Integrazione Piattaforma Contabilità Esterna

La piattaforma Bauking non gestisce direttamente la contabilità, ma si integra con una piattaforma contabile esterna che gestisce l'intero ciclo contabile, dalla generazione di fatture elettroniche alle note di credito e all'invio al Sistema di Interscambio (SDI).

Raccolta Dati Fatturazione

Tipi di Fattura

• Nessuna Fattura (none): Per prenotazioni senza richiesta fattura
• Fattura Privato (private): Fattura per privati con dati anagrafici
• Fattura Azienda (company): Fattura per aziende con dati fiscali completi

Dati Fatturazione Raccolti

• Dati Anagrafici: Nome, cognome, indirizzo completo, città, CAP, provincia/regione, paese
• Dati Contatto: Telefono, email
• Dati Fiscali (per aziende):
  • Partita IVA (P.IVA): Codice identificativo fiscale azienda
  • Codice Fiscale (CF): Codice fiscale per privati o aziende
  • SDI (Sistema di Interscambio): Codice destinatario per fatturazione elettronica
  • PEC: Indirizzo email certificata per ricezione fatture elettroniche

Processo di Integrazione

1. Raccolta Dati: Durante il checkout, l'utente seleziona il tipo di fattura e inserisce i dati necessari
2. Validazione: Sistema valida i dati inseriti (formato P.IVA, CF, SDI)
3. Salvataggio: Dati di fatturazione salvati nell'ordine nel database locale
4. Invio a Piattaforma Contabile: Dati ordine e fatturazione inviati alla piattaforma contabile esterna
5. Generazione Fattura: La piattaforma contabile esterna genera la fattura
6. Invio SDI: La piattaforma contabile esterna gestisce l'invio al Sistema di Interscambio
7. Ricezione Fattura: Fattura generata può essere scaricata e archiviata nel sistema

Gestione Fatture nel PIM

• Download Fattura: Download fatture generate dalla piattaforma contabile esterna
• Upload Fattura: Possibilità di caricare fatture ricevute dalla piattaforma esterna
• Visualizzazione: Anteprima e dettagli fattura nell'interfaccia admin
• Collegamento: Collegamento tra ordine e fattura nella piattaforma contabile

Note di Credito

Gestione tramite Piattaforma Esterna

• Trigger: In caso di cancellazioni, rimborsi o errori, il sistema comunica l'evento alla piattaforma contabile
• Generazione: La piattaforma contabile esterna genera la nota di credito
• Collegamento: Note di credito collegate alla fattura originale nella piattaforma esterna
• Invio SDI: La piattaforma contabile gestisce l'invio note di credito al SDI

Integrazione SDI (Sistema di Interscambio)

Gestione tramite Piattaforma Contabile

• La piattaforma contabile esterna gestisce completamente l'integrazione con il Sistema di Interscambio
• Comunicazione SDI: Invio fatture elettroniche e note di credito al SDI
• Formato XML: Generazione file XML conforme alle specifiche AgID
• Ricezione Esiti: Gestione ricezione esiti e notifiche dal SDI
• Codice Destinatario: Gestione codice SDI del cliente

Comunicazione con Piattaforma Contabile

Metodi di Integrazione

• API Integration: Comunicazione via API REST con la piattaforma contabile esterna
• Sincronizzazione Dati: Invio automatico dati ordini e fatturazione
• Webhook: Ricezione notifiche dalla piattaforma contabile (fatture generate, esiti SDI)
• Formati Standard: Scambio dati in formati standard (JSON, XML)

Dati Inviati alla Piattaforma Contabile

• Dati ordine completi (numero, date, importi)
• Dati fatturazione (anagrafica cliente, dati fiscali)
• Dettagli prenotazione (alloggio, camere, servizi)
• Informazioni pagamento

Dati Ricevuti dalla Piattaforma Contabile

• Fatture generate (file PDF/XML)
• Note di credito generate
• Esiti invio SDI
• Stato documenti fiscali

Caratteristiche Tecniche

• Comunicazione Asincrona: Invio dati in modo asincrono per non bloccare il processo di prenotazione
• Retry Logic: Sistema di retry in caso di errori di comunicazione
• Logging: Tracciamento completo comunicazioni con piattaforma contabile
• Sicurezza: Autenticazione e autorizzazione per comunicazione sicura
• Storage: Fatture scaricate salvate su storage sicuro (S3) per archiviazione

Flusso Integrazione Completo

1. Checkout: Utente seleziona tipo fattura e inserisce dati
2. Validazione: Sistema valida dati fiscali localmente
3. Prenotazione Confermata: Ordine creato con dati fatturazione nel database locale
4. Invio Dati: Dati ordine e fatturazione inviati alla piattaforma contabile esterna via API
5. Generazione Fattura: Piattaforma contabile esterna genera la fattura
6. Invio SDI: Piattaforma contabile esterna invia fattura al Sistema di Interscambio
7. Notifica: Piattaforma contabile notifica il sistema dell'esito
8. Download: Fattura può essere scaricata e archiviata nel sistema

Gestione Rimborsi e Note di Credito

1. Rimborso: Rimborso processato tramite gateway pagamento
2. Comunicazione Evento: Sistema comunica evento rimborso alla piattaforma contabile
3. Generazione Nota Credito: Piattaforma contabile esterna genera nota di credito
4. Invio SDI: Piattaforma contabile gestisce invio nota di credito al SDI
5. Notifica: Sistema riceve notifica di nota di credito generata

Use Case Diagram - Software di Contabilità

Questa sezione illustra il diagramma degli use case del software di contabilità esterno, mostrando le principali funzionalità e interazioni tra il sistema Bauking e la piattaforma contabile.

Diagramma Use Case Software Contabilità

Il diagramma seguente mostra tutti gli use case principali del software di contabilità:

Panoramica

Il diagramma degli use case del software di contabilità mostra le interazioni tra il sistema Bauking e la piattaforma contabile esterna. Questo diagramma aiuta a comprendere:

• Cosa può fare il software di contabilità
• Come Bauking interagisce con esso
• Quali funzionalità sono disponibili tramite l'integrazione

Attori Principali

1. Sistema Bauking

Il sistema Bauking è l'attore principale che interagisce con la piattaforma contabile:

• Invio dati ordini e fatturazione
• Ricezione notifiche e esiti
• Download fatture generate
• Gestione sincronizzazione dati

2. Piattaforma Contabile

La piattaforma contabile esterna gestisce:

• Generazione fatture elettroniche
• Invio al Sistema di Interscambio (SDI)
• Gestione note di credito
• Archiviazione documenti fiscali

3. Sistema di Interscambio (SDI)

Il SDI è un attore esterno che:

• Riceve fatture elettroniche
• Valida documenti fiscali
• Invia notifiche di esito
• Gestisce comunicazioni fiscali

Use Case Principali

Gestione Fatture

Use Case: Generare Fattura

• Attori: Sistema Bauking, Piattaforma Contabile
• Descrizione: Generazione fattura elettronica per ordine confermato
• Precondizioni: Ordine confermato con dati fatturazione completi
• Flusso principale:
  1. Sistema Bauking invia dati ordine e fatturazione alla piattaforma contabile
  2. Piattaforma contabile valida dati ricevuti
  3. Piattaforma contabile genera fattura elettronica in formato XML
  4. Piattaforma contabile salva fattura nel sistema
  5. Piattaforma contabile notifica Bauking della fattura generata
  6. Sistema Bauking può scaricare fattura generata

Use Case: Inviare Fattura al SDI

• Attori: Piattaforma Contabile, Sistema di Interscambio
• Descrizione: Invio fattura elettronica al Sistema di Interscambio
• Flusso principale:
  1. Piattaforma contabile prepara fattura in formato XML conforme AgID
  2. Piattaforma contabile invia fattura al SDI
  3. SDI valida fattura ricevuta
  4. SDI invia notifica di ricezione/errore
  5. Piattaforma contabile aggiorna stato fattura
  6. Piattaforma contabile notifica Bauking dell'esito

Use Case: Gestire Esiti SDI

• Attori: Piattaforma Contabile, Sistema di Interscambio
• Descrizione: Gestione esiti e notifiche dal Sistema di Interscambio
• Flusso principale:
  1. SDI invia notifica esito a piattaforma contabile
  2. Piattaforma contabile processa notifica
  3. Piattaforma contabile aggiorna stato fattura
  4. Piattaforma contabile notifica Bauking se necessario
  5. Gestione errori e retry se necessario

Gestione Note di Credito

Use Case: Generare Nota di Credito

• Attori: Sistema Bauking, Piattaforma Contabile
• Descrizione: Generazione nota di credito per rimborsi o correzioni
• Precondizioni: Evento che richiede nota di credito (rimborso, errore, cancellazione)
• Flusso principale:
  1. Sistema Bauking comunica evento (rimborso, cancellazione) alla piattaforma contabile
  2. Piattaforma contabile identifica fattura originale
  3. Piattaforma contabile genera nota di credito collegata alla fattura
  4. Piattaforma contabile salva nota di credito
  5. Piattaforma contabile notifica Bauking della nota di credito generata

Use Case: Inviare Nota di Credito al SDI

• Attori: Piattaforma Contabile, Sistema di Interscambio
• Descrizione: Invio nota di credito al Sistema di Interscambio
• Flusso principale:
  1. Piattaforma contabile prepara nota di credito in formato XML
  2. Piattaforma contabile invia nota di credito al SDI
  3. SDI valida documento ricevuto
  4. SDI invia notifica di ricezione/errore
  5. Piattaforma contabile aggiorna stato nota di credito

Sincronizzazione Dati

Use Case: Sincronizzare Dati Ordine

• Attori: Sistema Bauking, Piattaforma Contabile
• Descrizione: Sincronizzazione dati ordine con piattaforma contabile
• Flusso principale:
  1. Sistema Bauking invia dati ordine completi
  2. Piattaforma contabile valida e processa dati
  3. Piattaforma contabile crea/aggiorna record contabile
  4. Piattaforma contabile conferma sincronizzazione
  5. Sistema Bauking aggiorna stato sincronizzazione

Use Case: Ricevere Notifiche

• Attori: Piattaforma Contabile, Sistema Bauking
• Descrizione: Ricezione notifiche da piattaforma contabile
• Flusso principale:
  1. Piattaforma contabile genera evento (fattura creata, SDI esito, etc.)
  2. Piattaforma contabile invia webhook/notifica a Bauking
  3. Sistema Bauking processa notifica
  4. Sistema Bauking aggiorna stato ordine/fattura
  5. Sistema Bauking notifica utente se necessario

Gestione Documenti

Use Case: Scaricare Fattura

• Attori: Sistema Bauking, Piattaforma Contabile
• Descrizione: Download fattura generata dalla piattaforma contabile
• Flusso principale:
  1. Sistema Bauking richiede download fattura
  2. Piattaforma contabile verifica permessi e disponibilità
  3. Piattaforma contabile fornisce file fattura (PDF/XML)
  4. Sistema Bauking salva fattura su storage
  5. Fattura disponibile per visualizzazione/download utente

Use Case: Visualizzare Stato Fattura

• Attori: Sistema Bauking, Piattaforma Contabile
• Descrizione: Consultazione stato fattura nella piattaforma contabile
• Flusso principale:
  1. Sistema Bauking richiede stato fattura
  2. Piattaforma contabile restituisce stato (generata, inviata, accettata, rifiutata)
  3. Sistema Bauking aggiorna visualizzazione stato
  4. Sistema Bauking mostra stato all'utente

Relazioni tra Use Case

Include

Alcuni use case includono altri use case come parte del loro flusso:

• Generare Fattura include Sincronizzare Dati Ordine (per inviare dati completi)
• Inviare Fattura al SDI include Gestire Esiti SDI (per processare risposte)
• Generare Nota di Credito include Sincronizzare Dati Ordine (per dati rimborso)

Extend

Alcuni use case estendono altri use case in condizioni specifiche:

• Inviare Fattura al SDI estende Generare Fattura (quando fattura deve essere inviata)
• Scaricare Fattura estende Generare Fattura (quando si vuole scaricare)
• Inviare Nota di Credito al SDI estende Generare Nota di Credito (quando nota deve essere inviata)

Flussi di Lavoro Tipici

Workflow: Generazione e Invio Fattura

1. Sistema Bauking crea ordine con dati fatturazione
2. Sistema Bauking invia dati ordine alla piattaforma contabile
3. Piattaforma Contabile genera fattura elettronica
4. Piattaforma Contabile notifica Bauking della fattura generata
5. Piattaforma Contabile invia fattura al SDI
6. SDI valida e accetta fattura
7. SDI invia notifica esito a piattaforma contabile
8. Piattaforma Contabile notifica Bauking dell'esito
9. Sistema Bauking aggiorna stato ordine

Workflow: Gestione Rimborso e Nota di Credito

1. Sistema Bauking processa rimborso ordine
2. Sistema Bauking comunica evento rimborso alla piattaforma contabile
3. Piattaforma Contabile identifica fattura originale
4. Piattaforma Contabile genera nota di credito
5. Piattaforma Contabile notifica Bauking della nota di credito
6. Piattaforma Contabile invia nota di credito al SDI
7. SDI valida e accetta nota di credito
8. SDI invia notifica esito
9. Piattaforma Contabile notifica Bauking dell'esito

Workflow: Consultazione e Download Fattura

1. Utente richiede visualizzazione fattura nel sistema Bauking
2. Sistema Bauking richiede stato fattura alla piattaforma contabile
3. Piattaforma Contabile restituisce stato e metadati
4. Sistema Bauking richiede download fattura se disponibile
5. Piattaforma Contabile fornisce file fattura
6. Sistema Bauking salva fattura su storage
7. Utente può visualizzare/scaricare fattura

Note Tecniche

Comunicazione API

• Protocollo: REST API o GraphQL
• Autenticazione: Token-based authentication (OAuth 2.0, API Key)
• Formato Dati: JSON per richieste/risposte, XML per documenti fiscali
• Webhook: Notifiche asincrone tramite webhook

Sicurezza

• HTTPS: Tutte le comunicazioni su HTTPS
• Token Sicuri: Gestione sicura token di autenticazione
• Validazione: Validazione dati prima di invio
• Logging: Log completo comunicazioni per audit

Gestione Errori

• Retry Logic: Retry automatico per chiamate fallite
• Circuit Breaker: Protezione da cascading failures
• Error Handling: Gestione robusta errori e notifiche
• Monitoring: Monitoraggio chiamate API e errori

Conformità Fiscale

• Formato XML: Conformità specifiche AgID per fatturazione elettronica
• Validazione: Validazione dati fiscali prima di invio SDI
• Tracciabilità: Tracciamento completo documenti fiscali
• Archiviazione: Archiviazione documenti per conformità normativa