信丰物流无线手持终端接口方案概述本方案用于信丰物流快递管理系统接口,主要完成以下功能:1、用户登陆2、接单通知3、接单扫描。4、派件扫描。5、地区信息查询6、车线扫描(到/发件扫描)2011-2-21增加数据库:类型:oracle10g接口定义用户登录接口方式:存储过程过程名:bas_UserLogin调用方:BAS功能用户登陆验证密码参数名类型方向说明UserNoVarchar(10)工号PasswordVarchar(20)密码RetCodeIntoutput返回错误代码:0成功,-1未知错误,其他错误-101密码不存在,-102用户不存在,-103用户状态不对,ErrMsgVarchar(200)Output返回错误时,可以附加错误信息UserNameVarchar(20)Output用户姓名UserDepartmentVarchar(200)Output用户所属部门名UserDepartmentIdVarchar(20)output用户所属部门idUserAreaIdVarchar(20)output用户地区ID收件扫描接口方式:存储过程过程名:bas_OrderScan调用方:BAS功能业务员接单后进行扫描参数名类型方向说明UserNoVarchar(20)用户工号OrderIdVarchar(20)订单号码(无订单为空)ScanTimedatetime扫描时间BarcodeVarchar(20)订单条码CountDInt件数SubCodeVarchar(4000)子件号码,多件用|分割BackCodeVarchar(20)代签货单号DstAreaCodeVarchar(20)目的点号码WeightNumber(10,2)重量(KG)PriceNumber(10,2)到付(元)GoodPayNumber(10,2)代收货款RetCodeIntoutput返回错误代码:0成功,-1未知错误,其他错误ErrMsgVarchar(200)Output返回错误时,可以附加错误信息派送扫描接口方式:存储过程过程名:bas_ArrivalScan调用方:BAS功能业务员送达后扫描参数名类型方向说明UserNoVarchar(20)用户工号ResultCodeint结果码(代码暂时未定)派送成功、用户拒收、改期、用户拒付、目的地不可达……ScanTimedatetime扫描时间BarcodeVarchar(20)订单条码CountDInt件数SignerVarcar(20)签收人SubCodeVarchar(200)子件号码,多件用|分割BackCodeVarchar(4000)代签货单WeightNumber(10,2)重量PriceNumber(10,2)到付GoodPayNumber(10,2)代收货款RetCodeIntoutput返回错误代码:0成功,-1未知错误,其他错误ErrMsgVarchar(200)Output返回错误时,可以附加错误信息取业务员工信息接口方式:存储过程过程名:bas_GetUserInfo调用方:BAS功能业务员用户与密码结果集参数名类型方向说明SiteNoVarchar(20)网点编号RetCodeIntoutput返回错误代码:0成功,-1未知错误,其他错误ErrMsgVarchar(200)Output返回错误时,可以附加错误信息RetcurCursorOutput游标(NUMID,NAMES,GPRSPWD)接口方式:存储过程过程名:bas_GetUserInfoBydate调用方:BAS功能业务员用户与密码结果集参数名类型方向说明BegintimeDatetime更新起始时间(yyyy-mm-ddhh24:mi:ss)SiteNoVarchar(20)网点编号RetCodeIntoutput返回错误代码:0成功,-1未知错误,其他错误ErrMsgVarchar(200)Output返回错误时,可以附加错误信息RetcurCursorOutput游标(NUMID,NAMES,GPRSPWD)取省份信息接口方式:存储过程过程名:bas_GetProvInfo调用方:BAS功能省份信息结果集参数名类型方向说明RetCodeIntoutput返回错误代码:0成功,-1未知错误,其他错误ErrMsgVarchar(200)Output返回错误时,可以附加错误信息RetcurCursorOutput游标(provinceid,province,jp,py)接口方式:存储过程过程名:bas_GetProvInfoByDate调用方:BAS功能按更新时间取省份信息结果集参数名类型方向说明begintimeDatetime更新起始时间(yyyy-mm-ddhh24:mi:ss)RetCodeIntoutput返回错误代码:0成功,-1未知错误,其他错误ErrMsgVarchar(200)Output返回错误时,可以附加错误信息RetcurCursorOutput游标(provinceid,province,jp,py)取市信息接口方式:存储过程过程名:bas_GetCityInfo调用方:BAS功能市信息结果集参数名类型方向说明RetCodeIntoutput返回错误代码:0成功,-1未知错误,其他错误ErrMsgVarchar(200)Output返回错误时,可以附加错误信息RetcurCursorOutput游标(cityid,city,jp,py)接口方式:存储过程过程名:bas_GetCityInfoBydate调用方:BAS功能按更新时间取市信息结果集参数名类型方向说明begintimedatetime更新起始时间(yyyy-mm-ddhh24:mi:ss)RetCodeIntoutput返回错误代码:0成功,-1未知错误,其他错误ErrMsgVarchar(200)Output返回错误时,可以附加错误信息RetcurCursorOutput游标(cityid,city,jp,py)取目的区域信息接口方式:存储过程过程名:bas_GetDestInfo调用方:BAS功能(1)目地地详细结果集参数名类型方向说明RetCodeIntoutput返回错误代码:0成功,-1未知错误,其他错误ErrMsgVarchar(200)Output返回错误时,可以附加错误信息RetcurCursorOutput游标(areaid,cityid,areaname,reachstate,areainfo,city,lastdate,province,areacode)接口方式:存储过程过程名:bas_GetDestInfoBydate调用方:BAS功能(2)按更新时间取目地地详细结果集参数名类型方向说明Begintimedatetime更新起始时间(yyyy-mm-ddhh24:mi:ss)RetCodeIntoutput返回错误代码:0成功,-1未知错误,其他错误ErrMsgVarchar(200)Output返回错误时,可以附加错误信息RetcurCursorOutput游标(areaid,cityid,areaname,reachstate,areainfo,city,lastdate,province,areacode)接口方式:存储过程过程名:bas_GetDestInfoByPage调用方:BAS功能(3)按分页取目地地详细结果集(分多次取数,可以避免大数据量一次下载)参数名类型方向说明Begintimedatetime更新起始时间(yyyy-mm-ddhh24:mi:ss)PageSizeinteger每页大小,为0,则黪认为4行/页,否则返回实际行数/页PageNuminteger第N页,请求返回第几页TotPageintegerOutput总页数RetCodeIntoutput返回错误代码:0成功,-1未知错误,其他错误ErrMsgVarchar(200)Output返回错误时,可以附加错误信息RetcurCursorOutput游标(areaid,cityid,areaname,reachstate,areainfo,city,lastdate,province,areacode)注:Province省名City城市名,Cityid城市IDAreaid目的地IDAreacode目的地代码Areaname目的地名Reachstate到达状态Areainfo详细地区说明,Lastdate最后更新日期,取未签收原因接口方式:存储过程过程名:bas_GetReasonInfo调用方:BAS功能未签收原因集果集参数名类型方向说明RetCodeIntoutput返回错误代码:0成功,-1未知错误,其他错误ErrMsgVarchar(200)Output返回错误时,可以附加错误信息RetcurCursorOutput游标(Numid,Names)接口方式:存储过程过程名:bas_GetReasonInfoByDate调用方:BAS功能未签收原因集果集参数名类型方向说明begintimedatetime更新起始时间(yyyy-mm-ddhh24:mi:ss)RetCodeIntoutput返回错误代码:0成功,-1未知错误,其他错误ErrMsgVarchar(200)Output返回错误时,可以附加错误信息RetcurCursorOutput游标(Numid,NameS)在线运单查询接口方式:存储过程过程名:bas_GetOrdInfo调用方:BAS功能运单信息查询,返回参数参数名类型方向说明ScancodeVarchar(20)input运单号RetCodeIntoutput返回错误代码:0成功,-1未知错误,其他错误ErrMsgVarchar(200)Output返回错误时,可以附加错误信息RetCurCursorOutput游标(subcode,backcode,goodpay,weight,countd,dfMoney)/*subcode子单backcode代签货单,Goodpay代收货款,Weight重量countd件数dfMoney到付*/短信通知查询接口方式:存储过程过程名:bas_GetNoteInfo调用方:BAS功能揽件与通知信息查询,为了减小数据量,每次取数据时,返回最后一个已取到终端上的订单号,以此,来通知服务器,此单之前的单已下载到终端了.具体作以下操作:(1)将此订单号之前的所有未读状态,更新为已读状态(2)取未读的信息下去参数名类型方向说明LastOrderidVarchar(20)已查看的最后一个订单号根据这个,可以避免重复取数.UserIdVarchar(20)业务员编号RetCodeIntoutput返回错误代码:0成功,-1未知错误,其他错误ErrMsgVarchar(200)Output返回错误时,可以附加错误信息RetCurCursorOutput游标(orderid,address,tel,custname,picktime,remark,priority,noticetype,sender)到/发件扫描—上/下一产的站点结果集接口方式:存储过程过程名:BAS_GetSiteInfoBydate调用方:BAS功能参数名类型方向说明SiteIDVarchar(10)扫描用户所属站点begintimeDatetime更新起始时间(yyyy-mm-ddhh24:mi:ss)RetCodeIntoutput返回错误代码:0成功,-1未知错误,其他错误ErrMsgVarchar(200)Output返回错误时,可以附加错误信息RetCurCursorOutput游标(Numid:站点编号Names:站点名称)到/发件扫描接口方式:存储过程过程名:bas_NormScan调用方:BAS功能参数名类型方向说明vUserNoVarchar(20)扫描员编号vScantypeVarchar(10)扫描类别,到件扫描---03,发件扫描--02vSiteIDVarch