---
title: "Replace the options a provider offers for one of its sections"
method: PUT
path: "/fiscal-document/v1/fiscalization/providers/{providerId}/{sectionKey}/options"
tags: ["Fiscal Connection Config"]
---

# Replace the options a provider offers for one of its sections

`PUT /fiscal-document/v1/fiscalization/providers/{providerId}/{sectionKey}/options`

## Request

- Base URL: `https://api.cloudbeds.com`
- URL: `https://api.cloudbeds.com/fiscal-document/v1/fiscalization/providers/{providerId}/{sectionKey}/options`
- Auth: HTTP bearer

Partner-facing. Replaces the selectable options this provider offers in one scope, so a hotelier can map Cloudbeds data onto the partner's own values in the Cloudbeds UI. Omit connectionId for a catalogue that is the same for every property; send it when the values differ per customer account. Values dropped from a later push are deactivated, not deleted, so mappings already made against them keep their label. Restricted to the OAuth client registered for the provider. X-PROPERTY-ID is required even for a provider-wide push and must identify a property covered by the token's consent. A supplied connectionId must belong to this provider and a property covered by the token's resources claim.

## Path parameters

- `providerId` string, required
- `sectionKey` string, required

## Headers

- `X-Property-ID` integer, required

## Request body

- ProviderOptionsReplaceRequest
  - `connectionId` integer, nullable: Scope of the replacement. Omit for the provider's catalogue across every property; send a connection id when the values belong to a single customer account.
  - `options` ProviderOption[], required: The full list for this scope, in display order; anything not listed is deactivated. Active options are served before retired options, with connection-scoped options before provider-wide options of the same active status.
    - `value` string, required: Stored on the mapping and echoed back to the provider unchanged. Maximum 32 characters for taxCodes and paymentMethods, 128 for series, matching their mapping columns; 255 for other sections.
    - `label` string, required: What the hotelier sees in the dropdown.
    - `group` string, nullable: Slot within the section this option is offered for. Series are offered per document type, so send the document kind here to have the option appear only against that document. Omit for an option that applies to the whole section, which is how taxes and payment methods are offered.

## Response `200`

OK

- ProviderOptionsReplaceResponse
  - `providerId` string, required
  - `sectionKey` string, required
  - `connectionId` integer, nullable
  - `count` integer, required: Number of options now offered in this scope.

## Other responses

- `400`: Bad Request
- `403`: Access denied
- `404`: Not found

---

[API](https://skmtc.dev/cloudbeds/apis/fiscal-document-service-api.md) - [All operations](https://skmtc.dev/cloudbeds/apis/fiscal-document-service-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cloudbeds/apis/fiscal-document-service-api/revisions/9c2a47775e5e?raw)