---
title: "Create fiscalization registration"
method: POST
path: "/fiscal-document/v1/fiscalization/registration"
tags: ["Fiscalization"]
deprecated: true
---

# Create fiscalization registration

`POST /fiscal-document/v1/fiscalization/registration`

> **Deprecated.**

Creates a new fiscalization registration (supplier/party info) for the given property.

## Headers

- `X-Property-ID` integer, required

## Request body

- FiscalizationRegistrationRequest — Provider-agnostic supplier registration data
  - `partnerId` integer — Optional scope to a specific partner instance on a multi-partner property. Omit on single-partner properties (legacy behavior).
  - `country` string, required — ISO 3166-1 alpha-2 country code
  - `name` string, required — Legal name of the company
  - `taxId` string — Primary tax identification number
  - `addresses` FiscalizationAddress[]
    - `street` string, required — Street address with number
    - `number` string — Street number (separate field for countries like Brazil)
    - `locality` string — Neighborhood or locality
    - `region` string — City, region, or administrative area
    - `state` string — State/Province/Region code
    - `postalCode` string, required — Postal/ZIP code
    - `country` string, required — ISO 3166-1 alpha-2 country code
  - `emails` FiscalizationEmail[]
    - `address` string, email, required — Email address
    - `label` string — Optional label for the email
  - `phones` FiscalizationPhone[]
    - `number` string, required — Phone number (international format preferred)
    - `label` string — Optional label for the phone
  - `identities` object — Additional tax/legal identities (key-value pairs)
  - `extensions` object — Country-specific tax configuration. Known MX keys: `mx_border_zone` ("true"/"false") — set to "true" for properties in Mexico's northern border zone where IVA is 8% instead of 16%.

## Response `201`

Created

- FiscalizationRegistrationResponse — Provider-agnostic supplier registration data
  - `partnerId` integer — Optional scope to a specific partner instance on a multi-partner property. Omit on single-partner properties (legacy behavior).
  - `country` string, required — ISO 3166-1 alpha-2 country code
  - `name` string, required — Legal name of the company
  - `taxId` string — Primary tax identification number
  - `addresses` FiscalizationAddress[]
    - `street` string, required — Street address with number
    - `number` string — Street number (separate field for countries like Brazil)
    - `locality` string — Neighborhood or locality
    - `region` string — City, region, or administrative area
    - `state` string — State/Province/Region code
    - `postalCode` string, required — Postal/ZIP code
    - `country` string, required — ISO 3166-1 alpha-2 country code
  - `emails` FiscalizationEmail[]
    - `address` string, email, required — Email address
    - `label` string — Optional label for the email
  - `phones` FiscalizationPhone[]
    - `number` string, required — Phone number (international format preferred)
    - `label` string — Optional label for the phone
  - `identities` object — Additional tax/legal identities (key-value pairs)
  - `extensions` object — Country-specific tax configuration. Known MX keys: `mx_border_zone` ("true"/"false") — set to "true" for properties in Mexico's northern border zone where IVA is 8% instead of 16%.
  - `propertyId` integer, required — Property ID this registration belongs to
  - `status` FiscalizationRegistrationStatus, required
    - `countryCode` string, required — ISO 3166-1 alpha-2 country code
    - `status` 'NOT_REGISTERED' | 'PENDING' | 'AWAITING' | 'REGISTERED' | 'FAILED', required — Registration status with government systems
    - `providerId` string — Provider-specific registration ID
    - `linkUrl` string — External link URL when status is AWAITING (e.g., government portal)
    - `createdAt` string, date-time — When registration was created
    - `updatedAt` string, date-time — When status was last updated
    - `error` string — Error if registration failed
  - `providerId` string — Provider-specific ID (e.g., Invopop party ID)
  - `isDefault` boolean — Whether this is the default fiscalization registration
  - `createdAt` string, date-time
  - `updatedAt` string, date-time

---

[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)