星云税融API

API 文档
Base URL: https://shuiwu.xingyunv2.cn
接口文档
文档 / 发票认证 / 发票勾选

发票认证 - 发票勾选

进项认证、勾选、统计确认

发票勾选

进项发票勾选

发票勾选

发票抵扣勾选。对采集到的进项发票进行勾选操作，勾选后可用于进项税额抵扣。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/deduct/select

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.gxlx String 是 勾选类型：1=抵扣勾选/2=退税勾选/3=代办退税勾选
data.fpList Array 是 待勾选发票列表
data.fpList[].fphm String 是 发票号码
data.fpList[].fpdm String 否 发票代码
data.fpList[].kprq String 是 开票日期
data.fpList[].je Number 是 金额
data.fpList[].se Number 是 税额
data.fpList[].gxbz String 是 勾选标志：1=勾选/0=取消勾选

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "gxlx": "1",
        "fpList": [
            {
                "fphm": "23312000000043000001",
                "kprq": "2026-01-15",
                "je": 10000,
                "se": 1300,
                "gxbz": "1"
            }
        ]
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.taskId String 任务ID

响应示例

JSON 
{
    "reqId": "auth007",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "831928300933251"
    }
}

发票勾选结果查询

发票勾选结果查询。查询勾选操作的执行状态及每张发票的勾选结果。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/deduct/result

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.taskId String 是 任务ID

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "taskId": "831928300933251"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.status Integer 0=初始化/1=执行中/2=失败/3=成功
data.resultList Array 每张发票的勾选结果
data.resultList[].fphm String 发票号码
data.resultList[].success Boolean 勾选是否成功

响应示例

JSON 
{
    "reqId": "auth008",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "831928300933251",
        "status": 3,
        "resultList": [
            {
                "fphm": "23312000000043000001",
                "success": true
            }
        ]
    }
}

海关缴款书勾选

海关缴款书勾选

海关缴款书勾选。对采集到的海关缴款书进行勾选操作。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/customs/select

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.jksList Array 是 待勾选缴款书列表
data.jksList[].jksbh String 是 缴款书编号
data.jksList[].gxbz String 是 勾选标志：1=勾选/0=取消

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "jksList": [
            {
                "jksbh": "202603XXXXXXXX",
                "gxbz": "1"
            }
        ]
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.taskId String 任务ID

响应示例

JSON 
{
    "reqId": "auth009",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "831928300933252"
    }
}

海关缴款书勾选结果

海关缴款书勾选结果查询。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/customs/select/result

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.taskId String 是 任务ID

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "taskId": "831928300933252"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.status Integer 任务状态
data.resultList Array 勾选结果

响应示例

JSON 
{
    "reqId": "auth028",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "831928300933252",
        "status": 3
    }
}

农产品发票处理

待处理农产品发票

申请农产品发票处理。对待处理的农产品发票执行确认操作。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/farm/invoice

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.fpList Array 是 发票列表

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "fpList": [
            {
                "fphm": "23312000000043000005"
            }
        ]
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.taskId String 任务ID

响应示例

JSON 
{
    "reqId": "auth022",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "831928300933259"
    }
}

农产品发票处理结果

农产品发票处理结果查询。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/farm/invoice/result

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.taskId String 是 任务ID

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "taskId": "831928300933259"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.status Integer 任务状态

响应示例

JSON 
{
    "reqId": "auth023",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "831928300933259",
        "status": 3
    }
}

海关缴款书录入

申请海关缴款书录入

申请海关缴款书录入。将海关缴款书信息录入税局系统。异步接口。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/customs/entry

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.jksList Array 是 缴款书信息列表
data.jksList[].jksbh String 是 缴款书编号
data.jksList[].skrq String 是 实缴日期
data.jksList[].se Number 是 税额

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "jksList": [
            {
                "jksbh": "202603XXXXXXXX",
                "skrq": "2026-03-15",
                "se": 8500
            }
        ]
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.taskId String 任务ID

响应示例

JSON 
{
    "reqId": "auth024",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "831928300933260"
    }
}

海关缴款书录入结果

海关缴款书录入结果查询。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/customs/entry/result

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.taskId String 是 任务ID

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "taskId": "831928300933260"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.status Integer 任务状态

响应示例

JSON 
{
    "reqId": "auth025",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "831928300933260",
        "status": 3
    }
}

已录入缴款书查询

已录入海关缴款书查询。查看已录入到税局的缴款书列表。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/customs/entered

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440"
}

响应参数

参数名 类型 说明
code String 2000=成功
data.taskId String 任务ID

响应示例

JSON 
{
    "reqId": "auth026",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "831928300933261"
    }
}

已录入缴款书查询结果

已录入缴款书查询任务结果。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/customs/entered/result

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.taskId String 是 任务ID

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "taskId": "831928300933261"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.status Integer 任务状态
data.list Array 缴款书列表

响应示例

JSON 
{
    "reqId": "auth027",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "831928300933261",
        "status": 3,
        "list": []
    }
}

代扣代缴凭证勾选

代扣代缴凭证勾选

代扣代缴凭证勾选。对采集到的代扣代缴凭证进行勾选。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/withhold/select

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.pzList Array 是 凭证列表
data.pzList[].pzbh String 是 凭证编号
data.pzList[].gxbz String 是 勾选标志：1=勾选/0=取消

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "pzList": [
            {
                "pzbh": "DKDJ202603001",
                "gxbz": "1"
            }
        ]
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.taskId String 任务ID

响应示例

JSON 
{
    "reqId": "auth029",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "831928300933262"
    }
}

代扣代缴凭证勾选结果

代扣代缴凭证勾选结果查询。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/withhold/select/result

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.taskId String 是 任务ID

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "taskId": "831928300933262"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.status Integer 任务状态

响应示例

JSON 
{
    "reqId": "auth030",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "831928300933262",
        "status": 3
    }
}

农产品加计扣除勾选

农产品加计扣除勾选

农产品加计扣除勾选。对可加计扣除的农产品发票进行勾选。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/farm/add-select

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.fpList Array 是 发票列表
data.fpList[].fphm String 是 发票号码
data.fpList[].gxbz String 是 勾选标志

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "fpList": [
            {
                "fphm": "23312000000043000005",
                "gxbz": "1"
            }
        ]
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.taskId String 任务ID

响应示例

JSON 
{
    "reqId": "auth031",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "831928300933263"
    }
}

农产品加计扣除勾选结果

农产品加计扣除勾选结果查询。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/farm/add-select/result

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.taskId String 是 任务ID

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "taskId": "831928300933263"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.status Integer 任务状态

响应示例

JSON 
{
    "reqId": "auth032",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "831928300933263",
        "status": 3
    }
}

注销勾选

注销勾选

申请注销勾选/撤销注销勾选

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/cancel/select

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
sqlx String 是 申请类型：1=注销勾选，2=撤销注销勾选
accountId String 否 登录账户唯一标识，多账号时必传
customReqId String 否 用户标识ID，需保证唯一性
sync Boolean 否 是否同步获取结果，默认false

请求示例

JSON 
{
    "nsrsbh": "91***************3N",
    "sqlx": "1"
}

响应参数

参数名 类型 说明
code String 错误码，2000=成功
success Boolean 是否成功
message String 错误信息
reqId String 请求ID
data String|Object 异步模式返回申请ID；同步模式返回注销勾选结果对象
data.nsrsbh String 纳税人识别号（同步模式）
data.skssq String 税款所属期（同步模式）
data.cljg String 处理结果：1=成功，2=无此税号，3=已申请(注销/撤销注销勾选)，4=已注销/撤销注销勾选，99=其他异常
data.zt Integer 任务状态：1=进行中，2=失败，3=成功
data.zxgxlx String 注销勾选类型：1=注销勾选，2=撤销注销勾选
data.code String 任务失败错误码
data.message String 任务失败错误信息
data.action String 同步超时转异步时返回操作类型：zxgx
data.taskId String 同步超时转异步时返回的任务ID

响应示例

JSON 
{
    "reqId": "1accd95fefc343319163afcc2bb5879c",
    "code": "2000",
    "success": true,
    "message": null,
    "data": 475132666845504
}

注销勾选结果查询

查询注销勾选/撤销注销勾选申请结果

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/cancel/select/result

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
reqId String 是 申请注销勾选/撤销注销勾选接口返回的id
customReqId String 否 用户标识ID，需保证唯一性

请求示例

JSON 
{
    "nsrsbh": "91***************3N",
    "reqId": 477604473489600
}

响应参数

参数名 类型 说明
code String 错误码，2000=成功
success Boolean 是否成功
message String 错误信息
reqId String 请求ID
data.nsrsbh String 纳税人识别号
data.skssq String 税款所属期，格式：yyyyMM
data.cljg String 处理结果：1=成功，2=无此税号，3=已申请(注销/撤销注销勾选)，4=已注销/撤销注销勾选，99=其他异常
data.zt Integer 任务状态：1=进行中，2=失败，3=成功
data.zxgxlx String 注销勾选类型：1=注销勾选，2=撤销注销勾选
data.code String 任务失败错误码
data.message String 任务失败错误信息

响应示例

JSON 
{
    "reqId": "1accd95fefc343319163afcc2bb5879c",
    "code": "2000",
    "success": true,
    "message": null,
    "data": {
        "nsrsbh": "91****************3N",
        "skssq": "202307",
        "cljg": "1",
        "zt": 1,
        "zxgxlx": "1"
    }
}

© 2026 星云税融API. All rights reserved.

如需接入支持，请联系技术团队 | 注册账号