Changement de statut d'une facture

POST

Non implémenté pour l’instant (aucune crate delivery-*). Contrat cible.

Envoyé au SaaS (delivery HTTP) à chaque changement de statut du cycle de vie.

Livraison au moins une fois, ordre non garanti : dédupliquer sur id et ordonner sur occurred_at. Répondre 2xx pour acquitter ; sinon nouvelle tentative.

Signature : X-Signature = HMAC-SHA256, en hexadécimal, de <X-Timestamp>.<corps brut> avec le secret partagé configuré pour ce SaaS dans le déploiement. Rejeter l’événement si X-Timestamp s’écarte de plus de 5 minutes de l’heure courante (anti-rejeu).

Authorizations

• bearerAuth

Parameters

Header Parameters

X-Signature

required

string

HMAC-SHA256 hexadécimal de <X-Timestamp>.<corps brut>.

X-Timestamp

required

integer

Horodatage d’envoi, secondes Unix.

Request Body^required

Media typeapplication/json

object

id

required

Identifiant unique de l’événement (clé de déduplication).

string

type

required

string

Allowed value: invoice.status_changed

submission_id

required

string

saas_id

required

string

status

required

object

code

required

Statut du cycle de vie (référentiel 02 §17) : 200 Déposée, 201 Émise, 202 Reçue, 203 Mise à disposition, 204 Prise en charge, 205 Approuvée, 206 Approuvée partiellement, 207 En litige, 208 Suspendue, 209 Complétée, 210 Refusée, 211 Paiement transmis, 212 Encaissée, 213 Rejetée, 214 Visée (à vérifier : absent du référentiel 02).

integer

>= 200 <= 214

label

string

occurred_at

required

string format: date-time

reason

Motif, notamment pour 210 et 213.

string

occurred_at

required

string format: date-time

Responses

204

Événement acquitté.