Tạo đặt chỗ
Tính năng này cho phép thực hiện thao tác đặt giữ chỗ chuyến bay trên các hãng hàng không, các hệ thống GDS. Cho phép đồng thời đặt hành lý ký gửi mua thêm, ghế ngồi và các dịch vụ khác. Có thể truyền thêm các thông tin như thông tin hộ chiếu, mã thẻ thành viên cho từng hành khách.
Tổng quan
| Request URL: | https://ibe.datacom.vn/api/flight/bookflight |
| Giao thức: | POST |
| Kiểu dữ liệu: | JSON |
| Đặc tả API: | Xem đặc tả |
Hệ thống áp dụng
| Mã hệ thống | Tên hệ thống |
|---|---|
| VN | Vietnam Airlines |
| VJ | Vietjet Air |
| QH | Bamboo Airways |
| VU | Vietravel Airlines |
| 9G | Sun Phu Quoc Airways |
| 1G | Galileo |
| 1A | Amadeus + NDC |
| FO | Flyone |
| AK | AirAsia |
| TR | Scoot |
Request
{
"RequestInfo": {
"PrivateKey": "string",
"ApiAccount": "string",
"ApiPassword": "string",
"Currency": "string",
"Language": "string",
"IpAddress": "string"
},
"GuestContact": {
"Area": "string",
"Phone": "string",
"Email": "string",
"ReceiveEmail": true
},
"AgentContact": {
"Area": "string",
"Phone": "string",
"Email": "string",
"ReceiveEmail": true
},
"ListPassenger": [
{
"Index": 0,
"ParentId": 0,
"NameId": "string",
"Type": "string",
"Title": "string",
"Gender": 0,
"GivenName": "string",
"Surname": "string",
"DateOfBirth": "string",
"PassengerId": "string",
"Passport": {
"Index": "string",
"DocumentType": "string",
"DocumentCode": "string",
"DocumentExpiry": "string",
"Nationality": "string",
"IssueCountry": "string"
},
"ListBaggage": [
{
"Value": "string",
"Currency": "string",
"StartPoint": "string",
"EndPoint": "string",
"Session": "string"
}
],
"ListPreSeat": [
{
"Value": "string",
"Type": "string",
"Currency": "string",
"StartPoint": "string",
"EndPoint": "string",
"Session": "string"
}
],
"ListService": [
{
"Value": "string",
"Currency": "string",
"StartPoint": "string",
"EndPoint": "string",
"Session": "string"
}
],
"ListMembership": [
{
"Index": "string",
"Airline": "string",
"MembershipID": "string",
"MembershipType": "string"
}
]
}
],
"ListAirOption": [
{
"Session": "string",
"SessionType": "string",
"AirlineOptionId": 0,
"FareOptionId": 0,
"FlightOptionId": 0,
}
],
"Option": {
"IssueTicket": true,
"SeparateBooking": true,
"SendEmail": true
}
}
Đặc tả dữ liệu
| Thuộc tính | Mô tả | Kiểu dữ liệu | Bắt buộc | Ví dụ |
|---|---|---|---|---|
| RequestInfo | Thông tin truy vấn | object | Có | |
| GuestContact | Thông tin liên hệ khách hàng | object | Có | |
|
Area
|
Khu vực | string | Có | |
|
Phone
|
Số điện thoại | string | Có | |
|
Email
|
string | Có | ||
|
ReceiveEmail
|
Nhận Email | boolean | Có | |
| AgentContact | Thông tin liên hệ đại lý | object | Có | |
|
Area
|
Khu vực | string | Có | |
|
Phone
|
Số điện thoại | string | Có | |
|
Email
|
string | Có | ||
|
ReceiveEmail
|
Nhận Email | boolean | Có | |
| ListPassenger | Thông tin danh sách hành khách | object | Có | |
|
Index
|
Số thứ tự | int | Có | |
|
ParentId
|
Mã định danh người lớn đi cùng em bé | int | Không | |
|
NameId
|
Mã định danh do hệ thống hãng trả về | string | Không | |
|
Type
|
Loại hành khách | string | Có | |
|
Title
|
Danh xưng | string | Không | Mrs |
|
Gender
|
Giới tính | int | Có | |
|
GivenName
|
Tên đệm và tên | string | Có | |
|
Surname
|
Họ | string | Có | |
|
DateOfBirth
|
Ngày sinh | string | Không | |
|
Passport
|
Thông tin hộ chiếu | object | Không | |
|
Index
|
Số thứ tự | int | Không | |
|
DocumentType
|
Loại hộ chiếu | string | Có | |
|
DocumentCode
|
Mã hộ chiếu | string | Có | |
|
DocumentExpiry
|
Thời gian hết hạn | string | Không | |
|
Nationality
|
Quốc tịch | string | Có | |
|
IssueCountry
|
Quốc gia cấp | string | Có | |
| ListBaggage | Thông tin danh sách hành lý | object | Không | |
|
Value
|
Mã của hành lý/dịch vụ ( lấy từ API Get Ancillary) | string | Có | ABAG |
|
Currency
|
Đơn vị tiền tệ | String | Có | VND |
|
Session
|
Phiên làm việc | string | Có | |
|
StartPoint
|
Điểm khởi hành | string | Có | HAN |
|
EndPoint
|
Điểm kết thúc | string | Có | SGN |
| ListPreSeat | Thông tin danh sách chỗ ngồi đặt trước | object | Không | |
|
Value
|
Vị trí ghế ngồi muốn đặt | string | Có | 1A |
|
Currency
|
Đơn vị tiền tệ | String | Có | VND |
|
StartPoint
|
Điểm khởi hành | string | Có | HAN |
|
EndPoint
|
Điểm kết thúc | string | Có | SGN |
|
Session
|
Phiên làm việc | string | Có | |
| ListService | Thông tin danh sách dịch vụ | object | Không | |
|
Value
|
Mã của dịch vụ ( lấy từ API Get Ancillary) | string | Có | |
|
Currency
|
Đơn vị tiền tệ | String | Có | VND |
|
StartPoint
|
Điểm khởi hành | string | Có | HAN |
|
EndPoint
|
Điểm kết thúc | string | Có | SGN |
|
Session
|
Phiên làm việc | string | Có | |
| ListMembership | Thông tin danh sách thẻ thành viên | object | Không | |
|
Index
|
Số thứ tự của khách | int | Không | 0 |
|
Airline
|
Hãng hàng không | string | Có | VN |
|
MembershipId
|
Id thẻ thành viên | string | Có | |
|
MembershipType
|
Loại thẻ thành viên | string | Không | |
| ListAirOption | Danh sách lựa chọn chuyến bay | object | Không | |
|
Session
|
Phiên làm việc | string | Không | |
|
SessionType
|
Kiểu phiên làm việc | string | Không | |
|
AirlineOptionId
|
Id lựa chọn hãng hàng không | int | Không | |
|
FareOptionId
|
Id lựa chọn giá vé | int | Không | |
|
FlightOptionId
|
Id lựa chọn chuyến bay | int | Không | |
| Option | Tùy chọn | object | Không | |
|
IssueTicket
|
Xuất vé | boolean | Không | |
|
SeparateBooking
|
Tách booking | boolean | Không | |
|
SendEmail
|
Gửi Email | boolean | Không |
Response
{
"StatusCode": "string",
"Success": true,
"Expired": true,
"Message": "string",
"Language": "string",
"CustomProperties": {
"additionalProp1": "string",
"additionalProp2": "string",
"additionalProp3": "string"
},
"RequestID": 0,
"ApiQueries": [
{
"Step": 0,
"Type": "string",
"Name": "string",
"Request": "string",
"Response": "string"
}
],
"OrderId": "string",
"ListBooking": [
{
"Source": "string",
"System": "string",
"Airline": "string",
"BookingId": "string",
"OrderCode": "string",
"OrderId": "string",
"GdsCode": "string",
"BookingCode": "string",
"BookingStatus": "string",
"ExpirationTime": "string",
"TimePurchase": "string",
"TotalPrice": 0,
"Currency": "string",
"BookingPcc": "string",
"BookingSignIn": "string",
"BookingImage": "string",
"ResponseTime": 0,
"AutoIssue": true,
"Sandbox": true,
"StatusCode": "string",
"Message": "string",
"ListContact": [
{
"Title": "string",
"Name": "string",
"Area": "string",
"Phone": "string",
"Email": "string",
"Address": "string",
"Remark": "string",
"ReceiveEmail": true
}
],
"ListFlightFare": [
{
"Leg": 0,
"Journey": "string",
"Itinerary": 0,
"Airline": "string",
"System": "string",
"Source": "string",
"Remark": "string",
"FareInfo": {
"OptionId": 0,
"FareClass": "string",
"FareBasis": "string",
"FareFamily": "string",
"CabinCode": "string",
"CabinName": "string",
"Refundable": true,
"Availability": 0,
"Unavailable": true,
"ExpiryDate": "string",
"BaseFare": 0,
"PriceAdt": 0,
"PriceAdtOrigin": 0,
"NetFare": 0,
"NetFareOrigin": 0,
"TotalFare": 0,
"TotalFareOrigin": 0,
"Currency": "string",
"Airline": "string",
"System": "string",
"Source": "string",
"Tourcode": "string",
"ListFarePax": [
{
"PaxType": "string",
"PaxNumb": 0,
"BaseFare": 0,
"NetFare": 0,
"NetFareOrigin": 0,
"TotalFare": 0,
"TotalFareOrigin": 0,
"ListFareItem": [
{
"Code": "string",
"Amount": 0,
"Name": "string"
}
],
"ListTaxDetail": [
{
"Code": "string",
"Amount": 0,
"Name": "string"
}
],
"ListFareInfo": [
{
"SegmentId": "string",
"StartPoint": "string",
"EndPoint": "string",
"FareClass": "string",
"FareBasis": "string",
"HandBaggage": "string",
"FreeBaggage": "string",
"Availability": 0
}
]
}
]
},
"ListFlight": [
{
"Leg": 0,
"FlightId": "string",
"Airline": "string",
"Operator": "string",
"StartPoint": "string",
"EndPoint": "string",
"StartDate": "2024-08-13T07:25:31.706Z",
"EndDate": "2024-08-13T07:25:31.706Z",
"DepartDate": "string",
"ArriveDate": "string",
"FlightNumber": "string",
"StopNum": 0,
"Duration": 0,
"ListSegment": [
{
"Leg": 0,
"SegmentId": "string",
"Airline": "string",
"Operator": "string",
"StartPoint": "string",
"EndPoint": "string",
"StartDate": "2024-08-13T07:25:31.706Z",
"EndDate": "2024-08-13T07:25:31.706Z",
"DepartDate": "string",
"ArriveDate": "string",
"StartTerminal": "string",
"EndTerminal": "string",
"FlightNumber": "string",
"Equipment": "string",
"FareClass": "string",
"FareBasis": "string",
"Duration": 0,
"HasStop": true,
"StopPoint": "string",
"StopTime": 0,
"MarriageGrp": "string",
"FlightsMiles": 0,
"Status": "string"
}
]
}
],
"Adt": 0,
"Chd": 0,
"Inf": 0,
"AgentId": "string",
"AgentCode": "string",
"AgentType": "string",
"Session": "string",
"Status": true,
"Error": "string",
"Message": "string",
"Language": "string",
"NdcInfo": {
"ShoppingId": "string",
"OfferId": "string",
"AdtOfferItemId": "string",
"ChdOfferItemId": "string",
"InfOfferItemId": "string"
}
}
],
"ListPassenger": [
{
"Index": 0,
"ParentId": 0,
"NameId": "string",
"Type": "string",
"Title": "string",
"Gender": 0,
"GivenName": "string",
"Surname": "string",
"DateOfBirth": "string",
"PassengerId": "string",
"Passport": {
"DocumentType": "string",
"DocumentCode": "string",
"DocumentExpiry": "string",
"Nationality": "string",
"IssueCountry": "string"
},
"ListBaggage": [
{
"System": "string",
"Airline": "string",
"Value": "string",
"Type": "string",
"PaxType": "string",
"Name": "string",
"Description": "string",
"Price": 0,
"Currency": "string",
"Leg": 0,
"StartPoint": "string",
"EndPoint": "string",
"StatusCode": "string",
"Confirmed": true,
"Session": "string"
}
],
"ListPreSeat": [
{
"System": "string",
"Airline": "string",
"Value": "string",
"Type": "string",
"PaxType": "string",
"Name": "string",
"Description": "string",
"Price": 0,
"Currency": "string",
"Leg": 0,
"StartPoint": "string",
"EndPoint": "string",
"StatusCode": "string",
"Confirmed": true,
"Session": "string"
}
],
"ListService": [
{
"System": "string",
"Airline": "string",
"Value": "string",
"Type": "string",
"PaxType": "string",
"Name": "string",
"Description": "string",
"Price": 0,
"Currency": "string",
"Leg": 0,
"StartPoint": "string",
"EndPoint": "string",
"StatusCode": "string",
"Confirmed": true,
"Session": "string"
}
],
"ListFareInfo": [
{
"Code": "string",
"Amount": 0,
"Name": "string"
}
],
"ListMembership": [
{
"Airline": "string",
"MembershipID": "string",
"MembershipType": "string"
}
]
}
],
"ListTicket": [
{
"Index": 0,
"System": "string",
"Airline": "string",
"BookingCode": "string",
"ConjTktNum": "string",
"TicketNumber": "string",
"TicketType": "string",
"TicketStatus": "string",
"TicketRelated": "string",
"RelatedType": "string",
"ServiceType": "string",
"ServiceCode": "string",
"PaxType": "string",
"FullName": "string",
"GivenName": "string",
"Surname": "string",
"NameId": "string",
"Fare": 0,
"Tax": 0,
"Fee": 0,
"Vat": 0,
"Total": 0,
"Currency": "string",
"Itinerary": 0,
"StartPoint": "string",
"EndPoint": "string",
"DepartDate": "string",
"ReturnDate": "string",
"FareClass": "string",
"FareBasis": "string",
"FlightType": "string",
"Segments": "string",
"Remark": "string",
"TicketImage": "string",
"IssueDate": "2024-08-13T07:25:31.706Z"
}
]
}
]
}
Đặc tả dữ liệu
| Trường thông tin | Mô tả | Kiểu dữ liệu | Ví dụ |
|---|---|---|---|
| StatusCode | Mã trạng thái trả về từ hệ thống | string | 0000 |
| Success | Trạng thái phản hồi (Thành công/Thất bại) | boolean | true |
| Message | Thông báo lỗi hoặc thông tin trả về | string | |
| Language | Ngôn ngữ phản hồi | string | Vi |
| RequestId | ID duy nhất của yêu cầu | int | |
| OrderId | ID đơn hàng hệ thống | string | |
| ListBooking | Thông tin chi tiết đặt chỗ | object | |
|
Source
|
Nguồn dữ liệu kết nối | string | API |
|
System
|
Hệ thống đặt chỗ trung gian | string | VN |
|
Airline
|
Mã hãng hàng không | string | 1G |
|
OrderCode
|
Mã đơn hàng | string | |
|
OrderId
|
ID đơn hàng | string | |
|
GdsCode
|
Mã GDS | string | |
|
BookingCode
|
Mã đặt chỗ (PNR) | string | |
|
BookingStatus
|
Trạng thái đặt chỗ | string | |
|
ExpirationTime
|
Thời hạn giữ chỗ | string | |
|
TimePurchase
|
Thời hạn giữ giá | string | |
|
TotalPrice
|
Tổng giá trị đặt chỗ | double | |
|
Currency
|
Mã loại tiền tệ | string | VND |
|
BookingPcc
|
Mã PCC thực hiện đặt chỗ | string | |
|
BookingSignIn
|
Tài khoản Sign-in thực hiện giữ chỗ | string | |
|
BookingImage
|
Nội dung/Mặt booking chi tiết | string | |
|
ResponseTime
|
Thời gian phản hồi từ hệ thống (giây) | double | 2.21 |
|
AutoIssue
|
Cấu hình tự động xuất vé | boolean | false |
|
Sandbox
|
Đặt chỗ trên môi trường thử nghiệm | boolean | |
|
StatusCode
|
Mã trạng thái kết quả đặt chỗ | string | |
|
Message
|
Thông báo chi tiết | string | |
|
Warning
|
Thông tin cảnh báo | string | |
|
GuestContact
|
Thông tin liên hệ của khách hàng | object | |
|
Title
|
Danh xưng | string | Mr |
|
Name
|
Họ và tên | string | |
|
Area
|
Khu vực | string | |
|
Phone
|
Số điện thoại | string | |
|
Email
|
Địa chỉ Email | string | |
|
Address
|
Địa chỉ nhà | string | |
|
Remark
|
Ghi chú thêm | string | |
|
ReceiveEmail
|
Trạng thái đăng ký nhận Email | boolean | |
|
AgentContact
|
Thông tin liên hệ đại lý | object | |
|
Title
|
Danh xưng đại diện | string | |
|
Name
|
Tên người đại diện / Tên đại lý | string | |
|
Area
|
Khu vực đại lý | string | |
|
Phone
|
Số điện thoại đại lý | string | |
|
Email
|
Email đại lý | string | |
|
Address
|
Địa chỉ đại lý | string | |
|
Remark
|
Ghi chú đại lý | string | |
|
ReceiveEmail
|
Trạng thái nhận email đại lý | boolean | |
| ListFlightFare | Thông tin danh sách giá vé | object | |
|
Leg
|
Thứ tự chặng bay | int | 0 |
|
Journey
|
Chuỗi hành trình chi tiết | string | HANSGN23112024 |
|
Itinerary
|
Loại hành trình (1 chiều, khứ hồi,...) | int | |
|
Airline
|
Mã hãng hàng không | string | VN |
|
System
|
Hệ thống đặt chỗ | string | 1G |
|
Source
|
Nguồn dữ liệu | string | API |
|
Remark
|
Ghi chú giá vé | string | |
|
FareInfo
|
Thông tin chi tiết điều kiện & giá vé | list | |
|
OptionId
|
ID tùy chọn giá | int | 0 |
|
FareClass
|
Hạng chỗ (Class Code) | string | H |
|
FareBasis
|
Mã hạng giá (Fare Basis) | string | First Class |
|
FareFamily
|
Nhóm giá vé | string | |
|
CabinCode
|
Mã khoang phục vụ | string | |
|
CabinName
|
Tên khoang phục vụ | string | |
|
Refundable
|
Điều kiện hoàn/hủy vé | boolean | true/false |
|
Availability
|
Số chỗ còn trống | int | 9 |
|
Unavailable
|
Trạng thái hết chỗ | boolean | true/false |
|
ExpiryDate
|
Thời hạn giữ chỗ (phút) | string | 120 |
|
BaseFare
|
Giá vé cơ bản 1 người lớn | double | 0 |
|
BaseFareOrigin
|
Giá vé cơ bản gốc (chưa giảm giá) | double | 0 |
|
PriceAdt
|
Giá tổng 1 người lớn | double | 0 |
|
PriceAdtOrigin
|
Giá tổng 1 người lớn gốc | double | 0 |
|
NetFare
|
Giá Net | double | 0 |
|
NetFareOrigin
|
Giá Net gốc | double | 0 |
|
TotalFare
|
Tổng tiền vé | double | 0 |
|
TotalFareOrigin
|
Tổng tiền vé gốc | double | 0 |
|
Currency
|
Đơn vị tiền tệ | string | VND |
|
Airline
|
Mã hãng hàng không | string | VN |
|
System
|
Hệ thống hàng không | string | VN |
|
Source
|
Nguồn lấy giá | string | |
|
Tourcode
|
Mã giảm giá / Promotion Code | string | |
|
ListFarePax
|
Danh sách chi tiết giá theo loại khách | list | |
|
PaxType
|
Loại hành khách (ADT/CHD/INF) | string | ADT |
|
PaxNumb
|
Số lượng khách | int | 1 |
|
BaseFare
|
Giá vé cơ bản cho loại khách | double | |
|
BaseFareOrigin
|
Giá cơ bản gốc cho loại khách | double | |
|
NetFare
|
Giá Net cho loại khách | double | |
|
NetFareOrigin
|
Giá Net gốc cho loại khách | double | |
|
TotalFare
|
Tổng giá cho loại khách | double | |
|
TotalFareOrigin
|
Tổng giá gốc cho loại khách | double | |
|
ListFareItem
|
Danh sách bóc tách chi tiết các khoản phí | array[] | |
|
Code
|
Mã khoản phí | string | |
|
Amount
|
Số tiền | double | |
|
Name
|
Tên khoản phí | string | |
|
ListTaxDetail
|
Danh sách bóc tách chi tiết khoản thuế | array[] | |
|
Code
|
Mã loại thuế | string | |
|
Amount
|
Số tiền thuế | double | |
|
Name
|
Tên loại thuế | string | |
|
ListFareInfo
|
Chi tiết điều kiện hạng vé từng chặng | array[] | |
|
SegmentId
|
ID chặng bay | int | |
|
StartPoint
|
Mã sân bay đi | string | HAN |
|
EndPoint
|
Mã sân bay đến | string | SGN |
|
FareClass
|
Hạng chỗ | string | |
|
FareBasis
|
Mã hạng giá | string | |
|
HandBaggage
|
Hành lý xách tay miễn cước | string | |
|
FreeBaggage
|
Hành lý ký gửi miễn cước | string | |
|
Availability
|
Số chỗ còn lại | int | |
| ListFlight | Thông tin danh sách chuyến bay | list | |
|
Leg
|
Thứ tự chặng bay | int | 0 |
|
FlightId
|
ID hành trình bay | string | 123456 |
|
Airline
|
Mã hãng hàng không | string | VN |
|
Operator
|
Hãng khai thác thực tế | string | VN |
|
StartPoint
|
Sân bay đi | string | HAN |
|
EndPoint
|
Sân bay đến | string | SGN |
|
StartDate
|
Ngày giờ cất cánh | datetime | |
|
EndDate
|
Ngày giờ hạ cánh | datetime | |
|
DepartDate
|
Ngày giờ cất cánh (ddMMyyyy HHmm) | string | 21122024 1730 |
|
ArriveDate
|
Ngày giờ hạ cánh (ddMMyyyy HHmm) | string | 21122024 1930 |
|
FlightNumber
|
Số hiệu chuyến bay | string | VN205 |
|
StopNum
|
Số điểm dừng (0: Bay thẳng) | int | 0 |
|
Duration
|
Tổng thời gian bay (phút) | int | 0 |
|
ListSegment
|
Danh sách các phân đoạn bay (Segments) | list | |
|
Leg
|
Thứ tự chặng | int | 0 |
|
SegmentId
|
ID phân đoạn bay | string | 123456 |
|
Airline
|
Mã hãng hàng không | string | VJ |
|
Operator
|
Hãng khai thác | string | VN |
|
StartPoint
|
Sân bay cất cánh | string | HAN |
|
EndPoint
|
Sân bay hạ cánh | string | SGN |
|
StartDate
|
Ngày giờ khởi hành | datetime | 11122024 |
|
EndDate
|
Ngày giờ đến | datetime | 01012025 |
|
DepartDate
|
Định dạng cất cánh (ddMMyyyy HHmm) | string | 21122024 1730 |
|
ArriveDate
|
Định dạng hạ cánh (ddMMyyyy HHmm) | string | 21122024 1930 |
|
StartTerminal
|
Nhà ga đi | string | 1 |
|
EndTerminal
|
Nhà ga đến | string | 1 |
|
FlightNumber
|
Số hiệu chuyến bay | string | VN205 |
|
Equipment
|
Loại máy bay | string | Airbus A321 |
|
FareClass
|
Hạng chỗ | string | H |
|
FareBasis
|
Mã hạng giá | string | First Class |
|
Duration
|
Thời gian bay (phút) | int | 120 |
|
HasStop
|
Có điểm dừng hay không | boolean | true/false |
|
StopPoint
|
Mã sân bay dừng | string | |
|
StopTime
|
Thời gian dừng (giờ/phút) | double | |
|
TechnicalStop
|
Mã sân bay dừng kỹ thuật | string | |
|
MarriageGrp
|
Nhóm chặng bay liên kết (Marriage Group) | string | |
|
FlightsMiles
|
Số dặm bay | int | |
|
Status
|
Trạng thái chặng bay | string | |
|
Adt
|
Số lượng người lớn | int | |
|
Chd
|
Số lượng trẻ em | int | |
|
Inf
|
Số lượng em bé | int | |
|
Session
|
Phiên làm việc (Session ID) | string | |
|
Status
|
Trạng thái truy vấn | boolean | |
|
Error
|
Mã lỗi (nếu có) | string | |
|
Message
|
Thông báo | string | |
|
Language
|
Ngôn ngữ | string | Vi |
|
AgentId
|
ID đại lý | string | |
|
AgentCode
|
Mã đại lý | string | |
|
AgentType
|
Loại đại lý | string | |
| ListPassenger | Danh sách thông tin hành khách | object | |
|
Index
|
Thứ tự khách | int | |
|
ParentId
|
ID người lớn đi kèm (áp dụng cho Em bé - INF) | int | |
|
NameId
|
ID hành khách do hãng trả về | string | |
|
Type
|
Loại hành khách (ADT/CHD/INF) | string | |
|
Title
|
Danh xưng (Mr, Mrs, Ms,...) | string | Mr |
|
Gender
|
Giới tính (1: Nam, 2: Nữ,...) | int | |
|
GivenName
|
Tên đệm và Tên | string | |
|
Surname
|
Họ | string | |
|
DateOfBirth
|
Ngày sinh | string | |
|
PassengerId
|
ID định danh khách | string | |
|
Passport
|
Thông tin hộ chiếu / Giấy tờ tùy thân | object | |
|
DocumentType
|
Loại giấy tờ (Passport/ID) | string | |
|
DocumentCode
|
Số hộ chiếu/CMND/CCCD | string | |
|
DocumentExpiry
|
Ngày hết hạn | string | |
|
Nationality
|
Quốc tịch | string | |
|
IssueCountry
|
Quốc gia cấp | string | |
| ListBaggage | Thông tin hành lý mua thêm | object | |
|
System
|
Hệ thống đặt chỗ | string | VN |
|
Airline
|
Mã hãng hàng không | string | 1G |
|
Value
|
Giá trị/Gói hành lý (kg) | string | |
|
Type
|
Loại hành lý | string | |
|
PaxType
|
Loại hành khách mua | string | ADT |
|
Name
|
Tên gói hành lý | string | |
|
Description
|
Mô tả chi tiết | string | |
|
Price
|
Giá gói hành lý | double | |
|
Currency
|
Đơn vị tiền tệ | string | VND |
|
Leg
|
Thứ tự chặng bay áp dụng | int | |
|
StartPoint
|
Mã sân bay đi | string | HAN |
|
EndPoint
|
Mã sân bay đến | string | SGN |
|
StatusCode
|
Mã trạng thái | string | |
|
Confirmed
|
Trạng thái xác nhận mua | boolean | |
|
Session
|
Phiên làm việc | string | |
| ListPreSeat | Thông tin đặt trước chỗ ngồi | object | |
|
System
|
Hệ thống đặt chỗ | string | VN |
|
Airline
|
Mã hãng hàng không | string | 1G |
|
Value
|
Số ghế chọn (VD: 12A) | string | |
|
Type
|
Loại ghế | string | |
|
PaxType
|
Loại hành khách áp dụng | string | ADT |
|
Name
|
Tên gói ghế | string | |
|
Description
|
Mô tả chi tiết ghế | string | |
|
Price
|
Phí chọn ghế | double | |
|
Currency
|
Mã tiền tệ | string | VND |
|
Leg
|
Thứ tự chặng | int | |
|
StartPoint
|
Mã sân bay đi | string | HAN |
|
EndPoint
|
Mã sân bay đến | string | SGN |
|
StatusCode
|
Mã trạng thái | string | |
|
Confirmed
|
Trạng thái xác nhận chọn ghế | boolean | |
|
Session
|
Phiên làm việc | string | |
| ListService | Danh sách các dịch vụ bổ sung khác | object | |
|
System
|
Hệ thống đặt chỗ | string | VN |
|
Airline
|
Mã hãng hàng không | string | 1G |
|
Value
|
Giá trị dịch vụ | string | |
|
Type
|
Loại dịch vụ | string | |
|
PaxType
|
Loại hành khách mua | string | ADT |
|
Name
|
Tên dịch vụ | string | |
|
Description
|
Mô tả chi tiết | string | |
|
Price
|
Giá dịch vụ | double | |
|
Currency
|
Mã tiền tệ | string | VND |
|
Leg
|
Thứ tự chặng | int | |
|
StartPoint
|
Sân bay đi | string | HAN |
|
EndPoint
|
Sân bay đến | string | SGN |
|
StatusCode
|
Mã trạng thái | string | |
|
Confirmed
|
Xác nhận | boolean | |
|
Session
|
Phiên làm việc | string | |
| ListFareInfo | Danh sách tổng hợp mã phí dịch vụ | object | |
|
Code
|
Mã khoản phí | string | |
|
Amount
|
Số tiền | double | |
|
Name
|
Tên khoản phí | string | |
| ListMembership | Thông tin thẻ thành viên / Khách hàng thân thiết | object | |
|
Airline
|
Hãng hàng không áp dụng | string | |
|
MembershipId
|
Mã số thẻ | string | |
|
MembershipType
|
Hạng thẻ | string | |
| ListTicket | Thông tin chi tiết vé đã xuất | object | |
|
Index
|
Thứ tự vé | int | |
|
System
|
Hệ thống đặt chỗ | string | 1G |
|
Airline
|
Mã hãng hàng không | string | VN |
|
BookingCode
|
Mã đặt chỗ (PNR) | string | |
|
ConjTktNum
|
Đầu số vé nối / Số vé liên kết | string | |
|
TicketNumber
|
Số vé điện tử (e-ticket number) | string | |
|
TicketType
|
Loại vé | string | |
|
TicketStatus
|
Trạng thái vé (Issued/Void/Refund,...) | string | |
|
TicketRelated
|
Số vé gốc liên quan (nếu Đổi/Hoàn vé) | string | |
|
RelatedType
|
Loại liên quan | string | |
|
ServiceType
|
Loại dịch vụ | string | |
|
ServiceCode
|
Mã dịch vụ | string | |
|
PaxType
|
Loại hành khách | string | |
|
FullName
|
Họ và tên đầy đủ | string | |
|
GivenName
|
Tên đệm và tên | string | |
|
Surname
|
Họ | string | |
|
NameId
|
ID định danh khách | string | |
|
Fare
|
Giá vé cơ bản | double | 10000000 |
|
Tax
|
Thuế | double | 500000 |
|
Fee
|
Phí dịch vụ | double | 500000 |
|
Vat
|
Thuế VAT (%) | double | 10 |
|
Total
|
Tổng tiền thanh toán | double | 10000000 |
|
Currency
|
Mã tiền tệ | string | VND |
|
Itinerary
|
Loại hành trình | int | |
|
StartPoint
|
Mã sân bay đi | string | HAN |
|
EndPoint
|
Mã sân bay đến | string | SGN |
|
DepartDate
|
Ngày đi (ddMMyyyy) | string | 12032025 |
|
ReturnDate
|
Ngày về (ddMMyyyy) | string | 18032025 |
|
FareClass
|
Hạng chỗ | string | H |
|
FareBasis
|
Mã hạng giá | string | First Class |
|
FlightType
|
Phân loại chuyến bay | string | |
|
Segments
|
Thông tin danh sách chặng bay | string | |
|
Remark
|
Ghi chú trên vé | string | |
|
TicketImage
|
Link ảnh vé điện tử | string | |
|
IssueDate
|
Ngày xuất vé (ddMMyyyy) | string | 12032025 |
Mã lỗi
| Mã lỗi | Diễn giải |
|---|---|
| 000 | Thành công |
| 0000 | Thành công |
| 001 | Lỗi chung (cần xem message hoặc hỏi hỗ trợ để biết chi tiết) |
| 002 | Request không hợp lệ |
| 300 | Lỗi hệ thống hãng (cần xem message hoặc hỏi hỗ trợ để biết chi tiết) |
| 310 | Giá vé đã thay đổi |