DB33∕T 1383-2024 跨境電商零售出口退貨監(jiān)管服務(wù)平臺接口規(guī)范

33浙江省市場監(jiān)督管理局發(fā)布I 3 9 本標(biāo)準(zhǔn)按照GB/T1.1—2020《標(biāo)準(zhǔn)化工作導(dǎo)則第1部分：標(biāo)準(zhǔn)化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定本標(biāo)準(zhǔn)主要起草人：潘思蔚、沈超、丁玲玲、樓建華、1跨境電商零售出口退貨監(jiān)管服務(wù)平臺接口規(guī)范本標(biāo)準(zhǔn)適用于跨境電商零售出口退貨監(jiān)管服務(wù)平臺接口的設(shè)計(jì)、開發(fā)GB/T22239—2019信息安全技術(shù)網(wǎng)絡(luò)安全等級保護(hù)基本要求GB/T37988信息安全技術(shù)數(shù)據(jù)安全能力成熟度模型GB/T35408界定的術(shù)語和定義適用于本4縮略語AES：高級加密標(biāo)準(zhǔn)（AdvancedEncrGBK：漢字內(nèi)碼擴(kuò)展規(guī)范（ChineseInternalCGUID：全局唯一標(biāo)識符（GloballyUniqueIdentRSA：非對稱加密算法（AsymmetriccrySSL：安全套接層協(xié)議（SecureSocketUTF：Unicode轉(zhuǎn)換格式（UnicodeTranURL：統(tǒng)一資源定位符（UniformResourceLocator）5.1跨境電商零售出口退貨監(jiān)管服務(wù)平臺與電商企業(yè)、物流企業(yè)、場站公司之間的接口分類主要分為2接口說明退貨訂單申報(bào)接口商企業(yè)之間的接口退貨物流單申報(bào)接口流企業(yè)之間的接口退貨理貨明細(xì)申報(bào)接口站公司之間的接口物流妥投信息申報(bào)接口流企業(yè)之間的接口息發(fā)送至跨境電商零售出口退貨監(jiān)管服務(wù)平臺總署退單信息申報(bào)接口商企業(yè)、物流企業(yè)、場站公司之間的接口企業(yè)回執(zhí)發(fā)送接口商企業(yè)、物流企業(yè)、場站公司之間的接口電商企業(yè)系統(tǒng)電商企業(yè)系統(tǒng)物流企業(yè)系統(tǒng)場站系統(tǒng)海關(guān)總署跨境電商統(tǒng)一版系統(tǒng)跨境電商零售出口退貨監(jiān)管平臺3接收進(jìn)出口收發(fā)貨人企業(yè)申報(bào)的退貨訂單信息，通過跨境電商零售出口退/1.接收解析報(bào)文后，通過電商企業(yè)編號、），2.訂單存在，則根據(jù)表格字段說明判斷必填項(xiàng)、判斷幣值、數(shù)值、3.查詢到原訂單后記錄原訂單的運(yùn)單號、出口物流企業(yè)編號，作4.符合校驗(yàn)條件則入庫，默認(rèn)訂單狀態(tài)“申報(bào)中”，妥投狀態(tài)默認(rèn)“未妥5.退貨訂單不存在或者狀態(tài)為申報(bào)中，或者退單狀態(tài)下可以再次/NYYYNYNYNYYYYYYYYY4NYNYNY其他）]NYYYYYYYYYYYYYYYYYYYYYYYYYYYYYNN接收物流企業(yè)申報(bào)的退貨物流信息，通過跨境電商零售出口退貨監(jiān)管5/1.接收解析報(bào)文后，通過物流企業(yè)編號、出口運(yùn)單號為業(yè)務(wù)主鍵，校驗(yàn)訂單是否存在（校驗(yàn)接口由通關(guān)服務(wù)平臺提供先不校驗(yàn)，通過三單比對環(huán)節(jié)校驗(yàn)）。2.根據(jù)表格說明判斷必3.符合校驗(yàn)條件則入庫，無法入庫給出具體錯誤文字提示。具體字段填寫錯誤、原出口訂單4.退貨訂單不存在或者狀態(tài)為申報(bào)中，或者退單狀態(tài)下可以再次申報(bào)覆蓋。否則提示“運(yùn)單/YYYYYYYYYYYYYYNYNYNYNYNYNNNNNNNYNYNYNYNYNY6NYNYNYNYNYNYNYNNNY入////NY7NYNYNYNYNYNYNYNYNYNYNY：（NNYYYYYYYYYYYY物流企業(yè)將退貨商品妥投至商家后，將妥投信息發(fā)送至跨境電商零售出口/1.接收解析報(bào)文后，通過出口物流企業(yè)編在，不存在則退單，提示“出口退貨訂單不存在”8//貨物查驗(yàn)扣貨的原因及銷毀，或者放行后妥投至商家的狀態(tài)，或退運(yùn)貨物被海關(guān)總署退單//在企業(yè)申報(bào)數(shù)據(jù)處理后，或者系統(tǒng)自動審單產(chǎn)///9//7.1接口安全應(yīng)符合GB/T22239—2019第二級安全要求規(guī)定，數(shù)據(jù)安全應(yīng)符合GB/T377.3應(yīng)制定相應(yīng)的安全措施和保密機(jī)制，保障用戶注冊信息以7.4應(yīng)通過身份鑒別、訪問授權(quán)、防火墻、網(wǎng)絡(luò)行為審計(jì)、入侵防御、漏洞掃描、計(jì)算機(jī)病毒防治、A.1跨境退貨業(yè)務(wù)申報(bào)接口A.1.1接口調(diào)用地址A.1.1.1測試環(huán)境：:8553/gateway/receivA.1.1.2生產(chǎn)環(huán)境：/gateway/receive。A.1.2接口調(diào)用方式A.1.3接口參數(shù)說明18Y28Y3Y4Y5/Y6Y×tamp=請求時(shí)間戳&appKey=接口填7YA.1.4接口返回說明01A.1.5接口編碼格式A.1.6接口編碼密鑰A.1.6.1應(yīng)由跨境電商零售出口退貨監(jiān)管服務(wù)平臺統(tǒng)一頒發(fā)應(yīng)用密鑰（appKey）用于接口簽名，接入A.1.6.2測試環(huán)境appKey："abcdefghij1234567890abcdefghij12A.1.7接口調(diào)用示例publicstaticvoidmain(String[]args){Clientclient=newSSLClient(":8553/gateway/receive");//接口調(diào)用地址//生成請求簽名StringappId="RYT00001";//應(yīng)用唯一標(biāo)識StringbizCode="DEV21300";//業(yè)務(wù)代碼StringbizId="311af125-6fed-4603-8c5d-49b1fa4b4b9b";//業(yè)務(wù)ID//業(yè)務(wù)報(bào)文內(nèi)容Stringcontent="";//業(yè)務(wù)報(bào)文內(nèi)容Stringtimestamp=String.valueOf(System.currentTimeMillis());//時(shí)間戳StringappKey="abcdefghij1234567890abcdefghij1234567890";//應(yīng)用密鑰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/inputA.1.9接口地址限制A.1.10接口調(diào)用常見問題.ssl.SSLHandshakeException:Receivedfatalalert:A.1.10.2簽名錯誤A.2跨境退貨業(yè)務(wù)回執(zhí)接口A.2.1功能說明A.2.1.3對接企業(yè)應(yīng)提供跨境電商零售出口退貨監(jiān)管服務(wù)平臺回執(zhí)接收接口地址，用以接收所有回執(zhí)數(shù)據(jù)。數(shù)據(jù)接收回執(zhí)接口采用httppost方式，跨境電商零售出口退貨監(jiān)管服務(wù)平臺會對發(fā)送內(nèi)容加密加簽，企業(yè)接收時(shí)應(yīng)解密驗(yàn)簽。具體參照以下規(guī)例如：/gateway/pac_message_receimsg_type=XXXA.2.2業(yè)務(wù)參數(shù)說明請求報(bào)文內(nèi)容，跨境電商零售出口退貨監(jiān)管CUSTOMS_DEN_CALLBACK請求簽名，參考測試頁面說明，跨境電商零售出A.2.3跨境電商零售出口退貨監(jiān)管服務(wù)平臺同步、異步回執(zhí)報(bào)文結(jié)構(gòu)格式A.2.4報(bào)文加密與解密A.2.4.1開發(fā)參考頁面說明/newyorkOutside/test/datasend.jspb接口返回?cái)?shù)據(jù)格式應(yīng)滿足如下要A.基本參數(shù)NYYA.接口處理正常返回樣例A.接口處理異常返回樣例A.2.4.2安全性保證說明A.機(jī)密性：通訊報(bào)文應(yīng)采用AES算法加密，加密的信息僅接收方可解A.防抵賴：接收方收到的消息簽名由發(fā)送方的私鑰運(yùn)算生成，其他人無法生成對應(yīng)信息，應(yīng)A.身份認(rèn)證：接收方能解密信息，發(fā)送方默認(rèn)接收方具備身份合法的性質(zhì)。A.2.4.3通訊協(xié)議與報(bào)文格式"Content-type","application/x-www-form-urlencodeA.2.4.4其它說明A.為保證高度安全性，A.私鑰的安全保管，應(yīng)成為通信安全的核心保障。中文名稱說明Y報(bào)文的36位系統(tǒng)唯一序號(英文字母大寫)Y注：Y表示“是”、N表示“否”。中文名稱說明系統(tǒng)唯一序號Y企業(yè)系統(tǒng)生成36位唯一序號(英文字母大寫)Y報(bào)送時(shí)間Y企業(yè)報(bào)送時(shí)間，格式：YYYYMMDDhhmmssY企業(yè)報(bào)送狀態(tài)，默認(rèn)填寫2申報(bào)地海關(guān)代碼YYYYYYYYYYN19,5YY退貨類型：0-未觸達(dá)消費(fèi)者退貨；1-實(shí)Y01-派送失??；02-清關(guān)失敗；03-消費(fèi)者退貨；他YYYYN19,5YYN19,5YYN19,5YYYN19,5YYN19,5YN中文名稱說明Y報(bào)文傳輸?shù)钠髽I(yè)代碼(需與接入客戶端的企業(yè)身份一致)YY默認(rèn)為DXP,指中國電子口岸數(shù)據(jù)交換平臺Y注：Y表示“是”、N表示“否”。中文名稱說明Y報(bào)文的36位系統(tǒng)唯一序號(英文字母大寫)Y中文名稱說明系統(tǒng)唯一序號Y系統(tǒng)生成36位唯一序號(英文字母大寫)電商平臺編碼Y電商平臺的海關(guān)注冊登記編號或統(tǒng)一社會信用代電商企業(yè)編號Y訂單編號Y臺的訂單編號應(yīng)唯一回執(zhí)狀態(tài)Y操作結(jié)果(120-待審核/399-審核通/699-銷毀/700-退運(yùn)/-800放行)示處理異?；貓?zhí)回執(zhí)時(shí)間Y操作時(shí)間(格式：YYYYMMDDhhmmssSSS)回執(zhí)信息Y備注(如：退單原因)中文名稱說明Y報(bào)文的36位系統(tǒng)唯一序號(英文字母大寫)Y注：Y表示“是”、N表示“否”。YYYYYYYYYYYYYYYYN19,5YYNNYYYYN19,5YY中文名稱說明Y(需要與接入客戶端的企業(yè)身份一致)YY默認(rèn)為DXP,指中國電子口岸數(shù)據(jù)交換平臺Y向中國電子口岸數(shù)據(jù)中心申請數(shù)據(jù)交換平臺的用戶編號注：Y表示“是”、N表示“否”。中文名稱說明Y報(bào)文的36位系統(tǒng)唯一序號(英文字母大寫)Y中文名稱說明系統(tǒng)唯一序號Y系統(tǒng)生成36位唯一序號(英文字母大寫)YY回執(zhí)狀態(tài)Y回執(zhí)時(shí)間Y操作時(shí)間(格式：yyyyMMddHHmmssfff)回執(zhí)信息Y備注(如：入庫失敗原因)中文名稱說明Y報(bào)文的36位系統(tǒng)唯一序號(英文字母大寫)Y注：Y表示“是”、N表示“否”。YYYYYYY碼YYYYYYYYYNNN貨屬于實(shí)際觸達(dá)消費(fèi)者退貨YN19,5Y/Y體YYeYYYYY/YYYYN址YYYY說明Y報(bào)文的36位系統(tǒng)唯一序號(英文字母大寫)Y中文名稱說明系統(tǒng)唯一序號Y系統(tǒng)生成36位唯一序號(英文字母大寫)Y溯源退貨物流企業(yè)在海關(guān)的備案編碼。Y回執(zhí)狀態(tài)Y回執(zhí)時(shí)間Y操作時(shí)間(格式：yyyyMMddHHmmssfff)回執(zhí)信息Y備注(如：失敗原因)說明Y報(bào)文的36位系統(tǒng)唯一序號(英文字母大寫)Y注：Y表示“是”、N表示“否”。中文名稱說明系統(tǒng)唯一序號Y企業(yè)系統(tǒng)生成36位唯一序號(英文字母大寫)Y企業(yè)報(bào)送類型1-新增；2-變更；3-刪除報(bào)送時(shí)