API phát hành hóa đơn từ nháp

API Endpoint

POST

https://einvoice-api.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.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.

422REGISTRATION_NOT_TAX_APPROVED

Chưa đăng ký HĐĐT hoặc CQT chưa duyệt tờ khai.

422INVOICE_DATE_BEFORE_TAX_APPROVAL

Ngày hóa đơn trước ngày CQT duyệt. Xem tax_authority_approved_date trong GET /v1/provider-accounts.

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.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)