ReceivedDocuments
List received e-invoicing documents
GET /api/v1/einvoicing/received-documents
Requires authentication (Bearer token) and the X-Organization-Id header.
Inbound documents received through the e-invoicing network (invoices, credit notes), metadata only — the raw UBL stays encrypted at rest and is not exposed here. Paginated, newest first; filters: processing_status (new|processing|processed|error|unsupported) and document_type. (#957)
Parameters
| Name |
In |
Type |
Required |
Description |
processing_status |
query |
string |
no |
|
document_type |
query |
string |
no |
|
per_page |
query |
string |
no |
|
Responses
| Status |
Description |
| 200 |
For non-paginated data, return as before |
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.
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. (#957)
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"
}'