Come configurare Xero
Prepara la tua organizzazione Xero per le operazioni bancarie svizzere.
Configura Conti Bancari
Configura i tuoi conti bancari di finanziamento.
- Assicurati che ai tuoi conti bancari Xero siano assegnati IBAN e BIC validi.
- In Xero, vai su Contabilità -> Conti Bancari.
- Per il conto bancario da cui desideri pagare le fatture, fai clic su Gestisci Conto, quindi seleziona Modifica Dettagli Conto.
- Inserisci il tuo IBAN nel campo Nome Conto e il tuo BIC nel campo Numero Conto.
Configura Contatti
Assicurati che i dettagli di contatto siano validi.
- In Xero, vai alla pagina Modifica Contatto.
- Fai clic su Dettagli finanziari, inserisci l'IBAN nel campo Numero di conto bancario e il BIC nel campo Dettagli.
- Fai clic su Indirizzi e inserisci indirizzo, città e CAP del cliente.
Configura Fatture QR Fornitore
Aggiungi il riferimento richiesto per elaborare i pagamenti QR.
- Per elaborare i pagamenti QR, vai alla pagina Modifica Fattura in Xero.
- Inserisci il riferimento QR svizzero della fattura nel campo Riferimento.
Configura Dettagli Organizzazione
Convalida i dettagli della tua identità aziendale.
- Vai su Impostazioni -> Dettagli organizzazione.
- Assicurati che Ragione Sociale, indirizzo fisico e Partita IVA siano completamente compilati.
Connessione a Xero
Gestisci le integrazioni Xero e i vincoli multi-entità.
Collega Organizzazione
- Passa all'Area di Lavoro Organizzazioni.
- Fai clic su "Aggiungi Organizzazione" e segui le istruzioni OAuth2 di Xero.
- Seleziona il tenant Xero a cui vuoi consentire l'accesso a Digintu.
Configurazione Multi-entità
- I piani Gratuiti e Standard sono limitati a 1 connessione attiva.
- I piani Avanzati includono 3 connessioni per impostazione predefinita. Puoi acquistare limiti aggiuntivi tramite le Impostazioni del Profilo.
Disconnettere Organizzazioni
- Nell'Area di Lavoro Organizzazioni, fai clic sull'icona scollega accanto alla connessione attiva.
- Questo interrompe immediatamente il token di tracciamento OAuth2.
Importazione Fatture
Digitalizza i PDF e riconcilia i mastri. Automatizza l'inserimento tramite i Flussi o elabora manualmente i file qui.
QR-Fatture & ZUGFeRD
Gestione dei caricamenti PDF individuali.
- Trascina la tua QR-Fattura svizzera o PDF ZUGFeRD/Factur-X nell'area di deposito.
- Seleziona la direzione: Acquisti (Fornitore) o Vendite (Cliente).
- Il sistema estrae accuratamente Debitore/Creditore, IBAN, BIC, Indirizzo, Riferimento e Importo.
- Controlla i dati del mastro e clicca 'Conferma e invia a Xero'.
Importazione CSV di massa
Gestione dei dati del foglio di calcolo.
- Seleziona 'Importazione Foglio di Calcolo in blocco' e la direzione (Vendite/Acquisti).
- Carica il tuo file CSV, XLS o XLSX.
- Mappa le colonne con i campi Xero richiesti (Nome Contatto e Importo sono obbligatori).
- Verifica la griglia dei dati e invia l'intero lotto a Xero in un clic.
Inserimento Manuale
Per fatture senza documenti digitali.
- Seleziona 'Inserimento Manuale' per bypassare l'analisi dei file.
- Inserisci manualmente i dettagli del Creditore/Debitore, Conto Bancario, Importo e Riferimenti.
- Clicca 'Conferma' per creare istantaneamente la fattura nel cloud.
Generazione QR-Fatture
Genera manualmente o automaticamente polizze di versamento QR svizzere e XML ZUGFeRD per i tuoi crediti.
PDF Standard
- Clicca su 'Genera PDF' su qualsiasi fattura di vendita nella dashboard per aprire la suite di generazione.
- Seleziona 'PDF Standard' per ignorare completamente l'incorporamento dei metadati.
XML ZUGFeRD
- Seleziona 'ZUGFeRD XML' e scegli il tuo profilo di conformità (es. EN16931).
- Validazione Rigorosa: Richiede dettagli di indirizzo completi (Città e codice paese ISO a 2 lettere) per Creditore e Debitore.
QR-Fattura Svizzera
- Seleziona 'QR-Fattura Svizzera' per aggiungere una polizza di versamento ufficiale e vettoriale.
- Specifica la lingua (EN, DE, FR, IT) e mappa il Conto Bancario per recuperare l'IBAN.
- Se il tuo conto è un QR-IBAN, il sistema limita automaticamente lo schema a un QRR di 27 cifre.
Ibrido (Completo)
- Seleziona 'Ibrido (Completo)' per combinare i metadati ZUGFeRD con una polizza QR visiva.
- Spunta 'Consenti aggiornamento riferimento' per scrivere il Riferimento QR matematico (QRR/SCOR) in Xero.
- Spunta 'Allega PDF a Xero' per caricare automaticamente il file finalizzato.
Pagamento Fatture (PAIN.001)
Genera file di esecuzione conformi per la tua banca.
Compilazione di un lotto di pagamento
- Seleziona le fatture target dalla dashboard e clicca 'Elabora Fatture Selezionate'.
- Configura la Data di Esecuzione Bancaria.
- Raggruppa i blocchi XML in base alle rigide regole PmtInf della tua banca.
- Scarica l'XML PAIN.001 o usa la dashboard Automazioni per la generazione autonoma.
Strategie di Pagamento
- Seleziona il tuo Conto Bancario Xero di finanziamento e la Data di Esecuzione.
- Scegli la strategia: Nazionale Svizzero, QR-Fattura Svizzera o Internazionale (SEPA).
- Fai clic su Compila e Scarica per ricevere il tuo file XML.
Modifica in Linea e Convalida
Modifica i dettagli prima della compilazione.
- Puoi aggiornare l'IBAN, il BIC o l'Importo del creditore direttamente nella griglia.
- Appariranno degli avvisi se manca un BIC o se si tenta di utilizzare un QR-IBAN senza un riferimento QRR valido.
Nazionale Svizzero (Standard)
Bonifico bancario nazionale standard.
- Richiede un IBAN o numero di conto standard.
- Vieta esplicitamente i formati QR-IBAN.
- Nome beneficiario, IBAN e Importo sono strettamente richiesti.
Pagamento QR-Fattura Svizzera
Strategia obbligatoria per i conti QR-IBAN.
- Richiede un QR-IBAN svizzero valido (formato CH/LI con intervallo ID 30000-31999).
- Riferimento QR numerico obbligatorio di 27 cifre con checksum Modulo10 valido.
- Il regolamento è strettamente limitato alle valute CHF o EUR.
Bonifico Internazionale (SEPA / Estero)
Per pagamenti multivaluta o internazionali.
- Richiede Città e Paese del beneficiario, insieme a un IBAN standard.
- Richiede la specifica di un soggetto a cui addebitare le spese (Condivise, Mittente Paga Tutto, Destinatario Paga Tutto) e un Codice Casuale obbligatorio.
- Per SEPA (Scenario A), la valuta deve essere esattamente EUR.
Campi Modificabili & Xero Sync
Cosa può essere inserito e salvato.
- Puoi modificare Nome Beneficiario, Indirizzo, IBAN, BIC/SWIFT, Riferimento, Valuta e Importo direttamente in Digintu.
- L'azione "Salva" invia le modifiche per Nome Contatto, Blocco Indirizzo e Riferimento Fattura direttamente a Xero.
- Le modifiche ai Dettagli Bancari (IBAN/BIC), Valuta e Importo si applicano SOLO al file di pagamento generato.
Importazione Estratti Conto
Automatizza il mapping di riconciliazione utilizzando i dati CAMT.
Riconcilia Linee
- Apri l'Area Estratto Conto Bancario.
- Seleziona il Conto Bancario di destinazione.
- Carica il file XML CAMT.053/054 fornito dalla tua banca.
- Esamina i punteggi di confidenza (Perfetto, Parziale, Corrispondenza nome).
Punteggi di Confidenza e Abbinamento
Come il motore collega le transazioni.
- Corrispondenza Perfetta (Verde): Importo e riferimento corrispondono esattamente.
- Riferimento Abbinato (Blu): Riferimento abbinato ma l'importo può differire.
- Parziale/Pagamento in eccesso (Giallo): Possibile discrepanza negli importi.
- Duplicato (Rosso): La transazione è già stata sincronizzata.
Esportazione e Caricamento CSV Manuale
Scarica il CSV generato e caricalo manualmente su Xero.
- Nel menu Contabilità, seleziona Conti bancari.
- Per il conto bancario in cui desideri importare il file, fai clic sull'icona del menu, quindi seleziona Importa un Estratto Conto.
- In File da caricare, trascina e rilascia il CSV scaricato da Digintu.
- Se richiesto, assegna le colonne nel file di importazione ai campi corrispondenti in Xero.
- Se richiesto, seleziona il formato della data utilizzato, quindi fai clic su Avanti.
- Esamina le transazioni importate e deseleziona quelle che non desideri importare.
- Fai clic su Completa importazione.
Riconciliazione Diretta in 1 Clic
Invia gli estratti conto direttamente a Xero per la riconciliazione automatica.
- Invia gli estratti conto direttamente a Xero per la riconciliazione automatica.
- Il file XML CAMT.053 originale e i file CSV generati vengono automaticamente archiviati in modo sicuro come allegati nel tuo Xero Vault per la conformità agli audit.
Flussi in Entrata: Fatture Fornitori
Automatizza l'importazione di documenti passivi (PDF, CSV, Excel) in Xero.
Configurazione del Flusso
Quali campi compilare per le fatture in entrata.
- Seleziona un formato sotto 'Tipo Flusso' (es. Swiss QR Bill, ZUGFeRD).
- Scegli il 'Tipo Canale' (API REST, SFTP, Email, Google Drive).
- Imposta lo 'Stato di destinazione' (Bozza, In attesa di pagamento).
- Definisci la 'Soglia di confidenza' per la corrispondenza automatica del fornitore.
Dove trovare l'output in Xero
- I documenti elaborati appaiono in Xero sotto 'Acquisti > Fatture da pagare' nello stato target designato.
- Il PDF originale viene automaticamente allegato alla nuova fattura.
- I dettagli del fornitore, IBAN, BIC e voci di riga sono mappati automaticamente.
- Il flusso utilizza la Six Bank Master API per abbinare e derivare senza problemi il BIC bancario corretto da qualsiasi IBAN fornito.
Avvisi & Notifiche
- Riceverai un'email di conferma alla creazione del flusso.
- Se un file non viene elaborato correttamente, il sistema metterà in pausa il flusso e ti avviserà via email.
Flussi in Entrata: Estratti Conto
Automatizza i dati di riconciliazione bancaria tramite CAMT.053 o CSV.
Configurazione del Flusso
Campi richiesti per l'acquisizione di estratti conto.
- Seleziona 'Estratti Conto (CAMT.053)' o '(CSV)'.
- Seleziona il 'Conto Bancario Target' in Xero.
- Se usi CSV/Excel, usa lo strumento di mappatura colonne per definire Data, Importo, Beneficiario e Riferimento.
Dove trovare l'output in Xero
- Una volta che un file CAMT viene ricevuto dal tuo flusso, Digintu lo elabora istantaneamente. Crea transazioni del conto bancario abbinandole alle tue fatture esistenti.
- Inoltre, genererà un estratto conto bancario compatibile con Xero in formato CSV e lo salverà nel Xero File Vault. Il link al Vault sarà incluso nell'email di notifica.
- Scarica questo file CSV allegato. Accedi al tuo account Xero e importa manualmente il file CSV nel tuo conto bancario target per la riconciliazione finale.
- Per istruzioni dettagliate su questo passaggio finale, consulta l'articolo "Importing Bank Statements" in questo Centro Assistenza.
Avvisi & Notifiche
- Un avviso sicuro viene inviato alla tua email quando il flusso viene stabilito.
- In caso di formato file non valido, l'errore verrà annotato nei Log di Audit.
Flussi in Uscita: Esecuzione Pagamenti
Pianifica la generazione automatizzata di XML PAIN.001 per i fornitori.
Impostazione della Pianificazione
Configurazione del processo in background.
- Seleziona 'Automated Payments (PAIN.001 XML)'.
- Imposta il 'Calendario di Sistema' (Intervallo, Giornaliero, Settimanale).
- Seleziona lo 'Stato Fattura Target' (es. In attesa di pagamento).
- Configura la 'Strategia di Esecuzione' per le date bancarie.
Dove trovare l'output in Xero
- I file XML PAIN.001 generati vengono consegnati alla libreria file di Xero (Files / Vault).
- Da lì, puoi scaricare l'XML e caricarlo sul tuo portale e-banking.
- La Six Bank Master API viene utilizzata in background per arricchire e validare automaticamente le combinazioni di instradamento IBAN/BIC target.
Report di Esecuzione
- Dopo ogni esecuzione programmata, il motore invia un report riassuntivo via email.
- Questa email elenca le transazioni raggruppate con successo e le fatture ignorate (es. IBAN mancante).
Flussi in Uscita: Generazione PDF Clienti
Genera e allega automaticamente QR-Fatture o PDF ZUGFeRD ai tuoi crediti.
Impostazione della Pianificazione
Configurazione del motore di generazione.
- Seleziona 'Automated PDF Generation'.
- Scegli il 'Formato Documento' (PDF Standard, ZUGFeRD, QR Bill, ibrido).
- Definisci il tuo programma automatizzato.
Dove trovare l'output in Xero
- Il motore genera il PDF e lo allega direttamente alla fattura di vendita sorgente in Xero.
- Se abilitato, il riferimento QR (QRR o SCOR) viene salvato nel campo Riferimento di Xero.
Rigorosa Validazione Indirizzi
- I formati automatizzati richiedono dettagli di indirizzo completi.
- Assicurati che l'Organizzazione (Creditore) e il Contatto (Debitore) in Xero contengano una Città e un rigido codice paese ISO a 2 lettere (es. CH).
Idempotenza e Log di Audit
Tieni traccia delle esecuzioni e garantisci l'integrità dei dati.
Tracciare gli Audit
Come monitorare le tue pipeline.
- Vai alla dashboard Automazioni e clicca su 'Visualizza log di audit'.
- La finestra fornisce una visualizzazione cronologica e granulare di ogni file elaborato.
- Puoi leggere i messaggi di eccezione esatti (es. indirizzi mancanti, formati IBAN non validi) per risolvere i problemi.
Protezione dai Duplicati
Come il sistema previene la doppia elaborazione.
- Digintu utilizza un hash di stato crittografico per catturare l'impronta esatta di una fattura.
- Le fatture NON vengono MAI elaborate due volte a meno che i dati sottostanti non vengano modificati in Xero.
- Questo garantisce che le pianificazioni sovrapposte vengano ignorate in modo sicuro.
Sicurezza Avanzata
Proteggi le tue pipeline di dati con Whitelist IP, chiavi SSH e firme HMAC-SHA256.
Whitelist IP (CIDR)
Limita l'accesso alle reti aziendali note.
- Vai su Automazioni e Feed e modifica la tua integrazione API o SFTP.
- In Sicurezza avanzata, inserisci i tuoi indirizzi IP statici o blocchi CIDR separati da virgole (es. 192.168.1.0/24).
- Le connessioni da IP non in elenco verranno immediatamente rifiutate (403 Forbidden).
- Lascia vuoto il campo per consentire le connessioni da qualsiasi IP.
SFTP senza password (Chiave pubblica SSH)
Usa chiavi crittografiche invece delle password per FileZilla o script.
- Genera una coppia di chiavi SSH sul tuo computer (es.
ssh-keygen -t ed25519). - Incolla la Chiave Pubblica nell'interfaccia Digintu in Sicurezza Avanzata.
- Configura il tuo client SFTP (come FileZilla) per utilizzare la Chiave Privata (Tipo di accesso: File chiave).
- La password standard verrà disabilitata automaticamente.
Firme API HMAC-SHA256
Firma crittograficamente i tuoi payload per prevenire manomissioni.
- Abilita HMAC nelle impostazioni di Sicurezza Avanzata del feed.
- Digintu genererà un Segreto API. Non condividere questo segreto.
- Prima di inviare una richiesta POST, calcola l'hash HMAC-SHA256 dei byte grezzi del file utilizzando il Segreto API.
- Invia la stringa esadecimale risultante nell'intestazione HTTP
X-Signature.
Know Your Contact (KYC)
Verifica le controparti con il registro svizzero Zefix per la conformità LRD.
Come funziona la verifica
Il processo di corrispondenza utilizza logiche rigorose sull'IDI e ricerca fuzzy sul nome.
- Digintu tenta innanzitutto di abbinare il contatto utilizzando il Numero di conto Xero, supponendo che contenga un IDI svizzero valido.
- Se non viene trovato alcun IDI o la corrispondenza fallisce, Digintu ricorre a una ricerca testuale utilizzando il nome del contatto.
- Se più entità condividono nomi simili, ti verrà presentata un'elenco per selezionare manualmente la controparte corretta.
Spiegazione dei campi Zefix
Comprendere i dati di conformità recuperati.
- EHRA-ID & CH-ID: Identificatori federali e cantonali univoci per l'entità.
- Data FUSC: La data della pubblicazione più recente nel Foglio ufficiale svizzero di commercio.
- Stato: Indica se la società è ATTIVA o LIQUIDATA. I badge rossi richiedono attenzione immediata.
- Sede legale e scopo: Verifica l'indirizzo ufficiale registrato e lo scopo sociale vincolante.
Sincronizzazione Xero
Come Digintu aggiorna la tua contabilità.
- Quando si collega un record verificato, Digintu utilizza il campo 'Numero di conto' in Xero per memorizzare l'IDI Zefix convalidato (es. CHE-123.456.789).
- Per impostazione predefinita, Digintu sovrascriverà tutti i dati esistenti nel campo Numero di conto per garantire la coerenza della conformità.
- È possibile disattivare questo aggiornamento automatico prima di fare clic su 'Accetta e collega'.
Prezzi e crediti
Costi di verifica.
- L'interrogazione del registro e la visualizzazione dei risultati di ricerca iniziali sono completamente gratuite.
- Il recupero del profilo di conformità completo e dettagliato costa 1 Credito di verifica.
- I crediti vengono detratti automaticamente dal saldo dell'area di lavoro in caso di recupero riuscito.
Fatturazione e Abbonamenti
Comprendi i nostri prezzi scalabili, l'utilizzo della capacità e la gestione degli abbonamenti.
Quote di transazione
- Il piano Gratuito include 10 estrazioni/sincronizzazioni al mese.
- Il piano Standard include 100 transazioni al mese.
- Il piano Avanzato include analisi illimitate.
Gestione dell'abbonamento e della capacità
- Vai su Profilo.
- Sotto "Capacità Workspace", clicca su "Gestisci Capacità" per scalare i posti nel team o le organizzazioni connesse.
- Tutte le modifiche alla fatturazione vengono calcolate proporzionalmente all'istante.
Sconti ONG Svizzere
- Durante il checkout, inserisci il tuo Zefix UID.
- Se la tua organizzazione è un'associazione/fondazione registrata, viene applicato uno sconto permanente del 50% al tuo abbonamento premium.
Upgrade e Downgrade
Modifica del tuo abbonamento di base.
- Passa al tuo Profilo.
- Fai clic su 'Esegui l'upgrade ad Avanzato' per cambiare tramite il portale Stripe. Il tempo non utilizzato viene ripartito.
- Per eseguire il downgrade a Standard, devi prima ridurre i posti del team e le organizzazioni connesse a 1.
- Fai clic su 'Esegui il downgrade a Standard' direttamente nell'interfaccia.
Gestione dei componenti aggiuntivi di capacità
Aggiunta di posti o organizzazioni.
- Nel piano Avanzato, fai clic su 'Gestisci Capacità'.
- Usa i pulsanti +/- per scalare i Posti Team o le Organizzazioni Connesse.
- Il sistema mostrerà un'anteprima dal vivo del costo proporzionale prima del salvataggio.
Portale Fatturazione Clienti
Fatture e Metodi di Pagamento.
- Fai clic su 'Gestisci Abbonamento' per accedere al portale sicuro Stripe.
- Aggiorna la tua carta di credito predefinita o l'indirizzo di fatturazione.
- Scarica fatture PDF e ricevute passate.
- Annulla il tuo abbonamento in qualsiasi momento (l'annullamento ha effetto alla fine del periodo di fatturazione corrente).
Piano Enterprise
Ambienti su misura per grandi operazioni.
- Include prezzi personalizzati pagati tramite fatturazione B2B e pagamenti tradizionali.
- Sblocca organizzazioni personalizzate illimitate, posti dedicati e onboarding personalizzato.
- Per richiedere un preventivo Enterprise, usa il pulsante di contatto in fondo alla pagina.
Gestione del team
Invita i colleghi, gestisci la capacità dello spazio di lavoro e comprendi il cambio di contesto ospite.
Invitare nuovi membri
- Passa alla scheda 'Team' nella barra di navigazione superiore.
- Fai clic su 'Invita membro' e inserisci il suo indirizzo email. Riceverà un link sicuro di 7 giorni per unirsi al tuo spazio di lavoro.
- Devi avere posti disponibili nel tuo piano di abbonamento per inviare un invito.
Cambio di spazio di lavoro e accesso ospite
Come navigare tra più account senza perdere l'abbonamento.
- Quando vieni invitato in un nuovo spazio di lavoro, ti unisci come 'Membro ospite'.
- Il tuo spazio di lavoro 'Home' originale (e il relativo piano di fatturazione) viene tranquillamente messo in pausa in background mentre sei un ospite.
- Tutte le azioni e le detrazioni di credito che esegui si applicheranno rigorosamente allo spazio di lavoro host a cui ti sei unito.
Lasciare uno spazio di lavoro ospite
Ritorno al tuo ambiente domestico.
- Se sei attualmente un Membro Ospite, naviga nel tuo Profilo.
- Scorri fino in fondo e fai clic sul pulsante 'Lascia spazio di lavoro'.
- Verrai immediatamente ripristinato nel tuo spazio di lavoro 'Home' originale come Proprietario.
- Se il Proprietario dello spazio di lavoro host ti rimuove dal suo team, questo processo di ripristino avviene automaticamente.
Sicurezza e autorizzazioni OAuth2
- Digintu eredita le autorizzazioni Xero direttamente tramite OAuth2.
- Se un membro del team non ha accesso esplicito a un'organizzazione in Xero, non può accedere ai suoi dati all'interno di Digintu.
Impostazioni spazio di lavoro
Personalizzazione del tuo ambiente.
- Il Proprietario dello spazio di lavoro può aggiornare il nome interno del team direttamente dall'intestazione della dashboard del Team.