ReceivedDocuments
Lister les documents reçus par facturation électronique
GET /api/v1/einvoicing/received-documents
Nécessite une authentification (jeton Bearer) et l’en-tête X-Organization-Id.
Portée du jeton API : einvoicing.view
Documents entrants reçus via le réseau de facturation électronique (factures, avoirs), métadonnées uniquement — l'UBL brut n'est pas exposé ici. Paginé, du plus récent au plus ancien; filtres: processing_status (new|processing|processed|error|unsupported) et document_type.
Paramètres
| Nom | Emplacement | Type | Requis | Description |
|---|---|---|---|---|
processing_status |
query | string | non | |
document_type |
query | string | non | |
page |
query | integer | non | |
per_page |
query | integer | non |
Réponses
| Statut | Description |
|---|---|
| 200 | For non-paginated data, return as before |
| 422 |
Exemple de requête
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"
Envoyer une réponse de facture pour un document reçu
POST /api/v1/einvoicing/received-documents/{id}/response
Nécessite une authentification (jeton Bearer) et l’en-tête X-Organization-Id.
Portée du jeton API : einvoicing.respond
Envoie une réponse de facture Peppol via le service de réponse partagé: response_code AB (acceptation), CA (acceptation conditionnelle), RE (refus), UQ (mise en litige) ou AP (déjà payée). CA/RE/UQ exigent reason (texte libre); reason_code (optionnel) porte un code OPStatusReason normalisé (NON, REF, LEG, REC, QUA, DEL, PRI, QTY, ITM, PAY, UNR, FIN, PPD, OTH — le jeu de motifs MDT-113 français). Les factures reçues via le circuit français exigent un motif pour CA/UQ/RE, et PPD/OTH exigent un texte libre; toute violation renvoie 422 avec un message traduit avant tout appel au prestataire de transmission. 422 également lorsque le prestataire du document ne prend pas en charge les réponses de facture.
Paramètres
| Nom | Emplacement | Type | Requis | Description |
|---|---|---|---|---|
id |
path | integer | oui |
Corps de la requête
| Champ | Type | Requis | Description |
|---|---|---|---|
response_code |
string | oui | |
reason |
string | non | |
note |
string | non | |
reason_code |
string | non |
Réponses
| Statut | Description |
|---|---|
| 200 | For non-paginated data, return as before |
| 422 |
Exemple de requête
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"
}'