---
title: "Adds and directly posts a transitory charge to the folio. If there are any fees configured for the property, an additional charge for each configured fee will be added."
method: POST
path: "/finance/v0-nsfw/folio-actions/{folioId}/transitory-charges"
tags: ["FolioActions"]
---

# Adds and directly posts a transitory charge to the folio. If there are any fees configured for the property, an additional charge for each configured fee will be added.

`POST /finance/v0-nsfw/folio-actions/{folioId}/transitory-charges`

## Request

- Base URL: `https://api.apaleo.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.apaleo.com/finance/v0-nsfw/folio-actions/{folioId}/transitory-charges`
- Auth: OAuth 2
  - Implicit: `https://identity.apaleo.com/connect/authorize`
  - Scopes: `charges.create`, `folios.manage`, `admin`

Adds a transitory item for any good or service, and directly posts it. To be used for sales that are not revenue of the property,
but should appear on te guest's invoice.


Requires 'allowed action': AddCharge.<br>You must have at least one of these scopes: 'charges.create, folios.manage'.<br>For fine-grained clients, you must have this permission: 'core.folios.post_transitory_charge'.

## Path parameters

- `folioId` string, required

## Headers

- `Idempotency-Key` string

## Request body

- CreateTransitoryChargeModel
  - `name` string, required: The name, article number, or other description of this item
  - `amount` MonetaryValueModel, required
    - `amount` number, double, required
    - `currency` string, required
  - `receipt` string, nullable: Receipt for this transaction
  - `groupId` string, nullable: Identifier used for grouping related charges together
  - `serviceType` 'Other' | 'Accommodation' | 'FoodAndBeverages' | 'CityTax' | 'SecondCityTax', nullable: The service type. This is not used by accounting, but can be entered and stored on the charge.
  - `quantity` integer, nullable: The count of services provided. Defaults to 1. NOTE: this field will become required 07.05.2020.
  - `businessDate` string, date, nullable: The business date of the charge. Defaults to the current date. In some cases you might want to post the charges to the previous business date, this is only possible until 6 AM of the current day.

## Response `200`

Success.

- CreatedSubResourceIdModel
  - `id` string, required

## Other responses

- `400`: Bad request.
- `401`: You are unauthorized.
- `403`: Forbidden.
- `404`: The Request-URI could not be found.
- `415`: Unsupported media type.
- `422`: Validation errors in the request body or query params.
- `499`: Client closed request.
- `500`: An unexpected error occurred.
- `503`: The server is currently unavailable. Please try later.

---

[API](https://skmtc.dev/apaleo/apis/apaleo-finance-api-not-safe-for-work.md) - [All operations](https://skmtc.dev/apaleo/apis/apaleo-finance-api-not-safe-for-work/llms.txt) - [OpenAPI document](https://skmtc.dev/apaleo/apis/apaleo-finance-api-not-safe-for-work/revisions/72cbd31f02f4?raw)