EInvoice
Cổng chuyển tiếp hóa đơn điện tử, không dùng DB; tài khoản BKAV mặc định nằm ở cấu hình cổng. Đầu vào chung /api/invoices dùng một định dạng hóa đơn cho mọi nhà
cung cấp; gateway tự đổi sang định dạng của nhà cung cấp được chọn. API riêng của từng nhà cung cấp nằm ở
/api/<nhà-cung-cấp>/... (hiện có BKAV eHoadon).
Cách gọi
- Ký mỗi request bằng HMAC: header
X-Client-Id,X-Timestamp,X-Nonce,X-Signature(xem README, mục Xác thực). - Mọi lệnh gọi nhà cung cấp là
POSTvới body JSON./api/invoicesgửiProvider { Id, Config }(BKAV:ConfiggồmUserName,Password,IsDemo). Tài khoản BKAV (PartnerGuid,PartnerToken) lấy từ cấu hình cổng theo môi trường (Bkav:DemohoặcBkav:Production, chọn bằngIsDemo); request chỉ gửi khi muốn ghi đè (/api/bkav/...dùng trườngConnection). - Tạo hóa đơn gửi toàn bộ dữ liệu hóa đơn; các thao tác sau chỉ cần
ReferenceId. Hệ thống gọi tự lưu kết quả trả về. - Kết quả là JSON; lỗi trả về
application/problem+json. - Tài liệu đầy đủ: /openapi.json.
Endpoint (43)
| Nhóm | Method | Đường dẫn |
|---|---|---|
| BkavBills | POST | /api/bkav/bills |
| BkavBills | POST | /api/bkav/bills/invoices |
| BkavBills | POST | /api/bkav/bills/lookup |
| BkavBusinesses | POST | /api/bkav/businesses/lookup |
| BkavCatalogs | GET | /api/bkav/catalogs |
| BkavInvoiceQueries | POST | /api/bkav/invoices/by-date |
| BkavInvoiceQueries | POST | /api/bkav/invoices/files/04ss |
| BkavInvoiceQueries | POST | /api/bkav/invoices/get |
| BkavInvoiceQueries | POST | /api/bkav/invoices/history |
| BkavInvoiceQueries | POST | /api/bkav/invoices/links/04ss |
| BkavInvoiceQueries | POST | /api/bkav/invoices/links/converted |
| BkavInvoiceQueries | POST | /api/bkav/invoices/links/display |
| BkavInvoiceQueries | POST | /api/bkav/invoices/lookup/converted |
| BkavInvoiceQueries | POST | /api/bkav/invoices/lookup/display |
| BkavInvoiceQueries | POST | /api/bkav/invoices/lookup/xml |
| BkavInvoiceQueries | POST | /api/bkav/invoices/number-range |
| BkavInvoiceQueries | POST | /api/bkav/invoices/pdf |
| BkavInvoiceQueries | POST | /api/bkav/invoices/status |
| BkavInvoiceQueries | POST | /api/bkav/invoices/tax-status |
| BkavInvoiceQueries | POST | /api/bkav/invoices/xml |
| BkavInvoices | POST | /api/bkav/invoices |
| BkavInvoices | PUT | /api/bkav/invoices |
| BkavInvoices | POST | /api/bkav/invoices/adjustments |
| BkavInvoices | POST | /api/bkav/invoices/attachments |
| BkavInvoices | POST | /api/bkav/invoices/cancel |
| BkavInvoices | POST | /api/bkav/invoices/delete |
| BkavInvoices | POST | /api/bkav/invoices/explanations |
| BkavInvoices | POST | /api/bkav/invoices/explanations/replaced-adjusted |
| BkavInvoices | POST | /api/bkav/invoices/replacements |
| BkavInvoices | POST | /api/bkav/invoices/resend |
| BkavInvoices | POST | /api/bkav/invoices/resend/contacts |
| BkavInvoices | POST | /api/bkav/invoices/sign |
| BkavInvoices | POST | /api/bkav/invoices/sign/many |
| BkavQrCode | POST | /api/bkav/qrcode/parse |
| BkavReports | POST | /api/bkav/reports/bc26 |
| BkavReports | POST | /api/bkav/reports/listing |
| Invoices | POST | /api/invoices |
| Invoices | POST | /api/invoices/cancel |
| Invoices | POST | /api/invoices/delete |
| Invoices | POST | /api/invoices/get |
| Invoices | POST | /api/invoices/pdf |
| Invoices | POST | /api/invoices/publish |
| Invoices | POST | /api/invoices/xml |