接口文档 - 星云税融API

接口文档

文档 / 发票认证 / 发票勾选 / 进项发票勾选

发票认证 - 进项发票勾选

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

发票勾选

进项发票勾选

发票勾选

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

登录查看报价

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
            }
        ]
    }
}

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