Đối tượng
AnswerWarning
Cảnh báo gắn với một câu trả lời. kind có thể mở rộng: hãy hiển thị loại không xác định bằng một thông báo chung. Các loại:
- chart_unavailable, chart_type_changed, chart_axis_categorical, tool_not_allowed, tool_failed, table_query_failed (một truy vấn bảng của câu trả lời bị lỗi), truncated. Các loại này không có reason.
- answer_mismatch_data: một con số trong câu trả lời đứng cạnh một tháng khác với dữ liệu biểu đồ của tháng đó (reason: period_value, period_missing, total_as_period, period_part); hoặc con số không có trong dữ liệu của câu trả lời (reason: number_not_in_data); hoặc câu trả lời tổng quan nêu tên một tài liệu không có trong danh sách tài liệu và không có liên kết nguồn (reason: document_not_in_list); hoặc con số có trong dữ liệu nhưng ở tiền tệ khác (reason: currency_mismatch, với các trường number, currency, currencies). Trường: text, expected, spans.
- answer_source_ambiguous: dữ liệu đến từ nhiều bảng tương tự cho cùng một kỳ, và câu hỏi không yêu cầu kết hợp chúng (text liệt kê các bảng).
- answer_no_data_basis: câu trả lời có số liệu theo tháng nhưng không có dữ liệu bảng, nên các con số chưa được kiểm tra.
- currency_missing: một con số từ dữ liệu tiền tệ không có đơn vị tiền tệ, dù dữ liệu có nhiều tiền tệ (text, number, spans, currencies).
- mixed_currency_sum: một con số trong câu trả lời bằng tổng các giá trị ở các tiền tệ khác nhau (text, number, spans, currencies).
- access_limited: một số kết quả bị loại do quyền truy cập của người dùng, nên câu trả lời có thể chưa đầy đủ (không có trường dữ liệu).
- fx_rate_stale: việc quy đổi đã dùng tỷ giá cũ hơn ngưỡng độ mới của nguồn cung cấp tỷ giá (rate_date, currencies).
- fx_rate_missing: một số tiền trong câu trả lời chưa được quy đổi. reason là no_rate_on_date (không có tỷ giá cho ngày của dòng chứa số tiền trong phạm vi dung sai: 7 ngày, hoặc 31 ngày với tỷ giá tải lên thủ công) hoặc no_rate (hoàn toàn không có tỷ giá cho cặp tiền). currencies liệt kê các tiền tệ không có tỷ giá. text là văn bản dự phòng bằng tiếng Anh kèm các cặp tiền và ngày, ví dụ “RUB → USD on 2026-03-04, 2026-03-05”, nhiều cặp được phân tách bằng “; ”.
- restricted_unverified: câu hỏi về chủ đề bị hạn chế. Đoạn trích không được hiển thị nếu chưa kiểm tra mức độ liên quan (không có trường dữ liệu).
- enrichment_pending: phạm vi câu hỏi có tài liệu vẫn đang được xử lý, nên các trường và bản ghi tài chính của chúng chưa sẵn sàng. reason là documents (câu hỏi về số tiền hoặc câu trả lời từ bảng, nên tổng có thể chưa đầy đủ) hoặc document (câu hỏi về một tài liệu cụ thể đang được xử lý hoặc không thể xử lý). pending là số tài liệu đang được xử lý, còn card_ids là những tài liệu người dùng nhìn thấy (tối đa 20). failed là số tài liệu không thể xử lý, còn failed_card_ids là những tài liệu nhìn thấy được (tối đa 20).
- partial_coverage: câu hỏi tổng hợp hồ sơ hoặc danh sách tài liệu cùng một loại. Tìm thấy found tài liệu trong phạm vi, và chỉ shown < found tài liệu có trong câu trả lời, nên câu trả lời có thể chưa đầy đủ.
- reconcile_unconfirmed: câu trả lời nói “khớp” cho câu hỏi đối chiếu, nhưng số tiền không được tìm thấy trong hai tài liệu khác nhau (text là ghi chú kèm số tiền của cả hai nguồn bằng ngôn ngữ của câu trả lời).
Client tạo văn bản cho người dùng từ kind, reason và các trường dữ liệu bằng ngôn ngữ giao diện. text của access_limited, restricted_unverified và fx_rate_missing, cùng với expected, là văn bản dự phòng bằng ngôn ngữ của câu trả lời hoặc bằng tiếng Anh.
Trường
kindstringbắt buộcreasonstringanswer_mismatch_data: mã lý do (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: không córeason.currency_missing,mixed_currency_sum: lời giải thích bằng tiếng Anh (dự phòng; client tạo câu từcurrencies).fx_rate_missing:no_rate_on_date(không có tỷ giá cho ngày của dòng trong phạm vi dung sai) hoặcno_rate(hoàn toàn không có tỷ giá cho cặp tiền).requestedstringtypestringtoolstringtool_failed,tool_not_allowed: tên công cụ.textstringPhần của câu trả lời mà cảnh báo nhắc tới (
answer_mismatch_data: tháng và con số như được viết trong câu trả lời). Vớiaccess_limited,restricted_unverifiedvàfx_rate_missing, là văn bản dự phòng (fx_rate_missing: các cặp tiền và ngày không có tỷ giá).expectedstringDữ liệu nói gì (
answer_mismatch_data: giá trị của tháng này và tháng của giá trị này, hoặc giá trị của tổng).spansarray of array of integerVị trí của các phần trong nội dung câu trả lời (UTF-16, như trong chuỗi JavaScript): con số và tháng.
numberstringanswer_mismatch_data: con số như được viết trong câu trả lời. Cùng vớiperiod,other_period,valuesvàrows, đây là dữ liệu cho văn bản cảnh báo bằng ngôn ngữ giao diện.periodstringanswer_mismatch_data: tháng từ câu trả lời (YYYY-MM).other_periodstringanswer_mismatch_data: tháng của dữ liệu có giá trị bằng con số (YYYY-MM).valuesarray of number (double)answer_mismatch_data: các giá trị dữ liệu của tháng, hoặc tổng.rowsintegeranswer_mismatch_data,period_part: số dòng được cộng vào tổng của tháng.currencystringanswer_mismatch_data,currency_mismatch: tiền tệ của con số như được nêu trong câu trả lời (mã ISO 4217).currenciesarray of stringTiền tệ của dữ liệu (mã ISO 4217). Với
currency_mismatch, là các tiền tệ mà giá trị này xuất hiện trong dữ liệu; vớicurrency_missingvàmixed_currency_sum, là tiền tệ của các giá trị tiền trong dữ liệu của câu trả lời; vớifx_rate_stale, là các tiền tệ được quy đổi theo tỷ giá đã cũ; vớifx_rate_missing, là các tiền tệ không có tỷ giá.rate_datestring (date)fx_rate_stale: ngày của tỷ giá đã cũ (YYYY-MM-DD).pendingintegerenrichment_pending: số tài liệu trong phạm vi câu hỏi vẫn đang được xử lý.card_idsarray of stringenrichment_pending: các thẻ của những tài liệu này mà người dùng nhìn thấy (tối đa 20).failedintegerenrichment_pending: số tài liệu trong phạm vi câu hỏi không thể xử lý.failed_card_idsarray of stringenrichment_pending: các thẻ của những tài liệu không thể xử lý mà người dùng nhìn thấy (tối đa 20).foundintegerpartial_coverage: số tài liệu của tập được tìm thấy trong phạm vi câu hỏi.shownintegerpartial_coverage: số tài liệu đã tìm thấy có trong câu trả lời.