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.

Tra cứu theo id NexERP trả về, hoặc theo external_id của bạn. Cả hai trả cùng một khối trạng thái.

Endpoint: GET /invoices/{id} và GET /invoices?external_id=..., phạm vi invoices.read.

Request

Theo id:

GET https://api-demo.nexerp.vn/api/open/v1/invoices/{id}

Theo external_id:

GET https://api-demo.nexerp.vn/api/open/v1/invoices?external_id={external_id}

Trên môi trường thật, thay phần địa chỉ gốc bằng địa chỉ NexERP cấp. Header: X-Api-Key.

Tham số	Nằm ở	Kiểu	Ý nghĩa
`id`	đường dẫn	chuỗi UUID	`id` NexERP trả về lúc tạo hóa đơn
`external_id`	query	chuỗi, 1 đến 100 ký tự	Mã giao dịch bạn gửi lúc tạo

Phản hồi

HTTP 200 với Khối trạng thái hóa đơn. Không có hóa đơn thì 404 invoice.not_found.

curl -s "$BASE/invoices/0b3c5a2e-6f43-4f0e-9a52-6e2f6d6a7c11" -H "X-Api-Key: $KEY"
curl -s "$BASE/invoices?external_id=CN5-P03-V2-20261022-000123" -H "X-Api-Key: $KEY"

Ví dụ hóa đơn đã phát hành:

{
  "id": "0b3c5a2e-6f43-4f0e-9a52-6e2f6d6a7c11",
  "external_id": "CN5-P03-V2-20261022-000123",
  "status": "confirmed",
  "sold_at": "2026-10-22",
  "invoice_date": "2026-10-22",
  "einvoice_status": "cqt_accepted",
  "einvoice": {
    "number": "00000123",
    "serial": "1C26MLB",
    "template": "1",
    "lookup_code": "A1B2C3D4E5F6",
    "issued_at": "2026-10-22T07:41:40+07:00",
    "view_url": "https://tracuu.vidu.example/invoice/A1B2C3D4E5F6",
    "error": null
  },
  "replaced_by": null,
  "replaces": null
}

status là trạng thái hóa đơn trong NexERP, là confirmed ngay sau khi tạo.

Trạng thái hóa đơn điện tử

`einvoice_status`	Ý nghĩa	Bạn làm gì
`queued`	Đã xếp hàng phát hành	Chờ
`pending`	Đang phát hành	Chờ
`issued`	Đã phát hành, có số hóa đơn	Xong, có thể chờ mã cơ quan thuế
`cqt_accepted`	Cơ quan thuế đã cấp mã hoặc chấp nhận	Xong
`error`	Phát hành lỗi, xem `einvoice.error`	Báo doanh nghiệp. Kế toán xử lý trên NexERP
`cqt_rejected`	Cơ quan thuế từ chối	Báo doanh nghiệp. Không thay thế qua API được
`cancelled`	Đã hủy	Trạng thái cuối
`replaced`	Đã bị hóa đơn thay thế thay	Trạng thái cuối. Xem `replaced_by`
`duplicate_hold`, `check_failed`	NexERP đang giữ lại để kiểm tra	Chờ, kế toán xử lý

Lưu ý

GET chỉ đọc dữ liệu đã lưu, không bao giờ chờ nhà cung cấp hóa đơn điện tử. Gọi thoải mái trong giới hạn tần suất.
Có thể xuất hiện trạng thái mới trong tương lai. Hãy coi giá trị lạ là "chưa xong" và đừng báo lỗi.
Hóa đơn của ứng dụng khác hoặc doanh nghiệp khác trả 404 invoice.not_found.