Zum Hauptinhalt springen

Dinero-Fehler

typehttps://docs.frem.sh/reference/api/errors/dinero-error
HTTP-Status502 Bad Gateway

Was das bedeutet

Die Aktion ist gelungen, aber die Buchung in Dinero nicht.

Beispiele für detail-Meldungen, die mit diesem Fehler zurückkommen:

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

Was du tun kannst

Wiederhole die Anfrage nicht. Dieser Status bedeutet, dass der Geldvorgang bereits abgeschlossen ist und nur der Buchungsdatensatz fehlgeschlagen ist. Ein erneuter Versuch würde die Geldbewegung wiederholen – eine zweite Erstattung –, nur um eine Buchung zu reparieren.

Erstelle die Gutschrift von Hand in Dinero, zu der Rechnung, die in der Antwort genannt ist. Die Erstattung selbst ist zur Rechnung erfasst und in der Operator-Konsole sichtbar; nur die Buchhaltung ist nicht auf demselben Stand.

Das ist bewusst ein 502 und kein 500: Der Fehler liegt in einem Upstream-System, und genau diese Unterscheidung sagt dir, dass die Anfrage nicht atomar war.

Form der Antwort

Alle Fehler der fremforge-API sind RFC 9457 problem+json:

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

Werte type aus, nicht title oder detail – diese sind für Menschen gedacht und können umformuliert werden.