一、总概 1.1、通讯协议遵循 HTTP (1.0/1.1) 1.2、数据包装采用JSON,遵循RFC4627 字符集编码：UTF-8 (65001) 或者 \u转义 *特别提示，共有8个ASCII码采用x编码转义： "(双引号) = \x22 \(反斜杠) = \x5C /(斜杠) = \x2F (换行符) = \x0A (回车符) = \x0D (制表符) = \x09 (罕用) (退格符) = \x08 (极罕用) (换页符) = \x0C (极罕用) *POST数据，遵循上述编码规则，不进行URL_Encode 1.3、接口API为：“/cgi-bin/EmsData.dll?Do” 1.4、接口请求方式为：POST 1.5、安全控制，校验请求源IP(emsdata.ini中配置) *开发调试连接，不进行源IP地址验证，因此请在每一个请求中都加上JSON成员变量："TestPass":"6677XXab99" *如：http://www.xxx.com/cgi-bin/EmsData.dll?Do&{"RequestName":"ClientAuth","TestPass":"6677XXab99",...} *TestPass:在emsdata.ini中配置“TEST_PASS=6677XXab99” 二、JSON命名规范 2.1、RequestName：发起请求名称，为请求方的第一个顶级成员名称，定义如下： {"RequestName":"ClientAuth",...}： 客户验证请求，成功返回完整的客户信息 {"RequestName":"PreInputSet",...}： 客户预录单数据写入（添加、修改） {"RequestName":"PreInputDel",...}： 客户预录单数据删除 {"RequestName":"PreInputData",...}： 客户预录单数据单票查询，返回完整数据 {"RequestName":"PreInputList",...}： 客户预录单数据列表查询 {"RequestName":"RecList",...}： 客户快递单数据列表查询 {"RequestName":"EmsKindList",...}： 客户可见快递类别列表查询 {"RequestName":"FeeList",...}： 客户收款记录数据列表查询 {"RequestName":"PreInputTotal",...}： 客户预录单数据按留用串汇总 {"RequestName":"ClientCreate",...}： 客户档案创建请求 {"RequestName":"FeeAdd",...}： 客户收款记录数据添加 2.2、ReturnValue：响应返回状态码，为响应方的第一个顶级成员名称，整数值，通用定义如下： {"ReturnValue":0,...}： 没有结果或零处理 {"ReturnValue":1,...}： 大于零，结果数或处理记录数，为成功的标识 {"ReturnValue":-1,...}： 唯一性字段值重复，操作失败 {"ReturnValue":-2,...}： 记录不存在，操作失败 {"ReturnValue":-3,...}： 未提供必须的请求参数，操作失败 {"ReturnValue":-4,...}： 请求不支持，版本错误或请求未实现 {"ReturnValue":-7,...}： 安全校验失败，不是配置的IP或数字签名错误 {"ReturnValue":-8,...}： 未获授权 {"ReturnValue":-9,...}： EmsData.dll程序错误，通常为数据库查询失败 {"ReturnValue":-9999,...}： 数据库忙，稍后再试！ *负数值均为失败，更多的含义在具体的请求中定义。 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、ClientAuth 3.1.1、请求： {"RequestName":"ClientAuth","icID":79,"cWebAccount":"xxx","cWeChat":"xxx"} 3.1.1.1、字段名解释 icID：客户ID,在EMMis系统的id,整数，大于零，如果提供，则优先，无需提供其它参数 cWebAccount：客户“网站登入帐号”，原始配置在GInfo系统中，在EMMis中关联，也是客户登入使用的帐号，1-30字符,大小写敏感 cWeChat：客户在EMMis系统中，客户档案的“微信帐号”字段值 *以上三个参数提供一个即可，通常第一次登入验证提供“网站登入帐号”或者“微信帐号”，后续提供客户ID。 3.1.2、样例 3.1.2.1、请求： API: /cgi-bin/EmsData.dll?Do POST_DATA:{"RequestName":"ClientAuth","icID":0,"cWebAccount":"Just4Test","cWeChat":""} 3.1.2.2、响应： {"ReturnValue":1,"icID":79,"cWebAccount":"Just4Test","cPassword":"1234","fCredit":413800.00,"fBalance":404605.43,"iNoAudit":3809,"fNoAudit":398890.98,"fABalance":419514.45,"cAccount":"Test","cStation":"南京","cUnitName":"调试专用","cUnitNameE":"Just for Test","cAddr":"上海市福州路667好45TTyyy","cAddrE":"1234 # Jingjiang Rd.o\x0D\x0AShanghai+家ffff","cCity":"上海市","cCityE":"shanghai","cProvince":"上海市","cProvinceE":"shanghai","cCountry":"中国","cCountryE":"China","cSign":"李ab","cSignE":"Micheal+Lee","cPostCode":"200001","cPhone":"13916365333","cFax":"5555556666","cSms":"13916365333","cEMail":"shichun_li@yahoo.com","cQQ":"a%bcdgg%gg444","cMSN":"耿耿gfffff","cSkype":"123abc222","cWang":"55555","cWeChat":"1234566666","cBy1":"把1\x22","cBy2":"把2\x5C\x5C\x2F\x2F","cBy3":"把3","cBy4":"把4","cBy5":"把5"} 3.1.2.3、特别提示： 该接口有多种用途，本质上为查询客户基本资讯。 首先用于客户登入验证。数据返回后，请至少维持变量“icID”,如本例的79，因为所有后续客户相关的请求，都需要这个变量。 其次可用于任何时候的客户资料查询、帐号余额情况查询等。 3.1.3、字段名解释 icID：客户ID，请维持该变量，客户所有后续操作均须提供该值进行识别。 cWebAccount：客户网站登入帐号，1-30字符 cPassword：密码，1-30字符 fCredit：客户授信额 fBalance：客户结算余额 iNoAudit：客户未核销快件票数 fNoAudit：客户未核销快件快递费总额 fABalance：客户可用发货余额 *以下字段均为客户在EMMis中的档案信息* cAccount：客户帐号，1-30字符 cStation：客户所属站点，0-15字符 cUnitName：客户单位名称，1-63字符 cUnitNameE：客户单位名称（英文），0-127字符 cAddr：地址，0-127字符 cAddrE：地址（英文），0-127字符 cCity：城市，0-63字符 cCityE：城市（英文），0-63字符 cProvince：省州，0-15字符 cProvinceE：省州（英文），0-30字符 cCountry：国家，0-30字符 cCountryE：国家（英文），0-63字符 cSign：客户签名，0-30字符 cSignE：客户签名（英文），0-30字符 cPostCode：邮编，0-15字符 cPhone：电话，0-22字符 cFax：传真，0-22字符 cSms：短信，0-22字符 cEMail：电邮，0-63字符 cQQ：QQ，0-63字符 cMSN：MSN，0-63字符 cSkype：Skype，0-63字符 cWang：旺旺，0-63字符 cWeChat：微信帐号，0-30字符 cBy1：备用1，0-63字符 cBy2：备用2，0-63字符 cBy3：备用3，0-63字符 cBy4：备用4，0-63字符 cBy5：备用5，0-254字符 3.2.1、PreInputSet 3.2.1、请求： {"RequestName":"PreInputSet","icID":79,"RecList":[{"iID":0,"nItemType":1,"nLanguage":2,"cEmsKind":"EMS国际","cDes":"美国","fWeight":2.123,"cNum":"CNEX1234567","cNo":"EM123456789CN","GoodsList":[{"cxGoods":"电视机","ixQuantity":1,"fxPrice":1500.12},{"cxGoods":"裤子","ixQuantity":2,"fxPrice":88.99}]},...]} 3.2.1.1、字段名解释 icID：客户ID,必须。客户唯一识别。 *RecList：快件预录记录列表，为1-N个快件记录对象 #如下为记录对象的成员，除了必须的，其它可不提供 iID：预录记录ID,大于零，表明为记录数据修改，否则，为新记录添加。必须提供，且必须是记录对象的第一个参数（将用于辅助定界）！ nItemType：快件类型，默认为1。取值为：0(文件),1(包裹),2(防水袋) nLanguage：地域语言，默认为0。取值为：0(中国大陆),1(华语),2(其它地域) cEmsKind：快递类别,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字符。 **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.2.2、响应： {"ReturnValue":3,"OK":1,"ErrList":[{"iIndex":0,"iID":0,"cNum":"CEN88676666","cMess":"运单号重复"},{"iIndex":1,"iID":123,"cNum":"EM77882299CN","cMess":""},{"iIndex":2,"iID":0,"cNum":"","cMess":"目的地空"}]} 3.2.2.1、字段名解释 ReturnValue：正数，处理记录数。负数，失败（-2：icID错误；-3:没有RecList；-9:系统错误） OK：成功数 *ErrList：处理记录信息列表,按原始顺序返回。 iIndex：索引位置，0开始 iID：记录ID，一条预录单记录，都有一个唯一的不可更改的ID,系统识别码，对于记录的删除、修改则以此识别。 cNum：内单号，记录在系统内部的运单号，唯一。 cMess：错误信息,0-63字符，空串为无错误。 3.3.1、PreInputDel 3.3.1、请求： {"RequestName":"PreInputDel","icID":79,"iIDs":[1,2,3,...]} 3.3.1.1、字段名解释 icID：客户ID,必须。客户唯一识别。 iIDs：预录记录ID数组,1-N个大于零的整数 3.3.2、响应： {"ReturnValue":3,"OK":1,"ErrList":[{"iIndex":0,"iID":1,"cMess":"记录不存在"},{"iIndex":2,"iID":3,"cMess":"快件已操作，不能删除"}]} 3.3.2.1、字段名解释 ReturnValue：正数，处理记录数。负数，失败（-2：icID错误；-3:没有ID数组；-9:系统错误）。 OK：成功数 *ErrList：失败记录列表 iIndex：索引位置，0开始 iID：记录ID cMess：错误信息,1-63字符 3.4、PreInputData 3.4.1、请求： {"RequestName":"PreInputData","icID":79,"iID":2,"cNum":"LS000000341SH"} 3.4.1.1、字段名解释 icID：客户ID,在EMMis系统的id,整数，大于零，必须提供，则优先，无需提供其它参数 iID：记录ID,大于零，如提供，优先采用，则无需提供cNum cNum：内单号，7-30字符，精确匹配 3.4.2、样例 3.4.2.1、请求： API: /cgi-bin/EmsData.dll?Do POST_DATA:{"RequestName":"PreInputData","icID":79,"cNum":"RB00012352CN"} 3.4.2.2、响应： {"ReturnValue":1,"icID":79,"iID":1599,"irID":0,"nItemType":1,"nLanguage":2,"cEmsKind":"EMS国际","cEmsKindi":"EMS国际","cAddrFrom":"上海青浦","cDes":"美国","fWeight":0.000,"iLong":0,"iWidth":0,"iHeight":0,"iItem":1,"siPayWay":1,"fAmount":0.00,"cReceiver":"David Esparza","cRUnit":"","cRAddr":"2706 Illinois Ave","cRCity":"South Gate","cRPostcode":"90280","cRProvince":"CA","cRCountry":"United States","cRPhone":"52423432423","cREMail":"derookie45@gmail.com","cRSms":"","cNum":"RB00012352CN","cNo":"RB00012352CN","cRNo":"3EK05589Y12168527","cCNo":"","cSender":"王恒","cSUnit":"上海华天国际","cSAddr":"上海市青浦区124号","cSCity":"青浦","cSPostcode":"200045","cSProvince":"上海","cSCountry":"中国","cSPhone":"13912345678","cSEMail":"wh@163.com","cSSms":"13912345555","cDepart":"市场部","cMark":"","cMemo":"$0.00","cReserve":"","iReserve":0,"cBy1":"","cBy2":"","cBy3":"","cBy4":"","cBy5":"","cGoods":"硬粒小麦,用醋或醋酸制作的黄瓜及小黄瓜","iQuantity":3,"fPrice":1.66,"fGoods":0.00,"fGoodsc":0.00,"fDValue":5.00,"fIValue":0.00,"cMoney":"USD","cPayDir":"PP","cOrigin":"","cGoodsA":"","cGCodeA":"","cGCodeB":"","cGCodeC":"","fGCustom":0.00,"fGCRate":0.0000,"cPacking":"Aug-16-12","cTransNote":"1,2","GoodsList":[{"cxGoods":"硬粒小麦","ixQuantity":1,"fxPrice":1.00,"cxGoodsA":"","cxGCodeA":"","cxGCodeB":"","cxGCodeC":"","fxGCustom":0.00,"fxGCRate":0.0000},{"cxGoods":"用醋或醋酸制作的黄瓜及小黄瓜","ixQuantity":2,"fxPrice":2.00,"cxGoodsA":"","cxGCodeA":"","cxGCodeB":"","cxGCodeC":"","fxGCustom":0.00,"fxGCRate":0.0000}]} 3.4.3、字段名解释,参阅3.2.1.1 irID：处理到快递系统后的记录ID。可以理解：0=未处理(未收取快件包裹)；>0：已处理(已经收取快件包裹) ReturnValue：1，成功。负数，失败（-2：记录不存在；-6:快件已操作，入快递系统；-9:系统错误）。 cEmsKindi：快递类别客户显示名称，可能与系统中真实的字段值不一样，1-15字符 3.5、PreInputList 3.5.1、请求： {"RequestName":"PreInputList","icID":79,"iPage":1,"iPagePer":100,"dqBDate":"2013-10-03","dqEDate":"2014-01-20","cqDes":"美国","cqEmsKind":"EMS国际","cqStateMask":"10","cqNum":"EMS7788","cqMark":"","cqReserve":""} 3.5.1.1、字段名解释 icID：客户ID,在EMMis系统的id,整数，大于零，必须提供。 iPage：页次，默认1 iPagePer：每页记录数，默认值100，有效值0-1000,(0 表示仅返回记录总数) *如下为筛选条件 cqStateMask：查询记录筛选：记录状态掩码，共2种状态，用2位0或1表示，1表示筛选，0表示过滤。如未处理（10）,所有(11),已处理(01) 0：未处理 1：已处理 dqBDate：查询记录筛选：开始日期 dqBDate：查询记录筛选：结束日期 cqDes：查询记录筛选：目的地，包含查找 cqEmsKind：查询记录筛选：快递类别 cqNum：查询记录筛选：内单号，包含查找。可以提供用“,”分割的多个运单号，总长度小于12000字节，如"12345,66222,EE772222CN,UP334444HH"，进行多单号精确查询 cqMark：查询记录筛选：标签，包含查找 cqReserve：查询记录筛选：留用串，包含查找 3.5.2、响应： {"ReturnValue":1,"iPage":2,"iPagePer":100,"iTotalRec":2000,"dqBDate":"2013-10-03","dqEDate":"2014-01-20","cqDes":"美国","cqEmsKind":"EMS国际","cqNum":"EMS7788","cqMark":"","cqReserve":"","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.5.2.1、字段名解释,参阅3.2.1.1,不提供物品明细 ReturnValue：1成功并有数据；0：无记录；负数：查询失败 iTotalRec：符合查询条件的记录总数。当前返回的记录明细由RecList决定，为0 - iPagePer条。 iID：记录ID,大于零，记录操作的唯一标识，记录数据修改或删除时，须提供。 dDate：记录录入系统日期时间。 3.5.2.2、样例 {"ReturnValue":1,"icID":79,"iPage":1,"iPagePer":8,"iTotalRec":23,"dqBDate":"2013-10-03","dqEDate":"2014-01-20","cqDes":"","cqEmsKind":"","cqStateMask":"","cqNum":"","cqMark":"","cqReserve":"","RecList":[{"iID":1669,"irID":0,"dDate":"2013-12-27 15:47:58","nItemType":1,"nLanguage":2,"cEmsKind":"俄通收专线","cEmsKindi":"俄通收专线","cAddrFrom":"","cDes":"俄罗斯","fWeight":1.200,"iLong":0,"iWidth":0,"iHeight":0,"iItem":1,"siPayWay":0,"fAmount":0.00,"cReceiver":"FFDFSDFSA","cRUnit":"","cRAddr":"FDSFDF,4234,333333fffff","cRCity":"","cRPostcode":"101000","cRProvince":"","cRCountry":"FDSFASFAS","cRPhone":"fdsafsafsa","cREMail":"","cRSms":"","cNum":"PX423432424","cNo":"","cRNo":"","cCNo":"","cSender":"","cSUnit":"","cSAddr":"ffdsfsaf","cSCity":"","cSPostcode":"","cSProvince":"","cSCountry":"","cSPhone":"","cSEMail":"","cSSms":"","cDepart":"","cMark":"","cMemo":"dfsafsaf","cReserve":"!货值错误","iReserve":0,"cBy1":"","cBy2":"","cBy3":"","cBy4":"","cBy5":"","cGoods":"234242342","iQuantity":1,"fPrice":0.00,"fGoods":0.00,"fGoodsc":0.00,"fDValue":0.00,"fIValue":0.00,"cMoney":"CNY","cPayDir":"PP","cOrigin":"CN","cGoodsA":"","cGCodeA":"","cGCodeB":"","cGCodeC":"","fGCustom":0.00,"fGCRate":0.0000,"cPacking":"","cTransNote":""},{"iID":1668,"irID":0,"dDate":"2013-12-27 11:05:02","nItemType":1,"nLanguage":2,"cEmsKind":"俄通收专线","cEmsKindi":"俄通收专线","cAddrFrom":"","cDes":"俄罗斯","fWeight":1.200,"iLong":0,"iWidth":0,"iHeight":0,"iItem":1,"siPayWay":0,"fAmount":0.00,"cReceiver":"HH42342342","cRUnit":"","cRAddr":"4342134214","cRCity":"","cRPostcode":"","cRProvince":"","cRCountry":"RU","cRPhone":"77423343242","cREMail":"","cRSms":"","cNum":"PX884234324324","cNo":"","cRNo":"","cCNo":"","cSender":"","cSUnit":"","cSAddr":"","cSCity":"","cSPostcode":"","cSProvince":"","cSCountry":"","cSPhone":"","cSEMail":"","cSSms":"","cDepart":"","cMark":"","cMemo":"","cReserve":"*城市ID错误","iReserve":0,"cBy1":"","cBy2":"","cBy3":"","cBy4":"","cBy5":"","cGoods":"1RWERWQ","iQuantity":1,"fPrice":1.20,"fGoods":0.00,"fGoodsc":0.00,"fDValue":0.00,"fIValue":0.00,"cMoney":"CNY","cPayDir":"PP","cOrigin":"CN","cGoodsA":"","cGCodeA":"","cGCodeB":"","cGCodeC":"","fGCustom":0.00,"fGCRate":0.0000,"cPacking":"","cTransNote":""},{"iID":1667,"irID":0,"dDate":"2013-12-25 18:50:22","nItemType":1,"nLanguage":2,"cEmsKind":"俄通收专线","cEmsKindi":"俄通收专线","cAddrFrom":"","cDes":"俄罗斯","fWeight":2.330,"iLong":0,"iWidth":0,"iHeight":0,"iItem":1,"siPayWay":0,"fAmount":0.00,"cReceiver":"HH433","cRUnit":"","cRAddr":"234,7,UUREEE","cRCity":"","cRPostcode":"101000","cRProvince":"","cRCountry":"RU","cRPhone":"883333344444","cREMail":"","cRSms":"","cNum":"PX7824545633","cNo":"1009502962","cRNo":"","cCNo":"","cSender":"","cSUnit":"","cSAddr":"","cSCity":"","cSPostcode":"","cSProvince":"","cSCountry":"","cSPhone":"","cSEMail":"","cSSms":"","cDepart":"","cMark":"","cMemo":"","cReserve":"1009502962","iReserve":54,"cBy1":"","cBy2":"","cBy3":"","cBy4":"","cBy5":"","cGoods":"FFF","iQuantity":1,"fPrice":2.60,"fGoods":0.00,"fGoodsc":0.00,"fDValue":0.00,"fIValue":0.00,"cMoney":"CNY","cPayDir":"PP","cOrigin":"CN","cGoodsA":"","cGCodeA":"","cGCodeB":"","cGCodeC":"","fGCustom":0.00,"fGCRate":0.0000,"cPacking":"","cTransNote":""},{"iID":1666,"irID":0,"dDate":"2013-12-25 18:45:26","nItemType":1,"nLanguage":2,"cEmsKind":"俄通收专线","cEmsKindi":"俄通收专线","cAddrFrom":"","cDes":"俄罗斯","fWeight":2.455,"iLong":0,"iWidth":0,"iHeight":0,"iItem":1,"siPayWay":0,"fAmount":0.00,"cReceiver":"BBFDD","cRUnit":"","cRAddr":"1,4,UUYERTRR","cRCity":"","cRPostcode":"101000","cRProvince":"","cRCountry":"RU","cRPhone":"99883333333","cREMail":"","cRSms":"","cNum":"PX542331111","cNo":"1009502906","cRNo":"","cCNo":"","cSender":"","cSUnit":"","cSAddr":"","cSCity":"","cSPostcode":"","cSProvince":"","cSCountry":"","cSPhone":"","cSEMail":"","cSSms":"","cDepart":"","cMark":"","cMemo":"","cReserve":"1009502906","iReserve":53,"cBy1":"","cBy2":"","cBy3":"","cBy4":"","cBy5":"","cGoods":"GGG","iQuantity":1,"fPrice":1.40,"fGoods":0.00,"fGoodsc":0.00,"fDValue":0.00,"fIValue":0.00,"cMoney":"CNY","cPayDir":"PP","cOrigin":"CN","cGoodsA":"","cGCodeA":"","cGCodeB":"","cGCodeC":"","fGCustom":0.00,"fGCRate":0.0000,"cPacking":"","cTransNote":""},{"iID":1665,"irID":0,"dDate":"2013-12-25 18:30:50","nItemType":1,"nLanguage":2,"cEmsKind":"俄通收专线","cEmsKindi":"俄通收专线","cAddrFrom":"","cDes":"俄罗斯","fWeight":1.330,"iLong":0,"iWidth":0,"iHeight":0,"iItem":1,"siPayWay":0,"fAmount":0.00,"cReceiver":"KHH333","cRUnit":"","cRAddr":"234,7,STREET","cRCity":"","cRPostcode":"101000","cRProvince":"","cRCountry":"RU","cRPhone":"4777555555","cREMail":"","cRSms":"","cNum":"PX77312312312","cNo":"1009502741","cRNo":"","cCNo":"","cSender":"","cSUnit":"","cSAddr":"","cSCity":"","cSPostcode":"","cSProvince":"","cSCountry":"","cSPhone":"","cSEMail":"","cSSms":"","cDepart":"","cMark":"","cMemo":"","cReserve":"1009502741","iReserve":52,"cBy1":"","cBy2":"","cBy3":"","cBy4":"","cBy5":"","cGoods":"RR555","iQuantity":1,"fPrice":23.00,"fGoods":0.00,"fGoodsc":0.00,"fDValue":0.00,"fIValue":0.00,"cMoney":"CNY","cPayDir":"PP","cOrigin":"CN","cGoodsA":"","cGCodeA":"","cGCodeB":"","cGCodeC":"","fGCustom":0.00,"fGCRate":0.0000,"cPacking":"","cTransNote":""},{"iID":1664,"irID":0,"dDate":"2013-12-25 09:56:54","nItemType":1,"nLanguage":2,"cEmsKind":"俄通收专线","cEmsKindi":"俄通收专线","cAddrFrom":"","cDes":"俄罗斯","fWeight":1.230,"iLong":0,"iWidth":0,"iHeight":0,"iItem":1,"siPayWay":0,"fAmount":0.00,"cReceiver":"vvvv","cRUnit":"","cRAddr":"fdff,7,uurrr","cRCity":"","cRPostcode":"101000","cRProvince":"","cRCountry":"ru","cRPhone":"77634333333","cREMail":"","cRSms":"","cNum":"PX366633333","cNo":"1009497377","cRNo":"","cCNo":"","cSender":"","cSUnit":"","cSAddr":"","cSCity":"","cSPostcode":"","cSProvince":"","cSCountry":"","cSPhone":"","cSEMail":"","cSSms":"","cDepart":"","cMark":"","cMemo":"","cReserve":"1009497377","iReserve":32,"cBy1":"","cBy2":"","cBy3":"","cBy4":"","cBy5":"","cGoods":"dffff","iQuantity":1,"fPrice":2.33,"fGoods":0.00,"fGoodsc":0.00,"fDValue":0.00,"fIValue":0.00,"cMoney":"CNY","cPayDir":"PP","cOrigin":"CN","cGoodsA":"","cGCodeA":"","cGCodeB":"","cGCodeC":"","fGCustom":0.00,"fGCRate":0.0000,"cPacking":"","cTransNote":""},{"iID":1663,"irID":0,"dDate":"2013-12-24 20:33:21","nItemType":1,"nLanguage":2,"cEmsKind":"俄通收专线","cEmsKindi":"俄通收专线","cAddrFrom":"","cDes":"俄罗斯","fWeight":0.000,"iLong":0,"iWidth":0,"iHeight":0,"iItem":1,"siPayWay":0,"fAmount":0.00,"cReceiver":"hhffff","cRUnit":"ggggghfh","cRAddr":"203,7,hhgeeefffff","cRCity":"","cRPostcode":"101000","cRProvince":"544444","cRCountry":"ru","cRPhone":"2233655555","cREMail":"","cRSms":"","cNum":"PX4555555ZZ","cNo":"","cRNo":"","cCNo":"","cSender":"","cSUnit":"fdsfsd","cSAddr":"gfdsgdgfgggghhhhfffff","cSCity":"","cSPostcode":"","cSProvince":"","cSCountry":"","cSPhone":"535435344444","cSEMail":"","cSSms":"","cDepart":"","cMark":"","cMemo":"fdgsdgddddffff","cReserve":"!没有出重","iReserve":0,"cBy1":"","cBy2":"","cBy3":"","cBy4":"","cBy5":"","cGoods":"ffff","iQuantity":1,"fPrice":1.55,"fGoods":0.00,"fGoodsc":0.00,"fDValue":0.00,"fIValue":0.00,"cMoney":"CNY","cPayDir":"PP","cOrigin":"CN","cGoodsA":"","cGCodeA":"","cGCodeB":"","cGCodeC":"","fGCustom":0.00,"fGCRate":0.0000,"cPacking":"","cTransNote":""},{"iID":1662,"irID":19943,"dDate":"2013-12-24 12:09:30","nItemType":1,"nLanguage":2,"cEmsKind":"俄通收专线","cEmsKindi":"俄通收专线","cAddrFrom":"","cDes":"俄罗斯","fWeight":1.230,"iLong":0,"iWidth":0,"iHeight":0,"iItem":1,"siPayWay":0,"fAmount":0.00,"cReceiver":"ggtt","cRUnit":"","cRAddr":"23,7,treee","cRCity":"Петропавловск-Камчатский 40","cRPostcode":"683040","cRProvince":"","cRCountry":"rusian","cRPhone":"432432424","cREMail":"","cRSms":"","cNum":"PX66288222222","cNo":"1009484225","cRNo":"","cCNo":"","cSender":"","cSUnit":"","cSAddr":"ffff","cSCity":"","cSPostcode":"","cSProvince":"","cSCountry":"","cSPhone":"","cSEMail":"","cSSms":"","cDepart":"","cMark":"","cMemo":"","cReserve":"1009484225","iReserve":21,"cBy1":"","cBy2":"","cBy3":"","cBy4":"","cBy5":"","cGoods":"dddd","iQuantity":1,"fPrice":1.24,"fGoods":0.00,"fGoodsc":0.00,"fDValue":0.00,"fIValue":0.00,"cMoney":"CNY","cPayDir":"PP","cOrigin":"CN","cGoodsA":"","cGCodeA":"","cGCodeB":"","cGCodeC":"","fGCustom":0.00,"fGCRate":0.0000,"cPacking":"","cTransNote":""}]} 3.6、RecList 3.6.1、请求： {"RequestName":"RecList","icID":79,"iPage":1,"iPagePer":100,"dqBDate":"2013-10-03","dqEDate":"2014-01-20","cqDes":"美国","cqEmsKind":"EMS国际","cqStateMask":"00111111111","bqAudit":false,"iqfID":0,"cqNum":"EMS7788","cqMark":"","cqReserve":""} 3.6.1.1、字段名解释 icID：客户ID,在EMMis系统的id,整数，大于零，必须提供。 iPage：页次，默认1 iPagePer：每页记录数，默认值100，有效值0-1000,(0 表示仅返回记录总数) *如下为筛选条件 dqBDate：查询记录筛选：开始日期 dqBDate：查询记录筛选：结束日期 cqDes：查询记录筛选：目的地，包含查找 cqEmsKind：查询记录筛选：快递类别 cqStateMask：查询记录筛选：记录状态掩码，共11种状态，用11位0或1表示，1表示筛选，0表示过滤。如送达状态（00010000000）,所有已发送(01111111111),所有异常(00001111111) 0：未发送 1：已发送 2：转运中 3：送达 4：超时 5：扣关 6：地址错误 7：快件丢失 8：退件 9：其它异常 10：销毁 bqAudit：查询记录筛选：是否核销付款，true或false iqfID：查询记录筛选：关联收款核销记录ID，可查询某笔收款核销的所有业务记录 cqNum：查询记录筛选：内单号，包含查找。可以提供用“,”分割的多个运单号，总长度小于12000字节，如"12345,66222,EE772222CN,UP334444HH"，进行多单号精确查询 cqMark：查询记录筛选：标签，包含查找 cqReserve：查询记录筛选：留用串，包含查找 *所有筛选条件均可不提供 3.6.2、响应： {"ReturnValue":1,"iPage":2,"iPagePer":100,"iTotalRec":2000,"dqBDate":"2013-10-03","dqEDate":"2014-01-20","cqDes":"","cqEmsKind":"EMS国际","cqStateMask":"","bqAudit":false,"cqNum":"","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.6.2.1、字段名解释,参阅3.2.1.1,3.5.2.1 ReturnValue：1成功并有数据；0：无记录；负数：查询失败 iTotalRec：符合查询条件的记录总数。当前返回的记录明细由RecList决定，为0 - iPagePer条。 *RecList irID：业务记录ID,大于零。注意区分，预录单的ID为iID,少一个“r”。 dDate：业务日期。 fSPrice：标准价,2位小数。 nState：记录状态，取值(0-10),参阅3.6.1.1（cStateMask） bAudit：是否核销付款，true或false ifID：收款核销记录ID,大于零：关联的收款核销记录ID；0：未收款核销 cEmsKindc：快递类别（客户要求） cEmsKindci：快递类别（客户要求）显示名称 iCubic：体积，立方厘米 faBase：快递费：基础费用 faAddOn：快递费：燃油附加费 faCustom：快递费：报关费 faOther：快递费：杂费 faGet：快递费：取件费 faCarry：快递费：派件费 faSafe：快递费：保险费 faPack：快递费：包装费 faCheck：快递费：验货费 faRemote：快递费：偏远费 faBy：快递费：其它费 faAddRate：燃油附加费率，4位小数 fDiscount：折扣，4位小数 cLTDate：末条追踪信息：日期时间 cLTPlace：末条追踪信息：操作地点 cLTInfo：末条追踪信息：详细信息 3.6.2.2、样例 {"ReturnValue":1,"icID":79,"iPage":1,"iPagePer":5,"iTotalRec":199,"dqBDate":"2013-10-03","dqEDate":"2014-01-20","cqDes":"","cqEmsKind":"","cqStateMask":"","cqNum":"","cqMark":"","cqReserve":"","RecList":[{"irID":20141,"dDate":"2014-01-20","nItemType":1,"fWeight":0.000,"iLong":0,"iWidth":0,"iHeight":0,"iCubic":0,"fAmount":0.00,"fSPrice":0.00,"nState":3,"nPayWay":0,"bAudit":false,"ifID":0,"iItem":1,"cEmsKind":"荷兰邮政","cEmsKindi":"","cEmsKindc":"荷兰邮政","cEmsKindci":"","cDes":"马尔代夫","cReceiver":"","cNum":"RS108315564NL","cNo":"RS108315564NL","cRNo":"","cCNo":"","cMark":"","cMemo":"","cGoods":"","cLTDate":"2014-02-24 17:18","cLTPlace":"MVMLEA","cLTInfo":"Final Delivery","iReserve":0,"iQuantity":1,"fGoods":0.00,"fGoodsc":0.00,"faBase":0.00,"faAddOn":0.00,"faCustom":0.00,"faOther":0.00,"faAddRate":0.0000,"faGet":0.00,"faCarry":0.00,"faSafe":0.00,"faPack":0.00,"faCheck":0.00,"faRemote":0.00,"faBy":0.00,"fDiscount":0.0000},{"irID":20186,"dDate":"2014-01-19","nItemType":1,"fWeight":0.000,"iLong":0,"iWidth":0,"iHeight":0,"iCubic":0,"fAmount":0.00,"fSPrice":0.00,"nState":3,"nPayWay":0,"bAudit":false,"ifID":0,"iItem":1,"cEmsKind":"荷兰邮政","cEmsKindi":"","cEmsKindc":"荷兰邮政","cEmsKindci":"","cDes":"危地马拉","cReceiver":"","cNum":"RS109670249NL","cNo":"RS109670249NL","cRNo":"","cCNo":"","cMark":"","cMemo":"","cGoods":"","cLTDate":"2014-02-24","cLTPlace":"","cLTInfo":"Entregado","iReserve":0,"iQuantity":1,"fGoods":0.00,"fGoodsc":0.00,"faBase":0.00,"faAddOn":0.00,"faCustom":0.00,"faOther":0.00,"faAddRate":0.0000,"faGet":0.00,"faCarry":0.00,"faSafe":0.00,"faPack":0.00,"faCheck":0.00,"faRemote":0.00,"faBy":0.00,"fDiscount":0.0000},{"irID":20143,"dDate":"2014-01-19","nItemType":1,"fWeight":0.000,"iLong":0,"iWidth":0,"iHeight":0,"iCubic":0,"fAmount":0.00,"fSPrice":0.00,"nState":3,"nPayWay":0,"bAudit":false,"ifID":0,"iItem":1,"cEmsKind":"荷兰邮政","cEmsKindi":"","cEmsKindc":"荷兰邮政","cEmsKindci":"","cDes":"马来西亚","cReceiver":"","cNum":"RS109676462NL","cNo":"RS109676462NL","cRNo":"","cCNo":"","cMark":"","cMemo":"","cGoods":"","cLTDate":"2014-02-05 17:36","cLTPlace":"CW SUBANG JAYA","cLTInfo":"Item has been successfully delivered","iReserve":0,"iQuantity":1,"fGoods":0.00,"fGoodsc":0.00,"faBase":0.00,"faAddOn":0.00,"faCustom":0.00,"faOther":0.00,"faAddRate":0.0000,"faGet":0.00,"faCarry":0.00,"faSafe":0.00,"faPack":0.00,"faCheck":0.00,"faRemote":0.00,"faBy":0.00,"fDiscount":0.0000},{"irID":20210,"dDate":"2014-01-18","nItemType":1,"fWeight":0.000,"iLong":0,"iWidth":0,"iHeight":0,"iCubic":0,"fAmount":0.00,"fSPrice":0.00,"nState":3,"nPayWay":0,"bAudit":false,"ifID":0,"iItem":1,"cEmsKind":"荷兰邮政","cEmsKindi":"","cEmsKindc":"荷兰邮政","cEmsKindci":"","cDes":"匈牙利","cReceiver":"","cNum":"RS109735072NL","cNo":"RS109735072NL","cRNo":"","cCNo":"","cMark":"","cMemo":"","cGoods":"","cLTDate":"2014-02-27 09:03","cLTPlace":"HUNGARY","cLTInfo":"The item has been delivered successfully","iReserve":0,"iQuantity":1,"fGoods":0.00,"fGoodsc":0.00,"faBase":0.00,"faAddOn":0.00,"faCustom":0.00,"faOther":0.00,"faAddRate":0.0000,"faGet":0.00,"faCarry":0.00,"faSafe":0.00,"faPack":0.00,"faCheck":0.00,"faRemote":0.00,"faBy":0.00,"fDiscount":0.0000},{"irID":20152,"dDate":"2014-01-18","nItemType":1,"fWeight":0.000,"iLong":0,"iWidth":0,"iHeight":0,"iCubic":0,"fAmount":0.00,"fSPrice":0.00,"nState":3,"nPayWay":0,"bAudit":false,"ifID":0,"iItem":1,"cEmsKind":"荷兰邮政","cEmsKindi":"","cEmsKindc":"荷兰邮政","cEmsKindci":"","cDes":"秘鲁","cReceiver":"","cNum":"RS109680793NL","cNo":"RS109680793NL","cRNo":"","cCNo":"","cMark":"","cMemo":"","cGoods":"","cLTDate":"2014-02-08","cLTPlace":"EL ENVIO FUE ENTREGADO EL 08\x2F02\x2F2014","cLTInfo":"EL ENVIO FUE ENTREGADO EL 08\x2F02\x2F2014 AL DESTINATARIO EVER PEREZ ARTEAGA","iReserve":0,"iQuantity":1,"fGoods":0.00,"fGoodsc":0.00,"faBase":0.00,"faAddOn":0.00,"faCustom":0.00,"faOther":0.00,"faAddRate":0.0000,"faGet":0.00,"faCarry":0.00,"faSafe":0.00,"faPack":0.00,"faCheck":0.00,"faRemote":0.00,"faBy":0.00,"fDiscount":0.0000}]} 3.7、EmsKindList 3.7.1、请求： {"RequestName":"EmsKindList"} 3.7.2、响应： {"ReturnValue":3,"List":[{"cEmsKind":"DPD欧洲","cEmsKindi":"DPD专线"},{"cEmsKind":"EMS国际","cEmsKindi":"国际快线"},{"cEmsKind":"UPS","cEmsKindi":"UPS"}]} 3.7.2.1、字段名解释 ReturnValue：快递类别条数 cEmsKind：快递类别名称，系统中真实操作的名称,也是录单数据传送的字段值，1-15字节 cEmsKindi：客户操作界面显示的快递类别名称，1-15字节 3.8、FeeList 3.8.1、请求： {"RequestName":"FeeList","icID":79,"iPage":1,"iPagePer":100,"dqBDate":"2013-10-03","dqEDate":"2014-01-20","cqTypeMask":"","cqPayWayMask":"","cqMark":"","cqInvoice":"","cqMoney":"CNY","cqRefNo":""} 3.5.1.1、字段名解释 icID：客户ID,在EMMis系统的id,整数，大于零，必须提供。 iPage：页次，默认1 iPagePer：每页记录数，默认值100，有效值0-1000,(0 表示仅返回记录总数) *如下为筛选条件 cqTypeMask：查询记录筛选：记录类别掩码，共2种，用2位0或1表示，1表示筛选，0表示过滤。如核收（10）,清缴(01) 0：核收 （关联1-n条快递业务记录，通常有票单金额，可以查询业务记录明细） 1：清缴 （无业务记录关联，金额可以为正负数，负数可以理解为退款...） cqPayWayMask：查询记录筛选：付款方式掩码，共5种方式，用5位0或1表示，1表示筛选，0表示过滤。如现金（10000）,冲销(00010),非冲销(11101) 0：现金 1：转帐 2：网络 3：冲销 4：其它 dqBDate：查询记录筛选：开始日期 dqBDate：查询记录筛选：结束日期 cqMark：查询记录筛选：标签，包含查找 cqInvoice：查询记录筛选：发票号，包含查找 cqMoney：查询记录筛选：币种，国际三字代码，如USD cqRefNo：查询记录筛选：票证号，包含查找 3.8.2、响应： {"ReturnValue":1,"iPage":2,"iPagePer":100,"iTotalRec":2000,"dqBDate":"2013-10-03","dqEDate":"2014-01-20","cqTypeMask":"","cqPayWayMask":"","cqMark":"","cqInvoice":"","cqMoney":"CNY","cqRefNo":"","RecList":[{"ifID":10,"dDate":"2014-01-20 12:46:23","nItemType":1,"nLanguage":2,"cEmsKind":"EMS国际","cDes":"美国","fWeight":2.123,"cNum":"CNEX1234567","cNo":"EM123456789CN"..},,...]} 3.8.2.1、字段名解释 ReturnValue：1成功并有数据；0：无记录；负数：查询失败 iTotalRec：符合查询条件的记录总数。当前返回的记录明细由RecList决定，为0 - iPagePer条。 ifID：记录ID,大于零，可用于RecList中的iqfID查询业务记录明细。 dDate：付款日期。 nType：记录类别，枚举值：0：核收；1：清缴 cMoney：币种，国际三字代码。 fFee：付款金额，2位小数，可以为负数。 fFeer：关联票单总计金额，2位小数，“清缴”类别为零。 fChg：原始货币金额，2位小数，当用非本币付款时记录此项。 nPayWay：付款方式，枚举值：0：现金；1：转帐；2：网络；3：冲销；4：其它 cInvoice：发票号。 cRefNo：票证号，通常为付款方关联的支付号码。 cDocNo：会计记帐凭证号。 cMark：标签 cMemo：备注 3.8.2.2、样例 "ReturnValue":1,"icID":79,"iPage":1,"iPagePer":10,"iTotalRec":5,"dqBDate":"2010-10-03","dqEDate":"2014-01-20","cqTypeMask":"","cqPayWayMask":"","cqMark":"","cqInvoice":"","cqMoney":"CNY","cqRefNo":"","RecList":[{"ifID":252,"dDate":"2013-06-14","nType":1,"cMoney":"CNY","fFee":90000.00,"fFeer":0.00,"fChg":90000.00,"nPayWay":0,"cInvoice":"hfdgh","cRefNo":"","cDocNo":"","cMark":"","cMemo":""},{"ifID":247,"dDate":"2013-03-07","nType":0,"cMoney":"CNY","fFee":0.00,"fFeer":117.32,"fChg":0.00,"nPayWay":0,"cInvoice":"","cRefNo":"","cDocNo":"","cMark":"","cMemo":""},{"ifID":240,"dDate":"2012-09-02","nType":0,"cMoney":"CNY","fFee":676.95,"fFeer":676.95,"fChg":676.95,"nPayWay":0,"cInvoice":"gfsdgsdgsd","cRefNo":"","cDocNo":"","cMark":"","cMemo":""},{"ifID":238,"dDate":"2012-03-16","nType":0,"cMoney":"CNY","fFee":0.00,"fFeer":0.00,"fChg":0.00,"nPayWay":0,"cInvoice":"","cRefNo":"","cDocNo":"","cMark":"","cMemo":""},{"ifID":220,"dDate":"2011-03-14","nType":0,"cMoney":"CNY","fFee":0.00,"fFeer":493.54,"fChg":0.00,"nPayWay":0,"cInvoice":"","cRefNo":"","cDocNo":"","cMark":"","cMemo":""}]} 3.9、PreInputTotal 3.9.1、请求： {"RequestName":"PreInputTotal","icID":79,"dqBDate":"2013-10-03","dqEDate":"2014-01-20","cqReserves":["AAA","BBB","CCC"]} 3.9.1.1、字段名解释 icID：客户ID,在EMMis系统的id,整数，大于零，必须提供。 *如下为筛选条件 dqBDate：查询记录筛选：开始日期 dqBDate：查询记录筛选：结束日期 cqReserves：查询记录筛选：留用串数组，精确匹配 3.9.2、响应： {"ReturnValue":1,"TotalList":[{"cReserve":"AAA","iTotal":10,...},,...]} 3.9.2.1、字段名解释,参阅3.2.1.1,不提供物品明细 ReturnValue：>0 成功,留用串数；0：无记录；负数：查询失败 iTotal：汇总数。 3.9.2.2、样例 3.9.2.2.1、{"RequestName":"PreInputTotal","icID":79,"dqBDate":"2013-10-03","dqEDate":"2014-01-20"} {"ReturnValue":10,"icID":79,"TotalList":[{"cReserve":"","iTotal":15},{"cReserve":"!货值错误","iTotal":1},{"cReserve":"!没有出重","iTotal":1},{"cReserve":"*城市ID错误","iTotal":1},{"cReserve":"1009484225","iTotal":1},{"cReserve":"1009497377","iTotal":1},{"cReserve":"1009502741","iTotal":1},{"cReserve":"1009502906","iTotal":1},{"cReserve":"1009502962","iTotal":2}]} 3.9.2.2.2、{"RequestName":"PreInputTotal","icID":79,"cqReserves":["1009502906","1009502962","CCC"]} {"ReturnValue":3,"icID":79,"TotalList":[{"cReserve":"1009502906","iTotal":1},{"cReserve":"1009502962","iTotal":2}]} 3.10、ClientCreate 3.10.1、请求： {"RequestName":"ClientCreate","cUnitName":"DPE Co., Ltd.",...} 3.10.1.1、字段名解释 cUnitName：客户单位名称，2-63字符 cAccount：客户帐号，0-30字符 cStation：客户所属站点，0-15字符 cUnitNameE：客户单位名称（英文），0-127字符 cAddr：地址，0-127字符 cAddrE：地址（英文），0-127字符 cCity：城市，0-63字符 cCityE：城市（英文），0-63字符 cProvince：省州，0-15字符 cProvinceE：省州（英文），0-30字符 cCountry：国家，0-30字符 cCountryE：国家（英文），0-63字符 cSign：客户签名，0-30字符 cSignE：客户签名（英文），0-30字符 cPostCode：邮编，0-15字符 cPhone：电话，0-22字符 cFax：传真，0-22字符 cSms：短信，0-22字符 cEMail：电邮，0-63字符 cQQ：QQ，0-63字符 cMSN：MSN，0-63字符 cSkype：Skype，0-63字符 cWang：旺旺，0-63字符 cWeChat：微信帐号，0-30字符 cBy1：备用1，0-63字符 cBy2：备用2，0-63字符 cBy3：备用3，0-63字符 cBy4：备用4，0-63字符 cBy5：备用5，0-254字符 cMName：经办人，0-30字符 cKind：客户组别，0-15字符 cBrief：客户简称，0-15字符 cOrder：发票抬头，0-63字符 cMark：标签，0-15字符 cMemo：标签，0-1022字符 nPayWay：默认付款方式，枚举(0:月结；1：现付；2：倒付),默认0 nState：客户类别，枚举(0:普通；1：同行),默认0 icID：客户ID,在EMMis系统的id,整数，大于零，如果提供，则优先，无需提供其它参数 cWebAccount：客户“网站登入帐号”，原始配置在GInfo系统中，在EMMis中关联，也是客户登入使用的帐号，1-30字符,大小写敏感 cWeChat：客户在EMMis系统中，客户档案的“微信帐号”字段值 *以上三个参数提供一个即可，通常第一次登入验证提供“网站登入帐号”或者“微信帐号”，后续提供客户ID。 3.10.2、样例 3.10.2.1、请求： API: /cgi-bin/EmsData.dll?Do POST_DATA:{"RequestName":"ClientCreate","cUnitName":"DPE Co., Ltd.","cMark":"For test"} 3.10.2.2、响应： {"ReturnValue":160,"cUnitName":"DPE Co., Ltd.","cAccount":"DPECOLTD24072"} 3.10.2.3、 ReturnValue：大于零(icID)成功；负数：失败 -1：相同名称的客户已经存在，不能新建。" -4：相同用户帐号已经存在，不能新建。 -5：相同网站会员帐号已经存在，不能新建。 3.11.1、FeeAdd 3.11.1、请求： {"RequestName":"FeeAdd","icID":79,"fFee":123.45,"cRefNo":"T2015121209345601","cMark":"AliPay"} 3.11.1.1、字段名解释 icID：客户ID,必须。客户唯一识别。 fFee：金额，2位小数,大于0。 cRefNo：票证号,7-30字符,必须唯一。 *如下字段可不提供* cAccount：走帐号,0-30字符。 cMark：标签,0-15字符。 cMemo：备注,0-254字符。 cMoney：实付外币币种,0-3字符。 fChg：实付外币金额，2位小数。 3.11.2、响应： {"ReturnValue":366,"ifID":366,"icID":79,"fFee":123.45,"cRefNo":"T2015121209345601","cAccount":"","cMark":"AliPay","cMemo":"","cMoney":"","fChg":0.00} 3.11.2.1、字段名解释 ReturnValue：正数，成功,记录ID,=ifID。 负数，失败 -12：金额错误 -13：票证号错误 -1：票证号重复(系统进行此字段的简单重复性检查,但未锁定数据库,也未进行同步,请提交方尽可能进行同步!) -2：icID客户不存在 四、测试连接 http://www.xxx.com/cgi-bin/EmsData.dll?Do&{"RequestName":"EmsKindList"} 五、条码位图生成接口 1、接口URL构造：http://www.xxx.com/cgi-bin/EmsData.dll?DoBarCode&ccode=EM123456789CN&ih=50&iwz=3&idir=0&ntype=0&cmask=A2C8A 或者：http://www.xxx.com/cgi-bin/EmsData.dll?MfcISAPICommand=DoBarCode&ccode=EM123456789CN&ih=50&idir=0&ntype=0&cmask=A2C8A 2、参数解释 ccode：文本串，1-60字符，必须提供。 ih：位图高度，像素值，默认30，有效范围：20-150 iwz：位图宽度放大系数，默认1，有效范围：1-8(位图数据最大值32kb) idir：方向，默认0。0:正位；1: 顺时针转90度；2: 顺时针转180度；3: 顺时针转270度 ntype：类型，默认0(Code128,带脚部字符)。0:Code 128；1:I25；2:GS1； +100：位图不含脚部字符 +1000：png格式（默认bmp位图） cmask：Code128编码类型强制定义，默认空，由系统优化。如例含义为：前两个字符用A编码(A2)，中间8个字符用C编码(C8)，余下的用A编码(A) *如果使用掩码指令，确保掩码与原始文本匹配。 3、返回值：成功,位图数据(bmp)；错误,返回字符串“E!”。 4、HTML示例：