Anar al contingut
Sursa Developers

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

  • kindstringobligatori
  • reasonstring

    answer_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: sense reason. currency_missing, mixed_currency_sum: una explicació en anglès (un text alternatiu; el client construeix la frase a partir de currencies). fx_rate_missing: no_rate_on_date (no hi ha tipus per a la data de la fila dins de la tolerància) o no_rate (no hi ha cap tipus per a la parella).

  • requestedstring
  • typestring
  • toolstring

    tool_failed, tool_not_allowed: el nom de l’eina.

  • textstring

    Part 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 a access_limited, restricted_unverified i fx_rate_missing, un text alternatiu (fx_rate_missing: les parelles i les dates sense tipus).

  • expectedstring

    Què 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 integer

    Posicions dels segments al text de la resposta (UTF-16, com a les cadenes de JavaScript): el número i el mes.

  • numberstring

    answer_mismatch_data: el número tal com està escrit a la resposta. Juntament amb period, other_period, values i rows, són les dades per al text de l’avís en la llengua de la interfície.

  • periodstring

    answer_mismatch_data: el mes de la resposta (YYYY-MM).

  • other_periodstring

    answer_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.

  • rowsinteger

    answer_mismatch_data, period_part: quantes files s’han sumat en el total del mes.

  • currencystring

    answer_mismatch_data, currency_mismatch: la moneda del número tal com s’esmenta a la resposta (codi ISO 4217).

  • currenciesarray of string

    Monedes de les dades (codis ISO 4217). Per a currency_mismatch, les monedes en què aquest valor apareix a les dades; per a currency_missing i mixed_currency_sum, les monedes dels valors monetaris de les dades de la resposta; per a fx_rate_stale, les monedes convertides a un tipus desfasat; per a fx_rate_missing, les monedes sense tipus.

  • rate_datestring (date)

    fx_rate_stale: la data del tipus desfasat (YYYY-MM-DD).

  • pendinginteger

    enrichment_pending: quants documents de l’abast de la pregunta encara s’estan processant.

  • card_idsarray of string

    enrichment_pending: les entrades d’aquests documents que l’usuari pot veure (com a màxim 20).

  • failedinteger

    enrichment_pending: quants documents de l’abast de la pregunta no s’han pogut processar.

  • failed_card_idsarray of string

    enrichment_pending: les entrades dels documents que no s’han pogut processar i que l’usuari pot veure (com a màxim 20).

  • foundinteger

    partial_coverage: quants documents del conjunt s’han trobat dins de l’abast de la pregunta.

  • showninteger

    partial_coverage: quants dels documents trobats són a la resposta.

Forma part de

AnswerResponseChatEventDataFeedItemQuestionPayload