发票查询

优质

小牛编辑

131浏览

2023-12-01

请求地址

https://api.es.xiaojukeji.com/river/Invoice/get

返回数据格式

JSON

请求方式

GET

是否需要登录

是关于登录授权，参见如何登录授权

访问授权限制

暂无

请求参数

名称	类型	必选	描述
client_id	string	yes	申请应用时分配的AppKey
access_token	string	yes	授权后的access token
timestamp	bigint	yes	当前时间戳
company_id	string	yes	公司编号
invoice_type	int	no	开票类型(1：普票，2：专票，3：电票普票；若不传则不区分)
apply_source	int	no	申请来源(1：企业充值票，2：个人垫付票；若不传则不区分)
start_date	string	yes	开始日期（如：2015-05-01）
end_date	string	yes	结束日期（如：2015-05-28）
offset	int	yes	数据开始位置
length	int	yes	数据条数（最大100条）
sign	string	yes	签名

注意事项

暂无

请求示例

curl -X GET -H "Content-Type: application/x-www-form-urlencoded" https://api.es.xiaojukeji.com/river/Invoice/get?client_id=client_id_test&access_token=141ea31466478eab2f1c1ddcca2675b989a16552&timestamp=1566764837&company_id=12345678980&start_date=2018-05-13&end_date=2018-09-30&offset=0&length=10&sign=091cf244ad5ab16935cfe44fc698bc58

返回参数说明

返回值字段	字段类型	字段说明
errno	string	0表示成功，非0表示失败
errmsg	string	errno=0时为常量"SUCCESS"，errno!=0时为错误信息
data	object	发票列表信息

data数据格式

返回值字段	字段类型	字段说明
total	int	符合此次查询条件的发票总数
records	array	发票集合

records数组元素格式

返回值字段	字段类型	字段说明
invoice_id	string	发票ID
invoice_no	string	票单流水号
apply_date	string	申请日期
realname	string	申请人
invoice_title	string	发票抬头
total_price	string	金额
invoice_type	string	发票类型（1：普票，2：专票，3：电票普票）
invoice_content	string	内容
invoice_status	string	状态（纸质票状态：审核中、待邮寄、已发出、已签收、待发出、已重新开票、已驳回、已退票；电子票状态：审核中、待开票、已开票、待冲红、已冲红、已驳回）
apply_source	int	申请来源(1：企业充值票，2：个人垫付票)
express_company	string	物流公司
express_number	string	物流单号
remark	string	描述

返回示例

{
    "errno":0,
    "errmsg":"SUCCESS",
    "data":{
        "total":2,
        "records":[
            {
                "invoice_no":"1450682255",
                "invoice_id":"erp0fc87886",
                "apply_date":"2015-12-21",
                "invoice_title":"test",
                "total_price":"25.00",
                "invoice_type":1,
                "apply_source":1,
                "invoice_content":"约车服务费",
                "invoice_status":"审核中",
                "express_company":"",
                "express_number":"",
                "remark":"ddfdfdfd"
            }
        ]
    }
}