Objectes
AnswerWarning
Avís associat a una resposta. kind és ampliable: mostreu un tipus desconegut amb un missatge genèric. Tipus:
- chart_unavailable, chart_type_changed, chart_axis_categorical, tool_not_allowed, tool_failed, table_query_failed (ha fallat una consulta a les taules de la resposta), truncated. Aquests tipus no tenen reason.
- answer_mismatch_data: un número de la resposta al costat d’un mes difereix de les dades del gràfic per a aquell mes (reason: period_value, period_missing, total_as_period, period_part); o el número no és a les dades de la resposta (reason: number_not_in_data); o una resposta de visió general esmenta un document que no és a la llista de documents i no té enllaç a la font (reason: document_not_in_list); o el número és a les dades, però en una altra moneda (reason: currency_mismatch, amb els camps number, currency, currencies). Camps: text, expected, spans.
- answer_source_ambiguous: les dades provenen de diverses taules semblants del mateix període, i la pregunta no demanava combinar-les (text enumera les taules).
- answer_no_data_basis: una resposta amb números mensuals no té dades de taules, de manera que els números no estan verificats.
- currency_missing: un número de dades monetàries no té moneda, tot i que les dades tenen diverses monedes (text, number, spans, currencies).
- mixed_currency_sum: un número de la resposta és igual a una suma de valors en monedes diferents (text, number, spans, currencies).
- access_limited: l’accés de l’usuari ha exclòs alguns resultats, de manera que la resposta pot ser incompleta (sense camps de dades).
- fx_rate_stale: la conversió ha fet servir un tipus de canvi més antic que el llindar d’actualitat de la seva font (rate_date, currencies).
- fx_rate_missing: un import de la resposta no s’ha convertit. reason és no_rate_on_date (no hi ha tipus per a la data de la fila de l’import dins de la tolerància: 7 dies, o 31 dies per als tipus pujats manualment) o no_rate (no hi ha cap tipus per a la parella). currencies enumera les monedes sense tipus. text és un text alternatiu en anglès amb les parelles i les dates, per exemple «RUB → USD on 2026-03-04, 2026-03-05», amb diverses parelles separades per «; ».
- restricted_unverified: una pregunta sobre un tema restringit. Els extractes no es mostren sense una comprovació de pertinència (sense camps de dades).
- enrichment_pending: l’abast de la pregunta té documents que encara s’estan processant, de manera que els seus camps i registres financers no estan llestos. reason és documents (una pregunta sobre imports o una resposta a partir de taules, de manera que el total pot ser incomplet) o document (una pregunta sobre un document concret que encara s’està processant o que no s’ha pogut processar). pending és el nombre de documents en procés, i card_ids són els que l’usuari pot veure (com a màxim 20). failed és el nombre de documents que no s’han pogut processar, i failed_card_ids són els visibles (com a màxim 20).
- partial_coverage: una pregunta de dossier o una llista de documents d’un tipus. S’han trobat found documents dins de l’abast, i només shown < found són a la resposta, de manera que la resposta pot ser incompleta.
- reconcile_unconfirmed: la resposta diu «coincideix» a una pregunta de conciliació, però l’import no s’ha trobat en dos documents diferents (text és una nota amb els imports de les dues fonts en la llengua de la resposta).
El client construeix el text per a l’usuari a partir de kind, reason i els camps de dades en la llengua de la interfície. El text d’access_limited, restricted_unverified i fx_rate_missing, i expected, són textos alternatius en la llengua de la resposta o en anglès.
Camps
kindstringobligatorireasonstringanswer_mismatch_data: el codi del motiu (period_value,period_missing,total_as_period,period_part,number_not_in_data,document_not_in_list,currency_mismatch).chart_axis_categorical:unparsed_periods.tool_failed,table_query_failed,truncated: sensereason.currency_missing,mixed_currency_sum: una explicació en anglès (un text alternatiu; el client construeix la frase a partir decurrencies).fx_rate_missing:no_rate_on_date(no hi ha tipus per a la data de la fila dins de la tolerància) ono_rate(no hi ha cap tipus per a la parella).requestedstringtypestringtoolstringtool_failed,tool_not_allowed: el nom de l’eina.textstringPart de la resposta a què es refereix l’avís (
answer_mismatch_data: el mes i el número tal com estan escrits a la resposta). Per aaccess_limited,restricted_unverifiedifx_rate_missing, un text alternatiu (fx_rate_missing: les parelles i les dates sense tipus).expectedstringQuè diuen les dades (
answer_mismatch_data: el valor d’aquest mes i el mes d’aquest valor, o el valor del total).spansarray of array of integerPosicions dels segments al text de la resposta (UTF-16, com a les cadenes de JavaScript): el número i el mes.
numberstringanswer_mismatch_data: el número tal com està escrit a la resposta. Juntament ambperiod,other_period,valuesirows, són les dades per al text de l’avís en la llengua de la interfície.periodstringanswer_mismatch_data: el mes de la resposta (YYYY-MM).other_periodstringanswer_mismatch_data: el mes de les dades el valor del qual és igual al número (YYYY-MM).valuesarray of number (double)answer_mismatch_data: els valors de les dades del mes, o el total.rowsintegeranswer_mismatch_data,period_part: quantes files s’han sumat en el total del mes.currencystringanswer_mismatch_data,currency_mismatch: la moneda del número tal com s’esmenta a la resposta (codi ISO 4217).currenciesarray of stringMonedes de les dades (codis ISO 4217). Per a
currency_mismatch, les monedes en què aquest valor apareix a les dades; per acurrency_missingimixed_currency_sum, les monedes dels valors monetaris de les dades de la resposta; per afx_rate_stale, les monedes convertides a un tipus desfasat; per afx_rate_missing, les monedes sense tipus.rate_datestring (date)fx_rate_stale: la data del tipus desfasat (YYYY-MM-DD).pendingintegerenrichment_pending: quants documents de l’abast de la pregunta encara s’estan processant.card_idsarray of stringenrichment_pending: les entrades d’aquests documents que l’usuari pot veure (com a màxim 20).failedintegerenrichment_pending: quants documents de l’abast de la pregunta no s’han pogut processar.failed_card_idsarray of stringenrichment_pending: les entrades dels documents que no s’han pogut processar i que l’usuari pot veure (com a màxim 20).foundintegerpartial_coverage: quants documents del conjunt s’han trobat dins de l’abast de la pregunta.shownintegerpartial_coverage: quants dels documents trobats són a la resposta.