{"phien_ban":"1.0","xac_thuc":"Header 'Authorization: Bearer <khóa>' hoặc 'X-API-Key: <khóa>'. Khóa do người dùng tạo trên Hub (Người dùng → Khóa API cho AI), chỉ hiện 1 lần, thu hồi được.","quy_uoc":{"ngay":"YYYY-MM-DD","ky":"2026 | 2026-Q3 | 2026-07 (thay cho tu/den)","phan_trang":"trang (từ 1), so_dong (tối đa 5000); kết quả có tong_dong, con_nua","so_tien":"VNĐ, số thực","loi":"401 khóa sai/thu hồi · 403 ngoài danh sách công ty · 400 tham số"},"endpoints":[{"phuong_thuc":"GET","duong_dan":"/api/ai/v1/companies","tham_so":"","mo_ta":"Danh sách công ty khóa được đọc"},{"phuong_thuc":"GET","duong_dan":"/api/ai/v1/{cid}/can-doi-tai-khoan","tham_so":"tu, den | ky","mo_ta":"Bảng cân đối tài khoản (CĐPS)"},{"phuong_thuc":"GET","duong_dan":"/api/ai/v1/{cid}/nhat-ky-chung","tham_so":"tu, den | ky, trang, so_dong","mo_ta":"Sổ nhật ký chung, từng dòng"},{"phuong_thuc":"GET","duong_dan":"/api/ai/v1/{cid}/so-chi-tiet-tk","tham_so":"tk (bắt buộc, vd 131,331), tu, den | ky","mo_ta":"Sổ chi tiết tài khoản"},{"phuong_thuc":"GET","duong_dan":"/api/ai/v1/{cid}/nhap-xuat-ton","tham_so":"tu, den | ky","mo_ta":"Nhập – xuất – tồn"},{"phuong_thuc":"GET","duong_dan":"/api/ai/v1/{cid}/bang-ke","tham_so":"loai (mua|ban), ky","mo_ta":"Bảng kê hóa đơn mua vào / bán ra của kỳ khai thuế"},{"phuong_thuc":"GET","duong_dan":"/api/ai/v1/{cid}/sao-ke","tham_so":"tu, den | ky, trang, so_dong","mo_ta":"Giao dịch ngân hàng đã nhập từ sao kê"},{"phuong_thuc":"GET","duong_dan":"/api/ai/v1/{cid}/cong-no-mo","tham_so":"tk (131|331), den","mo_ta":"Công nợ còn mở theo hóa đơn và tuổi nợ"},{"phuong_thuc":"GET","duong_dan":"/api/ai/v1/{cid}/bang-luong","tham_so":"ky (YYYY-MM)","mo_ta":"Bảng lương (không có CCCD, số tài khoản ngân hàng)"},{"phuong_thuc":"GET","duong_dan":"/api/ai/v1/{cid}/kiem-tra","tham_so":"tu, den | ky","mo_ta":"Kết quả bộ kiểm tra rủi ro / kiểm tra chuẩn"},{"phuong_thuc":"GET","duong_dan":"/api/ai/v1/{cid}/ban-giao","tham_so":"ky","mo_ta":"Trạng thái phiếu bàn giao các phần hành và ghi chú AI"},{"phuong_thuc":"POST","duong_dan":"/api/ai/v1/{cid}/ban-giao/ghi-chu","tham_so":"JSON {ky, phan_hanh, noi_dung, ma_kiem_tra?}","mo_ta":"Ghi kết quả kiểm tra của AI vào phiếu bàn giao (chỉ ghi chú; AI không ký, không đổi trạng thái). Cần khóa có quyền ghi chú."}]}