(36) Thay đổi trạng thái hóa đơn
1. Tình huống kích hoạt
Webhook này được kích hoạt khi trạng thái của một lần tải lên hóa đơn thay đổi sau khi sử dụng endpoint POST Upload Invoice. Lưu ý: API POST Upload Invoice hiện chỉ áp dụng cho thị trường Brazil.
2. Các tham số nghiệp vụ dữ liệu
| Parameter name | Data type | Sample | Description |
|---|---|---|---|
| shop_id | string | "7494049642642441621" | ID của TikTok Shop. |
| type | int64 | 36 | ID của chủ đề webhook này, là 36. |
| tts_notification_id | string | "7327112393057371910" | ID của thông báo webhook này. |
| timestamp | int64 | 1644412885 | Thời điểm webhook này được kích hoạt. Unix timestamp. |
| data | object | ||
| └ package_id | string | "123456" | ID của kiện hàng. |
| └ order_ids | []string | ["152523", "532123"] | Danh sách ID đơn hàng trong package_id tương ứng. |
| └ invoice_status | string | "SUCCESS" | Trạng thái của lần tải lên hóa đơn. Các giá trị có thể có: * SUCCESS * PROCESSING * FAILED * INVALID |
| └ invalid_reason | string | "NOT_FOUND" | Lý do tại sao invoice_status = INVALID. Các giá trị có thể có: * UNKNOWN: Lỗi hệ thống nội bộ. Vui lòng thử lại sau. * FAILED: Tệp NFe hoặc khóa truy cập không hợp lệ. Vui lòng kiểm tra tính chính xác của tệp XML. * NOT_FOUND: Không tìm thấy NFe. Điều này có thể do độ trễ dữ liệu. Vui lòng thử lại sau. * NOT_AUTHORIZED: NFe không được cấp phép hợp pháp. Có thể NFe chưa được phát hành hoặc đã bị hủy. * ACCESS_KEY_DUPLICATE: Khóa truy cập đã tồn tại. Bạn không thể tải lên hóa đơn có khóa truy cập trùng lặp. * CNPJ_NOT_MATCH：Đảm bảo NF-e có cùng tiền tố 8 chữ số với CNPJ mà bạn đã cung cấp trong quá trình đăng ký. * UF_Inconsistent_Required: Xác thực NF-e thất bại: CNPJ dùng để phát hành NF-e được đăng ký ở một bang khác với kho hàng của bạn. * UF_Inconsistent_Dismisse_Retirada_missing: Xác thực NF-e thất bại: CNPJ dùng để phát hành NF-e được đăng ký ở một bang khác với kho hàng của bạn. Để phát hành NF-e hợp lệ với CNPJ này, hãy bao gồm thông tin kho hàng (Pickup Location Identification) trong NF-e của bạn. * UF_Inconsistent_Dismissed_Retirada_Inconsistent: CNPJ dùng để phát hành NF-e được đăng ký ở một bang khác với kho hàng của bạn. Để phát hành NF-e hợp lệ với CNPJ này, hãy bao gồm thông tin kho hàng (Pickup Location Identification) trong NF-e của bạn. |
Ví dụ sự kiện
JSONWord Wrap
{
"type": 36,
"tts_notification_id": "7327112393057371910",
"shop_id": "7494049642642441621",
"timestamp": 1644412885,
"data": {
"package_id": "123456",
"order_ids": [
"152523",
"532123"
],
"invoice_status": "INVALID",
"invalid_reason": "NOT_FOUND"
}
}