Vai al contenuto
Sursa Developers

Oggetti

AnswerWarning

Un avviso allegato a una risposta. kind è estendibile: mostra un tipo sconosciuto con un messaggio generico. Tipi:
- chart_unavailable, chart_type_changed, chart_axis_categorical, tool_not_allowed, tool_failed, table_query_failed (una query sulle tabelle della risposta non è riuscita), truncated. Questi tipi non hanno reason.

- answer_mismatch_data: un numero nella risposta accanto a un mese differisce dai dati del grafico per quel mese (reason: period_value, period_missing, total_as_period, period_part); oppure il numero non è nei dati della risposta (reason: number_not_in_data); oppure una risposta di panoramica cita un documento che non è nell’elenco dei documenti e non ha un link alla fonte (reason: document_not_in_list); oppure il numero è nei dati, ma in un’altra valuta (reason: currency_mismatch, con i campi number, currency, currencies). Campi: text, expected, spans.

- answer_source_ambiguous: i dati provengono da diverse tabelle simili per lo stesso periodo, e la domanda non chiedeva di combinarle (text elenca le tabelle).

- answer_no_data_basis: una risposta con numeri mensili non ha dati di tabella, quindi i numeri non sono verificati.

- currency_missing: un numero da dati monetari non ha una valuta, sebbene i dati abbiano più valute (text, number, spans, currencies).

- mixed_currency_sum: un numero nella risposta è uguale a una somma di valori in valute diverse (text, number, spans, currencies).

- access_limited: alcuni risultati sono stati esclusi dall’accesso dell’utente, quindi la risposta potrebbe essere incompleta (nessun campo di dati).

- fx_rate_stale: la conversione ha usato un tasso di cambio più vecchio della soglia di aggiornamento della sua fonte (rate_date, currencies).

- fx_rate_missing: un importo nella risposta non è stato convertito. reason è no_rate_on_date (nessun tasso per la data della riga dell’importo entro la tolleranza: 7 giorni, o 31 giorni per i tassi caricati manualmente) o no_rate (nessun tasso per la coppia). currencies elenca le valute senza tasso. text è un testo alternativo in inglese con le coppie e le date, ad esempio “RUB → USD on 2026-03-04, 2026-03-05”, con più coppie separate da “; ”.

- restricted_unverified: una domanda su un argomento soggetto a restrizioni. Gli estratti non vengono mostrati senza un controllo di pertinenza (nessun campo di dati).

- enrichment_pending: il perimetro della domanda contiene documenti ancora in elaborazione, quindi i loro campi e i dati finanziari non sono pronti. reason è documents (una domanda sugli importi o una risposta dalle tabelle, quindi il totale potrebbe essere incompleto) o document (una domanda su un documento specifico che è ancora in elaborazione o non è stato possibile elaborare). pending è il numero di documenti in elaborazione, e card_ids sono quelli visibili all’utente (al massimo 20). failed è il numero di documenti che non è stato possibile elaborare, e failed_card_ids sono quelli visibili (al massimo 20).

- partial_coverage: una domanda di tipo dossier o un elenco di documenti di un solo tipo. Nel perimetro sono stati trovati found documenti, e solo shown < found sono nella risposta, quindi la risposta potrebbe essere incompleta.

- reconcile_unconfirmed: la risposta dice “corrisponde” a una domanda di riconciliazione, ma l’importo non è stato trovato in due documenti diversi (text è una nota con gli importi di entrambe le fonti nella lingua della risposta).

Il client costruisce il testo per l’utente a partire da kind, reason e dai campi di dati nella lingua dell’interfaccia. Il text di access_limited, restricted_unverified e fx_rate_missing, e expected, sono testi alternativi nella lingua della risposta o in inglese.

Campi

  • kindstringobbligatorio
  • reasonstring

    answer_mismatch_data: il codice del motivo (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: nessun reason. currency_missing, mixed_currency_sum: una spiegazione in inglese (un testo alternativo; il client costruisce la frase a partire da currencies). fx_rate_missing: no_rate_on_date (nessun tasso per la data della riga entro la tolleranza) o no_rate (nessun tasso per la coppia).

  • requestedstring
  • typestring
  • toolstring

    tool_failed, tool_not_allowed: il nome dello strumento.

  • textstring

    La parte della risposta a cui si riferisce l’avviso (answer_mismatch_data: il mese e il numero come scritti nella risposta). Per access_limited, restricted_unverified e fx_rate_missing, un testo alternativo (fx_rate_missing: le coppie e le date senza tasso).

  • expectedstring

    Che cosa dicono i dati (answer_mismatch_data: il valore per questo mese e il mese di questo valore, o il valore del totale).

  • spansarray of array of integer

    Posizioni delle parti nel testo della risposta (UTF-16, come nelle stringhe JavaScript): il numero e il mese.

  • numberstring

    answer_mismatch_data: il numero come scritto nella risposta. Insieme a period, other_period, values e rows, sono i dati per il testo dell’avviso nella lingua dell’interfaccia.

  • periodstring

    answer_mismatch_data: il mese dalla risposta (YYYY-MM).

  • other_periodstring

    answer_mismatch_data: il mese dei dati il cui valore è uguale al numero (YYYY-MM).

  • valuesarray of number (double)

    answer_mismatch_data: i valori dei dati per il mese, o il totale.

  • rowsinteger

    answer_mismatch_data, period_part: quante righe sono state sommate nel totale del mese.

  • currencystring

    answer_mismatch_data, currency_mismatch: la valuta del numero come indicata nella risposta (codice ISO 4217).

  • currenciesarray of string

    Valute dei dati (codici ISO 4217). Per currency_mismatch, quelle in cui questo valore compare nei dati; per currency_missing e mixed_currency_sum, le valute dei valori monetari nei dati della risposta; per fx_rate_stale, le valute convertite a un tasso non aggiornato; per fx_rate_missing, le valute senza tasso.

  • rate_datestring (date)

    fx_rate_stale: la data del tasso non aggiornato (YYYY-MM-DD).

  • pendinginteger

    enrichment_pending: quanti documenti nel perimetro della domanda sono ancora in elaborazione.

  • card_idsarray of string

    enrichment_pending: le schede di questi documenti visibili all’utente (al massimo 20).

  • failedinteger

    enrichment_pending: quanti documenti nel perimetro della domanda non è stato possibile elaborare.

  • failed_card_idsarray of string

    enrichment_pending: le schede dei documenti che non è stato possibile elaborare e che sono visibili all’utente (al massimo 20).

  • foundinteger

    partial_coverage: quanti documenti dell’insieme sono stati trovati nel perimetro della domanda.

  • showninteger

    partial_coverage: quanti dei documenti trovati sono nella risposta.

Parte di

AnswerResponseChatEventDataFeedItemQuestionPayload