TÀI LIỆU KẾT NỐI API TOURKIT
Hướng dẫn lầy API-key:
- API-key lấy trên hệ thống CRM của tourkit
- Quản lý hệ thống => Cấu hình => Cấu hình công ty
1. API đổ cơ hội từ web về CRM
API cho phép nhận các phiếu tư vấn, đơn hàng tư vấn đổ từ các Website giới thiệu, bán hàng về kho cơ hội trong Tourkit để tiếp tục xử lý các khâu điều hành, vận hành
Endpoint:
https://<domain_CRM>/api/Ticket/CreateTicket
METHOD: POST
Headers :
+ Content-Type : application/json
+ api-key: lấy trong quản lý hệ thống CRM.
PARAMETER:
{
TenKH: string,
SoDienThoaiKH: string,
EmailKH: string,
DiaChiKH: string,
SoLuong: int,
QuantityChild: int,
QuantityBaby: int
Gia: decimal,
GiaChild: decimal,
GiaBaby: decimal,
TenPhieu: string,
NoiDungPhieu: string
}
Response:
200: Object Phiếu
5xx: Lỗi server
4xx: Lỗi trên Web
2. Lấy API danh sách tour từ CRM
API lấy danh sách Tour từ CRM giúp cho doanh nghiệp có thể đấu được APIs
Endpoint:
https://<domain_CRM>/api/Ticket/ListTourSample
METHOD: GET
Headers :
+ Content-Type : application/json
+ api-key: lấy trong quản lý hệ thống CRM.
Body:
{
"keyword": "",
"sortby":1,
"pageIndex":1,
"pageSize":50,
"startDateCI": "03/01/2024",
"endDateCI": "04/09/2024",
"startDateCO": "03/01/2024",
"endDateCO": "04/09/2024",
"marketId": -1
}
| Biến | Kiểu dữ liệu | Ý nghĩa | Mặc định |
|---|---|---|---|
| keyword | string | Tìm kiếm theo tên tour, mã tour,... | "" |
| pageIndex | int | index của trang (KHÔNG PHẢI OFFSET) | 1 |
| pageSize | int | Số bản ghi một trang | 10 |
| startDateCI | datetime mm/dd/yyyy/ | Tìm kiếm theo ngày bắt đầu | "" |
| startDateCO | datetime mm/dd/yyyy | Tìm kiếm theo ngày kết thúc check-out | "" |
| marketId | string | Tìm kiếm theo id thị trường của tour, sẽ được cung cấp bên dưới | -1 |
| sortby | int | = 0 => Sắp xếp theo ngày đóng chỗ = 1 => Sắp xếp theo số tiền người lớn giảm dần = 2 => Sắp xếp theo số tiền người lớn tăng dần = 3 => Sắp xếp theo ngày khởi hành |
1 |
Response:
{
"id": 428, id tour [int]
"tourCode": Mã tour,[string]
"title": Tên tour,[string]
"tourGuide": Hướng dẫn viên,[string]
"numerOfSlots": 25, Tổng số chỗ
"cusRemaining": 19, số chỗ còn lại [int]
"commissionAdult": 900000.0, hoa hồng người lớn [decimal]
"commissionChild": 700000.0, hoa hồng trẻ em (6 - 11) [decimal]
"commissionChildSmall": 700000.0, hoa hồng trẻ em (2 - 5) [decimal]
"commissionBaby": 500000.0, hoa hồng trẻ nhỏ [decimal]
"tourPrice": 7990000.0, giá tour [decimal]
"pricePerSlot": 7990000.0, giá người lớn [decimal]
"priceChild": 7590000.0, giá trẻ em (6 - 11)[decimal]
"priceChildSmall": 0.0 ,giá trẻ em (2 - 5) [decimal]
"priceBaby": 500000.0, giá trẻ nhỏ [decimal]
"placePickup": điểm đón,
"placePickdown": điểm trả,
"typeOf": loại hình,( Outbound, inbound, nội địa) [string]
"marketId": id thị trường,[string]
"bookingDate": "2024-04-11T00:00:00" thời gian nhận chỗ,[ datetime]
"closeDate": "2024-04-11T00:00:00" thời gian đóng chỗ, [datetime]
"startDate": "2024-04-11T00:00:00" thời gian khởi hành,[ datetime]
"endDate": "2024-04-11T00:00:00" thời gian kết thúc, [datetime]
"reversationTime": 222, Số giờ giữ chỗ [int]
"NameVehicleGo": Tên hãng đi,
"ImageVehicleGo": Link logo ảnh hãng phương tiện đi,
"ticketVehicleGo": Hành trình vé đi,
"NameVehicleBack": Tên hãng về,
"ImageVehicleBack": Link logo ảnh hãng phương tiện về,
"ticketVehicleBack": Hành trình vé về,
"vehicleId": Id phương tiện,
"journeyId": Id hành trình đi,
"journeyBackId": Id hành trình về,
"AvatarSchedule": Ảnh đại diện lịch trình,
"SlideImageSchedule": Slide lịch trình,
"totalRow": 262 Tổng số bản ghi [int]
},