Объекты
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: сколько из найденных документов попало в ответ.