星云税融API

API 文档
Base URL: https://shuiwu.xingyunv2.cn
接口文档
文档 / 发票入账

发票入账

发票/海关缴款书/代扣代缴入账

发票入账

发票入账操作。将已查验通过的发票标记为已入账状态，防止重复报销。支持批量操作。

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

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
accountId String 否 账号ID
data.fpList Array 是 发票列表
data.fpList[].fphm String 是 发票号码
data.fpList[].fpdm String 否 发票代码(税控票必填)
data.fpList[].kprq String 是 开票日期
data.fpList[].rzlx String 否 入账类型

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "fpList": [
            {
                "fphm": "23312000000043000001",
                "kprq": "2026-01-15"
            }
        ]
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.taskId String 任务ID
data.status Integer 0=初始化/1=执行中/2=失败/3=成功

响应示例

JSON 
{
    "reqId": "entry001",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "631928300933248",
        "status": 1
    }
}

发票入账信息查询

查询发票入账状态。通过发票号码查询该发票的入账状态信息。

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

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.fphm String 是 发票号码
data.fpdm String 否 发票代码(税控票必填)

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "fphm": "23312000000043000001"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.fphm String 发票号码
data.rzzt String 入账状态：0=未入账/1=已入账
data.rzrq String 入账日期

响应示例

JSON 
{
    "reqId": "entry002",
    "code": "2000",
    "success": true,
    "data": {
        "fphm": "23312000000043000001",
        "rzzt": "1",
        "rzrq": "2026-03-20"
    }
}

海关缴款书入账

海关缴款书入账操作。将海关进口增值税缴款书标记为已入账。

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

请求参数

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

请求示例

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

响应参数

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

响应示例

JSON 
{
    "reqId": "entry003",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "631928300933249"
    }
}

海关缴款书入账查询

查询海关缴款书入账状态。

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

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.jksbh String 是 缴款书编号

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "jksbh": "202603XXXXXXXX"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.jksbh String 缴款书编号
data.rzzt String 入账状态：0=未入账/1=已入账

响应示例

JSON 
{
    "reqId": "entry004",
    "code": "2000",
    "success": true,
    "data": {
        "jksbh": "202603XXXXXXXX",
        "rzzt": "1"
    }
}

代扣代缴入账

代扣代缴凭证入账操作。将代扣代缴完税凭证标记为已入账。

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

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.pzList Array 是 凭证列表
data.pzList[].pzbh String 是 凭证编号
data.pzList[].skrq String 是 实缴日期

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "pzList": [
            {
                "pzbh": "DKDJ202603001",
                "skrq": "2026-03-15"
            }
        ]
    }
}

响应参数

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

响应示例

JSON 
{
    "reqId": "entry005",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "631928300933250"
    }
}

代扣代缴入账查询

查询代扣代缴凭证入账状态。

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

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.pzbh String 是 凭证编号

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "pzbh": "DKDJ202603001"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.pzbh String 凭证编号
data.rzzt String 入账状态：0=未入账/1=已入账

响应示例

JSON 
{
    "reqId": "entry006",
    "code": "2000",
    "success": true,
    "data": {
        "pzbh": "DKDJ202603001",
        "rzzt": "1"
    }
}

异步请求结果查询(入账)

发票入账异步请求结果查询。通过taskId查询入账操作的执行状态。

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

请求参数

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

请求示例

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

响应参数

参数名 类型 说明
code String 2000=成功
data.taskId String 任务ID
data.status Integer 0=初始化/1=执行中/2=失败/3=成功
data.resultList Array 入账结果明细

响应示例

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

业务请求回调通知(入账)

发票入账业务请求回调通知。入账任务完成时系统自动推送到配置的回调地址。

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

请求参数

参数名 类型 必填 说明
taskId String 是 任务ID
status Integer 是 0=初始化/1=执行中/2=失败/3=成功
statusMsg String 否 状态描述

请求示例

JSON 
{
    "taskId": "631928300933248",
    "status": 3,
    "statusMsg": "入账完成"
}

响应参数

参数名 类型 说明
code String 返回2000表示已接收
msg String 处理结果

响应示例

JSON 
{
    "code": "2000",
    "msg": "成功"
}

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

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