# Xoá mẫu chưa duyệt > 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. `DELETE /v1/invoices/templates/{id}` 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:** Lấy id từ Danh sách mẫu đã đăng ký. Mẫu đã được cấp số lượng không xoá được. Thao tác không hoàn tác được. ## 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). | ## Param Nằm trên đường dẫn. Vị trí: đường dẫn. | Trường | Kiểu | Bắt buộc | Mô tả | | --- | --- | --- | --- | | `id` | string | có | Định danh mẫu đã đăng ký. Ví dụ 15899. | ## Ví dụ Request mẫu trên sandbox. cURL: ```bash 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. | Trường | Kiểu | Bắt buộc | Mô tả | | --- | --- | --- | --- | | `id` | string | có | Id mẫu vừa xoá. | | `object` | string | có | Luôn là invoice_template_registration. | | `deleted` | boolean | có | Luôn là true. | 200 OK: ```json { "id": "15899", "object": "invoice_template_registration", "deleted": true } ``` ## 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. | | `404 not_found` | — | không | Không có mẫu khớp id. | | `409 conflict` | — | không | Mẫu đã được duyệt số lượng. Chỉ xoá được mẫu có số lượng còn trống. | | `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/delete Cập nhật: 06/11/2026