---
title: "Update fiscal operator mappings for a property"
method: PUT
path: "/fiscal-document/v1/fiscalization/operators"
tags: ["Fiscalization"]
---

# Update fiscal operator mappings for a property

`PUT /fiscal-document/v1/fiscalization/operators`

Replaces the property's full list of operator mappings. Each entry must reference
a user assigned to the property and carry a syntactically valid OIB.

## Headers

- `X-Property-ID` integer, required

## Request body

- FiscalizationOperatorRequest
  - `partnerId` integer — Optional scope to a specific partner instance on a multi-partner property. Omit on single-partner properties (legacy behavior).
  - `operators` FiscalizationOperatorMappingInput[]
    - `userId` string, required
    - `legalId` string, required
    - `legalName` string, required
  - `fallbackOperator` FiscalizationFallbackOperator — Property-level fallback operator used when an invoice-issuing user has no per-user mapping. Optional — when absent, unmapped users get a hard error at submission time.
    - `legalId` string, required
    - `legalName` string, required

## Response `200`

Operator mappings saved successfully

- FiscalizationOperatorResponse
  - `operators` FiscalizationOperator[]
    - `user` FiscalizationOperatorUser, required
      - `id` string, required — Cloudbeds user ID
      - `email` string
      - `firstName` string
      - `lastName` string
      - `active` boolean — Cloudbeds user active state (from user service). Inactive users may still have a stored mapping but should be visually flagged in the UI.
    - `legalId` string — Operator legal identifier (e.g., HR OIB, IT codice fiscale). Null when not mapped.
    - `legalName` string — Legal name sent as operator.legal_name to the fiscalization provider
  - `fallbackOperator` FiscalizationFallbackOperator — Property-level fallback operator used when an invoice-issuing user has no per-user mapping. Optional — when absent, unmapped users get a hard error at submission time.
    - `legalId` string, required
    - `legalName` string, required

## Other responses

- `400` — Validation failed (invalid OIB, duplicate, unknown user)

---

[API](https://skmtc.net/cloudbeds/apis/cloudbeds-api.md) · [All operations](https://skmtc.net/cloudbeds/apis/cloudbeds-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cloudbeds/cloudbeds-api/revisions/2faa857793e8/schema)