# Ký 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. `POST /v1/invoices/sign` Ký một hoá đơn đã lưu nháp. Gửi invoice_code là UUID lấy từ data.id của API Tạo hoá đơn. ## Giới thiệu API ký một hoá đơn đang ở trạng thái 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 vào invoice_code của API này. Hoá đơn đã phát hành không ký lại bằng API này. Trên sandbox, hoá đơn không được gửi tới cơ quan thuế. ## Endpoint Gửi POST với JSON. Sandbox: https://sandbox.api.hddt.dev. Live: https://api.hddt.dev. > **Chỉ hoá đơn nháp:** invoice_code phải là UUID của hoá đơn vừa lưu nháp. Hoá đơn đã phát hành hoặc không tồn tại sẽ không được ký. ## 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 Chỉ gửi mã số của hoá đơn nháp cần ký. Vị trí: body JSON. | Trường | Kiểu | Bắt buộc | Mô tả | | --- | --- | --- | --- | | `invoice_code` | string | có | UUID của hoá đơn nháp, lấy từ data.id của API Tạo hoá đơn. | ## Ví dụ Ký hoá đơn nháp có id 7c9e6679-7425-40de-944b-e07fc1f90ae7 trên sandbox. cURL: ```bash curl -X POST https://sandbox.api.hddt.dev/v1/invoices/sign \ -H "Authorization: Bearer $HDDT_TOKEN" \ -H "api_key: $HDDT_API_KEY" \ -H "app_id: $HDDT_APP_ID" \ -H "Content-Type: application/json" \ -d '{ "invoice_code": "7c9e6679-7425-40de-944b-e07fc1f90ae7" }' ``` ## Phản hồi Khi ký được hoá đơn, success là true. data là dữ liệu trả về sau khi ký. | Trường | Kiểu | Bắt buộc | Mô tả | | --- | --- | --- | --- | | `success` | boolean | có | true khi ký được hoá đơn, false khi thất bại. | | `data` | object | có | Dữ liệu trả về khi ký thành công. Khi thất bại có thể trống. | | `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. | Phản hồi: ```json { "success": true, "data": {}, "error_code": "", "message": "Thành công" } ``` ## Mã lỗi Khi hoá đơn không được ký, 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. | | `422 validation_error` | — | không | Thiếu invoice_code. | Trang HTML: /docs/invoices/sign Cập nhật: 06/11/2026