百旺金穗云-SaaS标准化接口
  1. 1税局对接类
百旺金穗云-SaaS标准化接口
  • 销项
    • 1.接口概述
      • 1.接口调用规范
      • 2.接口调用示例代码
    • 2.接口调用说明（分场景）
      • 扫码开票
      • 数电开票
      • 税控开票
    • 3.接口定义
      • 1.通用接口
        • 3.1.1.查询企业唯一标识
        • 3.1.2.智能抬头
      • 2.发票开具
        • 3.2.6.发票开具申请(V2)
          • 3.2.6.发票开具申请(V2)
          • 6.1数电蓝字发票开具
          • 6.2数电纸票开具
          • 6.3折扣行发票开具
          • 6.4差额征收发票开具
          • 6.5特殊票种-住房租赁
          • 6.6特殊票种-不动产租赁-停车费
          • 6.7特殊票种-旅客运输服务
          • 6.8机动车销售统一发票-数电纸质
          • 6.9二手车销售统一发票-数电纸质
        • 3.2.1.查询企业税控设备
        • 3.2.2.查询开票终端
        • 3.2.3.查询数电纸票票种
        • 3.2.4.剩余票量查询
        • 3.2.5.获取待开票号
        • 3.2.7.(V2)发票查询-按订单流水号查询(V2)
      • 3.发票作废红冲
        • 3.3.3.数电红冲申请
        • 3.3.4.数电红冲结果查询
      • 4.辅助类接口
        • 3.4.1.企业基本信息查询
        • 3.4.2.电子税务局登录
        • 3.4.3.获取实人认证二维码（异步）
        • 3.4.4.获取实人认证二维码（同步）
        • 3.4.5.认证结果查询
      • 5.扫码开票
        • 3.5.1.订单码-全量（推送订单）
        • 3.5.1.订单码-数电（推送订单）
    • 4.附录信息
      • 6.1.特殊票种
      • 6.2.增值税特殊管理
      • 6.3.交通工具类型
      • 6.4.身份证件类型
      • 6.5.农产品证件类型
      • 6.6.商品列表
  • 进项
    • 1.接口概述
      • 1,1接口概述
    • 2.接口详情
      • 2.1登录辅助类接口
        • 2.1.1企业信息保存接口
        • 2.1.2电子税务局登录账号信息保存接口
        • 2.1.3电子税务局登录接口
        • 2.1.4获取电子税务局登录状态接口
      • 2.2税务基础
        • 2.2.1税期同步
          • 2.2.1.1同步税款所属期接口
          • 2.2.1.2查询税款所属期接口
        • 2.2.2发票归集接口
          • 2.2.2.1同步发票信息接口
          • 2.2.2.2单票信息查询接口
          • 2.2.2.3进项发票查询接口
          • 2.2.2.4全量进项发票查询接口
          • 2.2.2.5进项发票版式文件下载接口
          • 2.2.2.6海关缴款书查询接口
          • 2.2.2.7同步成品油发票信息
          • 2.2.2.8同步成品油海关缴款书
        • 2.2.3勾选接口
          • 2.2.3.1发票勾选接口
          • 2.2.3.2发票抵扣勾选查询接口
          • 2.2.3.3往期勾选发票信息查询接口
          • 2.2.3.4发票预勾选接口
          • 2.2.3.5海关缴款书勾选
          • 2.2.3.6发票勾选异步接口
          • 2.2.3.7发票勾选异步结果查询接口
          • 2.2.3.8农产品发票预处理接口
          • 2.2.3.9农产品发票加计勾选接口
        • 2.2.4退税勾选接口
          • 2.2.4.1发票退税勾选查询
          • 2.2.4.2发票退税勾选、撤销退税勾选
          • 2.2.4.3退税确认勾选
          • 2.2.4.4发票退税勾选统计接口
          • 2.2.4.5根据确认日期区间 查询已确认退税信息
        • 2.2.5入账接口
          • 2.2.5.1进项发票入账提交接口
          • 2.2.5.2进项发票入账调整接口
          • 2.2.5.3乐企通道--入账能力(非聚合接口，仅申请入账拿到流水号)
          • 2.2.5.4乐企通道--入账能力(非聚合接口，仅根据流水号查询乐企通道入账结果)
        • 2.2.6申请统计接口
          • 2.2.6.1申请统计查询接口
      • 2.3进项税额转出接口
        • 2.3.1进项税额转出接口
        • 2.3.2进项税额转出查询接口
        • 2.3.3进项税额转出统计接口
        • 2.3.4进项税额转出明细查询接口
      • 2.4采集查验接口
        • 2.4.1新版发票识别接口
        • 2.4.2新版发票查验接口
        • 2.4.3新版发票识别查验接口
        • 2.4.4乐企发票查验接口
        • 2.4.5新版采集发票保存接口
        • 2.4.6采集发票查询接口
        • 2.4.7老版发票查验接口（已停止维护，推荐使用新版发票查验接口）
        • 2.4.8老版发票识别接口（已停止维护，推荐使用新版发票识别接口）
        • 2.4.9老版发票识别查验接口（已停止维护，推荐使用新版发票识别查验接口）
        • 2.4.10发票业务状态保存接口
        • 2.4.11发票业务状态删除接口
        • 2.4.12发票业务状态查询接口
        • 2.4.13进项电子票据解析接口
        • 2.4.14新版发票识别查验接口(根据链接采集发票)
        • 2.4.15（批量）发票业务状态保存接口
        • 2.4.16国外发票识别接口
      • 2.5归档管理
        • 2.5.1发票单据绑定、解绑接口（发票：单据 =1：N）
        • 2.5.2发票单据绑定、解绑接口（单据：发票 =1：N）
        • 2.5.3发票凭证绑定、解绑接口（发票：凭证 =1：N）
        • 2.5.4发票凭证绑定、解绑接口（凭证：发票=1：N）
        • 2.5.5单据凭证绑定、解绑接口（单据：凭证=1：N）
        • 2.5.6单据凭证绑定、解绑接口（凭证：单据=1：N）
      • 2.6配单管理
        • 2.6.1单据新增/修改接口
        • 2.6.2自动配单结果回填
    • 3.附录信息
      • 3.1响应状态码
      • 3.2.1发票状态码（全电平台）
      • 3.2.2发票状态码（全国增值税查验平台）
      • 3.3《全电票平台》发票类型代码
      • 3.4数据来源类型代码
      • 3.5发票业务类型代码
      • 3.6特定要素枚举值
      • 3.7老版发票识别接口发票类型代码
      • 3.8新版发票识别接口发票类型
      • 3.9税区代码
      • 3.10乐企查验返回发票票面信息数据说明
      • 3.11发票风险等级
  • 老版进项
    • 公共参数说明
    • 1税局对接类
      • 1.1进项底账库发票查询（共享本地缓存）
        POST
      • 1.2 发票勾选/撤销勾选
        POST
      • 1.3 申请统计/撤销统计
        POST
      • 1.4 确认签名/取消确认签名
        POST
      • 1.5 获取申请统计数据
        POST
      • 1.6税期获取
        POST
      • 1.7全票面数据查询（实时，不落库共享）
        POST
      • 1.8发票查验
        POST
      • 1.9海关缴款书勾选
        POST
      • 1.10入账提交
        POST
      • 1.11入账调整
        POST
      • 1.12发票单据绑定/解绑
        POST
      • 1.13发票凭证绑定/解绑
        POST
      • 1.14采集发票查询
        POST
      • 1.15采集发票删除
        POST
      • 1.16发票文件识别保存
        POST
      • 1.17发票数据保存
        POST
      • 1.18单张发票版式获取
        POST
      • 1.19发票退税勾选查询
        POST
      • 1.20发票退税勾选、撤销退税勾选
        POST
      • 1.21退税确认勾选
        POST
      • 1.22发票退税勾选统计接口
        POST
      • 1.23根据确认日期区间查询已确认退税信息
        POST
      • 1.24异常状态发票更新
        POST
      • 1.25查询增值税用途标签状态
        POST
      • 1.26查询增值税用途标签状态（海关缴款书）
        POST
      • 1.27成品油用途列表查询
        POST
      • 1.28成品油用途勾选
        POST
      • 1.29成品油库存汇总台账
        POST
      • 1.30成品油授权编码查询
        POST
    • 2发票识别接口
      • 2.1识别接口
        • 2.1.1发票识别接口
      • 2.2识别返回报文
        • 2.2.1增值税专用发票（普票相同）
        • 2.2.2增值税电子普通发票
        • 2.2.3增值税普通发票（卷票）
        • 2.2.4机动车销售统一发票
        • 2.2.5二手车销售统一发票
        • 2.2.6火车票
        • 2.2.7出租车票
        • 2.2.8航空运输电子客票行程单
        • 2.2.9客运汽车票
        • 2.2.10过路费发票
        • 2.2.11定额发票
        • 2.2.12机打发票
        • 2.2.13增值税发票销货清单
        • 2.2.14完税证明
        • 2.2.15电子发票返回列表
    • 3发票查验接口
      • 3.1发票查验接口
    • 4附录
      • 4.1接口类型编号
      • 4.2特定约束类型
      • 4.3出行人证件类型
      • 4.4交通工具类型
  • 申报
    • 1.接口概述
      • 1.1申报接口调用规范
      • 1.2 接口调用流程
        • 1.2.1 个税调用流程
        • 1.2.2 增值税一般人调用流程
        • 1.2.4 企业所得税预缴(查账征收)调用流程
        • 1.2.5 印花税调用流程
      • 1.3 接口调用示例代码
    • 2.接口定义
      • 2.1 个税
        • 2.1.1 社保接口
          • 2.1.1.1 获取社保申报的数据
          • 2.1.1.2 社保申报
          • 2.1.1.3 社保申报结果查询
          • 2.1.1.4 社保扣款
          • 2.1.1.5 社保扣款结果查询
          • 2.1.1.6 社保完税凭证明细查询
          • 2.1.1.7 社保完税凭证导出
          • 2.1.1.8 查询社保人员明细数据
        • 2.1.2 个税接口
          • 2.1.2.1 生成批次信息-每调用一次生成一个批次ID
          • 2.1.2.2 删除批次信息
          • 2.1.2.3 同步人员
          • 2.1.2.4 个税-查询人员报送结果
          • 2.1.2.5 查询某年度符合一次性扣除6万数据
          • 2.1.2.6 确认并上报某年度一次性扣除6万数据
          • 2.1.2.7 同步专项附加数据
          • 2.1.2.8 获取专项附加数据
          • 2.1.2.9 同步收入
          • 2.1.2.10获取计算结果信息-第三方调用此接口,获取个税计算结果
          • 2.1.2.11 计算税款
          • 2.1.2.12 查询税款计算结果
          • 2.1.2.13 个税申报
          • 2.1.2.14 个税申报结果查询
          • 2.1.2.15 个税申报扣款
          • 2.1.2.16 个税扣款结果查询
          • 2.1.2.17 个税申报表获取
          • 2.1.2.18 个税完税凭证获取
          • 2.1.2.19 个税-作废当期申报
          • 2.1.2.20 个税-更正往期申报
          • 2.1.2.21 个税-撤销往期更正申报
          • 2.1.2.22 个税-撤销往期更正申报
          • 2.1.2.23 三方同步人员接口
          • 2.1.2.24 三方同步薪资接口
          • 2.1.2.25 人员信息查询接口
          • 2.1.2.26 个税完税凭证查询
          • 2.1.2.27 个人养老金查询接口
          • 2.1.28 个税每月初始化接口(仅报个税,不报国税时使用)
        • 2.1.3 个税附录
          • 纳税人类型代码
          • 收入类型代码及相对应的字段externFields
          • 人员相关字典
          • 国籍国家
          • incomeTypeCode字典
      • 2.2 国税
        • 2.2.1 各税种申报表对接接口
          • 2.2.1.1增值税一般人接口
          • 2.2.1.2增值税小规模接口
          • 2.2.1.3企业所得税(月季)接口
          • 2.2.1.4财务报表未执行接口
          • 2.2.1.5财务报表已执行接口
          • 2.2.1.6财务报表小企业接口
          • 2.2.1.7印花税接口
          • 2.2.1.8工会经费生成接口
          • 2.2.1.9通用申报接口
          • 2.2.1.10非税收入通用申报接口
          • 2.2.1.11文化事业建设费接口
          • 2.2.1.12水利建设专项收入接口
          • 2.2.1.13城市垃圾处理费接口
          • 2.2.1.14残疾人就业保障金接口
          • 2.2.1.15企业所得税汇算清缴(年报)接口
          • 2.2.1.16企业所得税分支机构(年报)接口
        • 2.2.2 税基台账底稿接口
          • 2.2.2.1 科目余额表
            • 查询科目余额表接口
            • 科目余额表添加接口
          • 2.2.2.2 增值税台账
            • 2.10.1销售收入台账接口
            • 2.10.2计算抵扣台账接口
            • 2.10.3增值税涉税事项台账接口
          • 2.2.2.3 企业所得税台账
            • 2.16.1企业所得税涉税事项台账接口
            • 2.16.2从业人数台账接口
            • 2.16.3分配比例台账接口
          • 2.2.2.4 财务报表税基
            • 2.17.1财务报表税基接口
          • 2.2.2.5 房产税台账
            • 房产税台账接口
          • 2.2.2.6 城镇土地使用税
            • 城镇土地使用税台账接口
        • 2.2.3 申报缴款凭证接口
          • 2.8.1发起申报接口
          • 2.8.2申报进度查询
          • 2.8.3发起缴款接口
          • 2.8.4缴款进度查询
          • 2.8.5发起表格式完税证明下载
          • 2.8.6表格式完税证明查询
          • 2.8.7发起申报/缴款结果查询任务
          • 2.8.8申报/缴款结果数据查询
        • 2.2.4 辅助查询类接口
          • 2.2.4.1 同步申报清册
            • 发起同步申报清册(同步纳税人信息)
          • 2.2.4.2 期初数接口
            • 期初数查询接口
          • 2.2.4.3 局端发票汇总
            • 发起获取局端发票汇总下载任务接口
            • 查询局端发票汇总明细
          • 2.2.4.4 税种认定信息查询
            • 2.9.1税种认定信息查询
          • 2.2.4.5 历史申报数据
            • 发起同步历史申报数据下载任务
            • 申报数据查询接口
      • 2.27 工商年报
        • 工商登录信息配置接口
        • 工商登录信息查询接口
        • 发起工商业务初始化接口
        • 发起社保初始化接口
        • 发起工商年报申报接口
        • 工商年报状态查询接口
    • 3.附录信息
      • 税种类型
      • 纳税期限和税款所属期
      • 征收品目（印花税）
      • 销售收入类型
      • 计算抵扣类型
      • 增值税一般人免税类型
      • 增值税一般人减税类型
      • 申报/扣款状态代码
  1. 1税局对接类

1.14采集发票查询

POST
https://api2.htjs.net/csxxh/skgxfw-api-master-api-saas/api/ydcj/invoice/jxInvoiceQuery
接口说明：用于第三方系统对接，第三方系统可查询系统中已采集的发票信息。
Content-Type：application/json

请求参数

Header 参数

Body 参数application/json

示例
{
    "lrrmc": "录入人名称", // 录入人名称
    "createEmp": "录入人工号", // 录入人工号
    "lrrid": "录入人 ID", // 录入人 ID
    "lrsjStart": "录入开始时间 yyyy-mm-dd", // 录入开始时间 yyyy-mm-dd
    "lrsjEnd": "录入截止时间 yyyy-mm-dd", // 录入截止时间 yyyy-mm-dd
    "buyerTaxId": "购方税号", // 购方税号
    "buyerName": "购方名称", // 购方名称
    "xfsh": "销方税号", // 销方税号
    "xfmc": "销方名称", // 销方名称
    "fpdm": "发票代码", // 发票代码
    "fphm": "发票号码", // 发票号码
    "status": "发票状态 0 未报销 1 已报销 默认未报销", // 发票状态 0 未报销 1 已报销 默认未报销
    "spr": "送票人", // 送票人
    "djbh": "单据编码", // 单据编码
    "pzh": "凭证号", // 凭证号
    "nsrsbh": "纳税人识别号" // 纳税人识别号
}

请求示例代码

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://api2.htjs.net/csxxh/skgxfw-api-master-api-saas/api/ydcj/invoice/jxInvoiceQuery' \
--header 'Date;' \
--header 'host;' \
--header 'x-htjs-nonce;' \
--header 'x-htjs-ua;' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "lrrmc": "录入人名称", // 录入人名称
    "createEmp": "录入人工号", // 录入人工号
    "lrrid": "录入人 ID", // 录入人 ID
    "lrsjStart": "录入开始时间 yyyy-mm-dd", // 录入开始时间 yyyy-mm-dd
    "lrsjEnd": "录入截止时间 yyyy-mm-dd", // 录入截止时间 yyyy-mm-dd
    "buyerTaxId": "购方税号", // 购方税号
    "buyerName": "购方名称", // 购方名称
    "xfsh": "销方税号", // 销方税号
    "xfmc": "销方名称", // 销方名称
    "fpdm": "发票代码", // 发票代码
    "fphm": "发票号码", // 发票号码
    "status": "发票状态 0 未报销 1 已报销 默认未报销", // 发票状态 0 未报销 1 已报销 默认未报销
    "spr": "送票人", // 送票人
    "djbh": "单据编码", // 单据编码
    "pzh": "凭证号", // 凭证号
    "nsrsbh": "纳税人识别号" // 纳税人识别号
}'

返回响应

🟢200成功
application/json
Body

示例
{
    "code": "返回代码，0 查询成功，其他查询失败", // 返回代码，0 查询成功，其他查询失败
    "msg": "提示信息", // 提示信息
    "data": [
        {
            "invoiceId": "发票唯一 ID", // 发票唯一 ID
            "invoiceCode": "发票代码", // 发票代码
            "invoiceNo": "发票号码", // 发票号码
            "pdfUrl": "发票 url 地址", // 发票 url 地址
            "lrsj": "2022-02-12 11:10:00", // 录入时间，格式为 2022-02-12 11:10:00
            "invoiceType": "发票类型代码", // 发票类型代码
            "amountLittle": "价税合计（小写）", // 价税合计（小写）
            "amountBig": "价税合计（大写）", // 价税合计（大写）
            "pretaxAmount": "非含税合计金额", // 非含税合计金额
            "taxAmount": "合计税额", // 合计税额
            "invoiceDate": "开票时间", // 开票时间
            "checkCode": "校验码", // 校验码
            "lrrmc": "录入人名称", // 录入人名称
            "sellerTaxId": "销方税号", // 销方税号
            "sellerName": "销方名称", // 销方名称
            "sellerAddress": "销方地址电话", // 销方地址电话
            "sellerBankInfo": "销方开户行及账号", // 销方开户行及账号
            "buyerTaxId": "购方税号", // 购方税号
            "buyerName": "购方名称", // 购方名称
            "buyerAddress": "购方地址电话", // 购方地址电话
            "buyerBankInfo": "购方开户行及账号", // 购方开户行及账号
            "sl": "税率", // 税率
            "cfd": "出发地", // 出发地
            "mdd": "目的地", // 目的地
            "fare": "飞机行程单票价", // 飞机行程单票价
            "caacDevelopmentFund": "飞机行程单民航发展基金", // 飞机行程单民航发展基金
            "fuelSurcharge": "飞机行程单燃油附加费", // 飞机行程单燃油附加费
            "otherTaxes": "其他税费", // 其他税费
            "insurance": "保险费", // 保险费
            "invoiceTypeName": "火车票", // 发票类型名称为火车票
            "bz1": "备注" // 备注
        }
    ]
}
修改于 2025-03-25 02:35:30
上一页
1.13发票凭证绑定/解绑
下一页
1.15采集发票删除
Built with