eHoadon: trạng thái hỗ trợ trong omniVN

Cần hỗ trợ từ provider

Chỉ sandbox SOAP trong Omni0. REST docs eHoadon mô tả tài khoản API; PartnerGUID/Token là legacy SOAP.

Cần liên hệ provider để lấy credential

Cần hỗ trợ từ provider. Hóa đơn từ sandbox SOAP. Official REST contract khác với code đang chạy. Trang này được liệt kê trong workspace.

Giới hạn hiện tại

Những điểm này ảnh hưởng đến khả năng kết nối hoàn chỉnh.

Chỉ hỗ trợ sandbox SOAP trong code hiện tại.
REST Web API và SOAP dùng credential khác nhau.
PartnerGUID/PartnerToken thường cần eHoadon cấp cho đối tác.

Tổng quan

Code Omni0 hiện dùng eHoadon sandbox SOAP (PartnerGUID + PartnerToken). Tài liệu công khai docs.ehoadon.online mô tả thêm REST Web API (tài khoản người dùng API) — không thay thế flow SOAP đang chạy.

Điều kiện trước khi bắt đầu

Tài khoản eHoaDon Online (sandbox nếu test SOAP Omni0).
Quyền Quản trị người dùng để tạo tài khoản API (REST).
PartnerGUID/PartnerToken: liên hệ eHoadon/BKAV cho tích hợp SOAP.

Các bước lấy credential

1. REST — Tạo tài khoản người dùng API

Đăng nhập eHoaDon Online → Hệ thống → Quản trị người dùng → Thêm mới. Ở cột Thông tin API, chọn + để thêm tài khoản API và lưu thông tin truy cập.

eHoadon — thêm tài khoản API trên lưới người dùng · docs.ehoadon.online

2. REST — Xem thông tin truy cập API

Chọn biểu tượng key trên user, nhập mật khẩu người dùng và Hiển thị để xem credential REST (email/password/tenant theo flow REST).

eHoadon — thông tin truy cập API · docs.ehoadon.online

3. SOAP sandbox (Omni0 hiện tại)

Omni0 Invoice form yêu cầu sandbox account id, PartnerGUID và PartnerToken do eHoadon cấp cho đối tác SOAP. Lấy theo hướng dẫn Tạo token trên docs.ehoadon.online hoặc liên hệ hỗ trợ — không dùng credential REST ở bước trên.

4. Điền vào Omni0

Invoice → eHoadon: externalAccountId, PartnerGUID, PartnerToken (SOAP sandbox).

Ánh xạ credential với omniVN

Cột "Lấy từ đâu" cho biết giá trị do người dùng nhập, do provider cấp, do omniVN quản lý, hay do OAuth sinh ra.

Field omniVN	Tên trong tài liệu official	Bắt buộc	Lấy từ đâu
Sandbox account id	Tài khoản sandbox	Bắt buộc	user_entered
Partner GUID	PartnerGUID	Bắt buộc	provider_generated eHoadon cấp cho đối tác tích hợp SOAP. REST docs không thay thế được.
Partner token	PartnerToken	Bắt buộc	provider_generated

externalAccountId → Sandbox account id; partnerGuid → PartnerGUID; partnerToken → PartnerToken (SOAP). REST credentials không map trực tiếp vào form hiện tại.

Vòng đời token

PartnerToken SOAP do eHoadon cấp; làm mới qua eHoadon. REST token theo flow Tạo token trên docs.ehoadon.online.

Nguồn chính thức

eHoadon - Tạo tài khoản người dùng API

docs.ehoadon.online·Công khai·Đã kiểm chứng 2026-08-29

eHoadon - Tạo token

docs.ehoadon.online·Công khai·Đã kiểm chứng 2026-08-29