Architettura della Piattaforma & Concetti Operativi

Scopri come Digintu Pay automatizza l'esecuzione dei pagamenti, la digitalizzazione delle fatture e la riconciliazione contabile.

Architettura di Base: Convertitori vs. Pipeline

Sussiste una fondamentale distinzione operativa tra Convertitori di formato e Pipeline automatiche.

  • Convertitori: Regole che definiscono la trasformazione dei dati (es. mappatura da CSV a ISO 20022 pain.001 o da camt.053 a foglio Excel). Sono eseguiti su richiesta nella memoria del browser.
  • Pipeline: Percorsi continui e automatizzati che combinano una sorgente di ingresso, un convertitore e una destinazione di uscita.
  • Separazione Logica: Costruisci la regola nei Convertitori una sola volta, testala con dati di prova e infine distribuiscila in una Pipeline headless autonoma.

Modello di Elaborazione a Conservazione Zero

Digintu Pay agisce rigorosamente come middleware transitorio per la trasformazione dei dati.

  • Elaborazione in Memoria Volatile: I file caricati e le disposizioni vengono elaborati esclusivamente nella RAM del container applicativo.
  • Cancellazione Immediata: Una volta consegnato l'output al server SFTP bancario o al webhook, i dati originari vengono eliminati all'istante.
  • Trasparenza Contabile: I log di diagnostica mantengono solo metadati (nome file, orario, esito e hash SHA-256), senza salvare dati finanziari nei database permanenti.

Configurazione Spazio di Lavoro & Società

Imposta coordinate dell'ordinante, conti bancari predefiniti e parametri anagrafici.

Impostazione Dati Societari Predefiniti

Configura il conto bancario dell'ordinante e l'indirizzo aziendale.

  • Accedi al Profilo o apri un Convertitore nell'Editor di Mappatura.
  • Seleziona la Scheda 2 (Configurazione & Valori Predefiniti) e individua 'Conto di Addebito & Indirizzo (Debitore)'.
  • Inserisci l'IBAN ordinante predefinito e il codice BIC/SWIFT dell'istituto bancario.
  • Inserisci via, numero civico, CAP, città e codice paese ISO-2.
  • Salva. Questi parametri verranno inseriti automaticamente nei campi Group Header ISO quando i file di ingresso non contengono i dati dell'ordinante.

Gestione di Spazi Multipli

Gestisci comodamente filiali, holding o clienti contabili terzi.

  • L'isolamento dello spazio garantisce che pipeline, schemi personalizzati e registri di audit rimangano separati.
  • I Proprietari possono rinominare gli spazi attivi direttamente dalla schermata di Gestione Team.
  • I collaboratori con incarichi su più aziende possono accettare inviti come ospiti senza dover registrare nuovi account.

Catalogo Modelli & Schemi Predefiniti

Accedi a modelli di compensazione certificati per i circuiti bancari europei e svizzeri.

Esplorazione & Attivazione di un Modello

Seleziona schemi collaudati direttamente dalla libreria verificata.

  • Fai clic sul pulsante 'Catalogo' in alto a destra nella schermata dei Convertitori.
  • Filtra per software gestionale (Bexio, Abacus, Dynamics), formato bancario o circuito.
  • Fai clic su un modello per esaminare le corrispondenze preimpostate e i dati di test.
  • L'editor si aprirà con lo schema precaricato. Rinomina la regola e fai clic su 'Salva Regola' per aggiungerla al tuo spazio.

Editor di Mappatura Personalizzato

Costruisci mappature personalizzate per convertire tracciati ERP proprietari, file CSV o JSON in schemi ISO 20022.

1. Definizione Formati & Separatori

Guida passo-passo per impostare il file di origine.

  • Fai clic su 'Nuovo Convertitore' nella pagina Convertitori.
  • Assegna un nome chiaro alla regola (es. 'Pagamenti Settimanali - Dynamics').
  • Seleziona l'Ambito Finanziario: Debiti Fornitori, Riconciliazione Bancaria o Crediti Clienti.
  • Imposta il formato di ingresso (CSV, Excel, JSON, PDF) e lo schema ISO di arrivo (es. pain.001.09 svizzero, EPC SEPA).
  • Se tabulare, specifica i separatori di colonna (virgola, punto e virgola, pipe) e se la prima riga contiene le intestazioni.

2. Estrazione Attributi & Collegamento Campi

Rileva automaticamente le colonne e collegale ai campi ISO.

  • Nella barra laterale sinistra individua 'Dati di Esempio'. Fai clic su 'Trascina file' e carica un file di prova.
  • Fai clic su 'Estrai Attributi'. L'applicazione leggerà le intestazioni visualizzando una tabella di anteprima.
  • Passa alla Scheda 3 (Dettagli Mappatura) ed espandi i gruppi funzionali (Importi, Banca Beneficiario, Causale).
  • Per ogni campo ISO seleziona la colonna corrispondente dal menu a tendina.
  • Per valori non presenti nel file, definisci un valore fisso nel campo Valore di Riserva.

3. Regole di Modifica & Trasformazione

Applica pulizia caratteri, formattatori di importi e parser di date.

  • Fai clic sul menu a discesa delle trasformazioni accanto a ogni campo mappato.
  • Applica modificatori: 'Rimuovi Spazi', 'Forza Maiuscolo', 'Estrai Importo (1.000,50 -> 1000.50)' o 'Analizza Data'.
  • Per gli indirizzi, applica 'Scomposizione Intelligente (Nov 2026)' per separare via, numero civico e città.
  • Le trasformazioni multiple vengono eseguite in sequenza da sinistra verso destra.

Simulazione in Memoria (Test a Secco)

Simula le conversioni in tempo reale, controlla il file XML ed evita scarti bancari prima della trasmissione vera e propria.

Esecuzione di un Test di Simulazione

Collaudare le mappature direttamente nella memoria del browser.

  • Apri qualsiasi convertitore e fai clic su 'Test di Simulazione (Dry Run)' nel piè di pagina o sulla card del convertitore.
  • Nella finestra fai clic su 'Carica Dati di Prova' o trascina un file di test nell'area dedicata.
  • Fai clic su 'Esegui Simulazione'.
  • Il sistema elabora i dati nella RAM e mostra l'XML o JSON con colorazione sintattica.
  • Verifica importi totali e codici valuta, oppure fai clic su 'Scarica File' per controllarlo sul tuo computer.

Trasmissione Effettiva vs Simulazione

Conseguenze dell'attivazione della modalità di invio reale.

  • Nelle simulazioni avviate da una Pipeline compare l'opzione 'Modalità Trasmissione Effettiva'.
  • Disattivata (Predefinita): Genera il file per l'anteprima nel browser senza contattare server esterni.
  • Attivata: Il file generato viene fisicamente inoltrato all'endpoint di destinazione (SFTP bancario, Webhook). Da usare con cautela sui percorsi di produzione.

Creazione di una Pipeline Automatizzata

Automatizza percorsi continui di compensazione con esecuzione autonoma.

Procedura Guidata

Creazione completa di una nuova pipeline da zero.

  • Vai su 'Pipeline' dal menu e fai clic su 'Nuova Pipeline'.
  • Fase 1 (Dettagli): Assegna un nome, imposta la verifica dei duplicati (SHA-256) e inserisci le e-mail per i report.
  • Fase 2 (Ingresso): Scegli la sorgente (API REST dedicata, SFTP dedicato, Google Drive o Ricezione E-mail).
  • Fase 3 (Convertitore): Collega la regola di conversione predisposta per trasformare i file ricevuti.
  • Fase 4 (Uscita): Scegli la destinazione (SFTP bancario, Webhook esterno, Deposito SFTP Digintu o E-mail).
  • Fai clic su 'Attiva Pipeline'. Le credenziali e gli indirizzi endpoint saranno pronti immediatamente.

Canali di Ingresso (API, SFTP, Drive, E-mail)

Dettagli tecnici e specifiche per ogni protocollo di acquisizione.

Acquisizione tramite API REST Dedicata

Specifiche HTTP POST dirette.

  • Endpoint di Destinazione: Invia multipart/form-data o payload grezzi a https://api-pay-dev-1.digintu.ch/api/v1/pipelines/execute/api.
  • Autenticazione Header: Trasmetti la chiave del canale nell'header 'X-API-Key'.
  • Riscontro: Restituisce HTTP 200 con i metadati di avvenuta consegna, oppure HTTP 400 con il dettaglio diagnostico degli errori.

Cartelle di Deposito SFTP Dedicate

Ricezione automatizzata di esportazioni da server gestionali.

  • Server: Connettiti a ftps-pay.digintu.ch sulla porta 2222.
  • Autenticazione: Usa utente e password assegnati, oppure carica la tua chiave pubblica SSH per accedere senza password.
  • Directory: Deposita i file nella cartella principale /uploads. Il processo verificherà la scrittura completa ed elaborerà subito il file.

Acquisizione da Google Drive & Casella E-mail

Monitoraggio automatico di cartelle cloud e caselle di posta.

  • Google Drive: Inserisci un'e-mail Google autorizzata. Digintu configurerà una cartella condivisa crittografata.
  • Ricezione E-mail: Inoltra le fatture all'indirizzo unico assegnato (es. pay-in+key@digintu.tech). Gli allegati verranno estratti e analizzati immediatamente.

Destinazioni di Uscita & Webhook

Trasmissione dei messaggi ISO 20022 validati verso sistemi bancari o di tesoreria.

Configurazione Webhook Esterni

Invio dei flussi JSON o XML ad altri server applicativi.

  • Nella procedura guidata (Fase 4), scegli 'API Utente'.
  • Inserisci l'URL di destinazione (es. https://erp.azienda.ch/webhooks/pagamenti).
  • Inserisci gli header di autorizzazione (token Bearer, chiavi API) o metadati personalizzati.
  • Abilita la firma crittografica HMAC se il tuo server richiede la verifica dell'autenticità del pacchetto.

Trasmissione su SFTP Bancario Esterno

Consegna diretta delle disposizioni ai server bancari host-to-host.

  • Seleziona 'SFTP Esterno' come destinazione.
  • Inserisci hostname della banca, porta (in genere 22), nome utente e cartella di destinazione (es. /clearing/inbound/).
  • Scegli il tipo di accesso: Password oppure Chiave privata SSH autorizzata dal tuo istituto.
  • I file trasformati saranno inviati direttamente alla banca appena completata la pipeline.

HMAC, Whitelist IP & Chiavi SSH

Proteggi gli endpoint contro accessi indesiderati, intrusioni e attacchi replay.

Configurazione Whitelist IP (CIDR)

Limitare l'ingresso agli indirizzi IP statici aziendali autorizzati.

  • Apri le impostazioni della pipeline e vai su 'Sicurezza d'Ingresso'.
  • Inserisci gli IP pubblici aziendali in formato CIDR (es. 195.141.22.0/24, 84.115.10.4).
  • Salva. Le richieste provenienti da indirizzi non autorizzati saranno respinte all'istante con errore HTTP 403 Forbidden.

Firma dei Messaggi HMAC-SHA256

Verifica dell'integrità del contenuto tramite crittografia.

  • Verifica in Ingresso: Consenti solo richieste HTTP provviste di firma HMAC generata con la chiave segreta del canale.
  • Firma in Uscita: Digintu firma i messaggi HTTP uscenti inserendo il digest nell'header designato (predefinito: X-Signature).
  • Qualsiasi alterazione del contenuto durante il transito invaliderà la firma, inducendo il server ricevente a respingere il file in sicurezza.

Indirizzi Strutturati Nov 2026

Preparati alla scadenza vincolante per gli indirizzi strutturati nei circuiti SIX ed EPC.

Quadro Normativo: Rifiuto Indirizzi Non Strutturati

Perché i vecchi indirizzi liberi a 7 righe non saranno più accettati.

  • Obbligo Normativo: I circuiti di compensazione svizzeri ed europei richiedono la totale rimozione dei campi indirizzo non strutturati (AdrLine) entro novembre 2026.
  • Conseguenze: I bonifici con indirizzi generici saranno respinti automaticamente dalle banche.
  • Requisito: Gli indirizzi di creditore e debitore devono essere separati in Nome Via (StrtNm), Numero Civico (BldgNb), CAP (PstCd), Città (TwnNm) e Paese (Ctry).

Motore di Scomposizione Automatica

Come Digintu Pay normalizza e ripartisce i dati anagrafici.

  • Nell'Editor di Mappatura, collega il testo completo dell'indirizzo al campo rawUnstructuredAddress.
  • Applica il modificatore: 'Scomposizione Intelligente (Nov 2026)'.
  • L'algoritmo riconosce ed estrae toponimi, numeri civici e CAP nei formati europei.
  • Il file ISO 20022 pain.001 conterrà i tag XML strutturati conformi alle convalide ufficiali.

Riconciliazione Estratti Conto CAMT.053

Elabora estratti conto bancari giornalieri ed esporta fogli CSV o Excel per la contabilità generale.

Lettura delle Voci CAMT.053

Estrazione saldi iniziali e finali, date contabili e causali.

  • Trascina il file XML CAMT.053 in un convertitore o automatizzane la ricezione via SFTP.
  • Il lettore ricava saldi contabili, date valuta, codici dare/avere (CRDT/DBIT) e importi.
  • Descrizioni e riferimenti (SCOR / QRR) vengono normalizzati in colonne ordinate.
  • Scarica il risultato come cartella di lavoro Excel o trasferiscilo direttamente al gestionale via webhook.

QR-Bills Svizzere & ZUGFeRD / Factur-X

Genera sezioni di pagamento QR svizzere ufficiali e fatture elettroniche Factur-X conformi.

Regole per l'Emissione di QR-Fatture

Verifica di conti QR-IBAN e riferimenti strutturati a 27 cifre.

  • Nell'Editor, seleziona l'ambito Fatturazione con destinazione 'QR-Fattura Cliente (PDF)'.
  • Inserisci il conto ufficiale del creditore (QR-IBAN con prefisso CH o LI).
  • Se nei dati di fatturazione mancano i riferimenti, attiva 'Calcolo Automatico Riferimenti Mancanti'.
  • Il motore produce sezioni di pagamento stampabili conformi con croce svizzera e codice QR ufficiale.

Profili XML ZUGFeRD / Factur-X

Compilazione di fatture ibride conformi alla direttiva EN16931.

  • Seleziona il formato 'ZUGFeRD Cliente (PDF)' o 'Ibrido QR + ZUGFeRD'.
  • Scegli il profilo: BASIC (standard commerciale), EN16931 (appalti pubblici europei) o EXTENDED.
  • Il PDF/A-3 risultante include il documento leggibile visivamente e l'XML integrato per l'acquisizione automatica.

Gestione Team & Ruoli (Proprietario vs Membro)

Controllo dei permessi, collaborazione con ospiti e gestione degli inviti.

Differenza tra PROPRIETARIO e MEMBRO

Attività operative rispetto alla gestione della fatturazione.

  • Ruolo PROPRIETARIO: Controllo amministrativo completo. Gestisce piani Stripe, postazioni, inviti nel team, rotazione chiavi ed eliminazione spazio.
  • Ruolo MEMBRO: Permessi operativi. Può creare e modificare Convertitori, eseguire pipeline, consultare i registri e scaricare file elaborati.
  • Separazione di Sicurezza: I membri non possono visualizzare chiavi private né accedere al portale pagamenti.

Accesso Ospite in Spazi di Lavoro Terzi

Collaborare negli ambienti dei clienti mantenendo il proprio profilo.

  • Quando un utente accetta un invito per un altro spazio, vi accede come Membro Ospite operativo.
  • La sua società originaria, l'abbonamento e le pipeline personali rimangono attivi in background.
  • Per tornare al proprio ambiente in qualunque momento, basta fare clic su 'Abbandona Spazio' nelle impostazioni del Profilo.

Fatturazione, Capacità & Crediti di Transazione

Comprendere le quote transazioni, i componenti aggiuntivi e i livelli di servizio.

Conteggio dei Crediti di Transazione

Consumo misurato per singola disposizione verificata.

  • Transazioni: Ogni singola disposizione di bonifico in un pain.001 o riga contabile in un estratto consuma 1 Credito.
  • Piano Free: Include 10 crediti gratuiti ogni mese per verifiche estemporanee e piccoli lotti.
  • Piano Standard: Include 250 transazioni/mese, 1 pipeline automatizzata attiva e 1 utente.
  • Piano Advanced: Include 1'000 transazioni/mese, 3 pipeline automatizzate e 3 licenze team.

Adeguamento Risorse (Pipeline, Postazioni & Crediti)

Aggiornamenti pro-rata gestiti tramite Stripe.

  • I titolari del piano Advanced possono aumentare le risorse senza modificare l'intero piano.
  • Vai su Profilo > Capacità Spazio di Lavoro > Gestisci Capacità.
  • Regola i selettori per aggiungere postazioni (+EUR 9/mese), pipeline (+EUR 35/mese) o pacchetti da 100 transazioni (+EUR 15/pacchetto).
  • I conteggi pro-rata vengono calcolati e applicati al ciclo di fatturazione in corso.

Tracciabilità di Audit & Risoluzione Errori

Ispeziona i log di esecuzione, verifica la deduplicazione ed esamina eventuali bonifici scartati.

Esame dei Registri di Controllo

Verifica di orari, numero di elementi elaborati e codici di stato.

  • Dalla schermata delle Pipeline, fai clic su 'Azioni' > 'Visualizza Log di Audit' accanto al canale.
  • Un registro cronologico mostrerà tutte le esecuzioni recenti, i nomi file originali, gli orari e l'esito di convalida.
  • Fai clic su qualsiasi riga per copiare il nome file originario e consultare eventuali avvertenze.

Protezione dai Duplicati & Idempotenza

Come l'impronta crittografica SHA-256 previene i doppi pagamenti.

  • Se l'opzione 'Consenti File Duplicati' è disattivata, il sistema calcola l'hash SHA-256 di ogni file ricevuto.
  • Se un file identico viene inoltrato entro 30 giorni, il flusso viene bloccato con un avviso di collisione.
  • Si prevengono così pagamenti doppi ai fornitori causati da esportazioni ripetute per errore dal gestionale.