按充值金额开票

请求地址

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 int yes 开票金额(值应该大于等于200,小于公司可开票余额)
remark string no 备注
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"
    }
}

接口错误解决方案

通用错误解决文档

  1. 4xx 错误
  2. 1xxx 错误

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

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

results matching ""

    No results matching ""