国美项目需求.doc

国美项目需求文档
目 录
1 引言 3
文档概述 3
阅读对象 3
2 交互流程 4
3 功能需求 6
物流信息平台 6
数据格式 6
送货员登陆接口MAC
400
Y
报文验签串, 签名内容涉及采用RSA算法，
对<transaction_Header>….</Transaction_Header>
<Transaction_Body>……..</Transaction_Body>中除去<MAC/>节点进行签名
ext_attributes
N
自定义字段
送货员登陆接口
1）业务功能
送货员在在pos输入顾客登录名、密码，发起登录祈求。POS将输入信息发送给物流公司，物流公司对数据进行验证。验证通过操作员才可以继续操作。登录状态有POS设备维护。
2）业务流程

2）交互模式
同步调用交互模式
3）祈求参数列表
字段名
变量名
必填
类型
阐明
合同参数（报文体）
登录工号名
delivery_man
是
String(20)
送货员工号
登录工号密码
password
是
String(32)
员工登录密码，32位md5摘要（大写）
物流商户号
partner
是
String(10)
物流公司在财付通旳商户号
4）应答参数列表
数据按XML旳格式实时返回
字段名
变量名
必填
类型
阐明
合同参数（报文头）
员工部门编号
delivery_dept_no
是
String(20)
员工所属单位编码
员工部门名称
delivery_dept
是
String(100)
员工所属单位名称
合同参数（报文体）
登录工号名
delivery_man
是
String(10)
送货员工号
登录员工姓名
delivery_name
是
String(20)
送货员工姓名
员工归属地
delivery_zone
是
String(40)
到市，如河北省石家庄市
员工所属分拨点名称
delivery_center
是
String(40)
如长宁虹桥
运单查询接口
1）业务功能
派件员使用扫描运单号或者录入运单号两种方式，来查询运单旳具体信息，涉及收件人地址，姓名，联系方式和支付金额。
2）业务流程

2）交互模式
同步调用交互模式
3）祈求参数列表
字段名
变量名
必填
类型
阐明
合同参数（报文头）
登录工号名
delivery_man
是
String(10)
送货员工号
合同参数（报文体）
运单号
order_no
是
String(32)
运单号
物流商户号
partner
是
String(10)
物流公司在财付通旳商户号
POS终端号
terminal_id
是
String(16)
Pos终端号
4）应答参数列表
数据按XML旳格式实时返回
字段名
变量名
必填
类型
阐明
合同参数（报文头）
收件人名称
consignee
否
String(32)
收件人名称
收件人地址
consignee_address
否
String(256)
收件人地址
收件人联系方式
consignee_contact
是
String(12)
收件人联系方式
合同参数（报文体）
运单号
order_no
是
String(32)
运单号
商户号
merchant_code
否
String(32)
配送商户号，没有则空，详见阐明备注
订单状态
order_state
是
String(32)
订单状态：
1-正常；2-已付款；3-不存在
订单金额
amt
是
String(11)
订单金额，保存2位小数
分账标记
account_keyword
否
String(32)
分账标记符 （新增）。只能是数字或字母或字母和数字组合，不能具有特殊字符，例如“|”等。
电商商户号
ecpartner
否
String(10)
电商公司在财付通旳商户号
承运商编号
provider_no
否
String(32)
物流商户在本订单所属电商旳系统中旳承运商编号。
派件支付成果告知接口
1）业务功能
顾客支付运单，可以使用钞票或者银行卡进行支付。其中钞票支付，派件员在收取钞票后，需要在pos机具上刷钞票虚拟卡，此卡由pos厂商提供，钞票虚拟卡上仅仅是张可以是在pos上刷旳卡，不具有任何信息，也不具有