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.

Open API cho phần mềm của đối tác tạo hóa đơn bán trên NexERP, ví dụ phần mềm trạm bơm xăng. NexERP ghi nhận hóa đơn rồi phát hành hóa đơn điện tử ở chế độ nền.

Địa chỉ gốc DEMO: https://api-demo.nexerp.vn/api/open/v1.

Cách hoạt động

  • Mỗi request tạo một hóa đơn bán.

  • API tạo hóa đơn trả về ngay (HTTP 202). Nó không chờ nhà cung cấp hóa đơn điện tử.

  • Số hóa đơn và mã cơ quan thuế đến sau, vài giây đến vài phút. Bạn lấy chúng bằng GET hoặc nhận webhook.

  • Gửi lại request của cùng một giao dịch không tạo hóa đơn thứ hai. Xem Chống tạo trùng.

Phần mềm trụ bơm chỉ có dữ liệu bơm thì dùng Gửi giao dịch bơm. Bạn gửi dữ liệu bơm, cửa hàng xuất hóa đơn trên NexERP.

Hai lớp duyệt

  1. NexERP duyệt công ty bạn là đối tác. Việc này làm một lần.

  2. Chủ doanh nghiệp đồng ý cho ứng dụng của bạn vào dữ liệu của họ, đúng các phạm vi đã xin và các cửa hàng đã chọn.

NexERP gửi cho bạn

Bạn không tự tạo khóa. Sau khi duyệt xong, NexERP gửi:

  • khóa API, chỉ hiện một lần, hãy cất kỹ

  • danh sách mã cửa hàng (store_code) được dùng

  • địa chỉ gốc của môi trường thật

  • bí mật ký webhook, nếu bạn dùng webhook

Muốn nhận webhook, bạn gửi địa chỉ nhận (https) cho NexERP để gắn vào.

Mỗi khóa thuộc đúng một doanh nghiệp. Khóa không đọc được hóa đơn do ứng dụng khác tạo, hay hóa đơn của doanh nghiệp khác. Các hóa đơn đó trả 404.

Tài liệu máy đọc

Bản OpenAPI của đúng các endpoint trong bộ bài này nằm ở GET /api/open/v1/openapi.json. Trang thử nhanh ở GET /api/open/v1/docs. Hai địa chỉ này không cần khóa API.

Lưu ý