百旺金穗云-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.2.9单票状态查询
        • 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.3.10成品油发票勾选接口
        • 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自动配单结果回填
      • 2.7基础资料
        • 出口退税率文库查询
      • 2.8消息推送
        • 异常发票消息推送
    • 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发票风险等级
      • 3.12 新版发票查验状态码以及异常详情
  • 老版进项
    • 公共参数说明
    • 1税局对接类
      • 1.1进项底账库发票查询（共享本地缓存）
      • 1.2 发票勾选/撤销勾选
      • 1.3 申请统计/撤销统计
      • 1.4 确认签名/取消确认签名
      • 1.5 获取申请统计数据
      • 1.6税期获取
      • 1.7全票面数据查询（实时，不落库共享）
      • 1.8发票查验
      • 1.9海关缴款书勾选
      • 1.10入账提交
      • 1.11入账调整
      • 1.12发票单据绑定/解绑
      • 1.13发票凭证绑定/解绑
      • 1.14采集发票查询
      • 1.15采集发票删除
      • 1.16发票文件识别保存
      • 1.17发票数据保存
      • 1.18单张发票版式获取
      • 1.19发票退税勾选查询
      • 1.20发票退税勾选、撤销退税勾选
      • 1.21退税确认勾选
      • 1.22发票退税勾选统计接口
      • 1.23根据确认日期区间查询已确认退税信息
      • 1.24异常状态发票更新
      • 1.25查询增值税用途标签状态
      • 1.26查询增值税用途标签状态（海关缴款书）
      • 1.27成品油用途列表查询
      • 1.28成品油用途勾选
      • 1.29成品油库存汇总台账
      • 1.30成品油授权编码查询
    • 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.2.28 个税每月初始化接口(仅报个税,不报国税时使用)
          • 2.1.2.29 个人养老金发起查询接口
          • 2.1.2.30 个人养老金明细查询接口
        • 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.接口调用规范

1. 接口内容声明#

报文格式：JSON（必须base64转码）
请求方式：POST
请求内容类型：application/json
编码方式：utf-8
接口适用范围：税控接口和数电接口有部分共用

2. 接口使用方式#

第三方/乙方企业必须在【百旺金穗共享SaaS平台】（或本地化部署系统）注册开户。
第三方/乙方服务需要申请访问【百旺金穗共享SaaS平台】（或本地化部署系统）服务相关密钥。
第三方/乙方服务提供访问【百旺金穗共享SaaS平台】（或本地化部署系统）服务的公网IP（可选）。
第三方/乙方服务提供回调地址（用于发票开具成功后回填）。

3. 接口安全接入#

第三方服务通过调用API网关(支持http、https)访问相关服务，请参考Demo中调用方式，具体调用原理参考
文档。

简要步骤#

1、组装sign_str内容（有顺序、需换行，date是格林威治时间、日期位是两位数，冒号后有空格）
POST /swgx-saas/agentinvoiceservice-cloudservice-cloudservice/agentiscloud/cloud/queryUniqueSign HTTP/1.1
date: Thu, 08 Jan 2024 07:48:16 GMT
host: api.baiwangjs.com
x-htjs-nonce: 5d4ed749-0afd-4d80-b627-af67e7e2b576（随机数）
x-htjs-ua: Java 1.8.0_181 64 bit, sdk-ver=1.0.0（开发环境）
2、将 sign_str 和网关 SECRET 通过 HmacSha256 计算，Base64 输出 sign 内容。
可以通过在线工具验证正确性：https://lzltool.cn/data-hash
3、组装请求 header 内容
Header内容
Authorizationhmac username="网关KEY", algorithm="hmac-sha256", headers="request-line date host x-htjs-nonce x-htjs-ua", signature="第2步生成的sign内容"
x-htjs-uaJava 1.8.0_181 64 bit, sdk-ver=1.0.0
Hostapi.baiwangjs.com
x-htjs-nonce5d4ed749-0afd-4d80-b627-af67e7e2b576
DateThu, 08 Jan 2024 07:48:16 GMT

4. 异步接口统一回调说明#

接口说明中接口类型为异步接口，需要接口调用方提供回调地址，按照接口规范接收返回数据。
回调地址请提供给百旺金穗云对接人员，我们负责回调地址的配置。
调用方式为POST；
回调接口接收报文类型格式为text/plain，回填格式Base64（明文），参考各接口异步返回数据参数说明

响应报文#

返回响应报文类型格式：application/json

回调接口 Java 示例#

修改于 2024-09-13 09:11:25
下一页
2.接口调用示例代码
Built with