#-------------------------------#
# 通过GInfo 接口 运单导入规范  #
#-------------------------------#

一、接口
1.1 提交上传接口
1.1.1、接口名：RecPreInputUpload
1.1.2、参数：w(网站ID),iidnum(关联运单生成ID,如果没有则采用EMMis导入提取),cmark(标签),cemskind(快递类别，渠道),file(文件)
1.1.3、可以在以客户身份登入后调用：“/cgi-bin/RecPreInputUploadForm?w=网站ID”，参考表单样式

二、文件规范
2.1、文件必须为CSV格式
2.2、字段名称严格按照EMMis系统预导入中"导出标准(完整)Excel表头"的定义
2.3、多种物品
2.3.1、定义"物品描述"、"物品数量"、"物品单价"三个带同样分割符号的字段，前两个为必须
2.3.2、"物品数量"为基准字段，数量为整数，用一个半角符号隔开,"物品数量"数量的个数必须与"物品描述"种数一致
2.3.3、半角分割符号建议用",",其它无冲突的符号也可以,比如"|",以"物品数量"为基准
2.3.4、例子
       "手机,皮带,钱包","1,2,3","320.11,55.62,333.8",

三、配置Excel文件导入支持
3.1、拷贝libxl.dll到GInfo.dll同一目录，覆盖GInfo.dll（支持xls的版本，查看最末尾的版本号为1）
3.2、覆盖更新emmis程序目录中的服务器升级程序：EmsServerUpdate.exe
3.3、严格按照EMMis系统预导入中"导出标准(完整)Excel表头"的定义



RecPreInputUpload==iID_FieldsMap
*客户个性设置通用定义，共四个接口（客户登入后有效）
1、EmsClientDefineSet，表单模式：（增、改)
ON_PARSE_COMMAND(EmsClientDefineSet,CGInfoExtension,ITS_PSTR ITS_I4 ITS_I2 ITS_I2 ITS_PSTR ITS_PSTR ITS_I4 ITS_I4 ITS_I4)
ON_PARSE_COMMAND_PARAMS("w= iid=0 nver=0 ntype=0 cname= cdata= iex1=0 iex2=0 iex3=0")
iid=0(增),>0(改)
nver=0(版本)
ntype=0(预导入格式模板)，以后可能增加更多定义
cname:名称，1-30字节
cdata：定义数据,1-7000字节
iex1:整数扩展1
iex2:整数扩展2
iex3:整数扩展3

2、ajxClientDefineList，列表，JSON数据RecList
ON_PARSE_COMMAND(ajxClientDefineList,CGInfoExtension,ITS_PSTR ITS_I2 ITS_R8)
ON_PARSE_COMMAND_PARAMS("w= ntype=0 r=0.0")

3、ajxClientDefineData，记录完整数据，JSON格式,ReturnValue>=0成功(记录ID)
ON_PARSE_COMMAND(ajxClientDefineData,CGInfoExtension,ITS_PSTR ITS_I4 ITS_I2 ITS_R8)
ON_PARSE_COMMAND_PARAMS("w= iid=0 ntype=0 r=0.0")
*当iid=0时，返回默认定义数据，方便客户编辑

4、ajxClientDefineDel，记录删除，返回JSON,ReturnValue>0成功(记录ID)
ON_PARSE_COMMAND(ajxClientDefineDel,CGInfoExtension,ITS_PSTR ITS_I4 ITS_R8)
ON_PARSE_COMMAND_PARAMS("w= iid=0 r=0.0")