Обекти
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: колко от намерените документи са в отговора.