Erreur Dinero


`type`	`https://docs.frem.sh/reference/api/errors/dinero-error`
Statut HTTP	`502` Bad Gateway

Ce que cela signifie

L’action a réussi, mais pas l’écriture comptable dans Dinero.

Exemples de messages detail renvoyés avec cette erreur :

Refund sent but the credit note failed: {detail} — raise it by hand, do NOT retry.

Que faire

Ne réessayez pas la requête. Ce statut signifie que la partie financière est déjà effectuée et que seul l’enregistrement comptable a échoué. Réessayer répéterait le mouvement d’argent (un second remboursement) pour tenter de corriger une écriture comptable.

Établissez l’avoir à la main dans Dinero, sur la facture indiquée dans la réponse. Le remboursement lui-même est enregistré sur la facture et visible dans la console opérateur ; seul le grand livre est désynchronisé.

C’est délibérément un 502 et non un 500 : l’échec se situe dans un système en amont, et c’est cette distinction qui vous indique que la requête n’était pas atomique.

Forme de la réponse

Toutes les erreurs de l’API fremforge sont au format problem+json de la RFC 9457 :

{
  "type": "https://docs.frem.sh/reference/api/errors/dinero-error",
  "title": "Bad Gateway",
  "status": 502,
  "detail": "..."
}

Basez votre logique sur type, et non sur title ou detail : ces champs sont destinés à être lus par un humain et peuvent être reformulés.

Erreur de base de données Erreur en amont