文档中心 > API类目 > 旅行用车API

alitrip.rentcar.btb.bill.notify (租车分销账单推送接口)

租车分销账单推送接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
rent_car_b2b_distribution_bill_req RentCarB2bDistributionBillReq 可选 入参
  • └ trace_id
  • String
  • 可选
  • 3048786216231969001
  • 用于排查问题
  • distributor_bill_list
  • DistributorBill []
  • 可选
  • 结算账单列表
  • 结算账单列表
  • └ total_amount
  • String
  • 必须
  • 10000
  • 批次总金额,一次打款的总金额,单位元,若此批次总支出金额大于总收入金额,则此值为负数
  • └ req_batch_no
  • String
  • 必须
  • 20230203001
  • 通知批次号
  • └ remark
  • String
  • 可选
  • 备注
  • 备注
  • └ bill_no
  • String
  • 必须
  • ID20230203
  • 分销商结算单号,一个结算周期内的多个通知批次需采用一致的结算单号
  • bill_detail_list
  • BillDetail []
  • 可选
  • 订单明细
  • 订单明细
  • └ pay_channel_amount
  • String
  • 可选
  • 0
  • 支付通道费,单位元
  • └ ext
  • String
  • 可选
  • {"key":"value"}
  • 扩展信息
  • └ user_real_pay_amount
  • String
  • 可选
  • 100
  • 用户实际支付金额、用户有损支付金额,单位元
  • └ biz_type
  • Number
  • 必须
  • 10
  • 业务类型,收入交易类型:10: 订单费用;11: 车损押金扣款;12: 违章押金扣款;13: 押金扣款;14: 有损取消(违约金收入);退款交易类型:20: 订单费用;21: 车损押金扣款的退款;22: 违章押金扣款的退款;23:押金扣款的退款;24: 有损取消的退款(违约金收入的退款);若无法区分是违章押金还是车损押金,统一传13(押金扣款)或23(押金退款)
  • └ real_consume_amount
  • String
  • 可选
  • 100
  • 实际消费金额(线上费用+ 线下费用)
  • └ order_id
  • String
  • 必须
  • fz2939293
  • 飞猪订单id
  • └ pay_time
  • Date
  • 必须
  • 2023-02-03 19:23:32
  • 打款时间,yyyy-MM-dd HH:mm:ss
  • └ discount_amount
  • String
  • 可选
  • 0
  • 飞猪平台优惠金额,单位元
  • └ order_status
  • String
  • 可选
  • 1
  • 订单状态 (分销商侧的订单状态)
  • └ pay_trade_no
  • String
  • 必须
  • 1122334411
  • 交易流水号
  • └ distributor_discount_amount
  • String
  • 可选
  • 0
  • 分销商平台优惠金额,单位元
  • └ order_amount
  • String
  • 必须
  • 100
  • 当前订单的金额变动,单位元,此值为正数,采用 tradeType 或 bizType 来区分收入还是支出
  • └ pay_type
  • Number
  • 可选
  • 1
  • 用户支付方式,1: 支付宝 2: 微信 3:滴滴支付
  • └ out_order_id
  • String
  • 必须
  • fx123111
  • 分销商订单号
  • └ trade_type
  • Number
  • 必须
  • 1
  • 交易类型,1: 收入 2: 退款
  • └ commission_amount
  • String
  • 可选
  • 10
  • 佣金金额,单位元
  • └ exts
  • String
  • 可选
  • {"key":"value"}
  • 扩展信息
  • └ channel_id
  • String
  • 必须
  • 80003
  • 分销渠道ID,高德:80001,哈啰:80002,滴滴:80003

响应参数

名称 类型 示例值 描述
successful Boolean true 请求是否成功
ret_code String 1001 错误码
exts Json {"k":"v"} 扩展信息
ret_msg String 错误信息 错误信息

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripRentcarBtbBillNotifyRequest req = new AlitripRentcarBtbBillNotifyRequest();
AlitripRentcarBtbBillNotifyRequest.RentCarB2bDistributionBillReq obj1 = new AlitripRentcarBtbBillNotifyRequest.RentCarB2bDistributionBillReq();
obj1.setTraceId("3048786216231969001");
List<AlitripRentcarBtbBillNotifyRequest.DistributorBill> list3 = new ArrayList<AlitripRentcarBtbBillNotifyRequest.DistributorBill>();
AlitripRentcarBtbBillNotifyRequest.DistributorBill obj4 = new AlitripRentcarBtbBillNotifyRequest.DistributorBill();
list3.add(obj4);
obj4.setTotalAmount("10000");
obj4.setReqBatchNo("20230203001");
obj4.setRemark("备注");
obj4.setBillNo("ID20230203");
List<AlitripRentcarBtbBillNotifyRequest.BillDetail> list7 = new ArrayList<AlitripRentcarBtbBillNotifyRequest.BillDetail>();
AlitripRentcarBtbBillNotifyRequest.BillDetail obj8 = new AlitripRentcarBtbBillNotifyRequest.BillDetail();
list7.add(obj8);
obj8.setPayChannelAmount("0");
obj8.setExt("{\"key\":\"value\"}");
obj8.setUserRealPayAmount("100");
obj8.setBizType(10L);
obj8.setRealConsumeAmount("100");
obj8.setOrderId("fz2939293");
obj8.setPayTime(StringUtils.parseDateTime("2023-02-03 19:23:32"));
obj8.setDiscountAmount("0");
obj8.setOrderStatus("1");
obj8.setPayTradeNo("1122334411");
obj8.setDistributorDiscountAmount("0");
obj8.setOrderAmount("100");
obj8.setPayType(1L);
obj8.setOutOrderId("fx123111");
obj8.setTradeType(1L);
obj8.setCommissionAmount("10");
list5.setBillDetailList(list7);
obj1.setDistributorBillList(list3);
obj1.setExts("{\"key\":\"value\"}");
obj1.setChannelId("80003");
req.setRentCarB2bDistributionBillReq(obj1);
AlitripRentcarBtbBillNotifyResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alitrip_rentcar_btb_bill_notify_response>
    <successful>true</successful>
    <ret_code>1001</ret_code>
    <exts>{&quot;k&quot;:&quot;v&quot;}</exts>
    <ret_msg>错误信息</ret_msg>
</alitrip_rentcar_btb_bill_notify_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部