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.
Documents entrants reçus via le réseau de facturation électronique (factures, avoirs), métadonnées uniquement — l'UBL brut reste chiffré au repos et n'est pas exposé ici. Paginé, du plus récent au plus ancien ; filtres : processing_status (new|processing|processed|error|unsupported) et document_type. (#957)
Paramètres
| Nom |
Emplacement |
Type |
Requis |
Description |
processing_status |
query |
string |
non |
|
document_type |
query |
string |
non |
|
per_page |
query |
string |
non |
|
Réponses
| Statut |
Description |
| 200 |
For non-paginated data, return as before |
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.
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. (#957)
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"
}'