2.1 门店数据导入

2.1.1 说明

请求方式:通过POST方式进行接口请求,以JSON格式返回结果。

接口名称:v1/import_store.php

简要描述:用于企业ERP/WMS导入门店信息数据到物流云平台,导入成功后,可通过“物流云平台 -> 门店管理”进行管理。门店编码存在时则覆盖,否则新增。传参位置坐标值为空、联系人/联系电话为空或不合法的门店在“物流云平台 -> 门店管理 -> 信息缺失门店”中管理。

☆ 地理编码:如果未传参“位置坐标值”时,自动根据“详细地址”解析出位置坐标值(可能存在误差),可通过“物流云平台 -> 门店管理 -> 信息缺失门店”中进行核实纠偏。此功能前提是门店编码不存在于门店库、或存在于门店库但位置坐标值未核实;否则位置坐标值不被覆盖更新。

☆ 拣出有效信息:如果联系人/联系电话格式不合法时,自动分拣出姓名/电话填充联系人/联系电话,可通过“物流云平台 -> 门店管理 -> 信息缺失门店”中进行核实纠正。

错误编码:0,1001,1002,1003,1004,1005,1900,2000

2.1.2 请求参数

参数名称格式描述参与签名必填
storecode String 门店编码(作为对接门店的唯一标识) Y Y
storename String 门店名称 Y Y
storeaddr String 详细地址 Y Y
linkman String 联系人 Y N
linkphone String 联系电话(标准电话或手机号码,电话号码可带区号/分机或不带,手机号码为11位;多个间以半角逗号“,”分隔,最多三个) Y N
org_name String 所属机构(与“物流云平台 -> 组织管理”中名称一致;默认为此公司的根节点组织机构) Y N
ctype Integer

位置坐标类型

1 为凯立德K码

2 为凯立德xy坐标

3 为GPS坐标

4 为国测局坐标

5 为百度坐标

Y N
coords String

位置坐标值

凯立德xy坐标格式:x,y

凯立德K码格式:9位字符

GPS坐标/国测局坐标/百度坐标格式:longitude,latitude

Y N
storemark String 门店的特殊送货说明 Y N
supervisor String 督导姓名 Y N
superphone String 督导电话 Y N
custcode String 所属客户编码(与“物流云平台 -> 客户管理”中客户编码一致) Y N
公共输入参数 详见公共请求参数

2.1.3 返回结果

参数名称格式描述
errcode Integer 错误编码(详见错误编码
errmsg String 错误提示

2.2 固定路由数据导入

2.2.1 说明

请求方式:通过POST方式进行接口请求,以JSON格式返回结果。

接口名称:v1/import_linedata.php

简要描述:用于企业外部系统导入已生成的固定路由到物流云平台,导入成功后,可通过“物流云平台 -> 固定路由”进行管理。路由编号存在时则覆盖,否则新增。请求参数linepoints为路由点集合(数量有限制,以实际配置为准),前提是路由点必须存在于门店/配送中心/客户关系网库中,JSON数组成员的先后顺序即路由点顺序。

错误编码:0,1001,1002,1003,1004,1005,1900,2000

2.2.2 请求参数

参数名称格式描述参与签名必填
lineno String 路由编号(作为对接固定路由的唯一标识) Y Y
linename String 路由名称 Y Y
linepoints ptype Json
(Array)
Integer 路由点类型(1为门店、2为配送中心、3为客户关系网 ) Y Y
pcode String 路由点编码(门店编码 / 配送中心编码 / 客户关系编码) Y Y
公共输入参数 详见公共请求参数

2.1.3 返回结果

参数名称格式描述
errcode Integer 错误编码(详见错误编码
errmsg String 错误提示
 
版权所有 ©马蹄圈,并保留所有权利。
粤ICP备16121480号