Vai al contenuto principale
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.

​
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>).