跨境电商已成为当下的热点,在制作商城以及后台时,与以往不同的是,跨境商品与国内的商品需要分开处理,
跨境商品需要先向海关报关(清关),然后由第三方公司负责把商品邮寄给购买的客户。
本文主要内容就是如何把跨境商品向海关报关,其中碰到的一些技术细节进行说明,只提供参考,
以宁波跨境贸易平台为例,
在企业在该平台申请备案后,可以获取接口说明,其中最主要的就是报文头部、进口订单部分,
参数名称 | 说明 | 类型 | 是否必填 | ||||||||||||||||||||||||||
userid | 账号 | String | 是 | ||||||||||||||||||||||||||
timestamp | URLEncoder.encode(当前时间(格式:yyyy-MM-dd HH:mm:ss), utf-8) 以2016-06-16 10:16:00为例,编码后为2016-06-16+10%3A16%3A00,文档中使用的java语法, 在php中可以用字符串替换 | String | 是 | ||||||||||||||||||||||||||
后的字符串,当前时间前后20分中内都有效 | |||||||||||||||||||||||||||||
sign | MD5.encode(userid + 密码 + timestamp) php中的md5函数自带的 | String | 是 | ||||||||||||||||||||||||||
1)密码(此密码为服务申请时产生的密钥,非平台登录密码) | |||||||||||||||||||||||||||||
2)各参数为原文(URLEncoder.encode之前) | |||||||||||||||||||||||||||||
xmlstr | xml头部以<?xml version="1.0" encoding="UTF-8" ?>申明 | String | 是 | ||||||||||||||||||||||||||
详见各sheet定义的格式说明 | |||||||||||||||||||||||||||||
需URLEncoder.encode | |||||||||||||||||||||||||||||
msgtype | 消息类型 | String | 是 | ||||||||||||||||||||||||||
customs | 关区代码 | String | 是 | ||||||||||||||||||||||||||
北仑保税区:3105 | |||||||||||||||||||||||||||||
空港保税物流中心:3115 | |||||||||||||||||||||||||||||
栎社机场:3109 | |||||||||||||||||||||||||||||
梅山保税区:3117 |
进口订单申报说明
2.报文类型(msgType) | ||||||||||||||||||||||||||
msgType | ||||||||||||||||||||||||||
cnec_jh_order | ||||||||||||||||||||||||||
3.xmlstr参数内容格式 | ||||||||||||||||||||||||||
字段名称 | 字段类型 | 是否必需 | 说明 | |||||||||||||||||||||||
<Message> | ||||||||||||||||||||||||||
<Header> | ||||||||||||||||||||||||||
<CustomsCode> | VARCHAR2(10) | 是 | 电商企业代码 在平台注册时有企业代码以及店铺代码,需区分 | |||||||||||||||||||||||
<OrgName> | VARCHAR2(200) | 是 | 电商企业名称 | |||||||||||||||||||||||
<CreateTime> | Date | 是 | 订单创建时间(yyyy-MM-dd HH:mm:ss)(必须是消费者真实下单时间) | |||||||||||||||||||||||
</Header> | ||||||||||||||||||||||||||
<Body> | ||||||||||||||||||||||||||
<Order> | ||||||||||||||||||||||||||
<Operation> | VARCHAR2(2) | 是 | 操作标识(0=新增,1=更新) | |||||||||||||||||||||||
<MftNo> | VARCHAR2(20) | *否 | 申报单号,更新场合时为必填 | |||||||||||||||||||||||
<OrderShop> | VARCHAR2(5) | 是 | 店铺代码 有专门的店铺备案,在《电商店铺备案管理》菜单中 | |||||||||||||||||||||||
<OTOCode> | VARCHAR2(5) | 否 | OTO店铺代码 | |||||||||||||||||||||||
<OrderFrom> | VARCHAR2(10) | 是 | 购物网站代码 在购物网站申请中 | |||||||||||||||||||||||
<PackageFlag> | VARCHAR2(2) | 否 | 是否组合装标识(0=不是,1=是) | |||||||||||||||||||||||
<OrderNo> | VARCHAR2(30) | 是 | 订单号 商城的订单号即可 | |||||||||||||||||||||||
<PostFee> | NUMBER (19,3) | 是 | 运费(无运费时请设置0) | |||||||||||||||||||||||
<InsuranceFee> | NUMBER (19,3) | 否 | 保价费(无保价费时自动设置为0) | |||||||||||||||||||||||
<Amount> | NUMBER (19,3) | 是 | 买家实付金额 | |||||||||||||||||||||||
<BuyerAccount> | VARCHAR2(200) | 是 | 购物网站买家账号 | |||||||||||||||||||||||
<Phone> | VARCHAR2(50) | 是 | 手机号 | |||||||||||||||||||||||
<Email> | VARCHAR2(50) | 否 | 邮箱 | |||||||||||||||||||||||
<TaxAmount> | NUMBER (19,3) | 否 | 税额(免税请设置0) 税改后基本都要加0.17的增值税,具体看特定商品 | |||||||||||||||||||||||
<TariffAmount> | NUMBER (19,3) | 是 | 关税额(免税请设置0) | |||||||||||||||||||||||
<AddedValueTaxAmount> | NUMBER (19,3) | 是 | 增值税额(免税请设置0) | |||||||||||||||||||||||
<ConsumptionDutyAmount> | NUMBER (19,3) | 是 | 消费税额(免税请设置0) | |||||||||||||||||||||||
<GrossWeight> | NUMBER (19,3) | 是 | 毛重(千克) | |||||||||||||||||||||||
<DisAmount> | NUMBER (19,3) | 否 | 优惠金额合计 | |||||||||||||||||||||||
<Promotions> | 订单优惠清单列表 | |||||||||||||||||||||||||
<Promotion> | 节点可循环 | |||||||||||||||||||||||||
<ProAmount> | NUMBER (19,3) | 否 | 优惠金额 | |||||||||||||||||||||||
<ProRemark> | VARCHAR2(1000) | 否 | 优惠信息说明 | |||||||||||||||||||||||
<Promotion> | ||||||||||||||||||||||||||
<Promotions> | ||||||||||||||||||||||||||
<Goods> | ||||||||||||||||||||||||||
<Detail> | 商品明细节点可循环 | |||||||||||||||||||||||||
<ProductId> | VARCHAR2(20) | 是 | 货号(跨境平台商品备案时产生的唯一编码) 可在商品备案中查询 | *注3 | ||||||||||||||||||||||
<GoodsName> | VARCHAR2(200) | 是 | 商品名称 | |||||||||||||||||||||||
<Qty> | NUMBER (19,3) | 是 | 数量 | |||||||||||||||||||||||
<Unit> | VARCHAR2(20) | 是 | 计量单位(需与商品备案时的单位一致) | |||||||||||||||||||||||
<Price> | NUMBER (19,3) | 是 | 商品单价 | |||||||||||||||||||||||
<Amount> | NUMBER (19,3) | 是 | 商品金额 | |||||||||||||||||||||||
</Detail> | ||||||||||||||||||||||||||
</Goods> | ||||||||||||||||||||||||||
</Order> | ||||||||||||||||||||||||||
<Pay> | ||||||||||||||||||||||||||
<Paytime> | Date | 是 | 支付时间 | |||||||||||||||||||||||
<PaymentNo> | VARCHAR2(50) | 是 | 支付单号(与支付机构交互的流水号) 提交了也没用,会提示找不到单号信息,需要 另外使用支付宝的海关报关接口根据单号提交,再查看是否有支付单号信息 | |||||||||||||||||||||||
<OrderSeqNo> | VARCHAR2(30) | 是 | 商家送支付机构订单交易号(如无,请与支付单号一致) | |||||||||||||||||||||||
<Source> | VARCHAR2(50) | 是 | 支付方式代码 | *详见附录4 | ||||||||||||||||||||||
<Idnum> | VARCHAR2(50) | 否 | 身份证(带英文字母的大写) 税改后必填 | |||||||||||||||||||||||
<Name> | VARCHAR2(50) | 否 | 真实姓名 税改后必填 | |||||||||||||||||||||||
<MerId> | VARCHAR2(50) | *否 | 银联在线商户号 | *注4 | ||||||||||||||||||||||
</Pay> | ||||||||||||||||||||||||||
<Logistics> | ||||||||||||||||||||||||||
<LogisticsNo> | VARCHAR2(60) | 否 | 运单号 | *注1 | ||||||||||||||||||||||
<LogisticsName> | VARCHAR2(60) | 是 | 快递公司名称 | |||||||||||||||||||||||
<Consignee> | VARCHAR2(50) | 是 | 收货人名称 | |||||||||||||||||||||||
<Province> | VARCHAR2(100) | 是 | 省 | |||||||||||||||||||||||
<City> | VARCHAR2(100) | 是 | 市 | |||||||||||||||||||||||
<District> | VARCHAR2(100) | 是 | 区 | |||||||||||||||||||||||
<ConsigneeAddr> | VARCHAR2(300) | 是 | 收货地址(包含省、市、区) | |||||||||||||||||||||||
<ConsigneeTel> | VARCHAR2(20) | 是 | 收货电话 | |||||||||||||||||||||||
<MailNo> | VARCHAR2(20) | 否 | 邮编 | |||||||||||||||||||||||
<GoodsName> | VARCHAR2(1000) | 否 | 货物名称 | |||||||||||||||||||||||
</Logistics> | ||||||||||||||||||||||||||
</Body> | ||||||||||||||||||||||||||
</Message> | ||||||||||||||||||||||||||
*注1 | ||||||||||||||||||||||||||
关区代码为:栎社机场(3109)场合,运单号(LogisticsNo)字段为选填;其他关区代码,不填LogisticsNo | ||||||||||||||||||||||||||
*注2 | ||||||||||||||||||||||||||
财付通(支付方式代码=13)的订单: | ||||||||||||||||||||||||||
若<PaymentNo>与<OrderSeqNo>保持一致,则默认<PaymentNo>为支付单号 | ||||||||||||||||||||||||||
若<PaymentNo>与<OrderSeqNo>不一致,<PaymentNo>请填写订单号,<OrderSeqNo>请填写商户机构号 | ||||||||||||||||||||||||||
如有疑问请联系相关支付机构 | ||||||||||||||||||||||||||
*注3 | ||||||||||||||||||||||||||
空港保税物流中心(关区代码:3115)有两种清关模式(北仑保税、空港保税),在商品备案时,需选择清关模式, | ||||||||||||||||||||||||||
不同清关模式的货号不能在同一订单申报。 | ||||||||||||||||||||||||||
商品的清关模式可登陆申报系统查询,也可以通过[API-备案商品查询(根据货号查询)]查询 | ||||||||||||||||||||||||||
*注4 | ||||||||||||||||||||||||||
银联在线(支付方式代码=01)的订单:<MerId>为必填项,请填写银联商户备案号 | ||||||||||||||||||||||||||
4.响应返回格式 | ||||||||||||||||||||||||||
字段名称 | 字段类型 | 是否必需 | 说明 | |||||||||||||||||||||||
<Message> | ||||||||||||||||||||||||||
<Header> | ||||||||||||||||||||||||||
<Result> | VARCHAR2(1) | 是 | T:操作成功;F:操作失败 | |||||||||||||||||||||||
<ResultMsg> | VARCHAR2(1000) | 否* | 结果描述(操作失败时必需) | |||||||||||||||||||||||
<MftNo> | VARCHAR2(20) | 否* | 申报单号(审核成功返回) | |||||||||||||||||||||||
</Header> | ||||||||||||||||||||||||||
</Message> |
支付宝海关报关
<span style="white-space:pre"> </span>//报关流水号
$out_request_no = $MftNO;//<span style="color:#ff0000;">报关成功后会返回报关的单号</span>
//支付宝交易号
$trade_no = '2016061221001003880255447556';//<span style="color:#ff0000;">支付的流水号</span>
//商户海关备案编号
$merchant_customs_code =$csRow['company_code'];//<span style="color:#ff0000;">不是店铺编号,也不是购物网站,而是对应的电商企业代码</span>
//商户海关备案名称
$merchant_customs_name =$csRow['company_name'];//<span style="color:#ff0000;">对应的电商企业名称</span>
//报关金额
$amount = 112.33;//支付单的实际金额
//海关编号
$customs_place = 'NINGBO';//<span style="color:#ff0000;">应注意与宁波海关提供的编码是不同的,支付宝有自己的海关编码</span>
目前支持报关的海关编号列表如下:海关编号 含义HANGZHOU 杭州海关ZHENGZHOU 郑州海关GUANGZHOU 广州海关CHONGQING 重庆海关NINGBO 宁波海关SHENZHEN 深圳海关HENAN 河南海关SHANGHAI 上海海关XIAN 西安海关FUJIAN 福建海关TIANJIN 天津海关NANSHAGJ 南沙国检ZONGSHU 海关总署说明:若与官方文档有不一致的地方,请以官方文档为准。支付宝海关报关网址:https://b.alipay.com/order/productDetail.htm?productId=2015112418944074&tabId=4#ps-tabinfo-hash