附录

错误代码表

异常代码>>>

E001:读取报文异常,异常信息!
E003:保存订单运单信息记录异常
E004:处理九曳业务数据出现异常,请联系管理员~
E005:处理总订单数和实际订单不一致出现错误,请联系管理员~
200:服务器返回成功
验证非法代码>>>
S001:请求的平台编码:"+platformPid+"没有授权
S002:元素orderCount不能为空,并且大于0
S003:请求的订单orderCount最大为50
S004:请求的orderList个数N,和orderCount:M不相等
S005:付款方式有误,支持的付款方式为:[1-在线支付,2-现金支付,3-POS刷卡]
S006:订单号:XXX,商家编码【XXX】没有在九曳系统中配置或者配置已作废,请联系九曳IT重新配置
S007:订单号:XXX,商家编码【XXX】,对应OMS商家ID【XXX】没有在九曳系统中配置月结帐号,请联系九曳IT配置月结帐号
S009:订单号:XXX,商家编码【XXX】,没有在九曳系统中配置项目ID,请联系九曳IT配置项目ID
S0010:订单号:XXX,商家编码【XXX】没有在九曳系统中商家信息未配置或者配置已作废,请联系九曳IT重新配置
S0011:订单号:XXX,地址:【XXX】不在九曳覆盖区域,若有异议,请联系九曳IT

处理单个订单非空代码>>>

N003:元素Head内容不能为空
N004:请求的平台编码(platformPid)不能为空
N005:元素Body内容不能为空
N006:元素orderList不能为空
N007:元素Order不能为空
N008:元素orderid不能为空
N009:元素sender不能为空
N0010:元素senderContact不能为空
N0011:寄件方手机号码或电话号码至少有一项有数据!
N0012:元素receiver不能为空
N0013:元素receiverContact不能为空
N0014:收件方手机号码或电话号码至少有一项有数据!
N0015:元素receiverProvince不能为空
N0016:元素receiverCity不能为空
N0017:元素receiverCountry不能为空
N0018:元素receiverAddress不能为空
N0019:元素expressType不能为空
N0020:元素status不能为空
N0021:元素status值错误(-1删除,2为更新或删除)
N0022:元素parcelQuantity不能为空必须大于0
N0023:元素cargoTotalWeight不能为空必须大于0
N0025:元素cargoList不能为空,且商品个数最少为一个
N0026:商品元素name不能为空
N0027:元素count不能为空必须大于0
N0028:请求参数对象WaybillRequest为空,请联系管理员!
N0031:waybillNoFlag为true时候元素waybillNo不能为空
N0032:元素senderProvince不能为空
N0033:元素senderCity不能为空
N0034:元素senderCountry不能为空
N0035:元素senderAddress不能为空

200:操作失败,订单已经撤单,无法再次操作
200:操作失败,订单已经揽收,无法更新或删除
200:服务器返回成功

sign签名算法

签名示例

https://apix.jiuyescm.com/v1/oms/receive?customerid=20001& timestamp=20170101120000&key=abc&method=expressnum&sign=123

输入参数为

customerid =20001
sign_method=md5
timestamp=20170101120000
key=abc
method = expressnum

按首字母升序排列

customerid =20001
key = abc
method = expressnum
sign_method=md5
timestamp =20170101120000

连接字符串

连接参数名与参数值,并在首尾加上secret,此处假设secret=test,如下: testcustomerid20001keyabcmethodexpressnumsign_methodmd5timestamp20170101120000bodytest

其中:body用请求中的body数据代替

生成签名

32位大写MD5值-> B8F7179FCB1B93DD2FF504AD443FD0D2