按充值金额开票

请求地址

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 string或float yes 开票金额（小于公司可开票余额）(传递参数例如 3379.34,"3379.34")
remark string no 备注(长度限制：100个字符)
sign string yes 签名

注意事项

开票规则：开票金额应该大于等于200，小于公司可开票余额

参数限制：

普票：invoice_type=1或3, invoice_title为发票抬头，必填

专票：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":"开票主体名称","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 ""