> ## Documentation Index
> Fetch the complete documentation index at: https://api-doc.xmenu.it/llms.txt
> Use this file to discover all available pages before exploring further.

# Tipi di dato

> Tipi di dato utilizzati nella documentazione API di xMenu

Questa documentazione utilizza i seguenti tipi di dato standardizzati per descrivere i campi nelle richieste API e nelle notifiche webhook.

## Tipi di dato

### string

Stringa di testo. Utilizzato per valori testuali generici.

**Nota sui formati data/ora:** I campi di tipo `string` possono contenere date e orari in formato legacy `AAAA-MM-GG hh:mm:ss` (esempio: `2025-12-04 14:30:00`). Il fuso orario di questi valori segue quello impostato nelle [Impostazioni API](/docs/it/overview/api-settings).

### string\<date>

Stringa contenente una data nel formato **ISO 8601** (esempio: `2025-12-04`). Questo tipo rappresenta una data senza informazioni di ora o timezone.

### string\<date-time>

Stringa contenente data e ora nel formato **ISO 8601** con timezone incorporato (esempio: `2025-12-04T14:30:00+01:00`).

A differenza del formato `string` legacy, questo tipo include esplicitamente il timezone del ristorante/locale associato all'entità, garantendo la corretta interpretazione dell'orario indipendentemente dalle impostazioni API.

### boolean

Valore booleano che può essere rappresentato in due modi:

* Booleano puro: `false` o `true`
* Numerico o stringa numerica: `0`/`"0"` (falso) o `1`/`"1"` (vero)

**Nota importante:** Per motivi di gestione interna e retrocompatibilità, i valori `boolean` possono essere restituiti in uno qualsiasi dei formati sopra indicati. Assicurati che il tuo codice gestisca correttamente tutte le rappresentazioni.

### integer

Numero intero senza decimali.

**Nota importante:** Per motivi di gestione interna e retrocompatibilità, i valori `integer` potrebbero essere restituiti come stringhe numeriche (esempio: `"123"` invece di `123`). Implementa una conversione appropriata quando elabori questi campi.

### number

Numero decimale con virgola (esempio: `12.50` per un prezzo).

**Nota importante:** Come per gli `integer`, i valori `number` potrebbero essere restituiti come stringhe numeriche (esempio: `"12.50"` invece di `12.50`). Implementa una conversione appropriata quando elabori questi campi.

### object

Oggetto strutturato contenente più campi/proprietà. La struttura specifica viene dettagliata nella documentazione di ciascun endpoint o webhook.

### array

Vettore/array contenente una collezione di elementi. Il tipo degli elementi contenuti viene specificato nella documentazione (esempio: `array<object>`, `array<string>`).