UpdateOrder

  • 用途：用于供应商将出票信息通知给AeroHub，完成出票
  • 请求方式：POST
  • 接口加密：否
  • FareMarket地址：/supplier/v1/api/update_order

请求参数

参数名称 类型 必填 说明
apiKey string ✅ 每个供应商有自己唯一的apiKey，用于表示供应商身份，AeroHub在接口测试前提供给供应商
requestId string ✅ 请求ID，出票环节每个次调用是唯一的，长度32位
purchaseOrderNo string ✅ AeroHub的订单号，与Order接口请求时的OrderNo对应
orderStatus string ✅ 需要更新的订单状态，TICKETED 已出票、TICKETED，REJECTED 拒单
sourceType int ⬜️ 调用接口的来源，AeroHub自用字段，1 通过API调用，2 通过供应商后台调用，默认1
reason string ⬜️ 拒单理由，orderStatus赋值REJECTED时必须填写,可参照示例：Incorrect information;Withdraw before issuing;Duplicate booking;Fare change; Flight sold out;Ancillary not available;Airline error;Payment card error;Automatic ticketing failed
ticketNoItems array/ticketNoItems Element ⬜️ 出票信息，需要真实有效，可用于航司官网的预定管理与客人值机，orderStatus赋值TICKETED时必填

array/ticketNoItems Element

参数名称 类型 必填 说明
passengerName string ✅ 乘客姓名，姓和名之间用/隔开，LastName/FirstName MiddleName
flightNumber string ✅ 航班号，如：CA123
cardNo string ✅ 证件号码，最大 15 个字符
pnrCode string ✅ 可在航司官网管理预定信息的编码，如传统航司的大编码、廉航的PNR
ticketNo string ✅ 票号，廉价航空若没有可和PNRCode一致
segmentNo int ✅ 航程顺序，1 去程、2 回程
sequence int ✅ 航段顺序，从1开始，注意：若是往返，去程和回程都是从1开始
depAirport string ✅ 出发机场代码，采用 IATA 三字代码做为标准
arrAirport string ✅ 到达机场代码，采用 IATA 三字代码做为标准
ticketingTime int ✅ 供应商出票的真实时间，用于追溯，采用时间戳格式，长度10位（精确到秒级）
accountName string ⬜️ 在航司官网出票时注册的账号，用于预定管理
accountPass string ⬜️ 在航司官网出票时注册账号的密码，用于预定管理
contactName string ⬜️ 供应商出票时预留的联系人，用于客户做售后或质检，姓和名之间用/隔开，LastName/FirstName MiddleName
contactEmail string ⬜️ 供应商出票时预留的邮箱，用于客户做售后或质检
contactMobile string ⬜️ 供应商出票时预留的手机号，用于客户做售后或质检

请求示例

出票成功请求

{
    "apiKey": "PcrNq8964iFUkE0CyVV4bhgXXX",
    "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"
    }]
}

返回参数

参数名称 类型 必填 说明
code int ✅ AeroHub的状态码，参考通用说明中的Market Errors
msg string ✅ AeroHub的错误说明，参考通用说明中的Market Errors

返回示例

Success-Response:

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

Error-Response

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

注意事项

  • 在遇到返回的 JSON 数据中 code 不等于 200 或 HTTP 状态码非 200 的情况时，供应商需要重试调用以确保请求的成功处理。
Author：AeroHub  Create time：2023-07-10 16:15
Last editor：AeroHub  Update time：2025-10-28 15:50