Skip to content
On this page

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"
}'