AnswerWarning

Avertissement joint à une réponse. kind est extensible : affichez un type inconnu avec un message générique. Types :
- chart_unavailable, chart_type_changed, chart_axis_categorical, tool_not_allowed, tool_failed, table_query_failed (une requête sur les tableaux de la réponse a échoué), truncated. Ces types n’ont pas de reason.
- answer_mismatch_data : un chiffre de la réponse placé à côté d’un mois diffère des données du graphique pour ce mois (reason : period_value, period_missing, total_as_period, period_part) ; ou le chiffre ne figure pas dans les données de la réponse (reason : number_not_in_data) ; ou une réponse de synthèse cite un document qui n’est pas dans la liste des documents et n’a pas de lien vers une source (reason : document_not_in_list) ; ou le chiffre figure dans les données, mais dans une autre devise (reason : currency_mismatch, avec les champs number, currency, currencies). Champs : text, expected, spans.
- answer_source_ambiguous : les données proviennent de plusieurs tableaux similaires pour la même période, et la question ne demandait pas de les combiner (text liste les tableaux).
- answer_no_data_basis : une réponse avec des chiffres mensuels ne s’appuie sur aucune donnée de tableau ; les chiffres ne sont donc pas vérifiés.
- currency_missing : un chiffre issu de données monétaires n’a pas de devise, alors que les données comportent plusieurs devises (text, number, spans, currencies).
- mixed_currency_sum : un chiffre de la réponse est égal à une somme de valeurs dans des devises différentes (text, number, spans, currencies).
- access_limited : certains résultats ont été exclus en raison des accès de l’utilisateur ; la réponse peut donc être incomplète (aucun champ de données).
- fx_rate_stale : la conversion a utilisé un taux de change plus ancien que le seuil de fraîcheur de sa source (rate_date, currencies).
- fx_rate_missing : un montant de la réponse n’a pas été converti. reason vaut no_rate_on_date (aucun taux pour la date de la ligne du montant dans la marge de tolérance : 7 jours, ou 31 jours pour les taux téléversés manuellement) ou no_rate (aucun taux pour la paire). currencies liste les devises sans taux. text est un texte de repli en anglais avec les paires et les dates, par exemple « RUB → USD on 2026-03-04, 2026-03-05 », plusieurs paires étant séparées par « ; ».
- restricted_unverified : une question sur un sujet restreint. Les extraits ne sont pas affichés sans vérification de pertinence (aucun champ de données).
- enrichment_pending : le périmètre de la question contient des documents encore en cours de traitement ; leurs champs et leurs entrées financières ne sont donc pas prêts. reason vaut documents (une question sur des montants ou une réponse issue de tableaux ; le total peut donc être incomplet) ou document (une question sur un document précis encore en cours de traitement ou qui n’a pas pu être traité). pending est le nombre de documents en cours de traitement, et card_ids ceux que l’utilisateur voit (au plus 20). failed est le nombre de documents qui n’ont pas pu être traités, et failed_card_ids ceux qui sont visibles (au plus 20).
- partial_coverage : une question de type dossier ou une liste de documents d’un même type. found documents ont été trouvés dans le périmètre, et seuls shown < found figurent dans la réponse ; la réponse peut donc être incomplète.
- reconcile_unconfirmed : la réponse indique « concorde » à une question de rapprochement, mais le montant n’a pas été trouvé dans deux documents différents (text est une note avec les montants des deux sources dans la langue de la réponse).

Le client construit le texte destiné à l’utilisateur à partir de kind, reason et des champs de données, dans la langue de l’interface. Le text de access_limited, restricted_unverified et fx_rate_missing, ainsi que expected, sont des textes de repli dans la langue de la réponse ou en anglais.