Przejdź do treści
Sursa Developers

Obiekty

AnswerWarning

Ostrzeżenie dołączone do odpowiedzi. kind jest rozszerzalne: nieznany rodzaj wyświetlaj z ogólnym komunikatem. Rodzaje:
- chart_unavailable, chart_type_changed, chart_axis_categorical, tool_not_allowed, tool_failed, table_query_failed (zapytanie odpowiedzi do tabeli nie powiodło się), truncated. Te rodzaje nie mają reason.

- answer_mismatch_data: liczba w odpowiedzi obok miesiąca różni się od danych wykresu dla tego miesiąca (reason: period_value, period_missing, total_as_period, period_part); albo liczby nie ma w danych odpowiedzi (reason: number_not_in_data); albo odpowiedź przeglądowa wymienia dokument, którego nie ma na liście dokumentów i który nie ma linku do źródła (reason: document_not_in_list); albo liczba jest w danych, ale w innej walucie (reason: currency_mismatch, z polami number, currency, currencies). Pola: text, expected, spans.

- answer_source_ambiguous: dane pochodzą z kilku podobnych tabel za ten sam okres, a pytanie nie prosiło o ich połączenie (text wymienia tabele).

- answer_no_data_basis: odpowiedź z liczbami miesięcznymi nie ma danych z tabel, więc liczby nie są zweryfikowane.

- currency_missing: liczba z danych pieniężnych nie ma waluty, choć dane mają kilka walut (text, number, spans, currencies).

- mixed_currency_sum: liczba w odpowiedzi jest równa sumie wartości w różnych walutach (text, number, spans, currencies).

- access_limited: część wyników została wykluczona przez dostęp użytkownika, więc odpowiedź może być niepełna (brak pól danych).

- fx_rate_stale: przy przeliczeniu użyto kursu walut starszego niż próg aktualności jego źródła (rate_date, currencies).

- fx_rate_missing: kwota w odpowiedzi nie została przeliczona. reason to no_rate_on_date (brak kursu dla daty wiersza kwoty w granicach tolerancji: 7 dni lub 31 dni dla kursów przesłanych ręcznie) lub no_rate (brak jakichkolwiek kursów dla pary). currencies wymienia waluty bez kursu. text to tekst zastępczy po angielsku z parami i datami, np. „RUB → USD on 2026-03-04, 2026-03-05”, przy kilku parach rozdzielonymi znakami „; ”.

- restricted_unverified: pytanie w temacie objętym ograniczeniem. Fragmenty nie są pokazywane bez sprawdzenia trafności (brak pól danych).

- enrichment_pending: w zakresie pytania są dokumenty, które są jeszcze przetwarzane, więc ich pola i wpisy finansowe nie są gotowe. reason to documents (pytanie o kwoty lub odpowiedź z tabel, więc suma może być niepełna) lub document (pytanie o konkretny dokument, który jest jeszcze przetwarzany lub którego nie udało się przetworzyć). pending to liczba przetwarzanych dokumentów, a card_ids – te z nich, które widzi użytkownik (najwyżej 20). failed to liczba dokumentów, których nie udało się przetworzyć, a failed_card_ids – widoczne z nich (najwyżej 20).

- partial_coverage: pytanie o dossier lub lista dokumentów jednego typu. W zakresie znaleziono found dokumentów, a w odpowiedzi jest tylko shown < found, więc odpowiedź może być niepełna.

- reconcile_unconfirmed: odpowiedź na pytanie o uzgodnienie mówi „zgadza się”, ale kwoty nie znaleziono w dwóch różnych dokumentach (text to uwaga z kwotami z obu źródeł w języku odpowiedzi).

Klient tworzy tekst dla użytkownika na podstawie kind, reason i pól danych w języku interfejsu. text rodzajów access_limited, restricted_unverified i fx_rate_missing oraz expected to teksty zastępcze w języku odpowiedzi lub po angielsku.

Pola

  • kindstringwymagane
  • reasonstring

    answer_mismatch_data: kod przyczyny (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: brak reason. currency_missing, mixed_currency_sum: wyjaśnienie po angielsku (tekst zastępczy; klient tworzy zdanie na podstawie currencies). fx_rate_missing: no_rate_on_date (brak kursu dla daty wiersza w granicach tolerancji) lub no_rate (brak jakichkolwiek kursów dla pary).

  • requestedstring
  • typestring
  • toolstring

    tool_failed, tool_not_allowed: nazwa narzędzia.

  • textstring

    Część odpowiedzi, której dotyczy ostrzeżenie (answer_mismatch_data: miesiąc i liczba w postaci zapisanej w odpowiedzi). Dla access_limited, restricted_unverified i fx_rate_missing – tekst zastępczy (fx_rate_missing: pary i daty bez kursu).

  • expectedstring

    Co mówią dane (answer_mismatch_data: wartość dla tego miesiąca i miesiąc tej wartości albo wartość sumy).

  • spansarray of array of integer

    Pozycje fragmentów w tekście odpowiedzi (UTF-16, jak w ciągach znaków JavaScript): liczba i miesiąc.

  • numberstring

    answer_mismatch_data: liczba w postaci zapisanej w odpowiedzi. Razem z period, other_period, values i rows są to dane do tekstu ostrzeżenia w języku interfejsu.

  • periodstring

    answer_mismatch_data: miesiąc z odpowiedzi (YYYY-MM).

  • other_periodstring

    answer_mismatch_data: miesiąc danych, których wartość jest równa liczbie (YYYY-MM).

  • valuesarray of number (double)

    answer_mismatch_data: wartości danych dla miesiąca lub suma.

  • rowsinteger

    answer_mismatch_data, period_part: ile wierszy zsumowano w sumie miesiąca.

  • currencystring

    answer_mismatch_data, currency_mismatch: waluta liczby w postaci podanej w odpowiedzi (kod ISO 4217).

  • currenciesarray of string

    Waluty danych (kody ISO 4217). Dla currency_mismatch – te, w których ta wartość występuje w danych; dla currency_missing i mixed_currency_sum – waluty wartości pieniężnych w danych odpowiedzi; dla fx_rate_stale – waluty przeliczone po nieaktualnym kursie; dla fx_rate_missing – waluty bez kursu.

  • rate_datestring (date)

    fx_rate_stale: data nieaktualnego kursu (YYYY-MM-DD).

  • pendinginteger

    enrichment_pending: ile dokumentów w zakresie pytania jest jeszcze przetwarzanych.

  • card_idsarray of string

    enrichment_pending: karty tych dokumentów widoczne dla użytkownika (najwyżej 20).

  • failedinteger

    enrichment_pending: ilu dokumentów w zakresie pytania nie udało się przetworzyć.

  • failed_card_idsarray of string

    enrichment_pending: karty dokumentów, których nie udało się przetworzyć, widoczne dla użytkownika (najwyżej 20).

  • foundinteger

    partial_coverage: ile dokumentów zestawu znaleziono w zakresie pytania.

  • showninteger

    partial_coverage: ile ze znalezionych dokumentów jest w odpowiedzi.

Część

AnswerResponseChatEventDataFeedItemQuestionPayload