说明

1. 备案信息

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

备案公司名称：杭州起码科技有限公司

海关备案号：3301961H10

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

备案公司名称：北京高汇通商业管理有限公司

海关备案号：1105961K9C

2. 支付方式

1）根据国家海关总署发布的 179 号公告要求，有赞微商城将完成“支付数据”与海关的打通，但仅限于微信支付代销模式的跨境业务商家。

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

3. 已开放口岸列表

省份 / 城市	对接关口	有赞编号	备注
郑州	郑州新郑综合保税区	ZZ
宁波	宁波栎社报税物流中心	NB
	宁波北仑	NN
江苏	太仓	TC
福建	福州江阴保税港、平潭	FZ	接受海关总署版
杭州	钱江海关驻下沙办事处	HZ
重庆	重庆	CQ
北京	北京	BJ
广州	广州白云	GZ
	广州黄埔	GH
	广州南沙	GN
成都	成都	CD

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

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

开发者对接流程图

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

订单报文：商家自己推送

运单报文：商家自己推送

一、店铺授权

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

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

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

二、创建应用 & 换取 token

1. 自用型应用

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

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

**

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://diy.youzanyun.com/doc/3496

四、海关申报

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）

货值，税费：商家自己根据 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 列表

| 接口名称 | 接口描述 | 文档地址 |

| youzan.trade.get | 交易订单详情 4.0 接口 | 查看文档 |

| youzan.trades.sold.get | 订单列表 4.0 接口 | 查看文档 |

| youzan.pay.customs.declaration.reportpayment.report | 支付报文推送接口 | 查看文档 |

| youzan.pay.customs.declaration.reportpayment.query | 报关状态查询 | 查看文档 |

| youzan.logistics.online.confirm | 卖家确认发货 | 查看文档 |

五、常见问题

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

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

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

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

Q: 一个订单洗可以同时存在 BBC\BC 两种业务吗？如何申报？

A: 首先拆单存在两种情况：1. 多个口岸 2. 多种跨境模式 ；一个订单下可以同时存在 BBC、BC 业务，即一个订单就会有多个不同的 sub_order_no，那么就需要拆单申报；

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

A:

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

标识：is_cross_border 是否是跨境海淘订单 (“1”: 是,“0”/‘‘null’’: 否)

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

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

3. 取 fx_order_no 作为 tid

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

注：拆单的情况另外判断