创建订单接口

更新时间： 2022-11-06 必须接入 在线调试（沙箱环境）

接口概述

1、该接口用来向供应商下单。
2、如果携程未收到响应信息，会间隔5秒后重试1次，如果仍无响应信息，则视为订单被取消，供应商需根据ctripPurchaseOrderId字段支持接口幂等。
3、性能要求：必须在2000ms内响应。

请求地址

地址格式:  {Domain}/{Channel}/ordercreate/2.0/{timeStamp}/{sign}

请求内容

CreateOrderRequest

注

1、携程用户单号（主单号）与携程采购单号存在一对多关系，供应商和携程交互时应该以采购单号为准。
2、当下单时的起终点、用车时间参数与查询产品时的请求参数完全一致时，请保留该次询价请求的日志，便于线上排障，至少保留2小时。

FixedLocationDTO

注

1、机场使用IATA代码，火车站为携程内部代码，如需要请线下联系携程商务。
2、携程在传机场地址时通常会将机场与具体的航站楼传给供应商，此时经纬度为具体航站楼的经纬度，方便供应商进行报价和接驳。有极小概率拿不到具体的航站楼数据，此时接口会传递机场经纬度，需要供应商自行兼容。如果不接受无航站楼报价，请联系携程技术屏蔽无航站楼报价。

GeoDTO

FlightInfoDTO

PassengerInfoDTO

AgentInfoDTO

SelectAddServiceDTO

EstimationStandardDTO

注：预估里程和时间仅供参考

PermissionDTO

返回内容

CreateOrderResponse

请求示例

{
  "ctripPurchaseOrderId": 4295005950716883,
  "categoryCode": "airport-dropoff",
  "totalPrice": 199,
  "priceMark": "64A06FFD269E5B32",
  "fixedLocation": {
    "fixedCode": "SHA",
    "cityId": "2",
    "cityName": "上海"
  },
  "vehicleType": 121,
  "useTime": "2020-10-30 16:22",
  "duseLocation": {
    "address": "地铁11号线",
    "detailAddress": "嘉定区 嘉定区",
    "longitude": 121.23748480579,
    "latitude": 31.391551182385,
    "geoType": "GCJ02"
  },
  "auseLocation": {
    "address": "虹桥国际机场",
    "detailAddress": "虹桥国际机场",
    "longitude": 121.326179,
    "latitude": 31.195514,
    "geoType": "GCJ02"
  },
  "flightInfo": {
    "departDelayTime": 30
  },
  "passenger": {
    "name": "张晓欢",
    "localPhoneAreaCode": "86",
    "localPhone": "13963746361",
    "maskRealPhone": "159***98902"
  },
  "agent": {},
  "masterOrderId": 4295005950716883,
  "needLandingVisa": false,
  "adults": 0,
  "children": 0,
  "luggage": 0
}

响应示例

{
  "msgCode": "OK",
  "message": "成功",
  "vendorOrderId": "20AD8D1J9WTW4W"
}

异常示例

{
  "msgCode": "ERROR_NO_PRICEMARK",
  "message": "价格标识符不存在"
}