aiaccountingloop.com
Máy làm việc của developer với trình soạn thảo mã

Bề mặt API cho developer

Hướng dẫn tích hợp trước khi mở endpoint rộng

Bề mặt developer chuẩn bị cho team cách tiếp cận auth, tích hợp có tenant, event handling, guided submission và workflow kế toán có governance theo từng quốc gia trước khi mở rộng API public.

Mở docs Mở help Hub luật Việt Nam

Định hướng public

Những gì bề mặt developer đang chuẩn bị

Auth và tenancy

Identity, tenant scoping, role-aware access và session behavior an toàn cho evidence.

Document và intake flow

File intake, validation, queueing, review state và lineage của record cho workflow kế toán.

Events và webhooks

Thay đổi trạng thái, review outcome, guided submission progress, export package handoff và event delivery có audit là một phần của roadmap.

Tích hợp theo country

Mọi bề mặt tích hợp đều phải theo scope của country pack đã duyệt, đúng hub luật và đúng truth đã đồng bộ giữa docs/help/API.

Release posture

Bề mặt API mở theo từng tầng có kiểm soát

  1. Công bố terminology, lifecycle và integration guidance trước.
  2. Công bố giả định về auth, evidence và tenant trước khi mở endpoint rộng.
  3. Giữ tài liệu developer bám cùng product truth như docs và help.
  4. Mở route tích hợp cho partner và pilot chỉ sau khi release governance duyệt.
  5. Giữ truth về route quốc gia và switcher thật chặt để không trang API nào làm người đọc hiểu rằng một quốc gia đã live trước khi đủ country pack, hub luật, docs/help/API đồng bộ, phê duyệt pháp lý và gate điều hướng.
  6. Giữ changelog, versioning và support boundary rõ khi bề mặt mở rộng.
Hình dữ liệu trừu tượng và kế hoạch tích hợp

Guardrail cho developer

Những gì bị khóa trên bề mặt API public

Không đưa secret lên client

Secret, token sống dài và credential có đặc quyền không được xuất hiện trong client code hoặc snippet public.

Contract phải có version

Schema dùng chung và contract tích hợp cần có change posture được mô tả trước khi mở rộng partner use.

Scope theo quốc gia

Mọi claim tích hợp phải khớp với country pack, filing mode và support reality đã duyệt cho quốc gia đó. Với Việt Nam hiện tại, đường đi public-safe dừng ở guided submission và export package.

Không mở host quốc gia khi chưa qua gate

vn.aiaccountingloop.com là host quốc gia đầu tiên đã qua governance. Không host quốc gia, mục dropdown hay lane điều hướng tự động nào khác được xuất hiện trên bề mặt API trước khi gate đầy đủ có hiệu lực.

Audit và evidence đi trước

Event history quan sát được và workflow an toàn cho evidence đi trước các tính năng tiện lợi.

Giá API public và việc công bố endpoint rộng vẫn đang private tính đến ngày 13/04/2026. Trang này khóa định hướng developer có governance, không phải gói thương mại public.

Lane luật quốc gia đầu tiên đã được governance là Việt Nam tại /vi/countries/vn/, đi cùng host quốc gia đầu tiên là vn.aiaccountingloop.com.