****************
* 特别授权接口 *
****************

一、快件检查点扫描、复重等操作

接口:EmsScan
数据收发方式：协议：HTTP；方式：POST；附加数据类型：text/xml
全部附加定义
<KIND>1</KIND> 类别:0:到站,1:出站,2:派送,3:签收,4:异常*
5:复重,已录单记录(未发送),6:复重并正式录单,预录单记录(未处理)

<PID>GG12345</PID> 手持终端编号，1-30字符*
<DATE>YYYY.MM.DD HH:MM:SS</DATE> 操作时间
<NUM>EM66232332</NUM> 运单号：8-30字母数字或者连字符-,*
<NUMTYPE>0</NUMTYPE> 运单号类别：
*检查点扫描时，0:快件运单号(默认);1:袋号(总单装袋模块，到站和出站，相当于批量操作)
*复重时，0：查内单号，1：查转单号
<NEXTSTATION>苏州</NEXTSTATION> 下一站：0-15字符，“出站”时必须**
<EXTRA>张三</EXTRA> 附加字串：0-30字符，“派送”时为派件人，“签收”时为签收人**
<TRACKPLACE>上海</TRACKPLACE> 操作地址: 0-126字符
<TRACKINFO>快件从上海发往苏州</TRACKINFO> 操作详细信息:1-254字符*
<TRACKPLACEE>Shanghai</TRACKPLACEE> 操作地址英文: 0-126字符
<TRACKINFOE>From Shanghai to Suzhou</TRACKINFOE> 操作详细信息英文:0-254字符
<TRACKPOS>1</TRACKPOS> 追踪信息位置点:1:航班前,50:航班后,200:第三方追踪信息之后

<WEIGHT>2.345</WEIGHT> 计价重量公斤，三位小数精度

<WEIGHTB>2.345</WEIGHTB> 称重，公斤，三位小数精度
<LONG>30.2</LONG> 长(厘米)，复重用
<WIDTH>20.4</WIDTH> 宽(厘米)，复重用
<HEIGHT>10.8</HEIGHT> 高(厘米)，复重用
<TAKER>李四</TAKER> 取件人，复重用,0-30字符,空保持原值
<EMSKIND>UPS</EMSKIND> 快递类别，复重用，0-15字符,空保持原值
<NO>EE3333333555CN</NO> 转单号，复重用，0-30字符,空保持原值
<DES>美国</DES> 目的地，复重用，0-62字符,空保持原值
<INPUT>王五</INPUT> 录入者，复重用，0-30字符,与手持终端编号对应的用户姓名

<EXCEPTION>4</EXCEPTION> 异常状态，类别为“异常”时：4超时，5扣关，6错误，7丢失，8退件，9异常**
<PICTYPE>JPG</PICTYPE>3字符，大写：BMP,JPG,GIF,PNG
<PICDATA>图片数据</PICDATA>base64编码,参阅EmsTrans接口规则
<MD5>KEY00345566CN</MD5>*

*:必须提供
**:相关类别必须提供

返回码：>0,成功，记录ID；<0,失败：
失败返回码含义:
-1 用户不存在，手持终端编号对应的系统用户不存在
-2 业务记录不存在(或不在操作许可的状态)，不能操作
-3 该票业务记录已经送达，不能操作
-4 版本错误
-5 数据错误<NUM>，提供的数据不完整或者不符合要求
-6 没有MD5签名数据
-7 MD5签名校验失败，请注意密钥的统一！
-8 未获授权
-9 数据库错误，GInfo平台问题
-10 <KIND>数据错误
-11 <DATE>数据错误
-12 <PID>数据错误
-13 <TRACKINFO>数据错误
-14 <EXTRA>数据错误,<KIND>为2或3
-15 <NEXTSTATION>数据错误，<KIND>为1
-16 <DATE>数据不合法，检查格式是否正确：YYYY.MM.DD hh:mm:ss
-17 <WEIGHT> 复重重量错，无有效重量
-106 运单号重复，复重预录单->业务录单检查

*袋号扫描返回格式为：成功数/袋中快件数[回车换行]袋号[回车换行]错误记录的运单号及错误代码(一行一个)
*错误代码：-2:记录不存在或不在本站点；-3:已送达

二、客户资料查询
1.接口:EmsTrans
2.操作:K
3.数据样式:
<OP>K</OP>
<PID>GG12345</PID>必须，查询该PID用户对应的所属站点的客户
<DATE>YYYY.MM.DD HH:MM:SS</DATE>如果提供，查询该时点之后添加或更新过的客户档案
<MD5>ac003b5fac003b5fac003b5fac003b5f</MD5>
4.返回数据：>=0,成功,记录数量,后接用户所属站点客户列表(XML)
5.开关配置：ems.ini中，在“#参数定义”里加上配置：“PDA查询客户列表=1”

三、授权配置
配置：
1.GInfo.dll -> ems.ini中，配置项目形如 “EMS_SCAN_VALIDATE=X1X747D6A7E6B657B4A7B343335343F34337B4A7BB6160400”
2.EMMis -> emmis数据库中执行形如 “cp_sys_dict_single_set 'PDA_EXTAPI','X1X747D6A7E6B657B4A7B343335343F34337B4A7BB6160400'”