4.16 批量创建税局入账申请任务

快速开始环境

https://cosmic-sandbox.piaozone.com/jdpjykjyxgs

POST

/kapi/app/rim/deduction

直连税局进行税局发票入账及入账状态更新。
本接口为异步接口，需要根据响应返回的“任务号”调用“查询税局入账申请任务结果”接口获取结果。

请求参数

Query 参数

access_token

string

鉴权token

可选

Header 参数

access_token

string

可选

默认值:

Body 参数application/json

businessSystemCode

string

对接业务系统来源编码

必需

对接业务系统来源编码，用于区分不同业务系统的回调接口

interfaceCode

string

接口编码

必需

接口编码，固定值：invoiceRecorded

requestId

string

请求id

可选

当前13位毫秒级时间戳加3位随机数字(总共16位)

data

object

请求参数

必需

需要把data的值加密成字符串，默认为base64

taxNo

string

企业税号

必需

nextEntryMarkStatus

enum<string>

需要更改的入账状态

必需

需要更改的入账状态

枚举值:

020306

invoices

array [object {5}]

发票数组

必需

发票数组，最大允许500条

示例

{
    "businessSystemCode": "string",
    "interfaceCode": "string",
    "requestId": "string",
    "data": {
        "taxNo": "string",
        "nextEntryMarkStatus": "string",
        "invoices": [
            {
                "serilNo": "string",
                "invoiceNo": "string",
                "invoiceCode": "string",
                "recordedTime": "string",
                "recordedPeriod": "string"
            }
        ]
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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": "string",
    "requestId": "string",
    "data": {
        "taxNo": "string",
        "nextEntryMarkStatus": "string",
        "invoices": [
            {
                "serilNo": "string",
                "invoiceNo": "string",
                "invoiceCode": "string",
                "recordedTime": "string",
                "recordedPeriod": "string"
            }
        ]
    }
}'

返回响应

🟢200成功

application/json

Body

errorCode

string

响应码

必需

响应码，0000-成功

message

string

响应描述

必需

响应描述

success

boolean

请求是否成功

必需

请求是否成功

data

object

返回内容data

可选

errorCode为成功时，data存在数据；需要解密，默认为base64

taskNo

string

任务号

可选

任务号

示例

{
    "errorCode": "string",
    "message": "string",
    "success": true,
    "data": {
        "taskNo": "string"
    }
}

修改于 2025-06-15 09:12:37

4.15 预勾选确认结果查询

4.17 查询税局入账申请任务结果