Tích hợp

Kết nối phần mềm của đối tác qua Open API: tạo hóa đơn bán, tra cứu, webhook.

• Danh sách API — Các endpoint của Open API v1 kèm URL đầy đủ, header bắt buộc, phạm vi khóa và cách kiểm tra khóa bằng GET /me.
• Môi trường và khóa API — Địa chỉ gốc và tiền tố khóa của môi trường thử (DEMO) và môi trường thật, cách gửi khóa trong request.
• Tổng quan Open API — Phần mềm của đối tác gọi Open API để tạo hóa đơn bán trên NexERP ngay khi giao dịch bán xong.
• Các trường hóa đơn — Kiểu, quy tắc và ví dụ của từng trường trong thân request tạo hóa đơn, dòng hàng, người mua và trụ bơm.
• Chống tạo trùng — Dùng external_id để gửi lại an toàn khi lỗi mạng mà không tạo hóa đơn thứ hai.
• Hóa đơn thay thế — Lập hóa đơn thay thế cho hóa đơn đã phát hành mà sai, kèm lý do và external_id mới.
• Khối trạng thái hóa đơn — Ý nghĩa từng trường của khối trạng thái hóa đơn mà API tạo, tra cứu, thay thế và webhook đều trả về.
• Link xem hóa đơn — Lấy link xem hóa đơn điện tử đã phát hành, hoặc link PDF mới từ nhà cung cấp.
• Ngày bán và ngày hóa đơn — Phân biệt sold_at và invoice_date, giới hạn thời điểm bán và trường hợp kỳ thuế đã khóa.
• Người mua — Cách NexERP ghi người mua trên hóa đơn theo mã số thuế, số định danh hoặc bán cho người tiêu dùng.
• Tạo hóa đơn — Gửi một giao dịch bán để NexERP lập hóa đơn bán và xếp hàng phát hành hóa đơn điện tử.
• Thành tiền và số lượng — Thành tiền khách trả là gốc của mỗi dòng. Quy tắc số lượng và làm tròn theo từng nhóm thuế suất.
• Tra cứu hóa đơn — Lấy trạng thái, số hóa đơn và mã tra cứu theo id NexERP hoặc theo external_id của bạn.
• Các trường giao dịch bơm — Kiểu, quy tắc và ví dụ của từng trường trong một giao dịch bơm gửi lên NexERP.
• Gửi giao dịch bơm — Phần mềm trụ bơm gửi từng giao dịch hoặc cả lô; cửa hàng xuất hóa đơn trên NexERP.
• Tra cứu giao dịch bơm — Xem trạng thái một giao dịch bơm và hóa đơn cửa hàng đã xuất từ giao dịch đó.
• Phản hồi và gửi lại — Mã HTTP máy nhận trả về quyết định NexERP dừng hay gửi lại webhook, kèm lịch gửi lại.
• Sự kiện webhook — NexERP gửi webhook mỗi khi trạng thái hóa đơn điện tử đổi, để bạn khỏi phải hỏi liên tục.
• Xác minh chữ ký — Kiểm tra header X-Nex-Signature bằng HMAC-SHA256 trên thân thô, kèm mã mẫu Node.js, Python, C#, PHP.
• Câu hỏi thường gặp — Các câu hỏi hay gặp khi tích hợp Open API: gửi lại, thành tiền, ngày hóa đơn, webhook, thuế suất.
• Giới hạn tần suất — Số request tối đa mỗi phút, cách xử lý mã 429 và giới hạn phát hành của nhà cung cấp hóa đơn điện tử.
• Mã lỗi — Khung lỗi chung của Open API và bảng mã lỗi kèm việc cần làm cho từng mã.