API Lettere di Benvenuto

Endpoint per la gestione delle lettere di benvenuto inviate agli ospiti. Le lettere vengono generate automaticamente in base alla lingua dell’ospite e ai dati della prenotazione.

Lista Lettere di Benvenuto

Restituisce l’elenco completo di tutte le lettere di benvenuto generate.

GET /api/lettere-benvenuto

Risposta

{
  "data": [
    {
      "id": 1,
      "prenotazione_id": 142,
      "nome_ospite": "Mario Rossi",
      "lingua": "IT",
      "created_at": "2026-07-18T09:00:00Z",
      "url": "https://..."
    },
    {
      "id": 2,
      "prenotazione_id": 143,
      "nome_ospite": "John Smith",
      "lingua": "EN",
      "created_at": "2026-07-19T10:30:00Z",
      "url": "https://..."
    }
  ]
}

Campi della Risposta

Verifica Esistenza Lettera

Controlla se esiste già una lettera di benvenuto per una specifica prenotazione. Utile per determinare se è necessario generarne una nuova o se è già stata creata.

GET /api/lettere-benvenuto/:prenotazioneId

Parametri URL

Esempio di Richiesta

GET /api/lettere-benvenuto/142

Risposta (Lettera Esistente)

{
  "exists": true,
  "data": {
    "id": 1,
    "prenotazione_id": 142,
    "nome_ospite": "Mario Rossi",
    "lingua": "IT",
    "created_at": "2026-07-18T09:00:00Z",
    "url": "https://..."
  }
}

Risposta (Lettera Non Esistente)

{
  "exists": false,
  "data": null
}

Genera Lettera di Benvenuto

Genera una nuova lettera di benvenuto per una prenotazione. La lettera viene creata in base alla lingua specificata e ai dati del template.

POST /api/lettere-benvenuto/genera

Parametri Body

Struttura template_data

Esempio di Richiesta

{
  "prenotazione_id": 144,
  "nome_ospite": "Maria Bianchi",
  "lingua": "IT",
  "template_data": {
    "check_in": "01/08/2026",
    "check_out": "08/08/2026",
    "numero_ospiti": 3,
    "note_aggiuntive": "Colazione inclusa dalle 7:30 alle 10:00",
    "info_struttura": {
      "nome": "Il Carrubo",
      "indirizzo": "Via Example 123",
      "telefono": "+39 0XX XXXXXXX"
    }
  }
}

Risposta (201 Created)

{
  "success": true,
  "data": {
    "id": 3,
    "prenotazione_id": 144,
    "nome_ospite": "Maria Bianchi",
    "lingua": "IT",
    "url": "https://...",
    "created_at": "2026-07-15T14:00:00Z"
  },
  "message": "Lettera di benvenuto generata con successo"
}

Errori Comuni

[!TIP]
Se devi rigenerare una lettera (ad esempio dopo una modifica alla prenotazione), elimina prima quella esistente con l’endpoint DELETE e poi genera una nuova versione.

Elimina Lettera di Benvenuto

Elimina la lettera di benvenuto associata a una prenotazione. Questa operazione è necessaria prima di poter rigenerare una lettera aggiornata.

DELETE /api/lettere-benvenuto/:prenotazioneId

Parametri URL

Esempio di Richiesta

DELETE /api/lettere-benvenuto/142

Risposta

{
  "success": true,
  "message": "Lettera di benvenuto eliminata con successo"
}

Risposta (Lettera Non Trovata)

{
  "error": "Nessuna lettera di benvenuto trovata per questa prenotazione",
  "status": 404
}

Flusso Tipico

Il flusso standard per la gestione delle lettere di benvenuto è il seguente:

1. Verifica se esiste già una lettera con GET /api/lettere-benvenuto/:prenotazioneId
2. Se non esiste, genera una nuova con POST /api/lettere-benvenuto/genera
3. Se esiste ma i dati sono cambiati, elimina con DELETE e poi rigenera