A方案对接指引

提示

根据公开数据，是中国境内对接耗时最短、性能稳定、开发成本最低的方案。

微信扫码登录

用户中心 点击 “微信扫码登录” 按钮，使用微信扫一扫，完成登录。

创建应用

1. 进入 用户中心，点击 左侧菜单 中国海关 > 客户端控件 ，进入 应用管理 页面；
2. 点击 创建应用 按钮，填写 中国电子口岸卡口令 ，并点击 确定 按钮；
3. 刚才创建的 中国海关 应用，点击 其他 > 下载客户端 按钮，下载 中国电子口岸代理 客户端；
4. 下载成功后，解压，并运行 IYUUProxy.exe 文件，完成初始化。
5. 把 IYUUProxy.exe 添加到 启动项 中，方便 开机启动。

Windows 11 如何设置开机启动

1. 按 Windows + R键，输入 shell:startup 后，点击确定，打开 启动文件夹
2. 创建一个 快捷方式，指向 IYUUProxy.exe
3. 把 快捷方式 拖到 启动文件夹

开发企业实时数据获取接口

服务定义：platDataOpen，跨境电商企业 在中国国际贸易单一窗口 注册 证书 和 数据抓取接口。

该接口部署在电商平台，企业接收海关发起的支付相关实时数据获取请求。

• 请求方法：POST
• Content-Type：application/x-www-form-urlencoded; charset=utf-8
• 调用方：海关

接口请求参数

请求Body参数

openReq={"orderNo":"申报订单的订单编号","sessionID": "海关会话ID", "serviceTime":毫秒时间戳}

{
  "orderNo": "申报订单的订单编号",
  "sessionID": "海关回话ID",
  "serviceTime": 1533271903898
}

参数说明

参数名	类型	必填	说明
orderNo	String	Y	申报订单的订单编号
sessionID	String	Y	海关发起请求时，平台接收的会话ID。
serviceTime	Long	Y	调用时的系统毫秒时间戳

接口响应参数

返回Json格式数据

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

参数说明

属性	类型	说明
code	String	状态代号。10000为正常调用值。
message	String	异常信息，正常时为空值
serviceTime	Long	系统响应时间

179加签后实时上报海关API接口

• 接口地址：https://iyuu.net/app/customs/api/realTimeDataUpload
• 请求方法：POST
• Content-Type：application/json; charset=utf-8
• 调用方：电商平台

请求Header参数

参数名	类型	必填	说明
Authorization	String	Y	请求验证参数

示例值：Authorization: app_id=应用ID&timestamp=秒时间戳&signature=签名值

bodyString 表示请求Body参数的JSON字符串。

signature 签名算法：md5(app_id + app_secret + timestamp + bodyString)。

请求Body参数

参数名	类型	必填	说明
orderNo	String	Y	申报订单的订单编号
sessionID	String	Y	海关发起请求时，平台接收的会话ID
serviceTime	Long	Y	调用时的系统毫秒时间戳
payExchangeInfoHead	Object	Y	支付原始数据表头
payExchangeInfoList	List	Y	支付原始数据表体

响应参数示例

{
  "code": 0,
  "data": {
    "signValue": "yAJa3X1tgznOeTLEvNIzAXGvu4AADqTtCLQYlsQQK9ZNt1NW5Uv25H35rLeHeHJ+h7/fWSbdO1ZCsICCaBWdyg==",
    "certNo": "00027ceb",
    "upload_status": "PUSH_ERROR",
    "upload_result": {
      "code": "20006",
      "message": "上传失败,入库失败: 唯一标识sessionID重复",
      "total": 0,
      "serviceTime": 1764338410355
    }
  },
  "msg": "ok"
}