/v1/invoices/templates/{id}Xoá mẫu chưa duyệt
Xoá một mẫu hoá đơn đã tạo nhưng chưa được duyệt số lượng trên trang quản lý.
Giới thiệu
API xoá mẫu đã tạo khi mẫu chưa được duyệt số lượng. Mẫu đã có số lượng sẽ bị từ chối.
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 DELETE với id mẫu trên đường dẫn. Host phải cùng môi trường với token. Sandbox: https://sandbox.api.hddt.dev. Live: https://api.hddt.dev.
Chỉ mẫu chưa duyệt số lượng
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).
Ví dụ
Request mẫu trên sandbox.
curl -X DELETE https://sandbox.api.hddt.dev/v1/invoices/templates/15899 \
-H "Authorization: Bearer $HDDT_TOKEN" \
-H "api_key: $HDDT_API_KEY" \
-H "app_id: $HDDT_APP_ID"Phản hồi
Khi xoá thành công, API trả 200 OK.
idstringBắt buộcId mẫu vừa xoá.
objectstringBắt buộcLuôn là invoice_template_registration.
deletedbooleanBắt buộcLuôn là true.
{
"id": "15899",
"object": "invoice_template_registration",
"deleted": true
}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.
404 not_found—Tuỳ chọnKhông có mẫu khớp id.
409 conflict—Tuỳ chọnMẫu đã được duyệt số lượng. Chỉ xoá được mẫu có số lượng còn trống.
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 đó.