Xem mục lục
Thiết lập Webhook
Hướng dẫn sử dụng
Tính năng Thiết lập Webhook
- Trên màn hình quản lý, từ menu Thiết lập (1), bạn kích chọn Thiết lập cửa hàng (2).
- Trong khối Thiết lập cửa hàng chọn Thiết lập webhook (3), bật tính năng Thiết lập Webhook (4)
- Điền thông tin bắt buộc trong phần Thiết lập chung (5) là URL Webhook, bật các sự kiện mà gian hàng muốn nhận (6) và bấm Lưu(7) để hoàn tất cấu hình Webhook
- Lưu ý (*) :
- Webhook url phải bắt đầu bằng https://
- Thời gian xử lý của server phải nhỏ hơn 3 giây và response status = 200
- Phát sinh khi gian hàng có đặt phòng mới được tạo.
- Request body:
{ "eventName" : "ORDER_CREATED", // tên sự kiện "requestId": "1e91d0dc-4c5d-4fd6-bed4-80a368fcd7a0", // uuid request data: { "uuid": "1e91d0dc-4c5d-4fd6-bed4-80a368fcd7a0", // uuid đặt phòng "customerId": 63182, "purchaseDate": "2024-04-20T10:08:32.0000000", // thời gian thanh toán "code": "DP000805", // mã đặt phòng "branchId": 3498, // id chi nhánh "status": 1, // trạng thái đặt phòng (1: đã đặt,2: hoàn thành, 3: đã hủy, 4: Chưa xác nhận) "modifiedDate": "2024-04-20T10:09:21.1000000", // ngày cập nhật "retailerId": 602482, "discount": 71100.0000, // tổng giảm giá "soldById": 24587, // nhân viên thanh toán "createdDate": "2024-04-20T10:09:15.0530000", ngày tạo đặt phòng "createdBy": 11889, // người tạo đặt phòng "modifiedBy": 11889, // người chỉnh sửa đặt phòng "discountRatio": 10, // phần tram giảm giá "total": 710289.0000, // tổng tiền hóa đơn "totalPayment": 200000.0000, // số tiền khách đã thanh toán "surcharge": 70389.0000, // thu khác "saleChannelId": 602482, // kênh bán "originVersion": 15, "orderDetails": [ { "uuid": "7c37cd98-da15-4408-ab57-bca6b73d9418", // uuid chi tiết đặt phòng "productId": 120843, // id sản phẩm "quantity": 1, // số lượng "price": 700000.0000, // đơn giá "discount": 0.0000, // giảm giá "createdDate": "2024-04-20T10:09:17.8630000", // ngày tạo "discountRatio": 0, // phần tram giảm giá "modifiedDate": "2024-04-20T10:09:20.7870000", // ngày cập nhật "orderUuid": "1e91d0dc-4c5d-4fd6-bed4-80a368fcd7a0", "isDeleted": false, "roomId": 52926, // id phòng "checkInTime": "2024-04-20T10:09:00.0000000", // ngày nhận phòng "checkOutTime": "2024-04-20T11:00:00.0000000", // ngày trả phòng "status": 2, trạng thái chi tiết đặt phòng (1: Đã đặt, 2: Đã nhận phòng, 3: Đã trả phòng, 4: Đã hủy,5: Chưa xác nhận) "productType": 6 // loại sản phẩm (2: Hàng hóa, 3: Dịch vụ, 6: Hạng phòng, 7: Phu phí), "counterType": 3, // hình thức lưu trú (1: Giờ, 2: Ngày, 3: Đêm ,4: Tháng) "retailerId": 602482, "branchId": 3498, // Id Chi nhánh "basePrice": 700000.0000, // Giá niêm yết "subTotal": 700000 // Tổng thành tiền }, { "productId": 120841, "quantity": 0, "price": 0.0000, "discount": 0.0000, "createdDate": "2024-04-20T10:09:18.6230000", "discountRatio": 0, "uuid": "86d77aeb-95b6-4090-bdc7-af27ae026ed6", "modifiedDate": "2024-04-20T10:09:20.5400000", "orderUuid": "1e91d0dc-4c5d-4fd6-bed4-80a368fcd7a0", "isDeleted": false, "roomId": 52926, "status": 0, "productType": 7, "counterType": 0, "retailerId": 602482, "branchId": 3498, "basePrice": 0.0000, "subTotal": 0, "parentUuid": "7c37cd98-da15-4408-ab57-bca6b73d9418", "extraFeeId": 8226 }, { "productId": 120841, "quantity": 0, "price": 0.0000, "discount": 0.0000, "createdDate": "2024-04-20T10:09:18.6230000", "discountRatio": 0, "uuid": "6bb035ce-8748-4a30-b68c-50dbc7056616", "modifiedDate": "2024-04-20T10:09:20.5430000", "orderUuid": "1e91d0dc-4c5d-4fd6-bed4-80a368fcd7a0", "isDeleted": false, "roomId": 52926, "status": 0, "productType": 7, "counterType": 0, "retailerId": 602482, "branchId": 3498, "basePrice": 0.0000, "subTotal": 0, "parentUuid": "7c37cd98-da15-4408-ab57-bca6b73d9418", "extraFeeId": 8225 }, { "id": 219177, "orderId": 108633, "productId": 120842, "quantity": 0, "price": 1000000.0000, "discount": 0.0000, "createdDate": "2024-04-20T10:09:18.8500000", "discountRatio": 0, "uuid": "51d5aa32-ad3c-4577-97a0-91ba872dccad", "modifiedDate": "2024-04-20T10:09:20.7870000", "orderUuid": "1e91d0dc-4c5d-4fd6-bed4-80a368fcd7a0", "isDeleted": false, "roomId": 52926, "checkInTime": "2024-04-20T10:09:00.0000000", "checkOutTime": "2024-04-20T10:09:00.0000000", "status": 2, "productType": 6, "counterType": 2, "retailerId": 602482, "branchId": 3498, "basePrice": 1000000.0000, "subTotal": 0, "parentUuid": "7c37cd98-da15-4408-ab57-bca6b73d9418" }, { "productId": 120938, "quantity": 1, "price": 11000.0000, "discount": 0.0000, "createdDate": "2024-04-20T10:09:19.0600000", "discountRatio": 0, "uuid": "b79a0b5e-6841-488a-999a-09e73836aa4a", "modifiedDate": "2024-04-20T10:09:20.5430000", "orderUuid": "1e91d0dc-4c5d-4fd6-bed4-80a368fcd7a0", "isDeleted": false, "roomId": 52926, "status": 0, "productType": 3, "counterType": 0, "retailerId": 602482, "branchId": 3498, "basePrice": 11000.0000, "subTotal": 11000, "parentUuid": "7c37cd98-da15-4408-ab57-bca6b73d9418" } ], "orderAttachments": [ // danh sách file đính kèm { "id": 254, "attachmentUrl": "https://d1k20gtjgkmqcd.cloudfront.net/mthu3/OrderAttachments/1e91d0dc4c5d4fd6bed480a368fcd7a0_0e3a7188146b46d6a79e3d62bb38ced2", "fileName": "hi.xlsx", "createdDate": "2024-04-20T10:09:19.2630000" } ], “historyNote”: “Ghi chú”, // Ghi chú đặt phòng "isCompletedPayment": false, // đã hoàn thành thanh toán hay chưa? "adultQuantity": 1, // số lượng người lớn "childQuantity": 0, // số lượng trẻ em "subTotal": 711000.0000, // tổng thành tiền đặt phòng "discountValue": 71100.0000 // tổng tiền giảm giá } } |
- Phát sinh khi gian hàng có thay đổi thông tin của đặt phòng
- Request body:
{ "eventName" : "ORDER_UPDATED", // tên sự kiện "requestId": "1e91d0dc-4c5d-4fd6-bed4-80a368fcd7a0", // uuid request data: { "uuid": "1e91d0dc-4c5d-4fd6-bed4-80a368fcd7a0", // uuid đặt phòng "customerId": 63182, "purchaseDate": "2024-04-20T10:08:32.0000000", // thời gian thanh toán "code": "DP000805", // mã đặt phòng "branchId": 3498, // id chi nhánh "status": 1, // trạng thái đặt phòng (1: đã đặt,2: hoàn thành, 3: đã hủy, 4: Chưa xác nhận) "modifiedDate": "2024-04-20T10:09:21.1000000", // ngày cập nhật "retailerId": 602482, "discount": 71100.0000, // tổng giảm giá "soldById": 24587, // nhân viên thanh toán "createdDate": "2024-04-20T10:09:15.0530000", ngày tạo đặt phòng "createdBy": 11889, // người tạo đặt phòng "modifiedBy": 11889, // người chỉnh sửa đặt phòng "discountRatio": 10, // phần tram giảm giá "total": 710289.0000, // tổng tiền hóa đơn "totalPayment": 200000.0000, // số tiền khách đã thanh toán "surcharge": 70389.0000, // thu khác "saleChannelId": 602482, // kênh bán "originVersion": 15, "orderDetails": [ { "uuid": "7c37cd98-da15-4408-ab57-bca6b73d9418", // uuid chi tiết đặt phòng "productId": 120843, // id sản phẩm "quantity": 1, // số lượng "price": 700000.0000, // đơn giá "discount": 0.0000, // giảm giá "createdDate": "2024-04-20T10:09:17.8630000", // ngày tạo "discountRatio": 0, // phần tram giảm giá "modifiedDate": "2024-04-20T10:09:20.7870000", // ngày cập nhật "orderUuid": "1e91d0dc-4c5d-4fd6-bed4-80a368fcd7a0", "isDeleted": false, "roomId": 52926, // id phòng "checkInTime": "2024-04-20T10:09:00.0000000", // ngày nhận phòng "checkOutTime": "2024-04-20T11:00:00.0000000", // ngày trả phòng "status": 2, trạng thái chi tiết đặt phòng (1: Đã đặt, 2: Đã nhận phòng, 3: Đã trả phòng, 4: Đã hủy,5: Chưa xác nhận) "productType": 6 // loại sản phẩm (2: Hàng hóa, 3: Dịch vụ, 6: Hạng phòng, 7: Phu phí), "counterType": 3, // hình thức lưu trú (1: Giờ, 2: Ngày, 3: Đêm ,4: Tháng) "retailerId": 602482, "branchId": 3498, // Id Chi nhánh "basePrice": 700000.0000, // Giá niêm yết "subTotal": 700000 // Tổng thành tiền }, { "productId": 120841, "quantity": 0, "price": 0.0000, "discount": 0.0000, "createdDate": "2024-04-20T10:09:18.6230000", "discountRatio": 0, "uuid": "86d77aeb-95b6-4090-bdc7-af27ae026ed6", "modifiedDate": "2024-04-20T10:09:20.5400000", "orderUuid": "1e91d0dc-4c5d-4fd6-bed4-80a368fcd7a0", "isDeleted": false, "roomId": 52926, "status": 0, "productType": 7, "counterType": 0, "retailerId": 602482, "branchId": 3498, "basePrice": 0.0000, "subTotal": 0, "parentUuid": "7c37cd98-da15-4408-ab57-bca6b73d9418", "extraFeeId": 8226 }, { "productId": 120841, "quantity": 0, "price": 0.0000, "discount": 0.0000, "createdDate": "2024-04-20T10:09:18.6230000", "discountRatio": 0, "uuid": "6bb035ce-8748-4a30-b68c-50dbc7056616", "modifiedDate": "2024-04-20T10:09:20.5430000", "orderUuid": "1e91d0dc-4c5d-4fd6-bed4-80a368fcd7a0", "isDeleted": false, "roomId": 52926, "status": 0, "productType": 7, "counterType": 0, "retailerId": 602482, "branchId": 3498, "basePrice": 0.0000, "subTotal": 0, "parentUuid": "7c37cd98-da15-4408-ab57-bca6b73d9418", "extraFeeId": 8225 }, { "id": 219177, "orderId": 108633, "productId": 120842, "quantity": 0, "price": 1000000.0000, "discount": 0.0000, "createdDate": "2024-04-20T10:09:18.8500000", "discountRatio": 0, "uuid": "51d5aa32-ad3c-4577-97a0-91ba872dccad", "modifiedDate": "2024-04-20T10:09:20.7870000", "orderUuid": "1e91d0dc-4c5d-4fd6-bed4-80a368fcd7a0", "isDeleted": false, "roomId": 52926, "checkInTime": "2024-04-20T10:09:00.0000000", "checkOutTime": "2024-04-20T10:09:00.0000000", "status": 2, "productType": 6, "counterType": 2, "retailerId": 602482, "branchId": 3498, "basePrice": 1000000.0000, "subTotal": 0, "parentUuid": "7c37cd98-da15-4408-ab57-bca6b73d9418" }, { "productId": 120938, "quantity": 1, "price": 11000.0000, "discount": 0.0000, "createdDate": "2024-04-20T10:09:19.0600000", "discountRatio": 0, "uuid": "b79a0b5e-6841-488a-999a-09e73836aa4a", "modifiedDate": "2024-04-20T10:09:20.5430000", "orderUuid": "1e91d0dc-4c5d-4fd6-bed4-80a368fcd7a0", "isDeleted": false, "roomId": 52926, "status": 0, "productType": 3, "counterType": 0, "retailerId": 602482, "branchId": 3498, "basePrice": 11000.0000, "subTotal": 11000, "parentUuid": "7c37cd98-da15-4408-ab57-bca6b73d9418" } ], "orderAttachments": [ // danh sách file đính kèm { "id": 254, "attachmentUrl": "https://d1k20gtjgkmqcd.cloudfront.net/mthu3/OrderAttachments/1e91d0dc4c5d4fd6bed480a368fcd7a0_0e3a7188146b46d6a79e3d62bb38ced2", "fileName": "hi.xlsx", "createdDate": "2024-04-20T10:09:19.2630000" } ], “historyNote”: “Ghi chú”, // Ghi chú đặt phòng "isCompletedPayment": false, // đã hoàn thành thanh toán hay chưa? "adultQuantity": 1, // số lượng người lớn "childQuantity": 0, // số lượng trẻ em "subTotal": 711000.0000, // tổng thành tiền đặt phòng "discountValue": 71100.0000 // tổng tiền giảm giá } } |
- Phát sinh khi gian hàng hủy đặt phòng.
- Request body:
{ "eventName" : "ORDER_CANCELLED", // tên sự kiện "requestId": "1e91d0dc-4c5d-4fd6-bed4-80a368fcd7a0", // uuid request data: { "uuid": "1e91d0dc-4c5d-4fd6-bed4-80a368fcd7a0", // uuid đặt phòng "customerId": 63182, "purchaseDate": "2024-04-20T10:08:32.0000000", // thời gian thanh toán "code": "DP000805", // mã đặt phòng "branchId": 3498, // id chi nhánh "status": 1, // trạng thái đặt phòng (1: đã đặt,2: hoàn thành, 3: đã hủy, 4: Chưa xác nhận) "modifiedDate": "2024-04-20T10:09:21.1000000", // ngày cập nhật "retailerId": 602482, "discount": 71100.0000, // tổng giảm giá "soldById": 24587, // nhân viên thanh toán "createdDate": "2024-04-20T10:09:15.0530000", ngày tạo đặt phòng "createdBy": 11889, // người tạo đặt phòng "modifiedBy": 11889, // người chỉnh sửa đặt phòng "discountRatio": 10, // phần tram giảm giá "total": 710289.0000, // tổng tiền hóa đơn "totalPayment": 200000.0000, // số tiền khách đã thanh toán "surcharge": 70389.0000, // thu khác "saleChannelId": 602482, // kênh bán "originVersion": 15, "orderDetails": [ { "uuid": "7c37cd98-da15-4408-ab57-bca6b73d9418", // uuid chi tiết đặt phòng "productId": 120843, // id sản phẩm "quantity": 1, // số lượng "price": 700000.0000, // đơn giá "discount": 0.0000, // giảm giá "createdDate": "2024-04-20T10:09:17.8630000", // ngày tạo "discountRatio": 0, // phần tram giảm giá "modifiedDate": "2024-04-20T10:09:20.7870000", // ngày cập nhật "orderUuid": "1e91d0dc-4c5d-4fd6-bed4-80a368fcd7a0", "isDeleted": false, "roomId": 52926, // id phòng "checkInTime": "2024-04-20T10:09:00.0000000", // ngày nhận phòng "checkOutTime": "2024-04-20T11:00:00.0000000", // ngày trả phòng "status": 2, trạng thái chi tiết đặt phòng (1: Đã đặt, 2: Đã nhận phòng, 3: Đã trả phòng, 4: Đã hủy,5: Chưa xác nhận) "productType": 6 // loại sản phẩm (2: Hàng hóa, 3: Dịch vụ, 6: Hạng phòng, 7: Phu phí), "counterType": 3, // hình thức lưu trú (1: Giờ, 2: Ngày, 3: Đêm ,4: Tháng) "retailerId": 602482, "branchId": 3498, // Id Chi nhánh "basePrice": 700000.0000, // Giá niêm yết "subTotal": 700000 // Tổng thành tiền }, { "productId": 120841, "quantity": 0, "price": 0.0000, "discount": 0.0000, "createdDate": "2024-04-20T10:09:18.6230000", "discountRatio": 0, "uuid": "86d77aeb-95b6-4090-bdc7-af27ae026ed6", "modifiedDate": "2024-04-20T10:09:20.5400000", "orderUuid": "1e91d0dc-4c5d-4fd6-bed4-80a368fcd7a0", "isDeleted": false, "roomId": 52926, "status": 0, "productType": 7, "counterType": 0, "retailerId": 602482, "branchId": 3498, "basePrice": 0.0000, "subTotal": 0, "parentUuid": "7c37cd98-da15-4408-ab57-bca6b73d9418", "extraFeeId": 8226 }, { "productId": 120841, "quantity": 0, "price": 0.0000, "discount": 0.0000, "createdDate": "2024-04-20T10:09:18.6230000", "discountRatio": 0, "uuid": "6bb035ce-8748-4a30-b68c-50dbc7056616", "modifiedDate": "2024-04-20T10:09:20.5430000", "orderUuid": "1e91d0dc-4c5d-4fd6-bed4-80a368fcd7a0", "isDeleted": false, "roomId": 52926, "status": 0, "productType": 7, "counterType": 0, "retailerId": 602482, "branchId": 3498, "basePrice": 0.0000, "subTotal": 0, "parentUuid": "7c37cd98-da15-4408-ab57-bca6b73d9418", "extraFeeId": 8225 }, { "id": 219177, "orderId": 108633, "productId": 120842, "quantity": 0, "price": 1000000.0000, "discount": 0.0000, "createdDate": "2024-04-20T10:09:18.8500000", "discountRatio": 0, "uuid": "51d5aa32-ad3c-4577-97a0-91ba872dccad", "modifiedDate": "2024-04-20T10:09:20.7870000", "orderUuid": "1e91d0dc-4c5d-4fd6-bed4-80a368fcd7a0", "isDeleted": false, "roomId": 52926, "checkInTime": "2024-04-20T10:09:00.0000000", "checkOutTime": "2024-04-20T10:09:00.0000000", "status": 2, "productType": 6, "counterType": 2, "retailerId": 602482, "branchId": 3498, "basePrice": 1000000.0000, "subTotal": 0, "parentUuid": "7c37cd98-da15-4408-ab57-bca6b73d9418" }, { "productId": 120938, "quantity": 1, "price": 11000.0000, "discount": 0.0000, "createdDate": "2024-04-20T10:09:19.0600000", "discountRatio": 0, "uuid": "b79a0b5e-6841-488a-999a-09e73836aa4a", "modifiedDate": "2024-04-20T10:09:20.5430000", "orderUuid": "1e91d0dc-4c5d-4fd6-bed4-80a368fcd7a0", "isDeleted": false, "roomId": 52926, "status": 0, "productType": 3, "counterType": 0, "retailerId": 602482, "branchId": 3498, "basePrice": 11000.0000, "subTotal": 11000, "parentUuid": "7c37cd98-da15-4408-ab57-bca6b73d9418" } ], "orderAttachments": [ // danh sách file đính kèm { "id": 254, "attachmentUrl": "https://d1k20gtjgkmqcd.cloudfront.net/mthu3/OrderAttachments/1e91d0dc4c5d4fd6bed480a368fcd7a0_0e3a7188146b46d6a79e3d62bb38ced2", "fileName": "hi.xlsx", "createdDate": "2024-04-20T10:09:19.2630000" } ], “historyNote”: “Ghi chú”, // Ghi chú đặt phòng "isCompletedPayment": false, // đã hoàn thành thanh toán hay chưa? "adultQuantity": 1, // số lượng người lớn "childQuantity": 0, // số lượng trẻ em "subTotal": 711000.0000, // tổng thành tiền đặt phòng "discountValue": 71100.0000 // tổng tiền giảm giá } } |
- Event được trả về theo method POST . Request body dạng application/json.
- Header bao gồm x-signature được mã hóa theo chuẩn SHA-HMAC256 (data + timestamp + retailerCode + secretKey) và x-timestamp là thời gian gửi thông tin theo giờ UTC
- Giải thích thuật ngữ :
- retailerCode : Mã gian hàng
- secretKey : Mã bí mật
- timeStamp : Là thời gian gửi được lấy bằng x-timestamp lấy từ header
- data : Request body
- Code mẫu :
- C#:
- Javascript :
- Phát sinh khi gian hàng có đặt phòng mới được tạo.
- Request body:
{ "eventName" : "ORDER_CREATED", // tên sự kiện "requestId": "1e91d0dc-4c5d-4fd6-bed4-80a368fcd7a0", // uuid request data: { "uuid": "1e91d0dc-4c5d-4fd6-bed4-80a368fcd7a0", // uuid đặt phòng "customerId": 63182, "purchaseDate": "2024-04-20T10:08:32.0000000", // thời gian thanh toán "code": "DP000805", // mã đặt phòng "branchId": 3498, // id chi nhánh "status": 1, // trạng thái đặt phòng (1: đã đặt,2: hoàn thành, 3: đã hủy, 4: Chưa xác nhận) "modifiedDate": "2024-04-20T10:09:21.1000000", // ngày cập nhật "retailerId": 602482, "discount": 71100.0000, // tổng giảm giá "soldById": 24587, // nhân viên thanh toán "createdDate": "2024-04-20T10:09:15.0530000", ngày tạo đặt phòng "createdBy": 11889, // người tạo đặt phòng "modifiedBy": 11889, // người chỉnh sửa đặt phòng "discountRatio": 10, // phần tram giảm giá "total": 710289.0000, // tổng tiền hóa đơn "totalPayment": 200000.0000, // số tiền khách đã thanh toán "surcharge": 70389.0000, // thu khác "saleChannelId": 602482, // kênh bán "originVersion": 15, "orderDetails": [ { "uuid": "7c37cd98-da15-4408-ab57-bca6b73d9418", // uuid chi tiết đặt phòng "productId": 120843, // id sản phẩm "quantity": 1, // số lượng "price": 700000.0000, // đơn giá "discount": 0.0000, // giảm giá "createdDate": "2024-04-20T10:09:17.8630000", // ngày tạo "discountRatio": 0, // phần tram giảm giá "modifiedDate": "2024-04-20T10:09:20.7870000", // ngày cập nhật "orderUuid": "1e91d0dc-4c5d-4fd6-bed4-80a368fcd7a0", "isDeleted": false, "roomId": 52926, // id phòng "checkInTime": "2024-04-20T10:09:00.0000000", // ngày nhận phòng "checkOutTime": "2024-04-20T11:00:00.0000000", // ngày trả phòng "status": 2, trạng thái chi tiết đặt phòng (1: Đã đặt, 2: Đã nhận phòng, 3: Đã trả phòng, 4: Đã hủy,5: Chưa xác nhận) "productType": 6 // loại sản phẩm (2: Hàng hóa, 3: Dịch vụ, 6: Hạng phòng, 7: Phu phí), "counterType": 3, // hình thức lưu trú (1: Giờ, 2: Ngày, 3: Đêm ,4: Tháng) "retailerId": 602482, "branchId": 3498, // Id Chi nhánh "basePrice": 700000.0000, // Giá niêm yết "subTotal": 700000 // Tổng thành tiền }, { "productId": 120841, "quantity": 0, "price": 0.0000, "discount": 0.0000, "createdDate": "2024-04-20T10:09:18.6230000", "discountRatio": 0, "uuid": "86d77aeb-95b6-4090-bdc7-af27ae026ed6", "modifiedDate": "2024-04-20T10:09:20.5400000", "orderUuid": "1e91d0dc-4c5d-4fd6-bed4-80a368fcd7a0", "isDeleted": false, "roomId": 52926, "status": 0, "productType": 7, "counterType": 0, "retailerId": 602482, "branchId": 3498, "basePrice": 0.0000, "subTotal": 0, "parentUuid": "7c37cd98-da15-4408-ab57-bca6b73d9418", "extraFeeId": 8226 }, { "productId": 120841, "quantity": 0, "price": 0.0000, "discount": 0.0000, "createdDate": "2024-04-20T10:09:18.6230000", "discountRatio": 0, "uuid": "6bb035ce-8748-4a30-b68c-50dbc7056616", "modifiedDate": "2024-04-20T10:09:20.5430000", "orderUuid": "1e91d0dc-4c5d-4fd6-bed4-80a368fcd7a0", "isDeleted": false, "roomId": 52926, "status": 0, "productType": 7, "counterType": 0, "retailerId": 602482, "branchId": 3498, "basePrice": 0.0000, "subTotal": 0, "parentUuid": "7c37cd98-da15-4408-ab57-bca6b73d9418", "extraFeeId": 8225 }, { "id": 219177, "orderId": 108633, "productId": 120842, "quantity": 0, "price": 1000000.0000, "discount": 0.0000, "createdDate": "2024-04-20T10:09:18.8500000", "discountRatio": 0, "uuid": "51d5aa32-ad3c-4577-97a0-91ba872dccad", "modifiedDate": "2024-04-20T10:09:20.7870000", "orderUuid": "1e91d0dc-4c5d-4fd6-bed4-80a368fcd7a0", "isDeleted": false, "roomId": 52926, "checkInTime": "2024-04-20T10:09:00.0000000", "checkOutTime": "2024-04-20T10:09:00.0000000", "status": 2, "productType": 6, "counterType": 2, "retailerId": 602482, "branchId": 3498, "basePrice": 1000000.0000, "subTotal": 0, "parentUuid": "7c37cd98-da15-4408-ab57-bca6b73d9418" }, { "productId": 120938, "quantity": 1, "price": 11000.0000, "discount": 0.0000, "createdDate": "2024-04-20T10:09:19.0600000", "discountRatio": 0, "uuid": "b79a0b5e-6841-488a-999a-09e73836aa4a", "modifiedDate": "2024-04-20T10:09:20.5430000", "orderUuid": "1e91d0dc-4c5d-4fd6-bed4-80a368fcd7a0", "isDeleted": false, "roomId": 52926, "status": 0, "productType": 3, "counterType": 0, "retailerId": 602482, "branchId": 3498, "basePrice": 11000.0000, "subTotal": 11000, "parentUuid": "7c37cd98-da15-4408-ab57-bca6b73d9418" } ], "orderAttachments": [ // danh sách file đính kèm { "id": 254, "attachmentUrl": "https://d1k20gtjgkmqcd.cloudfront.net/mthu3/OrderAttachments/1e91d0dc4c5d4fd6bed480a368fcd7a0_0e3a7188146b46d6a79e3d62bb38ced2", "fileName": "hi.xlsx", "createdDate": "2024-04-20T10:09:19.2630000" } ], “historyNote”: “Ghi chú”, // Ghi chú đặt phòng "isCompletedPayment": false, // đã hoàn thành thanh toán hay chưa? "adultQuantity": 1, // số lượng người lớn "childQuantity": 0, // số lượng trẻ em "subTotal": 711000.0000, // tổng thành tiền đặt phòng "discountValue": 71100.0000 // tổng tiền giảm giá } } |
- Phát sinh khi gian hàng có thay đổi thông tin của đặt phòng
- Request body:
{ "eventName" : "ORDER_UPDATED", // tên sự kiện "requestId": "1e91d0dc-4c5d-4fd6-bed4-80a368fcd7a0", // uuid request data: { "uuid": "1e91d0dc-4c5d-4fd6-bed4-80a368fcd7a0", // uuid đặt phòng "customerId": 63182, "purchaseDate": "2024-04-20T10:08:32.0000000", // thời gian thanh toán "code": "DP000805", // mã đặt phòng "branchId": 3498, // id chi nhánh "status": 1, // trạng thái đặt phòng (1: đã đặt,2: hoàn thành, 3: đã hủy, 4: Chưa xác nhận) "modifiedDate": "2024-04-20T10:09:21.1000000", // ngày cập nhật "retailerId": 602482, "discount": 71100.0000, // tổng giảm giá "soldById": 24587, // nhân viên thanh toán "createdDate": "2024-04-20T10:09:15.0530000", ngày tạo đặt phòng "createdBy": 11889, // người tạo đặt phòng "modifiedBy": 11889, // người chỉnh sửa đặt phòng "discountRatio": 10, // phần tram giảm giá "total": 710289.0000, // tổng tiền hóa đơn "totalPayment": 200000.0000, // số tiền khách đã thanh toán "surcharge": 70389.0000, // thu khác "saleChannelId": 602482, // kênh bán "originVersion": 15, "orderDetails": [ { "uuid": "7c37cd98-da15-4408-ab57-bca6b73d9418", // uuid chi tiết đặt phòng "productId": 120843, // id sản phẩm "quantity": 1, // số lượng "price": 700000.0000, // đơn giá "discount": 0.0000, // giảm giá "createdDate": "2024-04-20T10:09:17.8630000", // ngày tạo "discountRatio": 0, // phần tram giảm giá "modifiedDate": "2024-04-20T10:09:20.7870000", // ngày cập nhật "orderUuid": "1e91d0dc-4c5d-4fd6-bed4-80a368fcd7a0", "isDeleted": false, "roomId": 52926, // id phòng "checkInTime": "2024-04-20T10:09:00.0000000", // ngày nhận phòng "checkOutTime": "2024-04-20T11:00:00.0000000", // ngày trả phòng "status": 2, trạng thái chi tiết đặt phòng (1: Đã đặt, 2: Đã nhận phòng, 3: Đã trả phòng, 4: Đã hủy,5: Chưa xác nhận) "productType": 6 // loại sản phẩm (2: Hàng hóa, 3: Dịch vụ, 6: Hạng phòng, 7: Phu phí), "counterType": 3, // hình thức lưu trú (1: Giờ, 2: Ngày, 3: Đêm ,4: Tháng) "retailerId": 602482, "branchId": 3498, // Id Chi nhánh "basePrice": 700000.0000, // Giá niêm yết "subTotal": 700000 // Tổng thành tiền }, { "productId": 120841, "quantity": 0, "price": 0.0000, "discount": 0.0000, "createdDate": "2024-04-20T10:09:18.6230000", "discountRatio": 0, "uuid": "86d77aeb-95b6-4090-bdc7-af27ae026ed6", "modifiedDate": "2024-04-20T10:09:20.5400000", "orderUuid": "1e91d0dc-4c5d-4fd6-bed4-80a368fcd7a0", "isDeleted": false, "roomId": 52926, "status": 0, "productType": 7, "counterType": 0, "retailerId": 602482, "branchId": 3498, "basePrice": 0.0000, "subTotal": 0, "parentUuid": "7c37cd98-da15-4408-ab57-bca6b73d9418", "extraFeeId": 8226 }, { "productId": 120841, "quantity": 0, "price": 0.0000, "discount": 0.0000, "createdDate": "2024-04-20T10:09:18.6230000", "discountRatio": 0, "uuid": "6bb035ce-8748-4a30-b68c-50dbc7056616", "modifiedDate": "2024-04-20T10:09:20.5430000", "orderUuid": "1e91d0dc-4c5d-4fd6-bed4-80a368fcd7a0", "isDeleted": false, "roomId": 52926, "status": 0, "productType": 7, "counterType": 0, "retailerId": 602482, "branchId": 3498, "basePrice": 0.0000, "subTotal": 0, "parentUuid": "7c37cd98-da15-4408-ab57-bca6b73d9418", "extraFeeId": 8225 }, { "id": 219177, "orderId": 108633, "productId": 120842, "quantity": 0, "price": 1000000.0000, "discount": 0.0000, "createdDate": "2024-04-20T10:09:18.8500000", "discountRatio": 0, "uuid": "51d5aa32-ad3c-4577-97a0-91ba872dccad", "modifiedDate": "2024-04-20T10:09:20.7870000", "orderUuid": "1e91d0dc-4c5d-4fd6-bed4-80a368fcd7a0", "isDeleted": false, "roomId": 52926, "checkInTime": "2024-04-20T10:09:00.0000000", "checkOutTime": "2024-04-20T10:09:00.0000000", "status": 2, "productType": 6, "counterType": 2, "retailerId": 602482, "branchId": 3498, "basePrice": 1000000.0000, "subTotal": 0, "parentUuid": "7c37cd98-da15-4408-ab57-bca6b73d9418" }, { "productId": 120938, "quantity": 1, "price": 11000.0000, "discount": 0.0000, "createdDate": "2024-04-20T10:09:19.0600000", "discountRatio": 0, "uuid": "b79a0b5e-6841-488a-999a-09e73836aa4a", "modifiedDate": "2024-04-20T10:09:20.5430000", "orderUuid": "1e91d0dc-4c5d-4fd6-bed4-80a368fcd7a0", "isDeleted": false, "roomId": 52926, "status": 0, "productType": 3, "counterType": 0, "retailerId": 602482, "branchId": 3498, "basePrice": 11000.0000, "subTotal": 11000, "parentUuid": "7c37cd98-da15-4408-ab57-bca6b73d9418" } ], "orderAttachments": [ // danh sách file đính kèm { "id": 254, "attachmentUrl": "https://d1k20gtjgkmqcd.cloudfront.net/mthu3/OrderAttachments/1e91d0dc4c5d4fd6bed480a368fcd7a0_0e3a7188146b46d6a79e3d62bb38ced2", "fileName": "hi.xlsx", "createdDate": "2024-04-20T10:09:19.2630000" } ], “historyNote”: “Ghi chú”, // Ghi chú đặt phòng "isCompletedPayment": false, // đã hoàn thành thanh toán hay chưa? "adultQuantity": 1, // số lượng người lớn "childQuantity": 0, // số lượng trẻ em "subTotal": 711000.0000, // tổng thành tiền đặt phòng "discountValue": 71100.0000 // tổng tiền giảm giá } } |
- Phát sinh khi gian hàng hủy đặt phòng.
- Request body:
{ "eventName" : "ORDER_CANCELLED", // tên sự kiện "requestId": "1e91d0dc-4c5d-4fd6-bed4-80a368fcd7a0", // uuid request data: { "uuid": "1e91d0dc-4c5d-4fd6-bed4-80a368fcd7a0", // uuid đặt phòng "customerId": 63182, "purchaseDate": "2024-04-20T10:08:32.0000000", // thời gian thanh toán "code": "DP000805", // mã đặt phòng "branchId": 3498, // id chi nhánh "status": 1, // trạng thái đặt phòng (1: đã đặt,2: hoàn thành, 3: đã hủy, 4: Chưa xác nhận) "modifiedDate": "2024-04-20T10:09:21.1000000", // ngày cập nhật "retailerId": 602482, "discount": 71100.0000, // tổng giảm giá "soldById": 24587, // nhân viên thanh toán "createdDate": "2024-04-20T10:09:15.0530000", ngày tạo đặt phòng "createdBy": 11889, // người tạo đặt phòng "modifiedBy": 11889, // người chỉnh sửa đặt phòng "discountRatio": 10, // phần tram giảm giá "total": 710289.0000, // tổng tiền hóa đơn "totalPayment": 200000.0000, // số tiền khách đã thanh toán "surcharge": 70389.0000, // thu khác "saleChannelId": 602482, // kênh bán "originVersion": 15, "orderDetails": [ { "uuid": "7c37cd98-da15-4408-ab57-bca6b73d9418", // uuid chi tiết đặt phòng "productId": 120843, // id sản phẩm "quantity": 1, // số lượng "price": 700000.0000, // đơn giá "discount": 0.0000, // giảm giá "createdDate": "2024-04-20T10:09:17.8630000", // ngày tạo "discountRatio": 0, // phần tram giảm giá "modifiedDate": "2024-04-20T10:09:20.7870000", // ngày cập nhật "orderUuid": "1e91d0dc-4c5d-4fd6-bed4-80a368fcd7a0", "isDeleted": false, "roomId": 52926, // id phòng "checkInTime": "2024-04-20T10:09:00.0000000", // ngày nhận phòng "checkOutTime": "2024-04-20T11:00:00.0000000", // ngày trả phòng "status": 2, trạng thái chi tiết đặt phòng (1: Đã đặt, 2: Đã nhận phòng, 3: Đã trả phòng, 4: Đã hủy,5: Chưa xác nhận) "productType": 6 // loại sản phẩm (2: Hàng hóa, 3: Dịch vụ, 6: Hạng phòng, 7: Phu phí), "counterType": 3, // hình thức lưu trú (1: Giờ, 2: Ngày, 3: Đêm ,4: Tháng) "retailerId": 602482, "branchId": 3498, // Id Chi nhánh "basePrice": 700000.0000, // Giá niêm yết "subTotal": 700000 // Tổng thành tiền }, { "productId": 120841, "quantity": 0, "price": 0.0000, "discount": 0.0000, "createdDate": "2024-04-20T10:09:18.6230000", "discountRatio": 0, "uuid": "86d77aeb-95b6-4090-bdc7-af27ae026ed6", "modifiedDate": "2024-04-20T10:09:20.5400000", "orderUuid": "1e91d0dc-4c5d-4fd6-bed4-80a368fcd7a0", "isDeleted": false, "roomId": 52926, "status": 0, "productType": 7, "counterType": 0, "retailerId": 602482, "branchId": 3498, "basePrice": 0.0000, "subTotal": 0, "parentUuid": "7c37cd98-da15-4408-ab57-bca6b73d9418", "extraFeeId": 8226 }, { "productId": 120841, "quantity": 0, "price": 0.0000, "discount": 0.0000, "createdDate": "2024-04-20T10:09:18.6230000", "discountRatio": 0, "uuid": "6bb035ce-8748-4a30-b68c-50dbc7056616", "modifiedDate": "2024-04-20T10:09:20.5430000", "orderUuid": "1e91d0dc-4c5d-4fd6-bed4-80a368fcd7a0", "isDeleted": false, "roomId": 52926, "status": 0, "productType": 7, "counterType": 0, "retailerId": 602482, "branchId": 3498, "basePrice": 0.0000, "subTotal": 0, "parentUuid": "7c37cd98-da15-4408-ab57-bca6b73d9418", "extraFeeId": 8225 }, { "id": 219177, "orderId": 108633, "productId": 120842, "quantity": 0, "price": 1000000.0000, "discount": 0.0000, "createdDate": "2024-04-20T10:09:18.8500000", "discountRatio": 0, "uuid": "51d5aa32-ad3c-4577-97a0-91ba872dccad", "modifiedDate": "2024-04-20T10:09:20.7870000", "orderUuid": "1e91d0dc-4c5d-4fd6-bed4-80a368fcd7a0", "isDeleted": false, "roomId": 52926, "checkInTime": "2024-04-20T10:09:00.0000000", "checkOutTime": "2024-04-20T10:09:00.0000000", "status": 2, "productType": 6, "counterType": 2, "retailerId": 602482, "branchId": 3498, "basePrice": 1000000.0000, "subTotal": 0, "parentUuid": "7c37cd98-da15-4408-ab57-bca6b73d9418" }, { "productId": 120938, "quantity": 1, "price": 11000.0000, "discount": 0.0000, "createdDate": "2024-04-20T10:09:19.0600000", "discountRatio": 0, "uuid": "b79a0b5e-6841-488a-999a-09e73836aa4a", "modifiedDate": "2024-04-20T10:09:20.5430000", "orderUuid": "1e91d0dc-4c5d-4fd6-bed4-80a368fcd7a0", "isDeleted": false, "roomId": 52926, "status": 0, "productType": 3, "counterType": 0, "retailerId": 602482, "branchId": 3498, "basePrice": 11000.0000, "subTotal": 11000, "parentUuid": "7c37cd98-da15-4408-ab57-bca6b73d9418" } ], "orderAttachments": [ // danh sách file đính kèm { "id": 254, "attachmentUrl": "https://d1k20gtjgkmqcd.cloudfront.net/mthu3/OrderAttachments/1e91d0dc4c5d4fd6bed480a368fcd7a0_0e3a7188146b46d6a79e3d62bb38ced2", "fileName": "hi.xlsx", "createdDate": "2024-04-20T10:09:19.2630000" } ], “historyNote”: “Ghi chú”, // Ghi chú đặt phòng "isCompletedPayment": false, // đã hoàn thành thanh toán hay chưa? "adultQuantity": 1, // số lượng người lớn "childQuantity": 0, // số lượng trẻ em "subTotal": 711000.0000, // tổng thành tiền đặt phòng "discountValue": 71100.0000 // tổng tiền giảm giá } } |
Như vậy, KiotViet đã thực hiện xong phần hướng dẫn sử dụng Webhook.
Mọi thắc mắc xin liên hệ tổng đài tư vấn bán hàng 1800 6162, tổng đài hỗ trợ phần mềm 1900 6522 hoặc email cho chúng tôi tại địa chỉ: hotro@kiotviet.com để được hỗ trợ và giải đáp.
Chúc Quý khách thành công!
Tài liệu được cập nhật mới nhất ngày 07/06/2024
KiotViet - Phần mềm quản lý bán hàng phổ biến nhất
- Với 300.000 nhà kinh doanh sử dụng
- Chỉ từ: 6.000đ/ ngày
