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
kindstringobbligatorioreasonstringanswer_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: nessunreason.currency_missing,mixed_currency_sum: una spiegazione in inglese (un testo alternativo; il client costruisce la frase a partire dacurrencies).fx_rate_missing:no_rate_on_date(nessun tasso per la data della riga entro la tolleranza) ono_rate(nessun tasso per la coppia).requestedstringtypestringtoolstringtool_failed,tool_not_allowed: il nome dello strumento.textstringLa parte della risposta a cui si riferisce l’avviso (
answer_mismatch_data: il mese e il numero come scritti nella risposta). Peraccess_limited,restricted_unverifiedefx_rate_missing, un testo alternativo (fx_rate_missing: le coppie e le date senza tasso).expectedstringChe 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 integerPosizioni delle parti nel testo della risposta (UTF-16, come nelle stringhe JavaScript): il numero e il mese.
numberstringanswer_mismatch_data: il numero come scritto nella risposta. Insieme aperiod,other_period,valueserows, sono i dati per il testo dell’avviso nella lingua dell’interfaccia.periodstringanswer_mismatch_data: il mese dalla risposta (YYYY-MM).other_periodstringanswer_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.rowsintegeranswer_mismatch_data,period_part: quante righe sono state sommate nel totale del mese.currencystringanswer_mismatch_data,currency_mismatch: la valuta del numero come indicata nella risposta (codice ISO 4217).currenciesarray of stringValute dei dati (codici ISO 4217). Per
currency_mismatch, quelle in cui questo valore compare nei dati; percurrency_missingemixed_currency_sum, le valute dei valori monetari nei dati della risposta; perfx_rate_stale, le valute convertite a un tasso non aggiornato; perfx_rate_missing, le valute senza tasso.rate_datestring (date)fx_rate_stale: la data del tasso non aggiornato (YYYY-MM-DD).pendingintegerenrichment_pending: quanti documenti nel perimetro della domanda sono ancora in elaborazione.card_idsarray of stringenrichment_pending: le schede di questi documenti visibili all’utente (al massimo 20).failedintegerenrichment_pending: quanti documenti nel perimetro della domanda non è stato possibile elaborare.failed_card_idsarray of stringenrichment_pending: le schede dei documenti che non è stato possibile elaborare e che sono visibili all’utente (al massimo 20).foundintegerpartial_coverage: quanti documenti dell’insieme sono stati trovati nel perimetro della domanda.shownintegerpartial_coverage: quanti dei documenti trovati sono nella risposta.