E贸易对接规范-订单V1.1.docx

E贸易订单信息对接规范当前状态：草稿当前版本：1.1发布发布日期：2015-5-12修改历史日期版本作者修改内容评审号变更控制号2015-3-241.0吴建业2015-5-121.1吴建业目录1文档说明12对接流程12.1对接流程图12.2对接流程说明13数据传输体系架构24接口规范24.1接口使用说明24.2安全机制24.3接口报文34.3.1报文规则和系统限定34.3.2接口请求测试地址URL34.3.3订单信息格式34.3.4订单信息字段说明64.3.5报文结构示例124.3.6请求报文字段说明124.3.7回执报文字段说明134.3.8数据加密说明13文档说明本文档描述电商企业与E贸易系统对接的操作流程，数据传输的架构体系，以及电商企业在与E贸易系统进行对接的相关接口规范和说明。对接流程对接流程图对接流程说明1)、电商企业备案在海关国检进行企业备案完成之后，海关会提供电商企业一个数据传输加密key。2）、电商需要准备一台服务器，加密key插到该服务器上，作为数据传输中转设备；其中该服务器可以托管到河南保税物流中心机房，也可以由电商企业自己管理维护。3）、如服务器托管到河南保税物流中心机房，需要向河南保税物流中心下属部门信息中心硬件网络组提交服务器配置清单，作为设备移交的依据；该设备在物权上归属于电商企业，使用权归属河南保税物流中心。4）、如电商企业自己管理维护服务器，需确保服务器长期不能关机，另需要提供远程控制权限，由河南保税中心技术人员远程登录该服务器进行相关数据传输软件的安装。5）、电商企业根据该文档提供的接口规范以及说明进行程序开发，并测试，如果开发测试完成，即可以对接正式环境。数据传输体系架构接口规范接口使用说明报文通讯方式为HTTP通讯,E贸易提供URL给电商企业调用，电商企业根据此接口规范约定的方式传入参数和值。E贸易根据规范实时返回结果，客户根据结果确定是否需要重传。安全机制 传输数据采用RSA非对称加密算法，密钥对由E贸易产生，向电商企业提供公钥用于加密数据，同时数据加签名校验。流程如下：接口报文报文规则和系统限定报文采用标准XML格式，字符集编码为UTF-8 。报文内部各标签顺序固定按接口报文设计所示，标签无内容可留空，但不允许删除标签。接口请求测试地址URL12:9092/BIService/service/order/pushOrder订单信息格式?xml version=1.0 encoding=utf-8?Order OrderHeadecCode电商代码（检）/ecCodecbeCode电商代码（关）/cbeCodeecName电商名称（检）/ecNamecbeName电商名称（关）/cbeNameecpCodeCiq电商平台代码（检）/ecpCodeCiqecpCodeCus电商平台代码（关）/ecpCodeCusecpNameCiq电商平台名称（检）/ecpNameCiqecpNameCus电商平台名称（关）/ecpNameCusorderNo订单编号/orderNo charge总费用/chargegoodsValue货值/goodsValuefreight运费/freightother其他费用/othertax进口行邮税/taxcustomer客户姓名/customershipper发货人名称/shippershipperAddress发货人地址/shipperAddressshipperTelephone发货人电话/shipperTelephoneshipperCountryCiq发货人所在国（检）/shipperCountryCiqshipperCountryCus发货人所在国（关）/shipperCountryCusconsignee收货人名称/consigneeconsigneeProvince收货人省份/consigneeProvinceconsigneeCity收货人城市/consigneeCityconsigneeZone收货人区县/consigneeZoneconsigneeAddress收货人地址/consigneeAddressconsigneeTelephone收货人电话/consigneeTelephoneconsigneeCountryCiq收获人所在国（检）/consigneeCountryCiqconsigneeCountryCus收获人所在国（关）/consigneeCountryCusidType证件类型/idTypeidNumber证件号码/idNumberieType进出口标志/ieTypestockFlag集货/备货/stockFlagbatchNumbers批次号/batchNumberstotalLogisticsNo总运单号/total