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ệuMôi trường sandbox

Môi trường sandbox

Sandbox để thử tích hợp. Hoá đơn không gửi cơ quan thuế. Live chỉ gọi được sau khi được duyệt.

Markdown

#Giới thiệu

Ứng dụng mới luôn ở Sandbox. Dùng Sandbox để lấy token, tạo mẫu, tạo hoá đơn và nhận webhook. Hoá đơn sandbox không được gửi cơ quan thuế.

Nút Thử API trên tài liệu chỉ gọi Sandbox. Gọi Live bằng client hoặc cURL với key Live.

#Hai môi trường

Chọn host theo key đang giữ. Gửi key sandbox tới host Live, hoặc key Live tới host Sandbox, API trả 403.

Môi trườngHostTiền tố API key
Sandboxhttps://sandbox.api.hddt.devhddt_test_
Livehttps://api.hddt.devhddt_live_

#Dữ liệu tách riêng

Sandbox và Live là hai sổ riêng: API key, hạn mức, hoá đơn và webhook. Key sandbox không đọc được hoá đơn hay webhook Live. Thêm webhook bằng key hddt_test_ và App ID của ứng dụng thì URL đó chỉ nhận sự kiện sandbox.

App ID dùng chung cho cả hai môi trường. Token thì không: token lấy trên host nào chỉ gọi lại host đó.

#Hạn mức

Ứng dụng mới có 1.000 hoá đơn sandbox. Đây là tổng số được dùng, không làm mới theo tháng. Đây là sổ thử, không phải hoá đơn thật. Khi số còn lại về 0, API phát hành trả 402. Xem số đã dùng và còn lại bằng API Thông tin ứng dụng hoặc API Hạn mức hoá đơn.

Live có sổ hạn mức riêng. Hết hạn mức Live thì cần mua thêm. Sandbox không trừ vào sổ Live.

#Dữ liệu mẫu

Tra cứu mã số thuế trên sandbox: 0312345678 và 0109876543 luôn trả dữ liệu mẫu. MST khác có thể không có kết quả mẫu.

Tài khoản nhà cung cấp để lấy token do đội hỗ trợ gắn với ứng dụng trên trang quản trị. Client không gửi username hay password khi gọi API Lấy token.

#Chuyển sang Live

Live chưa được duyệt thì không gọi được host Live. Trên tab Tổng quan, khi ứng dụng còn Sandbox, mục Điều kiện chuyển sang Live gồm đã thử tích hợp trên sandbox và đã khai báo mã số thuế. Đủ điều kiện thì gửi yêu cầu chuyển sang Live. Đội hỗ trợ xác minh rồi bật Live.

Sau khi Live được bật, chọn Live trên đầu trang chi tiết để lấy API key hddt_live_ và Base URL https://api.hddt.dev. Vẫn có thể chọn lại Sandbox để thử. Hoá đơn Live được phát hành thật.

Đừng trộn key

Đổi sang Live thì đổi cả host, API key và token. Giữ nguyên token sandbox khi gọi api.hddt.dev sẽ bị từ chối.
Trước đóXác thựcTiếp theoMã lỗi
Trang này có hữu ích không?
Cập nhật lần cuối: 16/11/2026

Trên trang này

  • Giới thiệu
  • Hai môi trường
  • Dữ liệu tách riêng
  • Hạn mức
  • Dữ liệu mẫu
  • Chuyển sang Live
Đăng nhậpBắt đầu ngay