百旺金穗云-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.3勾选接口
          • 2.2.3.1发票勾选接口
          • 2.2.3.2发票抵扣勾选查询接口
          • 2.2.3.3往期勾选发票信息查询接口
          • 2.2.3.4发票预勾选接口
          • 2.2.3.5海关缴款书勾选
        • 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.4.14新版发票识别查验接口(根据链接采集发票)
        • 2.4.15(批量)发票业务状态保存接口
      • 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自动配单结果回填
  • 老版进项
    • 公共参数说明
    • 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
    • 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.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 企业所得税分支机构(年报)
      • 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 参数
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
lrrmc
string 
录入人名称
必需
createEmp
string 
录入人工号
必需
人员工号和销方税号必须二选一
lrrid
string 
录入人 ID
可选
进项用户唯一ID
lrsjStart
string 
录入开始时间 yyyy-mm-dd
可选
lrsjEnd
string 
录入截止时间 yyyy-mm-dd
可选
buyerTaxId
string 
购方税号
必需
人员工号和销方税号必须二选一
buyerName
string 
购方名称
可选
xfsh
string 
销方税号
可选
xfmc
string 
销方名称
可选
fpdm
string 
发票代码
可选
fphm
string 
发票号码
可选
status
string 
发票状态 0 未报销 1 已报销 默认未报销
可选
spr
string 
送票人
可选
djbh
string 
单据编码
可选
pzh
string 
凭证号
可选
nsrsbh
string 
纳税人识别号
必需
pageFlag
string 
是否分页
可选
0:不分页(默认),1分页
page
string 
分页页码
可选
默认:1
limit
string 
分页条数
可选
默认:100
示例
{
    "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
string 
返回代码,0 查询成功,其他查询失败
必需
msg
string 
提示信息
必需
data
array [object {31}] 
必需
invoiceId
string 
发票唯一 ID
可选
UUID
invoiceCode
string 
发票代码
必需
invoiceNo
string 
发票号码
可选
pdfUrl
string 
发票 url 地址
必需
lrsj
string 
录入时间,格式为 2022-02-12 11:10:00
可选
yyyy-MM-dd HH:mm:ss
invoiceType
string 
发票类型代码
可选
10100-增值税专用发票
10101-增值税普通发票
10102-增值税电子普通发票
10103-增值税普通发票(卷票)
10107 增值税电子专用发票
10200-火车票
10201-出租车票
10202-航空运输电子客票行程单
10203-客运票
10204 过路费发票
10300-定额发票
amountLittle
string 
价税合计(小写)
可选
保留两位小数
amountBig
string 
价税合计(大写)
必需
pretaxAmount
string 
非含税合计金额
可选
不含税金额,保留两位小数
taxAmount
string 
合计税额
可选
保留两位小数
invoiceDate
string 
开票时间
可选
yyyy-MM-dd
checkCode
string 
校验码
可选
lrrmc
string 
录入人名称
可选
采集发票的人员名称
sellerTaxId
string 
销方税号
可选
sellerName
string 
销方名称
可选
sellerAddress
string 
销方地址电话
可选
sellerBankInfo
string 
销方开户行及账号
可选
buyerTaxId
string 
购方税号
可选
buyerName
string 
购方名称
可选
buyerAddress
string 
购方地址电话
可选
buyerBankInfo
string 
购方开户行及账号
可选
sl
string 
税率
可选
单税率则传,多税率不传,保留两位小数,示例0.13
cfd
string 
出发地
可选
mdd
string 
目的地
可选
fare
string 
飞机行程单票价
可选
航空运输电子客票行程单必填
caacDevelopmentFund
string 
飞机行程单民航发展基金
可选
航空运输电子客票行程单必填
fuelSurcharge
string 
飞机行程单燃油附加费
可选
航空运输电子客票行程单必填
otherTaxes
string 
其他税费
可选
航空运输电子客票行程单必填
insurance
string 
保险费
可选
航空运输电子客票行程单必填
invoiceTypeName
string 
发票类型名称为火车票
可选
bz1
string 
备注
可选
示例
{
    "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