微报账API文档
  1. 发票
微报账API文档
  • 介绍
  • 鉴权
  • 公司人员
    • 查询公司人员列表
      GET
  • 发票
    • 查询全票种列表
      GET
    • 查询全票种详情
      GET
    • 全票种状态批量修改
      PATCH
  • 单据
    • 查询员工报账单列表
      GET
    • 查询公司报账单列表
      GET
    • 查询付款单详情
      GET
    • 查询付款单列表
      GET
  • 公司配置信息
    • 查询公司的费用类型列表
      GET
  • 公共信息
    • 发票票种
    • 发票查验状态
    • 抬头校验状态
    • 发票使用状态
    • 发票推送状态
    • 发票录入方式
    • 手工记账类型
    • 付款单状态
    • 接口返回码
  1. 发票

查询全票种列表

GET
/ticket/list
本接口支持以下三种方式的查询:
1、以时间区间(begCreateTime-endCreateTime)查询当前公司下的发票列表,此时用户ID不填写;
2、以用户ID(userId)查询当前公司下的该用户所有发票列表,此时时间区间不填写;
3、以用户ID(userId)+时间区间(begCreateTime-endCreateTime)联查该时间段,当前公司下的该用户所有发票列表;
4、reimbursementAmount报销金额,一般与invoiceSummaryAmount票面金额一致,如果需要报销金额小于票面时,可以进行修改报销金额;

请求参数

Query 参数
appId
string 
签名所用的应用ID
必需
示例值:
123456
timestamp
string 
必需
签名所用的时间戳(精确到毫秒)
示例值:
1557480235416
sig
string 
签名
必需
示例值:
1a4ffff8440a1da3de7a71a3aea55c0d
userId
integer 
用户ID
可选
示例值:
1232
begCreateTime
string 
可选
最小录入时间(yyyyMMddHHmmss)
示例值:
20220630122345
endCreateTime
string 
可选
最大录入时间(yyyyMMddHHmmss)
示例值:
20220630122345
pageSize
integer 
每页条数
可选
示例值:
10
page
integer 
页码(从0开始)
可选
示例值:
0

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET '/ticket/list?appId=123456&timestamp=1557480235416&sig=1a4ffff8440a1da3de7a71a3aea55c0d&userId=1232&begCreateTime=20220630122345&endCreateTime=20220630122345&pageSize=10&page=0'

返回响应

🟢200成功
application/json
Body
code
integer 
状态码
必需
data
object 
结果集
必需
forms
array [object {22}] 
数据集
必需
page
integer 
页码
必需
pageSize
integer 
每页条数
必需
total
integer 
总页数
必需
message
string 
消息
必需
示例
{
  "code": 10000,
  "message": "成功",
  "data": {
    "page": 1,
    "pageSize": 20,
    "total": 360,
    "forms": [
      {
        "id": "5fb7a375d18fda24713ed3c1",
        "createTime": "2020-11-20 19:07:33",
        "updateTime": "2021-11-09 10:33:13",
        "teamId": 12726,
        "userName": "张华",
        "invoiceCategory": 20,
        "invoiceCode": "044001900204",
        "invoiceNo": "75943452",
        "invoiceDate": "2020-05-15 00:00:00",
        "invoiceSummaryAmount": 108360,
        "buyerName": null,
        "sellerName": null,
        "sourceType": 8,
        "validState": -1,
        "titleState": -1,
        "pushState": 0,
        "status": 13,
        "costTagName": "其他",
        "reimbursementAmount": 202.5,
        "expenseDesc": ""
      }
    ]
  }
}
修改于 2024-05-07 08:07:56
上一页
查询公司人员列表
下一页
查询全票种详情
Built with