> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gridbeds.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Dati legali

> Cosa chiede a un annuncio la legge del luogo della struttura, come dati: legal.classification, legal.registration_number e legal.identifiers.

<Warning>
  **Anteprima: non è ancora attivo nulla.** Qui è descritto il contratto dell'API di distribuzione (versione `1.0.0`).
</Warning>

Quello che la legge chiede a un annuncio è dichiarato come dati su ogni struttura, sotto `legal`, per paese e, dove la legge è regionale, per regione o comune. Quali paesi pubblicare lo decidi tu: filtra su `address.country` della sede.

```json theme={null}
"legal": {
  "classification": null,
  "registration_number": "IT…",
  "identifiers": [
    { "scheme": "it.cin", "value": "IT…" }
  ]
}
```

## Per paese

| Struttura in | `classification` | `registration_number` |
| - | - | - |
| Romania | Sempre presente. Una struttura viene pubblicata solo con un certificato di classificazione valido, e viene ritirata (`property.withdrawn`) quando il certificato scade. | Il numero di registrazione secondo il Regolamento (UE) 2024/1028, una volta che il registro nazionale esiste; altrimenti `null`. |
| Italia | `null` | Il CIN (Codice Identificativo Nazionale). Una struttura viene pubblicata solo con il CIN. |
| Altrove | `null`, salvo che una regola locale lo compili. | Il numero di registrazione nazionale secondo il Regolamento (UE) 2024/1028, una volta che il registro nazionale esiste; altrimenti `null`. |

`classification` contiene il numero del certificato, la categoria della struttura (un elenco aperto, per esempio `hotel` o `pensiune_agroturistica`), il tipo di classificazione (`stars`, stelle, o `flowers`, fiori), la classificazione da 1 a 5, l'ultimo giorno di validità e il paese.

## `legal.identifiers`

`identifiers` elenca ogni identificativo legale dell'annuncio, al massimo uno per schema, come `{scheme, value, valid_until, issued_by}`; è vuoto dove la legge locale non ne chiede. Il certificato di `classification` compare anche qui come `ro.classification`, e un `registration_number` compare sempre anche qui.

* `scheme` è `<giurisdizione>.<nome>` in minuscolo: la giurisdizione è il codice ISO 3166-1 alpha-2 del paese che definisce lo schema, oppure `eu` per uno schema dell'Unione europea. Uno schema regionale porta il prefisso del suo paese e indica la regione in `issued_by`.
* Il nome di uno schema non viene mai rinominato né riusato; uno schema che cambia formato diventa un nome nuovo.
* `value` è l'identificativo esattamente come l'ha scritto l'autorità che lo rilascia.
* `valid_until` è l'ultimo giorno di validità, nel fuso orario della struttura; assente o `null` quando non scade.
* `issued_by` è l'autorità che lo rilascia, come testo.

Gli schemi noti nella versione 1:

| Schema | Identificativo |
| - | - |
| `ro.classification` | Il numero di un certificato di classificazione turistica rumeno. |
| `it.cin` | Il Codice Identificativo Nazionale italiano. |
| `eu.str_registration` | Un numero di registrazione secondo il Regolamento (UE) 2024/1028, applicabile dal 20 maggio 2026 ovunque uno Stato membro abbia una procedura di registrazione. |
| `es.ri` | Un numero di un registro turistico regionale spagnolo. |

<Note>
  **Ignora uno schema che non conosci.** Gli schemi nuovi si aggiungono senza una nuova versione dell'API.
</Note>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.