中税开票接口文档

> 泊链电子发票相关文档，仅限内部使用，包含接口文档，业务流程、系统交互相关说明

## 支付云-管理员-新增/修改车场开票

### 页面路径
云平台->支付云->车场管理->设置按钮->选择“中税”->点击“审核状态”列内的按钮（“未提交”、“”、“”）

### 请求类型
POST

### 请求地址
web/park/addinvoice

### 请求参数
至少保证“停车开票设置”和“充电开票设置”有一组是完整的

| 字段 | 类型 | 必填项 | 说明 |
| --- | --- | --- | --- |
|plat_type  |int  |必填  |固定为8，表示中税开票  |
|comid  |int  |必填  |车场主键id  |
|store_no  |string  |必填  |中税商户号  |
|taxpayer_name  |string  |必填  |企业名称  |
|taxpayer_num  |string  |必填  |社会信用代码  |
|region_code  |string  |必填  |省编码  |
|city_code  |string  |必填  |市编码  |
|area_code  |string  |必填  |区/县编码  |
|address  |string  |必填  |详细地址（不含省市区）  |
|product_type  |string  | 必填 |开票产品类型，ZS-SP-UKEY:税盘托管（含税务UKEY），ZS-QKL-SZ:区块链（深圳），ZS-QD:全电票 |
|invoice_type_code  |string  |必填  |可开票种，10:增值税发票，9:区块链发票，82:全电电子普票 |
|start_time  |string  |必填  |商户有效期开始时间，格式：yyyyMMdd  |
|end_time  |string  |必填  |商户有效期结束时间，格式：yyyyMMdd  |
|drawer  |string  |非必填  |开票人  |
|payeer  |string  | 非必填 |复核人  |
|reviewer  |string  |非必填  |收款人  |
|good_name  |string  |条件必填  |停车开票设置-停车发票商品名称，停车开票必填  |
|tax_code  |string  |条件必填  |停车开票设置-停车费税目编码，停车开票必填  |
|tax_rate  |int  |条件必填  |停车费税率（%），停车开票必填  |
|models  |string  |条件必填  |停车开票设置-停车发票规格型号，停车开票必填  |
|unit  |string |条件必填  |停车开票设置-停车发票单位，停车开票必填  |
|preferential_policy_flag  |int  |条件必填  |停车开票设置-是否使用优惠政策，停车开票必填，1:是, 0:否   |
|ele_good_name  |string  |条件必填  |充电开票设置-充电发票商品名称，充电开票必填  |
|ele_tax_code  |string  |条件必填  |充电开票设置-充电费税目编码，充电开票必填  |
|ele_tax_rate  |int  |条件必填  |充电开票设置-充电费税率（%），充电开票必填  |
|ele_models  |string  |条件必填  |充电开票设置-充电发票规格型号，充电开票必填  |
|ele_unit  |string  |条件必填  |充电开票设置-充电发票单位，充电开票必填  |
|ele_preferential_policy_flag  |int  |条件必填  |充电开票设置-是否使用优惠政策，充电开票必填，1:是, 0:否  |

### 响应参数

| 字段 | 类型 | 说明 |
| --- | --- | --- |
|state  |int  |业务执行状态，1:成功 0:失败  |
|msg  |string  |业务执行说明  |

## 支付云-管理员-查询车场开票详情

### 页面路径
云平台->支付云->车场管理->设置按钮->选择“中税”->点击“审核状态”列内的按钮（“未提交”、“”、“”）

### 请求类型
POST

### 请求地址
web/park/queryinvoice

### 请求参数

| 字段 | 类型 | 必填项 | 说明 |
| --- | --- | --- | --- |
|parkid  |int  |必填  |车场主键id  |
|seller_type  |int  |非必填  |开票方类型  0-总后台  1-厂商  2-服务商  |

### 响应参数

| 字段 | 类型 | 说明 |
| --- | --- | --- |
|comid  |int  |车场主键id  |
|store_no  |string  |中税商户号  |
|taxpayer_name  |string  |企业名称  |
|taxpayer_num  |string  |社会信用代码  |
|region_code  |string  |省编码  |
|city_code  |string  |市编码  |
|area_code  |string  |区/县编码  |
|address  |string  |详细地址（不含省市区）  |
|product_type  |string  | 开票产品类型，ZS-SP-UKEY:税盘托管（含税务UKEY），ZS-QKL-SZ:区块链（深圳），ZS-QD:全电票 |
|invoice_type_code  |string  |可开票种，10:增值税发票，9:区块链发票，82:全电电子普票 |
|start_time  |string  |商户有效期开始时间，格式：yyyyMMdd  |
|end_time  |string  |商户有效期结束时间，格式：yyyyMMdd  |
|drawer  |string  |开票人  |
|payeer  |string  |复核人  |
|reviewer  |string  |收款人  |
|good_name  |string  |停车开票设置-停车发票商品名称，停车开票必填  |
|tax_code  |string  |停车开票设置-停车费税目编码，停车开票必填  |
|tax_rate  |int  |停车费税率（%），停车开票必填  |
|models  |string  |停车开票设置-停车发票规格型号，停车开票必填  |
|unit  |string |停车开票设置-停车发票单位，停车开票必填  |
|preferential_policy_flag  |int  |停车开票设置-是否使用优惠政策，停车开票必填，1:是, 0:否   |
|ele_good_name  |string  |充电开票设置-充电发票商品名称，充电开票必填  |
|ele_tax_code  |string  |充电开票设置-充电费税目编码，充电开票必填  |
|ele_tax_rate  |int  |充电开票设置-充电费税率（%），充电开票必填  |
|ele_models  |string  |充电开票设置-充电发票规格型号，充电开票必填  |
|ele_unit  |string  |充电开票设置-充电发票单位，充电开票必填  |
|ele_preferential_policy_flag  |int  |充电开票设置-是否使用优惠政策，充电开票必填，1:是, 0:否  |

## 支付云-管理员-删除车场开票设置

### 页面路径
云平台->支付云->车场管理->设置按钮->选择“中税”->

### 请求类型
POST

### 请求地址
web/park/delinvoice

### 请求参数

| 字段 | 类型 | 必填项 | 说明 |
| --- | --- | --- | --- |
|comid  |int  |必填  |车场主键id  |

### 响应参数

删除成功/删除失败

## 支付云-车场后台-查询车场开票设置

### 页面路径
云平台->车场登录->支付云->车主发票->电子发票->开票设置

### 请求地址
web/orderInvoice/querySetInfo

### 请求类型
GET

### 请求参数

| 字段 | 类型 | 必填项 | 说明 |
| --- | --- | --- | --- |
|token  |string  |必填  |token  |

### 响应参数

| 字段 | 类型 | 说明 |
| --- | --- | --- |
|state  |int  |结果编码，1:成功，2:失败  |
|errmsg  |string  |结果说明  |
|data  |object  |发票设置详情  |
|supportInvoice  |int  |是否支持开票，0:否，1:是  |
|startTime  |string  |发票上线时间，格式：yyyyMMdd  |
|limitDay  |int  |历史补开天数  |
|invoiceSwitch  |int  |电子发票开关，0:关，1:开  |
|extra  |string  |电子发票备注  |
|goodName  |string  |停车发票商品名称  |
|taxCode  |string  |停车发票税目编码  |
|rate  |int  |停车发票税率（%）  |
|eleGoodName  |string  |充电发票商品名称  |
|eleTaxCode  |string  |充电发票税目编码  |
|eleTaxRate  |int  |充电发票税率（%）  |
|drawer  |string  |开票人  |
|reviewer  |string  |复核人  |
|payeer  |string  |收款人  |

## 支付云-车场后台-编辑车场开票设置

### 页面路径
云平台->车场登录->支付云->车主发票->电子发票->开票设置->“确定”按钮

### 请求地址
web/orderInvoice/editSetInfo

### 请求类型
POST

### 请求格式
application/x-www-form-urlencoded; charset=UTF-8

### 请求参数

| 字段 | 类型 | 必填项 | 说明 |
| --- | --- | --- | --- |
|token  |string  |必填  |token  |
|startTime  |string  |必填  |发票上线时间，格式：yyyyMMdd  |
|limitDay  |int  |非必填 |历史补开天数，默认0  |
|invoiceSwitch  |int  |非必填  |电子发票开关，0:关，1:开  |
|extra  |string  |非必填  |电子发票备注  |
|goodName  |string  |条件必填  |停车发票商品名称  |
|taxCode  |string  |条件必填  |停车发票税目编码  |
|rate  |int  |条件必填  |停车发票税率（%）  |
|eleGoodName  |string  |条件必填  |充电发票商品名称  |
|eleTaxCode  |string  |条件必填  |充电发票税目编码  |
|eleTaxRate  |int  |条件必填  |充电发票税率（%）  |
|drawer  |string  |非必填  |开票人  |
|reviewer  |string  |非必填  |复核人  |
|payeer  |string  |非必填  |收款人  |

### 响应参数

| 字段 | 类型 | 说明 |
| --- | --- | --- |
|state  |int  |结果编码，1:成功，2:失败  |
|errmsg  |string  |结果说明  |