Extra Costs

Update the extra costs of an apartment

post/v2/apartments/extracosts

Request

  • Base URL: https://provider-api-sandbox.holidu.com
  • URL: https://provider-api-sandbox.holidu.com/v2/apartments/extracosts
  • Auth: API key in header api-key

Query parameters

providerApartmentIdstring
providerstring
holiduApartmentIdinteger

Request body

idstring required

An identifier for this extra cost

name'FINAL_CLEANING' | 'EXTRA_CLEANING' | 'REFUNDABLE_SECURITY_DEPOSIT' | 'TOURIST_OR_CITY_TAX' | 'VAT_OF_RENTAL_PRICE' | 'BOOKING_FEE' | 'HYGIENE_SURCHARGE' | 'PET' | 'TRAVEL_INSURANCE' | 'TOWEL' | 'BEDLINEN' | 'TOWEL_BEDLINEN_PACKAGE' | 'KITCHEN_TOWELS' | 'BEDLINEN_AND_BEDMAKING' | 'BABY_BED' | 'BABY_CHAIR' | 'BABY_COT' | 'BABY_BUGGY' | 'BABY_HIGH_CHAIR' | 'EXTRA_BED' | 'HEATING' | 'AIRCONDITION' | 'FIREWOOD' | 'ELECTRICITY' | 'WATER' | 'GAS' | 'SAUNA' | 'POOL' | 'HOT_TUB' | 'WASHING_MACHINE' | 'BEACH_SERVICES' | 'CLUB_CARD' | 'INTERNET' | 'PARKING' | 'AIRPORT_SHUTTLE' | 'BREAKFAST' | 'SERVICE_COSTS' required

Name of extra cost

basisOfCalculation'PER_STAY' | 'PER_PERSON_PER_NIGHT' | 'PER_NIGHT' | 'PER_PERSON' | 'PER_UNIT' | 'PER_UNIT_PER_NIGHT' required

How is cost is calculated

maximumCountinteger

Maximum units that can be selected for this extra service if the service is selectable

type'MANDATORY' | 'SELECTABLE' | 'ON_USAGE' required

Type of service associated with this extra cost

paymentTime'ON_BOOKING' | 'WITH_RATES' | 'ONSITE' required

Payment time of extra cost

Example request

[
  {
    "id": "XYZ_123",
    "name": "BEDLINEN",
    "basisOfCalculation": "PER_PERSON_PER_NIGHT",
    "maximumCount": 1,
    "type": "MANDATORY",
    "paymentTime": "ONSITE",
    "price": {
      "type": "PERCENTAGE",
      "amount": 90.24,
      "currency": "EUR"
    },
    "condition": {
      "seasonApplicable": {
        "onlyApplicableFrom": "2020-08-01",
        "onlyApplicableUntil": "2021-04-30"
      },
      "numberOfNights": {
        "fromStayLengthInNights": 1,
        "toStayLengthInNights": 7
      }
    }
  }
]

Response

Successful update of extra costs for apartment

idstring required

An identifier for this extra cost

name'FINAL_CLEANING' | 'EXTRA_CLEANING' | 'REFUNDABLE_SECURITY_DEPOSIT' | 'TOURIST_OR_CITY_TAX' | 'VAT_OF_RENTAL_PRICE' | 'BOOKING_FEE' | 'HYGIENE_SURCHARGE' | 'PET' | 'TRAVEL_INSURANCE' | 'TOWEL' | 'BEDLINEN' | 'TOWEL_BEDLINEN_PACKAGE' | 'KITCHEN_TOWELS' | 'BEDLINEN_AND_BEDMAKING' | 'BABY_BED' | 'BABY_CHAIR' | 'BABY_COT' | 'BABY_BUGGY' | 'BABY_HIGH_CHAIR' | 'EXTRA_BED' | 'HEATING' | 'AIRCONDITION' | 'FIREWOOD' | 'ELECTRICITY' | 'WATER' | 'GAS' | 'SAUNA' | 'POOL' | 'HOT_TUB' | 'WASHING_MACHINE' | 'BEACH_SERVICES' | 'CLUB_CARD' | 'INTERNET' | 'PARKING' | 'AIRPORT_SHUTTLE' | 'BREAKFAST' | 'SERVICE_COSTS' required

Name of extra cost

basisOfCalculation'PER_STAY' | 'PER_PERSON_PER_NIGHT' | 'PER_NIGHT' | 'PER_PERSON' | 'PER_UNIT' | 'PER_UNIT_PER_NIGHT' required

How is cost is calculated

maximumCountinteger

Maximum units that can be selected for this extra service if the service is selectable

type'MANDATORY' | 'SELECTABLE' | 'ON_USAGE' required

Type of service associated with this extra cost

paymentTime'ON_BOOKING' | 'WITH_RATES' | 'ONSITE' required

Payment time of extra cost

Example response

[
  {
    "id": "XYZ_123",
    "name": "BEDLINEN",
    "basisOfCalculation": "PER_PERSON_PER_NIGHT",
    "maximumCount": 1,
    "type": "MANDATORY",
    "paymentTime": "ONSITE",
    "price": {
      "type": "PERCENTAGE",
      "amount": 90.24,
      "currency": "EUR"
    },
    "condition": {
      "seasonApplicable": {
        "onlyApplicableFrom": "2020-08-01",
        "onlyApplicableUntil": "2021-04-30"
      },
      "numberOfNights": {
        "fromStayLengthInNights": 1,
        "toStayLengthInNights": 7
      }
    }
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.