百旺金穗云-SaaS标准化接口
  1. 4.辅助类接口
百旺金穗云-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.企业基本信息查询
          POST
        • 3.4.2.电子税务局登录
          POST
        • 3.4.3.获取实人认证二维码（异步）
          POST
        • 3.4.4.获取实人认证二维码（同步）
          POST
        • 3.4.5.认证结果查询
          POST
      • 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.3勾选接口
          • 2.2.3.1发票勾选接口
          • 2.2.3.2发票抵扣勾选查询接口
          • 2.2.3.3往期勾选发票信息查询接口
          • 2.2.3.4发票预勾选接口
        • 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进项税额转出明细查询接口 Copy
      • 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.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单据新增/修改接口
  • 老版进项
    • 公共参数说明
    • 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查询增值税用途标签状态（海关缴款书）
    • 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.3 个税附录
          • 纳税人类型代码
          • 收入类型代码及相对应的字段externFields
          • 人员相关字典
          • 国籍国家
      • 2.2 增值税一般纳税人
        • 2.2.1增值税一般人申报表接口
      • 2.3 增值税小规模
        • 2.3.1增值税小规模申报表接口
      • 2.4 企业所得税预缴(查账征收)
        • 2.4.1.企业所得税预缴申报表数据生成接口
      • 2.5 印花税
        • 2.5.1.印花税申报表数据生成接口
      • 2.6 工会经费
        • 2.6.1.工会经费台账数据生成接口
      • 2.7 财务报表
        • 2.7.1财务报表未执行申报表接口
        • 2.7.2 财务报表已执行申报表接口
        • 2.7.3 财务报表小企业申报表接口
      • 2.8 发起申报缴款完税凭证
        • 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.9 税种认定信息查询
        • 2.9.1税种认定信息查询
      • 2.10 增值税台账
        • 2.10.1销售收入台账接口
        • 2.10.2计算抵扣台账接口
        • 2.10.3增值税涉税事项台账接口
      • 2.11 残疾人就业保障金
        • 2.11.1残疾人就业保障金台账生成接口
      • 2.12 城镇垃圾处理费
        • 2.12.1城市垃圾处理费台账生成接口
      • 2.13 水利建设专项收入
        • 2.13.1水利建设专项收入台账生成接口
      • 2.14 通用申报
        • 2.14.1通用申报台账
      • 2.15 非税收入通用申报
        • 2.15 非税通用申报
      • 2.16 企业所得税台账
        • 2.16.1企业所得税涉税事项台账接口
        • 2.16.2从业人数台账接口
        • 2.16.3分配比例台账接口
      • 2.17 财务报表税基
        • 2.17.1财务报表税基接口
      • 2.18 科目余额表
        • 查询科目余额表接口
        • 科目余额表添加接口
      • 2.19 同步申报清册
        • 发起同步申报清册(同步纳税人信息)
      • 2.20 房产税台账
        • 房产税台账接口
      • 2.21 城镇土地使用税
        • 城镇土地使用税台账接口
      • 2.22 局端发票汇总
        • 发起获取局端发票汇总下载任务接口
        • 查询局端发票汇总明细
      • 2.23 历史申报数据
        • 发起同步历史申报数据下载任务
        • 申报数据查询接口
      • 2.24 文化事业建设费
        • 文化事业建设费台账生成接口
      • 2.25 企业所得税汇算清缴(年报)
      • 2.26 企业所得税分支机构(年报)
    • 3.附录信息
      • 税种类型
      • 纳税期限和税款所属期
      • 征收品目（印花税）
      • 销售收入类型
      • 计算抵扣类型
      • 增值税一般人免税类型
      • 增值税一般人减税类型
  1. 4.辅助类接口

3.4.3.获取实人认证二维码（异步）

POST
https://api.baiwangjs.com/swgx-saas/agentinvoiceservice-cloudservice-cloudservice/agentiscloud/elecEwm/queryEwmrz
接口描述
支持税局APP、个税APP人脸识别二维码，如果ewmlx是2 返回的是base64文件流
请求路径/elecEwm/queryEwmrz
开放权限所有企业
调用方式POST
参数方式Base64（JSON格式）
重要说明需要短信省份登录分为两步，第一步获取短信验证码，第二步正式登录
业务范围数电
接口类型异步

异步返回数据#

响应报文#

{
  "ywlxdm":"ewmrz",
  "status":"查询状态",
  "ddlsh":"订单流水号",
  "rzid":"认证id",
  "nsrsbh":"纳税人识别号",
  "ewm":"二维码",
  "ycyy":"异常原因"
}

参数说明#

参数名称名称长度必须说明
ywlxdm业务类型代码4是ewmrz
status请求状态5是1成功
2失败
1004 需要登录
ddlsh订单流水号40是入参的ddlsh
ycyy异常原因100否如果status为2 会返回具体失败原因
rzid---
nsrsbh纳税人识别号--
ewm二维码--如果ewmlx是2 返回的是base64文件流

请求参数

Header 参数
Content-Type
string 
必需
默认值:
application/json
Date
string 
必需
默认值:
{{date}}
host
string 
必需
默认值:
{{host}}
x-htjs-nonce
string 
必需
默认值:
{{x-htjs-nonce}}
x-htjs-ua
string 
必需
默认值:
{{x-htjs-ua}}
Authorization
string 
必需
默认值:
{{Authorization}}
Body 参数application/json
qyId
string 
企业id
必需
ywdjDm
string 
业务单据代码
可选
支持按业务代码回调数据
ddlsh
string 
订单流水号
必需
nsrsbh
string 
纳税人识别号
必需
dlzh
string 
登录账号
必需
ewmlx
string 
二维码类型
可选
默认值1 1 税局APP 2 个税APP
示例
{
  "qyId": "企业id",
  "ywdjDm": "业务单据代码",
  "ddlsh": "订单流水号",
  "nsrsbh": "纳税人识别号",
  "dlzh": "登录账号",
  "ewmlx": "二维码类型 1税务app 2个税app"
}

示例代码

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://api.baiwangjs.com/swgx-saas/agentinvoiceservice-cloudservice-cloudservice/agentiscloud/elecEwm/queryEwmrz' \
--header 'Date;' \
--header 'host;' \
--header 'x-htjs-nonce;' \
--header 'x-htjs-ua;' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "qyId": "企业id",
    "ywdjDm": "业务单据代码",
    "ddlsh": "订单流水号",
    "nsrsbh": "纳税人识别号",
    "dlzh": "登录账号",
    "ewmlx": "二维码类型 1税务app 2个税app"
}'

返回响应

🟢200成功
application/json
Body
code
string 
返回代码
必需
0登录成功， 2001 短信验证码发送成功
message
string 
返回信息
必需
成功/失败
renson
string 
描述
必需
失败原因具体描述
示例
{
  "code": "0",
  "messages": "成功"
}
修改于 2024-09-25 02:24:43
上一页
3.4.2.电子税务局登录
下一页
3.4.4.获取实人认证二维码（同步）
Built with