Square
Questa integrazione è disponibile in Frihet. Configurala in Settings → Integrazioni → Square.
Connetti il tuo account Square a Frihet per importare automaticamente le transazioni e i pagamenti dal tuo punto vendita. Square è una piattaforma di incassi che include terminali POS, pagamenti online e gestione dell'inventario. Con questa integrazione, ogni vendita registrata in Square viene importata in Frihet come entrata, eliminando l'inserimento manuale e mantenendo la tua contabilità sincronizzata con le vendite in presenza e online.
A cosa serve?
- Importare transazioni — Ogni pagamento elaborato in Square (POS, online, fattura) viene importato come entrata in Frihet con tutti i dettagli
- Riconciliazione automatica — Abbina i pagamenti di Square alle tue fatture in Frihet senza sforzo manuale
- Clienti sincronizzati — I clienti registrati in Square vengono importati nel tuo database di contatti in Frihet
- Commissioni come spese — Le commissioni che Square addebita per ogni transazione vengono registrate automaticamente come spese in Frihet
- Storico completo — Importa transazioni passate per avere una visione completa della tua attività commerciale
Requisiti
- Account attivo su Square
- Piano Frihet Pro o Business
- Access Token dell'API di Square (si ottiene dalla Square Developer Dashboard)
Come connettere
Passaggio 1: Ottenere il tuo Access Token in Square
- Accedi a developer.squareup.com
- Crea una nuova applicazione o selezionane una esistente
- Nel pannello dell'applicazione, naviga su Credentials
- Copia il Production Access Token (non usare quello di sandbox per dati reali)
- Assicurati che il token abbia i permessi di lettura per Payments, Orders e Customers
Passaggio 2: Configurare in Frihet
- In Frihet, vai su Settings → Integrazioni
- Cerca Square e clicca sul card
- Incolla il tuo Access Token nel campo corrispondente
- Clicca su Testa connessione per verificare che le credenziali siano corrette
- Seleziona la posizione (location) di Square che vuoi sincronizzare
- Clicca su Salva
Dati che si sincronizzano
| Dato | Direzione | Dettagli |
|---|---|---|
| Transazioni/pagamenti | Square → Frihet | Importo, data, metodo di pagamento, riferimento |
| Clienti | Square → Frihet | Nome, email, telefono dell'acquirente |
| Commissioni | Square → Frihet | Commissioni di Square registrate come spese |
| Prodotti venduti | Square → Frihet | Linee di dettaglio di ogni transazione |
| Stato del pagamento | Square → Frihet | Completato, rimborsato, in sospeso |
Casi d'uso
Negozio fisico con contabilità digitale
Hai un negozio e incassi con il terminale Square. Ogni vendita del giorno viene importata automaticamente in Frihet di notte. La tua contabilità riflette tutte le vendite in presenza senza che tu debba copiare nulla a mano. Le commissioni di Square appaiono come spese in modo che tu possa vedere il tuo margine reale.
Attività con vendite in presenza e online
Vendi sia in negozio con Square sia tramite il tuo sito web. Frihet consolida le transazioni di Square con le tue fatture online per darti una visione unificata di tutti i tuoi ricavi. Puoi generare report fiscali con tutte le fonti di entrata centralizzate.
Libero professionista con incassi da mobile
Sei un libero professionista e incassi dai tuoi clienti con Square sul cellulare (eventi, servizi a domicilio, mercati). Ogni incasso viene registrato automaticamente in Frihet con il dettaglio del servizio, in modo da avere la tua contabilità aggiornata senza dedicare tempo extra.
Soluzione dei problemi
Errore di connessione
- Verifica che stai usando il Production Access Token, non quello di sandbox
- Controlla che il token non sia scaduto o sia stato revocato dalla Developer Dashboard
- Assicurati che l'applicazione di Square abbia i permessi necessari (Payments Read, Orders Read, Customers Read)
Le transazioni non vengono importate
- Conferma di avere transazioni nell'intervallo di date selezionato
- Vengono importate solo le transazioni con stato completato — quelle in sospeso o annullate vengono escluse
- Verifica di aver selezionato la posizione (location) corretta di Square
Transazioni duplicate
- Frihet deduplica per ID transazione di Square. Non dovrebbero verificarsi duplicati
- Se vedi duplicati, disconnetti e riconnetti l'integrazione
- Le transazioni già importate in Frihet non sono influenzate dalla riconnessione
Commissioni non registrate
- Le commissioni vengono registrate come spese separate, non vengono detratte dall'importo della transazione
- Verifica che l'importazione delle commissioni sia attivata nelle impostazioni dell'integrazione