ReceivedDocuments
List received e-invoicing documents
GET /api/v1/einvoicing/received-documents
Requires authentication (Bearer token) and the X-Organization-Id header.
API token scope: einvoicing.view
Inbound documents received through the e-invoicing network (invoices, credit notes), metadata only — the raw UBL is not exposed here. Paginated, newest first; filters: processing_status (new|processing|processed|error|unsupported) and document_type.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
processing_status |
query | string | no | |
document_type |
query | string | no | |
page |
query | integer | no | |
per_page |
query | integer | no |
Responses
| Status | Description |
|---|---|
| 200 | For non-paginated data, return as before |
| 422 |
Example request
curl -X GET "https://kworia.com/api/v1/einvoicing/received-documents" \
-H "Authorization: Bearer {{access_token}}" \
-H "X-Organization-Id: {{organization_id}}" \
-H "Accept: application/json"
Send an invoice response for a received document
POST /api/v1/einvoicing/received-documents/{id}/response
Requires authentication (Bearer token) and the X-Organization-Id header.
API token scope: einvoicing.respond
Sends a Peppol invoice response through the shared response service: response_code AB (accept), CA (conditional accept), RE (reject), UQ (query) or AP (already paid). CA/RE/UQ require reason (free text); optional reason_code carries a standard OPStatusReason code (NON, REF, LEG, REC, QUA, DEL, PRI, QTY, ITM, PAY, UNR, FIN, PPD, OTH — the French MDT-113 motif set). Invoices received through the French workflow require a motif on CA/UQ/RE, and PPD/OTH require free text; violations return 422 with a translated message before any provider call. 422 also when the document's provider does not support invoice responses.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
id |
path | integer | yes |
Request body
| Field | Type | Required | Description |
|---|---|---|---|
response_code |
string | yes | |
reason |
string | no | |
note |
string | no | |
reason_code |
string | no |
Responses
| Status | Description |
|---|---|
| 200 | For non-paginated data, return as before |
| 422 |
Example request
curl -X POST "https://kworia.com/api/v1/einvoicing/received-documents/{id}/response" \
-H "Authorization: Bearer {{access_token}}" \
-H "X-Organization-Id: {{organization_id}}" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"response_code": "string",
"reason": "string",
"note": "string",
"reason_code": "string"
}'