Aller au contenu

Type de problème de l'API Ironfang Finance

generation_failed

Échec de la génération. HTTP 500.

Ce que cela signifie

Le JSON a été accepté, mais le document généré à partir de celui-ci n'a pas passé le jeu de règles choisi : aucun XML n'a donc été délivré et rien n'a été facturé. L'issue est indéterminée et ne constitue pas un verdict sur l'entrée.

Que faire

Vérifiez les valeurs d'entrée dont dépendent les règles, comme les totaux, les catégories de taxe et les identifiants, puis réessayez. Si l'entrée est correcte, contactez le support en indiquant le request_id.

Ce que contient la réponse

type
https://ironfang.uk/problems/generation_failed, la version anglaise de cette page.
status
Toujours 500 pour ce code.
code
generation_failed. Stable : basez votre logique sur cette valeur, pas sur le libellé de title ou de detail, que l'API fournit en anglais.
detail
Ce qui s'est passé cette fois-ci, en anglais ; peut être montré à une personne. Ne contient jamais le contenu de la facture.
request_id
La même valeur que l'en-tête X-Ironfang-Request-ID. Indiquez-la au support.
retry_after_seconds
Jamais présent pour ce code.
outcome
Toujours indeterminate, avec usage_charged false : l'API n'a pas pu trancher, ce qui n'est pas un verdict sur le document, et rien n'a été facturé.

Les réponses de problème suivent la RFC 9457 et sont servies en application/problem+json. Un constat de validation n'est jamais une réponse de problème : une facture non valide est une réponse réussie qui liste ses constats. Consultez tous les types de problème, le guide Finance et le contrat OpenAPI (en anglais).