Salta ai contenuti
Cerca
Ctrl
K
Cancella
di
GitHub
Seleziona tema
Scuro
Chiaro
Auto
Seleziona lingua
Italiano
English
Menu
Guida del gestore
Panoramica
Configurazione guidata
Stabilimento
Stagioni e periodi
Chiusure
Mappe ed editor
Zone
Pool
Catalogo
Prezzi
Policy
Pagina pubblica e widget
Pagamenti online con Stripe
Modalità prova
Email e notifiche
Il percorso del cliente
Accessibilità
Cambio stagione
Importa dati
Oggi
Mappa del giorno
Blocca postazioni e prenotazione di gruppo
Calendario planning
Prenotazioni
Clienti e GDPR
Crediti dei clienti
Abbonamenti e rilasci
Rinnovi degli abbonamenti
Lista d'attesa
Cassa e chiusura
Vendita giornaliera e ticket
Assegnazione ombrelloni
Casse multiple e chiusura Z in PDF
Biglietti d'ingresso e controllo accessi
Corrispettivi
Stampanti e ESC/POS
Report
Team e ruoli
Chiavi API e webhook
Notifiche del pannello
Dispositivi
Pannello senza connessione
App desktop e rete locale
Glossario
Installazione e operatività
Panoramica
Cos'è Arenile
Scegli come installare
Installazione con Docker
Compilare dai sorgenti
Primo avvio
Dati demo
Configurazione
Backup e ripristino
Aggiornamenti
SQLite o PostgreSQL
Reverse proxy e HTTPS
Monitoraggio e log
Sicurezza
Privacy e GDPR
Novità
API e webhook
Panoramica
Autenticazione
Idempotenza
ETag e If-Match
Errori problem+json
API pubblica e checkout
Webhook dei pagamenti
Eventi e webhook in uscita
Riferimento API
Overview
ops
Overview
Processo vivo
GET
Pronto a servire (database raggiungibile, migrazioni allineate)
GET
auth
Overview
Accesso con email e password (e codice TOTP se attivo)
POST
Chiude la sessione corrente
POST
Utente corrente, appartenenze e permessi
GET
Avvia l'attivazione del secondo fattore TOTP
POST
Conferma l'attivazione del TOTP con un codice valido
POST
establishments
Overview
Stabilimenti accessibili all'utente corrente
GET
Crea un nuovo stabilimento (solo proprietari)
POST
Dettaglio di uno stabilimento
GET
Aggiorna, archivia o ripristina uno stabilimento
PATCH
Stato della modalità prova
GET
Attiva o disattiva la modalità prova
PUT
Link di anteprima della pagina pubblica in prova
POST
team
Overview
Utenti con accesso allo stabilimento
GET
Crea o invita un utente con un ruolo (solo owner)
POST
Revoca l'accesso dell'utente allo stabilimento (solo owner)
DELETE
Cambia ruolo o disattiva un utente (solo owner)
PATCH
seasons
Overview
Elenco stagioni
GET
Crea stagione
POST
Dettaglio stagione
GET
Sostituisce stagione
PUT
Elimina stagione
DELETE
Copia stagione sull'anno indicato (periodi, regole, prezzi fissi, policy)
POST
Elenco periodi tariffari
GET
Crea periodo tariffario
POST
Dettaglio periodo tariffario
GET
Sostituisce periodo tariffario
PUT
Elimina periodo tariffario
DELETE
Elenco giorni di chiusura
GET
Crea giorno di chiusura
POST
Dettaglio giorno di chiusura
GET
Sostituisce giorno di chiusura
PUT
Elimina giorno di chiusura
DELETE
Fine stagione: crea la stagione successiva copiando la configurazione (anteprima e applicazione)
POST
Storico dei passaggi di stagione
GET
maps
Overview
Elenco zone
GET
Crea zona
POST
Dettaglio zona
GET
Sostituisce zona
PUT
Elimina zona
DELETE
Elenco pool
GET
Crea pool
POST
Dettaglio pool
GET
Sostituisce pool
PUT
Elimina pool
DELETE
Elenco mappe
GET
Crea una mappa vuota
POST
Documento completo della mappa (mappa, postazioni, decorazioni)
GET
Salvataggio transazionale della mappa con controllo di versione
PUT
Elimina una mappa (rifiutato se ha postazioni con allocazioni future)
DELETE
Generatore di file: anteprima o applicazione
POST
Sposta il lato mare ribaltando o ruotando l'intera disposizione
POST
catalog
Overview
Elenco componenti
GET
Crea componente
POST
Dettaglio componente
GET
Sostituisce componente
PUT
Elimina componente
DELETE
Elenco pack
GET
Crea pack
POST
Dettaglio pack
GET
Sostituisce pack
PUT
Elimina pack
DELETE
Elenco extra
GET
Crea extra
POST
Dettaglio extra
GET
Sostituisce extra
PUT
Elimina extra
DELETE
pricing
Overview
Elenco regole di prezzo
GET
Crea regola di prezzo
POST
Dettaglio regola di prezzo
GET
Sostituisce regola di prezzo
PUT
Elimina regola di prezzo
DELETE
Elenco prezzi a durata fissa
GET
Crea prezzo a durata fissa
POST
Dettaglio prezzo a durata fissa
GET
Sostituisce prezzo a durata fissa
PUT
Elimina prezzo a durata fissa
DELETE
Elenco codici promozionali
GET
Crea codice promozionale
POST
Dettaglio codice promozionale
GET
Sostituisce codice promozionale
PUT
Elimina codice promozionale
DELETE
Elenco convenzioni
GET
Crea convenzione
POST
Dettaglio convenzione
GET
Sostituisce convenzione
PUT
Elimina convenzione
DELETE
Simulatore: quotazione con dettaglio passo per passo e policy
POST
Matrice di listino pack × categoria × periodo
GET
Verifica di copertura: giorni senza prezzo per pack attivo e categoria
GET
policies
Overview
Elenco policy
GET
Crea policy
POST
Dettaglio policy
GET
Sostituisce policy
PUT
Elimina policy
DELETE
setup
Overview
Modelli della configurazione guidata
GET
Avanzamento della configurazione guidata
GET
Applica un modello (stagione, mappa, zone, catalogo)
POST
Listino rapido: genera le regole base da prezzo per categoria e periodo
POST
customers
Overview
Elenco e ricerca clienti
GET
Crea cliente
POST
Scheda cliente con statistiche, crediti, prenotazioni recenti e abbonamenti
GET
Sostituisce i dati del cliente
PUT
Esportazione GDPR dei dati del cliente (JSON)
GET
Anonimizza il cliente (GDPR)
POST
Saldo e movimenti dei crediti del cliente
GET
Riconosce un credito (cortesia, manuale) o registra una rettifica
POST
Importazioni CSV
GET
Carica un file CSV da importare
POST
Modello CSV con le intestazioni attese
GET
Stato e rapporto dell'importazione
GET
Scarta l'importazione (cancella il file caricato)
DELETE
Anteprima (dry run) con rapporto di validazione
POST
Applica l'importazione validata
POST
bookings
Overview
Elenco prenotazioni filtrabile
GET
Crea prenotazione dal pannello
POST
Anteprima di una prenotazione: prezzo, policy e disponibilità (nessuna scrittura)
POST
Dettaglio prenotazione con righe, allocazioni, pagamenti e storico
GET
Modifica date, postazioni, righe o note (ricalcolo e riallocazione atomici)
PATCH
Conferma manuale (driver manual)
POST
Registra il check-in
POST
Segna come non presentato
POST
Approva una prenotazione in attesa
POST
Rifiuta una prenotazione in attesa
POST
Cancella con rimborso o credito da policy (anteprima con dry_run)
POST
Sposta una riga su un'altra postazione (o assegna una riga in attesa)
POST
Aggiunge una nota
POST
Assegnazione automatica delle righe in attesa (modalità zone)
POST
Reinvia l'email di conferma (con un nuovo link di gestione)
POST
Rigenera il link di gestione (revoca i precedenti)
POST
Eliminazione in blocco delle prenotazioni di prova
POST
availability
Overview
Blocco temporaneo (hold) di una selezione
POST
Stato di un hold
GET
Rilascia un hold
DELETE
Disponibilità per postazione e per zona/pool su un intervallo
GET
Blocchi manuali delle postazioni
GET
Blocca postazioni su un intervallo
POST
Rimuove un blocco
DELETE
operations
Overview
Stato operativo della mappa per data e fascia
GET
Calendario postazioni x giorni (codifica compatta)
GET
passes
Overview
Elenco abbonamenti stagionali
GET
Crea abbonamento (postazione per la stagione)
POST
Dettaglio abbonamento con rilasci
GET
Modifica note dell'abbonamento
PATCH
Giorni rilasciati
GET
Rilascia giorni: la postazione diventa prenotabile
POST
Revoca un rilascio non ancora rivenduto
DELETE
Prezzo manuale dell'abbonamento
PUT
Torna al prezzo del listino
DELETE
renewals
Overview
Campagne di rinnovo degli abbonamenti
GET
Proponi rinnovi: crea la campagna e una proposta per ogni abbonato (anteprima con dry_run)
POST
Dettaglio della campagna con i conteggi per stato
GET
Modifica nome, note o scadenza predefinita; chiude la campagna
PATCH
Proposte di rinnovo della campagna (filtri)
GET
Azioni di massa sulle proposte (invio, accettazione, rifiuto, proroga, rilascio)
POST
Dettaglio della proposta di rinnovo
GET
Accetta il rinnovo per conto del cliente (dal pannello)
POST
Registra il rifiuto del rinnovo e libera la postazione
POST
Invia (o reinvia) al cliente l'email della proposta con il link magico
POST
waitlist
Overview
Lista d'attesa in ordine di priorità
GET
Iscrive un cliente alla lista d'attesa dal pannello
POST
Dettaglio dell'iscrizione con le offerte
GET
Rimuove l'iscrizione (stato removed); un'offerta attiva viene revocata e il suo hold rilasciato
DELETE
Modifica l'iscrizione (periodo, zona, pack, priorità, note)
PATCH
Riordina la lista d'attesa
POST
Offre subito un posto all'iscritto (hold riservato a tempo e email con link)
POST
Revoca un'offerta attiva e rilascia il suo hold
POST
Impostazioni della lista d'attesa
GET
Aggiorna le impostazioni della lista d'attesa
PUT
payments
Overview
Pagamenti e rimborsi della prenotazione
GET
Registra un incasso manuale (contanti, carta, bonifico, altro)
POST
Registra un rimborso manuale
POST
Elenco pagamenti dello stabilimento
GET
Vendita libera di cassa senza prenotazione
POST
Riconciliazione dei pagamenti online
GET
Esegue subito la riconciliazione (come il job ogni 15 minuti)
POST
Rimborsi garantiti verso il gestore di pagamento
GET
Riprova subito un rimborso fallito
POST
cash
Overview
Storico delle sessioni di cassa
GET
Apre una sessione di cassa con fondo cassa
POST
Sessione aperta della cassa
GET
Dettaglio sessione di cassa
GET
Versamento o prelievo di contanti
POST
Chiude la sessione: atteso vs contato e differenza
POST
Casse dello stabilimento
GET
Crea una cassa
POST
Dettaglio della cassa
GET
Modifica nome, ordine o stato della cassa
PUT
Elimina una cassa mai usata
DELETE
Chiusura Z stampabile (HTML pronto per la stampa / PDF)
GET
tickets
Overview
Prezzo e disponibilità di una vendita giornaliera (nessuna scrittura)
POST
Vendita giornaliera rapida: biglietto numerato e prenotazione confermata
POST
Impostazioni della vendita giornaliera e della stampa del biglietto
GET
Aggiorna le impostazioni della vendita giornaliera
PUT
Ticket del giorno (JSON o CSV)
GET
Biglietti da assegnare (pannello Da assegnare della mappa e Oggi)
GET
Assegna automaticamente i biglietti da assegnare del giorno
POST
Biglietto dal codice del QR (controllo)
GET
Dettaglio del biglietto
GET
Dati di stampa del biglietto (scontrino 80/58 mm, A4, A5)
GET
Ristampa del biglietto (conteggio e audit)
POST
Annulla il biglietto (mantiene il numero, rimborso tramite pagamenti)
POST
Assegna un biglietto da assegnare a una postazione libera della sua zona
POST
Sposta il biglietto su un'altra postazione
POST
Ingresso al varco: scansione del QR del biglietto
POST
Tipi di biglietto d'ingresso (Adulto, Ridotto, Bambino, ...)
GET
Crea un tipo di biglietto d'ingresso
POST
Dettaglio del tipo di biglietto d'ingresso
GET
Elimina il tipo (o disattivalo se ha già biglietti venduti)
DELETE
Modifica il tipo di biglietto d'ingresso
PATCH
Prezzo e capienza residua di una vendita di ingressi
POST
Vendita di biglietti d'ingresso (stessa numerazione giornaliera)
POST
fiscal
Overview
Corrispettivi per aliquota IVA e metodo di pagamento (JSON o CSV)
GET
Documenti fiscali emessi dal driver
GET
realtime
Overview
Flusso SSE degli eventi di uno stabilimento
GET
public
Overview
Dati pubblici dello stabilimento (tema, lingue, configurazione del flusso)
GET
Disponibilità sintetica per giorno di un mese (passo "Quando")
GET
Geometria pubblica della mappa (senza dati sensibili)
GET
Disponibilità per il canale online in un intervallo (passo "Dove")
GET
Pack ed extra vendibili online compatibili con la selezione (passo "Cosa")
GET
Prezzo e policy di una selezione (nessuna scrittura)
POST
Crea la prenotazione in stato held e la sessione di checkout
POST
Stato della prenotazione e della sessione di checkout (polling)
GET
Abbandono del checkout, rilascia l'hold
DELETE
Dati del cliente, consensi, extra e codice promozionale
PATCH
Avvia il pagamento (o conferma senza pagamento online)
POST
QR della prenotazione confermata (SVG o PNG)
GET
Evento di calendario (.ics) della prenotazione confermata
GET
Prenotazione dal link magico (area gestione del cliente)
GET
QR della prenotazione dal link magico
GET
Evento di calendario (.ics) dal link magico
GET
Paga il saldo dal link magico
POST
Modifica entro i limiti della policy, con anteprima del nuovo prezzo
POST
Cancellazione secondo policy, con anteprima del rimborso o credito
POST
Rilascio di giorni dell'abbonamento (abbonati)
POST
Richiesta di un nuovo link di gestione (email + codice prenotazione)
POST
Proposta di rinnovo dal link magico
GET
Accetta il rinnovo e avvia il pagamento (acconto o saldo) con il provider online
POST
Rifiuta il rinnovo: la postazione torna disponibile
POST
Saldo crediti del cliente della prenotazione
GET
Usa il saldo crediti per pagare (in parte) la prenotazione
POST
Iscrizione alla lista d'attesa quando la richiesta non trova disponibilità
POST
Iscrizione alla lista d'attesa dal link personale, con l'eventuale offerta attiva
GET
Cancella l'iscrizione alla lista d'attesa
DELETE
Accetta l'offerta: la prenotazione nasce dall'hold riservato e prosegue nel checkout
POST
Rifiuta l'offerta (l'iscrizione resta in attesa, salvo `leave`)
POST
online
Overview
Impostazioni della pagina pubblica (tema, origini dell'incorporamento, flusso)
GET
Aggiorna le impostazioni della pagina pubblica
PUT
Versioni delle condizioni e dell'informativa
GET
Pubblica una nuova versione delle condizioni (immutabile)
POST
Provider di pagamento attivo e stato delle credenziali
GET
Imposta provider, modalità test/live e credenziali (cifrate)
PUT
Verifica le credenziali salvate presso il provider
POST
Impostazioni delle email transazionali
GET
Aggiorna mittente e notifiche
PUT
Invia un'email di prova
POST
Registro dei messaggi inviati (message_log)
GET
Modelli delle email ai clienti (testi modificabili)
GET
Un modello di email (tipo e lingua)
GET
Personalizza i testi di un modello
PUT
Ripristina i testi predefiniti di un modello
DELETE
Anteprima di un modello con dati di esempio
POST
Invia i testi in prova al proprio indirizzo
POST
webhooks
Overview
Webhook del provider di pagamento (firma obbligatoria)
POST
meta
Overview
Versione, edizione e capacità dell'istanza
GET
Avviso di nuova versione di Arenile
GET
devices
Overview
Crea un codice di abbinamento monouso a breve scadenza (QR)
POST
Dispositivi abbinati allo stabilimento
GET
Revoca un dispositivo (il suo token smette subito di funzionare)
DELETE
device
Overview
Scambia un codice di abbinamento con un token per dispositivo
POST
Il dispositivo del token (verifica che il token sia ancora valido)
GET
Scollega questo dispositivo (revoca il proprio token)
DELETE
fiscal-bridge
Overview
Stato del ponte fiscale dello stabilimento
GET
Registra (o aggiorna) questo dispositivo come ponte fiscale dello stabilimento
PUT
Annulla la registrazione di questo dispositivo come ponte fiscale
DELETE
Attende i lavori fiscali da eseguire sul FiscalDriver locale (long polling)
GET
Esito di un lavoro fiscale eseguito sul FiscalDriver locale
POST
desktop
Overview
Indica se serve la creazione guidata del primo utente owner
GET
Crea l'utente owner, l'organizzazione e lo stabilimento al primo avvio
POST
Impostazioni dell'app desktop (backup, aggiornamenti, rete locale)
GET
Aggiorna le impostazioni dell'app desktop
PUT
Backup presenti nella cartella dei backup
GET
Esegue subito un backup (come "Backup ora" del menu)
POST
Pianifica il ripristino di un backup (riavvio del server interno)
POST
reports
Overview
Indicatori principali del periodo (occupazione, ricavi, prenotazioni, saldi aperti)
GET
Occupazione per giorno, zona, fila o fascia
GET
Ricavi per periodo, canale, pack, extra, metodo di pagamento o aliquota IVA
GET
Prenotazioni per canale, anticipo di prenotazione, formula o giorno
GET
Cancellazioni e mancate presentazioni
GET
Abbonamenti stagionali, rilasci e rivendite
GET
Migliori clienti del periodo (solo nome visualizzato, nessun contatto)
GET
Saldi aperti (prenotazioni con importo ancora da incassare)
GET
Confronto con l'anno precedente sullo stesso intervallo di calendario
GET
Esportazione di un elenco in CSV o XLSX
GET
integrations
Overview
Chiavi API dello stabilimento (mai il segreto)
GET
Crea una chiave API (il segreto è restituito una sola volta)
POST
Dettaglio di una chiave API
GET
Revoca una chiave (immediata e definitiva; la riga resta per l'audit)
DELETE
Rinomina, cambia scope o scadenza di una chiave attiva
PATCH
Endpoint dei webhook in uscita (mai il segreto)
GET
Registra un endpoint (il segreto di firma è restituito una sola volta)
POST
Dettaglio di un endpoint
GET
Elimina un endpoint e il suo registro delle consegne
DELETE
Modifica URL, descrizione, eventi o stato attivo
PATCH
Ruota il segreto di firma (il nuovo è restituito una sola volta)
POST
Invia subito un evento di prova `webhook.test` a questo solo endpoint
POST
Registro delle consegne dell'endpoint (più recenti prima)
GET
Dettaglio di una consegna con corpo inviato ed estratto della risposta
GET
Rimette in coda una consegna (fallita o già consegnata) per un nuovo invio
POST
Notifiche del pannello
GET
Segna una notifica come letta
POST
Segna tutte le notifiche come lette
POST
Storico completo dei tentativi di una consegna
GET
printing
Overview
Stampanti ESC/POS di rete dello stabilimento
GET
Aggiungi una stampante di rete
POST
Dettaglio della stampante
GET
Modifica la stampante
PUT
Elimina la stampante
DELETE
Verifica se la stampante è raggiungibile
POST
Stampa di prova
POST
Instradamento dei documenti verso le stampanti
GET
Sostituisci l'instradamento dei documenti
PUT
Stampante da usare per un documento
GET
Lavori di stampa recenti
GET
Stampa un documento su stampante ESC/POS
POST
Stato del lavoro di stampa
GET
Riprova un lavoro di stampa fallito
POST
Sviluppo ed estensioni
Panoramica
Architettura
Mappa del repository
Invarianti
Estensioni (pkg/ext)
Driver di pagamento
Sviluppo con agenti AI
Contribuire
Licenza
GitHub
Seleziona tema
Scuro
Chiaro
Auto
Seleziona lingua
Italiano
English
di
Overview
meta
Sezione intitolata “meta”
Versione, edizione e capacità dell’istanza (app mobile e desktop, spec 29.2)
Operations
Sezione intitolata “Operations”
GET
/api/admin/v1/meta
GET
/api/admin/v1/system/update