# Create a room stay extra

This endpoint is used to create a new room stay extra.

Endpoint: POST /api/v3/roomStays/{id}/chargeableExtras
Version: 3.0.9
Security: OAuth2

## Path parameters:

  - `id` (integer, required)

## Request fields (application/json):

  - `id` (integer, required)
    The unique identifier of the room stay extra

  - `startDate` (string, required)
    Start date of the extra

  - `endDate` (string, required)
    End date of the extra

  - `guestId` (integer)
    Guest Id for the extra, if not specified the extra will be linked to the room stay

## Response 200 fields (application/json):

  - `id` (integer)
    The unique identifier of the room stay extra
    Example: 1

  - `description` (string, required)
    Description of the room stay extra

  - `product` (object)
    Product associated with the room stay extra

  - `product.id` (integer)
    Unique identifier of the product
    Example: 1

  - `product.productCode` (string)
    Code of the product
    Example: "PROD-001"

  - `product.name` (string)
    Name of the product
    Example: "Product 1"

  - `frequency` (string)
    Frequency of the chargeable extra
    Enum: "ONE_OFF", "DAILY", "WEEKLY", "MONTHLY"

  - `netPrice` (number)
    Net price of the room stay extra

  - `vatProfile` (object)
    VAT profile of the room stay extra

  - `vatProfile.id` (integer)
    The unique identifier of the VAT profile

  - `vatProfile.name` (string)
    The name of the VAT profile

  - `vatProfile.description` (string)
    The description of the VAT profile

  - `vatProfile.primaryProfile` (boolean)
    Indicates if this is the primary profile

  - `vatProfile.systemProfile` (boolean)
    Indicates if this is a system profile

  - `startDate` (string)
    Start date of the room stay extra

  - `endDate` (string)
    End date of the room stay extra

  - `lockToStay` (boolean)
    Indicates if the room stay extra is locked to stay

  - `status` (string)
    Status of the room stay extra
    Enum: "ACTIVE", "CANCELLING", "CANCELLED"

  - `vatInclusive` (boolean)
    Indicates if the VAT is inclusive

  - `extensionRequired` (boolean)
    Indicates if extension is required

  - `createCommission` (boolean)
    Indicates if commission creation is required

  - `organisationSettings` (object)
    Organisation settings

  - `organisationSettings.id` (integer)
    The unique identifier of the organisation settings
    Example: 1

  - `organisationSettings.name` (string)
    The name of the organisation
    Example: "Resharmonics"

  - `organisationSettings.currency` (object)
    The currency of the organisation

  - `organisationSettings.currency.id` (integer)
    Unique identifier of the currency

  - `organisationSettings.currency.name` (string)
    Name of the currency

  - `organisationSettings.currency.description` (string)
    Description of the currency

  - `organisationSettings.currency.symbol` (string)
    Symbol of the currency

  - `organisationSettings.currency.exchangeRate` (number)
    Exchange rate of the currency

  - `organisationSettings.currency.baseRate` (number)
    Base rate of the currency

  - `organisationSettings.currency.unit` (string)
    Unit of the currency

  - `organisationSettings.currency.autoUpdate` (boolean)
    Indicates if the currency is auto-updated

  - `organisationSettings.currency.primaryCurrency` (boolean)
    Indicates if this is the primary currency

  - `organisationSettings.currency.htmlSafeSymbol` (string)
    HTML safe symbol of the currency

  - `organisationSettings.country` (object)
    Data Transfer Object representing a Country entity in the Property Management System (PMS).

  - `organisationSettings.country.id` (integer)
    Unique identifier of the country

  - `organisationSettings.country.name` (string, required)
    Name of the country

  - `organisationSettings.country.sortOrder` (integer, required)
    Sort order of the country

  - `organisationSettings.country.countryCodeAlpha2` (string, required)
    Alpha-2 country code

  - `organisationSettings.country.countryCodeAlpha3` (string, required)
    Alpha-3 country code

  - `organisationSettings.country.countryCodeNumeric` (string, required)
    Numeric country code

  - `pricingModel` (string)
    Indicates which pricing model to be used for the room stay extra
    Enum: "UNIT_PRICE", "LINKED_TO_ROOM_RATE"

  - `percentageValue` (number)
    The percentage value of the room rate to be used if the room rate pricing model is enabled

  - `roomRateBasis` (string)
    Indicates if NET or GROSS room rate value is used if the room rate pricing model is enabled
    Enum: "GROSS", "NET"

  - `guestStay` (object)
    Guest stay associated with the issue

  - `guestStay.id` (integer)
    The unique identifier of the guest stay

  - `guestStay.contact` (object)

  - `guestStay.contact.id` (integer)
    Unique identifier of the contact

  - `guestStay.contact.firstName` (string)
    First name of the contact

  - `guestStay.contact.lastName` (string)
    Last name of the contact

  - `guestStay.dateFrom` (string)
    The start date of the guest stay

  - `guestStay.dateTo` (string)
    The end date of the guest stay