hddt.dev
Tài liệuBảng giáTra cứu

Bắt đầu

  • Tổng quan
  • Bắt đầu nhanh
  • Xác thực
  • Môi trường sandbox
  • Mã lỗi

Ứng dụng

  • GETThông tin ứng dụng
  • PATCHCập nhật ứng dụng

Hoá đơn

  • POSTLấy token
  • GETLấy mẫu hoá đơn
  • GETDanh sách mẫu đã đăng ký
  • GETHạn mức hoá đơn
  • POSTTạo mẫu hoá đơn
  • POSTDuyệt số lượng hoá đơn
  • DELETEXoá mẫu chưa duyệt
  • POSTTạo hoá đơn
  • GETDanh sách hoá đơn
  • POSTKý hoá đơn nháp
  • GETTải hoá đơn PDF/XML
  • DELETEXoá hoá đơn nháp

Tra cứu

  • GETTra cứu mã số thuế

Webhook

  • GETDanh sách webhook
  • POSTThêm webhook
  • POSTNhận và kiểm tra
Trang chủTài liệuDanh sách webhook
GET/v1/webhooks

Danh sách webhook

Lấy các webhook của ứng dụng xác định bởi app_id: URL, trạng thái bật và sự kiện đã đăng ký.

MarkdownOpenAPI

#Giới thiệu

API trả các webhook đã thêm cho ứng dụng. Header app_id là UUID dùng để tìm ứng dụng. Header api_key phải là key đang hiệu lực của đúng ứng dụng đó. Key có thể được tạo lại, nên không dùng key để định danh ứng dụng. Key hddt_test_ chỉ gọi Sandbox, key Live chỉ gọi Live. Sandbox và Live là hai danh sách riêng.

Danh sách không trả secret dùng để ký thông báo. Secret chỉ có trong phản hồi của API Thêm webhook. Endpoint không dùng token hoá đơn và không trừ hạn mức phát hành.

#Endpoint

Gửi GET. Host phải cùng môi trường với API key. Sandbox: https://sandbox.api.hddt.dev. Live: https://api.hddt.dev.

Chưa có webhook vẫn trả 200 và data là mảng rỗng.

#Header

Gửi App ID để tìm ứng dụng, và API key của đúng ứ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).

api_keystringBắt buộc

API key đang hiệu lực của ứng dụng có app_id ở trên.

#Ví dụ

Lấy webhook sandbox của ứng dụng có App ID đã gửi.

cURL
curl https://sandbox.api.hddt.dev/v1/webhooks \
  -H "app_id: $HDDT_APP_ID" \
  -H "api_key: $HDDT_API_KEY"

#Phản hồi

Khi key hợp lệ, API trả 200. data là mảng webhook của môi trường đó.

objectstringBắt buộc

Luôn là list.

dataarrayBắt buộc

Danh sách webhook. Mảng rỗng khi chưa thêm webhook nào. Xem mục Webhook.

200 OK
{
  "object": "list",
  "data": [
    {
      "id": "wh_8f2a1c9d",
      "object": "webhook",
      "url": "https://api.cua-ban.vn/webhooks/hddt",
      "enabled": true,
      "events": ["invoice_issued", "tax_authority_response"]
    }
  ]
}

#Webhook

Mỗi phần tử của data là một webhook. Không có trường secret.

idstringBắt buộc

Định danh webhook, ví dụ wh_8f2a1c9d.

objectstringBắt buộc

Luôn là webhook.

urlstringBắt buộc

URL HTTPS nhận thông báo.

enabledbooleanBắt buộc

true khi webhook đang nhận thông báo, false khi đang tắt.

eventsarray of stringBắt buộc

Các mã trong bảng Sự kiện đang đăng ký.

#Sự kiện đang đăng ký

Mỗi phần tử của events là một mã dưới đây. all nhận mọi sự kiện còn lại.

MãTrạng thái
allTất cả
template_createdTạo mẫu hoá đơn
template_quantity_approvedDuyệt số lượng mẫu hoá đơn
template_deletedXoá mẫu hoá đơn
invoice_draft_createdTạo nháp hoá đơn
invoice_issuedPhát hành hoá đơn
invoice_signedKý hoá đơn
tax_authority_responseCQT phản hồi
invoice_draft_deletedXoá hoá đơn nháp

#Mã lỗi

Lỗi xác thực trả mã HTTP kèm error.code và error.message.

401 unauthorized—Tuỳ chọn

Thiếu header app_id hoặc api_key; API key sai, đã thu hồi, hoặc không thuộc app_id.

403 forbidden—Tuỳ chọn

Gửi key của môi trường khác (key hddt_live_ tới host Sandbox, key hddt_test_ tới host Live).

404 not_found—Tuỳ chọn

Không có ứng dụng nào khớp app_id.

422 validation_error—Tuỳ chọn

app_id không phải UUID.

Trước đóTra cứu mã số thuếTiếp theoThêm webhook
Trang này có hữu ích không?
Cập nhật lần cuối: 10/11/2026

Trên trang này

  • Giới thiệu
  • Endpoint
  • Header
  • Ví dụ
  • Phản hồi
  • Webhook
  • Sự kiện đang đăng ký
  • Mã lỗi
Đăng nhậpBắt đầu ngay