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

Phát hành hóa đơn điện tử từ mã tham chiếu nháp qua SePay eInvoice API. Trả về mã tracking để theo dõi trạng thái phát hành với cơ quan thuế.

||

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

Khi API trả về một trong các lỗi dưới đây, hóa đơn chưa được phát hành và sẽ không được gửi lên cơ quan thuế.

400REFERENCE_CODE_REQUIRED

Thiếu reference_code trong body.

401UNAUTHORIZED

Thiếu hoặc sai Bearer token.

500EINVOICE_DRAFT_NOT_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.

500REGISTRATION_NOT_COMPLETE

Công ty chưa hoàn tất đăng ký gói hóa đơn điện tử.

500BILLING_IS_UNPAID

Công ty chưa thanh toán cho gói hóa đơn điện tử.

500QUOTA_HAS_BEEN_USERD_UP

Đã dùng hết hạn ngạch của gói hóa đơn điện tử, cần gia hạn để tiếp tục phát hành.

405METHOD_NOT_ALLOWED

Gọi sai HTTP method của endpoint.

500CREATE_INVOICE_DATA_FAIL

Lỗi hệ thống khi xử lý yêu cầu phát hành.

Lưu ý

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:

  1. 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)
Trước
—
Tiếp theo
—