跨境电商零售出口退货监管服务平台统一接入接口标准说明、企业数据交换接口报文规范、业务字典.docx

附录A附录B （资料性）附录C统一接入接口标准说明A.1跨境退货业务申报接口跨境企业向跨境电商退货监管服务平台申报单证数据。本接口采用的报文格式规范总署 参照海关总署跨境电子商务统一版规范。详细内容见附录B。A. 1.2接口调用方式采用POST方式调用。A.1.3接口参数说明接口参数见表A. 1。表A.1接口参数序 号参数名字段名类型长 度必填说明1appld应用唯 标识VARCHAR28贡由建设单位分配，测试环境aphid：Rytooooi2bizCode业务代码VARCHAR28看必填，必须为8位字符串，规则：DEN+三位数字编号+00,比如:退货清单则填写DEN写300,理 货明细填写DEN21500。具体内容见附录Bo3bizld业务IDVARCHAR21.50吴填写报文头属性的guid4content业务报文 内容VARC1IAR2<IM看报文规范定义见附录B5timestamp请求时间 戳VARCHR2/JS长整型。定义为从格林威治时 间1970年01月01日00时00分 00秒起至现在的总亳秒数。请求时间戳与服务器接收时间 间隔24小时将视为请求超期。6sign数据签名VARCHR240看时数据的签名，采用SHAl算 法。Sign=SHAI （ "bizCode=业务代 码&bizld=业务ID&content=业务报 文内容&t Lmestamp=请求时间戳 &appKey=接口签名密钥”），JAVA 客户端可参照1. 7示例代码API获 取7companyCode企业备案 编号VARCHAR210寿企业海关注册编号A.1.4接口返回说明 “code” ： “0”，“message” : “同步回执(报文结构参考L 2. 3章节)” rtcodew : “1050”，“message" ： “apple!不能为空”表A.2代码表编码(code)描述 (message)0同步回执（报文结构参考1. 2. 3章节）1失败（未明确定义的错误）1050appld不能为空1051bizCode不能为空1052bizld不能为空1053content不能为空1054timestamp不能为空1055sign不能为空1061接口服务未开放1062应用访问权限不足，请确认是否有调用该业务的权限1063业务层当前请求数过多,请稍后再试1064访问被拒绝1065数据重复提交1066接入层当前请求数过多,请稍后再试1067数据签名错误1068请求超时1069APP对应的客户端IP不正确1070路由地址未找到1071后台业务请求超时1072超出业务调用次数限制1073业务层返回HTTP状态码错误2201请求报文必填字段为空2202请求报文格式错误2203请求报文为空或null2204SerViCe服务异常A. 1.5接口编码格式接口数据采用UTF-8编码。A.1.6接口编码密钥应用密钥（appKey）用于接口签名。由建设单位统一颁发，请接入方妥善保管，防止泄 露。A.1.7接口调用示例Java代码示例见图. Iopublic static void main(String args)Client client=newSSLClient("https:/openapi-:8553/gateway/receive"); / 接口调用地址生成请求签名String appId="RYT00001"应用唯标识String bizCode="DEV21300" 业务代码String bizId="311afl25-6fed-4603-8c5d-49blfa4b4b9b" 业务工D 业务报文内容String Content =业务报文内容String timeStamp=String. VaLUeof(SyStem. CurrentTimeMiLLisO); 时间戳String appKey= "abcdefghijl234567890abcdefghijl234567890" 应用密钥String sign=client.getSign(bizCode, bizld, content, timestamp, appKey) 数字签名封装请求参数Map<Stringj String> parameters=new HashMap<Stringj String>(); parameters.put("appld"j appld); parameters.put("bizCode", bizCode);parameters .put("bizld", bizld);parameters .put("content", content);parameters .put("timestamp", timestamp);parameters.put(,sign"j sign);parameters .put("companyCode", "1105910159");parameters.put("cusSign", "1");String result=client.post(parameters); 接口调用System.out .println(result);打印返叵 1结果图A. 1接口调用Java代码示例A. 1.8接口调试工具https:/opcnapi-test. zjport. gov. cn:8553/gateway/test/inputcebA.1.9接口地址限制接入系统对客户端IP有限制，上生产环境时请提供客户端公网IP。A. 1.10接口调用常见问题A. 1.10. 1 SSL握手失败问题：使用ZjPOrtGatCWayCliCnt. jar按照示例代码调用，出现以下错误：javax. net. ssl. SSLHandshakeException: Received fatal alert: handshake_failure 解决方案：将jdk升级到1.7+A. 1. 10.2签名错误问题：参照示例代码编写，提交后提示签名错误。解决方案：L可能是密钥与应用不匹配，使用相应的密钥即可。2 .可能是报文内容从文件中读入，没有转成UTF-8编码。需要做一次编码转换。3 .可能是类包冲突，导致SHAI对中文的算法不匹配。可查看DCgiStUtilS.ShaHex （“中 文“）是否和网上SHAl对“中文”的加签一致。本项目使用的是commons-codec-1. 5. jar, 也支持更高版本。A.2跨境退货业务回执接口A. 2.1功能说明回执分同步、异步两种类型。同步回执在企业调用1.1接口后实时返回；异步回执由跨境电商退货监管服务平台主动调用企业接口发送。对接企业需提供一个回执接收接口地址给到跨境电商退货监管服务平台，用于接收所有 回执数据。数据接收回执接口采用http post方式，跨境电商退货监管服务平台会对发送 内容加密加签，企业接收时需要解密验签。具体参照以下规范开发。企业提供URL地址：例如：http:/xxx. XXX. XXX. com/gateway/pac mcssage receiver. doPost参数：Content=XXXXmsg_type=XXXdata_digest=XXXA. 2. 2业务参数说明业务参数说明见表A.3o表A. 3业务参数说明参数名称用途content请求报文内容，电子口岸提供AES解密密钥msgtype消息类型，不同消息类别对应报文格式不同。CUSTOMS DEN CALLBACK：退货申报回执 各单证回执类型见附录Bdata_digest请求签名，参考测试页面说明，电子口岸提供RSA验签公钥A. 2.3电子口岸同步、异步回执报文结构格式见附录B各单证回执报文定义。A. 2.4报文加密与解密鉴于与海关数据交换较强的安全级别要求，本方案采用国际通用的对称加密算法AES, 非对称加签算法RSA,实现防篡改、防抵赖、数据机密性、身份认证四个层面的安全要求。A. 2.4.1开发参考页面说明：http:/122. 224. 230. 4:47008/CplinkJkfClient/testSend. jsp 接口返回数据格式要求如下：A. 2.4. 1. 1 基本参数名称类型是否可为空备注successVARCIIAR2N是否成功errorCodesVRCHR2 (10)Y错误编码errorMsgVARCHAR2 (1000)Y错误信息A. 2. 4. 1.2接口处理正常返回样例：<response><success>true</success><response>A. 2. 4.1.3接口处理异常返回样例：<response><success>false</success><errorCode>l23<errorCode><errorMsg> 异常 <errorMsg><response>A. 2. 4. 2安全性保证说明机密性：通讯报文采用AES算法加密，加密的信息只有接收方可解密防篡改：只有发送 方可进行数据更改，其他任何人员无法修改防抵赖：接收方收到的消息签名由发送方的私钥运算生成，其他人无法生成对应信息, 采用RSA加签，只有接收方公钥才能验签。身份认证：接收方能解密信息，发送方默认接收方具备身份合法的性质。A. 2.4.3通讯协议与报文格式通讯双方采用http POSt方法作为通讯协议。请求头必须添加：“Content-type”, *application/-www-form-ur1encoded;Charset=XXXcharset:GBK, UTF-8 可选http请求参数都通过http URL编码传送A. 2. 4. 4其它说明为了保证高度安全性，请求与响应双方向采用同等策略私钥的安全保管，是通讯安全的核心保障附录D附录E （规范性）附 录F企业数据交换接口报文规范8.1 退货订单申报报文DEN2138.1.1 退货订单申报报文结构退货订单申报报文结构见图B.1。Ir- InvtRefundHead InvtRefund-一 InvtRefundListIiN-L-N, DEN213MessageAttributeBaseTransfer图B.1退货订单申报报文结构B.1.2退货订单报文根节点DEN2BMessage为退货订单报文XML根节点名称，包括guid和VerSiOn两个属性，见表B. K表B. 1 DEN213Message节点的属性名称英文名称类型必填说明报文编号guidan36是报文的36位系统唯一序号（英文字母大写）。版本号versionan. 10是报文版本号，默认为LO8.1.3 退货订单业务节点描述退货订单业务节点描述见表B. 2。表B.2退货订单业务节点描述中文名称英文名称数据格式必填说明InvtRefundHead系统唯一序号guidC36是企业系统生成36位唯一序号（英文字母大写）报送类型appTypeCl是企业报送类型。卜新增2-变更3-删除。报送时间appTimeC14是企业报送时间 格式：YYYYMMDDhhinlnSS报送状态appStatusCl是企业报送状态。默认填写2申报地海关代码CustomsCodeC4是接受申报的海关关区代码，参照JGS/T 18海关 关区代码讥提运单号bi IlNoC. 37是提运单号订单编号orderNoC.60是原交易订单编号-交易平台的订单编号，同一交易 平台的订单编号应唯一。电商平台名称ebpNameC. IOO是电商平台的登记名称电商平台编码ebpCodeC.50是电商平台的海关注册登记编号或统一社会信用代 码，与原订单电商平台企业一致。电商企业名称ebcNameC. 100是收发货人（电商企业）的登记名称电商企业编号ebcCodeC. 18是收发货人（电商企业）的海关注册登记编号或统一 社会信用代码，与原订单电商企业一致。退货物流企业编码IogisticsCodeC. 18是退货物流企业编码退货物流企业名称IogisticsNameC. 100是退货物流企业名称退货运单号IogisticsNoC.80是退货货物的物流面单号码毛重grossWeightN19,5是退货商品毛重-单位为千克退货类型refundTypeC.2是退货类型（0-未触达消费者退货，I-实际触达消费 者退货）退货原因代码reasonCodeC. .2是01-派送失败02-清关失败03-消费者退货04-其 他InvtRefundList商品项号gnumN4是对应原订单商品项商品名称gnameC. 250是退货商品名称商品编码geodeC. 10是退货商品海关商品编码（10位）规格型号gmodelC. 250是退货商品规格型号申报数量qtyN19,5是退货商品申报数量申报计量单位unitC3是退货商品申报计量单位,海关参数代码法定数量qtyiN19,5是退货商品法定数量法定计量单位unitlC3是退货商品法定计量单位,海关参数代码法定第二数量qty2N19,5是退货商品第二数量法定第二计量单位unit2C3是退货商品第二计量单位,海关参数代码消费者国别countryC3是退货商品消费者国别单价priceN19,5是退货商品单价币制currencyC3是退货商品币制总价totalPriceN19,5是退货商品总价电商店铺商品链接glinkC. 500否对应原订单电商店铺商品链接8.1.4 基础报文传输实体节点基础报文传输实体节点见表B. 4o表B.4基础报文传输实体节点中文名称英文名称数据格式必填说明传输企业代码copCodeC. 18是报文传输的企业代码（需要与接入客户端的企业身份一致）传输企业名称CopNameC. 100是报文传输的企业名称报文传输模式dxpModeC3是默认为DXP；指中国电子口岸数据交换平台报文传输编号dxpldC. .30是向中国电子11岸数据中心申请数据交换平台的用户编号B. 2退货订单回执报文【DEN2148.2.1 退货订单回执报文结构退货订单回执报文结构见图B. 2。DEN214Message图B.2退货订单回执报文结构8.2.2 退货订单回执报文根节点DEN214Mcssage为退货订单回执报文XML根节点名称，包括guid和version两个 属性,见表B.5。表B.5 DEN214Message节点的属性名称英文名称类型必填说明报文编号guidan36是报文的36位系统唯一序号（英文字母大写）。版本号versionan. 10是报文版本号，默认为LO8.2.3 2. 3退货订单回执报文描述退货订单回执报文描述见表B. 6o表B.6退货订单回执报文描述中文名称英文名称数据格式必填说明系统唯序号guidC36是系统生成36位唯一序号（英文字母大写）电商平台编码ebpCodeC. 50是电商平台的海关注册登记编号或统一社会信用代 码，与原订单电商平台企业一致。电商企业编号ebcCodeC. 18是收发货人（电商企业）的海关注册登记编号或统 一社会信用代码，与原订单电商企业一致。订单编号OrderNoC. 60是原交易订单编号-交易平台的订单编号，同一交易 平台的订单编号应唯一。回执状态FeturnStatusCl. 10是操作结果（120-待审核/399-审核通过/100-退单 /699-销毁/700-退运/-800放行），若小于0数字 表示处理异常回执回执时间returnTimeC17是操作时间（格式:YYYYMMDDhhmmSSSSS）回执信息returninfo C. 1000 是备注（如:退单原因）B.3退货理货明细申报报文【DEN215B. 3.1退货理货明细报文结构退货理货明细报文结构见图B. 3。InvtRefundDetaiIr InvtRefundDetaiIOrderHeadInvtRefundDetaiIList ,'InvtRefundDetailOrderListDEN215MessageN1-nBaseTransferAttribute图B.3退货订单回执报文结构B. 3.2退货理货明细根节点DEN215Message为订单报文XML根节点名称，包括guid和version两个属性，见表B. 34>表B7 DEN215Message节点的属性名称英文名称类型必填说明报文编号guidan36是报文的36位系统唯一序号（英文字母大写）。版本号versionan. 10是报文版本号，默认为LOB. 3.3退货理货明细业务节点描述退货理货明细业务节点描述见表B. 8。表B.8退货订单业务节点描述中文名称英文名称数据格式必填说明InvtRefundDetail系统唯一序号guidC36是企业系统生成36位唯一序号 （英文字母大写）报送类型appTypeCl是企业报送类型。1-新增2-变更3-删除。报送时间appTiraeC14是企业报送时间 格式:YYYYMMDDhhmmSS报送状态appStatusCl是企业报送状态。默认填写2中报地海关代码CustomsCodeC4是接受申报的海关关区代码,参照JGS/T 18 海关关区代码。退货提运单号refundBilINoC. 37是溯源退货货物的提运单号码入场交通工具号码domesticTrafNoC. 100是退货货物放行后进入监管场地提货的交通 工具车牌号码监管场所编码IoctNoC. 10是同一申报地海关下有多个跨境电子商务的 监管场所。监管场所经营人代码OperatorCodcC. 18是监管场所经营人在海关注册登记的编号， 邮政运输用邮政物流企业监管场所经营人名称OperatorNameC. 100是监管场所经营人在海关注册登记的名称， 邮政运输用邮政物流企业InvtRefundDetaiIOrderHead退货总包号totalpackageNoC.37是退货货物运单号装入的大包号码退货申报企业编码QgentCodeC. 18是申报退货订单数据的主体编码退货申报企业名称QgentNameC. 100是申报退货订单数据的主体名称退货物流企业编码IogisticsCod eC. 18是退货物流企业编码退货物流企业名称IogisticsNam eC. 100是退货物流企业名称退货运单号IogisticsNoC.80是退货货物的物流面单号码毛重grossWeightN19,5是单位为千克理货状态taiIyStatusCl是1-理货正常2-理货异常理货异常原因tallyinfoC2否（01品名不符、02数量不符，03重量不 符04其他）出场车牌号OutTrafNoC. 100否放行离场时对应的车牌号InvtRefundDetailOrderList商品项号gnumInt是对应原订单商品项商品名称gnameC. 250是退货商品名称商品编码geodeC. 10是退货商品的HSeOoD规格型号gmodelC. 250是退货商品的材质，用途等申报数量qtyN19,5是退货商品的个数申报计量单位unitC3是申报计量单位B. 3.4基础报文传输实体节点基础报文传输实体节点见表B. 9o表B.9基础报文传输实体节点P文名称英文名称数据格式必填说明传输企业代码copCodeC. 18是报文传输的企业代码（需要与接入客户端的企业身份一 致）传输企业名称CopNameC. 100是报文传输的企业名称报文传输模式dxpModeC3是默认为DXP；指中国电子口岸数据交换平台报文传输编号dxpldC. 30是向中国电子I 1岸数据中心申请数据交换平台的用户编号B. 4退货理货明细回执报文【DEN216B. 4.1退货理货明细回执报文结构DEN216MessageOperatorCoderefundBillNoreturnStatusreturnTimeguidreturn Infoatrribuites图B. 4退货理货明细回执报文结构B. 4.2退货理货明细回执报文根节点DEN216Message为退货理货明细回执报文XML根节点名称，包括guid和version 两个属性，见表B. 10。表B. 10 DEN216Message节点的属性名称英文名称类型必填说明报文编号guidan36是报文的36位系统唯一序号（英文字母大写）。版本号versionan. 10是报文版本号，默认为LoB. 4.3退货理货明细回执报文描述退货理货明细回执报文描述见表B. 11。表B.11退货理货明细回执报文描述中文名称英文名称数据格式必填说明系统唯一序号guidC36是系统生成36位唯一序号（英文字母大写）监管场所经营 人代码OperatorCodcC. 18是监管场所经营人在海关注册登记的编号，邮政运输 用邮政物流企业退货提运单号FefundBillNoC. .37是溯源退货货物的提运单号码回执状态returnStatusCl. 10是操作结果1:入库成功2:入库失败回执时间returnTimeC17是操作时间（格式：yyyyMMddHHmmssfff）回执信息returninfoC. 1000是备注（如:入库失败原因）B. 5退货物流单申报报文【DEN505 B.5.1退货物流单报文结构DEN505MessageRefundLogistics1.NBaseTransferatrribuites图B.5退货订单回执报文结构B.5.1退货物流单根节点DEN505Message为订单报文XML根节点名称，包括guid和version两个属 性，见表B. 12。表B. 16 DEN505Message节点的属性名称英文名称类型必填说明报文编号guidan36是报文的36位系统唯一序号（英文字母大写）。版本号versionan. 10是报文版本号，默认为LOB. 5.2退货物流单业务节点描述退货物流单业务节点描述见表17。表B.17退货物流单业务节点描述中文名称英文名称数据格式必填说明RefundLogistics系统唯一序号guidC36是企业系统生成36位唯一序号（英文 字母大写）报送类型appTypeCl是企业报送类型。1-新增2-变更3-删 除。报送时间appTimeC14是企业报送时间格式:YYYYMMDDhhinmSS报送状态appStatusCl是企业报送状态。默认填写2出口运单号CleclLogisticsNoC.80是出口运单号出口物流申报企业名称deciLogisticsNameC. 100是溯源出口运单中报的企业主体出口物流申报企业编码deciLogisticsCodeC. 18是出口运单巾报主体在海关系统的备案 编码出口离境口岸代码departurePortCodeC4是溯源退货包裹在出口时的出口口岸出口离境时间departure!imeC14是溯源退货包裹出口离境时间格 式：YYYYMW）DhhmmSS出口结关时间ClearanceTimeC14是溯源退货包裹出口结时间，只有完成 出口结关的货物才能办理退货。格 式：YYYYMMDDhhnmISS出口运抵国别tradeCountryC3是溯源退货包裹出口运抵国出口运抵境外城市名称tradeCityC. 128是出口运抵境外城市时间tradeCityTimeC14是格式:YYYYMMDDhhmmSS境外清关城市OverseasC1earanceCityC. 128是运抵境外清关城市时间OverseasC1earanceCityTimeC14是格式：YYYYMMDDhhmmSS境外清关是否成功OverseasC1earanceC.3是yes-成功，no-不成功境外配送分拨仓地址OverseasDeliveryL ocationC. 256否退货包裹在境外进I 1清关成功后运送 至配送分拨仓的地址。运抵境外配送分拨仓时 间OverseasDeliveryLOcationTimeC14否退货包裹在境外进口清关成功后运 送至配送分拨仓的时间境外配送是否成功OverseasDeliveryC.3否溯源退货包裹在境外是否配送成功， 成功“yes” ,失败“no”，配送失 败包裹属于未触达消费者退货，配送 成功包裹的退货属于实际触达消费者 退货。退货运单号IogisticsNoC. .80是毛重grossWeightN19,5是退货物流企业名称IogisticsNameC. 100是溯源向海关申报退货包裹的物流企业 主体退货物流企业代码IogisticsCodeC. 18是溯源退货物流企业在海关的备案编 码。境外退货分拨仓名称OverseasLocationC. 256是溯源退货货物在境外分拨仓的名称,运抵境外退货分拨仓时 间OverseasLocationT imeCU是溯源退货货物在境外分拨仓的时间。格式:YYYYMMDDhhmmSS退货提运单号bi IlNoC. .37是溯源退货货物的提运单号码。退货境外启运地despPortCodeC50是溯源退货包裹的启运地。退货境外启运时间despPortTimeC14是溯源退货包裹的启运时间。格 式：YYYYMMDDhhmmSS进境监管场所名称entyLoctNameC. 100是入境时间entyTimeCU是退货包裹进境时间，格 式：YYYYMMDDhhmmSS入境口岸代码entyPortCodeC4是溯源退货包裹进境口岸监管口岸代码IoctPortCodeC4是溯源退货包裹清关口岸名称退货运抵监管口岸时间IoctPortTimeC14是溯源退货包裹运抵清关口岸时间，格 式：YYYYMMDDhhmmSS物流查询地址IogisticsQueryUrlC. 128否供监管人员查看包裹物流节点的链接 地址B. 5. 3基础报文传输实体节点基础报文传输实体节点见表B. 18。表B.18基础报文传输实体节点中文名称英文名称数据格式必填说明传输企业代码copCodeC. 18是报文传输的企业代码（需要与接入客户端的企业身份一 致）传输企业名称CopNameC. IOO是报文传输的企业名称报文传输模式dxpModeC3是默认为DXP：指中国电子口岸数据交换平台报文传输编号dxpldC. 30是向中国电子口岸数据中心申请数据交换平台的用户编号B.6退货物流单回执报文【DEN506B. 6.1退货物流单回执报文结构退货物流单回执报文结构见图B. 6。L gid-IogisticsCodeL IogisticsNo-retumStatusJ retumTim©DEN506Message图B.6退货订单申报报文结构-retumlnfoB. 6.2退货物流单回执报文根节点DEN506Message为退货物流单回执报文XML根节点名称，包括guicl和version两 个属性，见表B. 19。表B. 19 DEN506Message节点的属性名称英文名称类型必填说明报文编号guidan36是报文的36位系统唯一序号（英文字母大写）。版本号versionan. 10是报文版本号，默认为LoB. 6.3退货物流单回执报文描述表B.20退货物流单回执报文描述中文名称英文名称数据格式必填说明系统唯一序号guidC36是系统生成36位唯一序号（英文字母大写）退货物流企业代码IogisticsCodeC. 18是溯源退货物流企业在海关的备案编码。退货运单号IogisticsNoC.80是回执状态returnStatusCL. 10是操作结果1:入库失败2:入库成功回执时间returnTimeC17是操作时间（格式：yyyyMMddHHmmssfff）回执信息returninfoC. IOOO是备注（如:失败原因）B. 7物流妥投、总署退单信息申报报文【DEN507B. 7.1物流妥投、总署退单报文结构物流妥投、总署退单报文结构见图7。(-guid- appType appTime,-appStatus-CustomsCode.-IogisticsNo.-IogIsticsNameRefundArrivaI一 一卜 IogisticsCode1.N,、'-PaCkageStaUJSDEN507Messagere,easeime_卜 ChannelName卜 arrivalTime detainTime卜 detainReason- destroyTime- -AttributeBaseTransfer图7物流妥投、总署退单报文结构B. 7.2物流妥投、总署退单根节点DEN507Message为物流妥投、总署退单报文XML根节点名称，包括guid和version 两个属性，见表B. 21。表B. 21 DEN507Message节点的属性名称英文名称类型必填说明报文编号guidan36是报文的36位系统唯一序号（英文字母大写）版本号versionan. 10是报文版本号，默认为LoB. 7.3物流妥投、总署退单业务节点描述物流妥投、总署退单业务节点描述见表B. 22。表B.22物流妥投、总署退单业务节点描述中文名称英文名称数据格式必填说明RefundArrival系统唯一序号guidC36是企业系统生成36位唯一序号（英文字母大 写）报送类型appTypeCl是企业报送类型。1新增2-变更3-删除。报送时间appTimeC14是企业报送时间格式:YYYYMMDDhhmmss报送状态appStatusCl是企业报送状态。默认填写2申报地海关代码CustomsCodeC4是接受申报的海关关区代码，参照JGS/T 18 海关关区代码o运单号IogisticsNoC. 80是物流企业的运单包裹面单号。同一物流企业 的运单编号不重复。出口物流中报企业名称IogisticsNameC. 100是物流企业在海关注册登记的名称。出口物流中报企业编码LogisticsCodeC. 18是物流企业的海关注册登记编号。包裹状态PackageStatusCl是包裹状态（1 -放行、2-妥投、3-销毁、4-