Sign in

v1

latestOpenAPI 3.0.12026-07-245277551.2 MB
Fiscalization

Update fiscalization registration

Updates the fiscalization registration for the given property.

put/fiscal-document/v1/fiscalization/registration

Headers

X-Property-IDinteger required

Request body

partnerIdinteger

Optional scope to a specific partner instance on a multi-partner property. Omit on single-partner properties (legacy behavior).

countrystring required

ISO 3166-1 alpha-2 country code

namestring required

Legal name of the company

taxIdstring

Primary tax identification number

identitiesobject

Additional tax/legal identities (key-value pairs)

extensionsobject

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%.

Example request

{
  "country": "IT",
  "name": "Mario Rossi Albergo",
  "taxId": "98765432103",
  "addresses": [
    {
      "street": "Via Roma 123",
      "number": "123",
      "locality": "Centro",
      "region": "Milan",
      "state": "MI",
      "postalCode": "20121",
      "country": "IT"
    }
  ],
  "emails": [
    {
      "address": "fatture@hotel-italia.it",
      "label": "Invoicing"
    }
  ],
  "phones": [
    {
      "number": "+39 02 1234567",
      "label": "Office"
    }
  ],
  "identities": {
    "it-fiscal-code": "98765432103"
  },
  "extensions": {
    "it-regime-fiscale": "RF07",
    "it-sdi-format": "FPR12",
    "mx_border_zone": "true"
  }
}

Response

OK

partnerIdinteger

Optional scope to a specific partner instance on a multi-partner property. Omit on single-partner properties (legacy behavior).

countrystring required

ISO 3166-1 alpha-2 country code

namestring required

Legal name of the company

taxIdstring

Primary tax identification number

identitiesobject

Additional tax/legal identities (key-value pairs)

extensionsobject

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%.

propertyIdinteger required

Property ID this registration belongs to

providerIdstring

Provider-specific ID (e.g., Invopop party ID)

isDefaultboolean

Whether this is the default fiscalization registration

createdAtstring date-time
updatedAtstring date-time

Example response

{
  "country": "IT",
  "name": "Mario Rossi Albergo",
  "taxId": "98765432103",
  "addresses": [
    {
      "street": "Via Roma 123",
      "number": "123",
      "locality": "Centro",
      "region": "Milan",
      "state": "MI",
      "postalCode": "20121",
      "country": "IT"
    }
  ],
  "emails": [
    {
      "address": "fatture@hotel-italia.it",
      "label": "Invoicing"
    }
  ],
  "phones": [
    {
      "number": "+39 02 1234567",
      "label": "Office"
    }
  ],
  "identities": {
    "it-fiscal-code": "98765432103"
  },
  "extensions": {
    "it-regime-fiscale": "RF07",
    "it-sdi-format": "FPR12",
    "mx_border_zone": "true"
  }
}