/v1/invoices/templates/approve-quantityDuyệ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ý.
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ộcBearer token lấy từ API Lấy token.
api_keystringBắt buộcAPI 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ộcapplication/json.
Body
Object JSON có mảng items. Mỗi phần tử chỉ gồm id, quantity và quantity_previous.
itemsarrayBắt buộcDanh sách mẫu cần duyệt số lượng. Không được để mảng rỗng.
items[].idintegerBắt buộcId mẫu đã đăng ký (trường id trên Danh sách mẫu đã đăng ký).
items[].quantityintegerBắt buộcSố lượng muốn cấp sau khi duyệt.
items[].quantity_previousintegerBắt buộcSố 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 -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ộcLuôn là invoice_template_approve_quantity.
approvedintegerBắt buộcSố dòng mẫu đã duyệt trong request.
{
"object": "invoice_template_approve_quantity",
"approved": 1
}Mã lỗi
Các trường hợp thường gặp:
401 unauthorized—Tuỳ chọnThiế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ọnThiế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 đó.