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':{} } ~~~