Appearance
3. 基础数据
3.1 科力普分公司
用途
科力普31家分子公司都有可能向同一供应商采购，接口提供科力普分公司数据为后面对账开票用（不同结算主体的采购订单 不允许统一申请开票）。
请求类型与路径
GET /api/v1/basic/getAllBranch
请求参数
| 名称 | 方式 | 类型 | 长度 | 必须 | 描述 |
|---|---|---|---|---|---|
| - | - | - | - | - | - |
响应参数
| 名称 | 类型 | 长度 | 必须 | 描述 |
|---|---|---|---|---|
| branchId | int | 4 | 是 | 分公司Id |
| branchName | string | 50 | 是 | 分公司名称 |
| invoiceType | string | 1 | 否 | 发票类型（2：增票、3：电子增票） |
| invoiceTitle | string | 100 | 否 | 开票抬头 |
| taxNum | string | 100 | 否 | 增值税号 |
| bankName | string | 100 | 否 | 开户行 |
| bankNum | string | 100 | 否 | 银行卡号 |
| invoiceAddress | string | 200 | 否 | 发票地址 |
| invoicePhone | string | 50 | 否 | 发票电话 |
示例：
json
[
{"branchId":1,"branchName":"上海科力普分公司",xxxxx:xxxx},
{"branchId":2,"branchName":"北京科力普分公司",xxxxx:xxxx},
......
]3.2 省市区
请求类型与路径
GET /api/v1/basic/getAllArea 查询全部省市区，注意是拉平的全部数据，注意本地缓存
请求参数
| 名称 | 方式 | 类型 | 长度 | 必须 | 描述 |
|---|---|---|---|---|---|
| - | - | - | - | - | - |
响应参数
| 名称 | 类型 | 长度 | 必须 | 描述 |
|---|---|---|---|---|
| provinceId | int | 4 | 是 | 省Id |
| provinceName | string | 50 | 是 | 省名称 |
| cityId | int | 4 | 是 | 市Id |
| cityName | string | 50 | 是 | 市名称 |
| districtId | int | 4 | 是 | 区Id |
| districtName | string | 50 | 是 | 区名称 |
示例：
json
[
{"provinceId":1,"provinceName":"北京",xxxxx:xxxx},
{"provinceId":2,"provinceName":"上海",xxxxx:xxxx},
......
]3.3 承运商
请求类型与路径
GET /api/v1/basic/getAllExpress 查询全部承运商
请求参数
| 名称 | 方式 | 类型 | 长度 | 必须 | 描述 |
|---|---|---|---|---|---|
| - | - | - | - | - | - |
响应参数
| 名称 | 类型 | 长度 | 必须 | 描述 |
|---|---|---|---|---|
| expressId | int | 4 | 是 | 承运商编号（快递编号） |
| expressCode | string | 100 | 是 | 承运商编码（快递编码） |
| expressName | string | 100 | 是 | 承运商名称（快递名称） |
示例：
json
[
{"expressId":1,"expressCode":"EMS",xxxxx:xxxx},
{"expressId":2,"expressCode":"SF",xxxxx:xxxx},
......
]3.4 平台信息
请求类型与路径
GET /api/v1/basic/getAllPlatform 查询所有平台
请求参数
| 名称 | 方式 | 类型 | 长度 | 必须 | 描述 |
|---|---|---|---|---|---|
| - | - | - | - | - | - |
响应参数
| 名称 | 类型 | 长度 | 必须 | 描述 |
|---|---|---|---|---|
| platformId | int | 4 | 是 | 平台编号 |
| platformCode | string | 100 | 是 | 平台编码 |
| platformName | string | 100 | 是 | 平台名称 |
| status | string | 1 | 是 | 平台状态（A:有效、P:无效、X:删除） |
| statusDisplayNote | string | 100 | 是 | 平台状态描述 |
示例：
json
[
{"platformId":1,"platformCode":"BeiJingZhengCai",xxxxx:xxxx},
{"platformId":2,"platformCode":"ShangHaiZhengCai",xxxxx:xxxx},
......
]