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.

Open API có hai môi trường. Lên môi trường thật chỉ đổi địa chỉ gốc và khóa, mã nguồn của bạn không đổi.

Môi trường

Địa chỉ gốc

Khóa

Thử (DEMO)

https://api-demo.nexerp.vn/api/open/v1

bắt đầu bằng nexk_demo_

Thật

do NexERP cung cấp cùng khóa

bắt đầu bằng nexk_live_

Ghép URL

URL của một request là địa chỉ gốc ghép với đường dẫn endpoint. Ví dụ tạo hóa đơn trên DEMO:

POST https://api-demo.nexerp.vn/api/open/v1/invoices

URL đầy đủ của mọi endpoint ở bài Danh sách API.

Gửi khóa

Mọi request gửi khóa trong header X-Api-Key. Không dùng Authorization: Bearer.

Các bài ví dụ dùng $BASE và $KEY:

export BASE="https://api-demo.nexerp.vn/api/open/v1"
export KEY="nexk_demo_DAN_KHOA_CUA_BAN_VAO_DAY"

Giới hạn của DEMO

Trên DEMO, hóa đơn là hóa đơn thử, không có giá trị pháp lý. Tài khoản hóa đơn điện tử thử không ký được, nên hóa đơn đi tới pending rồi dừng ở đó.

Trên DEMO bạn thử được:

  • tạo hóa đơn, gửi lại, chống trùng

  • tra cứu theo id và theo external_id

  • các mã lỗi

  • webhook, sự kiện queued → pending

Các trạng thái issued, cqt_accepted, link xem hóa đơn và hóa đơn thay thế chỉ chạy trọn trên môi trường thật.

Lưu ý

  • Khóa DEMO không dùng được trên môi trường thật và ngược lại.

  • Khóa chỉ hiện một lần lúc cấp. Mất khóa thì xin khóa mới.

  • Không để khóa trong mã nguồn công khai hay trên máy bán hàng không khóa màn hình.