跨境商城项目对接流程总结

简介

自去年年末开始公司与另外一个做跨境电商的公司合作，开始做一个b2c的跨境商城小程序。主要需求就是从供应链商品提供仓库对接，通过三单对碰的形式进实现用户购买保税仓内商品的功能。

工作内容：

1. 上架商品，推送订单等接口：第e仓，行云货仓
2. 支付，报关接口：合利宝
3. 商城底座：crmeb单商户版
4. 海关179号公文轮询

基本流程

购买保税仓的商品，海关会检查三单：

1. 购物订单
2. 物流订单
3. 支付订单

就按照需要去完成传递信息就 ok。

第一步：选品上架

正常商城流程一样，新增商品，通过供货商提供的接口，这里有两种：

1. 提供接口给供应商商城，在他们的商城中一键上架
   
2. 调用供应商接口获取商城列表，在自己内部构建列表选品上架
   

第二步：接收调价下架提醒

通常商品库存或者价格变动，以及订单状态的变化都需要我们提供给供应商相应的接口，来通知到我们的商城，以让商城实现商品相关的调整，可以在为商城直接添加一个对应供货商的消息通知模块

ps:可以保留一下通知的原始报文，在后面的问题排查中会起到帮助作用

第三步：购买商品时计算相应的税费和运费

税率

税率也有两种方式

1. 固定税率
   在购买商品固定税率通常是0.091，在商品采集时就确定下来。
2. 浮动税率
   浮动税率是以一个消费基准为界定线，超过多少金额后整体采用高额税率，在商品下单时确定下来。
   

运费

运费也有两种形式

1. 包邮
   供货商包邮或者提供的价格是包含运费的价格，那就很简单，只需要进行加价处理就可以直接下单。
2. 不包邮
   需要根据用户的收货地址，动态获取订单的运费最后加至订单价格中，需要单独展示运费信息。

第四步：支付订单报关

在购买商品过后，需要提供给供货商相关支付信息，并且需要进行海关的支付报关操作，在对接时需要用到 sha256，AES加密两种加密方式。
合利宝开放平台: 合利宝开放平台

第五步：海关轮询

说简单些就是接受海关抽查，在海关请求我们相关接口时，返回组装他所需要的信息。
硬件需求： 一台关闭防火墙的电脑终端服务器，24小时开机接受轮询检查。
核心部分： 采用了ws连接，websocket 即时通讯进行获取 ukey 操作员卡进行加签操作，拼装相关信息。

注意事项

整理一些在推进项目时遇到的一些注意事项

接口对接：验签

常用的基本上都是需要验签信息字段拼接之后采用MD5，sha256，AES等加密方式，仔细阅读文档很重要，基本上都是需要JSONString格式进行拼接加签。

海关轮询：验签

1. 需要先安装海关控件：中国电子口岸

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

3. 审核不通过的原因：企业收到调用返回的不是10000，企业三天内没有订单数据或未上传审核订单号，端口需要80，需要卡介质登陆

4. 企业可以在页面上传专供审核用的虚拟订单编号，此订单号可以解决：企业接口审核没有订单数据问题。

5. payExchangeInfoList 应该为 payExchangeInfoLists

6. serviceTime 的类型是string，不是long，用long验签过不去

7. totalAmount 的value值去掉双引号“”

8. 上传数据的sessionid 必须和请求的sessionid保持一致

一些问题

现在跨境购买商评最大的问题在于订单拆单以及不同仓库不能同时下单的限制，因为拆单后支付单没有拆分，海关清关清不掉，希望有解决方案的大佬指教指教

经验总结

经过本次跨境商城的开发，发现和普通商城比较还是复杂了挺多，碰到了很多以前没有的加签解签的问题，收获很多，对整个跨境商城流程也熟悉了很多。总之还是有很多需要学习的地方