- 整体介绍
- 快速开始
- 加解密
- 文件预览&文件上传&文件下载
- 发票数据结构
- 错误码
- 常见接口错误
- 场景指引
- 授权
- 开票
- 单据开票接口（税控+数电）
- 直接开票接口
- 数电开票
- 税控开票
- 2.2.01税控开票（直接开票，不支持拆分合并）
- 2.2.02税控发票快速红冲（仅支持全额红冲）
- 2.2.03税控发票作废
- 2.2.04税控红字信息表申请
- 2.2.05税控红字信息表下载
- 2.2.06税控发票库存查询
- 2.2.07税控开票设备查询
- 2.2.08税控发票打印发票打印（需安装套打打印组件， 仅适用于局域网内的HTTP调用方式）
- 2.2.09税控发票打印（仅适用于组件开票，托管无法使用）
- 2.2.10邮件短信重发（数电票和税控发票都支持）
- 2.2.11税控/数电机动车发票开具
- 2.2.12税控机动车发票作废
- 2.2.13税控/数电机动车发票红冲
- 2.2.14税控机动车发票打印
- 2.2.15机动车信息查询（数电专用）
- 发票查询接口
- 回调接口（支持除数电票直接开票接口外的开票回调）
- 开票风控接口
- 扫码开票接口（税控+数电）
- 信息查询接口
- 收票
- 全票池引入
- 收票报销
- 查询全票池的发票
- 税局下载发票和勾选认证
- 4.01 税局登录POST
- 4.02 进项发票表头归集POST
- 4.03 进项发票表头归集结果查询POST
- 4.04 获取税款所属期信息POST
- 4.05 发票勾选&撤销勾选POST
- 4.06 发票勾选结果查询POST
- 4.07 当前统计查询POST
- 4.08 生成&撤销统计表POST
- 4.09 生成&撤销统计表结果查询POST
- 4.10 确认统计表POST
- 4.11 确认统计表结果查询POST
- 4.12 变更税款所属期POST
- 4.13 发票预勾选POST
- 4.14 发票预勾选确认POST
- 4.15 预勾选确认结果查询POST
- 4.16 批量创建税局入账申请任务POST
- 4.17 查询税局入账申请任务结果POST
- 4.18 出口退税勾选统计查询POST
- 4.01 税局登录
- 识别查验
- 微服务接口
- 全球发票识别
- 发票签收
- 页面类
- 影像
- 档案
- 设置类
- 订单
- 数据模型
4.13 发票预勾选
快速开始环境
https://cosmic-sandbox.piaozone.com/jdpjykjyxgs
快速开始环境
https://cosmic-sandbox.piaozone.com/jdpjykjyxgs
POST
/kapi/app/rim/deduction
变更历史#
| 日期 | 变更描述 | 变更人 | 版本 |
|---|---|---|---|
| 2025/12/08 | 1、发票类型新增支持数电发票（机动车销售统一发票）、增值税代扣代缴完税凭证、数电发票（通行费发票）、增值税普通发票；2、抵扣用途枚举增加出口退税、旅客运输抵扣； | 黄潮鑫 | V1.01 |
请求参数
Query 参数
Header 参数
Body 参数application/json
示例
{
"businessSystemCode": "string",
"interfaceCode": "readySelect",
"requestId": "string",
"data": {
"authenticateFlag": 0,
"taxNo": "string",
"taxPeriod": "202501",
"invoices": [
{
"serialNo": "string",
"invoiceType": "1",
"invoiceCode": "string",
"invoiceNo": "string",
"invoiceDate": "2022-06-11",
"deductionPurpose": "1",
"notDeductibleType": "1"
}
]
}
}请求示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://cosmic-sandbox.piaozone.com/jdpjykjyxgs/kapi/app/rim/deduction?access_token=' \
--header 'access_token: {{access_token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
"businessSystemCode": "string",
"interfaceCode": "readySelect",
"requestId": "string",
"data": {
"authenticateFlag": 0,
"taxNo": "string",
"taxPeriod": "202501",
"invoices": [
{
"serialNo": "string",
"invoiceType": "1",
"invoiceCode": "string",
"invoiceNo": "string",
"invoiceDate": "2022-06-11",
"deductionPurpose": "1",
"notDeductibleType": "1"
}
]
}
}'返回响应
🟢200成功
application/json
Body
示例
{
"errorCode": "string",
"message": "string",
"success": true,
"data": {
"asyncFlag": "string",
"taskNo": "string",
"success": [
{
"invoiceCode": "string",
"invoiceNo": "string",
"invoiceDate": "string",
"invoiceType": "string",
"serialNo": "string",
"description": "string",
"selectResult": "1",
"notDeductibleType": "1"
}
],
"fail": [
{
"invoiceType": "string",
"invoiceCode": "string",
"invoiceNo": "string",
"invoiceDate": "string",
"serialNo": "string",
"description": "string",
"selectResult": "1"
}
]
}
}修改于 2025-12-11 06:38:37