Report payment
The supplier reports to the Tax Authority each payment it receives for a document. See the Introduction for reporting by document or by reference.
Submission and Detail Retrieval
- Report a payment for an invoice:
POST /invoices/{uuid}/payment-reports - Report a payment for a credit note:
POST /credit-notes/{uuid}/payment-reports - Report a payment for an external document:
POST /payment-reports - List payment reports:
GET /payment-reports - Fetch payment report details:
GET /payment-reports/{uuid}
A document can have several payments, for partial payments. To correct a payment, report it again with a negative amount, then report the right one.
Each payment has a date (paymentDate), an amount with two decimals (collectedAmount) and a payment method (paymentMethod):
| Payment method | Tax Authority code | Meaning |
|---|---|---|
transaction_account | T (transaction account) | Payment through a transaction (bank) account |
settlement | O (settlement) | Settlement without a money transfer, for example a set-off |
other | Z (other) | Any other payment method |
The Tax Authority doesn't check payments for duplicates: a payment reported twice, through A-Cube or in FiskAplikacija, is recorded twice. To cancel a payment, report it again with a negative amount.
Sample Request (by document)
POST /invoices/0199e8a1-2b3c-7d4e-8f90-a1b2c3d4e5f6/payment-reports
Authorization: Bearer {{jwt}}
Content-Type: application/json
Accept: application/json
{
"paymentDate": "2026-11-15",
"collectedAmount": "1656.25",
"paymentMethod": "transaction_account"
}
Sample Request (by reference)
POST /payment-reports
Authorization: Bearer {{jwt}}
Content-Type: application/json
Accept: application/json
{
"document": {
"number": "2026-Invoice-0003",
"issueDate": "2026-11-03",
"supplierTaxId": "48780941616",
"customerTaxId": "75608754333"
},
"paymentDate": "2026-11-15",
"collectedAmount": "500.00",
"paymentMethod": "transaction_account"
}
The supplier (supplierTaxId) must be one of your Legal Entities: it reports the payment.
Sample Submission Response (202 Accepted)
{
"uuid": "0199e8b4-6f1a-7c2d-9e3f-4a5b6c7d8e9f",
"legalEntityUuid": "018f4a2e-7b3c-7f1a-b2c3-4d5e6f789abc",
"document": {
"uuid": "0199e8a1-2b3c-7d4e-8f90-a1b2c3d4e5f6",
"number": "2026-Invoice-0001",
"issueDate": "2026-11-01",
"supplierTaxId": "48780941616",
"customerTaxId": "75608754333"
},
"paymentDate": "2026-11-15",
"collectedAmount": "1656.25",
"paymentMethod": "transaction_account",
"status": "queued",
"errors": [],
"acceptedAt": null,
"createdAt": "2026-11-15T10:00:00+00:00"
}
For a payment by reference, document.uuid is null and the other document fields are the ones sent.
Blockers (409)
A report that breaks a rule is refused with 409 and the rules in blockers:
| Code | When |
|---|---|
report.fiscalisation_disabled | The Legal Entity doesn't have fiscalisation enabled |
report.fiscalisation_not_confirmed | The Legal Entity's fiscalisation confirmation isn't confirmed |
report.document_not_fiscalized | By document: the document's Tax Data Document isn't accepted yet |
report.not_supplier | By document: a payment is reported by a Legal Entity that isn't the supplier |