33浙江省市場監(jiān)督管理局發(fā)布I II II請注意本標準的某些內(nèi)容可能涉及專利。本標準的發(fā)布機構(gòu)不承擔識別專利的責任。本標準主要起草人：潘思蔚、沈超、丁玲玲、樓建華、1跨境電商零售出口退貨監(jiān)管服務平臺接口規(guī)范本標準適用于跨境電商零售出口退貨監(jiān)管服務平臺接口的設計、開發(fā)4縮略語IP：網(wǎng)絡協(xié)議（InternetProtocol）5.1跨境電商零售出口退貨監(jiān)管服務平臺與電商企業(yè)、物流企業(yè)、場站公司之間的接口分類主要分為2表1接口功能描述表接口說明退貨訂單申報接口商企業(yè)之間的接口接收電商企業(yè)申報的退貨訂單信息退貨物流單申報接口流企業(yè)之間的接口接收物流企業(yè)申報的退貨物流信息退貨理貨明細申報接口站公司之間的接口接收場站理貨申報的退貨理貨明細信息物流妥投信息申報接口流企業(yè)之間的接口息發(fā)送至跨境電商零售出口退貨監(jiān)管服務平臺總署退單信息申報接口商企業(yè)、物流企業(yè)、場站公司之間的接口企業(yè)回執(zhí)發(fā)送接口商企業(yè)、物流企業(yè)、場站公司之間的接口5.2跨境電商零售出口退貨監(jiān)管服務平臺與電商企業(yè)、物流企業(yè)、場站公司之間主體之間的數(shù)據(jù)交互需求見圖1。其中“海關總署跨境電商統(tǒng)一版系統(tǒng)”是海關總署面向跨境電子商務相關企業(yè)進行通關數(shù)據(jù)申報的統(tǒng)一平臺。據(jù)申報的統(tǒng)一平臺。電商企業(yè)系統(tǒng)物流企業(yè)系統(tǒng)場站系統(tǒng)-3、包裹運抵—→-5、申報理貨明細信息——海關總署跨境電商統(tǒng)一版系統(tǒng)跨境電商零售出口退貨監(jiān)管平臺圖1數(shù)據(jù)交互需求圖3接收進出口收發(fā)貨人企業(yè)申報的退貨訂單信息，通過跨境電商零售出口退/1.接收解析報文后，通過電商企業(yè)編號、訂單號為業(yè)務主鍵，校驗訂單是否存在（校驗接口），2.訂單存在，則根據(jù)表格字段說明判斷必填項、判斷幣值、數(shù)值、計量單位，國別等字段的3.查詢到原訂單后記錄原訂單的運單號、出口物流企業(yè)編號，作為關聯(lián)出口物流單，理貨明4.符合校驗條件則入庫，默認訂單狀態(tài)“申報中”，妥投狀態(tài)默認“未妥投”無法入庫給出5.退貨訂單不存在或者狀態(tài)為申報中，或者退單狀態(tài)下可以再次申報覆蓋。否則提示“運單/[可選][可選]NYYYNYNYNYYYYYYYYY4NYNYNY其他）]NYYYYYYYYYYYYYYYYYYYYYYYYYYYYYNN接收物流企業(yè)申報的退貨物流信息，通過跨境電商零售出口退貨監(jiān)管5/1.接收解析報文后，通過物流企業(yè)編號、出口運單號為業(yè)務主鍵，校驗訂單是否存在（校驗接口由通關服務平臺提供先不校驗，通過三單比對環(huán)節(jié)校驗）。2.根據(jù)表格說明判斷必3.符合校驗條件則入庫，無法入庫給出具體錯誤文字提示。具體字段填寫錯誤、原出口訂單4.退貨訂單不存在或者狀態(tài)為申報中，或者退單狀態(tài)下可以再次申報覆蓋。否則提示“運單/[可選][可選]6.2.2退貨物流單接口報文應包含的業(yè)務字段見表6。YYYYYYYYYYYYYYNYNYNYNYNYNNNNNNNYNYNYNYNYNY6NYNYNYNYNYNYNYNNNY入//2.根據(jù)退貨物流企業(yè)編號、退貨物流單號查找對應訂單，若對應訂單已經(jīng)不是退單或者待4.若訂單不存在，則只入庫理貨明細（理論數(shù)據(jù)沒有，實物到達）。//[可選][可選]NY7NYNYNYNYNYNYNYNYNYNYNY：（NNYYYYYYYYYYYY物流企業(yè)將退貨商品妥投至商家后，將妥投信息發(fā)送至跨境電商零售出口/1.接收解析報文后，通過出口物流企業(yè)編號、出口運單號為業(yè)務主鍵，校驗退貨訂單是否存在，不存在則退單，提示“出口退貨訂單不存在”2.退貨訂單存在，則根據(jù)表格字段說明判斷必填項。符合則入庫3.查詢到原退貨訂單后，若是妥投信息更新退貨訂單8/[可選][可選]/貨物查驗扣貨的原因及銷毀，或者放行后妥投至商家的狀態(tài)，或退運貨物被海關總署退單/2.退貨訂單存在，則根據(jù)表格字段說明判斷必填項，符合/[可選][可選]在企業(yè)申報數(shù)據(jù)處理后，或者系統(tǒng)自動審單產(chǎn)///9/[可選][可選]/7.3應制定相應的安全措施和保密機制，保障用戶注冊信息以7.4應通過身份鑒別、訪問授權、防火墻、網(wǎng)絡行為審計、入侵防御、漏洞掃描、計算機病毒防治、A.1跨境退貨業(yè)務申報接口A.1.1接口調(diào)用地址A.1.1.1測試環(huán)境：:8553/gateway/receive。A.1.1.2生產(chǎn)環(huán)境：/gateway/receive。A.1.2接口調(diào)用方式A.1.3接口參數(shù)說明18Y28Y3bizIdY4Y5/Y6signY填7YA.1.4接口返回說明01bizId不能為空請求報文為空或nullservice服務異常A.1.5接口編碼格式A.1.6接口編碼密鑰A.1.7接口調(diào)用示例publicstaticvoidmain(String[]args){Clientclient=newSSLClient(":8553/gateway/receive");//接口調(diào)用地址//生成請求簽名StringappId="RYT00001";//應用唯一標識StringbizCode="DEV21300";//業(yè)務代碼StringbizId="311af125-6fed-4603-8c5d-49b1fa4b4b9b";//業(yè)務ID//業(yè)務報文內(nèi)容Stringcontent="";//業(yè)務報文內(nèi)容Stringtimestamp=String.valueOf(System.currentTimeMillis());//時間戳StringappKey="abcdefghij1234567890abcdefghij1234567890";//應用密鑰Stringsign=client.getSign(bizCode,bizId,content,timestamp,appKey)//數(shù)字簽名//封裝請求參數(shù)Map<String,String>parameters=newHashMap<String,String>();parameters.put("appId",appId);parameters.put("bizCode",bizCode);parameters.put("bizId",bizId);parameters.put("content",content);parameters.put("timestamp",timestamp);parameters.put("sign",sign);parameters.put("companyCode","1105910159");parameters.put("cusSign","1");Stringresult=client.post(parameters);//接口調(diào)用System.out.println(result);//打印返回結(jié)果}A.1.8接口調(diào)試工具:8553/gateway/test/inputcebA.1.9接口地址限制A.1.9.1接入系統(tǒng)對客戶端IP有限制，上生產(chǎn)環(huán)境時應提供客戶端公網(wǎng)IP。A.1.9.2如后續(xù)客戶端IP變更，應及時聯(lián)系平臺客服人A.1.10接口調(diào)用常見問題問題：使用zjportGatewayClient.jar按照示例代碼調(diào)用，出現(xiàn)以下錯誤：.ssl.SSLHandshakeException:Receivedfatalalert:handshake_failureA.1.10.2簽名錯誤a)若密鑰與應用不匹配，使用相應的密鑰即可。A.2跨境退貨業(yè)務回執(zhí)接口A.2.1功能說明A.2.1.2同步回執(zhí)應在企業(yè)調(diào)用1.1接口后實時返回；異步回執(zhí)應由跨境電A.2.1.3對接企業(yè)應提供跨境電商零售出口退貨監(jiān)管服務平臺回執(zhí)接收接口地址，用以接收所有回執(zhí)密加簽，企業(yè)接收時應解密驗簽。具體參照以下規(guī)A.2.2業(yè)務參數(shù)說明A.2.3跨境電商零售出口退貨監(jiān)管服務平臺同步、異步回執(zhí)報文結(jié)構(gòu)格式A.2.4報文加密與解密A.2.4.1開發(fā)參考頁面說明A.基本參數(shù)NYYA.接口處理正常返回樣例A.接口處理異常返回樣例A.2.4.2安全性保證說明A.防抵賴：接收方收到的消息簽名由發(fā)送方的私鑰運算生成，其他人無法生成對應信息，應A.身份認證：接收方能解密信息，發(fā)送方默認接收方具備身份合法的性質(zhì)。A.2.4.3通訊協(xié)議與報文格式A.通信雙方采用httppost方法作為通訊協(xié)議。請求頭必須添加：A.2.4.4其它說明A.為保證高度安全性，A.私鑰的安全保管，應成為通信安全的核心保障。(規(guī)范性)退貨訂單申報報文結(jié)構(gòu)按圖B.1執(zhí)行。中文名稱說明Y報文的36位系統(tǒng)唯一序號(英文字母大寫)Y報文版本號，默認為1.0表B.2退貨訂單業(yè)務節(jié)點描述中文名稱說明系統(tǒng)唯一序號Y企業(yè)系統(tǒng)生成36位唯一序號(英文字母大寫)Y報送時間Y企業(yè)報送時間，格式：YYYYMMDDhhmmssY企業(yè)報送狀態(tài)，默認填寫2申報地海關代碼YbillNoC..37YC..60YC..100YC..50YC..100YC..18YlogisticsCodeC..18YC..100YlogisticsNoC..80YY退貨商品毛重-單位為千克C..2YC..2Y他InvtRefundListYC..250YC..10YC..250YYunitYYunit1YYunit2YYpriceYYtotalPriceYglinkC..500N基礎報文傳輸實體節(jié)點按表B.3執(zhí)行。中文名稱說明Y報文傳輸?shù)钠髽I(yè)代碼(需與接入客戶端的企業(yè)身份一致)YY默認為DXP,指中國電子口岸數(shù)據(jù)交換平臺Y注：Y表示“是”、N表示“否”。退貨訂單回執(zhí)報文結(jié)構(gòu)按圖B.2執(zhí)行。中文名稱說明Y報文的36位系統(tǒng)唯一序號(英文字母大寫)Y注：Y表示“是”、N表示“否”。中文名稱說明系統(tǒng)唯一序號Y系統(tǒng)生成36位唯一序號(英文字母大寫)電商平臺編碼Y電商平臺的海關注冊登記編號或統(tǒng)一社會信用代電商企業(yè)編號Y收發(fā)貨人(電商企業(yè))的海關注冊登記編號或統(tǒng)一訂單編號Y臺的訂單編號應唯一回執(zhí)狀態(tài)Y操作結(jié)果(120-待審核/399-審核通/699-銷毀/700-退運/-800放行)示處理異?；貓?zhí)回執(zhí)時間Y操作時間(格式：YYYYMMDDhhmmssSSS)回執(zhí)信息Y備注(如：退單原因)注：Y表示“是”、N表示“否”。退貨理貨明細報文結(jié)構(gòu)按圖B.3執(zhí)行。中文名稱說明Y報文的36位系統(tǒng)唯一序號(英文字母大寫)Y注：Y表示“是”、N表示“否”。退貨理貨明細業(yè)務節(jié)點描述按表B.7執(zhí)行。YYYYYrefundBillNoC..37YC..100YC..10YC..18YC..100YC..37YC..18YC..100YlogisticsCodeC..18YC..100YlogisticsNoC..80YYtallyStatusYtallyInfoNC..100NInvtRefundDetailOrdIntYC..250YC..10YC..250YYunitY基礎報文傳輸實體節(jié)點按表B.8執(zhí)行。中文名稱說明Y(需要與接入客戶端的企業(yè)身份一致)YY默認為DXP,指中國電子口岸數(shù)據(jù)交換平臺Y向中國電子口岸數(shù)據(jù)中心申請數(shù)據(jù)交換平臺的用戶編號注：Y表示“是”、N表示“否”。退貨理貨明細回執(zhí)報文結(jié)構(gòu)按圖B.4執(zhí)行。中文名稱說明Y報文的36位系統(tǒng)唯一序號(英文字母大寫)Y注：Y表示“是”、N表示“否”。B.4.3退貨理貨明細回執(zhí)報文描述中文名稱說明系統(tǒng)唯一序號Y系統(tǒng)生成36位唯一序號(英文字母大寫)YY回執(zhí)狀態(tài)Y回執(zhí)時間Y操作時間(格式：yyyyMMddHHmmssfff)回執(zhí)信息Y備注(如：入庫失敗原因)注：Y表示“是”、N表示“否”。B.5.1退貨物流單報文結(jié)構(gòu)中文名稱說明Y報文的36位系統(tǒng)唯一序號(英文字母大寫)Y注：Y表示“是”、N表示“否”。YYYYdeclLogisticsNoC..80YC..100YC..18Y碼YYYYtradeCityC..128YYtyC..128YYC..3YationC..256NNC..3N貨屬于實際觸達消費者退貨logisticsNoC..80YY/C..100Y體logisticsCodeC..18YC..256YeYbillNoC..37YYYC..100Y/YYYYlogisticsQueryUrlC...128N址C..18YC..100YYC..30Y表B.14DEN506Message節(jié)點的屬性說明Y報文的36位系統(tǒng)唯一序號(英文字母大寫)Y注：Y表示“是”、N表示“否”。退貨物流單回執(zhí)報文描述按表B.15執(zhí)行。中文名稱說明系統(tǒng)唯一序號y系統(tǒng)生成36位唯一序號(英文字母大寫)Y溯源退貨物流企業(yè)在海關的備案編碼。Y回執(zhí)狀態(tài)Y回執(zhí)時間Y操作時間(格式：yyyyMMddHHmmssfff)回執(zhí)信息Y備注(如：失敗原因)注：Y表示“是”、N表示“否”。圖B.7物流妥投、總署退單報文結(jié)構(gòu)圖B.7.2物流妥投、總署退單根節(jié)點執(zhí)行。表B.16DEN507Message節(jié)點的屬性說明Y報文的36位系統(tǒng)唯一序號(英文字母大寫)Y注：Y表示“是”、N表示“否”。B.7.3物流妥投、總署退單業(yè)務節(jié)點描述物流妥投、總署退單業(yè)務節(jié)點描述按表B.17執(zhí)行。表B.17物流妥投、總署退單業(yè)務節(jié)點描述中文名稱說明系統(tǒng)唯一序號Y企業(yè)系統(tǒng)生成36位唯一序號(英文字母大寫)Y企業(yè)報送類型1-新增；2-變更；3-刪除報送時間Y企業(yè)報送時間，格式：YYYYMMDDhhmmssY企業(yè)報送狀態(tài)，默認填寫2申報地海關代碼YlogisticsNoC..80YC..100YlogisticsCodeC..18YYNC..100NarrivalTimeNNC..500NNC..18YC..100YYC..30YB.8物流妥投、總署退單回執(zhí)報文【D圖B.8物流妥投、總署退單報文結(jié)構(gòu)