Hóa đơn điện tử

Config → API Invoice. Nhà cung cấp HĐĐT, thông tin kết nối và ánh xạ trường nội bộ sang XML/JSON của họ.

Mục đích

Folio niTel là hóa đơn nội bộ. HĐĐT là chứng từ thuế. Màn hình này nối hai bên: chọn nhà cung cấp, điền MST/tài khoản API, map từng trường (tên hàng, tiền, thuế) sang tên field họ đòi.

Chọn nhà cung cấp

Ô chọn danh sách provider đã có, hoặc Customize để tạo bộ riêng. Mỗi provider: tên, mã, loại API, Base URL, username, password, MST, email, kiểu xác thực (None, Basic, Bearer, OAuth2), credentials.

• check_circleBase URL: môi trường thật, không phải sandbox, khi đã live.
• check_circleMST: trùng MST trên Hotel Info.
• check_circleAuth: Basic/Bearer/OAuth2 theo tài liệu nhà cung cấp. Sai auth thì Connect API thất bại dù MST đúng.
• check_circleCustomize: copy khung field từ mẫu rồi điền tên field ngoài. Dùng khi nhà cung cấp chưa có trong danh mục.

Field Mappings

Cột Internal = tên trong niTel. External = tên bên HĐĐT. Type và Required do mẫu provider. Chỉ sửa External cho khớp tài liệu họ. Field required mà để trống: xuất HĐ lỗi lúc trả phòng.

Connect / Test / Save

• check_circleConnect API: thử đăng nhập endpoint.
• check_circleTest API: gửi gói mẫu, chưa phải hóa đơn khách thật.
• check_circleSave: ghi mapping và thông tin provider.

Nghiệp vụ: làm trên sandbox trước. Bật VAT Auto trên Systems chỉ sau khi Test OK. Mapping sai số tiền (net/gross) làm lệch tờ khai — để kế toán đọc một hóa đơn test.

Cách dùng

1. 1Hoàn tất Hotel Info (MST, địa chỉ) và Systems (Manual phát hành).
2. 2Mở Config → API Invoice.
3. 3Chọn nhà cung cấp hoặc Customize.
4. 4Điền URL, tài khoản, MST.
5. 5Map field required.
6. 6Connect, rồi Test.
7. 7Save. Xuất một folio giả. Đối chiếu PDF/XML với kế toán.