接口说明书_20121224.docVIP

公用规格 基本约定 通讯约定：使用WebService方式进行通讯，传输协议：HTTPS，参数不做encode(URL转码)。特殊字符：$% 参数大小写约定：没有强制要求的地方，统一使用小写。 编码约定：如GBK或UTF-8等，默认为UTF-8。 参数约定： XML。 安全约定：1、加密算法暂定为RSA，对报文进行加密，有宇通生成公钥及数字签名文件发给第三方系统，第三方系统使用公钥对报文进行加密和解密，使用数字签名文件对报文进行签名和校验。2、只对敏感数据加密 消息数量约定：默认一个消息一个订单，单据生成和下发并行，生成多少下发多少。当涉及批量处理时，默认最多处理500个。 时间约定：时间格式使用 YYYY-MM-DD HH:mm:ss 的格式，精确到秒。 公用传输字段 主动模式基本字段 宇通下发消息给第三方系统，其基本字段定义如下表所示： 接口类名 消息请求格式 名称 类型 可选/必选 备注 sid String(3) 必选 合作伙伴的唯一标识，由双方协定。 如:2088002464631181 zdate String 必选 消息通知时间 YYYY-MM-DD hh:mm:ss zlines String(8) 必选 消息记录数 content 必选 消息内容或者消息参数，接口的消息参数，格式为 request p1/ p2/ /request 被动模式基本字段 接口类名 消息请求格式 名称 类型 可选/必选 备注 sid String(3) 必选 合作伙伴的唯一标识，由双方协定。 如:2088002464631181 zlines String(8 必选 消息记录数 content 必选 消息内容或者消息参数，接口的消息参数，格式为 request p1/ p2/ /request 被动模式消息响应字段 合生元在收到安得的消息后，会立即返回响应，其字段定义如下所示： 接口类名 消息响应格式 名称 类型 可选/必选 备注 is_success String 必选 T 成功 F 失败 业务参数 Error String 可选 错误信息，如果is_success是T，则不需要填写该参数，如果is_success是F,则必须填写该参数，便于查找问题原因 主动模式消息响应字段 同样安得在收到合生元消息后，同样需要立即返回响应，其字段定义如下： 基本参数 名称 类型 可选/必选 备注 is_success String 必选 是否成功 T 成功 F 失败 业务参数 名称 类型 可选/必选 备注 Error String 可选 错误信息，如果is_success是T，则不需要填写该参数，如果is_success是F,则必须填写该参数，便于查找问题原因  接口规格详述 3.1 装运单推送接口（主动模式：shipping_bill_notify） 新增装运单通过此接口主动发送到3PL。其定义字段如下表 接口类名 装运单推送接口 功能描述 装运单推送接口 服务名称 shipping_bill_notify 基础参数 名称 类型 可选/必选 备注 sid String(3) 必选 招商SZS 安得 SAD zdate String 必选 消息通知时间 YYYY-MM-DD hh:mm:ss zlines String(8) 必选 消息记录数 Content String 必选 内容，见业务参数定义 业务参数 项目 名称 类型 可选/必选 备注 装运单信息 item_list ListItem 必选 item_list ListItem 装车单明细信息字段 表3-6中装运单信息字段如下表所示： 装运单明细 item 名称 类型 长度 可选/必选 备注 vbeln String 10 必选 装运单号 posnr String 6 必选 装运单行项目 lifnr String 10 必选 供应商代码 matnr String 18 必选 物料号 dokvr String 2 必选 版本号 ebeln String 10 必选 采购订单号 ebelp String 5 必选 行项目 bedat String 8 必选 装运到货日期 amount Number 13,3 必选 装车数量 meins String 3 必选 单位 werks String 4 必选 工厂 wmeins String 3 预留 重量单位 ntgew String 13,3 预留 重量 remark String 20 备注