hddt.dev
Tài liệuBảng giáTra cứu

Bắt đầu

  • Tổng quan
  • Bắt đầu nhanh
  • Xác thực
  • Môi trường sandbox
  • Mã lỗi

Ứng dụng

  • GETThông tin ứng dụng
  • PATCHCập nhật ứng dụng

Hoá đơn

  • POSTLấy token
  • GETLấy mẫu hoá đơn
  • GETDanh sách mẫu đã đăng ký
  • GETHạn mức hoá đơn
  • POSTTạo mẫu hoá đơn
  • POSTDuyệt số lượng hoá đơn
  • DELETEXoá mẫu chưa duyệt
  • POSTTạo hoá đơn
  • GETDanh sách hoá đơn
  • POSTKý hoá đơn nháp
  • GETTải hoá đơn PDF/XML
  • DELETEXoá hoá đơn nháp

Tra cứu

  • GETTra cứu mã số thuế

Webhook

  • GETDanh sách webhook
  • POSTThêm webhook
  • POSTNhận và kiểm tra
Trang chủTài liệuKý hoá đơn nháp
POST/v1/invoices/sign

Ký hoá đơn nháp

Ký một hoá đơn đã lưu nháp. Gửi invoice_code là UUID lấy từ data.id của API Tạo hoá đơn.

MarkdownOpenAPI

#Giới thiệu

API ký một hoá đơn đang ở trạng thái nháp. Tạo nháp bằng API Tạo hoá đơn với issue_mode bằng 0, rồi gửi UUID trong data.id vào invoice_code của API này.

Hoá đơn đã phát hành không ký lại bằng API này. Trên sandbox, hoá đơn không được gửi tới cơ quan thuế.

#Endpoint

Gửi POST với JSON. Sandbox: https://sandbox.api.hddt.dev. Live: https://api.hddt.dev.

Chỉ hoá đơn nháp

invoice_code phải là UUID của hoá đơn vừa lưu nháp. Hoá đơn đã phát hành hoặc không tồn tại sẽ không được ký.

#Header

Token, API key và App ID phải cùng ứng dụng, cùng môi trường.

AuthorizationstringBắt buộc

Bearer token lấy từ API Lấy token.

api_keystringBắt buộc

API key của ứng dụng.

app_idstringBắt buộc

Định danh ứng dụng (UUID). Sao chép App ID trên trang chi tiết ứng dụng (tab Kết nối & bảo mật).

Content-TypestringBắt buộc

application/json.

#Body

Chỉ gửi mã số của hoá đơn nháp cần ký.

invoice_codestringBắt buộc

UUID của hoá đơn nháp, lấy từ data.id của API Tạo hoá đơn.

#Ví dụ

Ký hoá đơn nháp có id 7c9e6679-7425-40de-944b-e07fc1f90ae7 trên sandbox.

cURL
curl -X POST https://sandbox.api.hddt.dev/v1/invoices/sign \
  -H "Authorization: Bearer $HDDT_TOKEN" \
  -H "api_key: $HDDT_API_KEY" \
  -H "app_id: $HDDT_APP_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "invoice_code": "7c9e6679-7425-40de-944b-e07fc1f90ae7"
  }'

#Phản hồi

Khi ký được hoá đơn, success là true. data là dữ liệu trả về sau khi ký.

successbooleanBắt buộc

true khi ký được hoá đơn, false khi thất bại.

dataobjectBắt buộc

Dữ liệu trả về khi ký thành công. Khi thất bại có thể trống.

error_codestringBắt buộc

Trống khi thành công. Khi thất bại là mã lỗi nghiệp vụ.

messagestringBắt buộc

Thông báo thành công hoặc thất bại.

Phản hồi
{
  "success": true,
  "data": {},
  "error_code": "",
  "message": "Thành công"
}

#Mã lỗi

Khi hoá đơn không được ký, success là false, error_code và message mô tả lỗi nghiệp vụ. Lỗi xác thực và định dạng của hddt.dev vẫn trả mã HTTP kèm error.code và error.message.

401 unauthorized—Tuỳ chọn

Thiếu token hoặc header api_key, token sai hoặc hết hạn, API key đã thu hồi, hoặc key không cùng ứng dụng và môi trường với token. Gọi lại API Lấy token nếu token hết hạn.

422 validation_error—Tuỳ chọn

Thiếu invoice_code.

Trước đóDanh sách hoá đơnTiếp theoTải hoá đơn PDF/XML
Trang này có hữu ích không?
Cập nhật lần cuối: 06/11/2026

Trên trang này

  • Giới thiệu
  • Endpoint
  • Header
  • Body
  • Ví dụ
  • Phản hồi
  • Mã lỗi
Đăng nhậpBắt đầu ngay