curl --request POST \
--url https://api.debbiecollect.com/v1/{tenantId}/case-vouchers/allocations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"voucherTypeId": "c51f2f6a-8081-45ef-b52d-5e0569fdf12e",
"date": "2026-06-04",
"currency": "DKK",
"matches": [
{
"caseVoucherReferenceId": "D12412347",
"amount": 100000
},
{
"caseVoucherReferenceId": "D12412348",
"amount": 20000
},
{
"caseVoucherId": "d341b682-c7b2-48b4-9152-17c3b4085089",
"amount": 30000
}
]
}
'[
{
"caseId": "3f1c2d4e-5a6b-4c8d-9e0f-1a2b3c4d5e6f",
"caseVoucherId": "1a2b3c4d-5e6f-4a8b-9c0d-1e2f3a4b5c6d",
"amount": 120000,
"currency": "DKK",
"date": "2026-06-04T00:00:00.000Z",
"voucherTypeId": "c51f2f6a-8081-45ef-b52d-5e0569fdf12e",
"targetCaseVouchers": [
{
"caseVoucherId": "7a8b9c0d-1e2f-4a4b-8c6d-7e8f9a0b1c2d",
"referenceId": "D12412347",
"amount": -120000,
"matchedAmount": 100000
},
{
"caseVoucherId": "426148d2-204a-414b-8c76-cab1261c9b98",
"referenceId": "D12412348",
"amount": -20000,
"matchedAmount": 20000
}
]
},
{
"caseId": "92dd77da-9098-41f0-9568-01e8e5f8b603",
"caseVoucherId": "0ba4a63e-e4c5-4aae-8ab7-0d3d6e0c89ad",
"amount": 30000,
"currency": "DKK",
"date": "2026-06-04T00:00:00.000Z",
"voucherTypeId": "c51f2f6a-8081-45ef-b52d-5e0569fdf12e",
"targetCaseVouchers": [
{
"caseVoucherId": "d341b682-c7b2-48b4-9152-17c3b4085089",
"referenceId": "D12412349",
"amount": -30000,
"matchedAmount": 30000
}
]
}
]Case voucher allocations
Register case voucher allocation
Register a payment made directly to the creditor or a credit note against a list of existing case vouchers. Set voucherTypeId to deposit or credit note; other types are currently rejected. All created vouchers use source CREDITOR.
Each item in matches supplies a positive amount in minor units and exactly one of caseVoucherId and caseVoucherReferenceId. References must be unambiguous within the supplied creditorId. A target may appear only once, including when supplied by ID and reference in different items. Each amount must fit within the target’s remaining fixed-distribution capacity. All targets must have the same currency.
Matches are grouped by case. One allocation voucher is created per case with the sum of that case’s match amounts, and one fixed distribution per target on both accounts, using the allocation voucher date. No fixed distribution crosses cases. The response is an array of the created allocation vouchers and their targetCaseVouchers, including each matchedAmount.
Required scope: write:case-vouchers
POST
/
v1
/
{tenantId}
/
case-vouchers
/
allocations
curl --request POST \
--url https://api.debbiecollect.com/v1/{tenantId}/case-vouchers/allocations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"voucherTypeId": "c51f2f6a-8081-45ef-b52d-5e0569fdf12e",
"date": "2026-06-04",
"currency": "DKK",
"matches": [
{
"caseVoucherReferenceId": "D12412347",
"amount": 100000
},
{
"caseVoucherReferenceId": "D12412348",
"amount": 20000
},
{
"caseVoucherId": "d341b682-c7b2-48b4-9152-17c3b4085089",
"amount": 30000
}
]
}
'[
{
"caseId": "3f1c2d4e-5a6b-4c8d-9e0f-1a2b3c4d5e6f",
"caseVoucherId": "1a2b3c4d-5e6f-4a8b-9c0d-1e2f3a4b5c6d",
"amount": 120000,
"currency": "DKK",
"date": "2026-06-04T00:00:00.000Z",
"voucherTypeId": "c51f2f6a-8081-45ef-b52d-5e0569fdf12e",
"targetCaseVouchers": [
{
"caseVoucherId": "7a8b9c0d-1e2f-4a4b-8c6d-7e8f9a0b1c2d",
"referenceId": "D12412347",
"amount": -120000,
"matchedAmount": 100000
},
{
"caseVoucherId": "426148d2-204a-414b-8c76-cab1261c9b98",
"referenceId": "D12412348",
"amount": -20000,
"matchedAmount": 20000
}
]
},
{
"caseId": "92dd77da-9098-41f0-9568-01e8e5f8b603",
"caseVoucherId": "0ba4a63e-e4c5-4aae-8ab7-0d3d6e0c89ad",
"amount": 30000,
"currency": "DKK",
"date": "2026-06-04T00:00:00.000Z",
"voucherTypeId": "c51f2f6a-8081-45ef-b52d-5e0569fdf12e",
"targetCaseVouchers": [
{
"caseVoucherId": "d341b682-c7b2-48b4-9152-17c3b4085089",
"referenceId": "D12412349",
"amount": -30000,
"matchedAmount": 30000
}
]
}
]Authorizations
Authentication can be done by using a bearer token in the Authorization header. This is done using the following format Authorization: Bearer {token}.
Path Parameters
Id of the tenant
Query Parameters
Id of the creditor the case voucher belongs to
Body
application/json
The creditor allocation
One payment or credit note allocated across one or more case vouchers. All matches are validated and saved in one transaction. There is no separate total amount: each created voucher is the sum of its case's match amounts.
Type of the new allocation voucher: deposit (c51f2f6a-8081-45ef-b52d-5e0569fdf12e) or credit note (ef2cdc50-230f-4046-b1af-0f9c498dddd3).
Available options:
c51f2f6a-8081-45ef-b52d-5e0569fdf12e, ef2cdc50-230f-4046-b1af-0f9c498dddd3 Allocations to existing debt vouchers belonging to the supplied creditor. Targets may belong to different cases, but must use the same currency. Amounts are summed per case to create one allocation voucher per case.
Minimum array length:
1One target case voucher and the positive amount to apply to it in minor units. Give exactly one of caseVoucherId and caseVoucherReferenceId; the unused identifier may be absent or null. A target may only occur once, including when identified by both its ID and reference in separate matches.
- Option 1
- Option 2
Show child attributes
Show child attributes
Date of the payment or credit note: YYYY-MM-DD or an ISO 8601 timestamp with Z or a timezone offset (for example, 2026-09-21T12:34:56+02:00). Defaults to now. Invalid calendar dates and timestamps without a timezone are rejected.
Optional currency assertion. When omitted, the first target determines the currency. All targets must use that currency; mixed-currency requests are rejected.
Available options:
DKK, SEK, NOK, USD, EUR, GBP, CHF Example:
"DKK"
Free text shown on the created allocation voucher.
Response
All allocations were registered. Returns one allocation voucher per case.
Id of the case the allocation was registered on
Id of the created payment or credit note voucher
Sum of the matchedAmount values on this case, in minor units.
Currency
Available options:
DKK, SEK, NOK, USD, EUR, GBP, CHF Example:
"DKK"
Type of the new allocation voucher: deposit (c51f2f6a-8081-45ef-b52d-5e0569fdf12e) or credit note (ef2cdc50-230f-4046-b1af-0f9c498dddd3).
Available options:
c51f2f6a-8081-45ef-b52d-5e0569fdf12e, ef2cdc50-230f-4046-b1af-0f9c498dddd3 Only targets on this case, with their allocated amounts.
Minimum array length:
1Show child attributes
Show child attributes