一、总概

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?DoApi”
1.4、接口请求方式为：POST
1.5、安全控制，MD5数字签名,绑定客户ID、客户密钥，通过与时间戳生成摘要码验证。
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":"1881405534421123xxxxxxxx"}： *获取MD5,用于调试

     {"RequestName":"EPostUpload","icID":79,"TimeStamp":1405534421123,"MD5":"6c08ea4dff56d5a7a959c09f121c3c4f",...}： 提交eub数据，获取eub单号
     {"RequestName":"EPostPdf","icID":79,"TimeStamp":1405534421123,"MD5":"6c08ea4dff56d5a7a959c09f121c3c4f","cqNo":"LN562467349CN"}： 下载eub的标签(pdf格式)
     {"RequestName":"DoGetNo","icID":79,"TimeStamp":1405534421123,"MD5":"6c08ea4dff56d5a7a959c09f121c3c4f",...}： （提前）提取运单号

     *如下接口帮助参阅help_app.txt中的同名接口帮助*
     {"RequestName":"PreInputSet","icID":79,"TimeStamp":1405534421123,"MD5":"6c08ea4dff56d5a7a959c09f121c3c4f",...}： 客户预录单数据写入（添加、修改）

     *如下为仓库模块(wu),所有仓库接口必须包含cDepot（仓库编码），用于识别仓库
     {"RequestName":"wGoodsInfo","icID":79,"TimeStamp":1405534421123,"MD5":"6c08ea4dff56d5a7a959c09f121c3c4f","cDepot":"XYZ",...}： 查询物品信息
     {"RequestName":"wInQuery","icID":79,"TimeStamp":1405534421123,"MD5":"6c08ea4dff56d5a7a959c09f121c3c4f","cDepot":"XYZ",...}： 物品入库清单
     {"RequestName":"wInTotal","icID":79,"TimeStamp":1405534421123,"MD5":"6c08ea4dff56d5a7a959c09f121c3c4f","cDepot":"XYZ",...}： 物品入库汇总
     {"RequestName":"wOrderSet","icID":79,"TimeStamp":1405534421123,"MD5":"6c08ea4dff56d5a7a959c09f121c3c4f","cDepot":"XYZ",...}： 订单记录添加、修改
     {"RequestName":"wOrderDel","icID":79,"TimeStamp":1405534421123,"MD5":"6c08ea4dff56d5a7a959c09f121c3c4f","cDepot":"XYZ",...}： 订单删除
     {"RequestName":"wOutQuery","icID":79,"TimeStamp":1405534421123,"MD5":"6c08ea4dff56d5a7a959c09f121c3c4f","cDepot":"XYZ",...}： 物品出库清单
     {"RequestName":"wOutTotal","icID":79,"TimeStamp":1405534421123,"MD5":"6c08ea4dff56d5a7a959c09f121c3c4f","cDepot":"XYZ",...}： 物品出库汇总
     {"RequestName":"wOrderTotal","icID":79,"TimeStamp":1405534421123,"MD5":"6c08ea4dff56d5a7a959c09f121c3c4f","cDepot":"XYZ",...}： 未确认出库订单物品汇总
     {"RequestName":"wOrderInfo","icID":79,"TimeStamp":1405534421123,"MD5":"6c08ea4dff56d5a7a959c09f121c3c4f","cDepot":"XYZ",...}： 查询订单信息
      
      *如下为转发打包操作*ver:5.6
     {"RequestName":"RecTransBagSet","icID":79,"TimeStamp":1405534421123,"MD5":"6c08ea4dff56d5a7a959c09f121c3c4f",...}： 转发打包数据添加
     {"RequestName":"RecTransBagDel","icID":79,"TimeStamp":1405534421123,"MD5":"6c08ea4dff56d5a7a959c09f121c3c4f",...}： 转发打包数据删除
     {"RequestName":"RecTransSet","icID":79,"TimeStamp":1405534421123,"MD5":"6c08ea4dff56d5a7a959c09f121c3c4f",...}： 转发预报到件数据添加
     {"RequestName":"RecTransDel","icID":79,"TimeStamp":1405534421123,"MD5":"6c08ea4dff56d5a7a959c09f121c3c4f",...}： 转发预报到件数据删除
     {"RequestName":"RecTransData","icID":79,"TimeStamp":1405534421123,"MD5":"6c08ea4dff56d5a7a959c09f121c3c4f",...}： 转发预报到件数据单票查询，返回完整数据
     {"RequestName":"RecTransList","icID":79,"TimeStamp":1405534421123,"MD5":"6c08ea4dff56d5a7a959c09f121c3c4f",...}： 转发预报到件数据列表查询    

     {"RequestName":"wGoodsPicSet","icID":79,"TimeStamp":1405534421123,"MD5":"6c08ea4dff56d5a7a959c09f121c3c4f",...}： 物品定义图片添加
     {"RequestName":"wGoodsPicQuery","icID":79,"TimeStamp":1405534421123,"MD5":"6c08ea4dff56d5a7a959c09f121c3c4f",...}： 物品定义图片查询(添加了那些位置的图片)
     {"RequestName":"wGoodsPicGet","icID":79,"TimeStamp":1405534421123,"MD5":"6c08ea4dff56d5a7a959c09f121c3c4f",...}： 物品定义图片数据获取

     {"RequestName":"RecTransBagSetEx","icID":79,"TimeStamp":1405534421123,"MD5":"6c08ea4dff56d5a7a959c09f121c3c4f",...}： 转发打包数据整体添加(=RecTransSet+RecTransBagSet)


2.1.2、除第1、2通用请求(*)外，每一个请求都必须包含成员变量：icID、TimeStamp、MD5。
2.1.2.1、icID：客户在EMMis中建档时由系统生成的唯一整数值，同时还应该点击“客户API密钥”，为客户设置密钥(修改密钥通常需要重新启动www服务)
2.1.2.2、TimeStamp：时间戳，1970.1.1 0:0:0开始到请求时刻的毫秒数(UTC),13位整数。注意北京时间为东8区，需要调整时差。
2.1.2.3、MD5：数字签名，=MD5(icID+TimeStamp+客户密钥)
         *比如客户密钥为“1234ABCD”,如上例程为：MD5("7914055344211231234ABCD")="306f241be2d5963f20be2966f9961f55"
2.1.2.4、MD5：加强的数字签名，=MD5(icID+TimeStamp+客户密钥+消息ID)
         *比如客户密钥为“1234ABCD”,
         请求数据为:{"RequestName":"DoGetNo","icID":79,"TimeStamp":1405534421123,"cUniqueMsgID":"6d950424-032a-4ebd-832d-8d643e4f7d98","MD5":"f48b3bac260f5902b2aca9f8e59ebf77",...}
         如上请求：MD5("7914055344211231234ABCD6d950424-032a-4ebd-832d-8d643e4f7d98")="f48b3bac260f5902b2aca9f8e59ebf77"
         *消息ID字节长度:0-36字节,确保在一定的时间阀值内唯一!

2.2、ReturnValue：响应返回状态码，为响应方的第一个顶级成员名称，整数值，通用定义如下：
    {"ReturnValue":0,...}： 没有结果或零处理

    {"ReturnValue":1,...}： 大于零，结果数或处理记录数，为成功的标识
    
    {"ReturnValue":-1,...}： 唯一性字段值重复，操作失败
    {"ReturnValue":-2,...}： 记录不存在，操作失败
    {"ReturnValue":-3,...}： 未提供必须的请求参数，操作失败
    {"ReturnValue":-4,...}： 请求不支持，版本错误或请求未实现
    {"ReturnValue":-5,...}： Json数据格式错误,未解析出"RequestName"
    {"ReturnValue":-6,...}： Json数据格式错误,双引号(")配对异常
    {"ReturnValue":-7,...}： 安全校验失败，不是配置的IP或数字签名错误
    {"ReturnValue":-8,...}： 未获授权
    {"ReturnValue":-9,...}： EmsData.dll程序错误，通常为数据库查询失败
    {"ReturnValue":-999,...}： 超过并发线程极限，稍后再试！请控制并发请求数!
    {"ReturnValue":-9999,...}： 数据库忙，稍后再试！

    {"ReturnValue":-710,...}： icID 错误，未提供或小于1
    {"ReturnValue":-711,...}： icID 错误，客户不存在或者未配置合法密钥
    {"ReturnValue":-720,...}： TimeStamp 错误，超出了同步阈值
    {"ReturnValue":-730,...}： MD5 错误，长度不是32字符
    {"ReturnValue":-731,...}： MD5 错误，不匹配
    {"ReturnValue":-732,...}： 消息ID(cUniqueMsgID)不唯一
    {"ReturnValue":-733,...}： 消息ID(cUniqueMsgID)空 (系统配置必须提供时)
    {"ReturnValue":-810,...}： cEmsKind错误，不支持
    {"ReturnValue":-820,...}： iSP_Type错误，接口不支持
    {"ReturnValue":-821,...}： iSP_Type错误，相关接口未初始化

    *负数值均为失败，更多的含义在具体的请求中定义。

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、EPostPdf

3.1.1、请求：
API: /cgi-bin/EmsData.dll?DoApi
POST_DATA: {"RequestName":"EPostPdf","icID":79,"TimeStamp":1405534421123,"MD5":"6c08ea4dff56d5a7a959c09f121c3c4f","cqNo":"LN562467349CN","iSP_Type":0}

iSP_Type：接口类型，默认0。(0:EUB;1:澳邮交接)
cEmsKind：快递类别，0-15字符，如果未提供iSP_Type（大于1时），可提供cEmsKind
*iSP_Type 和 cEmsKind 提供一个即可，用于多渠道识别。
cqNo：运单号,7-30字符,必须。转单号。

3.1.2、响应：
失败：{"ReturnValue":-10}
成功：pdf文件数据
3.1.2.1、字段名解释
ReturnValue：失败时的错误代码：
             -3：未提供“cqNo”或不是eub的单号
             -10：未准备好数据，稍后再试。eub的pdf数据通常在转单号数据提交后10秒左右准备好

cqNo：从eub获取的单号





3.2、TimeStamp

3.2.1、请求：
API: /cgi-bin/EmsData.dll?DoApi
POST_DATA: {"RequestName":"TimeStamp"}

3.2.2、响应：
{"ReturnValue":1409591437000}
3.2.2.1、字段名解释
ReturnValue：服务器时间戳，1970.1.1 0:0:0 到此刻的毫秒值(UTC),可用于时间戳错误(-720)校验



3.3.1、EPostUpload
3.3.1、请求：
  a.非ASCII编码为UTF-8
{"RequestName":"EPostUpload","icID":79,"TimeStamp":1416458014000,"MD5":"ddcf481543088e8d22c4a52a3e92bc53","iSP_Type":0,"cNum":"EE1020472289","cEmsKind":"SKYNET","cDes":"美国","fWeight":1.000,"cReceiver":"bbERRe3266","cRAddr":"LOS ANGELES COUNTY\x0D\x0AALHAMBRA , CA 91801 , USA","cRCity":"ALHAMBRA","cRProvince":"CA","cRCountry":"UNITED STATES OF AMERICA","cRPostcode":"91801","cRPhone":"1394333344121","cRSms":"","cGoods":"玉米","cGoodsA":"MAIZE","iQuantity":1,"fPrice":11.00}

  b.或者对于非ASCII进行转义编码：
{"RequestName":"EPostUpload","icID":79,"TimeStamp":1416505667000,"MD5":"f2ceda7fe738181941994c7ab2a4dfa3","cNum":"EE55520472289","cEmsKind":"SKYNET","cDes":"\u7F8E\u56FD","fWeight":1.000,"cReceiver":"bbERRe3266","cRAddr":"LOS ANGELES COUNTY\x0D\x0AALHAMBRA , CA 91801 , USA","cRCity":"ALHAMBRA","cRProvince":"CA","cRCountry":"UNITED STATES OF AMERICA","cRPostcode":"91801","cRPhone":"1394333344121","cRSms":"","cGoods":"\u7389\u7C73","cGoodsA":"MAIZE","iQuantity":1,"fPrice":11.00}

3.3.1.1、字段名解释
icID：客户ID,客户唯一识别。

#如下为记录对象的成员，依据网络渠道，提供相应的字段

iSP_Type：接口类型，默认0。(0:EUB;1:澳邮交接)
cNum：运单号,7-30字符,必须。内单号或客户订单号
cEmsKind：网络渠道,1-15字符,必须。
fWeight：重量，公斤，3位小数。
iLong：长，厘米。不必须
iWidth：宽，厘米。不必须
iHeight：高，厘米。不必须

nItemType：快件类型，默认为1。取值为：0(文件),1(包裹),2(防水袋)
iItem：件数，默认1。
nPayWay：付款方式，默认为0。取值为：0(月结),1(现付),2(到付)
fAmount：快递费，2位小数。

cReceiver：收件人,1-63字符。
cRUnit：收件单位,0-254字符。不必须
cRAddr：收件地址,1-254字符。
cRCity：收件城市,1-126字符。
cRPostcode：收件邮编,4-15字符。
cRProvince：收件省州,2-63字符。
cRCountry：收件国家,4-126字符。
cRPhone：收件电话,4-63字符。
cREMail：收件电邮,0-63字符。不必须
cRSms：收件移动电话,4-22字符。

cGoods：物品描述,中文，2-254字符。不短于两个汉字
cGoodsA：物品别名，为英文描述,1-254字符。
iQuantity：物品数量，默认0
fPrice：物品单价，2位小数。
cTransNote：托运备注,0-63字符。不必须
cPrintCode：打印控制编码,0-15字符。不必须(00-a4;01-4*4;03:4*6)

cMark：标签,0-15字符。
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字符。
cPacking：包装,0-15字符。
cTransNote：托运备注,0-63字符。


cMoney：货币代码，0-3字符。
fGoods：物品货值，代收货款收件人支付的货值，2位小数。
fDValue：物品声明价，2位小数。
fIValue：物品投保价，2位小数。
cOrigin：原产地国家代码，0-3字符。
cGoodsA：物品别名，通常为英文描述,0-254字符。
cGCodeA：物品甲码，通常为HS编码,0-63字符。
cGCodeB：物品乙码，通常为统一编码,0-63字符。
cGCodeC：物品丙码，通常为客户编码,0-63字符。
fGCustom：关税额，2位小数。
fGCRate：税率，4位小数。


3.3.2、响应：
成功：{"ReturnValue":1,cNum":"EE1020472289",cNo":"LN562467349CN","cMess":"","cReserve":"留用串","cBy1":"","cBy2":"","cBy3":"","cBy4":"","cBy5":"Test备5"}
失败：{"ReturnValue":-12,cNum":"EE1020472289",cNo":"","cMess":"收件国家空"}
-810：网络渠道(cEmsKind)错误
3.3.2.1、字段名解释
ReturnValue：1，成功。负数，失败（-12：数据提交或检查错误，解释参见“cMess”）
cNo：获取的运单号！
cMess：错误信息,0-63字符。
cReserve：留用串，0-30字符。
cBy1：备用1，0-62字符。
cBy2：备用2，0-62字符。
cBy3：备用3，0-62字符。
cBy4：备用4，0-62字符。
cBy5：备用5，0-254字符。





3.4.1、DoGetNo
3.4.1、请求：
{"RequestName":"DoGetNo","icID":79,"TimeStamp":1416458014000,"MD5":"ddcf481543088e8d22c4a52a3e92bc53","iType":0,"cEmsKind":"国际小包"}

3.4.1.1、字段名解释
iType：运单号类别，默认0。(0:转单号；1:内单号)
cEmsKind：快递类别名称，1-15字节。


3.4.2、响应：
1，成功：{"ReturnValue":1,"cNo":"LN562467349CN","cReserve":"留用串","cBy1":"","cBy2":"","cBy3":"","cBy4":"","cBy5":"Test备5"}
0，单号资源耗尽。
负数：失败
-14：快递类别名称空
-15：快递类别无配置定义。(emsdata.ini)

cNo：获取的运单号！
*如下附加数据在提供cEmsKind(快递类别名称)时可能返回有效值
cReserve：留用串，0-30字符。
cBy1：备用1，0-62字符。
cBy2：备用2，0-62字符。
cBy3：备用3，0-62字符。
cBy4：备用4，0-62字符。
cBy5：备用5，0-254字符。




3.5、wGoodsInfo

3.5.1、请求：
{"RequestName":"wGoodsInfo","icID":79,"TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cDepot":"A11","iPage":1,"iPagePer":5,"nqType":1}

3.5.1.1、变量名解释
iPage：页次，默认1
iPagePer：每页记录数，默认值0，有效值0-1000,(0 表示仅返回记录总数)
iqwGiid：物品ID，物品在EMMis中的定义记录ID,如提供，则唯一识别，其它筛选条件失效。
cqgCode：物品统一编码，0-63字节，左包含筛选。
cqcCode：物品客户编码，0-63字节。左包含筛选。
nqType：库存状况，默认0，枚举值：(0：忽略；1：库存不足；2：库存正常；3：库存过多。)


3.5.2、样例
3.5.2.2、响应：
{"ReturnValue":1,"iPage":1,"iPagePer":5,"iTotalRec":6,"cDepot":"A11","iqwGiid":0,"cqgCode":"","cqcCode":"","nqType":1,"RecList":[{"iID":10,"iwGiid":13,"cgName":"被子","cgNameE":"","cMemo_d":"","cgCode":"FDH42343233455","ccCode":"FDH42343233","cUnit":"床","fWeight":5.110,"iEDays":0,"fPrice":222.00,"fPriceS":160.00,"fPriceB":190.00,"fPriceV":180.00,"fDValue":160.00,"fIValue":160.00,"fEValue":175.00,"cKind":"","iMin":10,"iMax":100,"iIn":1003,"iOut":1003,"iStock":0,"nState":0,"cMark":"","cMemo":""},{"iID":1,"iwGiid":1,"cgName":"打火机","cgNameE":"flight","cMemo_d":"退件","cgCode":"HGG42343214","ccCode":"BBFSA4243214","cUnit":"个","fWeight":0.010,"iEDays":365,"fPrice":70.00,"fPriceS":50.00,"fPriceB":65.00,"fPriceV":60.00,"fDValue":11.00,"fIValue":12.00,"fEValue":13.00,"cKind":"","iMin":999,"iMax":999,"iIn":9,"iOut":20,"iStock":-11,"nState":0,"cMark":"TestMark.","cMemo":"退件"},{"iID":3,"iwGiid":2,"cgName":"电视机","cgNameE":"TV Set","cMemo_d":"MEMO","cgCode":"DFASFASDFAS","ccCode":"DFHH442","cUnit":"台","fWeight":25.000,"iEDays":720,"fPrice":400.00,"fPriceS":220.00,"fPriceB":300.00,"fPriceV":250.00,"fDValue":220.00,"fIValue":220.00,"fEValue":220.00,"cKind":"电器","iMin":999,"iMax":999,"iIn":57,"iOut":5,"iStock":52,"nState":0,"cMark":"MMM","cMemo":"ORRO"},{"iID":8,"iwGiid":3,"cgName":"火锅","cgNameE":"","cMemo_d":"","cgCode":"33HH5254242","ccCode":"CGGRWRQW","cUnit":"口","fWeight":0.000,"iEDays":500,"fPrice":166.66,"fPriceS":122.22,"fPriceB":144.44,"fPriceV":133.33,"fDValue":122.21,"fIValue":133.31,"fEValue":111.11,"cKind":"","iMin":100,"iMax":999,"iIn":29,"iOut":16,"iStock":13,"nState":0,"cMark":"箱式包装","cMemo":"gggggg"},{"iID":4,"iwGiid":5,"cgName":"旗杆","cgNameE":"Flag pot","cMemo_d":"","cgCode":"TY342342433","ccCode":"KH42343242","cUnit":"杆","fWeight":23.500,"iEDays":80,"fPrice":55.50,"fPriceS":22.20,"fPriceB":44.40,"fPriceV":33.30,"fDValue":22.50,"fIValue":33.60,"fEValue":33.00,"cKind":"","iMin":999,"iMax":999,"iIn":21,"iOut":13,"iStock":8,"nState":0,"cMark":"","cMemo":""}]}


3.5.3、返回值含义
1：成功，有结果(iTotalRec)。
0：无结果。
小于零：失败。

*RecList,物品记录对象列表
iID：物品归库ID
iwGiid：物品定义ID
cgName：物品中文名称，1-63字节
cgNameE：物品英文名称，0-254字节
cMemo_d：物品定义备注,0-254字节
cgCode：物品统一编码，1-63字节
ccCode：物品客户编码，1-63字节
cUnit：计量单位，0-15字节
fWeight：重量
iEDays：保质期（天数）
fPrice：零售价
fPriceS：代售价
fPriceB：团购价
fPriceV：VIP价
fDValue：声明价
fIValue：投保价
fEValue：评估价
cKind：物品类别，0-30字节
iMin：最小库存
iMax：最大库存
iStock：库存量
iIn：入库总数
iOut：出库总数
nState：状态，枚举（0：营运；1：停售）
cMark：归库标签
cMemo：归库备注




3.6、wInQuery

3.6.1、请求：
{"RequestName":"wInQuery","icID":79,"TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cDepot":"A11","iPage":1,"iPagePer":5,"cqDateB":"2013-01-01","cqDateE":"2015-06-01"}


3.6.1.1、变量名解释
iPage：页次，默认1
iPagePer：每页记录数，默认值0，有效值0-1000,(0 表示仅返回记录总数)
cqDateB：日期时间开始，必须。格式("YYYY-MM-DD hh:mm:ss"),年月日必须
cqDateE：日期时间结束，必须。格式("YYYY-MM-DD hh:mm:ss"),年月日必须，且不早于cqDateB
nqDateType：日期时间类别，默认0(预入库记录创建日期时间),1:入库确认日期时间
iqwGiid：物品ID，物品在EMMis中的定义记录ID,如提供，则唯一识别，cqgCode|cqcCode筛选条件失效。
cqgCode：物品统一编码，0-63字节，左包含筛选。
cqcCode：物品客户编码，0-63字节。左包含筛选。
nqType：记录状态，默认0，枚举值：(0：忽略；1：未审核(nState=0)；2：已审核未入库确认(nState=10,20,30)；3：已入库确认(nState=40)。)

3.6.2、样例
3.6.2.2、响应：
{"ReturnValue":1,"iPage":1,"iPagePer":5,"iTotalRec":46,"cDepot":"A11","cqDateB":"2013-01-01","cqDateE":"2015-06-01","nqDateType":0,"iqwGiid":0,"cqgCode":"","cqcCode":"","nqType":0,"RecList":[{"iID":43,"iwGiid":14,"cgName":"退件","cgNameE":"","cMemo_d":"","cgCode":"HH423432LLLL","ccCode":"JJ342423432","cUnit":"","nType":1,"nState":40,"cBatch":"","cRNo":"HH333339999","dDate":"2013-01-29 10:19","dInDate":"2013-01-29 10:19","iQuantity":1,"fPick":0.00,"fQCIn":0.00,"fLabel":0.00,"fArrange":0.00,"iPic":0,"cMark":"","cMemo":""},{"iID":44,"iwGiid":14,"cgName":"退件","cgNameE":"","cMemo_d":"","cgCode":"HH423432LLLL","ccCode":"JJ342423432","cUnit":"","nType":1,"nState":40,"cBatch":"","cRNo":"PP333339999","dDate":"2013-01-29 10:19","dInDate":"2013-01-29 10:19","iQuantity":1,"fPick":0.00,"fQCIn":0.00,"fLabel":0.00,"fArrange":0.00,"iPic":0,"cMark":"","cMemo":""},{"iID":45,"iwGiid":13,"cgName":"被子","cgNameE":"","cMemo_d":"","cgCode":"FDH42343233455","ccCode":"FDH42343233","cUnit":"床","nType":0,"nState":40,"cBatch":"B2013051011","cRNo":"","dDate":"2013-05-10 11:31","dInDate":"2013-05-10 11:33","iQuantity":1000,"fPick":0.00,"fQCIn":0.00,"fLabel":0.00,"fArrange":0.00,"iPic":0,"cMark":"","cMemo":""},{"iID":46,"iwGiid":13,"cgName":"被子","cgNameE":"","cMemo_d":"","cgCode":"FDH42343233455","ccCode":"FDH42343233","cUnit":"床","nType":0,"nState":0,"cBatch":"","cRNo":"","dDate":"2013-07-17 12:03","dInDate":"","iQuantity":100,"fPick":0.00,"fQCIn":0.00,"fLabel":0.00,"fArrange":0.00,"iPic":0,"cMark":"","cMemo":""},{"iID":47,"iwGiid":1,"cgName":"打火机","cgNameE":"flight","cMemo_d":"退件","cgCode":"HGG42343214","ccCode":"BBFSA4243214","cUnit":"个","nType":0,"nState":10,"cBatch":"","cRNo":"","dDate":"2013-07-17 12:03","dInDate":"","iQuantity":120,"fPick":0.00,"fQCIn":240.00,"fLabel":720.00,"fArrange":120.00,"iPic":0,"cMark":"","cMemo":""}]}


3.6.3、返回值含义
1：成功，有结果(iTotalRec)。
0：无结果。
小于零：失败。

*RecList,入库记录对象列表
iID：入库记录ID
iwGiid：物品定义ID
cgName：物品中文名称，1-63字节
cgNameE：物品英文名称，0-254字节
cMemo_d：物品定义备注,0-254字节
cgCode：物品统一编码，1-63字节
ccCode：物品客户编码，1-63字节
cUnit：计量单位，0-15字节
nType：入库类型，枚举：(0:正常；1：退件；2：平仓)
nState：记录状态，枚举：(0:未处理；10：已审核；20：已提货确认；30：已质检；40：完成入库确认
cBatch：批次号，0-30字节
cRNo：参考号，0-30字节
dDate：记录创建日期时间
dInDate：入库确认日期时间
iQuantity：数量

fPick：上门提货费
fQCIn：入库质检费
fLabel：标签费
fArrange：理货费

iPic：关联图片数量
cMark：标签，0-15字节
cMemo：备注，0-254字节




3.7、wInTotal

3.7.1、请求：
{"RequestName":"wInTotal","icID":79,"TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cDepot":"A11","cqDateB":"2013-01-01","cqDateE":"2015-06-01"}


3.7.1.1、变量名解释
cqDateB：确认入库日期时间开始，必须。格式("YYYY-MM-DD hh:mm:ss"),年月日必须
cqDateE：确认入库日期时间结束，必须。格式("YYYY-MM-DD hh:mm:ss"),年月日必须，且不早于cqDateB
iqwGiid：物品ID，物品在EMMis中的定义记录ID,如提供，则唯一识别，cqgCode|cqcCode筛选条件失效。
cqgCode：物品统一编码，0-63字节，左包含筛选。
cqcCode：物品客户编码，0-63字节。左包含筛选。

3.7.2、样例
3.7.2.2、响应：
{"ReturnValue":1,"cDepot":"A11","cqDateB":"2013-01-01","cqDateE":"2015-06-01","iqwGiid":0,"cqgCode":"","cqcCode":"","RecList":[{"iwGiid":13,"cgName":"被子","cgNameE":"","cMemo_d":"","cgCode":"FDH42343233455","ccCode":"FDH42343233","cUnit":"床","iQuantity":1000,"iNormal":1000,"iDefective":0,"iCount":1},{"iwGiid":2,"cgName":"电视机","cgNameE":"TV Set","cMemo_d":"MEMO","cgCode":"DFASFASDFAS","ccCode":"DFHH442","cUnit":"台","iQuantity":27,"iNormal":20,"iDefective":7,"iCount":4},{"iwGiid":3,"cgName":"火锅","cgNameE":"","cMemo_d":"","cgCode":"33HH5254242","ccCode":"CGGRWRQW","cUnit":"口","iQuantity":23,"iNormal":23,"iDefective":0,"iCount":1},{"iwGiid":14,"cgName":"退件","cgNameE":"","cMemo_d":"","cgCode":"HH423432LLLL","ccCode":"JJ342423432","cUnit":"","iQuantity":0,"iNormal":0,"iDefective":0,"iCount":3}],"iTotalRec":4}

3.7.3、返回值含义
1：成功，有结果(iTotalRec)。
0：无结果。
小于零：失败。

*RecList,入库汇总记录对象列表
iwGiid：物品定义ID
cgName：物品中文名称，1-63字节
cgNameE：物品英文名称，0-254字节
cMemo_d：物品定义备注,0-254字节
cgCode：物品统一编码，1-63字节
ccCode：物品客户编码，1-63字节
cUnit：计量单位，0-15字节
iQuantity：数量
iNormal：正品数量
iDefective：次品数量
iCount：记录数





3.8.1、wOrderSet
3.8.1、请求：
{"RequestName":"wOrderSet","icID":79,"TimeStamp":1405534421123,"MD5":"6c08ea4dff56d5a7a959c09f121c3c4f","cDepot":"A11","cBatch":"BH000123","OrderList":[{"ioID":0,"nItemType":1,"nLanguage":2,"cEmsKind":"DHL","cDes":"US","fWeight":2.123,"cNum":"CNEX1234567","cNo":"EM123456789CN","GoodsList":[{"cxcCode":"KH42343242","ixQuantity":2,"fxPrice":30.12},{"cxcCode":"CGGRWRQW","ixQuantity":3,"fxPrice":10.55}]},...]}

3.8.1.1、字段名解释
icID：客户ID,必须。客户唯一识别。
cDepot：仓库编码，1-3字符，必须。
cBatch：批次号,0-30字符

*OrderList：订单记录列表，为1-N个快件订单对象
#如下为记录对象的成员，除了必须的，其它可不提供
ioID：订单记录ID,大于零，表明为记录数据修改，否则，为新记录添加。必须提供，且必须是记录对象的第一个参数（将用于辅助定界）！
nItemType：快件类型，默认为1。取值为：0(文件),1(包裹),2(防水袋)
nLanguage：地域语言，默认为0。取值为：0(中国大陆),1(华语),2(其它地域)
cEmsKind：快递类别,1-15字符，必须。
cAddrFrom：出发地,0-63字符。
cDes：目的地,1-63字符，必须。
fWeight：重量，公斤，3位小数。

nOrderType：订单类别，枚举，默认0。(0:快递;1:提货)
nPriceType：物品价格类型，枚举，默认0。(0:零售价;1:团购价;2:VIP价;3:代售价)
bBox：是否包装，逻辑值，默认：false
bVoidDel：是否缺货时取消订单，逻辑值，默认：true
bInvoice：是否打印发票，逻辑值，默认：false
bList：是否打印装箱单，逻辑值，默认：false

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：转单号,0-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字符。
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字符。


**GoodsList：快件所含物品列表，为1-100个物品对象
#为了区分，命名在顶层字段名称中嵌入了一个“x”,注意字段长度有所不同。

cxcCode：物品客户编码，1-63字节
cxgCode：物品统一编码，1-63字节
cxgName：物品中文名称，1-63字节
cxgNameE：物品英文名称，1-254字节
ixwGiid：物品定义ID
#以上5个物品识别字段请提供任意一个且仅一个！如多种物品,且本订单所提供的字段一致

ixQuantity：物品数量。必须。
fxPrice：物品单价，2位小数。可不提供。


3.8.2、响应：
{"ReturnValue":1,"OK":1,"ErrList":[{"iIndex":0,"ioID":69,"cNum":"CNEX1234567","cNo":"EM123456789CN","cMess":"","cReserve":"","cBy1":"","cBy2":"","cBy3":"","cBy4":"","cBy5":""}]}
3.8.2.1、字段名解释
ReturnValue：正数，处理记录数。负数，失败（-2：icID错误；-3:没有OrderList；-9:系统错误）
OK：成功数
*ErrList：处理记录信息列表,按原始顺序返回。
iIndex：索引位置，0开始
iID：记录ID，一条预录单记录，都有一个唯一的不可更改的ID,系统识别码，对于记录的删除、修改则以此识别。
cNum：内单号，记录在系统内部的运单号，唯一。
cNo：转单号，记录在系统的转运单号，可能有系统生成。
cMess：错误信息,0-63字符，空串为无错误。
*如果emsdata.ini定义了“字段填写定义”，则可能返回期望的数据
cReserve：留用串，0-30字符。
cBy1：备用1，0-62字符。
cBy2：备用2，0-62字符。
cBy3：备用3，0-62字符。
cBy4：备用4，0-62字符。
cBy5：备用5，0-254字符。



3.9.1、wOrderDel
3.9.1、请求：
{"RequestName":"wOrderDel","icID":79,"TimeStamp":1405534421123,"MD5":"6c08ea4dff56d5a7a959c09f121c3c4f","cDepot":"A11","ioIDs":[1,2,3,...]}
3.9.1.1、字段名解释
icID：客户ID,必须。客户唯一识别。
cDepot：仓库编码，1-3字符，必须。
ioIDs：订单记录ID数组,1-N个大于零的整数
3.9.2、响应：
{"ReturnValue":3,"OK":1,"ErrList":[{"iIndex":0,"ioID":1,"cMess":"记录不存在"},{"iIndex":2,"ioID":3,"cMess":"订单已经确认出库。"}]}
3.9.2.1、字段名解释
ReturnValue：正数，处理记录数。负数，失败（-2：icID错误；-3:没有ID数组；-9:系统错误）。
OK：成功数
*ErrList：失败记录列表
iIndex：索引位置，0开始
ioID：记录ID
cMess：错误信息,1-63字符



3.10、wOutQuery

3.10.1、请求：
{"RequestName":"wOutQuery","icID":79,"TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cDepot":"A11","iPage":1,"iPagePer":5,"cqDateB":"2013-01-01","cqDateE":"2015-06-01"}


3.10.1.1、变量名解释
iPage：页次，默认1
iPagePer：每页记录数，默认值0，有效值0-1000,(0 表示仅返回记录总数)
cqDateB：出库日期时间开始，必须。格式("YYYY-MM-DD hh:mm:ss"),年月日必须
cqDateE：出库日期时间结束，必须。格式("YYYY-MM-DD hh:mm:ss"),年月日必须，且不早于cqDateB
iqwGiid：物品ID，物品在EMMis中的定义记录ID,如提供，则唯一识别，cqgCode|cqcCode筛选条件失效。
cqgCode：物品统一编码，0-63字节，左包含筛选。
cqcCode：物品客户编码，0-63字节。左包含筛选。
nqOrderType：订单类别，枚举，默认0。(0:快递;1:提货;大于5:忽略)

3.10.2、样例
3.10.2.2、响应：
{"ReturnValue":1,"iPage":1,"iPagePer":5,"iTotalRec":2,"cDepot":"A11","cqDateB":"2013-01-01","cqDateE":"2015-06-01","iqwGiid":0,"cqgCode":"","cqcCode":"","nqOrderType":0,"RecList":[{"iID":59,"iwGiid":2,"cgName":"电视机","cgNameE":"TV Set","cMemo_d":"MEMO","cgCode":"DFASFASDFAS","ccCode":"DFHH442","cUnit":"台","ioID":17,"nOrderType":0,"cBatch":"","cNum":"OOPP233333","cNo":"ES719039679CS","cRNo":"EC","dDate":"2012-07-29 19:00","dChooseDate":"2015-03-25 16:06","dOutDate":"2015-03-27 10:44","iQuantity":2,"cMark":"测试ccc","cMemo":""},{"iID":60,"iwGiid":13,"cgName":"被子","cgNameE":"","cMemo_d":"","cgCode":"FDH42343233455","ccCode":"FDH42343233","cUnit":"床","ioID":48,"nOrderType":0,"cBatch":"","cNum":"UU42342343","cNo":"ES719039705CS","cRNo":"","dDate":"2012-10-22 15:10","dChooseDate":"2015-03-25 16:06","dOutDate":"2015-03-26 11:23","iQuantity":3,"cMark":"测试ccc","cMemo":""}]}

3.10.3、返回值含义
1：成功，有结果(iTotalRec)。
0：无结果。
小于零：失败。

*RecList,入库记录对象列表
iID：出库记录ID
iwGiid：物品定义ID
cgName：物品中文名称，1-63字节
cgNameE：物品英文名称，0-254字节
cMemo_d：物品定义备注,0-254字节
cgCode：物品统一编码，1-63字节
ccCode：物品客户编码，1-63字节
cUnit：计量单位，0-15字节

ioID：订单记录ID
nOrderType：订单类别，枚举。(0:快递;1:提货;2:次品;3:平仓;4:移库)
cBatch：订单批次号，0-30字节
cNum：订单号，0-30字节
cNo：订单转单号，0-30字节
cRNo：订单参考号，0-30字节
dDate：订单记录创建日期时间
dChooseDate：拣货完成日期时间
dOutDate：出库确认日期时间
iQuantity：数量

cMark：订单标签，0-15字节
cMemo：订单备注，0-254字节




3.11、wOutTotal

3.11.1、请求：
{"RequestName":"wOutTotal","icID":79,"TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cDepot":"A11","cqDateB":"2013-01-01","cqDateE":"2015-06-01"}


3.11.1.1、变量名解释
cqDateB：确认出库日期时间开始，必须。格式("YYYY-MM-DD hh:mm:ss"),年月日必须
cqDateE：确认出库日期时间结束，必须。格式("YYYY-MM-DD hh:mm:ss"),年月日必须，且不早于cqDateB
iqwGiid：物品ID，物品在EMMis中的定义记录ID,如提供，则唯一识别，cqgCode|cqcCode筛选条件失效。
cqgCode：物品统一编码，0-63字节，左包含筛选。
cqcCode：物品客户编码，0-63字节。左包含筛选。

3.11.2、样例
3.11.2.2、响应：
{"ReturnValue":1,"cDepot":"A11","cqDateB":"2013-01-01","cqDateE":"2015-06-01","iqwGiid":0,"cqgCode":"","cqcCode":"","RecList":[{"iwGiid":13,"cgName":"被子","cgNameE":"","cMemo_d":"","cgCode":"FDH42343233455","ccCode":"FDH42343233","cUnit":"床","iQuantity":990,"iNormal":990,"iDefective":0,"iCount":2},{"iwGiid":2,"cgName":"电视机","cgNameE":"TV Set","cMemo_d":"MEMO","cgCode":"DFASFASDFAS","ccCode":"DFHH442","cUnit":"台","iQuantity":5,"iNormal":4,"iDefective":1,"iCount":3}],"iTotalRec":2}

3.11.3、返回值含义
1：成功，有结果(iTotalRec)。
0：无结果。
小于零：失败。

*RecList,出库汇总记录对象列表
iwGiid：物品定义ID
cgName：物品中文名称，1-63字节
cgNameE：物品英文名称，0-254字节
cMemo_d：物品定义备注,0-254字节
cgCode：物品统一编码，1-63字节
ccCode：物品客户编码，1-63字节
cUnit：计量单位，0-15字节
iQuantity：数量
iNormal：正品数量
iDefective：次品数量
iCount：物品记录数(并非订单数，而是订单物品记录总和，因为一个订单可能有多种物品)




3.12、wOrderTotal

3.12.1、请求：
{"RequestName":"wOrderTotal","icID":79,"TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cDepot":"A11"}


3.12.1.1、变量名解释
cqDateB：订单创建日期时间开始。格式("YYYY-MM-DD hh:mm:ss"),年月日必须
cqDateE：订单创建日期时间结束。格式("YYYY-MM-DD hh:mm:ss"),年月日必须，且不早于cqDateB
iqwGiid：物品ID，物品在EMMis中的定义记录ID,如提供，则唯一识别，cqgCode|cqcCode筛选条件失效。
cqgCode：物品统一编码，0-63字节，左包含筛选。
cqcCode：物品客户编码，0-63字节。左包含筛选。
nqState：订单状态，枚举值，默认0，忽略。(0:所有未出库;1:已审核;2:未审核;3:已拣货)
       

3.12.2、样例
3.12.2.2、响应：
{"ReturnValue":1,"cDepot":"A11","nqState":0,"cqDateB":"","cqDateE":"","iqwGiid":0,"cqgCode":"","cqcCode":"","RecList":[{"iwGiid":13,"cgName":"被子","cgNameE":"","cMemo_d":"","cgCode":"FDH42343233455","ccCode":"FDH42343233","cUnit":"床","iQuantity":19,"iRealOut":19,"iCount":6},{"iwGiid":1,"cgName":"打火机","cgNameE":"flight","cMemo_d":"退件","cgCode":"HGG42343214","ccCode":"BBFSA4243214","cUnit":"个","iQuantity":44,"iRealOut":44,"iCount":10},{"iwGiid":2,"cgName":"电视机","cgNameE":"TV Set","cMemo_d":"MEMO","cgCode":"DFASFASDFAS","ccCode":"DFHH442","cUnit":"台","iQuantity":18,"iRealOut":18,"iCount":9},{"iwGiid":6,"cgName":"刮胡刀","cgNameE":"","cMemo_d":"","cgCode":"GG45423324","ccCode":"KK42343242","cUnit":"","iQuantity":3,"iRealOut":3,"iCount":3},{"iwGiid":3,"cgName":"火锅","cgNameE":"","cMemo_d":"","cgCode":"33HH5254242","ccCode":"CGGRWRQW","cUnit":"口","iQuantity":9,"iRealOut":9,"iCount":5},{"iwGiid":5,"cgName":"旗杆","cgNameE":"Flag pot","cMemo_d":"","cgCode":"TY342342433","ccCode":"KH42343242","cUnit":"杆","iQuantity":16,"iRealOut":16,"iCount":9}],"iTotalRec":6}


3.12.3、返回值含义
1：成功，有结果(iTotalRec)。
0：无结果。
小于零：失败。

*RecList,出库汇总记录对象列表
iwGiid：物品定义ID
cgName：物品中文名称，1-63字节
cgNameE：物品英文名称，0-254字节
cMemo_d：物品定义备注,0-254字节
cgCode：物品统一编码，1-63字节
ccCode：物品客户编码，1-63字节
cUnit：计量单位，0-15字节
iQuantity：订单物品数量
iRealOut：订单审核后实际数量
iCount：物品记录数(并非订单数，而是订单物品记录总和，因为一个订单可能有多种物品)






3.13、wOrderInfo

3.13.1、请求：
{"RequestName":"wOrderInfo","icID":79,"TimeStamp":1405534421123,"MD5":"c435e730ad0e2587761234e3dbb1eefb","cDepot":"A11","iPage":1,"iPagePer":10,"cqDateB":"2013-01-01","cqDateE":"2015-06-01","cqStateMask":"000011"}


3.13.1.1、变量名解释
cqDateB：订单创建日期时间开始。必须，格式("YYYY-MM-DD hh:mm:ss"),年月日必须
cqDateE：订单创建日期时间结束。必须，格式("YYYY-MM-DD hh:mm:ss"),年月日必须，且不早于cqDateB
cqStateMask：查询记录筛选：记录状态掩码，共6种状态，用6位0或1表示，1表示筛选，0表示过滤。如审核状态（010000）,所有已审核(011111),未审核(100000)            
            0：未审
            1：审核
            2：拣选
            3：检验
            4：包装
            5：已出

iqoID：订单ID，在EMMis中的记录ID,如提供，则唯一识别，后续筛选条件失效。
cqNum：订单号，0-30字节，左包含筛选。
cqRNo：参考号，0-30字节，左包含筛选。
cqNo：转单号，0-30字节，左包含筛选。
cqBatch：批次号，0-30字节。精确匹配。

       

3.13.2、样例
3.13.2.2、响应：
{"ReturnValue":1,"iPage":1,"iPagePer":10,"iTotalRec":3,"cDepot":"A11","cqDateB":"2013-01-01","cqDateE":"2015-06-01","iqoID":0,"cqNum":"","cqNo":"","cqRNo":"","cqBatch":"","cqStateMask":"000011","RecList":[{"ioID":54,"nOrderType":2,"nState":50,"cNum":"54354353","cBatch":"","cNum":"54354353","cNo":"","cRNo":"","cGoods":"电视机","iQuantity":1,"iCategory":1,"cPack":"","cTransNote":"1","dDate":"2013-09-24","dSysDate":"2013-09-24 09:24","dAudDate":"2013-09-24 09:25","dChooseDate":"2013-09-24 09:27","dOutDate":"2013-09-24 09:35","cMark":"","cMemo":""},{"ioID":57,"nOrderType":4,"nState":50,"cNum":"kk77777777","cBatch":"","cNum":"kk77777777","cNo":"","cRNo":"","cGoods":"","iQuantity":2,"iCategory":1,"cPack":"","cTransNote":"","dDate":"2013-09-24","dSysDate":"2013-09-24 17:52","dAudDate":"2013-09-24 17:52","dChooseDate":"","dOutDate":"2013-09-24 17:52","cMark":"测试提示","cMemo":"提示2"},{"ioID":68,"nOrderType":4,"nState":50,"cNum":"PP42333333388GG","cBatch":"","cNum":"PP42333333388GG","cNo":"","cRNo":"","cGoods":"","iQuantity":987,"iCategory":1,"cPack":"","cTransNote":"","dDate":"2015-03-26","dSysDate":"2015-03-26 16:19","dAudDate":"2015-03-26 16:19","dChooseDate":"","dOutDate":"2015-03-26 16:19","cMark":"mark","cMemo":"memo"}]}


3.13.3、返回值含义
1：成功，有结果(iTotalRec)。
0：无结果。
小于零：失败。

1：成功，有结果(iTotalRec)。
0：无结果。
小于零：失败。

*RecList,订单记录对象列表

ioID：订单记录ID
nOrderType：订单类别，枚举。(0:快递;1:提货;2:次品;3:平仓;4:移库)
nState：订单状态，枚举。(0:未审;10:审核;20:拣选;30:检验;40:包装;50:已出)
cBatch：订单批次号，0-30字节
cNum：订单号，0-30字节
cNo：订单转单号，0-30字节
cRNo：订单参考号，0-30字节
cGoods：物品描述,0-254字节，可能与真实物品不一致，是一个编辑字段
iQuantity：物品数量，能与真实物品数量不一致，是一个编辑字段
iCategory：物品重数
cPack：包装，0-15字节
cTransNote：托运备注，0-63字节
dDate：订单日期
dSysDate：订单记录创建日期时间
dAud：订单审核日期时间
dChooseDate：拣货完成日期时间
dOutDate：出库确认日期时间

cMark：订单标签，0-15字节
cMemo：订单备注，0-254字节






3.14.1、RecTransBagSet
3.14.1、请求：
{"RequestName":"RecTransBagSet","icID":79,"TimeStamp":1442373685000,"MD5":"9f0edba0409cb604b1d5509e292c3582","TransNums":["YDH000000017","YDH000000020","45607890"],"cEmsKind":"UPS","cDes":"US","fWeight":2.123,"cNum":"CNEX1234567TRANS"...}

3.14.1.1、字段名解释
icID：客户ID,必须。客户唯一识别。

*TransNums：到件记录运单号列表，为1-N个运单号,用于组合为一个转发快件包裹.
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字符。
cRIDCard：收件证照号,0-30字符。

cNum：运单号,7-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字符。
cSIDCard：发件证照号,0-30字符。

cMark：标签,0-15字符。
cMemo：备注,0-254字符。
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字符。

cPacking：包装,0-15字符。
cTransNote：托运备注,0-63字符。
fgWeight：物品净重，3位小数。

#如下为7个运费附加字段，选择提供(v7.3)
faGet：提货费，2位小数。
faSafe：保险费，2位小数。
faPack：包装费，2位小数。
faOther：杂费，2位小数。
faCheck：验货费，2位小数。
faRemote：偏远费，2位小数。
faBy：其它费，2位小数。


3.14.2、响应：
"ReturnValue":53,"cNum":"CNEX1234567TRANS"}
3.14.2.1、字段名解释
ReturnValue：正数，成功,打包记录ID,如果需要后续处理,如删除,请记录此数值。负数，失败
cNum：回传运单号

其它错误值含义:
-3:没有解析出到件记录运单号列表(TransNums)
-4:到件记录检查异常,状态错误或不存在...
-14:没有解析出运单号(cNum)
-15:没有解析出快递类别(cEmsKind)
-16:没有解析出目的地(cDes)





3.15.1、RecTransBagDel
3.15.1、请求：
{"RequestName":"RecTransBagDel","icID":79,"TimeStamp":1442373685000,"MD5":"9f0edba0409cb604b1d5509e292c3582","iIDs":[53,18766,25]}

3.15.1.1、字段名解释
icID：客户ID,必须。客户唯一识别。

*iIDs：打包记录ID列表，为1-N个记录ID.

3.15.2、响应：
{"ReturnValue":3,"OK":1,"ErrList":[{"iID":18766,"cMess":"\u8BB0\u5F55\u4E0D\u5B58\u5728\u3002"},{"iID":25,"cMess":"\u8BB0\u5F55\u5DF2\u7ECF\u5904\u7406\u3002"}]}
3.15.2.1、字段名解释
ReturnValue：正数，处理记录成功。负数，失败
OK:成功删除记录数
ErrList:未删除的记录,原因参阅cMess信息




3.16.1、RecTransSet
3.16.1、请求：
{"RequestName":"RecTransSet","icID":79,"TimeStamp":1442373685000,"MD5":"9f0edba0409cb604b1d5509e292c3582","RecList":[{"iID":0,"nItemType":1,"cEmsKind":"EMS","fWeight":2.123,"cNum":"CNEX1234567","GoodsList":[{"cxGoods":"电视机","ixQuantity":1,"fxPrice":1500.12},{"cxGoods":"裤子","ixQuantity":2,"fxPrice":88.99}]},...]}

3.16.1.1、字段名解释
icID：客户ID,必须。客户唯一识别。

*RecList：预报到件记录列表，为1-N个预报到件记录对象
#如下为记录对象的成员，除了必须的，其它可不提供
iID：预报到件记录ID,大于零，表明为记录数据修改，否则，为新记录添加。必须提供，且必须是记录对象的第一个参数（将用于辅助定界）！
cNum：运单号,4-30字符,必须。
nItemType：快件类型，默认为1。取值为：0(文件),1(包裹),2(防水袋)
cEmsKind：网络渠道,0-15字符。
fWeight：重量，公斤，3位小数。
iItem：件数，默认1。
fAmount：快递费，2位小数。
nOpen：是否可拆包，默认为0。取值为：0(不拆包),1(可拆包)

cMark：标签,0-15字符。
cMemo：备注,0-254字符。
nEx1：扩展数1，0-255
nEx2：扩展数2，0-255
nEx3：扩展数3，0-255
cEx1：扩展串1,0-63字符。
cEx2：扩展串2,0-63字符。
cEx3：扩展串3,0-254字符。

cGoods：物品描述,0-254字符。
iQuantity：物品数量，默认0
fPrice：物品单价，2位小数。
cMoney：货币代码，0-3字符。
fGoods：物品货值，2位小数。
fGoodsc：收货时代客户支付的货款，2位小数。
fDValue：物品声明价，2位小数。
fIValue：物品投保价，2位小数。
cPayDir：结算指示，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字符。

**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位小数。

3.16.2、响应：
{"ReturnValue":2,"OK":1,"ErrList":[{"iIndex":0,"iID":0,"cNum":"CEN88676666","cMess":"运单号重复"},{"iIndex":1,"iID":123,"cNum":"EM77882299CN","cMess":""}]}
3.16.2.1、字段名解释
ReturnValue：正数，处理记录数。负数，失败（-2：icID错误；-3:没有RecList；-9:系统错误）
OK：成功数
*ErrList：处理记录信息列表,按原始顺序返回。
iIndex：索引位置，0开始
iID：记录ID，一条预报到件记录，都有一个唯一的不可更改的ID,系统识别码，对于记录的删除、修改则以此识别。
cNum：运单号，包裹上人眼可识别的单号。
cMess：错误信息,0-63字符，空串为无错误。




3.17.1、RecTransDel
3.17.1、请求：
{"RequestName":"RecTransDel","icID":79,"TimeStamp":1442373685000,"MD5":"9f0edba0409cb604b1d5509e292c3582","iIDs":[1,2,3,...]}
3.17.1.1、字段名解释
icID：客户ID,必须。客户唯一识别。
iIDs：预报到件记录ID数组,1-N个大于零的整数
3.17.2、响应：
{"ReturnValue":3,"OK":1,"ErrList":[{"iIndex":0,"iID":1,"cMess":"记录不存在"},{"iIndex":2,"iID":3,"cMess":"记录已经处理，不能删除"}]}
3.17.2.1、字段名解释
ReturnValue：正数，处理记录数。负数，失败（-2：icID错误；-3:没有ID数组；-9:系统错误）。
OK：成功数
*ErrList：失败记录列表
iIndex：索引位置，0开始
iID：记录ID
cMess：错误信息,1-63字符



3.4、RecTransData

3.18.1、请求：
{"RequestName":"RecTransData","icID":79,"TimeStamp":1442373685000,"MD5":"9f0edba0409cb604b1d5509e292c3582","iID":2,"cNum":"LS000000341SH"}
3.18.1.1、字段名解释
icID：客户ID,在EMMis系统的id,整数，大于零，必须提供。
iID：记录ID,大于零，如提供，优先采用，则无需提供cNum
cNum：运单号，4-30字符，精确匹配

3.18.2、样例
3.18.2.1、请求：
  API: /cgi-bin/EmsData.dll?WeChat
  POST_DATA:{"RequestName":"RecTransData","icID":79,"iID":2188876}
3.18.2.2、响应：
{"ReturnValue":1,"icID":79,"iID":2188876,"ibID":46,"irID":0,"nItemType":1,"nOpen":0,"dDate":"1900-01-01 00:00:00","cNum":"5559993333333","cEmsKind":"ups","cStationc":"","cStationr":"","cShelf":"","dDate_r":"2013-12-23 12:12:08","cName_r":"","fWeight":0.000,"iItem":2,"fAmount":0.00,"cMark":"","cMemo":"","nEx1":0,"nEx2":0,"nEx3":0,"cEx1":"","cEx2":"","cEx3":"","cGoods":"衣物","iQuantity":5,"fPrice":0.00,"fGoods":0.00,"fGoodsc":0.00,"fDValue":0.00,"fIValue":0.00,"cMoney":"CNY","cPayDir":"PP","cGoodsA":"","cGCodeA":"","cGCodeB":"","cGCodeC":"","fGCustom":0.00,"fGCRate":0.0000,"cPacking":"","cTransNote":"","GoodsList":[{"cxGoods":"鞋子","ixQuantity":3,"fxPrice":100.00,"cxGoodsA":"","cxGCodeA":"","cxGCodeB":"","cxGCodeC":"","fxGCustom":0.00,"fxGCRate":0.0000},{"cxGoods":"帽子","ixQuantity":2,"fxPrice":150.00,"cxGoodsA":"","cxGCodeA":"","cxGCodeB":"","cxGCodeC":"","fxGCustom":0.00,"fxGCRate":0.0000}]}

3.18.3、字段名解释,参阅(help_app.txt::3.2.1.1)
irID：处理到快递系统后的记录ID。可以理解：0=未处理(未收取快件包裹)；>0：已处理(已经收取快件包裹)
ReturnValue：1，成功。负数，失败（-2：记录不存在；-6:快件已操作，入快递系统；-9:系统错误）。
ibID：关联打包指令ID,据此判断：>0,已发打包指令
irID：关联快递业务记录ID,据此判断：>0,已转发(到快递业务)
dDate：记录录入时间
dDate_r：到件确认时间，如果空，则未到件
cName_r：到件确认操作者
cStationc：站点（客户预报选择填写的）
cStationr：站点（到件确认所属的）
cShelf：存放架位



3.5、RecTransList

3.19.1、请求：
{"RequestName":"RecTransList","icID":79,"TimeStamp":1442373685000,"MD5":"9f0edba0409cb604b1d5509e292c3582","iPage":1,"iPagePer":5,"dqBDate":"2012-10-03","cqStation":"SH"}
3.19.1.1、字段名解释
icID：客户ID,在EMMis系统的id,整数，大于零，必须提供。
iPage：页次，默认1
iPagePer：每页记录数，默认值100，有效值0-1000,(0 表示仅返回记录总数)

*如下为筛选条件
dqBDate：查询记录筛选：开始日期
dqBDate：查询记录筛选：结束日期
cqEmsKind：查询记录筛选：快递类别
cqNum：查询记录筛选：内单号，包含查找
cqMark：查询记录筛选：标签，包含查找
cqStation：查询记录筛选：传接站点
bqReceived：查询记录筛选：true:已到件;false:未到件
bqBagged：查询记录筛选：true:已发打包指令;false:未发打包指令
bqSent：查询记录筛选：true:已打包转发;false:未打包转发

3.19.2、响应：
{"ReturnValue":1,"iPage":2,"iPagePer":100,"iTotalRec":2000,"dqBDate":"2013-10-03","dqEDate":"2014-01-20","cqEmsKind":"EMS","cqNum":"EMS7788","cqMark":"","bqReceived":"","bqBagged":"","bqSent":"","RecList":[{"iID":10,"dDate":"2014-01-20 12:46:23","nItemType":1,"nLanguage":2,"cEmsKind":"EMS国际","cDes":"美国","fWeight":2.123,"cNum":"CNEX1234567","cNo":"EM123456789CN"..},,...]}
3.19.2.1、字段名解释,参阅3.2.1.1,不提供物品明细
ReturnValue：1成功并有数据；0：无记录；负数：查询失败
iTotalRec：符合查询条件的记录总数。当前返回的记录明细由RecList决定，为0 - iPagePer条。
iID：记录ID,大于零，记录操作的唯一标识，记录数据修改或删除时，须提供。
dDate：记录录入系统日期时间。
cStation:客户录入站点
cStationr:到件确认站点


3.19.2.2、样例
{"ReturnValue":1,"icID":79,"iPage":1,"iPagePer":5,"iTotalRec":5,"dqBDate":"2012-10-03","dqEDate":"","cqEmsKind":"","cqNum":"","cqMark":"","cqStation":"SH","RecList":[{"iID":2188850,"ibID":0,"irID":0,"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":"","nEx1":0,"nEx2":0,"nEx3":0,"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","cGoodsA":"","cGCodeA":"","cGCodeB":"","cGCodeC":"","fGCustom":0.00,"fGCRate":0.0000,"cStation":"","cStationr":"SH","cPacking":"","cTransNote":""},{"iID":2188820,"ibID":36,"irID":0,"nItemType":1,"nOpen":1,"dDate":"2013-02-12 16:51:48","cNum":"KK34444999888GG","cEmsKind":"生同","cShelf":"ggg5555","dDate_r":"2013-02-12 16:51:15","cName_r":"预置账号","fWeight":2.330,"iItem":1,"fAmount":0.00,"cMark":"马kuang","cMemo":"发扽s","nEx1":0,"nEx2":0,"nEx3":0,"cEx1":"ex1","cEx2":"ex2","cEx3":"ex3","cGoods":"电视","iQuantity":1,"fPrice":0.00,"fGoods":0.00,"fGoodsc":0.00,"fDValue":0.00,"fIValue":0.00,"cMoney":"USD","cPayDir":"PP","cGoodsA":"","cGCodeA":"","cGCodeB":"","cGCodeC":"","fGCustom":0.00,"fGCRate":0.0000,"cStation":"上海","cStationr":"SH","cPacking":"","cTransNote":""},{"iID":2188814,"ibID":30,"irID":24594,"nItemType":1,"nOpen":0,"dDate":"2013-02-08 17:45:26","cNum":"34323433477","cEmsKind":"渠道A","cShelf":"4544535377","dDate_r":"2013-02-05 17:34:22","cName_r":"预置账号","fWeight":1.550,"iItem":2,"fAmount":0.00,"cMark":"","cMemo":"GDFGDG66666","nEx1":0,"nEx2":0,"nEx3":0,"cEx1":"","cEx2":"","cEx3":"","cGoods":"","iQuantity":1,"fPrice":0.00,"fGoods":0.00,"fGoodsc":0.00,"fDValue":0.00,"fIValue":0.00,"cMoney":"CNY","cPayDir":"PP","cGoodsA":"","cGCodeA":"","cGCodeB":"","cGCodeC":"","fGCustom":0.00,"fGCRate":0.0000,"cStation":"0","cStationr":"SH","cPacking":"","cTransNote":""},{"iID":2188813,"ibID":30,"irID":24594,"nItemType":1,"nOpen":0,"dDate":"2013-02-10 09:38:03","cNum":"JJ5354345345345","cEmsKind":"广州希优特","cShelf":"hhgjhg","dDate_r":"2013-02-04 16:20:57","cName_r":"预置账号","fWeight":1.200,"iItem":1,"fAmount":0.00,"cMark":"","cMemo":"","nEx1":0,"nEx2":0,"nEx3":0,"cEx1":"","cEx2":"","cEx3":"","cGoods":"","iQuantity":1,"fPrice":0.00,"fGoods":0.00,"fGoodsc":0.00,"fDValue":0.00,"fIValue":0.00,"cMoney":"CNY","cPayDir":"PP","cGoodsA":"","cGCodeA":"","cGCodeB":"","cGCodeC":"","fGCustom":0.00,"fGCRate":0.0000,"cStation":"0","cStationr":"SH","cPacking":"","cTransNote":""},{"iID":2188812,"ibID":30,"irID":24594,"nItemType":1,"nOpen":0,"dDate":"2013-02-10 09:49:32","cNum":"GG343234234324","cEmsKind":"广州希优特","cShelf":"8888","dDate_r":"2013-02-04 16:20:34","cName_r":"预置账号","fWeight":1.230,"iItem":1,"fAmount":0.00,"cMark":"","cMemo":"","nEx1":0,"nEx2":0,"nEx3":0,"cEx1":"","cEx2":"","cEx3":"","cGoods":"","iQuantity":1,"fPrice":0.00,"fGoods":0.00,"fGoodsc":0.00,"fDValue":0.00,"fIValue":0.00,"cMoney":"CNY","cPayDir":"PP","cGoodsA":"","cGCodeA":"","cGCodeB":"","cGCodeC":"","fGCustom":0.00,"fGCRate":0.0000,"cStation":"0","cStationr":"SH","cPacking":"","cTransNote":""}]}


3.20、wGoodsPicSet

3.20.1、请求：
{"RequestName":"wGoodsPicSet","icID":79,"TimeStamp":1442373685000,"MD5":"9f0edba0409cb604b1d5509e292c3582","iwGiid":19,"nPos":5,"cFileName":".jpg","vPic":"as56..."}
3.4.1.1、字段名解释
iwGiid：物品ID。
cgCode：物品统一编码，0-63字节。
*上面两个物品关联条件至少定义一个！或者下面两个参数，用于查询关联记录*
cAccount：EMMis中客户账号，1-30字节。
ccCode：物品客户编码，1-63字节。

nPos：图片位置(1-255),默认1
cFileName：文件名，4-255字符，必须提供，系统只解析扩展名（“.xxx”）
vPic：图片数据(base64编码)

3.20.2、样例
3.20.2.2、响应：
3.20.3、字段名解释,参阅3.2.1.1
ReturnValue：大于零，成功(记录ID)。负数，失败。
   -11:物品ID*错误
   -12:文件名不合法，没有解析出文件扩展名
   -13:图片数据不存在
   -14:图片数据太少(<1k)
   -15:图片数据太多(>500kb)
   -16:图片数据解码错误(base64)



3.21、wGoodsPicQuery

3.21.1、请求：
{"RequestName":"wGoodsPicQuery","icID":79,"TimeStamp":1442373685000,"MD5":"9f0edba0409cb604b1d5509e292c3582","iqwGiid":19}
3.4.1.1、字段名解释
iqwGiid：物品ID。
cqgCode：物品统一编码，0-63字节。
*上面两个筛选条件至少定义一个！或者下面两个参数，用于查询关联记录*
cqAccount：EMMis中客户账号，1-30字节。
cqcCode：物品客户编码，1-63字节。



3.21.2、样例
3.21.2.2、响应：
{"ReturnValue":1,"igID":19,"anPos":[1,2,5],"iTotalRec":3}
3.21.3、字段名解释,参阅3.2.1.1
ReturnValue：1，成功。负数，失败。
0：无结果
-11:*物品ID*错误

anPos：图片位置数组,如上在1,2,5三个位置有图片
iTotalRec：图片记录总数。





3.22、wGoodsPicGet

3.22.1、请求：
{"RequestName":"wGoodsPicGet","icID":79,"TimeStamp":1442373685000,"MD5":"9f0edba0409cb604b1d5509e292c3582","iqwGiid":19,"nqPos":2}
3.4.1.1、字段名解释
iqwGiid：物品ID。
cqgCode：物品统一编码，0-63字节。
*上面两个筛选条件至少定义一个！或者下面两个参数，用于查询关联记录*
cqAccount：EMMis中客户账号，1-30字节。
cqcCode：物品客户编码，1-63字节。

nqPos：图片位置(1-255),默认1


3.22.2、样例
3.22.2.2、响应：
{"ReturnValue":1,"igID":19,"nPos":2,"iLen":6038,"cExt":"gif","vPic":"R0lGODlhfgCfANUAADO150...EnJogADs="}
3.22.3、字段名解释,参阅3.2.1.1
ReturnValue：1，成功。负数，失败。
0：无结果
-11:*物品ID*错误

igID：物品ID,=iqwGiid
iLen：图片真实大小(字节)
cExt：文件扩展名,也可以简单理解为图片文件类型
vPic：图片数据(base64),解码后应该与iLen长度一致。




3.23.1、RecTransBagSetEx
3.23.1、请求：
{"RequestName":"RecTransBagSetEx","icID":79,"TimeStamp":1442373685000,"MD5":"9f0edba0409cb604b1d5509e292c3582","BagInfo":[{"cEmsKind":"UPS","cDes":"US","fWeight":2.123,"cNum":"CNEX1234567TRANS"...}],"RecTransList":[{"iID":0,"nItemType":1,"cEmsKind":"EMS","fWeight":2.123,"cNum":"CNEX1234567","GoodsList":[{"cxGoods":"电视机","ixQuantity":1,"fxPrice":1500.12},{"cxGoods":"裤子","ixQuantity":2,"fxPrice":88.99}]},...]}

3.23.1.1、字段名解释
icID：客户ID,必须。客户唯一识别。

*数据为两块,第一块为"BagInfo",第二块为"RecTransList",两块都采用对象数组格式包装

*BagInfo:打包记录数据
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字符。
cRIDCard：收件证照号,0-30字符。

cNum：运单号,7-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字符。
cSIDCard：发件证照号,0-30字符。

cMark：标签,0-15字符。
cMemo：备注,0-254字符。
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字符。

cPacking：包装,0-15字符。
cTransNote：托运备注,0-63字符。
fgWeight：物品净重，3位小数。

#如下为7个运费附加字段，选择提供(v7.3)
faGet：提货费，2位小数。
faSafe：保险费，2位小数。
faPack：包装费，2位小数。
faOther：杂费，2位小数。
faCheck：验货费，2位小数。
faRemote：偏远费，2位小数。
faBy：其它费，2位小数。

*RecTransList:所含到件包裹数据,参阅3.16.1.1
iID：为零，必须提供，且必须是记录对象的第一个参数（将用于辅助定界）！
cNum：运单号,4-30字符,必须。
nItemType：快件类型，默认为1。取值为：0(文件),1(包裹),2(防水袋)
cEmsKind：网络渠道,0-15字符。
fWeight：重量，公斤，3位小数。
iItem：件数，默认1。
fAmount：快递费，2位小数。
nOpen：是否可拆包，默认为0。取值为：0(不拆包),1(可拆包)

cMark：标签,0-15字符。
cMemo：备注,0-254字符。
nEx1：扩展数1，0-255
nEx2：扩展数2，0-255
nEx3：扩展数3，0-255
cEx1：扩展串1,0-63字符。
cEx2：扩展串2,0-63字符。
cEx3：扩展串3,0-254字符。

cGoods：物品描述,0-254字符。
iQuantity：物品数量，默认0
fPrice：物品单价，2位小数。
cMoney：货币代码，0-3字符。
fGoods：物品货值，2位小数。
fGoodsc：收货时代客户支付的货款，2位小数。
fDValue：物品声明价，2位小数。
fIValue：物品投保价，2位小数。
cPayDir：结算指示，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字符。

**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位小数。


3.23.2、响应：
"ReturnValue":53,"cNum":"CNEX1234567TRANS","iTotalTrans":2}
3.23.2.1、字段名解释
ReturnValue：正数，成功,打包记录ID,如果需要后续处理,如删除,请记录此数值。负数，失败
cNum：回传运单号
iTotalTrans:所含到件包裹数


其它错误值含义:
-3:没有解析出所含到件包裹列表(RecTransList)
-4:没有解析出打包记录数据(BagInfo)
-14:没有解析出打包记录运单号(cNum)
-15:没有解析出快递类别(cEmsKind)
-16:没有解析出目的地(cDes)