物料平臺openApi接口文檔

1、物料平臺openApi接口文檔修改記錄版本修改日期修改記錄修改者V1.02017/06/16創(chuàng)建在東2017/07/171. 配送指令創(chuàng)建時間字段為:create_date2. 更新各字段和數(shù)據(jù)庫一致.在東2017/07/201. 增加配送地址信息數(shù)據(jù)結(jié)構(gòu)AssetDeliveryAddress2. 增加物流單信息數(shù)據(jù)結(jié)構(gòu)LogisticsInfo3. 配送指令增加物料信息, 配送數(shù)量, 申請單id.3. 其他字段更新說明等.在東2017/07/25配送指令中物流信息改成單數(shù), logistics_info 只在個性碼生產(chǎn)時有一個在東2017/07/31物料生產(chǎn)流程圖更新在東2017/08/0

2、7AssetDeliveryAddress加”區(qū)”的字段: district, 比如西湖區(qū)在東2017/08/09AssetDeliveryAddress的district拼寫錯誤改正.在東2017/08/15生產(chǎn)指令asset_resource字段格式定義說明(目前用于獲取空碼備貨的碼值文件地址.).在東2017/08/18生產(chǎn)指令asset_resource, key值附錄6.2說明.在東2017/10/231.生產(chǎn)指令新增3個字段, 用于透傳:生產(chǎn)單號(key為produce_order), 備注(key為memo), 業(yè)務(wù)渠道(key為biz_tag).2.個性碼的生產(chǎn)指令asset_

3、resource 中會新增個性碼碼值, key為PERSONAL_QRCODE.在東2017/12/41. 添加環(huán)境介紹2. 添加流程介紹3. 附錄中添加demo4. 配送指令新增字段業(yè)務(wù)渠道(key為biz_tag).歐陽巖松2017/12/191.增加supplier_name, 和supplier_id一起標(biāo)識對應(yīng)供應(yīng)商的信息.在東2018/02/05新增3.8 物料信息反饋接口在東2018/02/05機(jī)具序列號反饋格式為數(shù)組.在東2018/03/01增加3.4,3.7 - 暫不支持分批反饋說明.增加3.8 - 接口反饋節(jié)點(diǎn)說明.在東1 概述1.1 術(shù)語術(shù)語描述物料供應(yīng)商(商戶)物料生產(chǎn)

4、方物流供應(yīng)商(商戶)負(fù)責(zé)物流的供應(yīng)商物料平臺支付寶物料設(shè)計(jì)、生產(chǎn)、運(yùn)輸?shù)男畔⑵脚_.開放平臺支付寶開放平臺()，通過開放平臺網(wǎng)關(guān)提供開放api給第三方調(diào)用1.2 整體流程介紹商家通過物料平臺進(jìn)行物料生產(chǎn)和配送, 操作生產(chǎn)單的讀取和更新, 配送單的讀取和更新.物料生產(chǎn)流程物料配送流程1.3 錯誤碼錯誤碼錯誤描述ILLEGAL_PARAMS參數(shù)不合法SYSTEM_ERROR系統(tǒng)繁忙INVALID_OP非法操作SIGN_CHECK_FAIL驗(yàn)簽失敗PAGE_SIZE_ILLEGAL請求訂單數(shù)量不在指定范圍PRODUCE_ORDER_QUERY_FAILED獲取生產(chǎn)指令異常HAS_NO_ASSIGN_I

5、TEM供應(yīng)商名下無此分配記錄ASSET_PRODUCE_PROCESS_EXCEPTION配送反饋更新失敗異常注意: 僅列出部分, 后面更新, 待增加.2 接入流程2.1開放平臺接入接入指南詳細(xì)步驟: 詳見【物料平臺商家接入開放平臺】.線上(生產(chǎn))環(huán)境由供應(yīng)商按照文檔指南進(jìn)行接入.開發(fā)或測試環(huán)境由物料平臺接口人負(fù)責(zé)提供賬號進(jìn)行聯(lián)調(diào).2.2環(huán)境介紹1. stable環(huán)境也叫開發(fā)環(huán)境, 供應(yīng)商接入時開發(fā)聯(lián)調(diào)在該環(huán)境進(jìn)行, 測試app信息由物料平臺接口人提供.openapi網(wǎng)關(guān)地址: 2. sit環(huán)境：SIT環(huán)境即TEST環(huán)境, 和開發(fā)環(huán)境一樣屬于線下環(huán)境.開發(fā)環(huán)境聯(lián)調(diào)通過之后, 由物料平臺接口人決

6、定, 供應(yīng)商是否需要接入該環(huán)境進(jìn)行聯(lián)調(diào). openAPI網(wǎng)關(guān)地址: 3. 預(yù)發(fā)布環(huán)境這是上線前的必須在該環(huán)境進(jìn)行驗(yàn)收, 供應(yīng)商需要在此前按照物料平臺上架接入開放平臺申請好線上賬號.如何連接預(yù)發(fā):- 供應(yīng)商綁定hosts 8 - 然后訪問 , 網(wǎng)關(guān)地址為 https:/ 注意:預(yù)發(fā)布環(huán)境的數(shù)據(jù)庫跟線上生產(chǎn)環(huán)境是同一套，服務(wù)器是跟線上隔離的，PD/開發(fā)/測試在該環(huán)境下用真實(shí)的線上賬號進(jìn)行本次需求內(nèi)容的測試驗(yàn)收.預(yù)發(fā)環(huán)境供應(yīng)商必須走線下實(shí)際流程，必須實(shí)際在生產(chǎn)線上生產(chǎn)，然后送貨至物流商，反饋實(shí)際的物流信息和物料信息。物流商也必須按照實(shí)際流程進(jìn)行配送。完成流程以后預(yù)發(fā)才算通過。

7、4. 線上環(huán)境預(yù)發(fā)驗(yàn)證通過之后, 業(yè)務(wù)方確認(rèn)后可以開啟線上流量. 線上網(wǎng)關(guān): 2.3調(diào)用說明該章節(jié)說明openAP請求參數(shù)格式以及返回結(jié)果的格式, 物料平臺提供的api接口詳情參照下一章節(jié).(1) 基本參數(shù)所有API接口都必須傳入的參數(shù)如下:參數(shù)名參數(shù)名稱參數(shù)類型必填描述范例app_id開發(fā)者的AppidString(32)Y支付寶分配給開發(fā)者的應(yīng)用Id2014072300007148method接口名稱String(128)Y接口名稱alipay.trade.paycharset參數(shù)字符編碼String(10)Y請求使用的編碼格式，如utf-8,gbk,gb2312等utf-8sign_ty

8、pe簽名類型String(10)Y商戶生成簽名字符串所使用的簽名算法類型，目前支持RSARSAsign簽名String(256)Y商戶請求參數(shù)的簽名串詳見簽名生成規(guī)則timestamp時間戳StringY發(fā)送請求的時間，格式“yyyy-MM-dd HH:mm:ss”2014-07-24 03:07:50version接口版本號StringY調(diào)用的接口版本，固定為：1.01.0notify_url接口異步通知urlString(256)N支付寶服務(wù)器主動通知商戶服務(wù)器里指定的頁面http路徑biz_content業(yè)務(wù)參數(shù)StringYJSON格式，具體包含的內(nèi)容參見各個接口的業(yè)務(wù)參數(shù)描述詳見各業(yè)

9、務(wù)接口(2) 業(yè)務(wù)參數(shù)每個API接口還有一些其他業(yè)務(wù)參數(shù)，可以在下文每個接口的詳細(xì)介紹中查到相關(guān)的接口參數(shù)說明，例如查詢生產(chǎn)指令接口, 業(yè)務(wù)參數(shù)在biz_content字段：(3) 接口返回結(jié)果成功結(jié)果: "ant_merchant_expand_assetproduce_assign_query_response": "code": "10000", "msg": "Success", "asset_produce_items": "apply_order_id&

10、quot;: "AO232323232323232323", " assign_item_id ": "2017031620076002000006742800", "biz_tag": ""ch_tag01":"服務(wù)商-開戶"", "template_id": "234", "template_name": "A6個性碼套裝掛牌組", "create_date&qu

11、ot;: "2017-12-14 15:24:30", "count": "1", "apply_date": "2017-05-12 16:20:22", "receiver_name": "收貨人姓名", "receiver_mobile": "聯(lián)系人電話", "receiver_address": "收貨人地址", "province": "

12、浙江", "city": "杭州", "district": "西湖區(qū)", "postcode": "postcode", "supplier_pid": "208812312313"，"asset_resource": ""PERSONAL_QRCODE_URL":" , "has_next_page": true , "sign&qu

13、ot;: " CwMoJ6Nu.MWKg="失敗結(jié)果: "ant_merchant_expand_assetproduce_assign_query_response": "code": "40004", "msg": "Business Failed", "sub_code": "PAGE_SIZE_ILLEGAL", "sub_msg": "業(yè)務(wù)異常, 請求生產(chǎn)指令數(shù)量有誤" , "

14、sign": "CwMoJ6Nu.MWKg="接口調(diào)用失敗時，返回消息中一定存在code、msg、sub_code、sub_msg，其中sub_code和sub_msg表示業(yè)務(wù)定義的錯誤碼, 具體參考【1.3 錯誤碼】.接口返回各參數(shù)含義可參考FAQ5.1/5.23 詳細(xì)接口3.1 接口列表接口編號API名稱接口含義3.2ant.merchant.expand.assetproduce.assign.query獲取生產(chǎn)指令接口3.3ant.merchant.expand.assetproduce.assign.sync生產(chǎn)指令接收反饋接口3.4plete.sync

15、物料生產(chǎn)完成反饋接口3.5ant.merchant.expand.assetdelivery.assign.query獲取配送指令3.6ant.merchant.expand.assetdelivery.assign.sync配送指令接收反饋3.7plete.sync配送完成反饋3.8ant.merchant.expand.assetinfo.sync物料信息反饋接口3.2 生產(chǎn)指令獲取接口- API名稱：ant.merchant.expand.assetproduce.assign.query （獲取生產(chǎn)指令接口）- API應(yīng)用場景說明：獲取某個供應(yīng)商需要處理的生產(chǎn)指令, 包含所有物料的生產(chǎn)

16、指令（個性碼，空碼，基礎(chǔ)物料）.- 參數(shù)詳細(xì)說明:- 入?yún)ⅲ簠?shù)類型是否必填最大長度描述示例page_sizeNumber是10一次請求獲取數(shù)量 可選值為1,200100- 響應(yīng)參數(shù)參數(shù)類型是否必填最大長度描述示例has_next_pageBoolean是-是否有下一頁truecodeString是返回結(jié)果code10000msgString是返回接口描述Successasset_produce_itemsAssetProduceIte m是-生產(chǎn)指令集合-+ assign_item_idString是64訂單明細(xì)IDPI2017031620076002+ apply_order_idStri

17、ng是64申請單號AO201608012007600+ template_idString是64模板ID160+ template_nameString是256模板名稱，線下約定的物料名轉(zhuǎn)賬碼吊牌、窗貼-10*10貼紙-推薦使用支付寶+asset_resourceString是4000生產(chǎn)資料大字段, 用于提供物料供應(yīng)商生產(chǎn)所需資料.比如空碼地址: "QRCORE_FILE_URL": "x-0.txt": " "x-1.txt": " 取出對應(yīng)的txt地址值就好. 更多詳情見: 附錄6.2.+ countStri

18、ng是128數(shù)量1000+ apply_dateString是-申請日期, 格式:yyyy-MM-dd HH：mm:ss2017-04-12 19:12:57+ create_dateString是-訂單創(chuàng)建日期, 格式:yyyy-MM-dd HH：mm:ss2017-05-01 19:12:57+ provinceString是256省浙江省+ cityString是256city杭州市+ districtString是256區(qū)西湖區(qū)+ postcodeString否128收件人地址郵編;310000+ supplier_pidString是1024供應(yīng)商id.208830208328828

19、0+ data_versionString 是64數(shù)據(jù)版本, 目前來說只會是data_verion = 2. 1：舊模式，需要在生產(chǎn)完成后反饋運(yùn)單號 2：新模式：不需要在生產(chǎn)完成后反饋運(yùn)單號+ produce_orderString 是64生產(chǎn)單號PO2017101202096225+ memoString 否500備注業(yè)務(wù)方下達(dá)生產(chǎn)的備注.+ biz_tagString 是500業(yè)務(wù)渠道"ch_tag07":"紅包碼套裝-天貓銷售"- 錯誤碼業(yè)務(wù)錯誤碼錯誤描述解決方案PAGE_SIZE_ILLEGAL業(yè)務(wù)異常請求生產(chǎn)指令數(shù)量有誤設(shè)置正確的page_si

20、ze, 范圍為1, 200.PRODUCE_ORDER_QUERY_FAILED業(yè)務(wù)異常生產(chǎn)指令獲取異常需要聯(lián)系物料平臺排查具體原因.3.3 生產(chǎn)指令下達(dá)反饋接口- API名稱：ant.merchant.expand.assetproduce.assign.sync （生產(chǎn)指令接收反饋接口）- API應(yīng)用場景說明：當(dāng)調(diào)用方調(diào)用了生產(chǎn)指令下達(dá)接口后，并且供應(yīng)商系統(tǒng)處理成功后調(diào)用該接口，保證再次獲取生產(chǎn)指令接口時不會拉取到重復(fù)數(shù)據(jù)。- 參數(shù)詳細(xì)說明:- 入?yún)?shù)類型是否必填最大長度描述示例asset_resultsAssetResult 是-生產(chǎn)指令接收情況，最多200條-+ successBoo

21、lean是64接口處理結(jié)果true+ assign_item_idString是64訂單明細(xì)ID2017031620076002000006742800+ error_codeString否64錯誤碼error_code+ error_desc否否128error_desc錯誤描述- 響應(yīng)參數(shù)參數(shù)類型是否必填最大長度描述示例asset_resultsAssetResult是1000生產(chǎn)指令反饋結(jié)果-+ successBoolean是64接口處理結(jié)果true+ assign_item_idString是64訂單明細(xì)ID2017031620076002000006742800+ error_cod

22、eString否64錯誤碼HAS_NO_ASSIGN_ITEM+ error_descString否128error_desc供應(yīng)商名下無此分配記錄- 錯誤碼業(yè)務(wù)錯誤碼錯誤描述解決方案PAGE_SIZE_ILLEGAL業(yè)務(wù)異常請求生產(chǎn)指令數(shù)量有誤設(shè)置正確的page_size, 范圍為1, 200.HAS_NO_ASSIGN_ITEM供應(yīng)商名下無此分配記錄確認(rèn)訂單明細(xì)ID是否正確;如果確實(shí)無誤, 那么需要聯(lián)系物料平臺排查具體原因.注意:(1)接口返回結(jié)果code不是 ”10000” (比如”20000”, “40004) 時表示接口調(diào)用出現(xiàn)異常, 商家需要對所有訂單重新進(jìn)行反饋.(2) 接口返回

23、結(jié)果code是”10000”, 表示接口調(diào)用成功, 商家需要從接口返回的結(jié)果中判斷每個生產(chǎn)單是否更新成功, 取AssetResult中的success判斷該訂單是否處理成功, 商家需要對success為false的訂單重新反饋.3.4 生產(chǎn)訂單完成反饋接口- API名稱：plete.sync （物料生產(chǎn)完成反饋接口）- API應(yīng)用場景說明：當(dāng)生產(chǎn)的物料已經(jīng)完成時，調(diào)用該接口。- 參數(shù)詳細(xì)說明:- 入?yún)?shù)類型是否必須最大長度描述示例值asset_produce_detailsAssetProduceDetail 是-物料生產(chǎn)單完成后制定物流信息-+ assign_item_idString是6

24、4訂單明細(xì)ID2017031620076002000006742800(只能填寫一條)- 響應(yīng)參數(shù)參數(shù)類型是否必須最大長度描述示例值asset_resultsAssetResult是-物料訂單更新結(jié)果信息-+ successBoolean是64truetrue+ error_codeString否64errorCodeHAS_NO_ASSIGN_ITEM+ error_descString否64錯誤描述供應(yīng)商名下無此分配記錄+assign_item_idString是64訂單明細(xì)ID訂單明細(xì)ID- 錯誤碼業(yè)務(wù)錯誤碼錯誤描述解決方案HAS_NO_ASSIGN_ITEM供應(yīng)商名下無此分配記錄確認(rèn)訂

25、單明細(xì)ID是否正確;如果確實(shí)無誤, 那么需要聯(lián)系物料平臺排查具體原因.ASSET_PRODUCE_PROCESS_EXCEPTION配送反饋更新失敗異常先進(jìn)行重試, 如果仍然有問題, 需要聯(lián)系物料平臺排查具體原因.注意:(1)接口返回結(jié)果code不是 ”10000” (比如”20000”, “40004) 時表示接口調(diào)用出現(xiàn)異常, 商家需要對所有訂單重新進(jìn)行反饋.(2) 接口返回結(jié)果code是”10000”, 表示接口調(diào)用成功, 商家需要從接口返回的結(jié)果中判斷每個生產(chǎn)單是否更新成功, 取AssetResult中的success判斷該訂單是否處理成功, 商家需要對success為false的訂單

26、重新反饋.(3) 該接口暫不支持分批反饋, 比如一個生產(chǎn)指令生產(chǎn)完成之后, 調(diào)該接口一次性反饋. 3.5 獲取配送指令- API名稱：ant.merchant.expand.assetdelivery.assign.query （獲取配送指令接口）- API應(yīng)用場景說明：用于給物流服務(wù)商主動獲取物料配送訂單. Note: 獲取配送訂單之后, 需要調(diào)用”3.6 配送指令接收反饋” 接口進(jìn)行反饋.參數(shù)詳細(xì)說明:- 入?yún)ⅲ簠?shù)類型是否必填最大長度描述示例page_sizeNumber是10一次請求獲取數(shù)量 可選值為1,200100- 響應(yīng)參數(shù)參數(shù)類型是否必填最大長度描述示例has_next_page

27、Boolean是-是否有下一頁trueasset_delivery_itemsAssetDeliveryItem是-配送指令集合-+ assign_item_idString是64配送訂單唯一Id2017031620076002000006742800+ assign_out_order_idString是64配送流水號，可用于對賬支付寶內(nèi)部的配送流水號, 可供物料商和物流商用于對賬.+ apply_order_idString是64申請單號AO2018020512345678+ supplier_idString是64對應(yīng)供應(yīng)商id.對應(yīng)供應(yīng)商id, 比如生產(chǎn)商需要把貨物配送至物流商倉庫,

28、那么該id為對應(yīng)物流供應(yīng)商的id.+ supplier_nameString是64對應(yīng)供應(yīng)商名稱和supplier_id對應(yīng)+ gmt_assignString是-配送指令生成日期, 格式:yyyy-MM-dd HH：mm:ss2017-05-01 19:12:57+ item_idString是-物料id+ item_nameString是-物料名稱+ amountString是-配送數(shù)量+ from_addressAssetDeliveryAddress是-發(fā)送地址+ + provinceString是256省浙江省+ + cityString是256市杭州市+ districtStrin

29、g是256區(qū)西湖區(qū)+ + addressString 是256地址黃龍時代小郵局2樓+ + contact_nameString是64聯(lián)系人趙四+ + contact_phoneString是64聯(lián)系電 + zip_codeString否64郵編31000+ to_addressAssetDeliveryAddress是-接收地址+ + provinceString是256省浙江省+ + cityString是256市杭州市+ districtString是256區(qū)余杭區(qū)+ + addressString 是256地址青青花園302樓+ + contact_nameS

30、tring是64聯(lián)系人閑林baby+ + contact_phoneString是64聯(lián)系電 + zip_codeString否64郵編31000+ logistics_infoLogisticsInfo否-物流信息+ + logistics_noString是64物流單號400012131+ + logistics_nameString是64物流公司名稱順豐速運(yùn)+ + logistics_codeString是64物流公司codeSF+ memoString否256+ biz_tagString是500業(yè)務(wù)渠道"ch_tag07":"紅

31、包碼套裝-天貓銷售"+ print_dataString否5000菜鳥電子面單信息(僅供對接了菜鳥的供應(yīng)商)“encryptedData”:”AES:bQclwcq3VsNGgrVAW5dqQ1T0HpsJjLiRgbD+3Y5mwJsHb”,”signature”:”MD:t5.=”,”templateURL”:”http:/cloudprint.cainia “+ action_typeString否128SEND,RECEIVESEND - 發(fā)貨指令(執(zhí)行向目的地進(jìn)行發(fā)貨動作) , RECEIVE - 收貨指令(執(zhí)行從來源地進(jìn)行收貨動作)默認(rèn)值為 SEND. (如果為空, 也應(yīng)

32、該視為SEND, 發(fā)貨指令.)- 錯誤碼業(yè)務(wù)錯誤碼錯誤描述解決方案PAGE_SIZE_ILLEGAL業(yè)務(wù)異常,請求配送指令數(shù)量有誤設(shè)置正確的page_size, 范圍為1, 200.PRODUCE_ORDER_QUERY_FAILED業(yè)務(wù)異常,配送指令獲取異常需要聯(lián)系物料平臺排查具體原因.3.6 配送指令接收反饋- API名稱：ant.merchant.expand.assetdelivery.assign.sync （配送指令接收反饋接口）- API應(yīng)用場景說明：當(dāng)調(diào)用方調(diào)用了配送指令下達(dá)接口(3.5)后，并且供應(yīng)商系統(tǒng)處理成功后調(diào)用該接口，保證再次獲取配送指令接口時不會拉取到重復(fù)數(shù)據(jù)。-

33、參數(shù)詳細(xì)說明:- 入?yún)?shù)類型是否必填最大長度描述示例delivery_resultsAssetResult 是-配送指令接收情況，最多200條-+ successBoolean是64接口處理結(jié)果true+ assign_item_idString是64配送訂單明細(xì)ID2017031620076002000006742800+ error_codeString否64錯誤碼error_code+ error_descString否128error_desc錯誤描述- 響應(yīng)參數(shù)參數(shù)類型是否必填最大長度描述示例delivery_resultsAssetResult 是1000配送指令反饋結(jié)果-+ s

34、uccessBoolean是64接口處理結(jié)果true+ assign_item_idString是64訂單明細(xì)ID2017031620076002000006742800+ error_codeString否64錯誤碼HAS_NO_ASSIGN_ITEM+ error_descString否128error_desc供應(yīng)商名下無此分配記錄- 錯誤碼業(yè)務(wù)錯誤碼錯誤描述解決方案HAS_NO_ASSIGN_ITEM供應(yīng)商名下無此分配記錄確認(rèn)訂單明細(xì)ID是否正確;如果確實(shí)無誤, 那么需要聯(lián)系物料平臺排查具體原因.注意:(1)接口返回結(jié)果code不是 ”10000” (比如”20000”, “40004

35、) 時表示接口調(diào)用出現(xiàn)異常, 商家需要對所有訂單重新進(jìn)行反饋.(2) 接口返回結(jié)果code是”10000”, 表示接口調(diào)用成功, 商家需要從接口返回的結(jié)果中判斷每個生產(chǎn)單是否更新成功, 取DeliveryResult中的success判斷該訂單是否處理成功, 商家需要對success為false的訂單重新反饋.3.7 配送完成反饋- API名稱：plete.sync （物料配送完成反饋接口）- API應(yīng)用場景說明：當(dāng)物料配送已經(jīng)完成時，調(diào)用該接口?？沾a類型，需要回傳遞物流單號，物流公司信息。- 參數(shù)詳細(xì)說明:- 入?yún)?shù)類型是否必須最大長度描述示例值asset_delivery_details

36、AssetDeliveryDetail 是-物料配送單完成后指定物流信息-+ assign_item_idString是64訂單明細(xì)ID2017031620076002000006742800+ amountInteger是128配送量+ logistics_infosLogisticsInfo否-物流信息可以為多個物流單，若配送給用戶則需要必須傳+ + logistics_noString否64物流單號400012131+ + logistics_nameString否64物流公司名稱順豐速運(yùn)（見附錄6.3）+ + logistics_codeString否64物流公司codeSF（見附錄6

37、.3）- 響應(yīng)參數(shù)參數(shù)類型是否必須最大長度描述示例值delivery_resultsAssetResult是-物料訂單更新結(jié)果信息-+ successBoolean是64truetrue+ error_codeString否64errorCodeHAS_NO_ASSIGN_ITEM+ error_descString否64錯誤描述供應(yīng)商名下無此分配記錄+assign_item_idString是64訂單明細(xì)ID訂單明細(xì)ID- 錯誤碼業(yè)務(wù)錯誤碼錯誤描述解決方案HAS_NO_ASSIGN_ITEM供應(yīng)商名下無此分配記錄確認(rèn)訂單明細(xì)ID是否正確;如果確實(shí)無誤, 那么需要聯(lián)系物料平臺排查具體原因.AS

38、SET_DELIVERY_PROCESS_EXCEPTION配送反饋更新失敗異常先進(jìn)行重試, 如果仍然有問題, 需要聯(lián)系物料平臺排查具體原因.注意:(1)接口返回結(jié)果code不是 ”10000” (比如”20000”, “40004) 時表示接口調(diào)用出現(xiàn)異常, 商家需要對所有訂單重新進(jìn)行反饋.(2) 接口返回結(jié)果code是”10000”, 表示接口調(diào)用成功, 商家需要從接口返回的結(jié)果中判斷每個生產(chǎn)單是否更新成功, 取AssetResult中的success判斷該訂單是否處理成功, 商家需要對success為false的訂單重新反饋.(3) 該接口暫不支持分批反饋, 在一個配送指令完成之后, 調(diào)

39、該接口一次性反饋(供應(yīng)商可自行分批發(fā)貨, 分多個包裹, 然后把所有物流單號反饋上來. 數(shù)量不要超過35個. ). 3.8 物料信息反饋接口- API名稱：ant.merchant.expand.assetinfo.sync （物料信息反饋接口）- API應(yīng)用場景說明：該接口用于向物料平臺同步生產(chǎn)或配送完成的物料信息, 包括但不限于序列號, mac地址等.- 參數(shù)詳細(xì)說明:- 入?yún)?shù)類型是否必須最大長度描述示例值asset_infosAssetInfoItem 是-傳入需要反饋的物料信息對象列表.-+ assign_item_idString是64訂單明細(xì)IDDI201703162007600

40、2, PI2018020412324552+ typeString是64PRODUCE或者DELIVERY生產(chǎn)資料或配送資料+ sub_typeString是128具體物料信息類型, 定義見附錄6.4.MC_SN_NOS - 機(jī)具序列號.+ valueString是3000物料信息,長度限制為3000, 格式按照附錄6.4約定.機(jī)具序列號:"SN12312312312321", "SN99988889FE898"- 響應(yīng)參數(shù)參數(shù)類型是否必須最大長度描述示例值info_resultsAssetResult是-物料訂單更新結(jié)果信息-+ successBool

41、ean是64truetrue+ error_codeString否64errorCodeHAS_NO_ASSIGN_ITEM+ error_descString否64錯誤描述供應(yīng)商名下無此分配記錄+assign_item_idString是64訂單明細(xì)IDDI2017031620076002, PI2018020412324552- 錯誤碼業(yè)務(wù)錯誤碼錯誤描述解決方案HAS_NO_ASSIGN_ITEM供應(yīng)商名下無此分配記錄確認(rèn)訂單明細(xì)ID是否正確;如果確實(shí)無誤, 那么需要聯(lián)系物料平臺排查具體原因.INFO_SYNC_INVALID_COUNT物料信息反饋數(shù)量非法或者超過指令數(shù)量.反饋不超過指令

42、中生產(chǎn)或配送數(shù)量的物料信息.INFO_SYNC_DUP_VALUE物料信息重復(fù)反饋.已經(jīng)反饋過該物料信息, 修改重復(fù)反饋的信息, 然后重試.INFO_LENGTH_INVALID物料信息長度不合法, 為空或者長度超過3000.如果是反饋信息長度超過3000 , 需要進(jìn)行分批反饋?zhàn)⒁?(1)接口返回結(jié)果code不是 ”10000” (比如”20000”, “40004) 時表示接口調(diào)用出現(xiàn)異常, 商家需要對所有訂單重新進(jìn)行反饋.(2) 接口返回結(jié)果code是”10000”, 表示接口調(diào)用成功, 商家需要從接口返回的結(jié)果中判斷每個生產(chǎn)單是否更新成功, 取AssetResult中的success判斷

43、該訂單是否處理成功, 商家需要對success為false的訂單重新反饋.(3) 物料信息反饋接口可以支持多次反饋, 如果該指令需要上傳的物料信息長度超過3000, 需要進(jìn)行分配次反饋. 多次反饋的數(shù)量總數(shù)不能超過指令中生產(chǎn)或配送數(shù)量.(4) 物料信息反饋入?yún)⒄f明.type 是DELIVERY還是PRODUCE需要供應(yīng)商和業(yè)務(wù)確認(rèn)生產(chǎn)配送流程之后確定.sub_type 具體物料信息類型, 這個也是業(yè)務(wù)確定之后, 字段各方進(jìn)行約定, 具體值參見6.4.4 資源下載- SDK下載：（SDK中封裝了簽名，鏈接的邏輯，僅需要提供數(shù)據(jù)即可，強(qiáng)烈推薦使用）支付寶提供的版本有: java(jdk1.5)版,

44、 java(jdk1.4)版, .net(2010)版, .net(2005)版, php版.- 秘鑰生成：如果無法訪問下載, 聯(lián)系物料平臺開發(fā).5 FAQ5.1 openapi接口返回參數(shù)怎么理解?(1) 接口返回成功:比如下圖是api:ant_merchant_expand_assetproduce_assign_query_response的返回結(jié)果, code為”10000”, msg為”Success”, 其余的(asset_produce_items, has_next_page)是業(yè)務(wù)返回. 外層的sign值給商戶進(jìn)行驗(yàn)簽, 商家可用”支付寶公鑰”進(jìn)行驗(yàn)簽, 確定是來自支付寶的返

45、回.(2) 接口返回失敗:看下面兩個失敗的場景:上圖是由于業(yè)務(wù)系統(tǒng)繁忙, openapi調(diào)用失敗, 商家可以進(jìn)行重試, 長時間不可用可聯(lián)系我們.上圖是sub_code為”PAGE_SIZE_ILLEGAL”, 可以在本文檔1.3看到, 這是由我們業(yè)務(wù)系統(tǒng)返回的錯誤碼, 因?yàn)槲覀儤I(yè)務(wù)系統(tǒng)做了限制, 每次只能最多請求200個, 不滿足就報(bào)這個異常.5.2 openapi接口參數(shù)規(guī)范(1) 成功返回規(guī)范碼code（返回碼枚舉值）：統(tǒng)一為10000msg （返回碼類型）：統(tǒng)一為Successsub_code（子錯誤碼）：統(tǒng)一為空sub_msg（錯誤描述）：統(tǒng)一為空(2) 業(yè)務(wù)失敗返回規(guī)范碼code（返回碼枚舉值）：統(tǒng)一為40004msg（返回碼類型）：對于業(yè)務(wù)系統(tǒng)統(tǒng)一為Business F