一、总概 1.1、通讯协议遵循 HTTP (1.0/1.1) 1.2、数据包装采用JSON,遵循RFC4627 非ASCII字符编码:UTF-8 (65001) 或者 \u转义 *特别提示,共有8个ASCII码采用x编码转义: "(双引号) = \x22 \(反斜杠) = \x5C /(斜杠) = \x2F (换行符) = \x0A (回车符) = \x0D (制表符) = \x09 (罕用) (退格符) = \x08 (极罕用) (换页符) = \x0C (极罕用) *POST数据,遵循上述编码规则,不进行URL_Encode(定义URL_ENCODE=1,强制URL_ENCODE) 1.3、接口API为:“/cgi-bin/EmsData.dll?DoPda” 1.4、接口请求方式为:POST 1.5、安全控制,MD5数字签名,绑定用户PID、pda密钥,通过与时间戳生成摘要码验证。 1.6、服务器程序配置: EmsData.dll为IIS的筛选、扩展程序,与GInfo.dll同类,在配置GInfo.dll的系统上,配置该筛选器及扩展模块 EmsData.dll使用GInfo.dll的服务器安全配置参数。所以在GInfo配置并成功运行后,再简单添加EmsData.dll即可。 二、JSON命名规范 2.1、RequestName:发起请求名称,为请求方的第一个顶级成员名称,定义如下: {"RequestName":"TimeStamp"}: *服务器时间戳获取,用于调试 {"RequestName":"GenerateMD5","cString":"A33256BJ1405534421123xxxxxxxx"}: *获取MD5,用于调试 {"RequestName":"EmsKindList"}: *客户可见快递类别列表查询 *pda定制接口开始*z*20150210* {"RequestName":"pdaSpInfo", "cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb",...}: 下家渠道绑定信息查询请求,成功返回下家渠道信息列表 {"RequestName":"pdaSpBatch", "cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb",...}: 下家批次号信息查询请求,成功返回下家已用批次号列表 {"RequestName":"pdaRecCtrlCode", "cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb",...}: 快件内控码操作 {"RequestName":"pdaRecPromptQuery","cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb",...}: 快件操作提示查询 {"RequestName":"pdaRecSend", "cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb",...}: 快件发送(检查、计价) {"RequestName":"pdaRecReWeight", "cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb",...}: 复重计价(已录单记录(未发送)) {"RequestName":"pdaRecReWeightPre","cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb",...}: 复重计价(预录单正式录单) {"RequestName":"pdaRecReWeightTrans","cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb",...}:复重计价(转发正式录单) {"RequestName":"pdaRecMod", "cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb",...}: 业务字段非关键性修改 {"RequestName":"pdaRecReturn", "cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb",...}: 退件入库(一体入库) *{"RequestName":"pdaRecExcept", "cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb",...}: 快件异常退件(可用EmsScan) {"RequestName":"pdaTransRcv", "cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb",...}: 转运收货确认 {"RequestName":"pdaTransShelfPut", "cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb",...}: 转发上架 {"RequestName":"pdaTransBagOut", "cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb",...}: 转发指令转运确认(进业务系统录单,计价),同"pdaRecReWeightTrans" *如下为仓库相关接口 *将设计单独的货物上、下架操作表,不进行验证,只记录操作,原子性操作(double check) {"RequestName":"pdawShelfPut", "cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cDepot":"XYZ",...}: 货物上架(double check,仅操作记录) {"RequestName":"pdawShelfGet", "cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cDepot":"XYZ",...}: 货物下架(double check,仅操作记录) {"RequestName":"pdawShelfQuery", "cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cDepot":"XYZ",...}: 货物查询,在架位上的货物统计汇总 {"RequestName":"pdawShelfGoods", "cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cDepot":"XYZ",...}: 货物在架查询,查询某货物在架(未下架)信息的统计汇总 {"RequestName":"pdawClientInfo", "cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cDepot":"XYZ",...}: 查询仓储客户资料 {"RequestName":"pdawGoodsInfo", "cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cDepot":"XYZ",...}: 查询物品信息 {"RequestName":"pdawInPick", "cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cDepot":"XYZ",...}: 取货确认 {"RequestName":"pdawInCheck", "cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cDepot":"XYZ",...}: 质检确认 {"RequestName":"pdawInConfirm", "cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cDepot":"XYZ",...}: 入库确认 {"RequestName":"pdawShelfChange", "cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cDepot":"XYZ",...}: 更换货架 {"RequestName":"pdawCartInfo", "cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cDepot":"XYZ",...}: 查询捡货车捡货信息 {"RequestName":"pdawCartChoose", "cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cDepot":"XYZ",...}: 捡货车关联捡货人(领单捡货) {"RequestName":"pdawOrderInfo", "cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cDepot":"XYZ",...}: 查询订单信息(单个订单的各种详细信息,含捡货...) {"RequestName":"pdawCartConfirm", "cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cDepot":"XYZ",...}: 捡货完成确认 {"RequestName":"pdawOrderOut", "cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cDepot":"XYZ",...}: 订单出库 {"RequestName":"pdawMoveInfo", "cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cDepot":"XYZ",...}: 查询待移库物品信息(出、入) {"RequestName":"pdawMoveIn", "cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cDepot":"XYZ",...}: 移库入库确认 {"RequestName":"pdawMoveOut", "cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cDepot":"XYZ",...}: 移库出库确认 {"RequestName":"pdawSerialIn", "cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cDepot":"XYZ",...}: 序列号物品扫描,入库确认前 {"RequestName":"pdawSerialOut", "cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cDepot":"XYZ",...}: 序列号物品扫描,捡货完成后-出库确认前 {"RequestName":"pdaUserInfo", "cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb"}: 查询用户(当前操作者)信息及权限 *以上共35个接口* **h*20150330* {"RequestName":"pdaRecPickup", "cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb",...}: 取件操作记录,记录客户、取件人及运单号,在录单时匹配验证 {"RequestName":"pdaRecTrackInfo", "cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb",...}: 业务记录追踪信息添加,对总单、袋或运单增加类总单(位置1-99)物流网络的末条追踪信息 {"RequestName":"pdaxBagQuery", "cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb",...}: 袋及相关信息查询统计 {"RequestName":"pdaxBagSet", "cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb",...}: 袋字段更新(标签、备1-备5) *z*20150505* {"RequestName":"pdawInAdd", "cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cDepot":"XYZ",...}: 预入库记录添加 {"RequestName":"pdawInQuery", "cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cDepot":"XYZ",...}: 预入库记录(待入库确认)列表 {"RequestName":"pdaTransQuery", "cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb",...}: 转发到件预报记录查询 {"RequestName":"pdaPreInputQuery", "cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb",...}: 快递客户预录数据记录查询 {"RequestName":"pdaRecAdd", "cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb",...}: 快递业务记录添加 {"RequestName":"pdaGetNum", "cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb",...}: 获取一个EMMis系统定义的运单号 *w*20150611* {"RequestName":"pdawInPicAdd", "cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cDepot":"XYZ",...}: 预入库记录图片添加 {"RequestName":"pdawInPicQuery", "cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cDepot":"XYZ",...}: 预入库记录图片查询 {"RequestName":"pdawGoodsDefine", "cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cDepot":"XYZ",...}: 物品定义记录添加 {"RequestName":"pdawGoodsDepot", "cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cDepot":"XYZ",...}: 物品归库 {"RequestName":"pdawInConfirmEx", "cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cDepot":"XYZ",...}: 入库确认(一体操作、物品定义、归库、预入库记录、审核、确认) 2.1.2、每一个请求都必须包含成员变量:cUserPid、TimeStamp、MD5,仓库相关接口都必须包含cDepot。 2.1.2.1、cUserPid:用户绑定PID,在EMMis中系统用户管理中的“PDA编号”,由此确认操作者姓名。 2.1.2.2、TimeStamp:时间戳,1970.1.1 0:0:0开始到请求时刻的毫秒数(UTC),13位整数。注意北京时间为东8区,需要调整时差。 2.1.2.3、MD5:数字签名,=MD5(cUserPid+TimeStamp+PDA密钥) *比如PDA密钥为“abcdefg1234567”,如上例程为:MD5("A33256BJ1405534421123abcdefg1234567")="c435e730ad0e2587761234e3dbb1eefb" 2.1.2.4、PDA密钥,在EMMis“系统初始化”中配置的“PDA密钥” 2.2、ReturnValue:响应返回状态码,为响应方的第一个顶级成员名称,整数值,通用定义如下: {"ReturnValue":0,...}: 没有结果或零处理 {"ReturnValue":1,...}: 大于零,结果数或处理记录数,为成功的标识 {"ReturnValue":-1,...}: 唯一性字段值重复,操作失败 {"ReturnValue":-2,...}: 记录不存在,操作失败 {"ReturnValue":-3,...}: 未提供必须的请求参数,操作失败 {"ReturnValue":-4,...}: 请求不支持,版本错误或请求未实现 {"ReturnValue":-5,...}: 未解析出"RequestName" {"ReturnValue":-6,...}: 没有启用亦米容器,配置“启用亦米容器=1” {"ReturnValue":-7,...}: 安全校验失败,不是配置的IP或数字签名错误 {"ReturnValue":-8,...}: 未获授权 {"ReturnValue":-9,...}: EmsData.dll程序错误,通常为数据库查询失败 {"ReturnValue":-710,...}: icID 错误,未提供或小于1 {"ReturnValue":-711,...}: icID ...错误,客户不存在 {"ReturnValue":-720,...}: TimeStamp 错误,超出了同步阈值 {"ReturnValue":-730,...}: MD5 错误,长度不是32字符 {"ReturnValue":-731,...}: MD5 错误,不匹配 {"ReturnValue":-810,...}: cUserPid 错误,未提供或小于1 {"ReturnValue":-811,...}: cUserPid 错误,用户不存在 {"ReturnValue":-820,...}: isID 错误,未提供或小于1 {"ReturnValue":-821,...}: isID 错误,下家不存在 {"ReturnValue":-830,...}: cDepot 错误,仓库编码未提供或不合法(3字母) {"ReturnValue":-831,...}: cDepot 错误,仓库不存在 *负数值均为失败,更多的含义在具体的请求中定义。 2.3、记录字段命名采用类匈牙利命名法,第一个符号小写,为字段数据类型,名称实词首字母大写 n:单字节正整数,取值0-255,常为枚举值。如:nItemType(快件类型) d:日期,实际为一固定格式字符串,格式为:“YYYY-MM-DD hh:mm:ss”,年月日为必须。如:dDate(业务日期) i:4字节整数,取值+-2^31。如:iItem(件数) f:双精度数,精确小数位数因字段而异。如:fWeight(重量,3位小数) b:逻辑值,true/false。如:bSmsSend(是否发派件短信) c:字符串,合法的长度区间,长度按ANSI字节计算。如:cRName(收件人姓名,1-62字节) 三、各请求详解及例子 3.1、pdaSpInfo 3.1.1、请求: {"RequestName":"pdaSpInfo","cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","iqsID":0,"iqType":0,"cqEmsKind":""} 3.1.1.1、查询变量名解释 iqsID:下家ID,在EMMis系统的id,整数,筛选条件 iqType:查询类别。0:绑定查询,结果集中有快递类别字段,可能较大记录集,建议加筛选条件;1:档案查询 cqEmsKind:查询快递类别,绑定查询时有效,筛选条件 3.1.2、样例 3.1.2.1、请求: API: /cgi-bin/EmsData.dll?DoPda POST_DATA:{"RequestName":"pdaSpInfo","cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb"} 3.1.2.2、响应: {"ReturnValue":1,"iqsID":0,"iqType":0,"cqEmsKind":"","RecList":[{"isID":9,"iBatch":301,"cEmsKind":"FedEx","cName":"TNT温州分部"},{"isID":9,"iBatch":301,"cEmsKind":"TNT","cName":"TNT温州分部"},{"isID":9,"iBatch":301,"cEmsKind":"颿达","cName":"TNT温州分部"},{"isID":9,"iBatch":301,"cEmsKind":"顺丰快递","cName":"TNT温州分部"},{"isID":9,"iBatch":301,"cEmsKind":"圆通速递","cName":"TNT温州分部"},{"isID":15,"iBatch":11,"cEmsKind":"EMS国际","cName":"广州01邮局"},{"isID":15,"iBatch":11,"cEmsKind":"韵达","cName":"广州01邮局"},{"isID":15,"iBatch":11,"cEmsKind":"韵达快递","cName":"广州01邮局"},{"isID":4,"iBatch":255,"cEmsKind":"DHL","cName":"杭州远程"},{"isID":4,"iBatch":255,"cEmsKind":"日本黑猫","cName":"杭州远程"},{"isID":4,"iBatch":255,"cEmsKind":"源伟丰","cName":"杭州远程"},{"isID":4,"iBatch":255,"cEmsKind":"中美联合","cName":"杭州远程"},{"isID":13,"iBatch":234,"cEmsKind":"INTERLINK","cName":"空的服务商"},{"isID":13,"iBatch":234,"cEmsKind":"广东振捷","cName":"空的服务商"},{"isID":3,"iBatch":56,"cEmsKind":"ANY","cName":"快快马网络"},{"isID":3,"iBatch":56,"cEmsKind":"FedEx","cName":"快快马网络"},{"isID":3,"iBatch":56,"cEmsKind":"GATI","cName":"快快马网络"},{"isID":3,"iBatch":56,"cEmsKind":"ONTRAC","cName":"快快马网络"},{"isID":3,"iBatch":56,"cEmsKind":"USADH","cName":"快快马网络"},{"isID":3,"iBatch":56,"cEmsKind":"博宏","cName":"快快马网络"},{"isID":3,"iBatch":56,"cEmsKind":"长川货运","cName":"快快马网络"},{"isID":3,"iBatch":56,"cEmsKind":"中邮物流","cName":"快快马网络"},{"isID":5,"iBatch":1,"cEmsKind":"DHL","cName":"某DHL特bsd"},{"isID":5,"iBatch":1,"cEmsKind":"中通速递","cName":"某DHL特bsd"},{"isID":17,"iBatch":123,"cEmsKind":"UPS","cName":"南京UPS"},{"isID":2,"iBatch":111,"cEmsKind":"DHL","cName":"钮门网络"},{"isID":2,"iBatch":111,"cEmsKind":"EMS(国内)","cName":"钮门网络"},{"isID":2,"iBatch":111,"cEmsKind":"EMS国际","cName":"钮门网络"},{"isID":2,"iBatch":111,"cEmsKind":"LINEX","cName":"钮门网络"},{"isID":2,"iBatch":111,"cEmsKind":"SKYNET","cName":"钮门网络"},{"isID":2,"iBatch":111,"cEmsKind":"UPS","cName":"钮门网络"},{"isID":2,"iBatch":111,"cEmsKind":"皇家邮政","cName":"钮门网络"},{"isID":2,"iBatch":111,"cEmsKind":"牧野清关","cName":"钮门网络"},{"isID":2,"iBatch":111,"cEmsKind":"青岛安捷","cName":"钮门网络"},{"isID":2,"iBatch":111,"cEmsKind":"上海OCS","cName":"钮门网络"},{"isID":2,"iBatch":111,"cEmsKind":"台灣超峰","cName":"钮门网络"},{"isID":2,"iBatch":111,"cEmsKind":"雅士国际","cName":"钮门网络"},{"isID":2,"iBatch":111,"cEmsKind":"邮政小包","cName":"钮门网络"},{"isID":2,"iBatch":111,"cEmsKind":"佐川急便","cName":"钮门网络"},{"isID":16,"iBatch":13,"cEmsKind":"188POST","cName":"莆田邮局"},{"isID":16,"iBatch":13,"cEmsKind":"EMS(国内)","cName":"莆田邮局"},{"isID":16,"iBatch":13,"cEmsKind":"EMS国际","cName":"莆田邮局"},{"isID":16,"iBatch":13,"cEmsKind":"yw-EMS(小包)","cName":"莆田邮局"},{"isID":16,"iBatch":13,"cEmsKind":"澳洲邮政","cName":"莆田邮局"},{"isID":16,"iBatch":13,"cEmsKind":"新加坡邮政","cName":"莆田邮局"},{"isID":16,"iBatch":13,"cEmsKind":"佐川急便","cName":"莆田邮局"},{"isID":12,"iBatch":998,"cEmsKind":"DHL","cName":"上海环亚55"},{"isID":12,"iBatch":998,"cEmsKind":"韵达快递","cName":"上海环亚55"},{"isID":8,"iBatch":10,"cEmsKind":"EMS国际","cName":"上海外滩邮局"},{"isID":8,"iBatch":10,"cEmsKind":"外运发展","cName":"上海外滩邮局"},{"isID":1,"iBatch":0,"cEmsKind":"4PX","cName":"天霖公司"},{"isID":1,"iBatch":0,"cEmsKind":"ACI","cName":"天霖公司"},{"isID":1,"iBatch":0,"cEmsKind":"ADPKR","cName":"天霖公司"},{"isID":1,"iBatch":0,"cEmsKind":"DHL","cName":"天霖公司"},{"isID":1,"iBatch":0,"cEmsKind":"EMS国际","cName":"天霖公司"},{"isID":1,"iBatch":0,"cEmsKind":"EMS国际E1","cName":"天霖公司"},{"isID":1,"iBatch":0,"cEmsKind":"FedEx","cName":"天霖公司"},{"isID":1,"iBatch":0,"cEmsKind":"GATI","cName":"天霖公司"},{"isID":1,"iBatch":0,"cEmsKind":"ONTRAC","cName":"天霖公司"},{"isID":1,"iBatch":0,"cEmsKind":"TNT","cName":"天霖公司"},{"isID":1,"iBatch":0,"cEmsKind":"UPS","cName":"天霖公司"},{"isID":1,"iBatch":0,"cEmsKind":"URPOST","cName":"天霖公司"},{"isID":1,"iBatch":0,"cEmsKind":"USADH","cName":"天霖公司"},{"isID":1,"iBatch":0,"cEmsKind":"澳洲邮政","cName":"天霖公司"},{"isID":1,"iBatch":0,"cEmsKind":"百福东方","cName":"天霖公司"},{"isID":1,"iBatch":0,"cEmsKind":"广州亚美","cName":"天霖公司"},{"isID":1,"iBatch":0,"cEmsKind":"皇家邮政","cName":"天霖公司"},{"isID":1,"iBatch":0,"cEmsKind":"嘉里大通J003","cName":"天霖公司"},{"isID":1,"iBatch":0,"cEmsKind":"金景物流","cName":"天霖公司"},{"isID":1,"iBatch":0,"cEmsKind":"京广速递","cName":"天霖公司"},{"isID":1,"iBatch":0,"cEmsKind":"美亚专线","cName":"天霖公司"},{"isID":1,"iBatch":0,"cEmsKind":"全一","cName":"天霖公司"},{"isID":1,"iBatch":0,"cEmsKind":"日本邮政","cName":"天霖公司"},{"isID":1,"iBatch":0,"cEmsKind":"申通","cName":"天霖公司"},{"isID":1,"iBatch":0,"cEmsKind":"顺丰快递","cName":"天霖公司"},{"isID":1,"iBatch":0,"cEmsKind":"天霖货运","cName":"天霖公司"},{"isID":1,"iBatch":0,"cEmsKind":"西武","cName":"天霖公司"},{"isID":1,"iBatch":0,"cEmsKind":"一通快递","cName":"天霖公司"},{"isID":1,"iBatch":0,"cEmsKind":"翼速国际","cName":"天霖公司"},{"isID":1,"iBatch":0,"cEmsKind":"邮政小包","cName":"天霖公司"},{"isID":1,"iBatch":0,"cEmsKind":"源伟丰","cName":"天霖公司"},{"isID":1,"iBatch":0,"cEmsKind":"运通物流","cName":"天霖公司"},{"isID":1,"iBatch":0,"cEmsKind":"中通速递","cName":"天霖公司"},{"isID":1,"iBatch":0,"cEmsKind":"中邮物流","cName":"天霖公司"},{"isID":1,"iBatch":0,"cEmsKind":"佐川急便","cName":"天霖公司"},{"isID":20,"iBatch":3,"cEmsKind":"天天测试","cName":"天天"}],"iTotalRec":86} 3.1.3、字段名解释 isID:下家ID。 iBatch:下家固定批次号,0-999;整数,可用于生成批次,如:150123-123-0 cEmsKind:绑定的快递类别 cName:下家名称 iTotalRec:记录数 *** ReturnValue:1:成功;0:无查询结果 3.2、pdaSpBatch 3.2.1、请求: {"RequestName":"pdaSpBatch","cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","iqsID":1,"cqDate":"2015.01.11"} 3.2.1.1、查询变量名解释 iqsID:下家ID,在EMMis系统的id,整数,必须! cqDate:批次日期,批次号前6位数字。如不提供,则默认当天。 3.2.2、样例 3.2.2.1、请求: API: /cgi-bin/EmsData.dll?DoPda POST_DATA:{"RequestName":"pdaSpBatch","cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","iqsID":1} 3.2.2.2、响应: {"ReturnValue":1,"iqsID":1,"cqDate":"2015.01.11","iBatch":0,"cName":"天霖公司","cBatches":["150111-000-2","150111-000-1","150111-000-0"],"iTotalRec":3} 3.2.3、字段名解释 iBatch:下家固定批次号,0-999;整数,可用于生成批次,如:20150111-000-3 cBatches:查询日期已经使用的“批次号”数组,倒序排列。 iTotalRec:“批次号”数组记录数 *** ReturnValue:1:成功;0:无查询结果 3.3、pdaRecCtrlCode 3.3.1、请求: {"RequestName":"pdaRecCtrlCode","cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","iKind":1,"cNo":"RM084310769CN","cCtrlCode":"JPS"} 3.3.1.1、变量名解释 iKind:运单号类型:0(内单号);1(转单号);2(参考号);3(报关号)。默认0。 cNo:运单号,7-30字符。必须! cCtrlCode:内控码,3字符。必须! 3.3.2、样例 3.3.2.2、响应: {"ReturnValue":24365,"iKind":1,"cNo":"RM084310769CN","cCtrlCode":"JPS"} 3.3.3、返回值含义 大于零:成功,记录ID(irID) 其它:失败。 3.4、pdaRecPromptQuery 3.4.1、请求: {"RequestName":"pdaRecPromptQuery","cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cqNum":"RP014195TT","iqType":0} 3.4.1.1、变量名解释 iqType:操作类别:0(复重);1(录单);2(发送);3(查询)。默认0。 cqNum:运单号,7-30字符。必须! iqcID:客户筛选,提供则筛选该客户的自行录入提示及本公司员工的普通提示记录 3.4.2、样例 3.4.2.2、响应: {"ReturnValue":1,"iqType":0,"cqNum":"RP014195TT","iqcID":0,"RecList":[{"dDate":"2010-10-10 14:23:23","cMark":"快件到达","cMemo":"快件丢失","cInput":"预置账号","icID":0}],"iTotalRec":1} 3.4.3、返回值含义 0:无结果 1:有操作提示 其它:失败。 3.4.4、返回值变量名解释 iTotalRec:操作提示记录数 cInput:录入者,如果为客户自行录入,此为空 icID:客户ID,如果为客户自行录入,此大于零 3.5、pdaRecSend 3.5.1、请求: {"RequestName":"pdaRecSend","cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","isID":1,"cBatch":"150213-000-0","cNum":"UU30889579","bCheckDes":true} 3.5.1.1、变量名解释 isID:下家ID,在EMMis中,下家档案管理由系统产生的唯一识别。必须。通过“pdaSpInfo”查询。 cNum:运单号,7-30字符,必须。由“ bNo”决定其为内单号还是转单号。 cBatch:批次号,12字符,必须。固定格式:“YYMMDD-NNN-N”(年月日-下家固定批次[000-999]-当日批次[0-9])。通过“pdaSpBatch”查询。 cEmsKind:快递类别,如提供,则更换。 cBearer:派件人,如提供,则更新。 cNextPoint:下一站点名称,如提供,则设置“检查点”。 fWeights:出重,三位小数,如提供,则更新。 bCredit:是否检查客户信用,默认否。逻辑值:true/false,如设置为“true”,则操作者选择后,必须设置为“false”才能完成操作 bNo:是否为转单号,默认否。逻辑值:true/false bSpCheck:是否检查下家成本优化或分拣,默认否。逻辑值:true/false bCost:是否(强制重新)计算成本,默认否。逻辑值:true/false bCheckWeight:是否检查重量,默认否。逻辑值:true/false,如设置为“true”,则操作者选择后,必须设置为“false”才能完成操作 bCheckDes:是否检查目的地,默认否。逻辑值:true/false 3.5.2、样例 3.5.2.2、响应: {"ReturnValue":23923,"cNum":"UU30889579","cNo":"UU30889579","cDes":"美国","cEmsKind":"EMS国际","fWeight":1.500,"nItemType":1,"iItem":1,"cAWB":"","cGoods":"测试物品4","cPacking":"","cTransNote":"1","cMark":"测试提示","cMemo":""} 3.5.3、返回值含义 大于零:成功,快递记录的ID(irID) -12:运单号(cNum)太短 -13:批次号(cBatch)错 其它负数:失败,查看“cMess”成员变量的说明信息 3.5.4、返回值变量名解释 cNum:内单号 cNo:转单号 cAWB:总单号,打包后有值 cPacking:包装 cTransNote:托运备注 3.5.5、特别说明 *如有必要,可能需要择机请求“pdaRecPromptQuery” 3.6、pdaRecReWeight 3.6.1、请求: {"RequestName":"pdaRecReWeight","cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cNum":"CN1234567XX","fWeight":1.123} {"RequestName":"pdaRecReWeight","cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cNum":"CNEX1234567BB","iItem":2,"ItemList":[{"fxWeight":1.8},{"fxWeight":1.2,"ixLong":45,"ixWidth":15,"ixHeight":30}]} 3.6.1.1、变量名解释 cNum:运单号,7-30字符,必须。由“ bNo”决定其为内单号还是转单号。 cTaker:取件人,如提供,则更新。 fWeight:重量,三位小数。 iItem:件数,整数。 bEmsKindc:是否按客户要的快递类别计价,默认否。逻辑值:true/false bPriceCalc:是否强制重新计价,默认是。逻辑值:true/false bNo:是否为转单号,默认否。逻辑值:true/false cNo:转单号,如提供(7-30字符),则换单。 **ItemList:快件分单信息列表,为0-N个分单信息对象 #如果长宽高等分单信息,需要此对象描述 fxWeight:重量(或称重),必须,且大于零。 ixLong:长,整数,厘米。 ixWidth:宽,整数,厘米。 ixHeight:高,整数,厘米。 cxGoods:物品描述,0-63字符。 ixQuantity:物品数量。 fxPrice:物品单价,2位小数。 cxGoodsA:物品别名,通常为英文描述,0-63字符。 cxGCodeA:物品甲码,通常为HS编码,0-63字符。 cxGCodeB:物品乙码,通常为统一编码,0-63字符。 cxGCodeC:物品丙码,通常为客户编码,0-63字符。 fxGCustom:关税额,2位小数。 fxGCRate:税率,4位小数。 cxNum:分内单号,0-30字符。 cxNo:分转单号,0-30字符。 cxRNo:分参考号,0-30字符。 3.6.2、样例 3.6.2.2、响应: {"ReturnValue":24553,"irID":24553,"cNum":"CN1234567XX","cNo":"EM123456789CN","cDes":"美国","cEmsKind":"UPS","fWeight":1.123,"nItemType":1,"iItem":1,"fAmount":221.20} {"ReturnValue":24315,"irID":24315,"cNum":"CNEX1234567BB","cNo":"CNEX1234567BB","cDes":"奥地利","cEmsKind":"UPS","fWeight":5.170,"nItemType":1,"iItem":2,"fAmount":678.33} 3.6.3、返回值含义 大于零:成功,快递记录的ID(irID) -12:运单号(cNum)太短 -14:数据检查,不能复重核价。原因查看“cMess” 其它负数:失败,查看“cMess”成员变量的说明信息 3.6.4、返回值变量名解释 cNum:内单号 cNo:转单号 cDes:目的地 cEmsKind:快递类别 fWeight:计价重量 nItemType:快件类型 iItem:件数 fAmount:总运费 3.6.5、特别说明 *如有必要,可能需要择机请求“pdaRecPromptQuery” 3.7、pdaRecReWeightPre 3.7.1、请求: {"RequestName":"pdaRecReWeightPre","cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cNum":"HH000010609C2","fWeight":2.4} {"RequestName":"pdaRecReWeightPre","cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cNum":"LS000000228SH","iItem":2,"ItemList":[{"fxWeight":1.33},{"fxWeight":1.5,"ixLong":40,"ixWidth":20,"ixHeight":30}]} 3.7.1.1、变量名解释 cNum:运单号,7-30字符,必须。由“ bNo”决定其为内单号还是转单号。 icID:客户id,如提供,则增加此查询条件。 cTaker:取件人,如提供,则更新。 fWeight:重量,三位小数。 iItem:件数,整数。 bEmsKindc:是否按客户要的快递类别计价,默认否。逻辑值:true/false bPriceCalc:是否强制重新计价,默认是。逻辑值:true/false bNo:是否为转单号,默认否。逻辑值:true/false cNo:转单号,如提供(7-30字符),则换单。 **ItemList:快件分单信息列表,为0-N个分单信息对象,参阅:3.6.1.1 3.7.2、样例 3.7.2.2、响应: {"ReturnValue":1698,"irID":24586,"cNum":"HH000010609C2","cNo":"HH000010609C2","cDes":"俄罗斯","cEmsKind":"EMS国际","fWeight":2.400,"nItemType":1,"iItem":1,"fAmount":331.70} {"ReturnValue":1675,"irID":24587,"cNum":"LS000000228SH","cNo":"155012780010292","cDes":"英国","cEmsKind":"UPS","fWeight":5.330,"nItemType":1,"iItem":2,"fAmount":678.33} 3.7.3、返回值含义 大于零:成功,预录单记录的ID(iID) -2:预录记录不存在或不符合筛选条件 -12:运单号(cNum)太短 -14:数据检查,不能复重核价。原因查看“cMess” 其它负数:失败,查看“cMess”成员变量的说明信息 3.7.4、返回值变量名解释 cNum:内单号 cNo:转单号 cDes:目的地 cEmsKind:快递类别 fWeight:计价重量 nItemType:快件类型 iItem:件数 fAmount:总运费 3.7.5、特别说明 *如有必要,可能需要择机请求“pdaRecPromptQuery” 3.8、pdaRecReWeightTrans 3.8.1、请求: {"RequestName":"pdaRecReWeightTrans","cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cNum":"ER000000204CN","fWeight":3.12} {"RequestName":"pdaRecReWeightTrans","cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cNum":"TR0010000246SH","iItem":2,"ItemList":[{"fxWeight":1.12},{"fxWeight":1.9,"ixLong":49,"ixWidth":23,"ixHeight":30}]} 3.8.1.1、变量名解释 cNum:指令单号,7-30字符,必须。 icID:客户id,如提供,则增加此查询条件。 cTaker:取件人,如提供,则更新。 fWeight:重量,三位小数。 iItem:件数,整数。 bPriceCalc:是否强制重新计价,默认是。逻辑值:true/false cNo:转单号,如提供(7-30字符),则换单。 **ItemList:快件分单信息列表,为0-N个分单信息对象,参阅:3.6.1.1 3.8.2、样例 3.8.2.2、响应: {"ReturnValue":51,"irID":24595,"cNum":"ER000000204CN","cNo":"","cDes":"沙特阿拉伯","cEmsKind":"EMS国际","fWeight":3.120,"nItemType":1,"iItem":3,"fAmount":508.02} {"ReturnValue":47,"irID":24596,"cNum":"TR0010000246SH","cNo":"","cDes":"中国","cEmsKind":"EMS国际","fWeight":6.750,"nItemType":1,"iItem":2,"fAmount":556.46} 3.8.3、返回值含义 大于零:成功,转发打包指令记录的ID(iID) -2:预录记录不存在或不符合筛选条件 -12:运单号(cNum)太短 -14:数据检查,不能复重核价。原因查看“cMess” 其它负数:失败,查看“cMess”成员变量的说明信息 3.8.4、返回值变量名解释 cNum:内单号 cNo:转单号 cDes:目的地 cEmsKind:快递类别 fWeight:计价重量 nItemType:快件类型 iItem:件数 fAmount:总运费 3.8.5、特别说明 *如有必要,可能需要择机请求“pdaRecPromptQuery” 3.9、pdaRecMod 3.9.1、请求: {"RequestName":"pdaRecMod","cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cNum":"CN1234567XX","cRNo":"TEST0001","cMark":"ok_Mark"} 3.9.1.1、变量名解释 cNum:运单号,7-30字符,必须。由“ bNo”决定其为内单号还是转单号。 icID:客户id,如提供,则增加此查询条件。 bNotDelivered:不操作已经签收的记录,默认否(不检查)。逻辑值:true/false bNo:是否为转单号,默认否。逻辑值:true/false *如下为可更改的字段,至少提供一个,可以提供空值,一旦提供,就将更改该字段! cNo:转单号,7-30字符。 cRNo:参考号,0-30字符。 cCNo:报关号,0-30字符。 cMark:标签,0-15字符。 cReserve:留用串,0-30字符。 cBy1:备用1,0-63字符。 cBy2:备用2,0-63字符。 cBy3:备用3,0-63字符。 cBy4:备用4,0-63字符。 cBy5:备用5,0-254字符。 cPacking:包装,0-15字符。 cTransNote:托运备注,0-63字符。 cSender:发件人,0-30字符。 cSUnit:发件单位,0-127字符。 cSAddr:发件地址,0-127字符。 cSCity:发件城市,0-63字符。 cSPostcode:发件邮编,0-15字符。 cSProvince:发件省州,0-30字符。 cSCountry:发件国家,0-63字符。 cSPhone:发件电话,0-63字符。 cSEMail:发件电邮,0-63字符。 cSSms:发件短信,0-22字符。 cDepart:所属部门,0-30字符。 3.9.2、样例 3.9.2.2、响应: {"ReturnValue":24553,"irID":24553,"cNum":"CN1234567XX","cNo":"EM123456789CN","nState":0,"iUpdate":2} 3.9.3、返回值含义 大于零:成功,快递记录的ID(irID) -12:运单号(cNum)太短 -13:没有提交更改的字段 -14:数据检查,操作者站点与业务记录客户所属站点不符 -15:数据检查,记录已经签收 3.9.4、返回值变量名解释 cNum:内单号 cNo:转单号 nState:快件状态 iUpdate:更新字段数 3.10、pdaRecReturn 3.10.1、请求: {"RequestName":"pdaRecReturn","cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cNum":"RX747730871DE","fWeight":3.9,"cDepot":"A11","cMark":"Test_Depot"} {"RequestName":"pdaRecReturn","cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cNum":"DINGDAN1112235","fWeight":76.1,"cDepot":"A11","bSysDate":true,"cInfo":"Return to sender."} 3.10.1.1、变量名解释 cNum:运单号,7-30字符,必须。由“ bNo”决定其为内单号还是转单号。 bNo:是否为转单号,默认否。逻辑值:true/false fWeight:重量 cCtrlCode:内控码(0-3字母),如提供,则给业务记录打上内控码 *如下仓库相关 cDepot:仓库编号(0-3字母),如提供,则进行仓库入库操作 cBatch:入库记录批次号(0-30字节) cMark:入库记录标签(0-15字节) cMemo:入库记录备注(0-254字节) *如下追踪信息相关 bSysDate:追踪记录日期时间使用服务器系统时间。逻辑值:true/false cDate:追踪记录日期时间(0-30字节,建议格式为 YYYY-MM-DD hh:mm) cInfo:追踪记录详细信息中文(0-254字节),提供则操作 cPlace:追踪记录操作地点中文(0-126字节) cInfoE:追踪记录详细信息英文(0-254字节),提供则操作 cPlaceE:追踪记录操作地点英文(0-126字节) 3.10.2、样例 3.10.2.2、响应: {"ReturnValue":24649,"irID":24649,"ioID":0,"cDepot":"A11","iinID":24649,"cNum":"RX747730871DE","cNo":"RX747730871DE","cDes":"英国","cEmsKind":"皇家邮政","cGoods":"硬粒小麦","fWeight":4.000,"fWeights":4.000,"nItemType":1,"iItem":1,"fAmount":44.00} {"ReturnValue":24017,"irID":24017,"ioID":65,"cDepot":"A11","iinID":24017,"cNum":"DINGDAN1112235","cNo":"","cDes":"美国","cEmsKind":"EMS国际","cGoods":"被子","fWeight":76.650,"fWeights":76.650,"nItemType":1,"iItem":1,"fAmount":713.00} 3.10.3、返回值含义 大于零:成功,快递记录的ID(irID) -14:操作失败。原因查看“cMess” 3.10.4、返回值变量名解释 cNum:内单号 cNo:转单号 ioID:仓库关联订单号,如果大于零,则为仓库订单物品,反向操作完成。 iinID:仓库入库记录ID,如果大于零,则成功入仓,可能为“退件”包裹。 fWeight:业务记录入重。 fWeights:业务记录出重。 3.11、pdaTransRcv 3.11.1、请求: {"RequestName":"pdaTransRcv","cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cNo":"GD167586174WW","fWeight":3.772,"cShelf":"XZ-A11","cMemo":"Test_Memo"} 3.11.1.1、变量名解释 cNo:运单号,7-30字符,必须。来自的单号。如查询不到,icID大于零直接创建一条已经确认到件的转发记录,否则创建未认领到件记录。 fWeight:重量 iLong:长,整数,厘米。 iWidth:宽,整数,厘米。 iHeight:高,整数,厘米。 iItem:件数,默认1 cShelf:架位,0-30字节,最好提供。 cMemo:备注,0-254字节 icID:客户ID。默认0。如提供:则为筛选条件。 cMark:标签,0-15字节 cEmsKind_f:来自渠道,0-15字节 3.11.2、样例 3.11.2.2、响应: {"ReturnValue":2188865,"cNo":"GD167586174WW","icID":79,"cEmsKind_f":"天地中国","cMemo":"Test_Memo"} 3.11.3、返回值含义 大于零:成功,转发记录ID -12:运单号不合法(7-30) -14:操作失败。原因查看“cMess” -15:站点错误,操作失败。 -16:已经确认到件,操作失败。 3.11.4、返回值变量名解释 cNo:内单号 icID:关联客户ID,如果等于零,则为未认领到件记录。 cEmsKind_f:来自网络。 cMemo:备注,原始记录备注优先。 3.12、pdaTransShelfPut 3.12.1、请求: {"RequestName":"pdaTransShelfPut","cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cNo":"CP255628820CN","cShelf":"XZ-B01"} 3.12.1.1、变量名解释 cNo:运单号,7-30字符,必须。来自的单号。 cShelf:架位,1-30字节,必须。 icID:客户ID。默认0。如提供:则为筛选条件。 3.12.2、样例 3.12.2.2、响应: {"ReturnValue":2188859,"cNo":"CP255628820CN","cShelf_o":"XZ-A11","cShelf":"XZ-B01","icID":79,"cEmsKind_f":"珲春邮政","cMemo":"Test_Memo"} 3.12.3、返回值含义 大于零:成功,转发记录ID -12:运单号不合法(7-30) -13:架位不合法(1-30) -14:操作失败。原因查看“cMess” -15:站点错误,操作失败。 3.12.4、返回值变量名解释 cNo:内单号 cShelf_o:原架位。 cShelf:新架位。 icID:关联客户ID。 cEmsKind_f:来自网络。 cMemo:备注。 3.13、pdaTransBagOut 3.13.1、请求:同“3.8、pdaRecReWeightTrans” 3.14、pdawShelfPut 3.14.1、请求: {"RequestName":"pdawShelfPut","cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cDepot":"A11","cShelf":"XZ-C45","cgCode":"FDH42343233455"} 3.14.1.1、变量名解释 cShelf:架位,1-15字节,必须。通常条码扫描。 cgCode:物品统一编码,1-63字节,必须。通常条码扫描。 csCode:物品序列号,0-63字节。通常条码扫描。如有,则进行序列号物品的唯一性检查和处理。 3.14.2、样例 3.14.2.2、响应: {"ReturnValue":13,"iwsioID":"2","cDepot":"A11","cShelf":"XZ-C45","cgCode":"FDH42343233455","csCode":""} 3.14.3、返回值含义 大于零:成功,物品通用定义记录ID(iwGiid,在EMMis系统中,客户物品初次定义时,由系统产生,全系统唯一识别) -12:物品统一编码不合法(1-63) -13:架位不合法(1-30) -14:操作失败。原因查看“cMess” 3.14.4、返回值变量名解释 iwsioID:物品上架记录ID,8字节大整数,所以此处以字符串定义,避免程序溢出。 3.15、pdawShelfGet 3.15.1、请求: {"RequestName":"pdawShelfGet","cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cDepot":"A11","cShelf":"XZ-C45","cgCode":"FDH42343233455"} 3.15.1.1、变量名解释 cShelf:架位,1-15字节,必须。通常条码扫描。 cgCode:物品统一编码,1-63字节,必须。通常条码扫描。 csCode:物品序列号,0-63字节。通常条码扫描。如有,则进行序列号物品的唯一性检查和处理。 3.15.2、样例 3.15.2.2、响应: {"ReturnValue":13,"iwsioID":"1","cDepot":"A11","cShelf":"XZ-C45","cgCode":"FDH42343233455","csCode":""} 3.15.3、返回值含义 大于零:成功,物品通用定义记录ID(iwGiid,在EMMis系统中,客户物品初次定义时,由系统产生,全系统唯一识别) -12:物品统一编码不合法(1-63) -13:架位不合法(1-15) -14:操作失败。原因查看“cMess” 3.15.4、返回值变量名解释 iwsioID:物品下架记录ID,8字节大整数,所以此处以字符串定义,避免程序溢出。 3.16、pdawShelfQuery 3.16.1、请求: {"RequestName":"pdawShelfQuery","cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cDepot":"A11","cqShelf":"XZ-C45"} 3.16.1.1、变量名解释 cqShelf:查询架位,1-15字节,必须。通常条码扫描。 3.16.2、样例 3.16.2.2、响应: {"ReturnValue":1,"cDepot":"A11","cqShelf":"XZ-C45","RecList":[{"iwGiid":13,"iCount":2,"cgCode":"FDH42343233455","cgName":"被子"}],"iTotalRec":1} 3.16.3、返回值含义 0:成功,无查询结果。 1:成功,有结果。记录数为iTotalRec 小于零:失败。 -13:架位不合法(1-15) 3.16.4、返回值变量名解释 RecList:在架物品统计汇总列表。 iwGiid:可存物品ID iCount:在架数量 cgCode:物品统一编码 cgName:物品名称 iTotalRec:汇总列表记录数 3.17、pdawShelfGoods 3.17.1、请求: {"RequestName":"pdawShelfGoods","cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cDepot":"A11","cqgCode":"FDH42343233455"} 3.17.1.1、变量名解释 cqgCode:查询物品统一编码,1-63字节,必须。通常条码扫描。 3.17.2、样例 3.17.2.2、响应: {"ReturnValue":1,"cDepot":"A11","cqgCode":"FDH42343233455","RecList":[{"iwGiid":13,"iCount":2,"cShelf":"XZ-C45","cgName":"被子"}],"iTotalRec":1} 3.17.3、返回值含义 0:成功,无查询结果。 1:成功,有结果。记录数为iTotalRec 小于零:失败。 -12:物品统一编码不合法(1-63) 3.17.4、返回值变量名解释 RecList:在架物品统计汇总列表。 iwGiid:可存物品ID iCount:在架数量 cShelf:架位 cgName:物品名称 iTotalRec:汇总列表记录数 3.18、pdawClientInfo 3.18.1、请求: {"RequestName":"pdawClientInfo","cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cDepot":"A11","cqAccount":"t"} 3.18.1.1、变量名解释 cqAccount:客户账号包含,0-30字节。 cqUnitName:客户名称包含,0-63字节。 *上面两个筛选条件至少定义一个! 3.18.2、样例 3.18.2.2、响应: {"ReturnValue":1,"cDepot":"A11","cqAccount":"t","cqUnitName":"","RecList":[{"icID":79,"cAccount":"test","cUnitName":"调试专用","cShelfb":"AVV41242","cShelfe":"AVV41242","cLink":"cc","cPhone":"5234543534","cMark":"现金赔偿","cMemo":"隔天发送"},{"icID":128,"cAccount":"ZDT","cUnitName":"州大头","cShelfb":"A232132","cShelfe":"Z423424","cLink":"","cPhone":"","cMark":"","cMemo":""},{"icID":106,"cAccount":"tt","cUnitName":"tian tai王","cShelfb":"","cShelfe":"","cLink":"fff","cPhone":"1223233333","cMark":"快件到达","cMemo":"测试第一项|上海"}],"iTotalRec":3} 3.18.3、返回值含义 0:成功,无查询结果。 1:成功,有结果。记录数为iTotalRec 小于零:失败。 -12:无筛选条件 3.18.4、返回值变量名解释 RecList:符合条件的仓库客户列表。 icID:客户ID cAccount:客户账号 cUnitName:客户名称 cShelfb:客户专属架位起点 cShelfe:客户专属架位终点 cLink:客户仓库业务相关联系人 cPhone:客户仓库业务相关联系电话 cMark:标签 cMemo:备注 3.19、pdawGoodsInfo 3.19.1、请求: {"RequestName":"pdawGoodsInfo","cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cDepot":"A11","cqgCode":"HGG42343214"} 3.19.1.1、变量名解释 iqwGiid:物品ID。 cqgCode:物品统一编码,0-63字节。 *上面两个筛选条件至少定义一个!或者下面两个参数 cqAccount:EMMis中客户账号,1-30字节。 cqcCode:物品客户编码,1-63字节。 3.19.2、样例 3.19.2.2、响应: {"ReturnValue":1,"cDepot":"A11","iqwGiid":0,"cqgCode":"HGG42343214","icID":79,"iwGiid":1,"cgName":"打火机","cgNameE":"flight","cgCode":"HGG42343214","ccCode":"BBFSA4243214","cUnit":"个","bSerial":false,"cColor":"红","cSize":"ML","cBrand":"沱沱","cModel":"M-180","fWeight":0.010,"iLong":100,"iWidth":200,"iHeight":500,"cShelf":"XZ-AB11","iStoryB":1,"iStoryE":1,"iColumnB":1,"iColumnE":1,"iEDays":365,"iEDays":365,"iIn":9,"iOut":20,"cMark":"快件离开","cMemo":"退件"} 3.19.3、返回值含义 0:成功,无查询结果。 1:成功,有结果。 小于零:失败。 -12:无筛选条件 3.19.4、返回值变量名解释 icID:客户ID iwGiid:物品ID。 cgName:物品名称 cgNameE:物品名称英文 cgCode:物品统一编码 ccCode:物品客户(系统)编码 cUnit:计量单位 bSerial:是否有序列号(唯一序列号物品) cColor:颜色 cSize:尺寸 cBrand:品牌 cModel:型号 fWeight:重量 iLong:长 iWidth:宽 iHeight:高 cShelf:架位 iStoryB:起点层 iStoryE:终点层 iColumnB:起点列 iColumnE:终点列 iEDays:保质期(天) iIn:入库总数 iOut:出库总数 cMark:归库标签 cMemo:归库备注 3.20、pdawInPick 3.20.1、请求: {"RequestName":"pdawInPick","cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cDepot":"A11","cRNo":"SS44556677BB","iNormal":12} 3.20.1.1、变量名解释 cRNo:预录库记录参考号,1-30字节,必须。通常条码扫描。 iNormal:正品数。 iDefective:次品数。 3.20.2、样例 3.20.2.2、响应: {"ReturnValue":1,"cDepot":"A11","cRNo":"SS44556677BB","iID":94,"fPick":12.50,"iQuantity":12,"iNormal":12,"iDefective":0,"cMark":"MM","cMemo":"OO,334","icID":79,"iwGiid":2,"cgName":"电视机","cgNameE":"TV Set","cgCode":"DFASFASDFAS","cUnit":"台","cColor":"COLOR","cSize":"SIZE","cBrand":"BRAND","cModel":"MODEL","fWeight":25.000,"iLong":5000,"iWidth":10000,"iHeight":12000} 3.20.3、返回值含义 0:无查询结果。 1:成功。 -12:参考号不合法(1-30) -13:正品数+次品数 小于1 -14:操作失败。原因查看“cMess” -15:记录未审核 3.20.4、返回值变量名解释,参阅3.19.4 iID:预录库记录ID。 fPick:取件费 iQuantity:物品总数量 cMark:预录库记录标签 cMemo:预录库记录备注 3.21、pdawInCheck 3.21.1、请求: {"RequestName":"pdawInCheck","cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cDepot":"A11","cRNo":"SS44556677BB","iNormal":12} 3.21.1.1、变量名解释 cRNo:预录库记录参考号,1-30字节,必须。通常条码扫描。 iNormal:正品数。 iDefective:次品数。 3.21.2、样例 3.21.2.2、响应: {"ReturnValue":1,"cDepot":"A11","cRNo":"SS44556677BB","iID":94,"fQCIn":4.50,"iQuantity":12,"iNormal":12,"iDefective":0,"cMark":"MM","cMemo":"OO,334","icID":79,"iwGiid":2,"cgName":"电视机","cgNameE":"TV Set","cgCode":"DFASFASDFAS","cUnit":"台","cColor":"COLOR","cSize":"SIZE","cBrand":"BRAND","cModel":"MODEL","fWeight":25.000,"iLong":5000,"iWidth":10000,"iHeight":12000} 3.21.3、返回值含义 0:无查询结果。 1:成功。 -12:参考号不合法(1-30) -13:正品数+次品数 小于1 -14:操作失败。原因查看“cMess” -15:记录未审核 3.21.4、返回值变量名解释,参阅3.19.4 iID:预录库记录ID。 fQCIn:入库质检费 iQuantity:物品总数量 cMark:预录库记录标签 cMemo:预录库记录备注 3.22、pdawInConfirm 3.22.1、请求: {"RequestName":"pdawInConfirm","cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cDepot":"A11","cRNo":"PP43338888UU","iNormal":23} 3.22.1.1、变量名解释 cRNo:预录库记录参考号,1-30字节,必须。通常条码扫描。 iNormal:正品数。 iDefective:次品数。 cShelf:架位,0-15字节。如提供,则更新归库物品的架位。 cConfirm:入库交接人姓名,如果仓库定义了“入库确认必须有交接人”,则必提供。 cPassword:入库交接人密码,如果仓库定义了“入库确认必须有交接人”,则必提供。 3.22.2、样例 3.22.2.2、响应: {"ReturnValue":1,"cDepot":"A11","cRNo":"PP43338888UU","cShelf":"A1-01","cConfirm":"","iID":95,"iQuantity":23,"iNormal":23,"iDefective":0,"cMark":"","cMemo":"","icID":79,"iwGiid":3,"cgName":"火锅","cgNameE":"","cgCode":"33HH5254242","cUnit":"口","cColor":"","cSize":"","cBrand":"","cModel":"","fWeight":0.000,"iLong":0,"iWidth":0,"iHeight":0} 3.22.3、返回值含义 0:无查询结果。 1:成功。 -12:参考号不合法(1-30) -13:正品数+次品数 小于1 -14:操作失败。原因查看“cMess” -15:记录未审核 -16:正品数和次品数与预录库记录不一致 3.22.4、返回值变量名解释,参阅3.19.4 iID:预录库记录ID。 iQuantity:物品总数量 cMark:预录库记录标签 cMemo:预录库记录备注 3.23、pdawShelfChange 3.23.1、请求: {"RequestName":"pdawShelfChange","cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cDepot":"A11","cqgCode":"HGG42343214","cShelf":"XZ-AB11","cMark":"TestMark."} 3.23.1.1、变量名解释 iqwGiid:物品ID。 cqgCode:物品统一编码,0-63字节。 *上面两个查询条件至少定义一个!或者下面两个参数 cqAccount:EMMis中客户账号,1-30字节。 cqcCode:物品客户编码,1-63字节。 cShelf:架位,1-30字节,必须。通常条码扫描。 iStoryB:起点层(1-255),默认1。 iStoryB:起点层(1-255),默认1。 iColumnB:起点列(1-30000),默认1。 iColumnE:终点列(1-30000),默认1。 cMark:归库标签,0-15字节,提供则更新。 cMemo:归库备注,0-254字节,提供则更新。 3.23.2、样例 3.23.2.2、响应: {"ReturnValue":1,"cDepot":"A11","iqwGiid":0,"cqgCode":"HGG42343214","cShelf":"XZ-AB11","iStoryB":1,"iStoryE":1,"iColumnB":1,"iColumnE":1,"icID":79,"iID":1,"iwGiid":1,"cgName":"打火机","cgNameE":"flight","cgCode":"HGG42343214","ccCode":"BBFSA4243214","cColor":"红","cSize":"ML","cBrand":"沱沱","cModel":"M-180","fWeight":0.010,"iLong":100,"iWidth":200,"iHeight":500,"cShelf_o":"XZ-AB11","iStoryB_o":1,"iStoryE_o":1,"iColumnB_o":1,"iColumnE_o":1,"cMark":"TestMark.","cMemo":"退件"} 3.23.3、返回值含义 0:无查询结果。 1:成功。 -12:无查询条件 -13:架位不合法(1-30字节) 3.23.4、返回值变量名解释,参阅3.19.4 iID:物品归库记录ID。 xxx_o:架位相关字段的原始值 3.24、pdawCartInfo 3.24.1、请求: {"RequestName":"pdawCartInfo","cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cDepot":"A11","iqCartID":35,"bListGoods":true,"bListOrder":true} 3.24.1.1、变量名解释 iqCartID:捡货车流水号(ID),必须。 bListGoods:统计汇总物品,列表(GoodsList),默认false,不列。 bListOrder:查询订单,列表(OrderList),默认false,不列。 3.24.2、样例 3.24.2.2、响应: {"ReturnValue":1,"cDepot":"A11","iqCartID":35,"iState":3,"iOrder":4,"iCatgory":2,"iQuantity":8,"dInput":"2015-03-23 17:50:39","cInput":"预置账号","dPrint":"","cPrint":"","dChoose":"2015-03-25 15:53:02","cChoose":"王蕾","cOper":"王蕾","cConfirm":"","cMark":"TestMark","GoodsList":[{"iwGiid":2,"cgName":"电视机","cgCode":"DFASFASDFAS","ccCode":"DFHH442","cgKind":"","cgModel":"","cShelf":"A1-04","iClomn":4,"iStory":7,"iQuantity":8,"cMark":"","cMemo":"","icID":79},{"iwGiid":13,"cgName":"被子","cgCode":"FDH42343233455","ccCode":"FDH42343233","cgKind":"","cgModel":"","cShelf":"A1-05","iClomn":0,"iStory":0,"iQuantity":8,"cMark":"","cMemo":"","icID":79}],"OrderList":[{"ioID":14,"icID":79,"cNum":"TEST12333333","cNo":"EL891551507CS","cEmskind":"EMS国际","cDes":"美国","cReceiver":"收件姓名","cGoods":"电视机","iQuantity":2,"iCategory":1,"cPack":"","cTransNote":"2","cMark":"测试ccc","cMemo":"fffggggg"},{"ioID":17,"icID":79,"cNum":"OOPP233333","cNo":"ES719039679CS","cEmskind":"EMS国际","cDes":"美国","cReceiver":"骤降faf","cGoods":"电视机","iQuantity":2,"iCategory":1,"cPack":"纸箱包装","cTransNote":"2","cMark":"测试ccc","cMemo":""},{"ioID":48,"icID":79,"cNum":"UU42342343","cNo":"ES719039705CS","cEmskind":"EMS国际","cDes":"美国","cReceiver":"号hhhh","cGoods":"被子","iQuantity":3,"iCategory":1,"cPack":"","cTransNote":"3","cMark":"测试ccc","cMemo":""},{"ioID":51,"icID":79,"cNum":"GG312312313","cNo":"ES719039736CS","cEmskind":"EMS国际","cDes":"","cReceiver":"aaa","cGoods":"被子","iQuantity":1,"iCategory":1,"cPack":"","cTransNote":"","cMark":"测试ccc","cMemo":""}]} 3.24.3、返回值含义 0:成功,无查询结果。 1:成功,有结果。 小于零:失败。 -12:捡货车流水号(ID)错误 3.24.4、返回值变量名解释 iOrder:订单数 iCatgory:所含物品种类数。 dInput:捡货车创建时间 cInput:捡货车创建者 dPrint:打印时间 cPrint:打印者 dChoose:捡货时间 cChoose:捡货者 *GoodsList:物品统计汇总列表,变量名解释参阅3.19.4 cgKind:物品类别 cgModel:物品型号 cShelf:归库架位 iClomn:归库列 iStory:归库层 cMark:归库标签 cMemo:归库备注 *OrderList:订单列表 ioID:订单ID cNum:订单号 cNo:转单号 iCategory:订单所含物品种类数。 cPack:包装 cTransNote:托运备注 cMark:标签 cMemo:备注 3.25、pdawCartChoose 3.25.1、请求: {"RequestName":"pdawCartChoose","cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cDepot":"A11","iqCartID":35,"cMark":"TestMark"} 3.25.1.1、变量名解释 iqCartID:捡货车流水号(ID),必须。 cChoose:捡货人姓名,0-30,默认为当前操作者。 cMark:捡货标签,0-15,提供则更新。 3.25.2、样例 3.25.2.2、响应: {"ReturnValue":1,"cDepot":"A11","iqCartID":35,"iState":0,"iOrder":4,"iCatgory":2,"iQuantity":8,"cMark":""} 3.25.3、返回值含义 0:成功,无查询结果。 1:成功,有结果。 小于零:失败。 -12:捡货车流水号(ID)错误 -14:操作失败。原因查看“cMess” 3.25.4、返回值变量名解释 iOrder:订单数 iCatgory:所含物品种类数。 cMark:原捡货标签 3.26、pdawOrderInfo 3.26.1、请求: {"RequestName":"pdawOrderInfo","cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cDepot":"A11","cNum":"HH442343242KK","bListGoods":true} 3.26.1.1、变量名解释 iqoID:订单流水号(ID)。 cNum:运单号,7-30字符。由“ bNo”决定其为订单号还是转单号。 *以上两个查询条件至少提供一个。 bNotDelivered:不操作已经签收的记录,默认否(不检查)。逻辑值:true/false bNo:是否为转单号,默认否。逻辑值:true/false bListGoods:是否物品列表(GoodsList),默认false,不列。 3.26.2、样例 3.26.2.2、响应: {"ReturnValue":1,"cDepot":"A11","ioID":53,"icID":79,"iState":0,"iCartID":0,"cNum":"HH442343242KK","cNo":"EL891551500CS","cRNo":"","cCNo":"","cBatch":"","cDes":"","cEmsKind":"EMS国际","dInput":"2013-04-07 00:00:00","cInput":"预置账号","cReceiver":"","cGoods":"刮胡刀,被子","iQuantity":2,"cPack":"","cTransNote":"1,1","cGoodsA":"dfs","cGCodeA":"aaa","cGCodeB":"bbb","cGCodeC":"ccc","cBy1":"","cBy2":"","cBy3":"","cBy4":"","cBy5":"","cMark":"测试ccc","cMemo":"","GoodsList":[{"iwGiid":6,"cgName":"刮胡刀","cgCode":"GG45423324","ccCode":"KK42343242","cShelf":"A1-05","iColume":1,"iStory":1,"cUnit":"","bSerial":false,"cEx1":"","iQuantity":1,"cMark":"","cMemo":"","icID":87},{"iwGiid":13,"cgName":"被子","cgCode":"FDH42343233455","ccCode":"FDH42343233","cShelf":"A1-05","iColume":0,"iStory":0,"cUnit":"床","bSerial":false,"cEx1":"","iQuantity":1,"cMark":"","cMemo":"","icID":79}]} 3.26.3、返回值含义 0:成功,无查询结果。 1:成功,有结果。 小于零:失败。 -12:无查询条件 3.26.4、返回值变量名解释 ioID:订单ID iCartID:捡货车ID,如有则已构造捡货车 cNo:转单号 cRNo:参考号 cCNo:报关号 cBatch:批次 dInput:创建时间 cInput:创建者 cPack:包装 cTransNote:托运备注 cGoodsA:物品别名 cGCodeA:物品甲码 cGCodeB:物品乙码 cGCodec:物品丙码 cBy1-cBy5:备用1 - 备用5 cMark:标签 cMemo:备注 *GoodsList:物品明细列表,变量名解释参阅3.19.4 cShelf:归库架位 iColume:归库列 iStory:归库层 cMark:归库标签 cMemo:归库备注 3.27、pdawCartConfirm 3.27.1、请求: {"RequestName":"pdawCartConfirm","cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cDepot":"A11","iqCartID":35} 3.27.1.1、变量名解释 iqCartID:捡货车流水号(ID),必须。 cOper:操作者姓名,0-30,默认为当前操作者。 cMark:捡货标签,0-15,提供则更新。 cConfirm:捡货交接人姓名,如果仓库定义了“捡货交接确认必须有交接人”,则必提供。 cPassword:捡货交接人密码,如果仓库定义了“捡货交接确认必须有交接人”,则必提供。 3.27.2、样例 3.27.2.2、响应: {"ReturnValue":1,"cDepot":"A11","iqCartID":35,"iState":2,"iOrder":4,"iCatgory":2,"iQuantity":8,"cMark":"TestMark"} 3.27.3、返回值含义 0:成功,无查询结果。 1:成功,有结果。 小于零:失败。 -12:捡货车流水号(ID)错误 -14:操作失败。原因查看“cMess” 3.27.4、返回值变量名解释 iOrder:订单数 iCatgory:所含物品种类数。 cMark:原捡货标签 3.28、pdawOrderOut 3.28.1、请求: {"RequestName":"pdawOrderOut","cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cDepot":"A11","cNum":"UU42342343"} 3.28.1.1、变量名解释 iqoID:订单流水号(ID)。 cNum:运单号,7-30字符。由“ bNo”决定其为订单号还是转单号。 *以上两个查询条件至少提供一个。 bNo:是否为转单号,默认否。逻辑值:true/false cConfirm:出库交接人姓名,如果仓库定义了“出库确认必须有交接人”,则必提供。 cPassword:出库交接人密码,如果仓库定义了“出库确认必须有交接人”,则必提供。 3.28.2、样例 3.28.2.2、响应: {"ReturnValue":1,"cDepot":"A11","icID":79,"ioID":48,"irID":24693,"cNum":"UU42342343","cNo":"ES719039705CS","cDes":"美国","cEmsKind":"EMS国际","iItem":1,"fWeight":5.110,"cGoods":"被子","iQuantity":3,"cTransNote":"3","cMark":"测试ccc","cMemo":""} 3.28.3、返回值含义 0:成功,无查询结果。 1:成功,有结果。 小于零:失败。 -12:无查询条件 -14:操作失败。原因查看“cMess” -15:订单未审核 -16:订单已出库 3.28.4、返回值变量名解释 ioID:订单ID irID:快递记录ID(同时创建快递单) 3.29、pdawMoveInfo 3.29.1、请求: {"RequestName":"pdawMoveInfo","cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cDepot":"A11","dqDateB":"2011.02.09"} 3.29.1.1、变量名解释 dqDateB:记录日期时间开始点,必须。 dqDateB:记录日期时间结束点。 cqNum:参考号,0-30字符,包含查询。 cqBatch:批次号,0-30字符,精确查询。 cqgCode:物品统一编码,0-63字符,精确查询。 bIn:移入还是移出(相对于当前操作者所在仓库),默认否(移出)。逻辑值:true/false bNoInSign:是否仅筛选未入库签名的记录,默认否。逻辑值:true/false bNoOutSign:是否仅筛选未出库签名的记录,默认否。逻辑值:true/false 3.29.2、样例 3.29.2.2、响应: {"ReturnValue":1,"cDepot":"A11","cqNum":"","cqBatch":"","cqgCode":"","dqDateB":"2011.02.09 0:0:0.0","dqDateE":"","bIn":false,"bNoInSign":false,"bNoOutSign":false,,"RecList":[{"imID":2,"iX":1,"cDepotf":"A11","cDepotd":"HH2","cNum":"PP42333333388GG","iwGiid":13,"cgName":"被子","cgCode":"FDH42343233455","cUnit":"床","iQuantity":987,"iNormal":987,"iDefictive":0,"dDate":"2015-03-26 16:19:41","cInput":"ppp","dOut":"2015-03-26 16:48:04","cOut":"王蕾","dIn":"2015-03-26 16:40:07","cIn":"王蕾","cBatch":"B2015032616","cMark":"mark","cMemo":"memo"},{"imID":1,"iX":4,"cDepotf":"A11","cDepotd":"HH2","cNum":"kk77777777","iwGiid":2,"cgName":"电视机","cgCode":"DFASFASDFAS","cUnit":"台","iQuantity":2,"iNormal":2,"iDefictive":0,"dDate":"2013-09-24 17:52:41","cInput":"预置账号","dOut":"2013-09-24 18:09:36","cOut":"王蕾","dIn":"2013-09-24 18:11:53","cIn":"王蕾","cBatch":"B2013092417","cMark":"测试提示","cMemo":"提示2"}],"iTotalRec":2} 3.29.3、返回值含义 0:成功,无查询结果。 1:成功,有结果。 小于零:失败。 -12:无合法的记录日期时间开始点(dqDateB) 3.29.4、返回值变量名解释 iTotalRec:记录数 *RecList:移库记录列表(最多列500条,倒序排列),变量名解释参阅3.19.4 imID:移库记录ID iX:移库记录交换验证ID,用于序列号物品编码的扫描关联! cDepotf:移出仓库 cDepotd:移入仓库 cNum:参考号 dOut:出库签名时间 cOut:出库签名人 dIn:入库签名时间 cIn:入库签名人 cBatch:批次号 cMark:标签 cMemo:备注 3.30、pdawMoveIn 3.30.1、请求: {"RequestName":"pdawMoveIn","cUserPid":"TT67893TT","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cDepot":"HH2","cNum":"PP42333333388GG"} 3.30.1.1、变量名解释 imID:移库记录ID cNum:参考号,0-30字符。 *以上两个记录查询条件至少提供一个 3.30.2、样例 3.30.2.2、响应: {"ReturnValue":1,"cDepotf":"A11","cDepotd":"HH2","cNum":"PP42333333388GG","iwGiid":13,"cgName":"被子","cgCode":"FDH42343233455","cUnit":"床","iQuantity":987,"iNormal":987,"iDefictive":0,"dDate":"2015-03-26 16:19:41","cInput":"ppp","dOut":"","cOut":"","dIn":"","cIn":"","cBatch":"B2015032616","cMark":"mark","cMemo":"memo"} 3.30.3、返回值含义 0:成功,无查询结果。 1:成功,有结果。 小于零:失败。 -12:无查询条件 -14:操作失败。原因查看“cMess” 3.30.4、返回值变量名解释,参阅3.29.4 *字段值为本次操作之前的记录字段值* 3.31、pdawMoveOut 3.31.1、请求: {"RequestName":"pdawMoveOut","cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cDepot":"A11","cNum":"PP42333333388GG"} 3.31.1.1、变量名解释 imID:移库记录ID cNum:参考号,0-30字符。 *以上两个记录查询条件至少提供一个 3.31.2、样例 3.31.2.2、响应: {"ReturnValue":1,"cDepotf":"A11","cDepotd":"HH2","cNum":"PP42333333388GG","iwGiid":13,"cgName":"被子","cgCode":"FDH42343233455","cUnit":"床","iQuantity":987,"iNormal":987,"iDefictive":0,"dDate":"2015-03-26 16:19:41","cInput":"ppp","dOut":"","cOut":"","dIn":"2015-03-26 16:40:07","cIn":"胡清华","cBatch":"B2015032616","cMark":"mark","cMemo":"memo"} 3.31.3、返回值含义 0:成功,无查询结果。 1:成功,有结果。 小于零:失败。 -12:无查询条件 -14:操作失败。原因查看“cMess” 3.31.4、返回值变量名解释,参阅3.29.4 *字段值为本次操作之前的记录字段值* 3.32、pdawSerialIn 3.32.1、请求: {"RequestName":"pdawSerialIn","cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cDepot":"A11","iID":99,"cCode":"TV12345678GD"} 3.32.1.1、变量名解释 iID:预录库记录ID cRNo:预录库记录参考号,1-30字节。 *以上两个选择提供一个即可。 cCode:物品序列号,必须。如果未预先添加(无查询结果),则尝试添加一条记录。 bDefective:是否为次品,默认否。逻辑值:true/false iqwGiid:物品ID。 cqgCode:物品统一编码,0-63字节。 *上面两个查询条件至少定义一个! 3.32.2、样例 3.32.2.2、响应: {"ReturnValue":1,"cDepot":"A11","cRNo":"","cShelf":"A1-04","cCode":"TV12345678GD","iserID":70,"iID":99,"cMark":"gg","cMemo":"ddgggg","icID":79,"iwGiid":2,"cgName":"电视机","cgNameE":"TV Set","cgCode":"DFASFASDFAS","cUnit":"台","cColor":"COLOR","cSize":"SIZE","cBrand":"BRAND","cModel":"MODEL","fWeight":25.000,"iLong":5000,"iWidth":10000,"iHeight":12000} 3.32.3、返回值含义 0:无查询结果。 1:成功。 -12:预录库记录ID和预录库记录参考号 都未提供 -13:物品序列号不合法(1-63字符) -14:操作失败。原因查看“cMess” -15:记录未审核 -16:已完成入库确认 -17:物品没有序列号定义 3.32.4、返回值变量名解释,参阅3.19.4 iID:预录库记录ID。 iserID:序列号物品明细记录ID cMark:预录库记录标签 cMemo:预录库记录备注 3.33、pdawSerialOut 3.33.1、请求: {"RequestName":"pdawSerialOut","cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cDepot":"A11","iqoID":14,"iqwGiid":2,"cCode":"TV12345678GD"} 3.33.1.1、变量名解释 iqoID:订单流水号(ID)。 cNum:运单号,7-30字符。由“ bNo”决定其为订单号还是转单号。 *以上两个查询条件至少提供一个。 bNo:是否为转单号,默认否。逻辑值:true/false iqwGiid:物品ID。 cqgCode:物品统一编码,0-63字节。 *上面两个查询条件至少定义一个! cCode:物品序列号,必须。如果未预先添加(无查询结果),则尝试添加一条记录。 bDefective:是否为次品,默认否。逻辑值:true/false 3.33.2、样例 3.33.2.2、响应: {"ReturnValue":1,"cDepot":"A11","ioID":14,"cNum":"TEST12333333","cNo":"EL891551507CS","cCode":"TV12345678GD","iserID":70,"iID":58,"cMark":"","cMemo":"","icID":79,"iwGiid":2,"cgName":"电视机","cgNameE":"TV Set","cgCode":"DFASFASDFAS","cUnit":"台","cColor":"COLOR","cSize":"SIZE","cBrand":"BRAND","cModel":"MODEL","fWeight":25.000,"iLong":5000,"iWidth":10000,"iHeight":12000} 3.33.3、返回值含义 0:无查询结果。 1:成功。 -11:物品ID和物品统一编码 都未提供 -12:订单记录ID和运单号 都未提供 -13:物品序列号不合法(1-63字符) -14:操作失败。原因查看“cMess” -15:订单未完成拣选 -16:订单已完成出库确认 -17:物品没有序列号定义 3.33.4、返回值变量名解释,参阅3.19.4 ioID:订单记录ID cNum:订单号 cNo:订单转单号 iserID:序列号物品明细记录ID iID:物品出库记录ID(在订单完成拣选后有系统生成)。 cMark:预录库记录标签 cMemo:预录库记录备注 3.34、pdaUserInfo 3.34.1、请求: {"RequestName":"pdaUserInfo","cUserPid":"A33256BJ","TimeStamp":1428348920000,"MD5":"208c8f7ace321cc7047fa52523bb5692"} 3.34.2、样例 3.34.2.2、响应: {"ReturnValue":1,"cUserName":"王蕾","cUserPid":"A33256BJ","cDepot":"A11","cStation":"","cStationt":"","bClientRec":true,"bSend":true,"bReWeight":true,"bCheckScan":true,"bCodeScan":true,"bReturnScan":false,"bTransReceive":true,"bTransSend":true,"bxBagCreate":false,"bxBagAddRec":false,"bxBagPack":false,"bxBagUnpack":false,"bxBagAwb":false,"bwInPick":true,"bwInCheck":true,"bwInConfirm":true,"bwInShelf":true,"bwInRet":true,"bwOutChoose":true,"bwOutCheck":true,"bwOutPack":true,"bwOutConfirm":true,"bwDepotMove":true} 3.34.3、返回值含义 0:无查询结果。 1:成功。 3.34.4、返回值变量名解释 cStation:用户所属调度站点 cStationt:用户所属传接站点(用于转发) *以下为权限授予 bClientRec:快递业务记录 bSend:快递发送 bReWeight:复重计价 bCheckScan:检查点扫描 bCodeScan:内控码设置 bReturnScan:退件扫描 bTransReceive:转发接货确认 bTransSend:转发发出(到业务记录) bxBagCreate:袋创建 bxBagAddRec:装袋 bxBagPack:封袋 bxBagUnpack:拆袋 bxBagAwb:总单及配载 bwInPick:仓库取货确认 bwInCheck:仓库质检确认 bwInConfirm:仓库入库确认 bwInShelf:仓库更换货架 bwInRet:仓库退件入库 bwOutChoose:仓库出库拣货 bwOutCheck:仓库出库质检 bwOutPack:仓库出库包装 bwOutConfirm:仓库出库确认 bwDepotMove:仓库移库 3.35、pdaRecPickup 3.35.1、请求: {"RequestName":"pdaRecPickup","cUserPid":"TT67893TT","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cAccount":"test","cNum":"E13901000044333"} 3.35.1.1、变量名解释 cNum:运单号,7-30字符,必须。 icID:客户ID cAccount:客户账号 *以上两个客户识别字段至少提供一个 cMemo:备注,0-254字符 3.35.2、样例 3.35.2.2、响应: {"ReturnValue":2,"icID":79,"cNum":"E13901000044333"} 3.35.3、返回值含义 大于零:成功,取件记录ID。 小于零:失败。 -12:无查询条件 -13:客户ID 和 客户账号 都不合法 -14:操作失败。原因查看“cMess” 3.36、pdaRecTrackInfo 3.36.1、请求: {"RequestName":"pdaRecTrackInfo","cUserPid":"TT67893TT","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cNumber":"ZD130815001","nNumberType":2,"cInfo":"Arrived at Heathrow airport","nPosB":50} 3.36.1.1、变量名解释 cNumber:单号,4-30字符,必须。 nNumberType:单号类别,枚举(0:业务内单号;1:业务转单号;2:装袋号;3:总单号),默认0。 cInfo:追踪详细信息中文,1-254字符,必须。 szDate:追踪日期时间,0-30字符。建议格式为(YYYY-MM-DD hh:mm),无效时将采用服务器系统时间。 bSysDate:追踪记录日期时间使用服务器系统时间。逻辑值:true/false cPlace:追踪记录操作地点中文(0-126字节) cInfoE:追踪记录详细信息英文(0-254字节),提供则操作 cPlaceE:追踪记录操作地点英文(0-126字节) 3.36.2、样例 3.36.2.2、响应: {"ReturnValue":5,"iNumberType":2,"cNumber":"ZD130815001"} 3.36.3、返回值含义 大于零:成功,操作业务记录条数。 小于零:失败。 -12:单号不合法(4-30字符) -13:追踪详细信息中文都不合法(1-254字符) 3.37、pdaxBagQuery 3.37.1、请求: {"RequestName":"pdaxBagQuery","cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cxNo":"NJ120115001","nCheckField":1,"nTotalType":1} 3.37.1.1、变量名解释 cxNo:装袋号,4-30字符,必须。 nCheckField:汇总检查字段,枚举,默认0。(0:标签;1:备用1;2:备用2;3:备用3;4:备用4;5:备用5) nTotalType:汇总模式,枚举,默认0。 0:不汇总; 1:关联总单汇总; 2:关联总单的同时间航班汇总; 3:关联总单的同日首航班机场汇总。 3.37.2、样例 3.37.2.2、响应: {"ReturnValue":1,"cxNo":"NJ120115001","nCheckField":1,"nTotalType":1,"ixID":6,"iState":2,"iItem":3,"fWeight":9.230,"dInput":"2012-01-15 16:52:27","cInput":"预置账号","cFrom":"PVG","cDes":"SZC","cStation":"南京","cStationd":"深圳","cTransNote":"","cOrder":" 3\x2F4","cAwb":"880-13123222","cHandleNo":"334455","cBy1":"","cBy2":"","cBy3":"","cBy4":"","cBy5":"","cMark":"","cMemo":"","cFlightNo":"CC3455","cAirport":"DDD\x2FGGG","dDepart":"2012-02-21 17:23","TotalList":[{"cValue":"","iCount":3},{"cValue":"ok_By1_check","iCount":1}]} 3.37.3、返回值含义 0:无结果(袋记录不存在或没有配载)。 1:成功。 -12:装袋号(cxNo)太短 3.37.4、返回值变量名解释 *如下为本装袋记录的属性字段值 ixID:装袋记录ID iItem:件数 fWeight:重量 dInput:创建时间 cInput:创建者 cFrom:出发机场 cDes:目的机场 cStation:出发站点 cStationd:目的站点 cTransNote:托运备注 cOrder:袋序 cAwb:配载总单号 cHandleNo:特控号 cBy1:备用1 cBy2:备用2 cBy3:备用3 cBy4:备用4 cBy5:备用5 cMark:标签 cMemo:备注 cFlightNo:总单首航班号 cAirport:总单首航班机场 dDepart:总单首航班日期 *TotalList,汇总列表 cValue:汇总字段值 iCount:袋数 3.38、pdaxBagSet 3.38.1、请求: {"RequestName":"pdaxBagSet","cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cxNo":"ZD130815001","cBy2":"ok_By2..."} 3.38.1.1、变量名解释 cxNo:装袋号,4-30字符,必须。 *如下为可更改的字段,至少提供一个,可以提供空值,一旦提供,就将更改该字段! cMark:标签,0-15字符。 cBy1:备用1,0-63字符。 cBy2:备用2,0-63字符。 cBy3:备用3,0-63字符。 cBy4:备用4,0-63字符。 cBy5:备用5,0-254字符。 3.38.2、样例 3.38.2.2、响应: {"ReturnValue":27,"ixID":27,"cxNo":"ZD130815001","iUpdate":1} 3.38.3、返回值含义 大于零:成功,装袋记录的ID(ixID) -12:装袋号(cxNo)太短 -13:没有提交更改的字段 3.38.4、返回值变量名解释 iUpdate:更新字段数 3.39、pdawInAdd 3.39.1、请求: {"RequestName":"pdawInAdd","cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cDepot":"A11","cqgCode":"HGG42343214","iQuantity":3,"cRNo":"TEST1234567","cBatch":"PDA123","dETA":"2015-05-05 14:30"} 3.39.1.1、变量名解释 iqwGiid:物品ID。 cqgCode:物品统一编码,0-63字节。 *上面两个筛选条件至少定义一个!或者下面两个参数 cqAccount:EMMis中客户账号,1-30字节。 cqcCode:物品客户编码,1-63字节。 cRNo:参考号,0-30字节。(请定义ID为8831的运单号生成记录,系统将在参考号为空时,自动生成一个) cBatch:批次号,0-30字节。(空时,按YYMMDDHHxxxxxx生成,xxxxxx为客户ID的数字格式) dETA:预计到库日期时间。 dDate_p:生产日期 dDate_v:保质日期 bPick:是否上门提货,逻辑值,默认false。 fPick:提货费 *如下3个计费变量如不提供,将取物品归库定义值* *不提供的含义为,在Json中没有该变量或变量值为负数(如-1.0) fQCIn:入库质检费 fLabel:入库标签费 fArrange:入库理货费 cMName:客户联络,0-30字节。 cPhone:联络电话,0-62字节。 cAddr:联络地址,0-126字节。 cShelf:架位,0-30字节。 iStory:层,1-255 iColumn:列,1-32000 cMark:标签,0-15字节。 cMemo:备注,0-254字节。 3.39.2、样例 3.39.2.2、响应: {"ReturnValue":101,"cDepot":"A11","iID":101,"iQuantity":3,"cShelf":"","cRNo":"TEST1234567","icID":79,"iwGiid":1,"cgName":"打火机","cgCode":"HGG42343214","ccCode":"BBFSA4243214","cUnit":"个","fWeight":0.010,"iLong":100,"iWidth":200,"iHeight":500,"cShelf_d":"XZ-AB11","iStoryB":1,"iStoryE":1,"iColumnB":1,"iColumnE":1} 3.39.3、返回值含义 大于0:成功,记录ID。 小于零:失败。 -2:无物品归库记录 -12:无查询物品条件 -13:数量小于1 -14:添加失败,原因看:“cMess”,罕见! -15:归库物品状态:停售 3.39.4、返回值变量名解释 cMess:操作失败原因。成功时不提供。 iID:新添加的入库记录ID,与ReturnValue一致 iQuantity:数量 cShelf:架位 icID:客户ID iwGiid:物品ID。 cgName:物品名称 cgCode:物品统一编码 ccCode:物品客户(系统)编码 cUnit:计量单位 fWeight:重量 iLong:长 iWidth:宽 iHeight:高 cShelf_d:物品归库架位 iStoryB:起点层 iStoryE:终点层 iColumnB:起点列 iColumnE:终点列 3.40、pdawInQuery 3.40.1、请求: {"RequestName":"pdawInQuery","cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cDepot":"A11","iPage":1,"iPagePer":10} 3.40.1.1、变量名解释 iPage:页次,默认1 iPagePer:每页记录数,默认值0,有效值0-1000,(0 表示仅返回记录总数) *如下两个客户筛选条件可提供一个 iqcID:客户ID cqAccount:EMMis中客户账号,1-30字节。 如下三个物品筛选条件可提供一个 iqwGiid:物品ID。 cqgCode:物品统一编码,0-63字节。 cqcCode:物品客户编码,1-63字节。配合客户识别方能生效。 cqRNo:参考号,0-30字节。精确查找。 cqBatch:批次号,0-30字节。左包含查找。 3.40.2、样例 3.40.2.2、响应: {"ReturnValue":1,"iqcID":0,"iPage":1,"iPagePer":3,"iTotalRec":56,"iqwGiid":0,"cqgCode":"","cqcCode":"","cqAccount":"","cqRNo":"","cqBatch":"","RecList":[{"iID":13,"icID":79,"iwGiid":2,"cgName":"电视机","cgCode":"DFASFASDFAS","ccCode":"DFHH442","cUnit":"台","iQuantity":3,"nState":30,"cRNo":"RN77665544","cBatch":"CH77665544","dETA":"2012-08-15 00:00","cMName":"张三","cPhone":"13999887766","cAddr":"上海虹桥","cShelf":"A1-04","iStory":4,"iColumn":7,"cMark":"mark","cMemo":"memo","dDate":"2012-08-01 12:28:09","cInput":"预置账号","cShelf_d":"A1-04","iStoryB":7,"iStoryE":7,"iColumnB":4,"iColumnE":4},{"iID":14,"icID":79,"iwGiid":2,"cgName":"电视机","cgCode":"DFASFASDFAS","ccCode":"DFHH442","cUnit":"台","iQuantity":2,"nState":30,"cRNo":"","cBatch":"B2012080211","dETA":"2012-08-02 15:02","cMName":"","cPhone":"","cAddr":"","cShelf":"A1-04","iStory":4,"iColumn":7,"cMark":"","cMemo":"","dDate":"2012-08-02 11:08:06","cInput":"预置账号","cShelf_d":"A1-04","iStoryB":7,"iStoryE":7,"iColumnB":4,"iColumnE":4},{"iID":19,"icID":79,"iwGiid":5,"cgName":"旗杆","cgCode":"TY342342433","ccCode":"KH42343242","cUnit":"杆","iQuantity":3,"nState":10,"cRNo":"fgsdgf","cBatch":"B2012081812","dETA":"","cMName":"","cPhone":"","cAddr":"","cShelf":"A1-05|1列|5层","iStory":1,"iColumn":5,"cMark":"","cMemo":"","dDate":"2012-08-18 12:00:58","cInput":"预置账号","cShelf_d":"A1-05","iStoryB":5,"iStoryE":5,"iColumnB":1,"iColumnE":1}]} 3.40.3、返回值含义 1:成功,有结果(iTotalRec)。 0:无结果。 小于零:失败。 -2:无物品归库记录 3.40.4、返回值变量名解释 *RecList iID:入库记录ID icID:客户ID iwGiid:物品ID。 cgName:物品名称 cgCode:物品统一编码 ccCode:物品客户(系统)编码 cUnit:计量单位 iQuantity:数量 nState:状态,枚举值(0:未审;10:已审核;20:已取件;30:已质检)。 cRNo:参考号 cBatch:批次号 dETA:预计到库时间 cMName:客户联系 cPhone:联系电话 cAddr:联系地址 cShelf:架位(记录设定,可能是归库定义不一致) iStory:层(记录设定) iColumn:列(记录设定) cMark:标签 cMemo:备注 dDate:录入时间 cInput:录入者 cShelf_d:物品归库架位 iStoryB:起点层(归库) iStoryE:终点层(归库) iColumnB:起点列(归库) iColumnE:终点列(归库) 3.41、pdaTransQuery 3.41.1、请求: {"RequestName":"pdaTransQuery","cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cqNum":"YDH000000017"} 3.41.1.1、变量名解释 cqNum:运单号,4-30字节。必须。 如下2个客户筛选条件可提供一个 iqcID:客户ID cqAccount:EMMis中客户账号,0-30字节。 3.41.2、样例 3.41.2.2、响应: {"ReturnValue":2188850,"iqcID":0,"cqNum":"YDH000000017","cqAccount":"","iID":2188850,"ibID":0,"irID":0,"icID":79,"cAccount":"test","cUnitName":"调试专用","nItemType":1,"nOpen":0,"dDate":"2013-06-17 18:42:58","cNum":"YDH000000017","cEmsKind":"","cShelf":"SH01","dDate_r":"2013-06-17 18:42:58","cName_r":"预置账号","fWeight":1.220,"iItem":1,"fAmount":0.00,"cMark":"","cMemo":"","cEx1":"","cEx2":"","cEx3":"","cGoods":"","iQuantity":1,"fPrice":0.00,"fGoods":0.00,"fGoodsc":0.00,"fDValue":0.00,"fIValue":0.00,"cMoney":"USD","cPayDir":"PP","cPacking":"","cTransNote":""} 3.41.3、返回值含义 大于0:成功,转发到件预报记录ID。 小于零:失败。 -2:无结果。 -12:cqNum空。 3.41.4、返回值变量名解释 iID:转发到件预报记录ID ibID:关联转发打包记录ID,大于零表示已经组包 irID:关联快递业务记录ID,大于零表示已经完成转发,已录单操作(快递)... icID:客户ID cAccount:客户账号 cUnitName:客户名称 nOpen:是否允许拆包,0:不允许;1:允许。 dDate:录入时间 cNum:运单号 cEmsKind:来自网络渠道 cShelf:存放架位 dDate_r:到件确认时间 cName_r:到件确认操作者 fWeight:重量 fAmount:运费 cEx1-3:扩展1-3 cGoods:物品描述 iQuantity:物品数量 fPrice:物品单价 fGoods:货值 fDValue:声明价 fIValue:投保价 cMoney:币种 cPayDir:支付指示 cPacking:包装 cTransNote:托运备注 cMark:标签 cMemo:备注 3.42、pdaPreInputQuery 3.42.1、请求: {"RequestName":"pdaPreInputQuery","cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cqNum":"RBG00012835CN"} 3.42.1.1、变量名解释 cqNum:运单号,4-30字节。必须。 如下2个客户筛选条件可提供一个 iqcID:客户ID cqAccount:EMMis中客户账号,0-30字节。 3.42.2、样例 3.42.2.2、响应: {"ReturnValue":1744,"iqcID":0,"cqNum":"RBG00012835CN","cqAccount":"","iID":1744,"irID":0,"icID":79,"cAccount":"test","cUnitName":"调试专用","nItemType":1,"nLanguage":2,"cEmsKind":"SKYNET","cEmsKindi":"SKYNET","cEmsKindc":"SKYNET","cEmsKindw":"","cAddrFrom":"","cDes":"美国","fWeight":1.220,"iLong":0,"iWidth":0,"iHeight":0,"iItem":1,"siPayWay":0,"fAmount":0.00,"cReceiver":"ffff","cRUnit":"ff fasf","cRAddr":"Dougherty County\x0D\x0AAlbany , GA 31705 , USA","cRCity":"Albany","cRPostcode":"31705","cRProvince":"GA","cRCountry":"United States of America","cRPhone":"412412313","cREMail":"","cRSms":"","cNum":"RBG00012835CN","cNo":"LN876131541CN","cRNo":"","cCNo":"","cSender":"","cSUnit":"","cSAddr":"","cSCity":"","cSPostcode":"","cSProvince":"","cSCountry":"","cSPhone":"","cSEMail":"","cSSms":"","cDepart":"","cMark":"","cMemo":"","cReserve":"","iReserve":0,"cBy1":"","cBy2":"","cBy3":"","cBy4":"","cBy5":"","cGoods":"硬粒小麦","iQuantity":1,"fPrice":10.00,"fGoods":0.00,"fGoodsc":0.00,"fDValue":0.00,"fIValue":0.00,"cMoney":"USD","cPayDir":"PP","cOrigin":"CN","cGoodsA":"Durum wheat","cGCodeA":"","cGCodeB":"","cGCodeC":"","fGCustom":0.00,"fGCRate":0.0000,"faGet":0.00,"faSafe":0.00,"faPack":0.00,"faOther":0.00,"faCheck":0.00,"faRemote":0.00,"faBy":0.00,"cPacking":"","cTransNote":""} 3.42.3、返回值含义 大于0:成功,预录记录ID。 小于零:失败。 -2:无结果。 -12:cqNum空。 3.42.4、返回值变量名解释 iID:预录记录ID irID:关联快递业务记录ID,大于零表示已经完成录单操作(快递)... icID:客户ID cAccount:客户账号 cUnitName:客户名称 nItemType:快件类型,默认为1。取值为:0(文件),1(包裹),2(防水袋) nLanguage:地域语言,默认为0。取值为:0(中国大陆),1(华语),2(其它地域) cEmsKind:快递类别,1-15字符,必须。 cEmsKindi:快递类别(客户可见录单),1-15字符。 cEmsKindc:快递类别(客户要求),1-15字符。 cEmsKindw:快递类别(客户希望),1-15字符。 cAddrFrom:出发地,0-63字符。 cDes:目的地,1-63字符,必须。 fWeight:重量,公斤,3位小数。 iLong:长,厘米。 iWidth:宽,厘米。 iHeight:高,厘米。 iItem:件数,默认1。 nPayWay:付款方式,默认为0。取值为:0(月结),1(现付),2(到付) fAmount:快递费,2位小数。 cReceiver:收件人,0-63字符。 cRUnit:收件单位,0-254字符。 cRAddr:收件地址,0-254字符。 cRCity:收件城市,0-126字符。 cRPostcode:收件邮编,0-15字符。 cRProvince:收件省州,0-63字符。 cRCountry:收件国家,0-126字符。 cRPhone:收件电话,0-63字符。 cREMail:收件电邮,0-63字符。 cRSms:收件短信,0-22字符。 cNum:内单号,7-30字符。(通常为系统配置自动生成) cNo:转单号,7-30字符。 cRNo:参考号,0-30字符。 cCNo:报关号,0-30字符。 cSender:发件人,0-30字符。 cSUnit:发件单位,0-127字符。 cSAddr:发件地址,0-127字符。 cSCity:发件城市,0-63字符。 cSPostcode:发件邮编,0-15字符。 cSProvince:发件省州,0-30字符。 cSCountry:发件国家,0-63字符。 cSPhone:发件电话,0-63字符。 cSEMail:发件电邮,0-63字符。 cSSms:发件短信,0-22字符。 cDepart:所属部门,0-30字符。 cMark:标签,0-15字符。 cMemo:备注,0-254字符。 cReserve:留用串,0-30字符。 iReserve:留用数,默认0 cBy1:备用1,0-63字符。 cBy2:备用2,0-63字符。 cBy3:备用3,0-63字符。 cBy4:备用4,0-63字符。 cBy5:备用5,0-254字符。 cGoods:物品描述,0-254字符。 iQuantity:物品数量,默认0 fPrice:物品单价,2位小数。 cMoney:货币代码,0-3字符。 fGoods:物品货值,代收货款收件人支付的货值,2位小数。 fGoodsc:物品返回客户货值,代收货款向客户返还的货值,2位小数。 fDValue:物品声明价,2位小数。 fIValue:物品投保价,2位小数。 cPayDir:结算指示,0-3字符。 cOrigin:原产地国家代码,0-3字符。 cGoodsA:物品别名,通常为英文描述,0-254字符。 cGCodeA:物品甲码,通常为HS编码,0-63字符。 cGCodeB:物品乙码,通常为统一编码,0-63字符。 cGCodeC:物品丙码,通常为客户编码,0-63字符。 fGCustom:关税额,2位小数。 fGCRate:税率,4位小数。 cPacking:包装,0-15字符。 cTransNote:托运备注,0-63字符。 #如下为7个运费附加字段 faGet:提货费,2位小数。 faSafe:保险费,2位小数。 faPack:包装费,2位小数。 faOther:杂费,2位小数。 faCheck:验货费,2位小数。 faRemote:偏远费,2位小数。 faBy:其它费,2位小数。 3.43、pdaRecAdd 3.43.1、请求: {"RequestName":"pdaRecAdd","cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","icID":79,"cNum":"RB443355660CN","cDes":"美国","cEmsKind":"DHL","fWeight":1.5,"GoodsList":[{"cxGoods":"电视机","ixQuantity":1,"fxPrice":1500.12},{"cxGoods":"裤子","ixQuantity":2,"fxPrice":88.99}]} 3.43.1.1、变量名解释 *如下2个客户识别条件必须提供一个 icID:客户ID cAccount:EMMis中客户账号,0-30字节。 bPriceCalc:是否强制计算运费,逻辑值,默认false。 *如下为业务字段,选择提供 nItemType:快件类型,默认为1。取值为:0(文件),1(包裹),2(防水袋) nLanguage:地域语言,默认为0。取值为:0(中国大陆),1(华语),2(其它地域) cEmsKind:快递类别,1-15字符,必须。 cAddrFrom:出发地,0-63字符。 cDes:目的地,1-63字符,必须。 fWeight:重量,公斤,3位小数。 iLong:长,厘米。 iWidth:宽,厘米。 iHeight:高,厘米。 iItem:件数,默认1。 nPayWay:付款方式,默认为0。取值为:0(月结),1(现付),2(到付) fAmount:快递费,2位小数。 cReceiver:收件人,0-63字符。 cRUnit:收件单位,0-254字符。 cRAddr:收件地址,0-254字符。 cRCity:收件城市,0-126字符。 cRPostcode:收件邮编,0-15字符。 cRProvince:收件省州,0-63字符。 cRCountry:收件国家,0-126字符。 cRPhone:收件电话,0-63字符。 cREMail:收件电邮,0-63字符。 cRSms:收件短信,0-22字符。 cNum:内单号,7-30字符。(通常为系统配置自动生成) cNo:转单号,7-30字符。 cRNo:参考号,0-30字符。 cCNo:报关号,0-30字符。 cSender:发件人,0-30字符。 cSUnit:发件单位,0-127字符。 cSAddr:发件地址,0-127字符。 cSCity:发件城市,0-63字符。 cSPostcode:发件邮编,0-15字符。 cSProvince:发件省州,0-30字符。 cSCountry:发件国家,0-63字符。 cSPhone:发件电话,0-63字符。 cSEMail:发件电邮,0-63字符。 cSSms:发件短信,0-22字符。 cDepart:所属部门,0-30字符。 cMark:标签,0-15字符。 cMemo:备注,0-254字符。 cReserve:留用串,0-30字符。 iReserve:留用数,默认0 cBy1:备用1,0-63字符。 cBy2:备用2,0-63字符。 cBy3:备用3,0-63字符。 cBy4:备用4,0-63字符。 cBy5:备用5,0-254字符。 cGoods:物品描述,0-254字符。 iQuantity:物品数量,默认0 fPrice:物品单价,2位小数。 cMoney:货币代码,0-3字符。 fGoods:物品货值,代收货款收件人支付的货值,2位小数。 fGoodsc:物品返回客户货值,代收货款向客户返还的货值,2位小数。 fDValue:物品声明价,2位小数。 fIValue:物品投保价,2位小数。 cPayDir:结算指示,0-3字符。 cOrigin:原产地国家代码,0-3字符。 cGoodsA:物品别名,通常为英文描述,0-254字符。 cGCodeA:物品甲码,通常为HS编码,0-63字符。 cGCodeB:物品乙码,通常为统一编码,0-63字符。 cGCodeC:物品丙码,通常为客户编码,0-63字符。 fGCustom:关税额,2位小数。 fGCRate:税率,4位小数。 cPacking:包装,0-15字符。 cTransNote:托运备注,0-63字符。 cMName:经办人,0-30字符。 cTaker:取件人,0-30字符。 #如下为7个运费附加字段,选择提供(v4.2) faGet:提货费,2位小数。 faSafe:保险费,2位小数。 faPack:包装费,2位小数。 faOther:杂费,2位小数。 faCheck:验货费,2位小数。 faRemote:偏远费,2位小数。 faBy:其它费,2位小数。 **GoodsList:快件所含物品列表,为0-100个物品对象 #如果只有一种物品,物品信息存放在上述顶层记录字段即可,多种物品,需要此对象描述 #为了区分,命名在顶层字段名称中嵌入了一个“x”,注意字段长度有所不同。 cxGoods:物品描述,0-63字符。必须。 ixQuantity:物品数量。必须。 fxPrice:物品单价,2位小数。 cxGoodsA:物品别名,通常为英文描述,0-63字符。 cxGCodeA:物品甲码,通常为HS编码,0-63字符。 cxGCodeB:物品乙码,通常为统一编码,0-63字符。 cxGCodeC:物品丙码,通常为客户编码,0-63字符。 fxGCustom:关税额,2位小数。 fxGCRate:税率,4位小数。 **ItemList:快件分单信息列表,为0-N个分单信息对象,参阅:3.6.1.1 3.43.2、样例 3.43.2.2、响应: {"ReturnValue":24894,"irID":24894,"icID":79,"cNum":"RB443355660CN","cNo":"RB443355660CN","fWeight":1.500,"fAmount":48.30,"cMess":""} 3.43.3、返回值含义 大于0:成功,业务记录ID。 其它:失败。查看cMess。 3.43.4、返回值变量名解释 irID:业务记录ID,大于零成功。 icID:客户ID cNum:内单号 cNo:转单号 fWeight:计价重量 fAmount:总运费 3.44、pdaGetNum 3.44.1、请求: {"RequestName":"pdaGetNum","cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","iID":160} 3.44.1.1、变量名解释 iID:EMMis 中“运单号生成定义”记录ID,必须且大于1。 3.44.2、样例 3.44.2.2、响应: {"ReturnValue":1,"iID":160,"cNum":"160-60058014"} 3.44.3、返回值含义 1:成功。 0:无资源可用 -12:iID不合法 3.44.4、返回值变量名解释 iID:运单号生成定义记录ID。 cNum:运单号 3.45、pdawInPicAdd 3.45.1、请求: {"RequestName":"pdawInPicAdd","cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"6c08ea4dff56d5a7a959c09f121c3c4f","iID":27,"cFileName":".jpg","vPic":"as56..."} 3.4.1.1、字段名解释 iID:预入库记录ID。 cRNo:预入库记录参考号,0-30字节 *以上两个变量,至少提供一个,用于查询关联记录* cFileName:文件名,4-255字符,必须提供,系统只解析扩展名(“.xxx”) vPic:图片数据(base64编码) 3.45.2、样例 3.45.2.2、响应: 3.45.3、字段名解释,参阅3.2.1.1 ReturnValue:大于零,成功(记录ID)。负数,失败。 -11:iID错误 -12:文件名不合法,没有解析出文件扩展名 -13:图片数据不存在 -14:图片数据太少(<1k) -15:图片数据太多(>1m) -16:图片数据解码错误(base64) 3.46、pdawInPicQuery 3.46.1、请求: {"RequestName":"pdawInPicQuery","cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"6c08ea4dff56d5a7a959c09f121c3c4f","iID":27,"iipID":23} 3.4.1.1、字段名解释 iID:预入库记录ID。 cRNo:预入库记录参考号,0-30字节 *以上两个变量,提供一个即可,用于查询关联记录* iipID:图片ID **iID或cRNo 和 iipID至少提供一个,提供前者,返回关联图片ID列表;提供后者,返回此图片数据 3.46.2、样例 3.46.2.2、响应: 3.46.3、字段名解释,参阅3.2.1.1 ReturnValue:大于零,成功。负数,失败。 0:无结果 -11:iID和iipID均无效 iID:预入库记录ID iipID:图片ID cExt:图片扩展名 iLen:图片数据真实长度(字节) vPic:图片数据(base64编码) *iipID_List:图片ID数组 iTotalRec:图片记录总数。 3.47、pdawGoodsDefine 3.47.1、请求: {"RequestName":"pdawGoodsDefine","cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cDepot":"A11","cAccount":"test","cgCode":"HGG42343214TEST","ccCode":"CCG42343214TE","cgName":"Test Goods Name"} 3.47.1.1、变量名解释 icID:客户ID cAccount:客户账号(EMMis) *以上两个变量提供一个即可,识别客户 cgCode:物品统一编码,0-63字节 ccCode:物品客户编码,0-63字节。 *以上两个变量至少提供一个 cgName:物品中文名称,1-63字节,必须。 cgNameE:物品英文名称,0-254字节。 cHSCode:HS编码,0-15字节。 cGPCCode:GPC编码,0-63字节。 cKind:物品类别,0-30字节。 cProducer:生产商,0-63字节。 cColor:颜色,0-15字节。 cSize:尺码,0-15字节。 cBrand:商标,0-15字节。 cModel:型号,0-63字节。 cOrigin:原产地,0-3字节。 cUnit:计量单位,0-15字节。 cMark:标签,0-15字节。 cMemo:备注,0-254字节。 bShare:是否允许代售,false/true,默认false。 nType:分类,枚举。0:无序列号,1:有序列号。 fLong:长(米) fWidth:宽(米) fHeight:高(米) fWeight:重量,公斤 iWeightDiff:重量偏差,克 fWPU:标准仓储单位 nQC:质检百分比(0-100) iEDays:保质期,天数。 iFreeDays:免费期,天数。 3.47.2、样例 3.47.2.2、响应: {"ReturnValue":18,"cDepot":"A11","icID":79,"iwGiid":18,"cgName":"Test Goods Name","cgCode":"HGG42343214TEST","ccCode":"CCG42343214TE","cUnit":""} 3.47.3、返回值含义 大于零:成功,物品ID。 小于零:失败。 -12:物品编码无效 -13:物品中文名称空 -14:操作失败,具体错误信息在“cMess”中。 3.47.4、返回值变量名解释 icID:客户ID iwGiid:物品ID。 cgName:物品名称 cgCode:物品统一编码 ccCode:物品客户(系统)编码 cUnit:计量单位 *--------------- cMess:-14错误时的详细错误信息 3.48、pdawGoodsDepot 3.48.1、请求: {"RequestName":"pdawGoodsDepot","cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cDepot":"A11","iwGiid":18,"cShelf":"AZ33-01"} 3.48.1.1、变量名解释 iwGiid:物品ID。 cgCode:物品统一编码,0-63字节。 *上面两个查询条件至少定义一个!或者下面两个参数 cAccount:EMMis中客户账号,1-30字节。 ccCode:物品客户编码,1-63字节。 cShelf:架位,0-15字节。 cMoney:币种代码,0-3字节。 cUnit:计量单位,0-15字节。 cMark:标签,0-15字节。 cMemo:备注,0-254字节。 bShare:是否允许代售,false/true,默认false。 nQC:质检百分比(0-100) iMin:最小库存,整数,默认0 iMax:最大库存,整数,默认999999 iColumnB:列数开始 iColumnE:列数结束 iStoryB:层数开始 iStoryE:层数结束 fWPU:标准仓储单位 iEDays:保质期,天数。 iFreeDays:免费期,天数。 3.48.2、样例 3.48.2.2、响应: {"ReturnValue":19,"cDepot":"A11","icID":79,"iwGiid":18,"iID":19,"cgName":"Test Goods Name","cgCode":"HGG42343214TEST","ccCode":"CCG42343214TE","cUnit":"","cShelf":"AZ33-01"} 3.48.3、返回值含义 大于零:成功,归库记录ID。 小于零:失败。 -2:物品定义记录不存在 -12:无有效的物品查询条件 -14:操作失败,具体错误信息在“cMess”中。 3.48.4、返回值变量名解释 icID:客户ID iwGiid:物品ID。 iID:归库记录ID cgName:物品名称 cgCode:物品统一编码 ccCode:物品客户(系统)编码 cUnit:计量单位 cShelf:架位 *--------------- cMess:-14错误时的详细错误信息 3.49、pdawInConfirmEx 3.49.1、请求: {"RequestName":"pdawInConfirmEx","cUserPid":"A33256BJ","TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cDepot":"A11","cAccount":"test","cgCode":"HGG42343ALL02","cgName":"ALLTOGATHER 2","cShelf":"AZ33-03","iQuantity":4} *一体入库必须是无序列号的物品,一次性完成物品定义、归库、预入库记录添加、确认入库4步操作* 3.49.1.1、变量名解释 icID:客户ID cAccount:客户账号(EMMis) *以上两个变量提供一个即可,识别客户 cgCode:物品统一编码,0-63字节 ccCode:物品客户编码,0-63字节。 *以上两个变量至少提供一个 cgName:物品中文名称,1-63字节,必须。 cgNameE:物品英文名称,0-254字节。 cHSCode:HS编码,0-15字节。 cGPCCode:GPC编码,0-63字节。 cKind:物品类别,0-30字节。 cProducer:生产商,0-63字节。 cColor:颜色,0-15字节。 cSize:尺码,0-15字节。 cBrand:商标,0-15字节。 cModel:型号,0-63字节。 cOrigin:原产地,0-3字节。 cUnit:计量单位,0-15字节。 cMark:标签,0-15字节。 cMemo:备注,0-254字节。 bShare:是否允许代售,false/true,默认false。 fLong:长(米) fWidth:宽(米) fHeight:高(米) fWeight:重量,公斤 iWeightDiff:重量偏差,克 fWPU:标准仓储单位 nQC:质检百分比(0-100) iEDays:保质期,天数。 iFreeDays:免费期,天数。 * 用于归库 cShelf:架位,0-15字节。 cMoney:币种代码,0-3字节。 iMin:最小库存,整数,默认0 iMax:最大库存,整数,默认999999 iColumnB:列数开始 iColumnE:列数结束 iStoryB:层数开始 iStoryE:层数结束 *用于预入库记录添加 iQuantity:物品数量,必须大于0 cRNo:参考号,0-30字节。(请定义ID为8831的运单号生成记录,系统将在参考号为空时,自动生成一个) cBatch:批次号,0-30字节。(空时,按YYMMDDHHxxxxxx生成,xxxxxx为客户ID的数字格式) *用于入库确认 cConfirm:入库交接人姓名,如果仓库定义了“入库确认必须有交接人”,则必提供。 cPassword:入库交接人密码,如果仓库定义了“入库确认必须有交接人”,则必提供。 3.49.2、样例 3.49.2.2、响应: {"ReturnValue":104,"cDepot":"A11","icID":79,"iwGiid":21,"iID":104,"iQuantity":4,"cRNo":"D0000000050","cBatch":"15061310000079","cShelf":"AZ33-03","cgName":"ALLTOGATHER 2","cgCode":"HGG42343ALL02","ccCode":"HGG42343ALL02","cUnit":""} 3.49.3、返回值含义 大于零:成功,入库记录ID,可于用后续图片添加。 小于零:失败。 -12:物品编码无效 -13:物品中文名称空 -14:操作失败,具体错误信息在“cMess”中。 -15:物品数量小于1 3.49.4、返回值变量名解释 icID:客户ID iwGiid:物品ID。 iID:入库记录ID iQuantity:入库数量 cRNo:参考号 cBatch:批次号 cShelf:架位 cgName:物品名称 cgCode:物品统一编码 ccCode:物品客户(系统)编码 cUnit:计量单位 *--------------- cMess:-14错误时的详细错误信息 四、测试连接 http://127.0.0.1/cgi-bin/EmsData.dll?DoPda&{"RequestName":"EmsKindList"}