基础说明
注意：这里的地址即是下面完整地址里面的$url，此地址并不一定是完整的接口请求地址，完整的接口请求地址和接口参数的封装方式有关，请参考下面具体说明你
请求参数
1、 老版本接口，未作特殊字符串的兼容（比如'&'），文本格式，不推荐使用
完整的接口请求地址：$url
请求参数示例：
f=getArea&v={"sKey":"93e91dbace794219c7658ad125c49a12"}2、 兼容特殊字符串的标准入参，JSON格式，推荐使用
完整的接口请求地址：$url/home/index/erpIndex
请求参数示例：
{
"f":"getArea",
"v":{
"sKey":"93e91dbace794219c7658ad125c49a12"
}
}3、 包含时效性的加密请求参数，JSON格式，一般不用
完整的接口请求地址：$url/home/index/erp_sign
请求参数示例：
{
"sign":"42d726aef8162884e24e2a263e0cec06",
"method":"getSite",
"channelId":"10000",
"signType":"MD5",
"params":[
{
"guid":"19919",
"num":"70.000"
}
]
}常用系统参数说明
入参
|
参数名称 |
是否必须 |
参数类型 |
参数说明 |
|
f |
Y |
String |
具体的业务方法名称 |
|
v |
Y |
String |
业务方法的请求参数 |
v参数
|
参数名称 |
是否必须 |
参数类型 |
参数说明 |
|
sKey |
Y |
String |
请求接口所需的密钥 |
|
body |
N |
Object |
批量操作的数据 |
返参
|
参数名称 |
类型 |
描述 |
|
rStatus |
Int |
100：正常，其他：异常 |
|
message |
String |
信息描述 |
|
rData |
Object |
具体的数据 |
|
rTotal |
Int |
列表查询时返回的总数 |
常用状态码
{
"success":{
"100":"success",
"101":"trouble"
},
"error":{
"200":"请求方式必须为POST",
"201":"SN账号与密码不匹配",
"202":"sKey与公司id不匹配",
"203":"sKey不存在",
"204":"支持自定义错误提示信息",
"205":"未知错误",
"206":"客户信息未与ERP同步",
"207":"数据签名不正确",
"208":"该公司尚未开通接口对接或者系统已到期，请联系接口提供商",
"209":"非法的请求参数格式",
"210":"请求业务方法不存在",
"211":"数据库连接异常！",
"212":"指定联营商无效，或者联营商已经被停用",
"213":"该公司系统已到期，请联系接口提供商"
},
"notice":{
"300":"对不起，该ERP接口已停用或者关闭，请联系接口提供商",
"301":"接口已停用，如需启用，请联系接口提供商",
"302":"此次申请数量+已用数量，超过最高设置",
"303":"单次请求数量不能超过1000",
"304":"当前账号信息对应的skey不存在"
},
"business":{
"400":"外码集合不能为空",
"401":"删除外码时，类型不能为空",
"402":""
},
"system":{
"500":"系统异常"
}
}重点说明
1. 红色表示重点关注项
2. 绿色代表最新更新或者新增项
3. 批量获取接口上限1000
4. 批量操作接口上限100
5. 所有接口请求方式均为POST
6. 数字精度依据系统配置来做截取，当前最多支持小数点后4位
7. 当错误码为203或判定token有效期到期时，请重新获取token
测试环境权限
地址：http://pc.newdhb.com/（注意此地址是登录订货宝测试环境的地址，不是接口请求地址，接口请求地址请见文档最顶部）
标准版本：
账号：erp
密码：dhb168
ERP对接序列号：65AC68AB-DC19-2D9A-4FF2-82DA442C5A41
ERP对接密码：340309
联营版本：
账号：18608004721
密码：123456
ERP对接序列号：F4FE315D-379C-10BE-1010-3B6244094F5C
ERP对接密码：517096
备注：由于测试环境使用人数众多，数据量巨大，且只应该作为正式上线前的接口调试使用，故会存在不定期清理数据的可能，我们并不保证测试环境数据的完整性和准确性