Report rejection
The recipient of a document reports to the Tax Authority when it rejects the document. See the Introduction for reporting by document or by reference.
Submission and Detail Retrieval
- Report the rejection of an invoice:
POST /invoices/{uuid}/rejection-reports - Report the rejection of a credit note:
POST /credit-notes/{uuid}/rejection-reports - Report the rejection of an external document:
POST /rejection-reports - List rejection reports:
GET /rejection-reports - Fetch rejection report details:
GET /rejection-reports/{uuid}
A document can have one rejection; another one only if the earlier one is rejected or failed.
Each rejection has a date (rejectionDate), a reason type (reasonType) and a reason text (reason, up to 1024 characters):
| Reason type | Tax Authority code | Meaning |
|---|---|---|
non_tax_mismatch | N (data mismatch without tax effect) | The data don't match, without effect on the tax calculation |
tax_mismatch | U (data mismatch with tax effect) | The data don't match, with an effect on the tax calculation |
other | O (other) | Any other reason |
Sample Request (by document)
POST /invoices/0199e8a1-9c4d-7e5f-8a6b-7c8d9e0f1a2b/rejection-reports
Authorization: Bearer {{jwt}}
Content-Type: application/json
Accept: application/json
{
"rejectionDate": "2026-11-05",
"reasonType": "tax_mismatch",
"reason": "The VAT rate on line 1 is wrong."
}
Sample Request (by reference)
POST /rejection-reports
Authorization: Bearer {{jwt}}
Content-Type: application/json
Accept: application/json
{
"legalEntityUuid": "0190a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
"document": {
"number": "2026-Invoice-0003",
"issueDate": "2026-11-03",
"supplierTaxId": "48780941616",
"customerTaxId": "75608754333"
},
"rejectionDate": "2026-11-05",
"reasonType": "other",
"reason": "The invoiced goods were not delivered."
}
legalEntityUuid is the Legal Entity that reports the rejection: the customer of the document, or the supplier of a self-billed one.
Sample Submission Response (202 Accepted)
{
"uuid": "0199e8c5-7a2b-7d3e-8f4a-5b6c7d8e9f0a",
"legalEntityUuid": "0190a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
"document": {
"uuid": "0199e8a1-9c4d-7e5f-8a6b-7c8d9e0f1a2b",
"number": "2026-Invoice-0001",
"issueDate": "2026-11-01",
"supplierTaxId": "48780941616",
"customerTaxId": "75608754333"
},
"rejectionDate": "2026-11-05",
"reasonType": "tax_mismatch",
"reason": "The VAT rate on line 1 is wrong.",
"status": "queued",
"errors": [],
"acceptedAt": null,
"createdAt": "2026-11-05T10:00:00+00:00"
}
For a report 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_recipient | By document: a rejection is reported by a Legal Entity that isn't the recipient |
report.rejection_already_reported | The document already has a rejection that isn't rejected or failed |
report.legal_entity_not_party | By reference: the Legal Entity is neither the supplier nor the customer of the document |