Перейти к содержанию
Sursa для разработчиков

Объекты

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обязательно
  • reasonstring

    answer_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 (для пары курсов нет вовсе).

  • requestedstring
  • typestring
  • toolstring

    tool_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): число и месяц.

  • numberstring

    answer_mismatch_data: число в том виде, как оно написано в ответе. Вместе с period, other_period, values и rows это данные для текста предупреждения на языке интерфейса.

  • periodstring

    answer_mismatch_data: месяц из ответа (YYYY-MM).

  • other_periodstring

    answer_mismatch_data: месяц данных, значение которого равно числу (YYYY-MM).

  • valuesarray of number (double)

    answer_mismatch_data: значения данных за месяц или итог.

  • rowsinteger

    answer_mismatch_data, period_part: сколько строк сложено в итоге за месяц.

  • currencystring

    answer_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).

  • pendinginteger

    enrichment_pending: сколько документов в области вопроса ещё обрабатываются.

  • card_idsarray of string

    enrichment_pending: карточки этих документов, видимые пользователю (не больше 20).

  • failedinteger

    enrichment_pending: сколько документов в области вопроса не удалось обработать.

  • failed_card_idsarray of string

    enrichment_pending: карточки документов, которые не удалось обработать и которые видны пользователю (не больше 20).

  • foundinteger

    partial_coverage: сколько документов набора найдено в области вопроса.

  • showninteger

    partial_coverage: сколько из найденных документов попало в ответ.

Входит в

AnswerResponseChatEventDataFeedItemQuestionPayload