跨境电商公共服务平台与企业接口规范

1、跨境电商公共服务平台与企业接口规范广州信天翁信息科技有限公司2014年8月更改记录日期作者版本更改参考/备注2014-06-09余皝v1.0文档建立，电商交易订单报文2014-07-09余皝v1.1增加支付报文和物流报文2014-09-03余皝v1.2根据国检要求版本整体调整2014-09-26曹燕飞v1.3装载单报文结构调整2014-10-28曹燕飞v1.4商品备案、进仓单、进境清单、装载单、电子订单 增加制单企业字段2014-11-19余皝v1.5增加集中申报报文。出区进口增加busimode。2014-12-09余皝v1.6出区进口申报单 提单号改为不必填2015-03-18赵金刚v1.

2、7物流信息报文中，代发企业改为非必录，新增电商平台企业2015-05-20舒权v1.8入境进区报文中增加两个字段,申报类型(reporttype)和预申报编码(declcode)审校日期审校人版本审校意见1 报文格式及命名1. 报文格式采用xm作为报文格式，使用utf-8作为报文文件的编码。2. 文件命名跨境电商平台的企业、公共服务平台、以及检验检疫对各自所发报文的命名约定按以下规则：报文类型（messagetype）+”_” + yyyymmddhhmiss（日期时间） +xxx（三位数字流水号）.xml例如：661101_20140404141005001.xml2 报文类型说明跨境贸易公

3、共服务平台与跨境贸易企业之间的数据交换报文报文类型及其说明，如下表：序号报文类型(messagetype)报文名称说明1docrec报文接收回执双方接收到对方报文后，立即回复报文接收回执报文2661105商品备案报文3661101电商交易订单报文电商平台企业向公共平台报送的电商交易订单数据。4661107支付信息上报报文支付平台向检验检疫发送的报文5661104装载单报文6661108物流信息上报报文物流企业向检验检疫发送的报文3661103出区进口报文企业向检验检疫发送的报文7661102入境进区报文企业向检验检疫发送的报文8661103出区进口报文企业向检验检疫发送的报文9661110集中

4、申报报文企业向检验检疫发送的报文3 报文规范在报文格式中字段用编码表示的可以参考,公共代码表excel文档!4 报文接收回执4.1.1 报文结构图4.1.2 报文结构说明根节点为:root 报文头head报文头标签，不循环。报文头标签中含有的标签标签标签内容格式要求可空messageid报文编号报文唯一编号，最大50字符nmessagetype报文类型固定为docrecnsender报文发送者标识最大10字符nreceiver报文接收人标识最大10字符nsendtime发送时间格式：yyyymmddhhmissnversion版本号最大10字符,固定值:1.0n 报文接收回执信息declara

5、tion接收回执标签，不循环。报文接收回执信息标签标签内容格式要求可空orgmessageid原始报文编号原发送报文中报文编号，最大50字符norgmessagetype原报文类型最大10字符norgsenderid原报文发送者标识最大10字符norgreceiverid原报文接收人标识最大10字符norgrectime原报文接收时间格式：yyyymmddhhmissnstatus申报状态申报状态，长度为2个字符，10：已接收（等待审核）20：申报失败nnotes申报反馈信息如申报失败，则放错误信息。最大长度1000个字符。n4.1.3 样例报文 psp00000000000000000172

6、4332 docrec icip topzhi 2015-02-06 16:34:46 01 1.0 cust000000000000000000457155 661103 topzhi icip 20150206163634 10 入库成功! 5 企业商品备案申请5.1.1 企业商品备案单上报报文根节点为:root 报文头head报文头标签，不循环。报文头标签中含有的标签标签标签内容格式要求可空messageid报文编号报文唯一编号，最大50字符nmessagetype报文类型固定为661105nsender报文发送者标识最大10字符(请填写icip企业备案号,不要填汉字)nreceiver

7、报文接收人标识最大10字符(固定为icip)nsendtime发送时间格式：yyyymmddhhmissnfunctioncode业务类型预留字段yversion版本号最大10字符，固定为：1.0y 报文体body报文内容(不可循环)系统字段goodsrecord企业商品备案信息单信息(父标签: body)(不可循环)record表标识,标识企业商品备案主表信息开始(父标签: goodsrecord)(不可循环)swbcargoback(表)record标签下的子标签标签标签内容格式要求可空cargobcode商品申请编号最大128字符,跨境电商企业系统中的唯一编号字段nentcargobac

8、kcodeciqbcode国检组织机构代码请参考:国检组织机构代码,测试联调时填000069nciqbcodecbecomcode跨境电商企业备案号跨境电商企业在智检平台做企业备案，审核通过后的企业备案号。测试联调填写：1000000019。ncbecomcoderemark备注最大255字符yremarkeditccode制单企业的企业备案号制单企业的企业备案号。测试联调填写：1000000019。neditccodeapplydate申请日期格式：yyyymmddhhmiss yodatecargolist企业商品备案子表信息(父标签:record,商品信息列表)(不可循环)record表

9、结点(父标签: swbcargobackg,标识一条商品信息)(可循环)swbcargobackg(表)record标签下的子标签标签标签内容格式要求是否可为空gcode商品货号最大30字符，跨境电商企业提供的商品编号ngcodegname商品名称最大255字符ngnamespec规格型号最大32字符nspechscode商品hs编码最大32字符nhscodeunit计量单位(最小)最大32字符,计量单位码表nqtyunitgoodsbarcode商品条形码最大13字符ygbarcodegoodsdesc商品描述最大255字符ygoodsdescremark备注最大255字符yremarkco

10、mname生产企业名称最大256字符ycomnamebrand品牌最大256字符nbrandassemcountry原产国/地区最大256字符,直接传输汉字,例如:美国等nassemcountryingredient成分 为空时默认“无”最大256字符yingredientadditiveflag超范围使用食品添加剂为空时默认“无”最大256字符yadditivestrpoisonflag含有毒害物质为空时默认“无”最大256字符ypoisonstr5.1.2 企业商品备案单上报报文样例 cust000000000000000002996561 661105 10001235 icip 201

11、50526092404 1.0 custsp1505260001 000069 1000001077 1001235 20150526000000 a seaforest87 美国美赞臣1段金樽早产奶粉 629g/罐 1901101000 122 300871466456 /newborn-infant-formulas/enfamil-newborn/enfamil-newborn-22-2-oz-powder-in-reusable-tub-case-of-4/ mead johnson & company llc enfamil 美国

12、玉米糖浆固体物、高油酸红花籽油、精炼植物油（椰子、大豆）、磷酸氢二钙、l-精氨酸、l-天门冬、l-亮氨酸、柠檬酸三钾、l-赖氨酸醋酸盐、l-谷氨酰胺、l-脯氨酸、l-异亮氨酸、甘氨酸、乳化剂、l-苏氨酸、l-酪氨酸、l-苯丙氨酸、l-丝氨酸、l-组氨酸、l-丙氨酸、l-胱氨酸、l-色氨酸、氯化钠、l-蛋氨酸、乙酸镁、镁l-天门冬、氯化钾酒、石酸胆碱的m-肌醇、l-抗坏血酸、硫酸亚铁、硫酸锌、牛磺酸、l-肉碱、烟酰胺和d-生育酚醋酸盐、钙d-泛酸钙、硫酸铜、硫酸锰、核黄素、维生素a醋酸酯、氯烟酸硫胺、碘化钾、硫酸铬、维生素k1、叶酸、d-生物素、维生素d3、维生素b12。 无 无 5.1.3 企

13、业商品备案接受回执报文参考 报文接收回执报文。5.1.4 企业商品备案单审核回执报文 报文头head报文头标签，不循环。报文头标签中含有的标签标签标签内容格式要求可空messageid报文编号报文唯一编号，最大50字符nmessagetype报文类型固定为661105recnsender报文发送者标识最大10字符,固定值: icipnreceiver报文接收人标识最大10字符,固定值: topzhinsendtime发送时间格式：yyyymmddhhmissnfunctioncode业务类型最大10字符预留字段yversion版本号最大10字符, 缺省值：1.0y 报文体declaration

14、报文内容(不循环)goodsregreclist企业商品备案子表信息(父标签: declaration,商品信息列表)(不循环)record表结点(父标签: swbcargobackg,标识一条商品信息)(不循环)swbcargobackg(表)record标签下的子标签标签标签内容格式要求是否可为空cargobcode商品申请编号最大128字符,跨境电商企业系统中的唯一编号字段nentcargobackcodecbecomcode跨境电商企业备案号跨境电商企业在智检平台做企业备案，审核通过后的企业备案号ncbecomcodegcode商品货号最大30字符,不重复,企业在商品备案时填写商品信息

15、时的商品货号。ngcodeciqgoodsno商品备案号最大50字符,商品审核通过时给的一个商品备案号。yciq_goodsnoregstatusicip回执状态最大4字符10:通过;20:不通过n根据审核的状态判断regnotesicip回执信息最大256字符y5.1.5 企业商品备案单审核回执报文样例 psp000000000000000003037102 661105rec icip topzhi 20150526095148 1.0 custsp1505250015 1000000964 1030310717 icip03150525000060 10 6 电商交易订单6.1.1 电商

16、交易订单报文根节点为:root 报文头head报文头标签，不循环。报文头标签中含有的标签标签标签内容格式要求可空messageid报文编号报文唯一编号，最大50字符nmessagetype报文类型固定为661101nsender报文发送者标识最大10字符,请填企业备案通过的备案号nreceiver报文接收人标识最大10字符,固定为icipnsendtime发送时间格式：yyyymmddhhmissnfunctioncode业务类型最大10字符预留字段yversion版本号最大10字符,固定为：1.0y 报文体 电商交易头信息body报文内容(不循环)对应该字段swbebtrade电商交易订单信

17、息(父标签: body)(不循环)record表标识,标识申报单主表信息开始(父标签: swbebtrade)(不循环)电商交易订单信息标签标签内容格式要求可空对应字段entinsideno企业内部编号(订单号)电商平台企业的报文内部订单编号；取消订单的企业订单编号，必须是被取消订单的企业订单编号；最大30个字符nenordercodeciqbcode国检组织机构代码请参考:国检组织机构代码,测试联调时填000069nciqbcodecbecomcode跨境电商企业备案号跨境电商企业在智检平台做企业备案，审核通过后的企业备案号ncbecomcodecbepcomcode跨境电商平台企业备案号跨

18、境电商平台企业在智检平台做企业备案，审核通过后的企业备案号ncbepcomcodeorderstatus订单状态s-订单新增，c-订单取消；（目前只支持新增）norderstatusreceivename收件人姓名最大30个字符,例如:李雷nrecipientnamereceiveaddr收件人地址最大255个字符,格式:省-市-县-乡镇-街道号nrecipientaddressreceiveno收件人证件号身份证号码，最大30个字符。nrecipientcrednoreceivephone收件人电话收件人电话nrecipienttelfcy总货款订单所有商品货款总和. 仅指货物价值，不包括运

19、费和税款(只能是数字,不能有非数字的字符(“.”除外),保留两位小数,例如:200.33)nfcyfcode币种默认：cnynfcodeeditccode制单企业的企业备案号制单企业的企业备案号。测试联调填写：1000000019。neditccodedrdate下单日期订单下单的日期yyyy-mm-dd hh:mm:ssnorderdateswbebtradeg电商交易订单信息(父标签: record) (不循环)record表标识,标识申报单主表信息开始(父标签: swbebtradeg),(可循环)电商交易头信息标签标签内容格式要求可空对应字段entgoodsno商品序号一份订单编号下的

20、连续的流水号，不可重复；最长6位字符ngcodeidxciqgoodsno商品备案号商品备案申请审核通过时的商品备案号。yciq_goodsnocopgname商品名称商品的名称ngnamebrand品牌最大256字符nbrandspec规格型号最大32字符nspecorigin产地商品原产国别/地区,录入汉字即可,和商品备案时录入的保持一致,例如:美国noriginqty商品数/重量缺省：整数，可输入四位小数；商品购买数/重量,只能是数字不能包含非数字的字符(“.”除外),例如:300.67nqtyqtyunit计量单位可以参考:计量单位码表nqtyunitdecprice商品单价2位小数；

21、该项商品的单价；单位：rmb；nupricdectotal商品总价该项商品的总价，二位小数； 单位：rmb；ndectotalsellwebsite销售网址http地址nsellwebsitenots备注商品的备注信息yremark6.1.2 电商交易订单报文样例 cust000000000000000002995463 661101 icip 1000000075 20150526000319 02 1.0 151458600019 000069 1000000075 1000000841 s 余笛 湖南 湘潭市 岳塘区 宝塔街道 金芙蓉路7号锦绣华庭11栋2单元301室 430304199

22、10719256039 cny 20150525160444 1001235 001 kao 花王 蒸汽眼罩眼膜 14片装 （柚子香） 1 39 39 0 14枚/盒 140 6.1.3 电商交易订单接收回执报文参考 报文接收回执报文。7 支付信息7.1.1 支付信息上报报文根节点:rootroot根节点(为head和body结点的父级结点)(不可循环)head报文头标签，不循环。(不可循环)报文头标签中含有的标签标签标签内容格式要求可空messageid报文编号报文唯一编号，最大50字符nmessagetype报文类型固定为661107nsender报文发送者标识最

23、大10字符,请填企业备案通过的备案号nreceiver报文接收人标识最大10字符,固定为icipnsendtime发送时间格式：yyyymmddhhmissnfunctioncode业务类型最大10字符预留字段yversion版本号最大10字符，固定为：1.0ybody报文内容(不可循环)对应该字段swbpayment支付信息(不可循环)record(不可循环)支付信息标签标签内容格式要求可空对应字段payno支付编号最大255,支付企业交易号npaynociqbcode国检组织机构代码请参考:国检组织机构代码,测试联调时填000069nciqbcodepaypcomcode 支付企业备案号支

24、付企业在智检平台做企业备案，审核通过后的企业备案号。npaypcomcodeenordercode电子交易订单编号最大30个字符,来源于电子订单nenordercodepayorname付款人付款人的姓名，最大128字符npayornamepayoraccount付款账号最大128字符，可最多选择4个字符用*代替。ypayoraccountshippername收款人收款人的姓名，最大128字符yshippernameorderfcy订单金额最大18位,必须是数字,不能有非数字字符(“.”除外),保留两位小数,例如:345.67norderfcyorderfcode订单币种默认cnynorde

25、rfcodepayfcy支付金额最大18位,必须是数字,不能有非数字字符(“.”除外),保留两位小数,例如:345.67npayfcypayfcode支付币种默认cnynpayfcodepaydate支付日期格式：yyyymmddhhmissnpaydatenotes备注最大512字符yremark7.1.2 支付信息上报报文样例661107_2015052608570155396611071002114icip201505260857011.0201505260856249236000069000069680485945784787019游永全390cny390cny2015-05-26 0

26、8:39:087.1.3 支付信息接收回执参见: 报文报文接收回执8 装载单报文8.1.1 装载单上报报文根节点:root 报文头部root根节点(为head和body结点的父级结点)head报文头标签，不循环。报文头标签中含有的标签标签标签内容格式要求可空messageid报文编号报文唯一编号，最大50字符nmessagetype报文类型固定为661104nsender报文发送者标识最大10字符,请填企业备案通过的备案号nreceiver报文接收人标识最大10字符,固定为:icipnsendtime发送时间格式：yyyymmddhhmissnfunctioncode业务类型最大10字符预留字

27、段yversion版本号最大10字符，缺省值：1.0y 报文体body报文内容(不循环)对应该字段swbloadbill(不循环)record装载清单业务头信息，不循环。swbloadbill装载清单业务头信息标签标签内容格式要求可空对应字段 entloadingno企业装载单自编号最大100字符,仓储企业系统中的唯一编号字段nentloadingnociqbcode国检组织机构代码请参考码表:国检组织机构代码,测试联调时填000069”nciqbcodestationbcode保税园区货物存储的保税园区请参考码表:保税园区码表nstationbcodestorcomcode仓储企业备案号仓储

28、企业在智检平台做企业备案，审核通过后的企业备案号。nstorcomcodelogisticscode物流企业备案号物流企业在智检平台做企业备案，审核通过后的企业备案号ylogisticscodeplatenumber车牌号不能包含特殊字符，例：粤ag4981。最大10字符。nplatenumberqty总件数总长度为10位，最大为4位,要求必须是数值类型的值,例如:300.67nqtyloaddate装载日期格式：yyyymmddhhmissnloaddateinputdate录入日期格式：yyyymmddhhmissnpredateoptype操作方式a-新增；m-修改；d-取消；（默认为新

29、增），最大10字符noptypeeditccode制单企业的企业备案号制单企业的企业备案号。测试联调填写：1000000019。neditccodenotes备注最大500字符yremarkloadcontent父节点主表的record节点(不循环)record装载清单业务明细信息，(可循环)。swbloadbillg装载清单业务明细信息标签标签内容格式要求可空对应字段seq 流水号最大3字符nidxcbecomcode跨境电商企业备案号跨境电商企业在智检平台做企业备案，审核通过后的企业备案号。ncbecomcodeenordercode电子订单号电子订单号，和电子交易订单中的订单号是同一个。

30、nordernowaybillno运单号真实运单号（国内快递单号）nwaybillnocbepcomcode跨境电商平台企业备案号跨境电商平台企业在智检平台做企业备案，审核通过后的企业备案号。ncbepcomcodenotes 备注最大500字符y8.1.2 装载单报文样例 cust000000000000000003147110 661104 1001235 icip 20150527090444 1.0 custzz1505270001 000069 000046 粤a56264 2464 20150527000000 20150527090007 a 1001235 000001 100

31、0000863 1042137048316014 802680331121 1001351 8.1.3 装载单接受回执报文参考:报文接收回执报文。8.1.4 装载单审核回执报文root根节点(为head和body结点的父级结点)对应该字段head报文头标签，不循环。报文头标签中含有的标签标签标签内容格式要求可空messageid报文编号报文唯一编号，最大50字符nprojwaitidmessagetype报文类型固定为661104recnsender报文发送者标识最大10字符，固定值：icipnreceiver报文接收人标识最大10字符，固定值：topzhinsendtime发送时间格式：yy

32、yymmddhhmissnversion版本号缺省值1.0ndeclaration报文体标签，不循环。swbloadbill报文体标签中含有的标签eportinboundnoicip平台唯一标识icip平台唯一标识,icip平台上的装载单编码neportimportnoentinboundno企业端唯一标识(内码)企业端唯一标识,对应装载单申报报文中entloadingno的值nentimportnostatusto审核状态审核状态. 10:成功20:失败nstatusdesc审核备注审核备注y8.1.5 装载单审核回执报文样例 psp000000000000000000251799 661101rec icip topzhi 2014-12-18 18:53:58 1.0 10 17 load1412180001 10 9 物流信息9.1.1 物流信息上报报文root根节点(为hea