Code Monkey home page Code Monkey logo

customsreport's Introduction

海关上报支付数据

技术栈

  • net461
  • Topshelf
  • Newtonsoft.Json

避坑指南

官方文档

海关总署公告2018年第165号(关于实时获取跨境电子商务平台企业支付相关原始数据有关事宜的公告)

海关总署公告2018年第179号(关于实时获取跨境电子商务平台企业支付相关原始数据接入有关事宜的公告)

**电子口岸客户端控件

附件3:电子口岸安全组件及使用手册 提取码:cmm5

对接流程

企业返回实时数据接口(部署在通关服务系统)

进行加签之前的报文

"sessionID":"fe2374-8fnejf97-55616242"||"payExchangeInfoHead":"{"guid":"9D55BA71-55DE-41F4-8B50-C36C83B3B419","initalRequest":"https://openapi.alipay.com/gateway.do?timestamp=2013-01-0108:08:08&method=alipay.trade.pay&app_id=13580&sign_type=RSA2&sign=ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE&version=1.0&charset=GBK","initalResponse":"ok","ebpCode":"3301963K69","payCode":"312226T001","payTransactionId":"2018121222001354081010726129","totalAmount":100,"currency":"142","verDept":"3","payType":"1","tradingTime":"20181212041803","note":"批量订单,测试订单优化,生成多个so订单"}"||"payExchangeInfoLists":"[{"orderNo":"SO1710301150602574003","goodsInfo":[{"gname":"lhy-gnsku3","itemLink":"http://m.yunjiweidian.com/yunjibuyer/static/vue-buyer/idc/index.html#/detail?itemId=999761&shopId=453"},{"gname":"lhy-gnsku2","itemLink":"http://m.yunjiweidian.com/yunjibuyer/static/vue-buyer/idc/index.html#/detail?itemId=999760&shopId=453"}],"recpAccount":"OSA571908863132601","recpCode":"","recpName":"YUNJIHONGKONGLIMITED"}]"||"serviceTime":"1544519952469"

上传给海关的报文

{"sessionID":"fe2374-8fnejf97-55616242","payExchangeInfoHead":{"guid":"9D55BA71-55DE-41F4-8B50-C36C83B3B419","initalRequest":"https://openapi.alipay.com/gateway.do?timestamp=2013-01-0108:08:08&method=alipay.trade.pay&app_id=13580&sign_type=RSA2&sign=ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE&version=1.0&charset=GBK","initalResponse":"ok","ebpCode":"3301963K69","payCode":"312226T001","payTransactionId":"2018121222001354081010726129","totalAmount":100,"currency":"142","verDept":"3","payType":"1","tradingTime":"20181212041803","note":"批量订单,测试订单优化,生成多个so订单"},"payExchangeInfoLists":[{"orderNo":"SO1710301150602574003","goodsInfo":[{"gname":"lhy-gnsku3","itemLink":"http://m.yunjiweidian.com/yunjibuyer/static/vue-buyer/idc/index.html#/detail?itemId=999761&shopId=453"},{"gname":"lhy-gnsku2","itemLink":"http://m.yunjiweidian.com/yunjibuyer/static/vue-buyer/idc/index.html#/detail?itemId=999760&shopId=453"}],"recpAccount":"OSA571908863132601","recpCode":"","recpName":"YUNJIHONGKONGLIMITED"}],"serviceTime":"1544519952469","certNo":"01010000000019f1","signValue":"J1shnr986MzgvwOBIMD0QMpkTTTARsGgwM9RkRAAmZOWA1ZAi8KNR+h5WtqXy6qdiW9KTfLyx9kgseWX/udghOOMVJrYlGelhwg26L7bq5gj72AU40zXq69bNoOgH/ccSQzHFRvbGug2gJ4Pv8dSNVVY8rFzX+8AMNnHTdIWo74="}

深坑 报文特殊之处

  1. guid 的值必须为大写字母

  2. totalAmount 的值 零尾巴截掉,而且不能带双引号。

    错误格式 正确格式
    100.0 100
    100.10 100.1
  3. 加签字符串形式: 注意格式 字段顺序 二级字段顺序 必须和固定格式一致 表头表体和时间的value必须添加双引号,totalAmount不带引号

  4. 报文中的 certNoebpCode 需要替换为 自己企业的对应信息

    certNo 、ebpCode 不对应,错误提示:企业实时数据获取验签证书未在服务系统注册的

  5. 报文中的 sessionID,来自于海关请求电商平台接口的 sessionID ,如果每次请求的 sessionID 相同,错误提示:上传失败,入库失败

    起码走到这一步,证明验签问题解决了

上报海关请求报文的请求形式

HTTP POST 请求,Content-Type: application/x-www-form-urlencoded

加签方法

  1. 咨询当地【跨境电商公共服务平台】是否能辅助加签。
  2. 本地加签方式

官方提供的加签为JS + WebStocket示例,这种方式比较绕,需要定期轮询待加签的列表。

建议下 使用COM组件的形式,可以以同步的方式上报数据,结构比较清晰,示例代码

企业实时数据获取接口(部署在电商平台)

深坑 海关请求方式

  1. 海关请求方式HTTP POST请求, Content-Type: application/x-www-form-urlencoded

    企业直接获取openReq参数即可 openReq={"sessionID":"fe2374-8fnejf97-55616242","orderNo":"XXXX","serviceTime":"1544519952469"}

  2. 接口端口必须是80端口

  3. 必须成功响应数据

    {"code":"10000","message":"XXXX","serviceTime":"1544519952469"}

  4. 审核数据为近三天订单数据

  5. 通关系统注册接口地址 互联网+海关

    访问注册地址,需要插入操作人IC卡
    证书注册时,需要注意证书编号,一定要小写

customsreport's People

Contributors

cooperliu avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.