税务数字化管理平台
  1. 销项
税务数字化管理平台
  • 对外接口
    • 文档概览
    • 如何调用接口
    • 更新记录
    • 常见问题
    • 接口码表
    • 销项
      • 税控
        • 发票领购查询
        • 发票作废
        • 空白发票作废
        • 红字信息表申请
        • 红字信息表查询
        • 红字信息表撤销
        • 红字信息表准备信息查询
        • 发票开具（专、普、电）
      • 数电
        • 红字确认单申请准备信息查询
        • 红字确认单申请
        • 查询红字确认单详细信息
        • 红字确认单撤销
        • 红字确认单查询
        • 红字确认单确认
        • 异常红字确认单下载
        • 全电发票开具
        • 人脸识别二维码
        • 获取全电开票结果
        • 获取全电全票面数据
        • 全电认证
        • 短信认证
        • 全电交付
        • 成品油库存台账查询
        • 全电纸质发票作废
        • 获取人脸识别结果
        • 获取红字确认单申请结果
        • 获取数电发票下载地址
        • 红字全电发票开具
        • 获取纸质发票打印XML
        • 发送发票数据到控件
        • 开启打印窗口
        • 蓝字发票数据统计
        • 版式文件下载
        • 批量红字确认单下载
        • 获取当前发票代码号码(数电纸票)
        • 查询跨区域涉税事项报验管理编码
        • 检查账号在线状态
        • 查询身份授权（用户是否需要人脸认证）状态
      • 乐企
        • 获取批量预赋码信息
        • 查询授信额度
        • 下载/退回授信额度
        • 调整授信额度有效期
        • 查询纳税人风险信息
        • 查询纳税人基本信息
        • 查询可用税率信息
        • 查询数字化电子红字确认单列表信息
        • 数字化电子红字确认单确认
        • 查询数字化电子红字确认单明细信息
        • 再次上传数电发票
        • 废弃乐企异常发票
        • 数电发票开具
        • 数电发票开具（实时开票）
        • 数字化电子红字确认单申请
      • 扫码开票
        • 二维码生成规则
        • 扫码开票订单导入
        • 扫码开票订单查询
        • 扫码开票订单作废
      • 发票查询
        POST
      • 单张发票查询
        POST
      • 商品导入
        POST
      • 客户导入
        POST
      • 批量待开导入
        POST
      • 待开分页查询
        POST
      • 批量单据导入
        POST
      • 单据分页查询
        POST
      • 账号注册
        POST
      • 全票种开具
        POST
      • 抬头联想
        POST
      • 单张发票修复
        POST
  1. 销项

发票查询

POST
fpcx

1、接口及场景描述#

接口描述： 根据查询条件获取企业的发票信息
是否支持数电及税控发票：全部支持

2、请求参数#

字段名称必选类型长度字段含义及备注
pageNum否integer页码 [大小： 1~] 默认为1
pageSize否integer每页显示数量 [大小： 1~5000] 默认为10
request是object请求对象
sfhlgwcxtj否string1是否忽略岗位查询条件
发票查询列表，默认查询的是当前岗位的发票信息，若忽略，则不只查询当前岗位的信息
0:不忽略 1:忽略 默认为：0
gwmc否string255岗位名称
当“sfhlgwcxtj”字段传0时：
【1】“gwmc”字段如果传值时，则按照传入的岗位名称进行查询
【2】“gwmc”字段为空时，则按照该账号下默认岗位进行查询
yqjg否string[]验签结果
0：验签失败
1：验签成功
2：待验签
99：无需验签
00: 乐企上传成功
01: 乐企上传中
02: 乐企上传失败（上传失败状态的发票数据）
03: 乐企未上传
04: 乐企重复上传
kprqq否string开票日期起 格式：yyyy-MM-dd
kprqz否string开票日期止 格式：yyyy-MM-dd
djlsh否string100单据流水号（模糊查询）
ghdwmc否string128购货单位名称（模糊查询）
ghdwsbh否string20购货单位识别号（模糊查询）
fphm否string20发票号码
fpdm否string20发票代码
bz否string100备注（模糊查询）
kpsqr否string16开票申请人（模糊查询）
kpr否string40开票人（模糊查询）
kpzdbs否string[]开票终端标识
fplxdm否string[]发票类型代码
004：增值税专用发票
007：增值税普通发票
025：卷式发票
026：增值税电子普通发票
005：机动车发票
006：二手车销售统一发票
028： 增值税电子专用发票
81：电子发票(增值税专用发票)
82： 电子发票(增值税普通发票)
85 纸质专票(全电)
86纸质普票(全电)
fpzt否string[]发票状态
00：已开具的正数发票
01：已开具的负数发票
02：未开具发票的作废发票
03：已开具正数发票的作废发票
04：已开具负数发票的作废发票
fply否string[]发票来源
0：待开导入
1：待开接口对接
2：单据导入
3：单据接口对接
4：发票填开
5：发票修复
6：发票库存查询
7：发票查询

8：红字确认单
zsfs否string1征税方式
0：普通征税
2：差额征税
sdfphm否string20数电发票号码
hjjeq否string合计金额起
hjjez否string合计金额止
hjseq否string合计税额起
hjsez否string合计税额止
jshjq否string价税合计起
jshjz否string价税合计止
sjly否string255数据来源
fpqqlsh否string发票请求流水号
tszt否string推送状态
0:未推送
1:已推送

3、返回参数#

字段名称是否必返回类型长度字段含义及备注
code是integer返回代码
msg是string返回消息
data否object返回数据
id否string20发票唯一编码（由发票代码和发票号码组成）
yqjg否string2验签结果
0：验签失败
1：验签成功
2：待验签
99：无需验签
00: 乐企上传成功
01: 乐企上传中
02: 乐企上传失败（上传失败状态的发票数据）
03: 乐企未上传
04: 乐企重复上传
kprq否string14开票日期 格式：yyyyMMddHHmmss
djlsh否string100单据流水号
fpdm否string20发票代码
fphm否string20发票号码
ghdwsbh否string购货单位识别号
ghdwmc否string购货单位名称
ghdwdzdh否string购货单位地址电话
ghdwyhzh否string购货单位银行帐号
hjje否string32合计金额
hjse否string32合计税额
jshj否string32价税合计
fpzt否string2发票状态
00：已开具的正数发票
01：已开具的负数发票
02：未开具发票的作废发票
03：已开具正数发票的作废发票
04：已开具负数发票的作废发票
kpzdbs否string30开票终端标识
fplxdm否string3发票类型代码
004：增值税专用发票
007：增值税普通发票
025：卷式发票
026：增值税电子普通发票
005：机动车发票
006：二手车销售统一发票
028： 增值税电子专用发票
81：电子发票(增值税专用发票)
82： 电子发票(增值税普通发票)
fply否string2发票来源
0：待开导入
1：待开接口对接
2：单据导入
3：单据接口对接
4：发票填开
5：发票修复
6：发票库存查询
7：发票查询
8：红字确认单
kpsqr否string开票申请人
kpr否string开票人
bz否string备注
url否string电子普通发票版式式文件地址
qdbz否string1清单标志
0：无清单
1：带清单
xhdwmc否string销方单位名称
zsfs否string1征税方式
0：普通征税
2：差额征税
pdfurl否stringpdfurl（数电返回）
ewmurl否string二维码路径（数电返回）
ofdurl否stringofdurl（数电返回）
xmlurl否stringxmlurl（数电返回）
sdfphm否string20数电发票号码
gwmc否string岗位名称
fpqqlsh否string发票请求流水号
sbyy否string失败原因
tszt否string推送状态
0:未推送
1:已推送
yx否string推送邮箱
sjh否string推送手机号

请求参数

Body 参数application/json
method
string 
固定值fpcx
必需
object
object 
必需
pageNum
integer 
页码
可选
页码 [大小： 1~] 默认为1
pageSize
integer 
每页显示数量
可选
每页显示数量 [大小： 1~5000] 默认为10
request
object 
请求对象
必需
请求对象
示例
{
  "method": "fpcx",
  "object": {
    "pageNum": 1,
    "pageSize": 10,
    "request": {
      "sfhlgwcxtj": "0",
      "yqjg": [
        "验签结果"
      ],
      "kprq": [
        "开票日期起",
        "开票日期止"
      ],
      "djlsh": "单据流水号",
      "ghdwmc": "购货单位名称",
      "ghdwsbh": "购货单位识别号",
      "fphm": "发票号码",
      "fpdm": "发票代码",
      "bz": "备注",
      "kpsqr": "开票申请人",
      "kpr": "开票人",
      "kpzdbs": [
        "开票终端标识"
      ],
      "fplxdm": [
        "发票类型代码"
      ],
      "fpzt": [
        "发票状态"
      ],
      "fply": [
        "发票来源"
      ],
      "zsfs": "征税方式",
      "hjjeq": "合计金额起",
      "hjjez": "合计金额止",
      "hjseq": "合计税额起",
      "hjsez": "合计税额止",
      "jshjq": "价税合计起",
      "jshjz": "价税合计止",
      "sjly": "数据来源",
      "sdfphm": "数电发票号码",
      "gwmc": "岗位名称",
      "tszt": "推送状态"
    }
  }
}

返回响应

🟢200成功
application/json
Body
code
integer 
返回代码
必需
返回代码
msg
string 
返回消息
必需
返回消息
data
object 
返回数据
可选
返回数据
count
integer 
必需
pageNum
integer 
必需
dataList
array [object {35}] 
必需
示例
{
  "code": 0,
  "msg": "成功",
  "data": {
    "count": 1,
    "pageNum": 1,
    "dataList": [
      {
        "id": "发票唯一编码",
        "yqjg": "验签结果",
        "kprq": "开票日期",
        "djlsh": "单据流水号",
        "fpdm": "发票代码",
        "fphm": "发票号码",
        "ghdwsbh": "购货单位识别号",
        "ghdwmc": "购货单位名称",
        "ghdwdzdh": "购货单位地址电话",
        "ghdwyhzh": "购货单位银行帐号",
        "hjje": "合计金额",
        "hjse": "合计税额",
        "jshj": "价税合计",
        "fpzt": "发票状态",
        "kpzdbs": "开票终端标识",
        "fplxdm": "发票类型代码",
        "fply": "发票来源",
        "kpsqr": "开票申请人",
        "kpr": "开票人",
        "bz": "备注",
        "url": "电子普通发票版式式文件地址",
        "qdbz": "清单标志",
        "xhdwmc": "销方单位名称",
        "zsfs": "征税方式",
        "pdfurl": "pdfurl（全电有）",
        "ewmurl": "二维码路径（全电有）",
        "ofdurl": "ofdurl（全电有）",
        "xmlurl": "xmlurl（全电有）",
        "sdfphm": "数电发票号码",
        "gwmc": "岗位名称",
        "fpqqlsh": "发票请求流水号",
        "sbyy": "失败原因",
        "tszt": "推送状态",
        "yx": "推送邮箱",
        "sjh": "推送手机号"
      }
    ]
  }
}
上一页
扫码开票订单作废
下一页
单张发票查询
Built with