Към съдържанието
Sursa Developers

Обекти

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