平台Api对接
  1. 发票夹业务
平台Api对接
  • 错误编码信息
  • 开发指南
    • 开发前必读
    • 对接地址
    • 接口调用规则
    • 认证鉴权
    • 认证鉴权
      POST
  • 发票夹业务
    • 介绍
    • 票夹发票查询
      POST
    • 发票使用状态推送
      POST
    • 同步组织(单位、部门、人员)结构接口
      POST
    • 邮局邮件获取
      POST
  • 进项业务
    • 介绍
    • 获取税款所属期
      POST
    • 进项发票采集
      POST
    • 进项发票勾选
      POST
    • 海关缴款书采集
      POST
    • 海关缴款书勾选
      POST
    • 申请发票统计
      POST
    • 发票统计确认签名
      POST
    • 撤销发票统计(统计确认签名)
      POST
  • 税局登陆业务
    • 介绍
    • 电子税务局账户登录接口(手机号短信)
      POST
    • 电子税务局账户上传短信验证码
      POST
  • 发票归集
    • 发票信息获取
      POST
  • 发票文件下载
    • 单张发票板式文件下载
  • 发票开具
    • 介绍
    • 红字发票
      • 红字确认单列表查询
      • 获取红字确认单明细信息
      • 红字确认单申请
      • 红字确认单确认操作
      • 红字确认单撤销操作
      • 红字发票概况统计查询
      • 红字发票开具
    • 附加要素
      • 获取附加要素列表
      • 附加要素添加
      • 附加要素编辑
      • 附加要素删除
    • 获取人脸识别认证二维码(税务app)
    • 获取人脸识别认证结果(税务app)
    • 获取企业基本信息
    • 获取开票统计信息
    • 发票开具申请
    • 获取开票结果
    • 发票邮件交付接口
    • 已开发票列表查询
    • 已开发票明细查询
    • 数电已开发票版式文件下载(单个)
    • 开票刷脸状态查询
  • 智能编码
    • 商品编码智能匹配
    • 企业名称模糊查询
  • 企业相关接口
    • 企业授权模块查询
  • 票据识别
    • 票据识别OCR
  • 发票查验
    • 增值税发票查验
  1. 发票夹业务

票夹发票查询

POST
/invoiceTicket/TicketQuery/1.0
该接口用于发票夹的发票信息查询。
不同的发票类型,返回的发票信息字段不一样

请求参数

Body 参数application/json
nsrsbh
string 
发票所属企业纳税人识别号
必需
示例值:
9133062456*******X
query
object 
查询条件
必需
use_type
integer 
发票状态
必需
使用状态(0:未报销,1报销中,2:已报销)
示例值:
0
yz_type
integer 
验真状态
必需
验真状态(0:未验真,1:验真通过,2:验真未通过)
bill_owner
string 
发票归属人
必需
发票归属人的手机号码
示例值:
1381234****
update_time
string 
更新时间
必需
发票修改信息的时间:yyyy-MM-dd HH:mm:ss
page
integer 
页码
必需
需要查询的当前页码
示例值:
1
limit
integer 
条数
必需
需要一次返回的发票数量
示例值:
20
示例
{
    "nsrsbh": "9133062456*******X",
    "query": {
        "use_type": 0,
        "yz_type": 0,
        "bill_owner": "1381234****",
        "update_time": "string"
    },
    "page": 1,
    "limit": 20
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/invoiceTicket/TicketQuery/1.0' \
--header 'Content-Type: application/json' \
--data-raw '{
    "nsrsbh": "9133062456*******X",
    "query": {
        "use_type": 0,
        "yz_type": 0,
        "bill_owner": "1381234****",
        "update_time": "string"
    },
    "page": 1,
    "limit": 20
}'

返回响应

🟢200成功
application/json
Body
code
integer 
业务代码
必需
0:成功,非0:失败
message
string 
业务消息
必需
requestID
string 
业务流水号
必需
timestamp
integer 
业务提交时间戳
必需
token
string 
登陆Token
可选
只有登陆接口有返回数据
codeType
integer 
业务返回格式
必需
data数据内容编码格式,0:明文,2:AES,3:Base64
iszip
integer 
业务返回压缩标记
必需
data数据是否压缩,1:zip压缩
data
object 
业务返回数据
必需
返回的数据
items
array [object {23}] 
数据列表
必需
total
integer 
总条数
必需
示例
{
    "code": 0,
    "message": "string",
    "requestID": "string",
    "timestamp": 0,
    "token": "string",
    "codeType": 0,
    "iszip": 0,
    "data": {
        "items": [
            {
                "fplsh": "string",
                "yz_type": 0,
                "use_type": 0,
                "update_time": "string",
                "bill_owner": "string",
                "dw_owner": "string",
                "fp_type": "string",
                "zzsfp": {},
                "zzsSd": {},
                "zzsJs": {},
                "jdfp": {},
                "jdc": {},
                "esjdc": {},
                "cxd": {},
                "czc": {},
                "defp": {},
                "glf": {},
                "hcp": {},
                "hgdzkp": {},
                "kyqcp": {},
                "dzylpj": {},
                "srpj": {},
                "other_fp": {}
            }
        ],
        "total": 0
    }
}
🟢200增值税(专用/普通/电子专用)发票
修改于 2024-10-09 03:56:55
上一页
介绍
下一页
发票使用状态推送
Built with