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#

Responses#

Example request#

curl -X GET "https://app.encryptinvoice.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#

Request body#

Responses#

Example request#

curl -X POST "https://app.encryptinvoice.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"
}'