Ledger
Endpoints for Ledger
Endpoints for Ledger
POST/api/v1/ledger/filter
Authentication: Bearer token (JWT)
pagenumberOptional1minimum: 1takenumberOptional10minimum: 1maximum: 50orderBystringOptional"createdAt"Allowed values: "createdAt", "id", "updatedAt"orderDirectionstringOptional"desc"Allowed values: "asc", "desc"application/jsonstatusstringOptional"open", "matched", "ignored"typesarray of TransactionResponseTypeOptional"payment", "refund", "invoice", "credit_note", "rounding_adjustment"invoiceStatusarray of INVOICE_STATUSOptional"paid", "unpaid", "over-due", "over-paid", "partially-paid", "refunded", "credited", itemsarray of TransactionResponseRequired15 fieldsitemstransactionGroupIdnumberField path: items[].transactionGroupIdcurlcurl https://api.subrite.no/api/v1/ledger/filter \
--request POST \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"status": "open",
"types": [
"payment"
],
"invoiceStatus": [
"paid"
],
"invoiceNumber": 0,
"reference": "string",
"memberSearch": "string",
"memberId": "string",
"memberEmail": "string",
"dateFrom": "2019-08-24T14:15:22Z",
"dateTo": "2019-08-24T14:15:22Z",
"amountFilter": {
"operator": "EQUALS",
"amount": 0,
"secondAmount": 0
}
}'GET/api/v1/ledger/{memberId}
Authentication: Bearer token (JWT)
memberIdstringRequiredstatusstringOptional"open", "matched", "ignored"PATCH/api/v1/ledger/{memberId}
Authentication: Bearer token (JWT)
memberIdstringRequiredapplication/jsontransactionIdsarray of numberRequiredactionTRANSACTION_GROUP_ACTIONRequiredPOST/api/v1/ledger/{memberId}/summary
Authentication: Bearer token (JWT)
memberIdstringRequiredapplication/jsonSame fields as Match transactions (Request body).
PATCH/api/v1/ledger/{memberId}/{transactionId}
Authentication: Bearer token (JWT)
memberIdstringRequiredtransactionIdnumberRequiredapplication/json"partially-credited"invoiceNumbernumberOptionalreferencestringOptionalmemberSearchstringOptionalmaxLength: 120memberIdstringOptionalmemberEmailstringOptionalmaxLength: 120dateFromstring (date-time)OptionaldateTostring (date-time)OptionalamountFilterAmountFilterOptional2 required when the containing object is present3 fieldsamountFilteroperatorComparisonOperatorRequired when parent is presentField path: amountFilter.operator"EQUALS", "BETWEEN", "GREATER_THAN", "LESS_THAN"amountnumberRequired when parent is presentField path: amountFilter.amountsecondAmountnumberOptionalField path: amountFilter.secondAmount{
"status": "open",
"types": [
"payment"
],
"invoiceStatus": [
"paid"
],
"invoiceNumber": 0,
"reference": "string",
"memberSearch": "string",
"memberId": "string",
"memberEmail": "string",
"dateFrom": "2019-08-24T14:15:22Z",
"dateTo": "2019-08-24T14:15:22Z",
"amountFilter": {
"operator": "EQUALS",
"amount": 0,
"secondAmount": 0
}
}transactionIdnumberRequired when parent is presentField path: items[].transactionIdmemberIdstringRequired when parent is presentField path: items[].memberIdmemberEmailstringRequired when parent is presentField path: items[].memberEmailmemberNamestringField path: items[].memberNametypeTransactionResponseTypeRequired when parent is presentField path: items[].type"payment", "refund", "invoice", "credit_note", "rounding_adjustment"registrationDatestring (date-time)Required when parent is presentField path: items[].registrationDateaccountingDatestring (date-time)Required when parent is presentField path: items[].accountingDateinvoiceNumbernumberField path: items[].invoiceNumberinvoiceStatusINVOICE_STATUSRequired when parent is presentField path: items[].invoiceStatus"paid", "unpaid", "over-due", "over-paid", "partially-paid", "refunded", "credited", "partially-credited"referencestringRequired when parent is presentField path: items[].referenceamountnumberRequired when parent is presentField path: items[].amountstatusTRANSACTION_RESPONSE_STATUSRequired when parent is presentField path: items[].status"open", "matched", "ignored"memberPackageIdnumberRequired when parent is presentField path: items[].memberPackageIdmemberNumbernumberRequired when parent is presentField path: items[].memberNumbermetaPageMetaRequired6 fieldsmetapagenumberRequiredField path: meta.pagetakenumberRequiredField path: meta.takecountnumberRequiredField path: meta.countpageCountnumberRequiredField path: meta.pageCounthasPreviousPagebooleanRequiredField path: meta.hasPreviousPagehasNextPagebooleanRequiredField path: meta.hasNextPage{
"items": [
{}
],
"meta": {
"page": 0,
"take": 0,
"count": 0,
"pageCount": 0,
"hasPreviousPage": true,
"hasNextPage": true
}
}This response has no body.
unauthorized
This response has no body.
forbiddenResource
messageCodestringRequiredmessagestringerrorsarray of FieldErrorRequired7 fieldserrorsfieldstringRequired when parent is presentField path: errors[].fieldfieldValuestringRequired when parent is presentField path: errors[].fieldValueidentifierstringRequired when parent is presentField path: errors[].identifieridentifierValuestringRequired when parent is presentField path: errors[].identifierValuemessageCodestringRequired when parent is presentField path: errors[].messageCodemessagestringField path: errors[].messageerrorTypestringRequired when parent is presentField path: errors[].errorType{
"messageCode": "string",
"message": "string",
"errors": [
{}
]
}transactionGroupIdnumbertransactionIdnumberRequired when parent is presentmemberIdstringRequired when parent is presentmemberEmailstringRequired when parent is presentmemberNamestringtypeTransactionResponseTypeRequired when parent is present"payment", "refund", "invoice", "credit_note", "rounding_adjustment"registrationDatestring (date-time)Required when parent is presentaccountingDatestring (date-time)Required when parent is presentinvoiceNumbernumberinvoiceStatusINVOICE_STATUSRequired when parent is present"paid", "unpaid", "over-due", "over-paid", "partially-paid", "refunded", "credited", "partially-credited"referencestringRequired when parent is presentamountnumberRequired when parent is presentstatusTRANSACTION_RESPONSE_STATUSRequired when parent is present"open", "matched", "ignored"memberPackageIdnumberRequired when parent is presentmemberNumbernumberRequired when parent is present[
{
"transactionGroupId": 0,
"transactionId": 0,
"memberId": "string",
"memberEmail": "string",
"memberName": "<memberName>",
"type": "payment",
"registrationDate": "2019-08-24T14:15:22Z",
"accountingDate": "2019-08-24T14:15:22Z",
"invoiceNumber": 0,
"invoiceStatus": "paid",
"reference": "string",
"amount": 0,
"status": "open",
"memberPackageId": 0,
"memberNumber": 0
}
]unauthorized
This response has no body.
forbiddenResource
Same fields as Get ledger of all members (403).
{
"messageCode": "string",
"message": "string",
"errors": [
{}
]
}curlcurl 'https://api.subrite.no/api/v1/ledger/{memberId}' \
--header 'Authorization: Bearer <token>'"match"Allowed values: "match", "open"{
"transactionIds": [
0
],
"action": "match"
}uuidstringRequiredisOpenbooleanRequiredisManualMatchbooleanRequiredtransactionsarray of TransactionRequired24 fieldstransactionstransactionGroupIdnumberRequired when parent is presentField path: transactions[].transactionGroupIdtypestringRequired when parent is presentField path: transactions[].type"payment", "refund", "invoice", "credit_note", "rounding_adjustment"memberPackageIdnumberRequired when parent is presentField path: transactions[].memberPackageIdamountnumberRequired when parent is presentField path: transactions[].amountreferenceidnumberRequiredcreatedAtstring (date-time)RequiredupdatedAtstring (date-time)RequireddeletedAtstring (date-time)RequiredmetaDataobjectRequired{
"uuid": "string",
"isOpen": true,
"isManualMatch": true,
"transactions": [
{
"metaData": {}
}
],
"id": 0,
"createdAt": "2019-08-24T14:15:22Z",
"updatedAt": "2019-08-24T14:15:22Z",
"deletedAt": "2019-08-24T14:15:22Z",
"metaData": {}
}matchWouldOrphanCreditNote
messageCodestringRequired"matchWouldOrphanCreditNote"messagestringerrorsunauthorized
This response has no body.
forbiddenResource
Same fields as Get ledger of all members (403).
{
"messageCode": "string",
"message": "string",
"errors": [
{}
]
}curlcurl 'https://api.subrite.no/api/v1/ledger/{memberId}' \
--request PATCH \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"transactionIds": [
0
],
"action": "match"
}'{
"transactionIds": [
0
],
"action": "match"
}transactionsarray of TransactionWithAmountRequired3 fieldstransactionstransactionIdnumberRequired when parent is presentField path: transactions[].transactionIdamountnumberRequired when parent is presentField path: transactions[].amounttypeTransactionResponseTypeRequired when parent is presentField path: transactions[].type"payment", "refund", "invoice", "credit_note", "rounding_adjustment"roundingAdjustmentAmountnumbertransactionGroupIdnumber{
"transactions": [
{}
],
"roundingAdjustmentAmount": 0,
"transactionGroupId": 0
}crossTransactionGroups
Same fields as Get ledger of all members (403).
{
"messageCode": "string",
"message": "string",
"errors": [
{}
]
}unauthorized
This response has no body.
curlcurl 'https://api.subrite.no/api/v1/ledger/{memberId}/summary' \
--request POST \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"transactionIds": [
0
],
"action": "match"
}'statusTRANSACTION_STATUSOptional"ignored"{
"status": "ignored"
}This response has no body.
badRequest
messageCodestringRequired"badRequest"messagestringerrorsarray of FieldErrorRequired7 fieldserrorsfieldstringRequired when parent is presentField path: errors[].fieldfieldValuestringRequired when parent is presentField path: errors[].fieldValueidentifierstringRequired when parent is presentField path: errors[].identifier{
"messageCode": "badRequest",
"message": "string",
"errors": [
{}
]
}unauthorized
This response has no body.
forbiddenResource
Same fields as Get ledger of all members (403).
{
"messageCode": "string",
"message": "string",
"errors": [
{}
]
}curlcurl 'https://api.subrite.no/api/v1/ledger/{memberId}/{transactionId}' \
--request PATCH \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"status": "ignored"
}'stringinvoiceIdnumberRequired when parent is presentField path: transactions[].invoiceIdpaymentIdnumberRequired when parent is presentField path: transactions[].paymentIdrefundIdnumberRequired when parent is presentField path: transactions[].refundIdaccountingDatestring (date-time)Required when parent is presentField path: transactions[].accountingDatestatusstringRequired when parent is presentField path: transactions[].status"ignored"tenantIdnumberRequired when parent is presentField path: transactions[].tenantIdmemberIdstringRequired when parent is presentField path: transactions[].memberIdtransactionGroupTransactionGroupRequired when parent is presentField path: transactions[].transactionGroupRecursive schema; nested fields are not repeated.memberMemberRequired when parent is presentField path: transactions[].member21 fieldstransactions[].memberuserIdnumberRequired when parent is presentField path: transactions[].member.userIdmemberNumbernumberRequired when parent is presentField path: transactions[].member.memberNumbertenantIdnumberRequired when parent is presentField path: transactions[].member.tenantIdexternalIdstringRequired when parent is presentField path: transactions[].member.externalIdfullNamestringRequired when parent is presentField path: transactions[].member.fullNamenickNamestringRequired when parent is presentField path: transactions[].member.nickNameavatarstringRequired when parent is presentField path: transactions[].member.avataremailstringRequired when parent is presentField path: transactions[].member.emailbirthDatestring (date-time)Required when parent is presentField path: transactions[].member.birthDatephonestringRequired when parent is presentField path: transactions[].member.phoneisCompanybooleanRequired when parent is presentField path: transactions[].member.isCompanycompanyNamestringRequired when parent is presentField path: transactions[].member.companyNameorganizationNostringRequired when parent is presentField path: transactions[].member.organizationNodeleteAfterExpirationbooleanRequired when parent is presentField path: transactions[].member.deleteAfterExpirationcustomPropertyValuesobjectRequired when parent is presentField path: transactions[].member.customPropertyValuesproductRecipientsarray of MemberPackageProductRecipientRequired when parent is presentField path: transactions[].member.productRecipientsNested fields omitted: depth limit.idstringRequired when parent is presentField path: transactions[].member.idcreatedAtstring (date-time)Required when parent is presentField path: transactions[].member.createdAtupdatedAtstring (date-time)Required when parent is presentField path: transactions[].member.updatedAtdeletedAtstring (date-time)Required when parent is presentField path: transactions[].member.deletedAtmetaDataobjectRequired when parent is presentField path: transactions[].member.metaDatatenantTenantRequired when parent is presentField path: transactions[].tenantNested fields omitted: field limit.invoiceInvoiceRequired when parent is presentField path: transactions[].invoiceNested fields omitted: field limit.paymentPaymentRequired when parent is presentField path: transactions[].paymentNested fields omitted: field limit.refundRefundRequired when parent is presentField path: transactions[].refund21 fieldstransactions[].refundrefundNumbernumberRequired when parent is presentField path: transactions[].refund.refundNumberinvoiceNumbernumberRequired when parent is presentField path: transactions[].refund.invoiceNumberinvoiceIdnumberRequired when parent is presentField path: transactions[].refund.invoiceIdmemberIdstringRequired when parent is presentField path: transactions[].refund.memberIdlanguagestringRequired when parent is presentField path: transactions[].refund.language"en", "no", "sv", "da"memberInfoMemberInfoRequired when parent is presentField path: transactions[].refund.memberInfoNested fields omitted: depth limit.addressInfoAddressInfoRequired when parent is presentField path: transactions[].refund.addressInfoNested fields omitted: depth limit.tenantInfoTenantInfoRequired when parent is presentField path: transactions[].refund.tenantInfoNested fields omitted: depth limit.paymentProviderstringRequired when parent is presentField path: transactions[].refund.paymentProvider"stripe", "vipps", "external", "nets", "efaktura-avtalegiro-ehf", "swedbankpay"amountnumberRequired when parent is presentField path: transactions[].refund.amountaccountingDatestring (date-time)Required when parent is presentField path: transactions[].refund.accountingDatecurrencystringRequired when parent is presentField path: transactions[].refund.currencynotestringRequired when parent is presentField path: transactions[].refund.noteinvoiceInvoiceRequired when parent is presentField path: transactions[].refund.invoiceNested fields omitted: depth limit.memberMemberRequired when parent is presentField path: transactions[].refund.memberNested fields omitted: depth limit.tenantTenantRequired when parent is presentField path: transactions[].refund.tenantNested fields omitted: depth limit.idnumberRequired when parent is presentField path: transactions[].refund.idcreatedAtstring (date-time)Required when parent is presentField path: transactions[].refund.createdAtupdatedAtstring (date-time)Required when parent is presentField path: transactions[].refund.updatedAtdeletedAtstring (date-time)Required when parent is presentField path: transactions[].refund.deletedAtmetaDataobjectRequired when parent is presentField path: transactions[].refund.metaDatamemberPackageMemberPackageRequired when parent is presentField path: transactions[].memberPackageNested fields omitted: field limit.idnumberRequired when parent is presentField path: transactions[].idcreatedAtstring (date-time)Required when parent is presentField path: transactions[].createdAtupdatedAtstring (date-time)Required when parent is presentField path: transactions[].updatedAtdeletedAtstring (date-time)Required when parent is presentField path: transactions[].deletedAtmetaDataobjectRequired when parent is presentField path: transactions[].metaDataarray of FieldErrorerrorsfieldstringRequired when parent is presentField path: errors[].fieldfieldValuestringRequired when parent is presentField path: errors[].fieldValueidentifierstringRequired when parent is presentField path: errors[].identifieridentifierValuestringRequired when parent is presentField path: errors[].identifierValuemessageCodestringRequired when parent is presentField path: errors[].messageCodemessagestringField path: errors[].messageerrorTypestringRequired when parent is presentField path: errors[].errorType{
"messageCode": "matchWouldOrphanCreditNote",
"message": "string",
"errors": [
{}
]
}identifierValuestringRequired when parent is presentField path: errors[].identifierValuemessageCodestringRequired when parent is presentField path: errors[].messageCodemessagestringField path: errors[].messageerrorTypestringRequired when parent is presentField path: errors[].errorType