Step 1 — Installazione
Clicca questo link per iniziare:
https://fic.squadd.it/oauth/connect/start
Cosa succede:
- Si apre SQUADD e ti chiede di scegliere la location da collegare — seleziona la tua
- Autorizzi i permessi richiesti (lettura/scrittura contatti, opportunità, fatture)
- Vieni reindirizzato automaticamente a Fatture in Cloud — accedi con le tue credenziali FiC e autorizza
- Vedi la schermata "Collegamento completato" — puoi chiudere la finestra
A questo punto nel tuo account SQUADD troverai già installati:
- I custom fields necessari (Ragione Sociale, Partita IVA, Codice Fiscale, Indirizzo Sede Legale, CAP, Città, Provincia, Codice SDI, PEC, Importo Fattura, Descrizione Fattura, Aliquota IVA)
- Due workflow pronti all'uso
Step 2 — Scegli come vuoi fatturare
Vai in Automazioni nel tuo SQUADD. Troverai due workflow dedicati alla fatturazione. Puoi usarne uno o entrambi, a seconda di come lavori:
Opzione A — Fattura da Opportunità (Pipeline)
Questo workflow scatta quando un'opportunità viene spostata nello stato Vinto.
Importante: i dati di fatturazione devono essere compilati PRIMA di spostare l'opportunità in "Vinto". Se sposti in "Vinto" con i campi vuoti, la fattura non si crea (o si crea incompleta).
Verifica Fatture in Cloud in caso di errore, elimina la fattura se creata errata, e rifai il processo da SQUADD.
Campi da compilare nell'opportunità:
- Ragione Sociale (obbligatorio)
- Partita IVA o Codice Fiscale (almeno uno dei due, obbligatorio)
- Importo Fattura (obbligatorio)
- Indirizzo, CAP, Città, Provincia (consigliati)
- Codice SDI o PEC (per la fatturazione elettronica)
- Descrizione Fattura (se vuoto, usa il nome dell'opportunità)
- Aliquota IVA (default 22% se non specificata)
Flusso: compili i dati → sposti in "Vinto" → la fattura appare su Fatture in Cloud.
Opzione B — Fattura da Contatto (Anagrafica)
Questo workflow si attiva tramite un campo a tendina nel contatto chiamato Invia Fattura.
Come funziona:
- Apri la scheda del contatto
- Compila i campi di fatturazione (stessi di sopra)
- Vai al campo
Invia Fattura→ selezionaInviadal menu a tendina - Salva il contatto
- La fattura si crea su Fatture in Cloud
Utile quando vuoi fatturare un contatto senza passare dalla pipeline.
Nota: Puoi attivare entrambi i workflow senza problemi. Non si pestano i piedi — il sistema ha un controllo anti-duplicati integrato.
Step 3 — Verifica
Dopo aver creato la prima fattura di test:
- Vai su Fatture in Cloud → Fatture Emesse → verifica che la fattura sia presente
- Controlla che i dati del cliente (ragione sociale, P.IVA, indirizzo) siano corretti
- La fattura viene creata in stato "Non pagata" — sta a te poi segnarla come pagata su FiC
Step 4 — Setup
Come parte finale, scegli che tipologia di fatture il sistema creerà.
Seleziona l'aliquota
Valori disponibili (da scrivere manualmente, solo la percentuale):
- 22%
- 10%
- 5%
- 4%
- 0%
Seleziona la tipologia di cliente
Valori disponibili (da scrivere manualmente):
- privato
- azienda
Seleziona se l'IVA è compresa o no
Valori disponibili (da scrivere manualmente):
- sì
- no
Cosa succede dietro le quinte
- SQUADD gestisce l'invio del dato
- Il codice cerca il cliente su Fatture in Cloud (per nome o P.IVA) — se non esiste, lo crea
- Crea la fattura con i dati ricevuti
- Salva tutto e notifica SQUADD che la fattura è stata creata (con numero fattura e riferimento)
Campi obbligatori (riepilogo)
| Campo | Privato | Azienda (B2B) |
|---|---|---|
| Ragione Sociale | Non richiesto | Obbligatorio |
| Nome (first_name + last_name) | Obbligatorio (fallback: full_name o contact_name) | Non richiesto |
| Partita IVA | Non richiesto | Almeno uno tra P.IVA e CF |
| Codice Fiscale | Obbligatorio | Almeno uno tra P.IVA e CF |
| Importo Fattura | Obbligatorio | Obbligatorio |
| Aliquota IVA | No (default 22%) | No (default 22%) |
| IVA Compresa (sì/no) | No (default: no) | No (default: no) |
| Descrizione | No | No |
| Indirizzo/CAP/Città/Provincia | Consigliato | Consigliato |
| Codice SDI | Non inviato | Consigliato (e-invoice) |
| PEC | Non inviata | Alternativa a SDI |
Problemi comuni
"La fattura non si crea"
- Controlla che i campi obbligatori siano compilati (ragione sociale, P.IVA o CF, importo)
- Per le opportunità: i dati vanno compilati prima di spostare in "Vinto"
- Per i contatti: dopo aver selezionato "Invia", devi salvare il contatto
"La fattura si è creata doppia"
- Non dovrebbe succedere — c'è un controllo anti-duplicati. Verifica di non averla inviata due volte dal CRM.
- Se succede, contattaci.
"I dati del cliente su FiC sono sbagliati"
- Il cliente viene creato su FiC la prima volta. Le volte successive viene riutilizzato quello esistente. Correggi i dati direttamente su Fatture in Cloud.