Order

  • Purpose: Used to generate AeroHub’s supplier order, generating an order means the supplier should make a reservation, reducing the rate of price changes.
  • Request: POST
  • Encryption: Yes

Request

Parameter Name Type Required Description
requestId string ✅ The request ID. It is unique for each interface in the booking process and connects the entire booking flow. It should be 32 characters long.
orderNo string ✅ AeroHub’s order number. The length is 20 characters. The supplier must save this for reference in the ticketing phase.
tripType int ✅ Trip type: 1 for one-way, 2 for round-trip.
sessionId string ✅ Session identifier. A unique ID consisting of numbers or letters, up to 40 characters, linking all interfaces in the booking process.
routing object/routing Element ✅ The routing and pricing information, referenced from the Verify interface’s object/routing Element.
passengers array/passenger Element ✅ Passenger information.
contact object/contact Element ✅ Contact information.
passengerBaggages array/passengerBaggages Element ⬜️ Optional auxiliary service information.
passengerSeats array/passengerSeats Element ⬜️ Optional seat selection information for passengers.
baggageSources string ⬜️ Empty: Supplier-provided baggage information; FMKT: Faremarket baggage data.

array/passenger Element

Parameter Name Type Required Description
passengerNo int ✅ The passenger sequence number, starting from 0.
name string ✅ The passenger’s name, formatted as LastName/FirstName MiddleName.
ageType int ✅ The passenger type: 0 for adult, 1 for child, 2 for infant.
birthday string ✅ The passenger’s date of birth, in the format YYYYMMDD.
gender string ✅ The passenger’s gender: M for male, F for female.
cardType string ⬜️ The type of identity document: PP for passport, GA for Hong Kong-Macau Travel Permit, TW for Taiwan Travel Permit, TB for Taiwan compatriot travel permit, HX for Mainland-Hong Kong/Macau Travel Permit, HY for international seaman’s certificate, ID for national ID,NIE for Foreign Identification Number (Spain), DNI for Identification Number (Spain), UN for unknown.
cardNo string ⬜️ The document number, up to 15 characters.
cardIssuePlace string ⬜️ The country where the document was issued, using the ISO 3166 two-letter code.
cardExpired string ⬜️ The document expiration date, in the format YYYYMMDD.
withPassengerNo int ⬜️ When the passenger type is infant, this field must be provided, indicating the accompanying adult’s passengerNo.
nationality string ⬜️ The passenger’s nationality, using the ISO 3166 two-letter code.

object/contact Element

Parameter Name Type Required Description
fullName string ✅ The contact’s full name, formatted as LastName/FirstName MiddleName.
address string ✅ The contact’s address.
postCode string ⬜️ The postal code.
email string ✅ The contact’s email address.
mobile string ✅ The contact’s mobile number.

array/passengerBaggages Element

Parameter Name Type Required Description
passengerNo int ⬜️ The passenger sequence number, starting from 0.
passengerName string ⬜️ The passenger’s name, formatted as LastName/FirstName MiddleName.
payBaggages array/payBaggages Element ⬜️ Auxiliary service details.

array/payBaggages Element

Parameter Name Type Required Description
flightNumber string ✅ Flight number, e.g., CA123.
depAirport string ✅ Departure airport code, using the IATA three-letter code.
arrAirport string ✅ Arrival airport code, using the IATA three-letter code.
depTime string ✅ Departure date and time (local time), format: YYYYMMDDHHMM (e.g., 20230310 for March 10, 2023).
baggagePrices array/baggagePrice Element ✅ List of baggage prices.

array/baggagePrice Element

Parameter Name Type Required Description
code string ✅ Auxiliary service code, should match the SSR interface’s code.
name string ✅ Auxiliary service name, should match the SSR interface’s name.
type int ✅ Auxiliary service type: 0 for checked baggage, 1 for carry-on baggage, 2 for check-in, 3 for fast boarding + priority boarding package, matching SSR interface.
count int ✅ Quantity of auxiliary services needed.
weight int ✅ Baggage weight, matching SSR interface.
bookSalePrice float ✅ Booking price for the auxiliary service, matching SSR interface, rounded to two decimal places.
currency string ✅ Currency of the auxiliary service, should match the ticket’s currency and SSR interface.
desc string ⬜️ Description of the auxiliary service, matching SSR interface.

array/passengerSeats Element

Parameter Name Type Required Description
passengerNo int ✅ The passenger sequence number, starting from 0.
passengerName string ✅ The passenger’s name, formatted as LastName/FirstName MiddleName.
seats array/seats Element ✅ Seat selection information.

array/seats Element

Parameter Name Type Required Description
flightNumber string ✅ Auxiliary code, should match the code returned by the SSR interface
depAirport string ✅ Departure airport code, consistent with the SSR interface
arrAirport string ✅ Arrival airport code, consistent with the SSR interface
depTime string ✅ Departure time (local time), format: YYYYMMDDHHMM, e.g., 20230310 means March 10, 2023
segmentNo int ✅ Flight segment sequence, 1 for outbound, 2 for return
sequence int ✅ Segment order, starting from 1. Note: for round-trip, both outbound and return are numbered starting from 1
amount float ✅ Seat price, if the price is 0, it means the seat is included in the package for free
currency string ✅ Transaction currency
rowNo string ✅ Row number in the seating chart
colNo string ✅ Column number in the seating chart
data string ✅ Original data from the GetSeat interface, used by suppliers for internal business integration
deck string ✅ M: Main Deck (lower cabin); U: Upper Deck (upper cabin)
status int ✅ 0: Not available, 1: Available
nearAisle int ✅ Whether near the aisle: 0: Unknown, 1: Yes, 2: No
nearExit int ✅ Whether near the exit: 0: Unknown, 1: Yes, 2: No
nearLavatory int ✅ Whether near the lavatory: 0: Unknown, 1: Yes, 2: No
nearWindow int ✅ Whether near the window: 0: Unknown, 1: Yes, 2: No
overWing int ✅ Whether near the wing: 0: Unknown, 1: Yes, 2: No
allowChildSelected int ⬜️ Whether children are allowed to select seats: 0: Unknown, 1: Yes, 2: No
withInfant int ⬜️ Whether the current seat allows an infant: 0: Unknown, 1: Yes, 2: No

Sample Request

{
    "requestId": "bc3461520668454e",
    "orderNo": "F1726885264686714880",
    "tripType": 2,
    "sessionId": "aNBOGd3p7Kf72ALZOQY",
    "routing": {
        "data": "DST_djlfOUNCMkNCSl9QVkd",
        "fromSegments": [{
            "marketingCarrier": "9C",
            "depAirport": "PVG",
            "depTime": "202302100915",
            "arrAirport": "HKG",
            "arrTime": "202302101220",
            "seatGrade": "",
            "seatClass": "V",
            "flightNumber": "9C8921",
            "codeShare": false,
            "aircraftCode": "",
            "segmentNo": 1,
            "operatingCarrier": "",
            "operatingFlightNo": "",
            "stopCities": ""
        }],
        "retSegments": [{
            "marketingCarrier": "9C",
            "depAirport": "HKG",
            "depTime": "202302151320",
            "arrAirport": "PVG",
            "arrTime": "202302151545",
            "seatClass": "V",
            "seatGrade": "",
            "flightNumber": "9C8922",
            "codeShare": false,
            "aircraftCode": "",
            "segmentNo": 2,
            "operatingCarrier": "",
            "operatingFlightNo": "",
            "stopCities": ""
        }]
    },
    "passengers": [{
        "passengerNo": 0,
        "name": "ZHANG/SAN",
        "ageType": 0,
        "birthday": "19890910",
        "gender": "M",
        "cardType": "",
        "cardNo": "",
        "cardIssuePlace": "CN",
        "cardExpired": "20201125",
        "nationality": "CN"
    }],
    "contact": {
        "fullName": "ZHANG/SAN",
        "address": "XXX, Beijing, China",
        "postCode": "200335",
        "email": "SAN@aerohubtech.com",
        "mobile": "13810001234"
    },
    "passengerBaggages": [{
        "passengerNo": 0,
        "passengerName": "QIN/GANGFENG",
        "payBaggages": [{
            "flightNumber": "9C8921",
            "depAirport": "PVG",
            "arrAirport": "HKG",
            "depTime": "202002100915",
            "baggagePrices": [{
                "code": "PA20",
                "name": "20 KG",
                "type": 1,
                "count": 1,
                "weight": 20,
                "bookSalePrice": 100,
                "currency": "USD",
                "desc": ""
            }, {
                "code": "PA30",
                "name": "30 KG",
                "type": 1,
                "count": 2,
                "weight": 30,
                "bookSalePrice": 180,
                "currency": "USD",
                "desc": ""
            }]
        }]
    }],
    "passengerSeats": [{
        "passengerNo": 0,
        "passengerName": "QIN/GANGFENG",
        "seats": [{
            "flightNumber": "9C8921",
            "depAirport": "PVG",
            "arrAirport": "HKG",
            "segmentNo": 1,
            "sequence": 1,
            "depTime": "202002100915",
            "amount": 19.32,
            "currency": "USD",
            "rowNo": "1",
            "colNo": "A",
            "data": "eyJzZXJ2aWNlQ29kZSI6ICJTVEZTIiwgI0=",
            "deck": "M",
            "status": 1,
            "nearAisle": 0,
            "nearExit": 0,
            "nearLavatory": 0,
            "nearWindow": 0,
            "overWing": 0,
            "allowChildSelected": 0,
            "withInfant": 0
        }, {
            "flightNumber": "9C8922",
            "depAirport": "HKG",
            "arrAirport": "TYO",
            "segmentNo": 2,
            "sequence": 1,
            "depTime": "202002301115",
            "amount": 29.32,
            "currency": "USD",
            "rowNo": "10",
            "colNo": "B",
            "data": "eyJzZXJ2aWNlQ29kZSI6ICJTVEZTIiwgI0=",
            "deck": "M",
            "status": 1,
            "nearAisle": 0,
            "nearExit": 0,
            "nearLavatory": 0,
            "nearWindow": 0,
            "overWing": 0,
            "allowChildSelected": 0,
            "withInfant": 0
        }]
    }]
}

Response

Parameter Name Type Required Description
marketErrorCode int ✅ Supplier system error code, used to help AeroHub and the supplier troubleshoot the issue. Please return the actual error truthfully.
marketErrorMsg string ✅ Supplier system error description, please return the actual error reason truthfully, length less than 300 characters.
sessionId string ✅ Session identifier, a unique identifier for the supplier’s reservation process, consisting of digits or letters, maximum length 40 characters.
orderNo string ✅ The supplier’s own system order number, maximum 30 characters. AeroHub will record this field for later traceability.
pnrCode string ✅ PNR code used for pricing/booking hold.
maxSeats int ✅ Total number of seats booked, maximum of 9.
orderContact object ✅ Contact information used at the time of booking, should match the contact information in the airline’s official booking management and should be able to receive airline emails at the provided email address.
routing object ✅ Itinerary and pricing information, refer to the object/routing Element in the Verify interface.
passengerBaggages array/passengerBaggages Element ⬜️ Actual ancillary information for the booking, should be consistent with the request, this parameter is used to verify if both systems’ order bookings are consistent.
passengerSeats array/passengerSeats Element ⬜️ Seat selection information for ancillary services.

Success Response:

{
    "marketErrorCode": 200,
    "marketErrorMsg": "Successful",
    "sessionId": "5821bdc6e733aec47432d2omyrwz",
    "orderNo": "lf24011914090061116",
    "pnrCode": "5MO00B",
    "maxSeats": 3,
    "orderContact": {
        "address": "Beijing 62",
        "fullName": "ZHANG/SAN",
        "mobile": "911114174",
        "email": "zhangsan@aerohub.com",
        "postCode": "10001"
    },
    "routing": {
        "data": "eyJzIjogIjU4MjFiZGM2ZTczM2FlY==",
        "fromSegments": [{
            "marketingCarrier": "T6",
            "seatClass": "B",
            "depAirport": "USU",
            "arrAirport": "ENI",
            "codeShare": false,
            "aircraftCode": "",
            "stopCities": "",
            "flightNumber": "T6537",
            "seatGrade": "Y",
            "segmentNo": 0,
            "depTime": "2024-01-25T12:50:00",
            "arrTime": "2024-01-25T13:30:00",
            "operatingCarrier": "",
            "operatingFlightNo": ""
        }],
        "retSegments": [],
        "priceList": [{
                "passengerType": 0,
                "publishPrice": 55.37,
                "price": 55.37,
                "taxFeeAmount": 19.56,
                "taxFeeDisclosureList": null
            },
            {
                "passengerType": 1,
                "publishPrice": 55.37,
                "price": 55.37,
                "taxFeeAmount": 19.56,
                "taxFeeDisclosureList": null
            }
        ],
        "originPriceList": [{
                "passengerType": 0,
                "publishPrice": 55.37,
                "price": 55.37,
                "taxFeeAmount": 19.56,
                "taxFeeDisclosureList": null
            },
            {
                "passengerType": 1,
                "publishPrice": 55.37,
                "price": 55.37,
                "taxFeeAmount": 19.56,
                "taxFeeDisclosureList": null
            }
        ],
        "eligibility": "",
        "validatingCarrier": "T6",
        "productType": "",
        "fareBasis": "",
        "bookingOfficeNo": "",
        "ticketingOfficeNo": "",
        "reservationType": "1X",
        "posCode": "",
        "complexTerm": 0,
        "minAge": 0,
        "maxAge": 0,
        "planCategory": "",
        "invoiceType": "E",
        "minPassengerCount": 1,
        "maxPassengerCount": 9,
        "note": "",
        "airlineAncillaries": null,
        "formatBaggageDetailList": [{
                "segmentNo": 1,
                "flightSeq": "1",
                "passengerType": 0,
                "baggagePiece": 0,
                "baggageWeight": -1
            },
            {
                "segmentNo": 1,
                "flightSeq": "1",
                "passengerType": 1,
                "baggagePiece": 0,
                "baggageWeight": -1
            }
        ],
        "refundInfoList": [{
                "passengerType": 0,
                "refundType": 0,
                "refundStatus": "T",
                "refundFee": 0.0,
                "refNoshow": "T",
                "refNoShowCondition": 0,
                "refNoshowFee": 0.0,
                "conditionList": null
            },
            {
                "passengerType": 1,
                "refundType": 0,
                "refundStatus": "T",
                "refundFee": 0.0,
                "refNoshow": "T",
                "refNoShowCondition": 0,
                "refNoshowFee": 0.0,
                "conditionList": null
            }
        ],
        "changesInfoList": [{
                "passengerType": 0,
                "changesType": 0,
                "changesStatus": "T",
                "changesFee": 0.0,
                "revNoShow": "",
                "revNoShowCondition": 0,
                "revNoShowFee": 0.0,
                "conditionList": null
            },
            {
                "passengerType": 1,
                "changesType": 0,
                "changesStatus": "T",
                "changesFee": 0.0,
                "revNoShow": "",
                "revNoShowCondition": 0,
                "revNoShowFee": 0.0,
                "conditionList": null
            }
        ],
        "packageInfo": {
            "packageType": "",
            "packageName": ""
        },
        "currency": "USD",
        "ticketTimeUnit": 0,
        "combineIndexs": null,
        "endorsement": 0
    },
    "passengerBaggages": [{
            "passengerNo": 0,
            "passengerName": "ZHANG/SAN",
            "payBaggages": [{
                "flightNumber": "T6537",
                "depAirport": "USU",
                "arrAirport": "ENI",
                "depTime": "2024-01-25T12:50:00",
                "baggagePrices": [{
                    "code": "PA20",
                    "name": "20 KG",
                    "type": 0,
                    "count": 2,
                    "weight": 20.0,
                    "bookSalePrice": 15.32,
                    "currency": "USD",
                    "desc": ""
                }]
            }]
        },
        {
            "passengerNo": 1,
            "passengerName": "LI/SI",
            "payBaggages": [{
                "flightNumber": "T6537",
                "depAirport": "USU",
                "arrAirport": "ENI",
                "depTime":"202002100915",
                "baggagePrices": [{
                    "code": "PA20",
                    "name": "20 KG",
                    "type": 0,
                    "count": 2,
                    "weight": 20.0,
                    "bookSalePrice": 15.32,
                    "currency": "USD",
                    "desc": ""
                }]
            }]
        },
        {
            "passengerNo": 2,
            "passengerName": "WANG/WU",
            "payBaggages": [{
                "flightNumber": "T6537",
                "depAirport": "USU",
                "arrAirport": "ENI",
                "depTime": "202002100915",
                "baggagePrices": [{
                    "code": "PA20",
                    "name": "20 KG",
                    "type": 0,
                    "count": 2,
                    "weight": 20.0,
                    "bookSalePrice": 15.32,
                    "currency": "USD",
                    "desc": ""
                }]
            }]
        }
    ],
    "passengerSeats": [{
        "passengerNo": 0,
        "passengerName": "QIN/GANGFENG",
        "seats": [{
                "flightNumber": "9C8921",
                "depAirport": "PVG",
                "arrAirport": "HKG",
                "depTime": "202002100915",
                "segmentNo": 1,
                "sequence": 1,
                "amount": 19.32,
                "currency": "USD",
                "rowNo": "1",
                "colNo": "A",
                "data": "eyJzZXJ2aWNlQ29kZSI6ICJTVEZTIiwgI0=",
                "deck": "M",
                "status": 1,
                "nearAisle": 0,
                "nearExit": 0,
                "nearLavatory": 0,
                "nearWindow": 0,
                "overWing": 0,
                "allowChildSelected": 0,
                "withInfant": 0
            },
            {
                "flightNumber": "9C8922",
                "depAirport": "HKG",
                "arrAirport": "TYO",
                "depTime": "202002301115",
                "segmentNo": 2,
                "sequence": 1,
                "amount": 29.32,
                "currency": "USD",
                "rowNo": "10",
                "colNo": "B",
                "data": "eyJzZXJ2aWNlQ29kZSI6ICJTVEZTIiwgI0=",
                "deck": "M",
                "status": 1,
                "nearAisle": 0,
                "nearExit": 0,
                "nearLavatory": 0,
                "nearWindow": 0,
                "overWing": 0,
                "allowChildSelected": 0,
                "withInfant": 0
            }
        ]
    }]
}],
    "processTime": 2.9854
}

Error Response

{
    "marketErrorCode": 5112,
    "marketErrorMsg": "Price changed to no seat"
}
Author：AeroHub  Create time：2023-07-10 16:13
Last editor：AeroHub  Update time：2025-07-29 17:21