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]
    
},