按金额申请开票

优质

小牛编辑

132浏览

2023-12-01

请求地址

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

返回数据格式

JSON

请求方式

POST

是否需要登录

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

访问授权限制

暂无

请求参数

名称	类型	必选	描述
client_id	string	yes	申请应用时分配的AppKey
access_token	string	yes	授权后的access token
timestamp	bigint	yes	当前时间戳
company_id	string	yes	公司编号
receiver	string	no	收件人,invoice_type=1或2时必传
receiver_phone	string	no	收件人电话,invoice_type=1或2时必传
receiver_address	string	no	收件人地址,invoice_type=1或2时必传
receiver_email	string	no	电子邮箱(接收电子发票)， invoice_type=3必传
invoice_title	string	no	发票抬头（普票必填，专票不填）
tax_registration_number	string	no	纳税人识别号（普票必填，专票不填）
invoice_qid	string	no	资质id（专票必填，普票不填），专票资质列表返回结果中的资质ID
invoice_type	int	yes	发票类型（1:纸质普票 2:纸质专票 3：电子普票）
invoice_content	string	yes	发票内容（运输服务客运服务费）此为唯一默认值，不能变更
invoice_no	string	yes	开票请求编号（接入方唯一标识）
invoice_amount	float	yes	开票金额（值应该大于等于200，小于公司可开票余额）
remark	string	no	备注(长度限制：100个字符)
sign	string	yes	签名

注意事项

开票规则：开票金额应该大于等于200，小于公司可开票余额
参数限制：
普票：invoice_type=1或3, invoice_title为发票抬头、tax_registration_number为纳税人识别号，必填
专票：invoice_type=2, invoice_qid为开票资质ID，必填，并且必须为专票资质列表api返回结果中的资质ID

请求示例

curl -X POST -H "content-type:application/json" \
-d '{"client_id":"client_id_test","access_token":"2313cea6aef2ea3a316b62c47f45db04c1ce4457","timestamp":1583482660,"company_id":"12345678980","receiver_email":"11000005555@qq.com","invoice_type":3,"invoice_content":"*\u8fd0\u8f93\u670d\u52a1*\u5ba2\u8fd0\u670d\u52a1\u8d39","invoice_no":"125904356705555","invoice_amount":"100","invoice_title":"1259xxxxxx555","tax_registration_number":"222259xxxx05555","sign":"ed907a8d5b43f93ebba7cad1297fe043"}' \
https://api.es.xiaojukeji.com/river/Invoice/charge

返回参数说明

返回值字段	字段类型	字段说明
errno	string	0表示成功，非0表示失败
errmsg	string	errno=0时为常量"SUCCESS"，errno!=0时为错误信息
data	object	返回数据
data	data.invoice_id	发票id(同一发票id可能对应多张发票)

返回示例

{
    "errno":0,
    "errmsg":"success",
    "data":{
        "invoice_id":"erpfj8493gsk9v38v"
    }
}

接口错误解决方案

通用错误解决文档

4xx 错误
1xxx 错误

50103(该流水号已经开过票了)

invoice_no不能重复，本次传参中的invoice_no已经被使用过，请换一个