UpdateOrder

  • Purpose: Used by the supplier to notify AeroHub of ticketing information and complete the ticketing process.
  • Request: POST
  • Encryption: No
  • URL: /supplier/v1/api/update_order

Request

Name Type Required Description
apiKey string ✅ Each supplier has a unique apiKey to represent their identity. Provided by AeroHub before interface testing.
requestId string ✅ Unique ID for each call in the ticketing process. 32 characters in length.
purchaseOrderNo string ✅ AeroHub’s order number, corresponding to Order interface’s OrderNo.
orderStatus string ✅ The updated order status. Possible values: TICKETED (ticketed), REJECTED (rejected).
sourceType int ⬜️ Source type of the interface call. AeroHub internal field. 1 for API call, 2 for supplier backend call. Default is 1.
reason string ⬜️ Rejection reason. Required when orderStatus is set to REJECTED.
ticketNoItems array/ticketNoItems Element ⬜️ Ticketing information, must be genuine and valid. Used for airline’s official website reservation management and passenger check-in. Required when orderStatus is set to TICKETED.

array/ticketNoItems Element

Name Type Required Description
passengerName string ✅ Passenger’s name, separated by / between last name and first name (LastName/FirstName MiddleName).
flightNumber string ✅ Flight number, e.g., CA123.
cardNo string ✅ ID card number, maximum 15 characters.
pnrCode string ✅ Code that can manage booking information on the airline’s official website, such as traditional airline’s large code or low-cost airline’s PNR.
ticketNo string ✅ Ticket number. For low-cost airlines, it can be the same as PNRCode if not available.
segmentNo int ✅ Sequence of the journey, 1 for outbound, 2 for return.
sequence int ✅ Segment sequence, starting from 1. Note: For round trips, both outbound and return start from 1.
depAirport string ✅ Departure airport code, using IATA three-letter code as the standard.
arrAirport string ✅ Arrival airport code, using IATA three-letter code as the standard.
ticketingTime int ✅ The actual time of the supplier’s ticketing, for traceability. In timestamp format, 10 digits (accurate to the second).
accountName string ⬜️ The account registered by the airline when issuing tickets on the official website, used for reservation management.
accountPass string ⬜️ The password for the account registered by the airline when issuing tickets on the official website, used for reservation management.
contactName string ⬜️ Contact person’s name provided by the supplier during ticket issuance, for customer service or quality inspection. Last name and first name are separated by a slash, LastName/FirstName MiddleName
contactEmail string ⬜️ Email address provided by the supplier during ticket issuance, for customer service or quality inspection.
contactMobile string ⬜️ Mobile phone number provided by the supplier during ticket issuance, for customer service or quality inspection.

Sample Request:

{
    "apiKey": "bMkMG6CO9pslu2Cv8YTQBb4kJVS7",
    "requestId": "B2B171eAv8YTQ",
    "purchaseOrderNo": "F1745553257834618888",
    "orderStatus": "TICKETED",
    "sourceType": 1,
    "reason": "",
    "ticketNoItems": [{
        "passengerName": "ZHANG/SAN",
        "flightNumber": "LA2407",
        "cardNo": "166341242",
        "pnrCode": "LT75TO",
        "ticketNo": "LT75TO",
        "segmentNo": 1,
        "sequence": 1,
        "depAirport": "VVI",
        "arrAirport": "LIM",
        "ticketingTime": 1705026483,
        "accountName": "",
        "accountPass": "",
        "contactName": "ZHANG/SAN",
        "contactEmail": "zhang@gmail.com",
        "contactMobile": "+8615001230000"
    }]
}

Response

Name Type Required Description
code int ✅ AeroHub status code, refer to Market Errors in the general instructions.
msg string ✅ AeroHub error description, refer to Market Errors in the general instructions.

Success Response:

{
    "code": 200,
    "msg": "Successful"
}

Error Response

{
    "code": 400,
    "msg": "Failed"
}

Special

  • In cases where the code in the returned JSON data is not equal to 200 or the HTTP status code is not 200, suppliers should retry the call to ensure successful processing of the request.
Author：AeroHub  Create time：2023-07-10 16:15
Last editor：AeroHub  Update time：2025-07-29 17:21