按行程开票

请求地址

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

返回数据格式

JSON

请求方式

POST

是否需要登录

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

访问授权限制

暂无

请求参数

注意事项

1. 开票规则：只有是个人垫付（pay_type=1）或混合支付（pay_type=2）且未开票(is_invoice=0)的订单（已支付或部分退款的）才可以开票，仅支持快车专车豪华车

参数限制：

1. 普票：invoice_type=1或3, invoice_title为发票抬头，必填；
2. 专票：invoice_type=2, invoice_qid为开票资质ID，必填，并且必须为专票资质列表api返回结果中的资质ID
3. 纸质发票：invoice_type=1或2，如发票金额<200，则邮费到付；如发票金额>=200，则包邮

请求示例

curl -X POST -H "content-type:application/json" \
-d '{"client_id":"client_id_test","access_token":"c69340a883d3c87133793f71f6c960cbc7ae9284","timestamp":1583482495,"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","data":"{\"total_price\":\"13\",\"orders\":[{\"order_id\":\"1125904356700122\",\"price\":\"13\"}]}","invoice_title":"1259xxxxxx555","tax_registration_number":"222259xxxx05555","sign":"9b4ef177eda266c8db62bdbc81d5c36f"}' \
https://api.es.xiaojukeji.com/river/Invoice/apply

返回参数说明

返回示例

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

接口错误解决方案

通用错误解决文档

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

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

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

51100,51102(不满足开票要求(原因可能是:xxx))

xxx可能是：

1. 存在金额不符订单
   1. 该订单开票金额确实与订单支付金额不符
   2. 该订单发生了退款，但是开票时的开票金额没有减去退款金额(检查方法：调用订单详情接口重新拉一下订单，检查是否发生退款)
2. 存在实际可开票金额为零的订单
   1. 订单可能发生全部退款(检查方法：调用订单详情接口重新拉一下订单，检查支付金额与退款金额是否相等，如果相等则表示全额退款)
3. 存在出租车或代驾订单
   1. 不支持出租车和代驾订单开票
4. 存在非支付订单
   1. 括号后面列举的订单还没有支付，需要支付后才能开票
5. 存在已开票订单
   1. 括号后面列举的订单已经开过票，不能再开