Об’єкти
AnswerWarning
Попередження, додане до відповіді. kind — розширюваний перелік: невідомий вид показуйте із загальним повідомленням. Види:
- chart_unavailable, chart_type_changed, chart_axis_categorical, tool_not_allowed, tool_failed, table_query_failed (не вдався запит відповіді до таблиць), truncated. Ці види не мають reason.
- answer_mismatch_data: число у відповіді поруч із місяцем відрізняється від даних діаграми за цей місяць (reason: period_value, period_missing, total_as_period, period_part); або числа немає в даних відповіді (reason: number_not_in_data); або оглядова відповідь називає документ, якого немає в списку документів і який не має посилання на джерело (reason: document_not_in_list); або число є в даних, але в іншій валюті (reason: currency_mismatch, з полями number, currency, currencies). Поля: text, expected, spans.
- answer_source_ambiguous: дані походять із кількох схожих таблиць за той самий період, а запитання не просило їх об’єднувати (text перелічує таблиці).
- answer_no_data_basis: відповідь із помісячними числами не має табличних даних, тому числа не перевірено.
- currency_missing: число з грошових даних не має валюти, хоча в даних кілька валют (text, number, spans, currencies).
- mixed_currency_sum: число у відповіді дорівнює сумі значень у різних валютах (text, number, spans, currencies).
- access_limited: деякі результати виключено через доступ користувача, тому відповідь може бути неповною (без полів даних).
- fx_rate_stale: для перерахунку використано курс валюти, старіший за поріг актуальності його джерела (rate_date, currencies).
- fx_rate_missing: суму у відповіді не перераховано. reason — no_rate_on_date (немає курсу на дату рядка суми в межах допуску: 7 днів або 31 день для курсів, завантажених вручну) або no_rate (для пари курсів немає взагалі). currencies перелічує валюти без курсу. text — резервний текст англійською з парами й датами, наприклад «RUB → USD on 2026-03-04, 2026-03-05», кілька пар розділено «; ».
- restricted_unverified: запитання на тему з обмеженим доступом. Фрагменти не показуються без перевірки релевантності (без полів даних).
- enrichment_pending: в області запитання є документи, які ще обробляються, тому їхні поля та фінансові записи не готові. reason — documents (запитання про суми або відповідь за таблицями, тому підсумок може бути неповним) або document (запитання про конкретний документ, який ще обробляється або який не вдалося обробити). pending — кількість документів, що обробляються, а card_ids — ті з них, які бачить користувач (не більше 20). failed — кількість документів, які не вдалося обробити, а failed_card_ids — видимі з них (не більше 20).
- partial_coverage: запитання-досьє або список документів одного типу. В області знайдено found документів, а у відповіді є лише shown < found, тому відповідь може бути неповною.
- reconcile_unconfirmed: на запитання про звірку відповідь каже «збігається», але суму не знайдено у двох різних документах (text — примітка із сумами обох джерел мовою відповіді).
Клієнт будує текст для користувача з kind, reason і полів даних мовою інтерфейсу. text для access_limited, restricted_unverified і fx_rate_missing, а також expected — резервні тексти мовою відповіді або англійською.
Поля
kindstringобов’язковоreasonstringanswer_mismatch_data: код причини (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:reasonнемає.currency_missing,mixed_currency_sum: пояснення англійською (резервний текст; клієнт будує фразу зcurrencies).fx_rate_missing:no_rate_on_date(немає курсу на дату рядка в межах допуску) абоno_rate(для пари курсів немає взагалі).requestedstringtypestringtoolstringtool_failed,tool_not_allowed: назва інструмента.textstringЧастина відповіді, до якої належить попередження (
answer_mismatch_data: місяць і число так, як їх написано у відповіді). Дляaccess_limited,restricted_unverifiedіfx_rate_missing— резервний текст (fx_rate_missing: пари й дати без курсу).expectedstringЩо показують дані (
answer_mismatch_data: значення за цей місяць і місяць цього значення або значення підсумку).spansarray of array of integerПозиції фрагментів у тексті відповіді (UTF-16, як у рядках JavaScript): число й місяць.
numberstringanswer_mismatch_data: число так, як його написано у відповіді. Разом ізperiod,other_period,valuesіrowsце дані для тексту попередження мовою інтерфейсу.periodstringanswer_mismatch_data: місяць із відповіді (YYYY-MM).other_periodstringanswer_mismatch_data: місяць даних, значення якого дорівнює числу (YYYY-MM).valuesarray of number (double)answer_mismatch_data: значення даних за місяць або підсумок.rowsintegeranswer_mismatch_data,period_part: скільки рядків підсумовано в підсумку місяця.currencystringanswer_mismatch_data,currency_mismatch: валюта числа так, як її названо у відповіді (код ISO 4217).currenciesarray of stringВалюти даних (коди ISO 4217). Для
currency_mismatch— ті, у яких це значення трапляється в даних; дляcurrency_missingіmixed_currency_sum— валюти грошових значень у даних відповіді; дляfx_rate_stale— валюти, перераховані за застарілим курсом; дляfx_rate_missing— валюти без курсу.rate_datestring (date)fx_rate_stale: дата застарілого курсу (YYYY-MM-DD).pendingintegerenrichment_pending: скільки документів в області запитання ще обробляються.card_idsarray of stringenrichment_pending: картки цих документів, які бачить користувач (не більше 20).failedintegerenrichment_pending: скільки документів в області запитання не вдалося обробити.failed_card_idsarray of stringenrichment_pending: картки документів, які не вдалося обробити й які бачить користувач (не більше 20).foundintegerpartial_coverage: скільки документів набору знайдено в області запитання.shownintegerpartial_coverage: скільки зі знайдених документів є у відповіді.