跨境电商零售出口退货监管服务平台统一接入接口标准说明、企业数据交换接口报文规范、业务字典.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企业数据交
14、换接口报文规范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位系统唯一序号(英文字母大写)。版本号
15、versionan. 10是报文版本号,默认为LO8.1.3 退货订单业务节点描述退货订单业务节点描述见表B. 2。表B.2退货订单业务节点描述中文名称英文名称数据格式必填说明InvtRefundHead系统唯一序号guidC36是企业系统生成36位唯一序号(英文字母大写)报送类型appTypeCl是企业报送类型。卜新增2-变更3-删除。报送时间appTimeC14是企业报送时间 格式:YYYYMMDDhhinlnSS报送状态appStatusCl是企业报送状态。默认填写2申报地海关代码CustomsCodeC4是接受申报的海关关区代码,参照JGS/T 18海关 关区代码讥提运单号bi IlN
16、oC. 37是提运单号订单编号orderNoC.60是原交易订单编号-交易平台的订单编号,同一交易 平台的订单编号应唯一。电商平台名称ebpNameC. IOO是电商平台的登记名称电商平台编码ebpCodeC.50是电商平台的海关注册登记编号或统一社会信用代 码,与原订单电商平台企业一致。电商企业名称ebcNameC. 100是收发货人(电商企业)的登记名称电商企业编号ebcCodeC. 18是收发货人(电商企业)的海关注册登记编号或统一 社会信用代码,与原订单电商企业一致。退货物流企业编码IogisticsCodeC. 18是退货物流企业编码退货物流企业名称IogisticsNameC. 1
17、00是退货物流企业名称退货运单号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是退货商品申报
18、数量申报计量单位unitC3是退货商品申报计量单位,海关参数代码法定数量qtyiN19,5是退货商品法定数量法定计量单位unitlC3是退货商品法定计量单位,海关参数代码法定第二数量qty2N19,5是退货商品第二数量法定第二计量单位unit2C3是退货商品第二计量单位,海关参数代码消费者国别countryC3是退货商品消费者国别单价priceN19,5是退货商品单价币制currencyC3是退货商品币制总价totalPriceN19,5是退货商品总价电商店铺商品链接glinkC. 500否对应原订单电商店铺商品链接8.1.4 基础报文传输实体节点基础报文传输实体节点见表B. 4o表B.4基础
19、报文传输实体节点中文名称英文名称数据格式必填说明传输企业代码copCodeC. 18是报文传输的企业代码(需要与接入客户端的企业身份一致)传输企业名称CopNameC. 100是报文传输的企业名称报文传输模式dxpModeC3是默认为DXP;指中国电子口岸数据交换平台报文传输编号dxpldC. .30是向中国电子11岸数据中心申请数据交换平台的用户编号B. 2退货订单回执报文【DEN2148.2.1 退货订单回执报文结构退货订单回执报文结构见图B. 2。DEN214Message图B.2退货订单回执报文结构8.2.2 退货订单回执报文根节点DEN214Mcssage为退货订单回执报文XML根节
20、点名称,包括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
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 跨境电商 零售 出口 退货 监管 服务 平台 统一 接入 接口标准 说明 企业 数据 交换 接口 报文 规范 业务 字典
链接地址:https://www.desk33.com/p-100761.html