淘宝开放平台

登录
文档中心 > 商家经营工具-开发指引

商家经营工具-开发指引

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

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

一、背景概述


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

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


二、适用对象


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


三、报关方案

1.流程示意


001.png


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) 我要提问
返回
顶部