Phát hành hóa đơn điện tử (nháp)

API phát hành hóa đơn điện tử nhận mã tham chiếu của hóa đơn xuất bản nháp, thực hiện phát hành chính thức và trả về mã tham chiếu để theo dõi trạng thái phát hành.

API Endpoint

POST

https://einvoice-api-sandbox.sepay.vn/v1/invoices/issue

API Request

reference_codestringrequired

Mã tham chiếu hóa đơn nháp đã tạo trước đó

API Response

Response thành công (200)

{
  "success": true,
  "data": {
    "tracking_code": "084e179d-d95a-11f0-aef4-52c7e9b4f41b",
    "tracking_url": "https://einvoice-api-sandbox.sepay.vn/v1/invoices/issue/check/084e179d-d95a-11f0-aef4-52c7e9b4f41b",
    "message": "Đã tạo yêu cầu xuất bán hóa đơn điện tử"
  }
}

successboolean

dataobject

Xử lý lỗi

400Bad Request

Thiếu hoặc sai reference_code.

401Unauthorized

Thiếu hoặc sai Bearer token.

404Not Found

Không tìm thấy hóa đơn nháp theo reference_code.

Lưu ý

Chỉ phát hành đối với những hóa đơn đã xuất nháp trước đó (is_draft=true)
reference_code có thể tra cứu qua API danh sách hóa đơn với những hóa đơn có status là draft hoặc lấy từ reference_code sau khi kiểm tra trạng thái tạo hóa đơn nháp thành công
Sau khi gửi yêu cầu phát hành hóa đơn thành công, sử dụng endpoint được cung cấp qua tracking_url để gọi API theo dõi trạng thái phát hành hóa đơn

Code mẫu

curl --request POST \
  --url https://einvoice-api-sandbox.sepay.vn/v1/invoices/issue \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN' \
  --header 'content-type: application/json' \
  --data '{"reference_code":"084e179d-d95a-11f0-aef4-52c7e9b4f41b"}'

Bước tiếp theo

Sau khi gửi yêu cầu phát hành thành công và nhận được tracking_code:

Theo dõi trạng thái phát hành hóa đơn - Sử dụng tracking_code để kiểm tra kết quả phát hành (bắt buộc)