IYUU.net

主题

海关179加签上报 ​

API接入点 ​

POST /api/customs179

请求格式 ​

json
{
  "sessionId": "海关请求会话ID",
  "payExchangeInfoHead": {
    "guid": "企业系统生成36位唯一序号",
    "initalRequest": "<xml><openid><![CDATA[o9dVx7XxxxxxxxxxxxkoSFiHdto]]></openid><out_trade_no><![CDATA[cp477912536700682240]]></out_trade_no><total_fee>14364</total_fee><attach><![CDATA[product]]></attach><body><![CDATA[BioSkin 赋活奇....]]></body><trade_type><![CDATA[JSAPI]]></trade_type><notify_url><![CDATA[https://iyuu.cn/api/pay/notify/routine]]></notify_url><spbill_create_ip><![CDATA[27.148.85.253]]></spbill_create_ip><appid><![CDATA[wxff7dxxxxx9f857]]></appid><mch_id>1695916000</mch_id><nonce_str><![CDATA[6899cbbe0592c]]></nonce_str><sign><![CDATA[CA932F8245FBC44195A2C89B98039F9A]]></sign></xml>",
    "initalResponse": "ok",
    "ebpCode": "电商平台代码",
    "payCode": "4403169D3W",
    "payTransactionId": "4200002754202508110844258623",
    "totalAmount": 143.64,
    "currency": "142",
    "verDept": "3",
    "payType": "4",
    "tradingTime": "20250811185359",
    "note": "备注"
  },
  "payExchangeInfoLists": [
    {
      "orderNo": "cp477912536700682240",
      "goodsInfo": [
        {
          "gname": "BioSkin 赋活奇肌全方位洗卸慕斯150mL",
          "itemLink": "https://iyuu.cn/pages/goods_details/index?id=8"
        }
      ],
      "recpAccount": "收款账号",
      "recpCode": "收款企业代码",
      "recpName": "跨境电子商务有限公司"
    }
  ],
  "serviceTime": 1756571640000,
  "realTimeDataUpload": true
}

响应格式 ​

成功响应 ​

json
{
  "sessionID": "海关请求会话ID",
  "serviceTime": 1756571640000,
  "guid": "e786bcca-2718-4af9-966d-3d8ac7cc29bf",
  "certNo": "0328cebb",
  "signValue": "f4OyKF6ekhWpf4g6+cDNZutbPUgsbsicMFn5+wM0tQ/JJQ9xMtuj5boifekb/doFOnPt2XjlqpiYaMBe6GTVFA==",
  "customs": {
    "code": "1000",
    "message": "上传成功",
    "serviceTime": 1758686018452,
    "total": 0
  },
  "success": true
}

错误响应 ​

json
{
  "sessionID": "123456",
  "serviceTime": 1756571640000,
  "guid": "e786bcca-2718-4af9-966d-3d8ac7cc29bf",
  "certNo": "0328cebb",
  "signValue": "f4OyKF6ekhWpf4g6+cDNZutbPUgsbsicMFn5+wM0tQ/JJQ9xMtuj5boifekb/doFOnPt2XjlqpiYaMBe6GTVFA==",
  "customs": {
    "code": "20004",
    "message": "企业实时数据获取验签证书未在服务系统注册",
    "serviceTime": 1758686018452,
    "total": 0
  },
  "success": true
}
json
{
  "sessionID": "123456",
  "serviceTime": 1756571640000,
  "guid": "e786bcca-2718-4af9-966d-3d8ac7cc29bf",
  "certNo": "0328cebb",
  "signValue": "f4OyKF6ekhWpf4g6+cDNZutbPUgsbsicMFn5+wM0tQ/JJQ9xMtuj5boifekb/doFOnPt2XjlqpiYaMBe6GTVFA==",
  "customs": {
    "code": "20005",
    "message": "验签失败",
    "serviceTime": 1758686018452,
    "total": 0
  },
  "success": true
}
json
{
  "sessionID": "123456",
  "serviceTime": 1756571640000,
  "guid": "e786bcca-2718-4af9-966d-3d8ac7cc29bf",
  "certNo": "0328cebb",
  "signValue": "f4OyKF6ekhWpf4g6+cDNZutbPUgsbsicMFn5+wM0tQ/JJQ9xMtuj5boifekb/doFOnPt2XjlqpiYaMBe6GTVFA==",
  "customs": {
    "code": "20006",
    "message": "上传失败,入库失败: 唯一标识sessionID重复",
    "serviceTime": 1758686018452,
    "total": 0
  },
  "success": true
}

示例 API 调用 ​

bash
curl -X POST http://127.0.0.1:8780/api/customs179 \
  -H "Content-Type: application/json" \
  -d '{
    "sessionId": "海关请求会话ID",
    "payExchangeInfoHead": {"guid":"企业系统生成36位唯一序号","initalRequest":"<xml><openid><![CDATA[o9dVx7XxxxxxxxxxxxkoSFiHdto]]></openid><out_trade_no><![CDATA[cp477912536700682240]]></out_trade_no><total_fee>14364</total_fee><attach><![CDATA[product]]></attach><body><![CDATA[BioSkin 赋活奇....]]></body><trade_type><![CDATA[JSAPI]]></trade_type><notify_url><![CDATA[https://iyuu.cn/api/pay/notify/routine]]></notify_url><spbill_create_ip><![CDATA[27.148.85.253]]></spbill_create_ip><appid><![CDATA[wxff7ddexxxxxxxx]]></appid><mch_id>1695916000</mch_id><nonce_str><![CDATA[6899cbbe0592c]]></nonce_str><sign><![CDATA[CA932F8245FBC44195A2C89B98039F9A]]></sign></xml>","initalResponse":"ok","ebpCode":"电商平台代码","payCode":"4403169D3W","payTransactionId":"4200002754202508110844258623","totalAmount":143.64,"currency":"142","verDept":"3","payType":"4","tradingTime":"20250811185359","note":"备注"},
    "payExchangeInfoLists": [{"orderNo":"cp477912536700682240","goodsInfo":[{"gname":"BioSkin 赋活奇肌全方位洗卸慕斯150mL","itemLink":"https://iyuu.cn/pages/goods_details/index?id=8"}],"recpAccount":"收款账号","recpCode":"收款企业代码","recpName":"跨境电子商务有限公司"}],
    "serviceTime": 1756571640000,
    "realTimeDataUpload": true
  }'