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 đó.

Tra một giao dịch bơm theo id_log để biết cửa hàng đã xuất hóa đơn chưa.

Endpoint: GET /pump-logs?id_log=, phạm vi invoices.read.

Request

GET https://api-demo.nexerp.vn/api/open/v1/pump-logs?id_log=CH01-V03-20261028-000123

curl -s "$BASE/pump-logs?id_log=CH01-V03-20261028-000123" -H "X-Api-Key: $KEY"

Giao dịch không phải của ứng dụng bạn, hoặc không có, trả 404 log.not_found.

Khối giao dịch bơm

POST /pump-logs và GET /pump-logs trả cùng một khối:

{
  "id": "5d0f1c3a-8e2b-4b7a-9c61-0a4f2e7d9b10",
  "id_log": "CH01-V03-20261028-000123",
  "store_code": "CH01",
  "status": "invoiced",
  "pumped_at": "2026-10-28T03:45:00Z",
  "received_at": "2026-10-28T03:45:02Z",
  "due_at": "2026-10-28T03:55:00Z",
  "invoice": {
    "id": "0b3c5a2e-6f43-4f0e-9a52-6e2f6d6a7c11",
    "external_id": "CH01-V03-20261028-000123",
    "status": "confirmed",
    "sold_at": "2026-10-28",
    "invoice_date": "2026-10-28",
    "einvoice_status": "issued",
    "einvoice": { "number": "00000123", "serial": "1C26MLB", "template": "1", "lookup_code": "A1B2C3", "issued_at": "2026-10-28T03:46:10Z", "view_url": "https://…", "error": null },
    "replaced_by": null,
    "replaces": null
  },
  "error": null
}

Trường	Kiểu	Ý nghĩa
`id`	chuỗi UUID	Mã NexERP của giao dịch
`id_log`	chuỗi	Mã giao dịch bạn gửi
`store_code`	chuỗi	Cửa hàng của giao dịch
`status`	chuỗi	Trạng thái giao dịch, bảng bên dưới
`pumped_at`	chuỗi thời điểm	Thời điểm bơm xong, giờ UTC
`received_at`	chuỗi thời điểm	Lúc NexERP nhận, giờ UTC
`due_at`	chuỗi thời điểm	Hạn NexERP tự xuất cho người tiêu dùng nếu cửa hàng chưa xuất, giờ UTC
`invoice`	đối tượng hoặc `null`	Khối trạng thái hóa đơn khi đã có hóa đơn. Luôn `null` khi `closed`
`error`	đối tượng hoặc `null`	`code` và `message` khi `status` là `failed`

Trạng thái

`status`	Ý nghĩa	Bạn làm gì
`pending`	Đang chờ cửa hàng xuất hóa đơn	Chờ. Quá `due_at` NexERP tự xuất
`invoiced`	Đã có hóa đơn. Theo dõi `invoice.einvoice_status`	Xong phía bạn
`failed`	Lập hóa đơn lỗi, xem `error`	Không cần gửi lại. Cửa hàng xử lý rồi xuất lại trên NexERP
`closed`	Cửa hàng đã lập hóa đơn ngoài hàng chờ NexERP và đóng giao dịch. NexERP không xuất hóa đơn cho giao dịch này nữa	Không cần gửi lại. Xong phía bạn

closed là trạng thái cuối: giao dịch không quay lại hàng chờ và không có hóa đơn trên NexERP, nên GET /invoices?external_id=<id_log> trả 404. Gửi lại đúng nội dung cũ vẫn nhận 200 kèm khối closed.

Hóa đơn và webhook

Khi giao dịch thành hóa đơn, id_log trở thành external_id của hóa đơn đó. Vì vậy:

GET /invoices?external_id=<id_log> trả hóa đơn của giao dịch. Xem Tra cứu hóa đơn.
Webhook invoice.einvoice_status_changed gửi khi trạng thái hóa đơn điện tử đổi, với external_id là id_log. Xem Sự kiện webhook.

Lưu ý

GET chỉ đọc dữ liệu NexERP, không gọi nhà cung cấp hóa đơn điện tử.
Link xem hóa đơn lấy bằng GET /invoices/{id}/link với invoice.id.