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

《跨境电商零售出口退货监管服务平台统一接入接口标准说明、企业数据交换接口报文规范、业务字典.docx》由会员分享，可在线阅读，更多相关《跨境电商零售出口退货监管服务平台统一接入接口标准说明、企业数据交换接口报文规范、业务字典.docx（19页珍藏版）》请在优知文库上搜索。

1、附录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,理 货明细填写D

2、EN21500。具体内容见附录Bo3bizld业务IDVARCHAR21.50吴填写报文头属性的guid4content业务报文 内容VARC1IAR2IM看报文规范定义见附录B5timestamp请求时间 戳VARCHR2/JS长整型。定义为从格林威治时 间1970年01月01日00时00分 00秒起至现在的总亳秒数。请求时间戳与服务器接收时间 间隔24小时将视为请求超期。6sign数据签名VARCHR240看时数据的签名，采用SHAl算 法。Sign=SHAI （ bizCode=业务代 码&bizld=业务ID&content=业务报 文内容&t Lmestamp=请求时间戳 &appK

3、ey=接口签名密钥”），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不能为空1054tim

4、estamp不能为空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接口编

5、码密钥应用密钥（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

6、业务报文内容String Content =业务报文内容String timeStamp=String. VaLUeof(SyStem. CurrentTimeMiLLisO); 时间戳String appKey= abcdefghijl234567890abcdefghijl234567890; 应用密钥String sign=client.getSign(bizCode, bizld, content, timestamp, appKey) 数字签名封装请求参数Map parameters=new HashMap(); parameters.put(appldj appld); param

7、eters.put(bizCode, bizCode);parameters .put(bizld, bizld);parameters .put(content, content);parameters .put(timestamp, timestamp);parameters.put(,signj sign);parameters .put(companyCode, 1105910159);parameters.put(cusSign, 1);String result=client.post(parameters); 接口调用System.out .println(result);打印返

8、叵 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 解决方

9、案：将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接口后实时返回；异步回执由跨境电商退货监

10、管服务平台主动调用企业接口发送。对接企业需提供一个回执接收接口地址给到跨境电商退货监管服务平台，用于接收所有 回执数据。数据接收回执接口采用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请求报文内容

11、，电子口岸提供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/Cplin

12、kJkfClient/testSend. jsp 接口返回数据格式要求如下：A. 2.4. 1. 1 基本参数名称类型是否可为空备注successVARCIIAR2N是否成功errorCodesVRCHR2 (10)Y错误编码errorMsgVARCHAR2 (1000)Y错误信息A. 2. 4. 1.2接口处理正常返回样例：trueA. 2. 4.1.3接口处理异常返回样例：falsel23 异常 A. 2. 4. 2安全性保证说明机密性：通讯报文采用AES算法加密，加密的信息只有接收方可解密防篡改：只有发送 方可进行数据更改，其他任何人员无法修改防抵赖：接收方收到的消息签名由发送方的私钥运

13、算生成，其他人无法生成对应信息, 采用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是报