淘宝开放平台

登录
文档中心 > API类目 > 飞猪-综合交通api

飞猪-综合交通api

alitrip.rentcar.commodity.store.rule.change.notify (商品库门店规则变更推送)

门店规则信息变更推送；每当门店规则信息变更时推送变更门店规则信息到飞猪，飞猪将同步更新对应内容。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
extra Json 可选 {} 额外字段
store_rule_info_list PutStoreRuleInfo 可选 门店规则信息列表
  • forbidden_drive_list
  • ForbiddenDrive []
  • 可选
  • 见列表内容
  • 禁行规则，同一个禁行类型和禁行区域，生效时间不得重叠；此外，同一时间段内，禁止驶出区域不能包含禁止驶入区域(两个区域相同也不可以)
  • └ effect_start_time
  • String
  • 可选
  • 2024-03-09
  • 生效开始时间，yyyy-MM-dd类型，仅当effectType为2时有效
  • └ forbidden_type
  • Number
  • 可选
  • 1
  • 禁行类型，1-禁止驶入，2-禁止驶出
  • └ forbidden_city_code
  • String
  • 可选
  • 110000,230000
  • 禁行类型城市Code，使用供应商城市divisionCode，多个使用逗号分隔
  • └ effect_end_time
  • String
  • 可选
  • 2024-04-09
  • 生效截止时间，yyyy-MM-dd类型，仅当effectType为2时有效
  • └ effect_type
  • Number
  • 可选
  • 1
  • 1-永久有效，2-一段时间有效
  • └ status
  • Number
  • 可选
  • 1
  • 禁行状态，0启用,1禁用，整数
  • invoice_rule
  • ProductInvoiceRule
  • 可选
  • 发票规则
  • └ invoice_content
  • Number
  • 可选
  • 1
  • 发票内容，1-旅游服务费，2-代收租车费，3-旅游费，4-约车服务费，5-服务费，6-包车费，7-客运服务费，8-租车费，9-团款
  • └ invoice_freight_type
  • Number
  • 可选
  • 1
  • 发票运费类型，1-免运费，2-运费到付，3-全国一口价
  • └ invoice_type
  • Number
  • 可选
  • 1
  • 发票类型，1-电子发票，2-纸质发票，整数
  • └ freight_price
  • String
  • 可选
  • 20.00
  • 一口价价格,单位元（invoice_freight_type=3才有值）
  • road_assist_list
  • RoadAssist []
  • 可选
  • 见列表内容
  • 道路救援
  • └ service_charge
  • Number
  • 可选
  • 200
  • 收费，整数，单位元/次
  • └ assist_type
  • Number
  • 可选
  • 3
  • 救援类型，1-紧急送油，2-现场抢修，3-搭电服务，4-紧急加水，5-送备用钥匙
  • └ service_range
  • Number
  • 可选
  • 50
  • 距离门店服务范围，整数，单位公里，e.g:距离门店50公里内
  • pickup_materials
  • PickupMaterials
  • 可选
  • 取车材料
  • └ id_valid_month
  • Number
  • 可选
  • 12
  • 证件最小有效期，整数，单位月
  • └ id_type
  • String
  • 可选
  • 1,2,3,4,5,6
  • 证件类型，0:身份证,1:护照,2:学生证,3:军官证,4:回乡证,5:台胞证,6:港澳通行证,7:国际海员,8:外国人永久居留(身份)证,9:其他证件,10:警官证,11:士兵证,12:台湾通行证,13:入台证,14:户口本,15:出生日期,16:驾驶证,17:港澳居民居住证,18:台湾居民居住证,多个证件类型使用逗号分隔
  • └ deposit_pay_type
  • String
  • 可选
  • 1,2,3
  • 押金支付方式，1-信用卡，2-支付宝及其他在线支付工具，3-现金，多个押金支付方式使用逗号分隔
  • └ credit_card_valid_month
  • Number
  • 可选
  • 5
  • 信用卡最小有效期，整数，单位月
  • └ min_driver_age
  • Number
  • 可选
  • 18
  • 最小驾驶人年龄(含)，整数，单位岁
  • └ min_drive_experience
  • Number
  • 可选
  • 10
  • 最小驾龄，整数，单位月
  • └ max_driver_age
  • Number
  • 可选
  • 70
  • 最大驾驶人年龄(含)，整数，单位岁
  • └ drive_license_expiry_date
  • Number
  • 可选
  • 4
  • 驾驶证最小有效期，整数，单位月
  • └ store_code
  • String
  • 必须
  • 122
  • 供应商门店唯一标识
  • └ rule_code
  • String
  • 必须
  • 122
  • 供应商规则唯一标识，每个门店仅包含1个规则
  • cancel_rule_list
  • ProductCancelRule []
  • 可选
  • 见列表内容
  • 取消规则，所有节假日取消规则按照当年节假日为准，如果此节假日已过，则同步下年此节假日规则，如果此规则日期还未公布，可不传
  • └ date_type
  • Number
  • 可选
  • 5
  • 取消规则类型，0-平日，1-元旦，2-春节，3-清明节，4-劳动节，5-端午节，6-中秋节，7-国庆节，8-自定义，整体规则分为节假日，自定义和平日取消规则，平日取消规则即兜底规则，未命中自定义和节假日规则时，以平日规则为准
  • └ cancel_charge_type
  • Number
  • 可选
  • 1
  • 取车时间前取消类型：1-按照取消时间距离取车时间，收取订单金额百分比，2-取车时间之前均为免费取消
  • └ start_time
  • String
  • 可选
  • 2024-06-08
  • 起始时间，格式yyyy-MM-dd，时间集合不得重叠，dateType为0时，不需要传递
  • └ end_time
  • String
  • 可选
  • 2024-06-10
  • 结束时间，格式yyyy-MM-dd，时间集合不得重叠，dateType为0时，不需要传递
  • └ noshow_charge_pt
  • Number
  • 可选
  • 30
  • 超时未取车时，取消收费百分比，整数，单位百分比
  • cancel_charge
  • CancelCharge
  • 可选
  • 取消收费规则，仅当 cancelChargeType 为1时需要传
  • pick_up_charge_list
  • PickUpCharge []
  • 可选
  • 见列表内容
  • 收费时间段，e.g [{pickUpChargeBeginHours: 0, pickUpChargeFeePercent: 100}, {pickUpChargeBeginHours: 4, pickUpChargeFeePercent: 50}]
  • └ pick_up_charge_begin_hours
  • Number
  • 可选
  • 3
  • 取车前n小时，n取整数，单位小时
  • └ pick_up_charge_fee_percent
  • Number
  • 可选
  • 30
  • 在此时间段之内需要收费百分比x，x取整数，单位百分比
  • └ pick_up_free_hours
  • Number
  • 可选
  • 4
  • 取车时间前n小时之前的时间段取消免费。此处需传n，整数，单位小时
  • energy_service_fee
  • EnergyServiceFee
  • 可选
  • 能源服务费
  • └ oil_service_fee
  • String
  • 可选
  • 30.00
  • 充电服务费，保留两位小数，单位元
  • └ battery_service_fee
  • String
  • 可选
  • 20.00
  • 加油服务费，保留两位小数，单位元
  • deposit_deduction_policy
  • DepositDeductionPolicy
  • 可选
  • 押金扣费标准
  • vehicle_item_loss_info_list
  • VehicleItemLossInfo []
  • 可选
  • 见列表内容
  • 随车物品损失扣费规则
  • vehicle_item_loss_price_info_list
  • VehiclePriceInfo []
  • 可选
  • 1
  • 维修金额列表，每个type都需要传递
  • └ price
  • Number
  • 可选
  • 200
  • 费用金额，单位元
  • └ type
  • Number
  • 可选
  • 1
  • 车辆金额类型，1:十万以内;2:十万-二十万;3:二十万-三十万;4:大于三十万
  • └ type
  • Number
  • 可选
  • 1
  • 遗失或损坏项目，101，三角警示牌102，千斤顶103，工具包104，灭火器105，音响喇叭（扬声器）106，遮阳板107，车内后视镜108，雨刷片109，车辆钥匙（需换全车锁）110，行驶证（含登报费）111，标贴（环保，年检，交强）112，附加税证/标（含登报费）113，车辆牌照（含登报费）
  • violation_dealing
  • ViolationDealing
  • 可选
  • 违章处理标准
  • illegal_deduct_rule
  • IllegalDeductRule
  • 可选
  • 违章扣款规则
  • └ late_processing_penalty
  • Number
  • 可选
  • 200
  • 客户逾期处理违约金，整数，单位元/天
  • drive_license_lending
  • DriveLicenseLending
  • 可选
  • 驾驶证借用规则
  • └ diff_city_lending_availability_time
  • Number
  • 可选
  • 48
  • 异地可借用时间，整数，单位小时
  • └ same_city_lending_availability_time
  • Number
  • 可选
  • 8
  • 同城可借用时间，整数，单位小时
  • └ lending_drive_license_deposit
  • Number
  • 可选
  • 400
  • 借用行驶证押金，整数，单位元
  • └ lending_advance_booking_time
  • Number
  • 可选
  • 9
  • 通知违章后的行驶证借用申请时间，整数，单位天
  • notify_detail
  • NotifyDetail
  • 可选
  • 违章通知及客户处理时限
  • └ audit_time
  • Number
  • 可选
  • 1
  • (字段已废弃，无需传递)车行审核违章时效，整数，单位天
  • └ user_deal_time
  • Number
  • 可选
  • 2
  • 客户处理时效，整数，单位天
  • └ notify_user_time
  • Number
  • 可选
  • 3
  • 实际还车后通知客户违章的时效，整数，单位天
  • vehicle_damage_info_list
  • VehicleDamageInfo []
  • 可选
  • 见列表内容
  • 车辆损失扣费规则
  • vehicle_damage_price_info_list
  • VehiclePriceInfo []
  • 可选
  • 1
  • 维修金额列表，每个type都需要传递
  • └ price
  • Number
  • 可选
  • 200
  • 费用金额，单位元
  • └ type
  • Number
  • 可选
  • 1
  • 车辆金额类型，1:十万以内;2:十万-二十万;3:二十万-三十万;4:大于三十万
  • └ type
  • Number
  • 可选
  • 101
  • 维修或更换项目，101，维修保险杠(前、后)，102，维修前叶子板，103，维修前机盖，104，维修前风挡立柱，105，维修车门总成，106，维修反光镜总成，107，维修中门立柱，108，维修车顶，109，维修底大边、后围，110，维修后叶子板，111，维修后备箱盖，112，维修轮毂(灰色铝合金质地)，201，更换保险杠(前、后)，202，更换前叶子板，203，更换前机盖，204，更换前风挡立柱，205，更换车门总成，206，更换反光镜镜片，207，更换反光镜总成，208，更换中门立柱，209，更换车顶，210，更换底大边、后围，211，更换后叶子板，212，更换后备箱盖，213，更换前大灯总成，214，更换尾灯总成，215，更换侧转向灯总成，216，更换轮毂盖，217，更换轮毂(黑色铁质地)，218，更换轮毂(灰色铝合金质地)，219，更换钥匙(机械)，220，更换雾灯总成，221，更换轮胎，222，更换轮胎(漏气保用)，223，更换前挡风玻璃
  • scattered_hours_list
  • ScatteredHours []
  • 可选
  • 见列表内容
  • 零散小时收费规则，每一个零散小时项必须连续，从0-24覆盖完毕
  • └ end_hour
  • Number
  • 可选
  • 3
  • 结束小时数
  • └ charge_fee
  • Number
  • 可选
  • 30
  • 表示零散小时符合此时间段时，收费整天金额的百分比，整数，单位百分比
  • └ start_hour
  • Number
  • 可选
  • 0
  • 开始小时数

响应参数

名称 类型 示例值 描述
message_code Number 0 错误码
message String 错误信息 错误信息

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripRentcarCommodityStoreRuleChangeNotifyRequest req = new AlitripRentcarCommodityStoreRuleChangeNotifyRequest();
req.setExtraString("{}");
AlitripRentcarCommodityStoreRuleChangeNotifyRequest.PutStoreRuleInfo obj1 = new AlitripRentcarCommodityStoreRuleChangeNotifyRequest.PutStoreRuleInfo();
List<AlitripRentcarCommodityStoreRuleChangeNotifyRequest.ForbiddenDrive> list3 = new ArrayList<AlitripRentcarCommodityStoreRuleChangeNotifyRequest.ForbiddenDrive>();
AlitripRentcarCommodityStoreRuleChangeNotifyRequest.ForbiddenDrive obj4 = new AlitripRentcarCommodityStoreRuleChangeNotifyRequest.ForbiddenDrive();
list3.add(obj4);
obj4.setEffectStartTime("2024-03-09");
obj4.setForbiddenType(1L);
obj4.setForbiddenCityCode("110000,230000");
obj4.setEffectEndTime("2024-04-09");
obj4.setEffectType(1L);
obj4.setStatus(1L);
obj1.setForbiddenDriveList(list3);
AlitripRentcarCommodityStoreRuleChangeNotifyRequest.ProductInvoiceRule obj5 = new AlitripRentcarCommodityStoreRuleChangeNotifyRequest.ProductInvoiceRule();
obj5.setInvoiceContent(1L);
obj5.setInvoiceFreightType(1L);
obj5.setInvoiceType(1L);
obj5.setFreightPrice("20.00");
obj1.setInvoiceRule(obj5);
List<AlitripRentcarCommodityStoreRuleChangeNotifyRequest.RoadAssist> list7 = new ArrayList<AlitripRentcarCommodityStoreRuleChangeNotifyRequest.RoadAssist>();
AlitripRentcarCommodityStoreRuleChangeNotifyRequest.RoadAssist obj8 = new AlitripRentcarCommodityStoreRuleChangeNotifyRequest.RoadAssist();
list7.add(obj8);
obj8.setServiceCharge(200L);
obj8.setAssistType(3L);
obj8.setServiceRange(50L);
obj1.setRoadAssistList(list7);
AlitripRentcarCommodityStoreRuleChangeNotifyRequest.PickupMaterials obj9 = new AlitripRentcarCommodityStoreRuleChangeNotifyRequest.PickupMaterials();
obj9.setIdValidMonth(12L);
obj9.setIdType("1,2,3,4,5,6");
obj9.setDepositPayType("1,2,3");
obj9.setCreditCardValidMonth(5L);
obj9.setMinDriverAge(18L);
obj9.setMinDriveExperience(10L);
obj9.setMaxDriverAge(70L);
obj9.setDriveLicenseExpiryDate(4L);
obj1.setPickupMaterials(obj9);
obj1.setStoreCode("122");
obj1.setRuleCode("122");
List<AlitripRentcarCommodityStoreRuleChangeNotifyRequest.ProductCancelRule> list11 = new ArrayList<AlitripRentcarCommodityStoreRuleChangeNotifyRequest.ProductCancelRule>();
AlitripRentcarCommodityStoreRuleChangeNotifyRequest.ProductCancelRule obj12 = new AlitripRentcarCommodityStoreRuleChangeNotifyRequest.ProductCancelRule();
list11.add(obj12);
obj12.setDateType(5L);
obj12.setCancelChargeType(1L);
obj12.setStartTime("2024-06-08");
obj12.setEndTime("2024-06-10");
obj12.setNoshowChargePt(30L);
AlitripRentcarCommodityStoreRuleChangeNotifyRequest.CancelCharge obj14 = new AlitripRentcarCommodityStoreRuleChangeNotifyRequest.CancelCharge();
List<AlitripRentcarCommodityStoreRuleChangeNotifyRequest.PickUpCharge> list16 = new ArrayList<AlitripRentcarCommodityStoreRuleChangeNotifyRequest.PickUpCharge>();
AlitripRentcarCommodityStoreRuleChangeNotifyRequest.PickUpCharge obj17 = new AlitripRentcarCommodityStoreRuleChangeNotifyRequest.PickUpCharge();
list16.add(obj17);
obj17.setPickUpChargeBeginHours(3L);
obj17.setPickUpChargeFeePercent(30L);
obj14.setPickUpChargeList(list16);
obj14.setPickUpFreeHours(4L);
list13.setCancelCharge(obj14);
obj1.setCancelRuleList(list11);
AlitripRentcarCommodityStoreRuleChangeNotifyRequest.EnergyServiceFee obj18 = new AlitripRentcarCommodityStoreRuleChangeNotifyRequest.EnergyServiceFee();
obj18.setOilServiceFee("30.00");
obj18.setBatteryServiceFee("20.00");
obj1.setEnergyServiceFee(obj18);
AlitripRentcarCommodityStoreRuleChangeNotifyRequest.DepositDeductionPolicy obj19 = new AlitripRentcarCommodityStoreRuleChangeNotifyRequest.DepositDeductionPolicy();
List<AlitripRentcarCommodityStoreRuleChangeNotifyRequest.VehicleItemLossInfo> list21 = new ArrayList<AlitripRentcarCommodityStoreRuleChangeNotifyRequest.VehicleItemLossInfo>();
AlitripRentcarCommodityStoreRuleChangeNotifyRequest.VehicleItemLossInfo obj22 = new AlitripRentcarCommodityStoreRuleChangeNotifyRequest.VehicleItemLossInfo();
list21.add(obj22);
List<AlitripRentcarCommodityStoreRuleChangeNotifyRequest.VehiclePriceInfo> list25 = new ArrayList<AlitripRentcarCommodityStoreRuleChangeNotifyRequest.VehiclePriceInfo>();
AlitripRentcarCommodityStoreRuleChangeNotifyRequest.VehiclePriceInfo obj26 = new AlitripRentcarCommodityStoreRuleChangeNotifyRequest.VehiclePriceInfo();
list25.add(obj26);
obj26.setPrice(200L);
obj26.setType(1L);
list23.setVehicleItemLossPriceInfoList(list25);
obj22.setType(1L);
obj19.setVehicleItemLossInfoList(list21);
AlitripRentcarCommodityStoreRuleChangeNotifyRequest.ViolationDealing obj27 = new AlitripRentcarCommodityStoreRuleChangeNotifyRequest.ViolationDealing();
AlitripRentcarCommodityStoreRuleChangeNotifyRequest.IllegalDeductRule obj28 = new AlitripRentcarCommodityStoreRuleChangeNotifyRequest.IllegalDeductRule();
obj28.setLateProcessingPenalty(200L);
obj27.setIllegalDeductRule(obj28);
AlitripRentcarCommodityStoreRuleChangeNotifyRequest.DriveLicenseLending obj29 = new AlitripRentcarCommodityStoreRuleChangeNotifyRequest.DriveLicenseLending();
obj29.setDiffCityLendingAvailabilityTime(48L);
obj29.setSameCityLendingAvailabilityTime(8L);
obj29.setLendingDriveLicenseDeposit(400L);
obj29.setLendingAdvanceBookingTime(9L);
obj27.setDriveLicenseLending(obj29);
AlitripRentcarCommodityStoreRuleChangeNotifyRequest.NotifyDetail obj30 = new AlitripRentcarCommodityStoreRuleChangeNotifyRequest.NotifyDetail();
obj30.setAuditTime(1L);
obj30.setUserDealTime(2L);
obj30.setNotifyUserTime(3L);
obj27.setNotifyDetail(obj30);
obj19.setViolationDealing(obj27);
List<AlitripRentcarCommodityStoreRuleChangeNotifyRequest.VehicleDamageInfo> list32 = new ArrayList<AlitripRentcarCommodityStoreRuleChangeNotifyRequest.VehicleDamageInfo>();
AlitripRentcarCommodityStoreRuleChangeNotifyRequest.VehicleDamageInfo obj33 = new AlitripRentcarCommodityStoreRuleChangeNotifyRequest.VehicleDamageInfo();
list32.add(obj33);
List<AlitripRentcarCommodityStoreRuleChangeNotifyRequest.VehiclePriceInfo> list36 = new ArrayList<AlitripRentcarCommodityStoreRuleChangeNotifyRequest.VehiclePriceInfo>();
AlitripRentcarCommodityStoreRuleChangeNotifyRequest.VehiclePriceInfo obj37 = new AlitripRentcarCommodityStoreRuleChangeNotifyRequest.VehiclePriceInfo();
list36.add(obj37);
obj37.setPrice(200L);
obj37.setType(1L);
list34.setVehicleDamagePriceInfoList(list36);
obj33.setType(101L);
obj19.setVehicleDamageInfoList(list32);
obj1.setDepositDeductionPolicy(obj19);
List<AlitripRentcarCommodityStoreRuleChangeNotifyRequest.ScatteredHours> list39 = new ArrayList<AlitripRentcarCommodityStoreRuleChangeNotifyRequest.ScatteredHours>();
AlitripRentcarCommodityStoreRuleChangeNotifyRequest.ScatteredHours obj40 = new AlitripRentcarCommodityStoreRuleChangeNotifyRequest.ScatteredHours();
list39.add(obj40);
obj40.setEndHour(3L);
obj40.setChargeFee(30L);
obj40.setStartHour(0L);
obj1.setScatteredHoursList(list39);
req.setStoreRuleInfoList(obj1);
AlitripRentcarCommodityStoreRuleChangeNotifyResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alitrip_rentcar_commodity_store_rule_change_notify_response>
    <message_code>0</message_code>
    <message>错误信息</message>
</alitrip_rentcar_commodity_store_rule_change_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测试工具 错误码查询工具 SDK下载

如何获得此API

FAQ

我要提问
返回
顶部