Objetos
AnswerWarning
Una advertencia asociada a una respuesta. kind es ampliable: muestre un tipo desconocido con un mensaje genérico. Tipos:
- chart_unavailable, chart_type_changed, chart_axis_categorical, tool_not_allowed, tool_failed, table_query_failed (falló una consulta a las tablas de la respuesta), truncated. Estos tipos no tienen reason.
- answer_mismatch_data: un número de la respuesta junto a un mes difiere de los datos del gráfico para ese mes (reason: period_value, period_missing, total_as_period, period_part); o el número no está en los datos de la respuesta (reason: number_not_in_data); o una respuesta de visión general menciona un documento que no está en la lista de documentos y no tiene enlace a la fuente (reason: document_not_in_list); o el número está en los datos, pero en otra moneda (reason: currency_mismatch, con los campos number, currency, currencies). Campos: text, expected, spans.
- answer_source_ambiguous: los datos proceden de varias tablas similares del mismo período y la pregunta no pedía combinarlas (text enumera las tablas).
- answer_no_data_basis: una respuesta con cifras mensuales no tiene datos de tablas, así que las cifras no están verificadas.
- currency_missing: un número procedente de datos monetarios no tiene moneda, aunque los datos tienen varias monedas (text, number, spans, currencies).
- mixed_currency_sum: un número de la respuesta es igual a una suma de valores en monedas distintas (text, number, spans, currencies).
- access_limited: el acceso del usuario excluyó algunos resultados, así que la respuesta puede estar incompleta (sin campos de datos).
- fx_rate_stale: la conversión usó un tipo de cambio más antiguo que el umbral de actualidad de su fuente (rate_date, currencies).
- fx_rate_missing: un importe de la respuesta no se convirtió. reason es no_rate_on_date (no hay tipo para la fecha de la fila del importe dentro del margen de tolerancia: 7 días, o 31 días para los tipos subidos manualmente) o no_rate (no hay ningún tipo para el par). currencies enumera las monedas sin tipo. text es un texto alternativo en inglés con los pares y las fechas, por ejemplo, «RUB → USD on 2026-03-04, 2026-03-05», con varios pares separados por «; ».
- restricted_unverified: una pregunta sobre un tema restringido. Los extractos no se muestran sin una comprobación de pertinencia (sin campos de datos).
- enrichment_pending: el alcance de la pregunta tiene documentos que todavía se están procesando, por lo que sus campos y registros financieros no están listos. reason es documents (una pregunta sobre importes o una respuesta a partir de tablas, por lo que el total puede estar incompleto) o document (una pregunta sobre un documento concreto que todavía se está procesando o no se ha podido procesar). pending es el número de documentos en proceso, y card_ids son los visibles para el usuario (como máximo 20). failed es el número de documentos que no se han podido procesar, y failed_card_ids son los visibles (como máximo 20).
- partial_coverage: una pregunta de tipo dosier o una lista de documentos de un mismo tipo. Se encontraron found documentos en el alcance y solo shown < found están en la respuesta, por lo que la respuesta puede estar incompleta.
- reconcile_unconfirmed: la respuesta dice «coincide» a una pregunta de conciliación, pero el importe no se encontró en dos documentos distintos (text es una nota con los importes de ambas fuentes en el idioma de la respuesta).
El cliente compone el texto para el usuario a partir de kind, reason y los campos de datos, en el idioma de la interfaz. El text de access_limited, restricted_unverified y fx_rate_missing, y expected, son textos alternativos en el idioma de la respuesta o en inglés.
Campos
kindstringobligatorioreasonstringanswer_mismatch_data: el código 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: sinreason.currency_missing,mixed_currency_sum: una explicación en inglés (texto alternativo; el cliente compone la frase a partir decurrencies).fx_rate_missing:no_rate_on_date(no hay tipo para la fecha de la fila dentro del margen de tolerancia) ono_rate(no hay ningún tipo para el par).requestedstringtypestringtoolstringtool_failed,tool_not_allowed: el nombre de la herramienta.textstringLa parte de la respuesta a la que se refiere la advertencia (
answer_mismatch_data: el mes y el número tal como aparecen en la respuesta). Enaccess_limited,restricted_unverifiedyfx_rate_missing, un texto alternativo (fx_rate_missing: los pares y las fechas sin tipo).expectedstringLo que dicen los datos (
answer_mismatch_data: el valor de este mes y el mes de este valor, o el valor del total).spansarray of array of integerPosiciones de las partes del texto de la respuesta (UTF-16, como en las cadenas de JavaScript): el número y el mes.
numberstringanswer_mismatch_data: el número tal como aparece en la respuesta. Junto conperiod,other_period,valuesyrows, son los datos para el texto de la advertencia en el idioma de la interfaz.periodstringanswer_mismatch_data: el mes de la respuesta (YYYY-MM).other_periodstringanswer_mismatch_data: el mes de los datos cuyo valor es igual al número (YYYY-MM).valuesarray of number (double)answer_mismatch_data: los valores de los datos del mes, o el total.rowsintegeranswer_mismatch_data,period_part: cuántas filas se sumaron en el total del mes.currencystringanswer_mismatch_data,currency_mismatch: la moneda del número tal como se nombra en la respuesta (código ISO 4217).currenciesarray of stringMonedas de los datos (códigos ISO 4217). En
currency_mismatch, aquellas en las que aparece este valor en los datos; encurrency_missingymixed_currency_sum, las monedas de los valores monetarios de los datos de la respuesta; enfx_rate_stale, las monedas convertidas a un tipo desactualizado; enfx_rate_missing, las monedas sin tipo.rate_datestring (date)fx_rate_stale: la fecha del tipo desactualizado (YYYY-MM-DD).pendingintegerenrichment_pending: cuántos documentos del alcance de la pregunta todavía se están procesando.card_idsarray of stringenrichment_pending: las tarjetas de estos documentos que el usuario puede ver (como máximo 20).failedintegerenrichment_pending: cuántos documentos del alcance de la pregunta no se han podido procesar.failed_card_idsarray of stringenrichment_pending: las tarjetas de los documentos que no se han podido procesar y que el usuario puede ver (como máximo 20).foundintegerpartial_coverage: cuántos documentos del conjunto se encontraron en el alcance de la pregunta.shownintegerpartial_coverage: cuántos de los documentos encontrados están en la respuesta.