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

Add baggage

Tổng quan

Request URL: https://ibe.datacom.vn/api/Flight/AddBaggage
Method: POST
Data Type JSON
API Specification: View details

Hệ thống áp dụng

System code  System name
VN Vietnam Airlines
VJ Vietjet Air
QH Bamboo Airways
VU Vietravel Airlines
AK AirAsia
TR Scoot

Request

{
  "RequestInfo": {
    "PrivateKey": "string",
    "ApiAccount": "string",
    "ApiPassword": "string",
    "Currency": "string",
    "Language": "string",
    "IpAddress": "string"
  },
  "System": "string",
  "BookingCode": "string",
  "ListPassenger": [
    {
      "NameId": "string",
      "ListBaggage": [
        {
          "Value": "string",
          "Currency": "string",
          "StartPoint": "string",
          "EndPoint": "string",
          "Session": "string"
        }
      ]
    }
  ]
}
Data Specification
Fields Description Data type Required? Examples
RequestInfo Data query
View descriptoin Common attribute		 object Yes

 
System Reservation system string Yes VN
BookingCode Booking code string Yes  
ListPassenger List passengers object Yes  
NameId
 Identifier returned by the airline system
string
 Yes  
      ListBaggage Service list information object Yes  
Value
 Value string Yes  
Currency
 Currency string Yes VND
StartPoint
 Start point code string Yes HAN
EndPoint
 Arrival point code string Yes SGN
Session
 Session string Yes  

 

Response

{
  "StatusCode": "string",
  "Success": true,
  "Message": "string",
  "Language": "string",
  "RequestID": 0,
  "Booking": {
    "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",
    "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,
          "Exchangeable": true,
          "Availability": 0,
          "Unavailable": true,
          "ExpiryDate": "string",
          "BaseFare": 0,
          "PriceAdt": 0,
          "NetFare": 0,
          "TotalFare": 0,
          "Discount": 0,
          "Currency": "string",
          "Airline": "string",
          "System": "string",
          "Source": "string",
          "Tourcode": "string",
          "ListFarePax": [
            {
              "PaxType": "string",
              "PaxNumb": 0,
              "BaseFare": 0,
              "NetFare": 0,
              "TotalFare": 0,
              "Discount": 0,
              "Currency": "string",
              "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": "2025-11-12T07:12:19.584Z",
            "EndDate": "2025-11-12T07:12:19.584Z",
            "DepartDate": "string",
            "ArriveDate": "string",
            "FlightNumber": "string",
            "StopNum": 0,
            "Duration": 0,
            "ListSegment": [
              {
                "Leg": 0,
                "SegmentId": "string",
                "Airline": "string",
                "Operator": "string",
                "StartPoint": "string",
                "EndPoint": "string",
                "StartDate": "2025-11-12T07:12:19.584Z",
                "EndDate": "2025-11-12T07:12:19.584Z",
                "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": "2025-11-12T07:12:19.584Z",
      }
    ]
  }
}
Đặc tả dữ liệu
Fields Description Data Type Examples
StatusCode Status code string 0000
Success Status returned boolean true
Message Returned error message string  
Language Returned language string Vi
RequestId Request ID int  
Booking
 Booking information object  
Source
 Data source string API
System
 Reservation 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 sign in string  
BookingImage
 Booking image string  
ResponseTime
 Response time double 2.21
AutoIssue
 Auto issue boolean false
Sandbox
 Booking onn the virtual system 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 flight fare object  
Leg
 Order of flight int 0 : the first intinerary
Journey
 Journey string HANSGN23112024
Itinerary
 Type of itineraries int  
Airline
 Airlines string VN
System
 System string 1G
Source
 Data source string API
Remark
 Remark string  
FareInfo
 Fare information list  
OptionId
 Option ID int 0
FareClass
 Fare class string H
FareBasis
 Farebasic string First Class
FareFamily
 Fare family string  
CabinCode
 Cabin code string  
CabinName
 Cabin name string  
Refundable
 Condition of refund boolean True/false
Availability
 The seats left int 9
Unavailable
 The class available or not boolean True/false
ExpiryDate
 Expiration time string 120
BaseFare
 Base fare of an adult double 0
PriceAdt
 Total price of an adult double 0
NetFare
 Net fare double 0
TotalFare
 Total fare double 0
Currency
 Currency string VND
Airline
 Airlines string VN
System
 System string VN
Source
 Data source string  
Tourcode
 Mã giảm giá áp dụng string  
ListFarePax
 Passenger fare information list list  
PaxType
 Passenger type string  
PaxNumb
 Number of passenger int  
BaseFare
 Base fare double  
NetFare
 Net fare double  
TotalFare
 Total fare double  
ListFareItem
 List of detailed fare information array[]  
Code
 Code string  
Amount
 Amount double  
Name
 Name String  
ListTaxDetail
 List of detailed tax information array[]  
Code
 Code string  
Amount
 Amount double  
Name
 Name string  
ListFareInfo
 List of detailed fare information array[]  
SegmentId
 SegmentID int  
StartPoint
 Start point string HAN
EndPoint
 End point string SGN
FareClass
 Fare class string  
FareBasis
 Farebasic string  
HandBaggage
 Free hand baggage string  
FreeBaggage
 Free baggage allowance string  
Availability
 Available seat left int  
ListFlight
 List flight list  
Leg
 Order of itineraries int 0
FlightId
 Flight ID string 123456
Airline
 Airlrine string VN
Operator
 Operator code string VN
StartPoint
 Start point string HAN
EndPoint
 End point string SGN
StartDate
 Ngày khởi hành
Định dạng ddMMyyyy		 string 12032025
EndDate
 Ngày hạ cánh
Định dạng ddMMyyyy		 string 12102025
DepartDate
 Ngày khởi hành
Định dạng ddMMyyyy		 string 12032025
ArriveDate
 Ngày hạ cánh
Định dạng ddMMyyyy		 string 12102025
FlightNumber
 Số hiệu chuyến bay string VN205
StopNum
 Số điểm dừng int 0
Duration
 Thời gian bay int 0
ListSegment
 Danh sách chặng bay list  
Leg
 Thứ tự chặng bay int 0
SegmentId
 ID hành trình bay string 123456
Airline
 Mã hãng hàng không string VJ
Operator
 Mã hãng vận chuyển string VN
StartPoint
 Mã sân bay điểm đi string HAN
EndPoint
 Mã sân bay điểm đến string SGN
StartDate
 Ngày khởi hành
Định dạng ddMMyyyy		 string 11122024
EndDate
 Ngày hạ hành
Định dạng ddMMyyyy		 string 01012025
DepartDate
 Ngày khởi hành
Định dạng ddMMyyyy		 datetime 11122024
ArriveDate
 Ngày hạ cánh
Định dạng ddMMyyyy		 datetime 12122024
StartTerminal
 Nhà ga khởi hành string 1
EndTerminal
 Nhà ga hạ cánh string 1
FlightNumber
 Số hiệu chuyến bay string VN205
Equipment
 Mã loại máy bay string  Airbus A321
FareClass
 Hạng chỗ string H
FareBasis
 Hạng giá string First Class
Duration
 Thời gian bay int 120
HasStop
 Có điểm dừng boolean True/false
StopPoint
 Mã sân bay điểm dừng string  
StopTime
 Thời gian dừng double  
TechnicalStop
 Mã sân bay điểm dừng kỹ thuật string  
MarriageGrp
 Nhóm chặng bay theo cặp string  
FlightsMiles
 Dặm bay int  
Status
 Mã trạng thái string  
Adt
 Số lượng khách người lớn int  
Chd
 Số lượng khách trẻ em int  
Inf
 Số lượng khách trẻ sơ sinh int  
Session
 Phiên làm việc string  
Status
 Trạng thái boolean  
Error
 Mã lỗi 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
 Thông tin danh sách hành khách object  
Index
Số thứ tự
int
 
ParentId
Mã định danh người lớn đi cùng em bé
int
 
NameId
Mã định danh do hệ thống hãng trả về
string
 
Type
 Loại hành khách string  
Title
 Danh xưng string Mrs
Gender
 Giới tính int  
GivenName
 Tên đệm và tên string  
Surname
 Họ string  
DateOfBirth
 Ngày sinh string  
PassengerId
 Id hành khách string  
Passport
 Thông tin hộ chiếu object  
DocumentType
 Loại hộ chiếu string  
DocumentCode
 Mã hộ chiếu string  
DocumentExpiry
 Thời gian hết hạn string  
Nationality
 Quốc tịch string  
IssueCountry
 Quốc gia cấp string  
ListBaggage
 Thông tin danh sách hành lý object  
System
 Hệ thống đặt chỗ string VN
Airline
 Hãng hàng không string 1G
Value
 Giá trị string  
Type
 Loại hành lý string  
PaxType
 Loại hành khách string ADT
Name
 Tên string  
Description
 Mô tả string  
Price
 Giá hành lý double  
Currency
 Đơn vị tiền tệ string VND
Leg
 Số thứ tự int  
StartPoint
 Mã sân bay điểm đi string HAN
EndPoint
 Mã sân bay điểm đến string SGN
StatusCode
 Mã trạng thái string  
Confirmed
 Xác nhận boolean  
Session
 Phiên làm việc string  
ListPreSeat
 Thông tin danh sách chỗ ngồi đặt trước object  
System
 Hệ thống đặt chỗ string VN
Airline
 Hãng hàng không string 1G
Value
 Giá trị string  
Type
 Loại hành lý string  
PaxType
 Loại hành khách string ADT
Name
 Tên string  
Description
 Mô tả string  
Price
 Giá hành lý double  
Currency
 Đơn vị tiền tệ string VND
Leg
 Số thứ tự int  
StartPoint
 Mã sân bay điểm đi string HAN
EndPoint
 Mã sân bay điểm đến string SGN
StatusCode
 Mã trạng thái string  
Confirmed
 Xác nhận boolean  
Session
 Phiên làm việc string  
ListService
 Thông tin danh sách dịch vụ object  
System
 Hệ thống đặt chỗ string VN
Airline
 Hãng hàng không string 1G
Value
 Giá trị string  
Type
 Loại hành lý string  
PaxType
 Loại hành khách string ADT
Name
 Tên string  
Description
 Mô tả string  
Price
 Giá hành lý double  
Currency
 Đơn vị tiền tệ string VND
Leg
 Số thứ tự int  
StartPoint
 Mã sân bay điểm đi string HAN
EndPoint
 Mã sân bay điểm đế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
 Thông tin danh sách giá vé object  
Code
 Mã string  
Amount
 Số tiền double  
Name
 Tên String  
ListMembership
 Thông tin danh sách thẻ thành viên object  
Airline
 Hãng hàng không string  
MembershipId
 Id thẻ thành viên string  
MembershipType
 Loại thẻ thành viên string  
ListTicket
 Thông tin danh sách vé object  
Index
Số thứ tự
int
 
System
 Hệ thống đặt chỗ string 1G
Airline
 Hãng hàng không string VN
BookingCode
 Mã đặt chỗ string  
ConjTktNum
 Đầu số vé string  
TicketNumber
 Số vé string  
TicketType
 Loại vé string  
TicketStatus
 Trạng thái vé string  
TicketRelated
 Vé liên quan string  
RelatedType
 Loại vé liên quan string  
ServiceType
 Loại dịch vụ string  
ServiceCode
 Mã dịch vụ string  
PaxType
 Passeneger type string  
FullName
 Full name string  
GivenName
 Given name string  
Surname
 Surname string  
NameId
 Identifier returned by airline string  
Fare
 Fare double 10000000
Tax
 Tax double 500000
Fee
 Fee double 500000
Vat
 Value Added Tax double 10
Total
 Total price double 10000000
Currency
 Currency code string VND
Itinerary
 Itinerary type int  
StartPoint
 Start point string HAN
EndPoint
 End point string SGN
DepartDate
 Departure date
Format ddMMyyyy		 string 12032025
ReturnDate
 Arrival date
Format ddMMyyyy		 string 18032025
FareClass
 Fare class string H
FareBasis
 Fraebasic string First Class
FlightType
 Flight type string  
Segments
 Segment list string  
Remark
 Remark string  
TicketImage
 Ticket image  string  
IssueDate
 Issuance date
Format ddMMyyyy		 string 12032025
Error Code
Error Code Description
0000 Success
0001 System error
0002 Invalid request
zalo