# Duyệt số lượng hoá đơn > Chỉ dùng endpoint, field, mã lỗi và ví dụ trong trang này. Không thêm API chưa được mô tả ở đây. `POST /v1/invoices/templates/approve-quantity` 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ý. ## 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. Vị trí: header. | Trường | Kiểu | Bắt buộc | Mô tả | | --- | --- | --- | --- | | `Authorization` | string | có | Bearer token lấy từ API Lấy token. | | `api_key` | string | có | API key của ứng dụng. | | `app_id` | string | 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-Type` | string | có | application/json. | ## Body Object JSON có mảng items. Mỗi phần tử chỉ gồm id, quantity và quantity_previous. Vị trí: body JSON. | Trường | Kiểu | Bắt buộc | Mô tả | | --- | --- | --- | --- | | `items` | array | có | Danh sách mẫu cần duyệt số lượng. Không được để mảng rỗng. | | `items[].id` | integer | có | Id mẫu đã đăng ký (trường id trên Danh sách mẫu đã đăng ký). | | `items[].quantity` | integer | có | Số lượng muốn cấp sau khi duyệt. | | `items[].quantity_previous` | integer | 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: ```bash 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. | Trường | Kiểu | Bắt buộc | Mô tả | | --- | --- | --- | --- | | `object` | string | có | Luôn là invoice_template_approve_quantity. | | `approved` | integer | có | Số dòng mẫu đã duyệt trong request. | 200 OK: ```json { "object": "invoice_template_approve_quantity", "approved": 1 } ``` ## Mã lỗi Các trường hợp thường gặp: | Trường | Kiểu | Bắt buộc | Mô tả | | --- | --- | --- | --- | | `401 unauthorized` | — | không | 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` | — | không | Thiếu items, mảng rỗng, hoặc một dòng thiếu id, quantity hoặc quantity_previous. | | `502 bad_gateway` | — | không | Ứ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 đó. | Trang HTML: /docs/invoices/templates/approve-quantity Cập nhật: 06/11/2026