Hướng dẫn tích hợp API

Book flight

This feature allows to make flight reservations on airlines, GDS systems. Allows to simultaneously book additional checked baggage, seats and other services. Can transmit additional information such as passport information, membership card code for each passenger.

Overview

Request URL: https://ibe.datacom.vn/api/flight/bookflight
Method: POST
Data type: JSON
API Specification: See specifications

Applicable system

System code System name
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"
  },
  "System": "string",
  "RequestKey": "string",
  "GuestContact": {
    "Title": "string",
    "Name": "string",
    "Area": "string",
    "Phone": "string",
    "Email": "string",
    "Address": "string",
    "Remark": "string",
    "ReceiveEmail": true
  },
  "AgentContact": {
    "Title": "string",
    "Name": "string",
    "Area": "string",
    "Phone": "string",
    "Email": "string",
    "Address": "string",
    "Remark": "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": {
        "DocumentType": "string",
        "DocumentCode": "string",
        "DocumentExpiry": "string",
        "Nationality": "string",
        "IssueCountry": "string"
      },
      "ListBaggage": [
        {
          "Value": "string",
          "Session": "string"
        }
      ],
      "ListPreSeat": [
        {
          "Value": "string",
          "Session": "string"
        }
      ],
      "ListService": [
        {
          "Value": "string",
          "Session": "string"
        }
      ],
      "ListMembership": [
        {
          "Airline": "string",
          "MembershipID": "string",
          "MembershipType": "string"
        }
      ]
    }
  ],
  "ListAirOption": [
    {
      "Session": "string",
      "SessionType": "string",
      "AirlineOptionId": 0,
      "FareOptionId": 0,
      "FlightOptionId": 0,
      "Tourcode": "string",
      "CAcode": "string",
      "VIPText": "string",
      "Remark": "string",
      "AccountCode": "string"
    }
  ],
  "Option": {
    "IssueTicket": true,
    "SeparateBooking": true,
    "SendEmail": true
  }
}
Data specification
Information field Describe Data type Obligatory For example
RequestInfo Query information
See description Shared properties		 object Yes

 
System Reservation system string Yes VN
RequestKey Key request string No  
GuestContact
 Customer contact information object Yes  
Title
 Title string Yes  
Name
 Name string Yes  
Area
 Area string Yes  
Phone
 Phone string Yes  
Email
 Email string Yes  
Address
 Address string Yes  
Remark
 Remark string Yes  
ReceiveEmail
 Receive Email boolean Yes  
AgentContact
 Dealer contact information object Yes  
Title
 Title string Yes  
Name
 Name string Yes  
Area
 Area string Yes  
Phone
 Phone string Yes  
Email
 Email string Yes  
Address
 Address string Yes  
Remark
 Remark string Yes  
ReceiveEmail
 Receive Email boolean Yes  
ListPassenger
 Passenger list information object Yes  
Index
 Index
int
 Yes  
ParentId
 Identification code of adult accompanying the infant
int
 Yes  
NameId
 Identification code returned by the airline system
string
No
  
Type
 Passenger type string Yes  
Title
 Title string No Mrs
Gender
 Gender int Yes  
GivenName
 Giname string Yes  
Surname
 Sur name string Yes  
DateOfBirth
 Date of birth string Yes  
Passport
 Passport object No  
DocumentType
 Passport type string Yes  
DocumentCode
 Passport code string Yes  
DocumentExpiry
 Expiration time string Yes  
Nationality
 Nationality string Yes  
IssueCountry
 Issue country string Yes  
ListBaggage
 List baggage object No  
Value
 Value string Yes  
Session
 Session string Yes  
ListPreSeat
 Pre-booked seat list information object No  
Value
 Value string Yes  
Session
 Session string Yes  
ListService
 Service list information object No  
Value
 Value string Có  
Session
 Session string Có  
ListMembership
 Membership card list information object No  
Airline
 Airline string Yes  
MembershipId
 Membership card id string Yes  
MembershipType
 Membership card type string Yes  
ListAirOption Air options list object No  
Session
 Session string No  
SessionType
 Session type string No  
AirlineOptionId
 Airline option id int No  
FareOptionId
 Fare option id int No  
FlightOptionId
 Flight option id int No  
Tourcode
 Tour code string No  
CAcode
 CA code string No  
VIPtext
 VIP text string No  
Remark
 Remark string No  
AccountCode
 Account code string No  
Option Option object No  
IssueTicket
 Isticket boolean No  
SeparateBooking
 Separate booking   No  
SendEmail
 Send email boolean No  

 

Response

{
  "StatusCode": "string",
  "Success": true,
  "Message": "string",
  "Language": "string",
  "RequestID": 0,
  "OrderId": "string",
  "ListBooking": [
    {
      "Source": "string",
      "System": "string",
      "Airline": "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",
      "Warning": "string",
      "GuestContact": {
        "Title": "string",
        "Name": "string",
        "Area": "string",
        "Phone": "string",
        "Email": "string",
        "Address": "string",
        "Remark": "string",
        "ReceiveEmail": true
      },
      "AgentContact": {
        "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,
            "BaseFareOrigin": 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,
                "BaseFareOrigin": 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-11-27T06:47:49.081Z",
              "EndDate": "2024-11-27T06:47:49.081Z",
              "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-11-27T06:47:49.081Z",
                  "EndDate": "2024-11-27T06:47:49.081Z",
                  "DepartDate": "string",
                  "ArriveDate": "string",
                  "StartTerminal": "string",
                  "EndTerminal": "string",
                  "FlightNumber": "string",
                  "Equipment": "string",
                  "FareClass": "string",
                  "FareBasis": "string",
                  "Duration": 0,
                  "HasStop": true,
                  "StopPoint": "string",
                  "StopTime": 0,
                  "TechnicalStop": "string",
                  "MarriageGrp": "string",
                  "FlightsMiles": 0,
                  "Status": "string"
                }
              ]
            }
          ],
          "Adt": 0,
          "Chd": 0,
          "Inf": 0,
          "Session": "string",
          "Status": true,
          "Error": "string",
          "Message": "string",
          "Language": "string",
          "AgentId": "string",
          "AgentCode": "string",
          "AgentType": "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-11-27T06:47:49.081Z"
        }
      ]
    }
  ]
}
Data specification
Information field Describe   Data type For example
StatusCode Status code   string 0000
Success Success   boolean true
Message Message   string  
Language Language   string Vi
RequestId Request Id   int  
OrderId Order Id   string  
ListBooking
 List of reservation information   object  
Source
 Source   string API
System
 System   string VN
Airline
 Airline   string 1G
OrderCode
 Order code   string  
OrderId
 Order ID   string  
GdsCode
 Gds Code   string  
BookingCode
 Booking Code   string  
BookingStatus
 Booking Status   string  
ExpirationTime
 Expiration Time   string  
TimePurchase
 Time Purchase   string  
TotalPrice
 Total Price   double  
Currency
 Currency   string VND
BookingPcc
 Booking Pcc   string  
BookingSignIn
 Booking SignIn   string  
BookingImage
 Booking Image   string  
ResponseTime
 Response Time   double 2.21
AutoIssue
 Auto Issue   boolean false
AutoIssue AutoIssue   boolean  
StatusCode
 Status Code   string  
Message
 Message   string  
Warning
 Warning   string  
GuestContact
 Guest Contact   object  
Title
 Title   string  
Name
 Name   string  
Area
 Area   string  
Phone
 Phone   string  
Email
 Email   string  
Address
 Address   string  
Remark
 Remark   string  
ReceiveEmail
 Receive Email   boolean  
AgentContact
 Agent Contact   object  
Title
 Title   string  
Name
 Name   string  
Area
 Area   string  
Phone
 Phone   string  
Email
 Email   string  
Address
 Address   string  
Remark
 Remark   string  
ReceiveEmail
 Receive Email   boolean  
ListFlightFare
 List Flifare   object  
Leg
 Leg   int 0
Journey
 Journey   string HANSGN23112024
Itinerary
 Itinerary   int  
Airline
 Airline   string VN
System
 System   string 1G
Source
 Source   string API
Remark
 Remark   string  
FareInfo
 Fare info   list  
OptionId
 Option ID    int 0
FareClass
 Fare class   string H
FareBasis
 Fare basis   string First Class
FareFamily
 Fare family   string  
CabinCode
 Cabin code   string  
CabinName
 Cabin name   string  
Refundable
 Refundable   boolean True/false
Availability
 Availability   int 9
Unavailable
 Unavailable   boolean True/false
ExpiryDate
 Expiry date   string 120
BaseFare
 Basic fare for an adult   double 0
BaseFareOrigin
 Base fare for an adult without airline discount code   double 0
PriceAdt
 Ticket price for one adult   double 0
PriceAdtOrigin
 Price per adult ticket without airline discount code   double 0
NetFare
 Net fare   double 0
NetFareOrigin
 Net fare before applying the company's discount code   double 0
TotalFare
 Total fare   double 0
TotalFareOrigin
 Total fare before applying airline discount code   double 0
Currency
 Currency   string VND
Airline
 Airline   string VN
System
 System   string VN
Source
 Source   string  
Tourcode
 Tourcode   string  
ListFarePax
 List of ticket price information for each customer   list  
PaxType
 Pax type   string  
PaxNumb
 Number of guests   int  
BaseFare
 Base fare   double  
BaseFareOrigin 
 Basic fare without airline discount code applied   double  
NetFare
 Net fare   double  
NetFareOrigin
 Net fare before applying the company's discount code   double  
TotalFare
 Total fare   double  
TotalFareOrigin
 Total fare before applying airline discount code   double  
ListFareItem
 List of detailed ticket price information   array[]  
Code
 Code   string  
Amount
 Amount   double  
Name
 Name   string  
ListTaxDetail
 List of tax details   array[]  
Code
 Code   string  
Amount
 Amount   double  
Name
 Name   string  
ListFareInfo
 List of detailed ticket class information   array[]  
SegmentId
 Segment ID   int  
StartPoint
 Airport code, departure city   string HAN
EndPoint
 Airport code, destination city   string SGN
FareClass
 Fare class   string  
FareBasis
 Fare basis   string  
HandBaggage
 Free carry-on baggage   string  
FreeBaggage
 Free checked baggage   string  
Availability
 Availability   int  
ListFlight
 List flight   list  
Leg
 Leg   int 0
FlightId
 Flight ID   string 123456
Airline
 Airline   string VN
Operator
 Operator   string VN
StartPoint
 Departure airport code   string HAN
EndPoint
 Destination airport code   string SGN
StartDate
 Departure Date
Format ddMMyyyy		   string 12032025
EndDate
 Landing Date
Format ddMMyyyy		   string 12102025
DepartDate
 Departure Date
Format ddMMyyyy		   string 12032025
ArriveDate
 Landing Date
Format ddMMyyyy		   string 12102025
FlightNumber
 Flight number   string VN205
StopNum
 Number of stops   int 0
Duration
 Duration   int 0
ListSegment
 List segment   list  
Leg
 Leg   int 0
SegmentId
 Segment ID   string 123456
Airline
 Airline   string VJ
Operator
 Operator   string VN
StartPoint
 Departure airport code   string HAN
EndPoint
 Destination airport code   string SGN
StartDate
 Departure Date
Format ddMMyyyy		   string 11122024
EndDate
 Landing Date
Format ddMMyyyy		   string 01012025
DepartDate
 Departure Date
Format ddMMyyyy		   datetime 11122024
ArriveDate
 Landing Date
Format ddMMyyyy		   datetime 12122024
StartTerminal
 Departure terminal   string 1
EndTerminal
 Landing terminal   string 1
FlightNumber
 Flight number   string VN205
Equipment
 Equipment   string  Airbus A321
FareClass
 Fare class   string H
FareBasis
 Fare basis   string First Class
Duration
 Duration   int 120
HasStop
 Has stop   boolean True/false
StopPoint
 Airport stopover code   string  
StopTime
 Stop time   double  
TechnicalStop
 Airport code technical stop   string  
MarriageGrp
 Flight groups in pairs   string  
FlightsMiles
 Air miles   int  
Status
 Status   string  
Adt
 Number of adult guests   int  
Chd
 Number of children   int  
Inf
 Number of infant guests   int  
Session
 Session   string  
Status
 Status   boolean  
Error
 Error   string  
Message
 Message   string  
Language
 Language   string Vi
AgentId
 Agent ID   string  
AgentCode
 Agent code   string  
AgentType
 Agent type   string  
ListPassenger
 Passenger list information   object  
Index
 Index  
int
 
ParentId
 Identification code of adult accompanying the infant  
int
 
NameId
 Identification code returned by the airline system  
string
 
Type
 Passenger type   string  
Title
 Title   string Mrs
Gender
 Gender   int  
GivenName
 Given name   string  
Surname
 Surname   string  
DateOfBirth
 Date of birth   string  
PassengerId
 Passenger ID   string  
Passport
 Passport   object  
DocumentType
 Document type   string  
DocumentCode
 Document code   string  
DocumentExpiry
 Document expiry   string  
Nationality
 Nationality   string  
IssueCountry
 Issue country   string  
ListBaggage
 Luggage list information   object  
System
 System   string VN
Airline
 Airline   string 1G
Value
 Value   string  
Type
 Type   string  
PaxType
 Pax type   string ADT
Name
 Name   string  
Description
 Description   string  
Price
 Price   double  
Currency
 Currency   string VND
Leg
 Leg   int  
StartPoint
 Departure airport code   string HAN
EndPoint
 Destination airport code   string SGN
StatusCode
 Status code   string  
Confirmed
 Confirm   boolean  
Session
 Session   string  
ListPreSeat
 Pre-booked seat list information   object  
System
 System   string VN
Airline
 Airline   string 1G
Value
 Value   string  
Type
 Type   string  
PaxType
 Pax type   string ADT
Name
 Name   string  
Description
 Description   string  
Price
 Price   double  
Currency
 Currency   string VND
Leg
 Leg   int  
StartPoint
 Departure airport code   string HAN
EndPoint
 Destination airport code   string SGN
StatusCode
 Status code   string  
Confirmed
 Confirm   boolean  
Session
 Session   string  
ListService
 Service list information   object  
System
 System   string VN
Airline
 Airline   string 1G
Value
 Value   string  
Type
 Type   string  
PaxType
 Pax type   string ADT
Name
 Name   string  
Description
 Description   string  
Price
 Price   double  
Currency
 Currency   string VND
Leg
 Leg   int  
StartPoint
 Departure airport code   string HAN
EndPoint
 Destination airport code   string SGN
StatusCode
 Status code   string  
Confirmed
 Confirmed   boolean  
Session
 Session   string  
ListFareInfo
 Ticket price list information   object  
Code
 Code   string  
Amount
 Amount   double  
Name
 Name   String  
ListMembership
 Membership card list information   object  
Airline
 Airline   string  
MembershipId
 Membership ID   string  
MembershipType
 Membership type   string  
ListTicket
 Ticket list information   object  
Index
 Index  
int
 
System
 System   string 1G
Airline
 Airline   string VN
BookingCode
 Booking code   string  
ConjTktNum
 Conj ticket number   string  
TicketNumber
 Ticket number   string  
TicketType
 Ticket type   string  
TicketStatus
 Ticket status   string  
TicketRelated
 Related tickets   string  
RelatedType
 Related ticket types   string  
ServiceType
 Service type   string  
ServiceCode
 Service code   string  
PaxType
 Customer type   string  
FullName
 Full name   string  
GivenName
 Given name   string  
Surname
 Surname   string  
NameId
 Identification code returned by the airline system   string  
Fare
 Fare   double 10000000
Tax
 Tax   double 500000
Fee
 Fee   double 500000
Vat
 Vat   double 10
Total
 Total   double 10000000
Currency
 Currency   string VND
Itinerary
 Itinerary   int  
StartPoint
 Airport code, departure city   string HAN
EndPoint
 Airport code, destination city   string SGN
DepartDate
 Departure Date
Format ddMMyyyy		   string 12032025
ReturnDate
 Landing Date
Format ddMMyyyy		   string 18032025
FareClass
 Fare class   string H
FareBasis
 Fare basis   string First Class
FlightType
 Flight type   string  
Segments
 Segments   string  
Remark
 Remark   string  
TicketImage
 Ticimage   string  
IssueDate
 Issue date
Format ddMMyyyy		   string 12032025
Error code
Error code Interpretation
0000 Success
0001 System error
0002 Invalid request
zalo