说明

1.备案信息

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

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

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

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

2.支付方式

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

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

3.已开放口岸列表

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

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

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

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

订单报文：商家自己推送

运单报文：商家自己推送

一、店铺授权

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列表

接口名称	接口描述	文档地址
youzan.trade.get	交易订单详情4.0接口	查看文档：https://open.youzan.com/v3/apicenter/doc-api-main/1/2/trade/youzan.trade.get
youzan.trades.sold.get	订单列表4.0接口	查看文档：https://open.youzan.com/v3/apicenter/doc-api-main/1/2/trade/youzan.trades.sold.get
youzan.pay.customs.declaration.reportpayment.report	支付报文推送接口	查看文档：https://open.youzan.com/v3/apicenter/doc-api-main/1/2/pay-customs-declaration/youzan.pay.customs.declaration.reportpayment.report
youzan.pay.customs.declaration.reportpayment.query	报关状态查询	查看文档：https://open.youzan.com/v3/apicenter/doc-api-main/1/2/pay-customs-declaration/youzan.pay.customs.declaration.reportpayment.query
youzan.logistics.online.confirm	卖家确认发货	查看文档：https://open.youzan.com/v3/apicenter/doc-api-main/1/2/trade-delivery/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"/空:否)

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

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

3.取fx_order_no 作为tid

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

注：拆单的情况另外判断

版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 yubaibai360@qq.com 举报，一经查实，本站将立刻删除。