14.1订单数据同步接口 · 收吖开发文档

ISV 代商家接入扫码点餐前，请根据[添加功能并签约](https://opendocs.alipay.com/mini/00ns1o#%E6%B7%BB%E5%8A%A0%E8%83%BD%E5%8A%9B%E5%B9%B6%E7%AD%BE%E7%BA%A6)指引，在三方应用中添加： 1. [小程序二维码](https://opendocs.alipay.com/mini/introduce/qrcode) 能力，用于生成点餐二维码。 2. [当面付](https://opendocs.alipay.com/open/194/105072)能力用于替换自研商家使用的**小程序支付**能力。 3. [服务商代运营基础包](https://opendocs.alipay.com/mini/01hp14)、[蚂蚁门店管理](https://opendocs.alipay.com/mini/0149jo)能力，用于代商家创建蚂蚁门店。 4. [小程序订单中心](https://opendocs.alipay.com/mini/introduce/ordercenter)能力，用于回传扫码点餐订单获取返佣。 ~~~[api] post:/api/alipayopen/aliPayMerchantOrderSync *string:token=默认值#公共登录令牌 *outTradeNo#系统订单号 *preGenerateNo#系统预生成单号 discountInfoListExternalDiscountId#128,(订单优惠信息)外部优惠id discountInfoListDiscountName#20,(订单优惠信息)优惠名称 discountInfoListDiscountAmount#10,(可选,订单优惠信息)优惠金额 orderType=TRADE_ORDER#32,订单类型,若为空,默认为交易订单,每次请求必传服务订单-SERVICE_ORDER 交易订单-TRADE_ORDER orderAuthCode#64,订单授权码(与订单一一对应,不是请求维度的,服务订单首次同步必传)利用订单同步前获取的formId作为订单授权码. 订单授权码对应的小程序id与买家uid与同步订单的小程序id和买家uid一致.注:当orderType为SERVICE_ORDER时必填 orderModifiedTime#32,订单修改时间,一般不需要传入用于订单状态或数据变化较快的顺序控制,order_modified_time较晚的同步会被最终存储,order_modified_time相同的两次同步可能会被幂等处理,SERVICE_ORDER按照行业标准化接入场景必传 ticketInfoType#64,(可选,凭证信息)凭证类型 MEAL_NUM-取餐号;PICKUP_CODE-取件码;SELF_PICK_CODE-自提码;PASSWORD-口令 ticketInfoTicketNo#64,(可选,凭证信息)单据号,不同类型下单据号含义不同. 若类型为MEAL_NUM,则ticket_no表示取餐号;若类型为PICKUP_CODE,则ticket_no表示取件码 ticketInfoTime#64,(可选,凭证信息)时间,如果传入了end_time则该字段必传不同类型下的地址含义不同. 若type为MEAL_NUM,time则代表取餐时间; 若type为PICKUP_CODE,address则代表取件时间 orderCreateTime#32,订单创建时间,当order_type为SERVICE_ORDER时必传 orderPayTime#32,订单支付时间当pay_channel为非ALIPAY时,且订单状态已流转到“支付”或支付后时,需要将支付时间传入 recordId#34,商户订单同步记录id buyerInfoName#16,(可选,buyer_info与buyer_id必选其一)姓名 buyerInfoMobile#20,可选,buyer_info与buyer_id必选其一手机号 buyerInfoCertNo#64,可选,buyer_info与buyer_id必选其一证件号 discountAmount#11,优惠金额 payTimeoutExpress#7,支付超时时间,超过时间支付宝自行关闭订单 sendMsg#16,是否需要小程序订单代理发送模版消息,Y代表需要发送,N代表不需要发送,不传默认不发送 discountInfoListDiscountQuantity#10,(可选,订单优惠信息)优惠数量 discountInfoListDiscountPageLink#128,(可选,订单优惠信息)优惠跳转链接地址 ticketInfoResvType#64,(可选,凭证信息)凭证预约类型,一般不需要传入. 可选值为INSTANT/RESERVATION,其中INSTANT代表是实时凭证,RESERVATION代表是预约凭证,不传入默认为实时凭证. 区别在于预约凭证一般不是当场可取,而是用户下单后的很多天之后才可以凭借凭证提取 ticketInfoAddress#128,(可选,凭证信息)地址不同类型下的地址含义不同. 若type为MEAL_NUM,address则代表取餐地点; 若type为PICKUP_CODE,address则代表取件地点 ticketInfoShop#128,(可选,凭证信息)凭证可核销门店/货品自提门店,如果自提门店与购买门店不一致,可传入该字段提示用户自提门店 ticketInfoEndTime#64,(可选,凭证信息)截止时间,如果凭证自提/核销时间是一个时间段可传入该字段,time代表自提开始时间,end_time代表自提结束时间,结束时间必须晚于开始时间 logisticsInfoListTrackingNo#128,(可选,物流信息,列表最多支持物流信息个数)物流单号 logisticsInfoListLogisticsCode#128,(可选,物流信息,列表最多支持物流信息个数)物流公司编号,注:该值为空时,有可能匹配不到物流信息.若有则必传 <<< success { 'status':'1', 'message':'成功信息', 'data':{ 'record_id':'', //同步订单记录id,(同步小程序订单成功必返回record_id) 'order_id':'', //支付宝订单号 'order_status':'' //订单状态 } } <<< error { 'status':'2', 'message':'错误信息', 'data':{} } ~~~