天猫国际平台代报关服务接入手册

更新时间：2023/01/03 访问次数：13780

一、背景概述
二、适用对象
三、报关方案
四、技术方案
五、说明

一、背景概述

《数据安全法》和《个人信息保护法》的相继出台，国家对于互联网平台的消费者个人信息安全及平台数据使用规范提出了更为明确的要求。基于合规标准，天猫国际平台（后简称“平台”）对平台开展的各类业务进行了全面排查，其中：部分商家采用委托第三方服务商进行跨境报关操作，过程中需要由平台提供报关需要的订单、支付单等信息，此模式存在较大的数据安全风险。

为了进一步落实相关政策，促进天猫国际业务的良性发展，平台将启动天猫国际商家跨境零售进口通关方案的全面升级：由平台官方授权跨境订单代报关平台，统一对平台订单进行消费者敏感信息加密、去标识化等安全技术措施处理后，对接海关报关系统进行订单申报处理。

二、适用对象

天猫国际平台全量商家（使用菜鸟服务进行报关的商家，将由菜鸟统一对接平台进行改造）。

三、报关方案

1.流程示意

2.流程概述

1）服务关系

a.由天猫国际平台委托平台跨境订单代报关平台服务商，并与代报关服务商签订平台数据授权及消费者信息保护协议。在平台订单及消费者信息加密、保护的基础上，由代报关服务商进行天猫国际平台海关申报订单的信息提供；

b.平台商家提前在平台注册委托报关服务商信息，在订单申报环节，将报关报文经由淘宝开放平台接口发送至天猫国际代报关平台，后由代报关平台对接海关提供报关材料后进行报关处理。

2）服务注册

a.代报关平台注册：商家向平台申请使用第三方报关服务商，并提交（线下）报关服务商基础资料信息进行服务绑定。基础资料主要包括加密机证书申请材料及DXPid（电商企业、物流企业、清关企业），申请材料模板及详细要求由代申报平台对接人与商家线下沟通告知。

b.淘宝开放平台注册：商家/报关服务商入驻淘宝开放平台（https://open.taobao.com/），申请API开发者账户及服务应用App Key；

需要商家授权，授权流程：点击查看；授权通过后，方可使用token操作商家订单；

3）服务使用

a.商家正常委托报关服务商发起订单申报（此过程平台将不提供/仅提供加密版的消费者信息，包含但不限于姓名、电话、地址、身份认证、平台账户名等信息），生成申报单；

b.商家/报关服务商调用淘宝开放平台推送商家申报订单报文，由平台代报关平台进行消费者信息解密及补充后，发送海关完成订单申报；

c.商家/报关服务商后续可通过淘宝开放平台，查询订单申报回执信息。

四、技术方案

天猫国际代申报平台包含两个接口：1.商家接入接口；2.回执接口。其中：

a.商家接入接口为商家提交申报必要信息，供天猫国际代申报平台进行海关申报的接口；

b.回执接口为商家查询天猫国际代申报平台及海关回执信息的接口。

具体接口字段说明：

a.商家接入接口字段

名称	参数类型	字段长度	是否必填	字段说明
表头字段(DeclareOrder)
operationType	String	C1	Y	推送类型，1-新增，2-变更。
orderNo	string	C..60	Y	申报订单号，交易平台的订单编号，同一交易平台的订单编号应唯一，订单编号长度不能超过60位。用于申报的订单号。如未拆单，则为唯一订单号；若拆单，则为子订单号。
isSplit	string	C1	N	拆单标志，仅当该参数传值为 T 或者 t 时，才会触发拆单(报关海关必须支持拆单)。
masterOrderNo	string	C..60	Y	主订单号。如未拆单，则为唯一的申报订单号；如拆单，则为主订单号。
orderSource	string	C..20	N	订单来源。如商家不填，则默认为天猫平台。目前只支持天猫平台的商家。
ebpCode	string	C..18	N	电商平台总署备案号，如商家不填，则系统默认为天猫平台。
ebpName	string	C..100	N	电商平台总署备案名称，如商家不填，则系统默认为天猫平台。
ebcCode	string	C..18	Y	电商企业总署备案号。
ebcName	string	C..100	Y	电商企业总署备案名称。
payCompanyType	String	C..10	N	支付企业，如商家不填，则系统默认为支付宝。
payCompanyCode	string	C..18	N	支付企业在海关备案编号，如商家不填，则系统默认为支付宝。
payCompanyName	string	C..100	N	支付企业在海关备案名称，如商家不填，则系统默认为支付宝。
goodsValue	string	N19,5	Y	订单商品总价，商品实际成交价，含非现金抵扣金额（即优惠前）。订单商品总价 = ∑(商品单价(优惠前)*商品数量)
postFee	double	N19,5	Y	运杂费，不包含在商品价格中，当前币种最小单位（分）。
coupon	double	N19,5	Y	订单优惠，使用积分、虚拟货币、代金券等非现金支付金额，无则填写"0"，当前币种最小单位（分）。
totalTax	double	N19,5	Y	订单综合税，企业预先代扣的税款金额，无则填写“0”，当前币种最小单位（分）。
actualpayment	double	N19,5	Y	订单买家实付金额，与支付凭证的支付金额一致，当前币种最小单位（分）。订单买家实付金额 = 订单完税价 + 订单综合税 - 订单优惠
openUid	string	C..60		淘宝开放平台会将商家传输的Open uid转化成买家id ，供关务系统调取申报必要信息。
OAID	string	C..60	Y	用于收货人信息解密（姓名/手机号/详细地址）。
country	string	C..200	Y	收货人所在国家。
province	string	C..200	Y	收货人所在省。
city	string	C..200	Y	收货人所在市。
district	string	C..200	Y	收货人所在区。
town	string	C..200	Y	收货人所在街道。
zipCode	string	C6	N	收货联系人邮编。
tmsCompanyCode	string	C..18	Y	物流企业总署备案号。
tmsCompanyName	string	C..100	Y	物流企业总署备案名称。
mailNo	string	C..60	Y	运单号。
billNo	string	C..37	N 9610必填	提运单号，9610必填。
insurance	double	N19,5	Y	订单保费，当前币种最小单位（分）。
grossWeight	double	N19,5	Y	毛重（公斤），货物及其包装材料的重量之和，计量单位为千克。
copNo	string	C..20	Y	企业内部编号，企业内部单证关联号。
assureCode	string	C..30	Y	担保企业编号，担保扣税的企业海关注册登记编号，只限清单的电商平台企业、电商企业、物流企业。
emsNo	string	C..30	N 1210必填	账册编号，1210必填。
customsCode	string	C4	Y	申报海关代码，接受清单申报的海关关区代码，参照JGS/T 18《海关关区代码》。
portCode	string	C4	Y	口岸海关代码，商品实际进出我国关境口岸海关的关区代码，参照JGS/T 18《海关关区代码》。
idDate	string	C8	N	进口日期，运载所申报商品的运输工具申报进境的日期，进口申报时无法确知相应的运输工具的实际进境日期时，免填。格式:YYYYMMDD。
agentCode	string	C..18	Y	申报企业总署备案号。
agentName	string	C..100	Y	申报企业总署备案名称。
areaCode	string	C..18	N 1210必填	区内企业（仓储企业）代码，1210模式必填。
areaName	string	C..100	N 1210必填	区内企业（仓储企业）名称，1210模式必填。
tradeMode	string	C4	Y	贸易方式，填写“9610”/“1210”。
trafMode	string	C1	Y	运输方式，填写海关标准的参数代码，参照《JGS-20 海关业务代码集》- 运输方式代码。9610指跨境段物流运输方式，1210指二线出区物流运输方式。
trafNo	string	C..100	N 9610必填	运输工具编号，9610必填。
voyageNo	string	C..32	N 9610必填	航班航次号，9610必填。
loctNo	string	C..10	N	监管场所代码，针对同一申报地海关下有多个跨境电子商务的监管场所，需要填写区分。
fromCountry	string	C3	Y	起运国，ISO国际标准，9610进口填写起始发出国家（地区）代码，参照《JGS-20 海关业务代码集》的国家（地区）代码表；1210填写代码“142”。
wrapType	string	C1	N	包装种类代码，海关对进出口货物实际采用的外部包装方式的标识代码，采用1 位数字表示，如：木箱、纸箱、桶装、散装、托盘、包、油罐车等。
netWeight	double	N19,5	Y	净重（公斤），货物的毛重减去外包装材料后的重量，即货物本身的实际重量，计量单位为千克。
currency	string	C3	N	币制，如商家不填，则系统默认为人名币"142"。
表体字段(DeclareGoods)
itemNo	string	C..30	N 1210必填	企业商品货号，料号，1210必填。
itemName	string	C..250	Y	商品名称。
barCode	string	C..50	Y	条码，商品条码一般由前缀部分、制造厂商代码、商品代码和校验码组成。
unit	string	C3	Y	申报计量单位。
qty	double	N19,5	Y	商品数量。
price	double	N19,5	Y	商品单价(优惠前)，当前币种最小单位（分）。
totalPrice	double	N19,5	Y	商品总价，商品单价(优惠前)*商品数量。
productCountry	string	C3	Y	原产国，ISO国际标准。
itemRecordNo	string	C..30	N 1210必填	金二序号，1210必填。
gcode	string	C10	Y	HSCODE。
gmodel	string	C..250	Y	商品规格型号，满足海关归类、审价以及监管的要求为准。包括：品牌、规格、型号等。
unit1	string	C3	Y	法定计量单位。
unit2	string	C3	N	第二计量单位，如有。
qty1	double	N19,5	Y	法定数量。
qty2	double	N19,5	N	第二数量，如有。
goodsCustomsTax	double	N19,5	Y	商品关税。
goodsConsumptionTax	double	N19,5	Y	商品消费税。
goodsVAT	double	N19,5	Y	商品增值税。
goodsTotalTax	double	N19,5	Y	商品综合税。

b.回执接口字段

中文名称	英文名称	参数类型	字段长度	是否必填	字段说明
表头字段（InvtReturn)
订单编号	orderNo	string	c60	Y	企业传入的订单编号
预录入编号	preNo	string	c20	N	电子口岸标识单证的编号
清单编号	invtNo	string	c30	N	海关审核反馈的清单编号
平台状态码	status	string	c20	Y	代申报平台定义的标准状态
平台状态描述	desc	string	c500	N	平台状态码对应的状态描述
订单综合税	totalTax	double	N19,5	N	海关返回的综合税
补充字段	feature	string	c1000	N	补充说明的内容
表体字段(CustomsStatus)
海关状态	customsStatus	string	c20	N	海关回执的状态
海关状态描述	customsStatusDesc	string	c500	N	海关回执状态的描述
海关状态时间	customsStatusTime	string	c18	N	海关回执状态的时间格式：yyyy-MM-dd HH:mm:ss

c.平台状态码汇总

平台状态码	状态名称	状态描述
DECLARE_FAILED	申报失败	1）商家seller id不在白名单中；2）该口岸暂不支持申报；3）XXXX必填字段未填。
DECLARING	申报中	平台已推送三单（订单/支付单/运单），但未推送清单。
DECLARE_SUCCESS	已申报	平台成功推送清单。

d.海关状态汇总

海关状态	状态描述
1	电子口岸已暂存
2	电子口岸申报中
3	发送海关成功
4	发送海关失败
100	海关退单
120	海关入库
300	人工审核
400	待运抵
800	放行
500	查验
600	挂起
700	退运

五、说明

升级时间：2021年9月26日-10月15日。

改造答疑钉钉群：35743245。

FAQ

关于此文档暂时还没有FAQ

有用(0) 我要提问