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

## 通用场景: 商户可以调用此接口同步交易对应的订单数据 ~~~[api] post:/api/alipayopen/aliPayMerchantOrderSync *string:token=默认值#公共登录令牌 *outTradeNo#系统订单号 discountInfoListExternalDiscountId#128,(可选,订单优惠信息)外部优惠id discountInfoListDiscountName#20,(可选,订单优惠信息)优惠名称 discountInfoListDiscountAmount#10,(可选,订单优惠信息)优惠金额 orderType=TRADE_ORDER#特殊可选,32,订单类型,若为空,默认为交易订单,每次请求必传服务订单-SERVICE_ORDER 交易订单-TRADE_ORDER orderAuthCode#特殊可选,64,订单授权码(与订单一一对应,不是请求维度的,服务订单首次同步必传)利用订单同步前获取的formId作为订单授权码. 订单授权码对应的小程序id与买家uid与同步订单的小程序id和买家uid一致.注:当order_type为SERVICE_ORDER时必填 orderModifiedTime#特殊可选,32,订单修改时间,一般不需要传入用于订单状态或数据变化较快的顺序控制,order_modified_time较晚的同步会被最终存储,order_modified_time相同的两次同步可能会被幂等处理,SERVICE_ORDER按照行业标准化接入场景必传 ticketInfoType#必填,64,(可选,凭证信息)凭证类型 MEAL_NUM-取餐号;PICKUP_CODE-取件码;SELF_PICK_CODE-自提码;PASSWORD-口令 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 ~~~