| 工具下载: |
 华讯 云加签=>ukey加密机, http请求,使用内网穿透技术,适用于总署XML/179实时加签, 免费试用 >>点击查看详情 |
第一图,
179对接业务流程及解决方案 |
|
第二图,
179服务注册注意事项 |
>>操作员卡编号及证书导出 >>服务地址接口开发文档 >>终极版客户端 >>海关179支付查询上报参数详解
>>单一窗口 登录标准入口: https://www.singlewindow.cn/#/
参照这里找到服务管理点击1或者点击2
|
第三,
179资质办理问题 |
1.先查询是否具有资质?如下图表示已经具有资质, >>电商平台资质查询
2,如果没有资质,需要办理,步骤如下:
1. 线上申请已经办理好海关备案登记，取得电子口岸卡的企业，可登陆 单一窗口 https://www.singlewindow.cn/, 要用卡介质登录
进入 企业资质 > 企业注册登记 > 注册信息变更申请 页面，在跨境电子商务企业类型一栏 , 勾选 "电子商务企业"、"电子商务交易平台" 两个选项，进行线上备案申请
2. 现场审核打电话( 95198或12360)咨询需要要什么资料,然后到你海关的企业管理科去做现场审核,开通后如下图:
以上仅供参考,每个地区不一样,具体请咨询当地海关 |
第三图,
179对接流程 |
| 1、服务注册 |
登录>>http://ceb1.chinaport.gov.cn/,按要求将证书编号,证书,模拟订单号,接口地址填写并保存 |
| 2、开发接口并上传测试数据 |
企业根据所提供样例及接口开发文档>>海关跨境电商进口统一版信息化系统平台数据实时获取接口（试行），自己开发，返回"上传成功"，为正确上传状态,通过联调企业返回实时数据接口地址上传请求,将数据内容所有数据一级节点使用||分割符拼接为连续字符串，使用IC卡、Ukey、服务类密码设备进行加签，将certNo（证书编号）、signValue（加签结果）补充入请求中。
通过>>模拟样例中海关实时数据获取请求，按返回格式正确返回正常调用值。在相应时间内上传支付相关原始数据。
联调企业返回实时数据接口地址：
https://customs.chinaport.gov.cn/ceb2grab/grab/realTimeDataUpload |
| 3、注册完成需要审核 |
审核的时候系统随机抽查企业三天内的通关清单订单号或自填订单号，发送给企业，企业接收到返回10000为审核通过.
审核不通过的原因：
企业收到调用返回的不是10000，企业三天内没有订单数据或未填写订单号，端口需要80，是否配置白名单，需要卡介质登陆
群里按照此格式发审核请求:
电商平台代码：**** ,麻烦审核一下,@鑫² º ² º |
| 4、审核通过后 |
企业启用审核通过的地址，确保上传数据在收到请求后两分钟内完成。
|
| 5、保持接口连通。 |
对接完成 |
|
第四工具,
证书检测,
上报数据格式检测,
签名验证 |
验签失败辅助工具:>>http://tool.qdhuaxun.cn/?checksign |
第五图,
179支付数据示例 |
 |
第六图,
3种加签工具 |
 1.IC卡(很少用,老版的,<=12票/分钟)  2.Usbkey(98%用的是这个,<=240票/分钟) | 3.云加签 |4.建行U盾  |
加签能力
 |
1.互联网+平台页面,如果无"服务注册管理"菜单或提示无注册权限
a.请检查电商平台权限,应该具有电子商务企业和电子商务平台企业两项权限
b.是否是法人卡登陆,需要用法人卡登录才可以
2.证书注册栏里,如果电商平台代码为空
请开通电商平台权限,应该具有电子商务企业和电子商务平台企业两项权限
3.证书注册栏里,如果电商平台代码与报关海关编号不一致
请联系海关办卡部门变更,注销老的,保留新的
4.上报时,如果提示"企业实时数据获取验签证书未在服务系统注册"
请检查: 证书编号是否已填写,证书是否已上传
请检查: 上报的ebpCode 与 certNo 是否与证书注册栏里的一致,并且证书编号为小写,电商平台代码字母为大写!
5.证书注册栏,点击上传证书按钮,如果提示"操作失败"
a.互联网+入口地址不对,看群公告最新登录地址
b.清理浏览区缓存试下
c.不要用360浏览器,用谷歌浏览器试试,最大的原因是入口不对
6.上报数据时,如果提示"签名验证根证书失败"
a.请检查证书是否完整,有的没有复制完整
b.证书格式是否标准
c.证书是否已过期,有这样的
7.审核订单号与企业联系人管理栏
如果交易管理栏没有订单,此处应填写订单号
8.审核订单号与企业联系人管理栏,点击单号与联系人,提示成功,但刷新信息为空
如果保存不上,请更换谷歌浏览器,不要用360浏览器
9.如果提示"上传失败"
上传数据方式有问题，建议可以先把payExchangeInfoHead里的initalRequest和initalResponse先改成简单的字符串试试
验签前json解析失败 注意:json字符串格式 （看公告样例）
如果带特殊字符，payInfostr的value 需要做下urlencode (使用多次就会出现汉字乱码%什么的)
10.上报数据时,如果报"验签失败"
a.原文不匹配(注意格式 字段顺序 二级字段顺序 必须和固定格式一致 表头表体和时间的value必须添加双引号 totalAmount不带引号)
b.证书问题(证书如果带-----BEGIN CERTIFICATE与-----END CERTIFICATE独占一行 别跟在后面，影响验签结果。)
c.加签方式不对(js加签如果证书原文没问题一定可以过，不可以用法人卡要用操作员卡）
11.企业收不到海关请求数据
数据中心请求你们的Content-Type: application/x-www-form-urlencoded，端口默认 80
从请求中获取openReq参数的值，该参数值是一个符合json标准的字符串，
请求方式为POST,不是raw一个json字符串的方式
12.审核不通过
a.接口不通 企业收不到调取信息。
b.企业返回的不是:{"code":"10000","message":"","serviceTime":1567050097628}
c.企业三天内没有订单数据或者互联网+审核订单号与企业联系人管理栏,未填写订单号
d.端口不是80，是否配置白名单,不能用https,不能用ip,不能带端口号
13.关于展示网址itemLink字段取值问题
单独做一个web页面，app不可以，小程序不可以，样式无特别要求，显示商品图片，名称，售价等便可
14.关于收款账号recpAccount字段取值问题
是电商平台收款最终流入的银行卡号
15.收款企业名称recpName字段取值问题
就是电商平台企业名字的全称
对接的文档大部分是技术帖, 很少有能从业务和架构角度进行阐述的
本文旨在从业务与架构角度
先上图,有图有真相,注意版权保护
对接时有几个问题需要注意:
1.usbkey是硬件加签,windows驱动,这个无论如何是绕不开的
所以想放到linux上去的,是不现实的
2.放在远程服务器机房可不可以?
当然可以,但是维护起来麻烦,如果usbkey卡死了,还得找人重新拔插
3.我见过的几种实现方式?
有ws内网穿透的,有usb虚拟接口的,但要么是使用和维护成本太高,要么是技术难度有点大
要么是安全性不行,目前轮询是一个即经济有便利的实现方式
4.对本地服务器有何要求?
对机器本身没有太高要求,但是网络要稳定
机器的话,windowxp的都一样用
5.加签实现方式
有用浏览器+js的,有用go的,有用java的,有用php的,有用c#的,有用python的
各有优劣吧,但是感觉还是比较复杂,需要配置计划任务
