# Create a fee invoice item for a room stay

Creates a new fee invoice item associated with a specific room stay. This endpoint allows you to apply various fees (such as late checkout fees, damage fees, etc.) to a room stay. The fee will be added as a sales invoice item on the room stay's billing account. If the specified room stay ID does not exist, a 404 Not Found error will be returned. In case of an unexpected system error, a 500 Internal Server Error will be triggered.

Endpoint: POST /api/v3/roomStays/{id}/fees
Version: 3.0.12
Security: X-Auth-Token

## Path parameters:

  - `id` (integer, required)
    The unique identifier of the room stay to which the fee will be applied

## Request fields (application/json):

  - `selectedFeeType` (object, required)
    Data transfer object representing a fee type that can be applied to room stays

  - `selectedFeeType.id` (integer)
    Unique identifier of the fee type
    Example: 123

  - `selectedFeeType.name` (string)
    Name of the fee type
    Example: "Late Checkout Fee"

  - `selectedFeeType.description` (string)
    Detailed description of the fee type
    Example: "Fee charged when guests check out after the standard checkout time"

  - `selectedFeeType.product` (object)
    The product associated with this fee type for accounting purposes

  - `selectedFeeType.product.id` (integer)

  - `selectedFeeType.product.productType` (string)
    Enum: "SALES", "PURCHASE"

  - `selectedFeeType.product.productCode` (string)

  - `selectedFeeType.product.name` (string)

  - `selectedFeeType.product.description` (string)

  - `selectedFeeType.product.nominalCode` (object)

  - `selectedFeeType.product.nominalCode.id` (integer)
    The unique identifier of the nominal code

  - `selectedFeeType.product.nominalCode.code` (string)
    The code of the nominal code

  - `selectedFeeType.product.nominalCode.description` (string)
    The description of the nominal code

  - `selectedFeeType.product.nominalCode.type` (string)
    The type of the nominal code
    Enum: "BANK", "CARD", "OWNER_LIABILITY", "PURCHASE", "SALES"

  - `selectedFeeType.product.nominalCode.currency` (object)
    The currency of the organisation

  - `selectedFeeType.product.nominalCode.currency.id` (integer)
    Unique identifier of the currency

  - `selectedFeeType.product.nominalCode.currency.name` (string)
    Name of the currency

  - `selectedFeeType.product.nominalCode.currency.description` (string)
    Description of the currency

  - `selectedFeeType.product.nominalCode.currency.symbol` (string)
    Symbol of the currency

  - `selectedFeeType.product.nominalCode.currency.exchangeRate` (number)
    Exchange rate of the currency

  - `selectedFeeType.product.nominalCode.currency.baseRate` (number)
    Base rate of the currency

  - `selectedFeeType.product.nominalCode.currency.unit` (string)
    Unit of the currency

  - `selectedFeeType.product.nominalCode.currency.autoUpdate` (boolean)
    Indicates if the currency is auto-updated

  - `selectedFeeType.product.nominalCode.currency.primaryCurrency` (boolean)
    Indicates if this is the primary currency

  - `selectedFeeType.product.nominalCode.currency.htmlSafeSymbol` (string)
    HTML safe symbol of the currency

  - `selectedFeeType.product.nominalCode.accountType` (string)
    The account type of the nominal code

  - `selectedFeeType.product.systemProduct` (boolean)

  - `selectedFeeType.product.descriptionTemplate` (string)

  - `selectedFeeType.product.useExtendedInvoiceDescription` (boolean)

  - `selectedFeeType.product.useUnitNameOnlyInvoiceDescription` (boolean)

  - `selectedFeeType.product.includeRoomstayDatesInvoiceDescription` (boolean)

  - `selectedFeeType.product.useChargeDatesInvoiceDescription` (boolean)

  - `selectedFeeType.product.invoiceWrapGroup` (string)

  - `selectedFeeType.product.defaultUnitPrice` (number)

  - `selectedFeeType.product.defaultVatProfile` (object)
    VAT profile

  - `selectedFeeType.product.defaultVatProfile.id` (integer)
    The unique identifier of the VAT profile

  - `selectedFeeType.product.defaultVatProfile.name` (string)
    The name of the VAT profile

  - `selectedFeeType.product.defaultVatProfile.description` (string)
    The description of the VAT profile

  - `selectedFeeType.product.defaultVatProfile.primaryProfile` (boolean)
    Indicates if this is the primary profile

  - `selectedFeeType.product.defaultVatProfile.systemProfile` (boolean)
    Indicates if this is a system profile

  - `selectedFeeType.product.defaultCurrency` (object)
    The currency of the organisation

  - `selectedFeeType.product.rollUpGroupName` (string)

  - `selectedFeeType.product.rollUpGroupDescription` (string)

  - `selectedFeeType.product.invoiceToLandlord` (boolean)

  - `selectedFeeType.product.unitManagementFee` (object)
    The product associated with this fee type for accounting purposes

  - `selectedFeeType.product.unitManagementFeeEnabled` (boolean)

  - `selectedFeeType.product.fiscalisationBlocked` (boolean)

  - `feeAmount` (number, required)
    The amount of the fee
    Example: 50

  - `vatProfile` (object, required)
    VAT profile

  - `startDate` (string, required)
    The start date of the fee period
    Example: "2025-01-01"

  - `endDate` (string, required)
    The end date of the fee period
    Example: "2025-01-02"

  - `description` (string, required)
    Description of the fee
    Example: "Late checkout fee"

  - `noteText` (string)
    Internal note text for the fee, if not specified, no note will be created
    Example: "Guest requested late checkout"

  - `noteCategory` (object)
    Category of the associated note, required if noteText is provided

  - `noteCategory.id` (integer)
    Unique identifier of the note category

  - `noteCategory.name` (string)
    Name of the note category

  - `noteCategory.defaultCategory` (boolean)
    Indicates if this is the default category

  - `noteCategory.buildingLimit` (integer)

  - `noteCategory.nameLowercase` (string)

  - `noteCategory.default` (integer)

## Response 200 fields (application/json):

  - `id` (integer)
    ID of the sales invoice item

  - `uuid` (string)
    UUID of the sales invoice item

  - `salesInvoice` (object)
    Summary of the sales invoice

  - `salesInvoice.id` (integer)
    The unique identifier of the sales invoice
    Example: 1

  - `salesInvoice.salesInvoiceNumber` (integer)
    Ordering for the sales ledger
    Example: 1001

  - `salesInvoice.type` (string, required)
    Type of the sales invoice
    Enum: "SALES_INVOICE", "SALES_CREDIT"

  - `salesInvoice.invoiceDate` (string, required)
    Date of the invoice
    Example: "2023-10-01"

  - `salesInvoice.dueDate` (string, required)
    Due date of the invoice
    Example: "2023-10-15"

  - `description` (string)
    Description of the sales invoice item

  - `comment1` (string)
    First comment

  - `comment2` (string)
    Second comment

  - `currency` (object)
    Base currency details of the invoice

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

  - `currency.name` (string)
    Name of the currency
    Example: "US Dollar"

  - `baseCurrency` (object)
    Base currency details of the invoice

  - `type` (string)
    Type of the invoice
    Enum: "SALES_INVOICE", "SALES_CREDIT"

  - `unitPrice` (number)
    Unit price

  - `baseUnitPrice` (number)
    Base unit price

  - `reportingUnitPrice` (number)
    Reporting unit price

  - `quantity` (number)
    Quantity

  - `gross` (number)
    Gross amount

  - `baseGross` (number)
    Base gross amount

  - `reportingGross` (number)
    Reporting gross amount

  - `net` (number)
    Net amount

  - `baseNet` (number)
    Base net amount

  - `reportingNet` (number)
    Reporting net amount

  - `tax` (number)
    Tax amount

  - `baseTax` (number)
    Base tax amount

  - `reportingTax` (number)
    Reporting tax amount

  - `taxRate` (number)
    Tax rate

  - `taxCode` (object)
    Tax code details

  - `taxCode.id` (integer)
    The unique identifier of the tax code
    Example: 1

  - `taxCode.type` (string, required)
    Type of the tax code
    Enum: "SALES", "PURCHASE"

  - `taxCode.code` (string, required)
    Code of the tax code

  - `taxCode.name` (string, required)
    Name of the tax code

  - `taxCode.rate` (number, required)
    Rate of the tax code

  - `taxCode.xeroTaxType` (string)
    Xero tax type of the tax code

  - `taxCode.exportName` (string)
    Export name of the tax code

  - `chargeFrom` (string)
    Charge start date

  - `chargeTo` (string)
    Charge end date

  - `dueDate` (string)
    Due date

  - `invoiceDate` (string)
    Invoice date

  - `financeAccount` (object)
    Finance account details

  - `financeAccount.id` (integer)
    Unique identifier of the finance account

  - `financeAccount.accountCode` (string)
    Account code of the finance account

  - `financeAccount.contact` (object)

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

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

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

  - `financeAccount.company` (object)
    Company summary associated with the finance account

  - `financeAccount.company.id` (integer)
    Unique identifier of the company

  - `financeAccount.company.companyName` (string)
    Name of the company

  - `financeAccount.externalId` (string)
    External identifier of the finance account

  - `financeAccount.exportedDate` (string)
    Date when the finance account was exported

  - `financeAccount.exportStatus` (string)
    Export status of the finance account
    Enum: "SKIPPED", "CREATED", "PENDING", "SENT", "EXPORTED", "FAILED", "IMPORTED"

  - `product` (object)
    Accommodation product summary

  - `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"

  - `product.invoiceWrapGroup` (string)
    Wrapping group of the product
    Example: "Rentals"

  - `nominalCode` (object)

  - `nominalCode.id` (integer)
    The unique identifier of the nominal code

  - `nominalCode.code` (string)
    The code of the nominal code

  - `nominalCode.description` (string)
    The description of the nominal code

  - `nominalCode.type` (string)
    The type of the nominal code
    Enum: "BANK", "CARD", "OWNER_LIABILITY", "PURCHASE", "SALES"

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

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

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

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

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

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

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

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

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

  - `nominalCode.accountType` (string)
    The account type of the nominal code

  - `ourReference` (string)
    Our reference

  - `status` (string)
    Status of the invoice item
    Enum: "DRAFT", "VOID", "POSTED"

  - `roomStay` (object)
    Extension of original room stay summary

  - `roomStay.id` (integer)
    Unique identifier of the room stay

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

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

  - `roomStay.roomStayStatus` (string)
    Status of the room stay
    Enum: "ENQUIRY", "QUOTED", "PENDING", "MEDIATION_REQUIRED", "CONFIRMED", "CHECKED_IN", "CHECKED_OUT", "COMPLETE", "CANCELLED", "LOST"

  - `roomStay.netAmount` (number)
    Net amount for the room stay

  - `roomStay.vatAmount` (number)
    VAT amount for the room stay

  - `roomStay.numberOfAdults` (integer)
    Number of adults in the room stay

  - `roomStay.numberOfChildren` (integer)
    Number of children in the room stay

  - `roomStay.numberOfInfants` (integer)
    Number of infants in the room stay

  - `unit` (object)
    Summary of the Unit associated with the Unit Access Group

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

  - `unit.name` (string)
    Name of the unit
    Example: "Apartment 101"

  - `unitPriceIncludesTax` (boolean)
    Indicates if unit price includes tax

  - `amountPaid` (number)
    Amount paid