说明:
1.第三方平台补贴用户的场景,按照补贴后的金额给用户开票,需要通过该接口或者2.12 确认费用接口
传入“第三方补贴金额”“曹操分摊补贴金额”字段,传入后开票金额=曹操订单结算金额-第三方补贴金额-曹操分摊补贴金额
2.名词:【第三方补贴金额】第三方平台给用户补贴的金额;【曹操分摊补贴金额】在第三方平台补贴用户但由曹操承担补贴的金额
3.未支付&已开票订单不支持调用该接口;若订单未改费只允许传入一次。
4.接入方收到改费回调通知后,可重新调用该接口更新一次第三方补贴金额&曹操分摊补贴金额。
5.三方补贴金额的发票仅支持联系曹操商务线下获取,该部分不支持线上开票,详情咨询商务
请求地址: /v2/common/updateAllowanceAmount
服务协议: HTTP/POST
Content-Type: application/x-www-form-urlencoded
请求参数:
参数名 | 类型 | 必选 | 描述 |
---|---|---|---|
client_id | string | Y | 申请的client_id |
timestamp | long | Y | 时间戳 |
sign | string | Y | 参数签名 |
amountItems | string | Y | [{"allowanceAmount":100,"caoAllowanceAmount":100,"orderNo":8144403802000}] 为json字符串 1.allowanceAmount Long Y 第三方补贴金额,单位分 (例:曹操订单结算金额为100元,三方平台给乘客做10元补贴,该字段传入1000,则调用开票接口该笔订单开出90元发票,剩余10元发票可线下向曹操申请开取) 2.caoAllowanceAmount Long Y 曹操营销分摊金额 (例:曹操订单结算金额为100元,曹操营销分摊给乘客做10元,该字段传入1000,则调用开票接口该笔订单开出90元发票) 3.第三方补贴金额和曹操营销分摊金额都有传,开票金额为=订单金额-这两项费用 4.注意:第三方补贴金额和曹操分摊补贴金额中有一项更新过一次,另一项也不能在第二次进行更新 5. orderNo Long Y 订单号 |
响应data参数:
参数名称 | 类型 | 必有 | 说明 |
---|---|---|---|
ignoreOrderNos | List |
N | 无效订单号列表 |
unFinishOrderNos | List |
N | 未支付订单号列表 |
invoiceOrderNos | List |
N | 已开票订单列表 |
结果示例:
{"code":200,"data":{"invoiceOrderNos":[8144403802000],"success":true}