Webhook

Webhook gửi sự kiện từ hoadon.pro tới hệ thống của bạn ngay khi có thay đổi (hoá đơn mới, kết quả kiểm tra, thư mới…). Trang này hướng dẫn cấu hình trên giao diện; phần kỹ thuật (chữ ký, xác thực, thử lại) nằm ở Tài liệu webhook cho nhà phát triển.

Phần Webhook trong thẻ API và Webhook theo bản thiết kế: danh sách điểm nhận và lịch sử giao

Danh sách điểm nhận

Mỗi dòng là một điểm nhận: URL nhận, tên gợi nhớ, các sự kiện đã đăng ký, trạng thái bật hoặc tạm dừng, tỉ lệ giao thành công trong 7 ngày và secret ký (chỉ hiện phần cuối). Dùng secret ký để xác thực chữ ký của mỗi yêu cầu.

Thêm webhook

1. Chọn Thêm webhook.
2. Nhập URL nhận (địa chỉ phải truy cập được từ internet).
3. Chọn các sự kiện cần nhận (xem danh sách sự kiện).
4. Lưu và sao chép secret ký vào cấu hình của hệ thống nhận.

Lịch sử giao webhook

Bảng lịch sử cho từng lượt giao: thời điểm, phản hồi (ví dụ 200 OK, 502), độ trễ và số lần thử. Dùng bảng này để tìm lý do khi hệ thống của bạn không nhận được sự kiện. Webhook giao lỗi liên tục có thể tự tạm dừng theo thiết kế; sau khi sửa lỗi, bật lại webhook.

Thông báo qua Zalo và email

Cùng thẻ có phần cấu hình thông báo cho người dùng: kênh Zalo và email, và loại thông báo (hoá đơn rủi ro, credit thấp, mất kết nối Cơ quan Thuế). Chọn người nhận và ngưỡng cảnh báo credit.