有赞云跨境电商对接指南

小提示：您能找到这篇{有赞云跨境电商对接指南}绝对不是偶然，我们能帮您找到潜在客户，解决您的困扰。如果您对本页介绍的有赞云跨境电商对接指南内容感兴趣，有相关需求意向欢迎拨打我们的服务热线，或留言咨询，我们将第一时间联系您！

说明

1.备案信息

有赞作为电商平台责任主体，备案信息如下：

备案公司名称：杭州起码科技有限公司海关备案号：3301961H10

有赞作为支付企业（高汇通作为支付企业责任主体），备案信息如下：

备案公司名称：北京高汇通商业管理有限公司海关备案号：1105961K9C

2.支付方式

1）根据国家海关总署发布的179号公告要求，有赞微商城将完成“支付数据”与海关的打通，包含微信支付代销、支付宝、银行卡等支付方式的原始数据都会提供给海关。

2）微信支付自有模式在“支付数据”打通海关的环节更复杂，难度更大，目前暂无法支持。为避免不合规经营带来的风险，我们特别敦促此类商家在3月30日前将网络营销人支付方式切换至微信支付代销。

3.已开放口岸列表

后续备案口岸暂定为：上海、青岛，西安，天津、深圳、大连

预计备案完成时间：待定。（时间不由我方把控，时间仅作为参考）

支付报文：需要开发者主动调用有赞“支付跨境报关接口”

订单报文：商家自己推送

运单报文：商家自己推送

一、店铺授权

1.跨境商家店铺必须先授权“有赞官方支付报关”https://app.youzanyun.com/detail/39315

2.点击“前往购买”登录店铺账号进行授权，授权成功关闭授权页面即可。

3.注意：商家可以自行访问授权，服务商请引导您的商家对该应用进行授权。

二、创建应用&换取token

1.自用型应用

1）自用型应用：您是一个商家或店主，只有一个微商城店铺，给自己公司使用选择创建自用型。

2）自用型应用创建&获取token：https://open.youzan.com/v3/apicenter/doc-api-main/1/1/4369

**

2.工具型应用

1）工具型应用：您是一个服务商，为多家有赞微商城商户提供服务，选择创建工具型。

2）工具型应用创建&获取token：https://diy.youzanyun.com/doc/3458

3）如果原来在开放平台注册过应用的，需要一键迁移的，请参考工具型无容器迁移指南：

https://diy.youzanyun.com/doc/3517

三、权限申请&SDK下载

1.支付报文接口权限申请

1）调用接口前必须先申请“支付报文推送”接口权限

2）申请API接口权限说明：https://bbs.youzan.com/thread-671826-1-1.html

2.SDK下载

SDK下载地址：https://open.youzan.com/docs/guide/3399/3411

四、海关申报

1.支付报文申报规则

1）跨境的正常订单

1.1）参数取值规则

取值按照参数名直接取值即可。

非拆单：支付报文一定要使用“tid”字段值进行推送。

拆单：支付报文一定要使用“tid+sub_order_no”字段值进行推送。

1.2）支付报关金额取值请使用订单接口的full_order_info.orders.payment

1.3）使用full_order_info.pay_info.transaction作为有赞支付流水号

2）跨境的分销订单

2.1）参数取值规则

非拆单：支付报文一定要使用fx_order_no作为“tid”，fx_inner_transaction_no作为transaction进行推送。

拆单：支付报文一定要使用fx_order_no作为“tid”，fx_inner_transaction_no作为transaction、sub_order_no作为sub_order_no字段值进行推送。

2.2）支付报关金额取值请使用订单接口的full_order_info.orders.fenxiao_payment

2.3) ktd_id取值fx_kdt_id

2.订单报文申报规则

订单报文推送订单信息订单号使用sub_order_no字段(不论是否拆单，重点注意) ，包邮包税，税需要自己计算。

正常订单

1）货值+税费+运费=用户实际支付金额（full_order_info.orders.payment）+优惠券（full_order_info.orders.total_fee-full_order_info.orders.payment）

2）货值，税费：商家自己根据total_fee，商品税率进行计算。

3）运费：因为运费也要征税，为方便计算运费都为0。

4）支付金额：取每一个商品的full_order_info.orders.payment累加。

5) 优惠金额：取每一个商品的(full_order_info.orders.total_fee-full_order_info.orders.payment)累加。

分销订单(分销订单是以供货商授权进行订单推送)

1）货值+税费+运费=支付金额（full_order_info.orders.fenxiao_payment）+优惠券（full_order_info.orders.fenxiao_price-full_order_info.orders.fenxiao_payment）

2）货值，税费：商家自己根据fenxiao_price，商品税率进行计算。

3）运费：因为运费也要征税，为方便计算运费都为0。

4）支付金额：取每一个商品的full_order_info.orders.fenxiao_payment累加。

5) 优惠金额：取每一个商品的(full_order_info.orders.fenxiao_price-full_order_info.orders.fenxiao_payment)累加。

3.特殊声明规则

1）有赞是按照口岸进行拆单，所以一笔订单中如果有多个口岸商品，则要调用多次支付报关接口分开申报。

2）最好一个商家选择一个服务商进行报关，否则会出现一笔订单被多个服务商处理，需要线下协调。

4.订单发货

1）调用有赞确认发货接口对订单进行发货。

注意：如果订单有多个口岸，服务商只需更新自己的发货信息。

5.接口API列表

五、常见问题

Q:如何判断订单是否拆单?

A：根据orders>sub_order_no字段来判断是否有拆单，遍历的orders取出 sub_order_no，加入set中去重，然后判断 set.size 是否大于1。如果大于1表示需要拆单。

Q：如何判断一笔订单中哪些是海淘订单那些是普通订单?

A:普通商品和海淘商品不支持一起下单。

Q:一个订单下可以同时存在BBCBC两种业务吗？如何申报？

A:首先拆单存在两种情况：1.多个口岸 2.多种跨境模式 ；

因此一个订单下可以同时存在BBC、BC业务，即会有多个sub_order_no，申报的时候分开申报；

Q:以供货商为主体推单，如何判断某笔订单是海淘分销订单并推送支付报文？

A:

1.判断是否是海淘订单？

标识：is_cross_border 是否是跨境海淘订单("1":是,"0"/空:否)

2.判断是否是分销订单？

标识：is_purchase_order 是否采购单（true）

3.取fx_order_no 作为tid

4.取fx_inner_transaction_no作为有赞支付流水号

注：拆单的情况另外判断