企业相关
# 新增开票企业
新增一家用于开票的企业,并绑定给门店。
请求路径:
`/openapi/company/add`
请求方式:
`POST`
接口参数:
| 参数| 类型| 必填 | 说明|
| ------------| ------------| ------------ | ------------|
|registerActiveCode | String | 是 |激活码|
|companyName | String | 是 | 公司名称|
|companyTaxNo| String| 是| 公司税号|
|legalPerson| String| 是| 法人名称|
|taxpayerType| Integer| 是| 纳税人类别:0[小规模纳税人]、1[一般纳税人]|
|ordinaryLimit| String| 是| 普票限额,单位[分]|
|specializedLimit| String| 是| 专票限额,单位[分]|
|electronicsLimit| String| 是| 电子限额,单位[分]|
|companyAddress| String| 是| 公司地址|
|companyTelephone| String| 是| 公司电话|
|bankName| String| 否| 开户行名称|
|bankCardNumber| String| 否| 开户行账号| |contactsName| String| 是| 联系人姓名| |contactsPhone| String| 是| 联系人手机|
|contactsName| String| 是| 联系人姓名|
|contactsPhone| String| 是| 联系人手机号|
|contactsMail| String| 是| 联系人邮箱|
请求参数示例:
```json
{
"registerActiveCode":"T2J23B",
"companyTaxNo":"TEST12345678902",
"companyName":"瑞山食品店",
"legalPerson":"陈瑞山",
"taxpayerType":1,
"contactsName":"陈瑞生",
"contactsPhone":"122222222",
"contactsMail":"112312312@qq.com",
"ordinaryLimit":"9999.99",
"specializedLimit":"9999.99",
"electronicsLimit":"9999.99",
"companyAddress":"浙江省杭州市西湖区古翠路12号",
"companyTelephone":"13423124923",
"bankName":"杭州银行",
"bankCardNumber":"1203123123"
}
```
响应结果:
| 字段名 | 类型 | 说明 |
| ------------ | ------------ | ------------ |
| code | Integer | 处理结果 |
| message | String | 结果描述 |
| data | Long | 平台公司ID |
响应结果示例:
```json
失败:
{
"code": -1,
"message": "公司税号只能是大写字母和数字"
}
成功:
{
"code": 0,
"data": 10144
}
```
# 更新开票企业
更新开票企业信息,如变更企业公司名称、公司税号等
请求路径:
`/openapi/company/update`
请求方式:
`POST`
接口参数:
| 参数| 类型| 是否必填| 说明|
| ------------ | ------------ |------------ | ------------ |
|companyId| Long| 是| 平台公司ID|
|companyName| String| 否| 公司名称|
|companyTaxNo| String| 否| 公司税号|
|legalPerson| String| 否| 公司税号|
|taxpayerType| Integer| 否| 纳税人类别:0[小规模纳税人]、1[一般纳税人]|
|ordinaryLimit| String| 否| 普票限额,单位[分]|
|specializedLimit| String| 否| 专票限额,单位[分]|
|electronicsLimit| String| 否| 电子限额,单位[分]|
|companyAddress| String| 否| 公司地址|
|companyTelephone| String| 否| 公司电话|
|bankName| String| 否|开户行名称|
|bankCardNumber| String| 否| 开户行账号|
|contactsName| String| 否| 联系人姓名|
|contactsPhone| String| 否| 联系人手机|
|contactsMail| String| 否| 联系人邮箱|
请求参数示例:
```json
{
"companyId":"10144",
"companyTaxNo":"TEST12345678902",
"companyName":"瑞山食品店",
"legalPerson":"陈瑞山",
"taxpayerType":1,
"contactsName":"陈瑞生",
"contactsPhone":"122222222",
"contactsMail":"112312312@qq.com",
"ordinaryLimit":"9999.99",
"specializedLimit":"9999.99",
"electronicsLimit":"9999.99",
"companyAddress":"浙江省杭州市西湖区古翠路12号",
"companyTelephone":"13423124923",
"bankName":"杭州银行",
"bankCardNumber":"1203123123"
}
```
响应结果:
| 字段名 | 类型 | 说明 |
| ------------ | ------------ | ------------ |
| code | Integer | 处理结果 |
| message | String | 结果描述 |
| data | Object | 修改信息 |
响应结果示例:
```json
失败:
{
"errcode": -1,
"errmsg": "公司税号只能是大写字母和数字"
}
成功:
{
"errcode": 0,
"errmsg": "success",
"data": "修改成功"
}
```
# 查询开票企业
请求路径:
`/openapi/company/get`
请求方式:
`POST`
接口参数:
| 参数 | 类型 | 是否必填 | 说明 |
| ------------ | ------------ |------------ | ------------ |
| companyId | Long | 是 | 平台公司ID |
请求参数示例:
`/openapi/company/list?storeId=12312`
响应结果:
| 字段名 | 类型 | 说明 |
| ------------ | ------------ | ------------ |
| code | Integer | 处理结果 |
| message | String | 结果描述 |
| data | CompanyDTO | 公司信息 |
CompanyDTO
| 参数 | 类型 | 说明 |
| ------------ | ------------ | ------------ |
|companyId| Long| 平台公司ID|
|companyName| String| 公司名称|
|companyTaxNo| String| 公司税号|
|legalPerson| String| 公司税号|
|taxpayerType| Integer| 纳税人类别:0[小规模纳税人]、1[一般纳税人]|
|ordinaryLimit| String| 普票限额,单位[分]|
|specializedLimit| String| 专票限额,单位[分]|
|electronicsLimit| String| 电子限额,单位[分]|
|companyAddress| String| 公司地址|
|companyTelephone| String| 公司电话|
|bankName| String| 开户行名称|
|bankCardNumber| String| 开户行账号|
|contactsName| String| 联系人姓名|
|contactsPhone| String| 联系人手机|
|contactsMail| String| 联系人邮箱|
响应结果示例:
```json
失败:
{
"code": -1,
"message": "找不到对应公司"
}
成功:
{
"code": 0,
"message": "success",
"data": {
"companyId":"10144",
"companyTaxNo":"TEST12345678902",
"companyName":"瑞山食品店",
"legalPerson":"陈瑞山",
"taxpayerType":1,
"contactsName":"陈瑞生",
"contactsPhone":"122222222",
"contactsMail":"112312312@qq.com",
"ordinaryLimit":"9999.99",
"specializedLimit":"9999.99",
"electronicsLimit":"9999.99",
"companyAddress":"浙江省杭州市西湖区古翠路12号",
"companyTelephone":"13423124923",
"bankName":"杭州银行",
"bankCardNumber":"1203123123"
}
}
```