Dinero-fout

Wat het betekent

De actie is gelukt, maar de boeking in Dinero niet.

Voorbeelden van detail-berichten die met deze fout worden teruggegeven:

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

Wat je kunt doen

Probeer het verzoek niet opnieuw. Deze status betekent dat de financiële kant al is afgerond en alleen de boekhoudkundige registratie is mislukt. Opnieuw proberen zou de geldbeweging herhalen (een tweede terugbetaling) terwijl je probeert een boeking te herstellen.

Maak de creditnota met de hand aan in Dinero, op de factuur die in het antwoord wordt genoemd. De terugbetaling zelf is op de factuur geregistreerd en zichtbaar in de operatorconsole; alleen het grootboek loopt niet gelijk.

Dit is bewust een 502 en geen 500: de fout zit in een upstream-systeem, en juist dat onderscheid vertelt je dat het verzoek niet atomair was.

Vorm van het antwoord

Alle API-fouten van fremforge zijn RFC 9457 problem+json:

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

Baseer je logica op type, niet op title of detail: die zijn bedoeld voor mensen en kunnen anders worden geformuleerd.