海关179号对接

置顶 已于 2024-05-22 15:06:51 修改
阅读量1.6w 收藏 27
点赞数 12
分类专栏： 海关179号 跨境电商 海关179号对接 文章标签： 经验分享 后端 php
于 2020-10-26 17:11:35 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_39393201/article/details/109207579
版权

1. 准备工作

  1. 第一步去海关注册备案拿到ukey
  2. 去中华人民共和国海关总署下载179号文档对接前先看一遍文档
  3. https://www.chinaport.gov.cn/pages/news/news-detail.html?jumpNoticeId=1878联系相关人员添加微信（群公告很重要）
  4. 中国电子口岸控件安装：https://app.singlewindow.cn/cas/login?_loginCportCU=1&service=https%3A%2F%2Fwww.chinaport.gov.cn%2Fcenter%2Fuserinfodemo%2Fuserinfo（打开地址点击下载控件）

2. 接收海关请求

海关发起数据查询
post方式（x-www-form-urlencoded）
从请求中获取openReq参数的值，该参数值是一个符合json标准的字符串，由于海关提交的请求是post方式（x-www-form-urlencoded），所以在url中是没有参数的，必须要从表单中获取该参数

海关数据示例
{"orderNo":"202009231454212140210352","sessionID":"032C3F56-0EE6-4558-B548-6C7A3451F07D","serviceTime":"1600852846372"}

接收完后需企业返回响应json格式数据 必须是json格式 10000表示成功 20000失败

{ "code":"10000","message":"","serviceTime":1533271903898}

3. 组装数据和上传报文

使用接收到的sessionID就可以进行加签（前期可以自己模拟请求）
使用ukey进行加签获取签名（使用操作员ukey）
按照179号文档进行数据拼装

获取签名

1. 使用官方js请求时需按以下格式来请求

数据格式

"sessionID":"032C3F56-0EE6-4558-B548-6C7A3451F07D"||"payExchangeInfoHead":"{"guid":"E4766021-21AC-1AA2-21DD-E974DF93C11D","initalRequest":"<xml><appid><![CDATA[]]></appid><mch_id></mch_id><body><![CDATA[]]></body><nonce_str><![CDATA[]]></nonce_str><out_trade_no>202009231454212140210352</out_trade_no><total_fee>500</total_fee><spbill_create_ip><![CDATA[]]></spbill_create_ip><notify_url><![CDATA[]]></notify_url><openid><![CDATA[]]></openid><trade_type><![CDATA[JSAPI]]></trade_type><sign><![CDATA[]]></sign></xml>","initalResponse":"<xml><appid><![CDATA[]]></appid><bank_type><![CDATA[OTHERS]]></bank_type><cash_fee>500</cash_fee><fee_type><![CDATA[CNY]]></fee_type><is_subscribe><![CDATA[N]]></is_subscribe><mch_id></mch_id><nonce_str><![CDATA[]]></nonce_str><openid><![CDATA[]]></openid><out_trade_no></out_trade_no><result_code><![CDATA[SUCCESS]]></result_code><return_code><![CDATA[SUCCESS]]></return_code><sign><![CDATA[]]></sign><time_end>20200923145426</time_end><total_fee>500</total_fee><trade_type><![CDATA[JSAPI]]></trade_type><transaction_id>4200000681202009235085032319</transaction_id></xml>","ebpCode":"11111111","payCode":"4403169D3W","payTransactionId":"4200000681202009235085032319","totalAmount":5,"currency":"142","verDept":"3","payType":"4","tradingTime":"20200923145426","note":""}"||"payExchangeInfoLists":"[{"orderNo":"202009231454218421271832","goodsInfo":[{"gname":"济州花梨精华面膜","itemLink":"https://填写自己的商品地址"}],"recpAccount":"111111111","recpCode":"22222222222","recpName":"填写在海关注册的公司"}]"||"serviceTime":"1601282210417"

js请求示例
海关179 js加签，海关179号对接，海关165号对接

2. WebSocket请求

请求地址：
ws://127.0.0.1:61232
wss://wss.singlewindow.cn:61231

数据格式

{"_id":"1","_method":"cus-sec_SpcSignDataAsPEM","args":{"inData":"\"sessionID\":\"032C3F56-0EE6-4558-B548-6C7A3451F07D\"||\"payExchangeInfoHead\":\"{\"guid\":\"E4766021-21AC-1AA2-21DD-E974DF93C11D\",\"initalRequest\":\"<xml><appid><![CDATA[]]><\/appid><mch_id><\/mch_id><body><![CDATA[]]><\/body><nonce_str><![CDATA[]]><\/nonce_str><out_trade_no>202009231454212140210352<\/out_trade_no><total_fee>500<\/total_fee><spbill_create_ip><![CDATA[]]><\/spbill_create_ip><notify_url><![CDATA[https:\/\/www.qingwatour.com\/api\/notify\/index]]><\/notify_url><openid><![CDATA[]]><\/openid><trade_type><![CDATA[JSAPI]]><\/trade_type><sign><![CDATA[]]><\/sign><\/xml>\",\"initalResponse\":\"<xml><appid><![CDATA[]]><\/appid><bank_type><![CDATA[OTHERS]]><\/bank_type><cash_fee>500<\/cash_fee><fee_type><![CDATA[CNY]]><\/fee_type><is_subscribe><![CDATA[N]]><\/is_subscribe><mch_id><\/mch_id><nonce_str><![CDATA[]]><\/nonce_str><openid><![CDATA[]]><\/openid><out_trade_no>202009231454212140210352<\/out_trade_no><result_code><![CDATA[SUCCESS]]><\/result_code><return_code><![CDATA[SUCCESS]]><\/return_code><sign><![CDATA[]]><\/sign><time_end>20200923145426<\/time_end><total_fee>500<\/total_fee><trade_type><![CDATA[JSAPI]]><\/trade_type><transaction_id>4200000681202009235085032319<\/transaction_id><\/xml>\",\"ebpCode\":\"111111\",\"payCode\":\"4403169D3W\",\"payTransactionId\":\"4200000681202009235085032319\",\"totalAmount\":5,\"currency\":\"142\",\"verDept\":\"3\",\"payType\":\"4\",\"tradingTime\":\"20200923145426\",\"note\":\"\"}\"||\"payExchangeInfoLists\":\"[{\"orderNo\":\"202009231454218421271832\",\"goodsInfo\":[{\"gname\":\"\u6d4e\u5dde\u82b1\u68a8\u7cbe\u534e\u9762\u819c\",\"itemLink\":\"商品链接地址"}],\"recpAccount\":\"111111\",\"recpCode\":\"222222\",\"recpName\":\"测试测试"}]\"||\"serviceTime\":\"1601282210417\"","passwd":"88888888"}}

!!!把以上加签数据替换成你自己的信息!!!

获取到签名格式

{"Result":true,"Data":["KT1m7MkJ98/O5s33P0BpF34b7+gyW5WEpMvaTB+Ji0O9H3FabJuoRj8s2DxbglUbqA9mFDoCXbljgt+GaO73HE0eO8vl+eWx981S5hYumdK7sVovMTqkCKs211ZsB3edVUVfDau3D8ew8rwoda/zOBVBiDKmo3J5iQ5INxN3oF8=","证书"],"Error":[]}

4. 上传报文

请求地址：https://customs.chinaport.gov.cn/ceb2grab/grab/realTimeDataUpload
方式：POST
参数名：payExInfoStr
参数类型: JSON

报文格式

{"sessionID":"032C3F56-0EE6-4558-B548-6C7A3451F07D","payExchangeInfoHead":{"guid":"E4766021-21AC-1AA2-21DD-E974DF93C11D","initalRequest":"<xml><appid><![CDATA[xwxwxwxwx112121]]></appid><mch_id>11111111</mch_id><body><![CDATA[测试测试]]></body><nonce_str><![CDATA[ashdgahgdhaghgliqwueyqu1]]></nonce_str><out_trade_no>202009231454212140210352</out_trade_no><total_fee>500</total_fee><spbill_create_ip><![CDATA[192.168.0.1]]></spbill_create_ip><notify_url><![CDATA[https://www.baidu.com]]></notify_url><openid><![CDATA[adasyduiyasdhjxzycua-Q]]></openid><trade_type><![CDATA[JSAPI]]></trade_type><sign><![CDATA[asd1sa56d4545wqe44wq5]]></sign></xml>","initalResponse":"<xml><appid><![CDATA[xwxwxwxwx112121]]></appid><bank_type><![CDATA[OTHERS]]></bank_type><cash_fee>500</cash_fee><fee_type><![CDATA[CNY]]></fee_type><is_subscribe><![CDATA[N]]></is_subscribe><mch_id>11111111</mch_id><nonce_str><![CDATA[ashdgahgdhaghgliqwueyqu1]]></nonce_str><openid><![CDATA[adasyduiyasdhjxzycua-Q]]></openid><out_trade_no>202009231454212140210352</out_trade_no><result_code><![CDATA[SUCCESS]]></result_code><return_code><![CDATA[SUCCESS]]></return_code><sign><![CDATA[asgdhasgdhasgdhgasgdhasgdh]]></sign><time_end>20200923145426</time_end><total_fee>500</total_fee><trade_type><![CDATA[JSAPI]]></trade_type><transaction_id>4200000681202009235085032319</transaction_id></xml>","ebpCode":"请替换","payCode":"4403169D3W","payTransactionId":"4200000681202009235085032319","totalAmount":5,"currency":"142","verDept":"3","payType":"4","tradingTime":"20200923145426","note":""},"payExchangeInfoLists":[{"orderNo":"202009231454218421271832","goodsInfo":[{"gname":"济州花梨精华面膜","itemLink":"请替换"}],"recpAccount":"请替换","recpCode":"请替换","recpName":"请替换"}],"serviceTime":"1601282210417","certNo":"证书号要小写","signValue":"KT1m7MkJ98/O5s33P0BpF34b7+gyW5WEpMvaTB+Ji0O9H3FabJuoRj8s2DxbglUbqA9mFDoCXbljgt+GaO73HE0eO8vl+eWx981S5hYumdK7sVovMTqkCKs211ZsB3edVUVfDau3D8ew8rwoda/zOBVBiDKmo3J5iQ5INxN3oF8="}

返回信息

{"code":"20006","message":"上传失败,入库失败 java.sql.SQLException: ORA-00001: 违反唯一约束条件 (sessionID重复)","total":0,"serviceTime":1603684304670}

返回以上json如上就基本完成，因为这里sessionID是自己生成的或者第二次上传，才会返回sessionID重复。可以去海关http://ceb1.chinaport.gov.cn/填写测试订单号进行线上模拟测试
填写海关1791，165线上测试订单，海关179号对接，海关165号对接

 {"code":"20004","message":"企业实时数据获取验签证书未在服务系统注册","total":0,"serviceTime":1603693566761}

未上传证书编号和证书，这里需要注意的事项！！！证书编号需要小写，并且页面上传的和上传支付数据的证书编号保持一致！！！ 如果已上传请检查证书是否一致
海光179,165注册服务地址，海关179号对接，海关165号对接

{"code":"20005","message":"验签失败","total":0,"serviceTime":1603696878548}

查看数据格式是否出现问题，查看证书是否一致
有一些坑需要注意
文档中的payExchangeInfoList应该是payExchangeInfoLists
serviceTime必须是字符串类型
totalAmoun不是string类型
查看上传数据和加签数据的时间，guid是否一致

{"code":"10000","message":"上传成功","total":0,"serviceTime":1603696878548}

测试完成

第一次写这么长的文档可能有点乱，大佬勿喷，小弟十分感谢！

涛老弟
关注
专栏目录
JAVA 海关179公告对接完整版本！！！
weixin_43398098的博客
08-08 1563
海关179公告对接，首先，我们会进入到一个海关的官方对接群
海关跨境电商平台数据实时获取接口对接走过的坑（海关165，179号公告）
liz0027的博客
08-07 6716
最近又有业务需要连接海关的报关业务，所以就必须对接海关165，179号公告的内容。 万万没想到的是，偌大的海关居然没有一个完整的对接文档，对接工作完全任凭网友的猜测和经验总结，难度可想而知。 而且，这个对接接口设计的理念实在是有点奇葩，非普通人类所能企及；Json格式字段顺序必须与标准报文（所谓的）一致； 加签和上报的报文还不是同一个字符串； 官方提供的JDK居然不好用，错误百出…等等等吧，已经无...
php对接海关179公告.zip
08-21
坑爹的海关写个文档看的累死人，废了几个礼拜才把这个鬼东西搞完，都是一路坑过来的，分享有需要的朋友希望减少坑人
179号海关公告php接入，代码遵循psr4规范
08-24
179号海关公告php接入,需要的朋友拿去吧,根据网上其他人的资料整理了一下代码，自己公司使用可以跑通
海关179对接
mgq_1991的博客
12-17 6750
1.背景 http://www.customs.gov.cn/customs/302249/302266/302267/2155884/index.html 跨境电子商务平台企业支付相关原始数据必须对接179，否则会清关失败。 例：清单[电商企业编码：xxxx,订单编号：xxxxxxxx]报文校验失败:电商平台[xxx]未对接海关总署179号公告数据实时抓取业务，无法正常申报。 2.准备 第一步去海关注册备案拿到法人卡（用于服务注册管理）和操作员卡（或者ukey）（用于上传支付信息加签） 如果操
179号海关公告php接入
03-29
179号海关公告php接入,需要的朋友拿去吧.现在这个用的是本地去找服务器是否有单,如果有内网穿透,可以用socket,就是把本地的那段代码放到服务器里面.
海关179号公文接入
Hxuening的博客
08-23 660
179号公文对接 上海公服示例 package net.shop.controller.admin.warehouse; import cn.hutool.core.codec.Base64; import com.fasterxml.jackson.core.JsonProcessingException; import com.fasterxml.jackson.databind.ObjectMapper; import net.shop.util.WebUtils; import org.apa
海关179号公告模拟接收海关请求.zip
09-07
海关179号公告模拟接收海关请求,求返回值,将收到的orderNo和sessionID存起来,供第二步使用，海关179对接终极版下载，海关179证书导出工具下载
python node.js ruby_海关179对接java,.net,python,node.js,ruby等业务处理逻辑
weixin_35272691的博客
02-09 213
创建数据表:– Table structure forpaycheckDROP TABLE IF EXISTSpaycheck;CREATE TABLEpaycheck(idint(10) unsigned NOT NULL AUTO_INCREMENT,order_novarchar(255) NOT NULL COMMENT ‘海关请求参数:orderNo’,session_id...
JAVA版海关179号对接流程
hdnhsf的博客
11-08 2902
代码借鉴海关179对接API.（如有侵权马上删除） 步骤 拿到ukey（运营或产品哪里应该会有） 获取开发文档179号开发文档 开发接收海关请求接口（按文档要求不能有端口号） 组装数据进行加签 拼接加签数据上报 完成 以上文档等不多介绍主要是开发（身为CV工程师直接上代码） 接收海关请求 接收海关请求并存储请求（因为加签需要在本地而接收请求要在开放服务器所以使用mq传输数据） @PostMapping(value = "/platDataOpen") @ResponseBody publ
php java海关联调服务api接口 179号公告接入
09-29
179号公告是海关发布的关于通关服务的重要法规，该公告可能规定了新的数据交换标准、流程规范或监管要求，因此，对于开发相关应用的企业来说，理解和遵循179号公告是至关重要的。 【描述】中提到的“海关联调服务”...
海关179对接问题及解决办法大集锦
alexyu01的博客
12-15 8536
1.大集锦
java海关179对接
12-21
java海关179对接
海关179接口终极解决方案
qq_23041905的博客
09-06 8399
海关179接口终极解决方案 海关165号、179号要求电商平台开放订单原始数据。有幸参与过几次完整的对接流程，知道其中的麻烦事。 在对接微信群里，接触到的不外乎以下几种身份： 1、电商平台boss,自己不是很懂技术，招的技术也不懂。 2、电商平台技术，新手，入职一段时间了，一直没有进展，老板给的压力很大。 3、产品经理 4、接外包的技术公司或者个人技术 大家普遍遇到的问题： 1、文档看不懂，业务流...
179海关公告php接入
08-12
179号海关公告php接入,需要的朋友拿去吧.现在这个用的是本地去找服务器是否有单,如果有内网穿透,可以用socket,就是把本地的那段代码放到服务器里面.
海关179对接微信/支付宝/通联支付及报关
alexyu01的博客
12-15 8899
支付报关,微信,支付宝,通联支付报关等
179海关公告php接入 php最新版 海关报关申报清单申报
09-29
179海关公告php接入 php最新版
179海关上报数据方法（.net）
04-23
js加签一般都没有问题，我就是加签之后上传的问题弄了两个礼拜，最后弄清楚了。 以下是数据上报海关方法，我用的是.net的web方式： 1.添加三个引用，见dll文件夹。 2.加载我写的类：两个cs文件（放到web目录下） 3.组织上报数据实体格式如下 public class payExchangeInfoLists { public string orderNo { get; set; }//String 订单编号 public List goodsInfo { get; set; }// List 商品信息 public string recpAccount { get; set; }// String 收款账号 public string recpCode { get; set; }// String 收款企业代码 public string recpName { get; set; }// String 收款企业名称 } public class goodsInfo { public string gname { get; set; }// String 商品名称 public string itemLink { get; set; }// String 商品展示链接地址 } public class payExchangeInfoHead { public string guid { get; set; }// String 系统唯一序号 public string initalRequest { get; set; }// String 原始请求 public string initalResponse { get; set; }// String 原始响应 public string ebpCode { get; set; }// String 电商平台代码 public string payCode { get; set; }// String 支付企业代码 public string payTransactionId { get; set; }// String 交易流水号 public double totalAmount { get; set; }// double 交易金额 public string currency { get; set; }// String 币制 public string verDept { get; set; }// String 验核机构 public string payType { get; set; }// String 支付类型 public string tradingTime { get; set; }// String 交易成功时间 public string note { get; set; }// String 备注 } public class payExInfoStr { public string sessionID { get; set; }// string Y In 海关发起请求时，平台接收的会话ID。 public payExchangeInfoHead payExchangeInfoHead { get; set; }// String Y In 支付原始数据表头 public List payExchangeInfoLists { get; set; }// List Y In 支付原始数据表体 public string serviceTime { get; set; }// Long Y In 返回时的系统时间 public string certNo { get; set;
179海关接口.net加签验签实例
04-25
1.申请测试环境 2.修改179report.cs最下面的参数： public static CustomsReportSetting Current = new CustomsReportSetting() { CertNo = "", CertFilePath = "/cert/cert.cer", CertPassword = "", CorpName = "", CorpCode = "", ebpCode= "" }; 其中的CertFilePath = "/cert/cert.cer",是您导出的证书，替换项目中的证书文件 其他项目修改成您自己的。 3.在插有操作员卡的电脑上安装iis环境，并部署该web项目。 4.在浏览其中运行该web项目。
海关179号出口运单报文CEB505Message描述规范
最新发布
m0_61330489的博客
11-28 395
海关179号报关流程,CEB505Message出口运单报文描述
评论 33
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值