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ệuDuyệt số lượng hoá đơn
POST/v1/invoices/templates/approve-quantity

Duyệt số lượng hoá đơn

Cấp hoặc cập nhật số lượng hoá đơn cho một hoặc nhiều mẫu đã đăng ký trên trang quản lý.

MarkdownOpenAPI

#Giới thiệu

API duyệt số lượng cho từng mẫu đã đăng ký. Mỗi dòng chỉ cần id mẫu, số lượng muốn cấp và số lượng trước đó.

Gọi endpoint này sau khi đã lấy token. Header Authorization dùng token đó. Gửi thêm API key trong header api_key và App ID trong header app_id. Các giá trị phải cùng ứng dụng, cùng môi trường.

Không gửi username hay password trang quản lý hoá đơn trong request. Hệ thống dùng tài khoản đã gắn với ứng dụng trên trang quản trị để đăng nhập và xử lý phần mẫu hoá đơn.

#Endpoint

Gửi POST với body JSON. Host phải cùng môi trường với token. Sandbox: https://sandbox.api.hddt.dev. Live: https://api.hddt.dev.

#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

Object JSON có mảng items. Mỗi phần tử chỉ gồm id, quantity và quantity_previous.

itemsarrayBắt buộc

Danh sách mẫu cần duyệt số lượng. Không được để mảng rỗng.

items[].idintegerBắt buộc

Id mẫu đã đăng ký (trường id trên Danh sách mẫu đã đăng ký).

items[].quantityintegerBắt buộc

Số lượng muốn cấp sau khi duyệt.

items[].quantity_previousintegerBắt buộc

Số lượng trước khi duyệt, lấy từ quantity hiện tại của mẫu.

#Ví dụ

Duyệt 10 hoá đơn cho mẫu id 13362 trên sandbox.

cURL
curl -X POST https://sandbox.api.hddt.dev/v1/invoices/templates/approve-quantity \
  -H "Authorization: Bearer $HDDT_TOKEN" \
  -H "api_key: $HDDT_API_KEY" \
  -H "app_id: $HDDT_APP_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      {
        "id": 13362,
        "quantity": 10,
        "quantity_previous": 10
      }
    ]
  }'

#Phản hồi

Khi duyệt thành công, API trả 200 OK.

objectstringBắt buộc

Luôn là invoice_template_approve_quantity.

approvedintegerBắt buộc

Số dòng mẫu đã duyệt trong request.

200 OK
{
  "object": "invoice_template_approve_quantity",
  "approved": 1
}

#Mã lỗi

Các trường hợp thường gặp:

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 items, mảng rỗng, hoặc một dòng thiếu id, quantity hoặc quantity_previous.

502 bad_gateway—Tuỳ chọn

Ứng dụng chưa được gắn tài khoản trang quản lý hoá đơn, hoặc hệ thống không đăng nhập được bằng tài khoản đó.

Trước đóTạo mẫu hoá đơnTiếp theoXoá mẫu chưa duyệt
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