# Xoá hoá đơn nháp > 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/{id}` Xoá một hoá đơn đang lưu nháp. Hoá đơn đã phát hành không xoá bằng API này. ## Giới thiệu API xoá một hoá đơn đang lưu nháp. Tạo nháp bằng API Tạo hoá đơn với issue_mode bằng 0, rồi gửi UUID trong data.id lên đường dẫn của API này. Hoá đơn đã phát hành không xoá được. Muốn bỏ một hoá đơn đã phát hành thì dùng quy trình thông báo sai sót, không dùng API này. Thao tác không hoàn tác được. ## Endpoint Gửi DELETE với UUID của hoá đơn nháp trên đường dẫn. Sandbox: https://sandbox.api.hddt.dev. Live: https://api.hddt.dev. > **Chỉ hoá đơn nháp:** id phải là UUID của hoá đơn vừa lưu nháp và chưa phát hành. Hoá đơn đã phát hành, đã ký, hoặc không thuộc ứng dụng sẽ không được xoá. ## 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ó | UUID của hoá đơn nháp, lấy từ data.id của API Tạo hoá đơn. | ## Ví dụ Xoá hoá đơn nháp có id 7c9e6679-7425-40de-944b-e07fc1f90ae7 trên sandbox. cURL: ```bash curl -X DELETE https://sandbox.api.hddt.dev/v1/invoices/7c9e6679-7425-40de-944b-e07fc1f90ae7 \ -H "Authorization: Bearer $HDDT_TOKEN" \ -H "api_key: $HDDT_API_KEY" \ -H "app_id: $HDDT_APP_ID" ``` ## Phản hồi Khi xoá được hoá đơn nháp, success là true. data.id là UUID vừa xoá. data.deleted là true. Nếu ứng dụng đã đăng ký sự kiện invoice_draft_deleted, hệ thống gửi webhook sau khi xoá. | Trường | Kiểu | Bắt buộc | Mô tả | | --- | --- | --- | --- | | `success` | boolean | có | true khi xoá được hoá đơn nháp, false khi thất bại. | | `data` | object | có | Kết quả xoá. Khi thành công có id và deleted. | | `error_code` | string | có | Trống khi thành công. Khi thất bại là mã lỗi nghiệp vụ. | | `message` | string | có | Thông báo thành công hoặc thất bại. | | `id` | string | có | UUID của hoá đơn nháp vừa xoá, nằm trong data. | | `deleted` | boolean | có | Luôn là true khi xoá thành công, nằm trong data. | 200 OK: ```json { "success": true, "data": { "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7", "deleted": true }, "error_code": "", "message": "Thành công" } ``` ## Mã lỗi Khi hoá đơn không được xoá, success là false, error_code và message mô tả lỗi nghiệp vụ. Lỗi xác thực và định dạng của hddt.dev vẫn trả mã HTTP kèm error.code và error.message. | 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ó hoá đơn nháp với id này trong ứng dụng, hoặc hoá đơn đã được xoá. | | `422 validation_error` | — | không | id không phải UUID, hoặc hoá đơn không còn là nháp (đã ký hoặc đã phát hành). | Trang HTML: /docs/invoices/cancel Cập nhật: 10/11/2026