Ordini di pagamento pain.001 per la Svizzera [BETA]

L'estensione Ordini di pagamento consente di generare file XML nel formato pain.001, a partire dalle registrazioni contabili o dalla scansione di codici QR. 

Le informazioni necessarie per effettuare un pagamento, come il beneficiario, il conto IBAN e l'importo, vengono salvate nelle registrazioni come dati di pagamento. Uno o più pagamenti possono quindi essere inclusi in un ordine di pagamento e generati in un file XML nel formato pain.001, pronto per essere caricato nel portale della propria banca o di un altro istituto finanziario.

I messaggi XML generati sono conformi alle raccomandazioni svizzere pain.001.001.09.ch.03, secondo gli attuali Swiss Payment Standards.

Requisiti e raccomandazioni

• La funzionalità di pagamento è attualmente disponibile in Banana Accounting+ Dev Channel.
• L'estensione richiede il piano Advanced. Se non disponi di questo piano, puoi richiedere al nostro servizio clienti l'attivazione di 1 mese gratuito.
• L’estensione è attualmente in fase di Beta Test. Verifica attentamente il funzionamento e segnalaci eventuali problemi.
• Ti consigliamo di utilizzare una copia del tuo file contabile o un file vuoto per effettuare alcuni test con i file di pagamento.
• Dopo aver caricato il file di pagamento XML sul portale della tua banca o di PostFinance, verifica sempre attentamente i dati dei pagamenti visualizzati nel portale.

Aggiornamento versione canale Release Beta

Ultimo aggiornamento: 29.09.2026

A partire dal 21 novembre 2026, gli indirizzi nei file di pagamento pain.001 dovranno essere trasmessi esclusivamente in forma strutturata o ibrida. Gli istituti finanziari raccomandano l'utilizzo dell'indirizzo strutturato e alcuni supportano esclusivamente questo formato. Abbiamo perciò scelto di adottare gli indirizzi strutturati, garantendo una maggiore compatibilità.

In vista di questi cambiamenti, è stata rilasciata una nuova versione dell'estensione nel canale Release Beta, che integra lo standard SPS 2025 e consente di generare ordini di pagamento con indirizzi strutturati. Vedi anche Passaggio agli indirizzi strutturati.

L'estensione rimarrà disponibile per un periodo nel canale Release Beta, così da consentire agli utenti di testarla e segnalarci eventuali problemi o suggerimenti di miglioramento.

Per provare il nuovo formato di trasmissione con gli indirizzi strutturati:

• Scarica e installa l'ultima versione di Banana Accounting+ Dev Channel
• Apri il menu Estensioni > Gestisci estensioni...
• Seleziona Svizzera
• Seleziona la voce Online > Produttività
• Seleziona dalla lista Ordini di pagamento pain.001 per la Svizzera
• Clicca sul bottone Installa a destra
• Nel canale preferito seleziona Release Beta al posto di Release Stabile

Puoi tornare al canale Release Stabile in qualsiasi momento.

Tipi di pagamenti supportati

L'estensione supporta il seguente standard:

• SPS 2025 ISO-Version 2019 (pain.001.001.09.ch.03) con indirizzi strutturati

Sono supportati i seguenti tipi di pagamento:

• D: pagamenti nazionali in Svizzera, in CHF e in EUR.
• S: pagamenti SEPA in EUR.
• X: pagamenti in altre valute, esclusivamente verso conti con IBAN.

Preparare Banana Contabilità+ per i pagamenti

1. Preparare il file contabile

Prima di utilizzare questa estensione, procedi come segue:

• Apri il tuo file contabile. 
  • Se preferisci non modificare il file originale, puoi crearne una copia oppure creare un nuovo file (una contabilità doppia o una contabilità entrate-uscite) in cui registrare i tuoi pagamenti.
• Nella tabella Conti, verifica che sia presente la vista Indirizzi.
  • Se necessario, aggiungila con il comando Strumenti > Aggiungi/Rimuovi funzionalità... selezionando la voce Aggiungi colonne indirizzi nella tabella Conti.
  • Se nella vista Indirizzi mancano alcune colonne necessarie (ad esempio la colonna IBAN), consulta la documentazione Vista Indirizzi.

2. Attivare la funzionalità di pagamento

• Apri il menu Strumenti > Aggiungi/Rimuovi funzionalità... 
• Seleziona la voce Aggiungi funzionalità di pagamento e premi OK. 
  • Questa funzionalità è visibile solo in Banana+ Dev Channel con il piano Advanced.

3. Installare l'estensione manualmente (se necessario)

Se utilizzi una contabilità in CHF, l'estensione viene installata automaticamente. Negli altri casi, devi installarla manualmente:

• Apri il menu Estensioni > Gestisci estensioni...
• Seleziona Svizzera.
• Seleziona la voce Online > Produttività.
• Seleziona dalla lista Ordini di pagamento PAIN.001 per la Svizzera.
• Clicca sul pulsante Installa.

Configurare l'estensione

• Apri il file contabile.
• Apri il menu Estensioni > Gestisci estensioni...
• Seleziona l'estensione Ordini di pagamento PAIN.001 per la Svizzera.
• Clicca sulla freccia a sinistra del nome per visualizzare il contenuto dell'estensione.
• Seleziona Credit Transfer File for Switzerland.
• Clicca sul pulsante Impostazioni a destra.

• Mittente del messaggio
  Nome del mittente del messaggio pain.001, massimo 70 caratteri. Di default viene utilizzato il nome impostato nei dati base della contabilità (comando File > Proprietà file..., Indirizzo). Utilizza questo parametro se il nome in contabilità non coincide con il nome della persona che effettua l'ordine di pagamento.
• Campo per informazioni supplementari (nome XML)
  Nome XML della colonna nella tabella Registrazioni che contiene informazioni aggiuntive da trasmettere con il pagamento. La colonna può anche essere aggiunta alla tabella Registrazioni.
• Gruppo creditori (separare più gruppi con il carattere ;)
  Indica il gruppo definito nella tabella Conti che contiene l'elenco dei conti dei fornitori. I conti appartenenti a questo gruppo verranno visualizzati sotto la voce Account ID nella finestra di dialogo Dati di Pagamento, consentendo il completamento automatico delle informazioni di pagamento.
  Per includere più gruppi, separali con un punto e virgola. Ad esempio, se hai due gruppi di creditori, inserisci: CRED_CHF;CRED_EUR

Impostare i conti bancari e i fornitori

1. Impostare il conto bancario d'addebito

Queste impostazioni non sono obbligatorie, ma possono velocizzare la creazione dell'ordine di pagamento, poiché i dati vengono proposti automaticamente durante la procedura.

• Nella tabella Conti seleziona la vista Indirizzi (vedi Installazione)
• Completa i dati dei conti bancari o postali che utilizzi per effettuare i pagamenti. Compila in particolare:
  • Nome e Cognome / Organizzazione: indicano il titolare del conto da addebitare.
  • IBAN: inserisci l'IBAN del conto bancario o postale da addebitare.
  • Bank clearing: inserisci il codice BIC dell'istituto finanziario da addebitare. 
    Questa colonna è stata utilizzata temporaneamente per memorizzare il codice BIC, in attesa dell'introduzione della colonna specifica BIC.

2. Impostare i fornitori

Queste impostazioni non sono obbligatorie, ma possono velocizzare la creazione dell'ordine di pagamento. Se si inseriscono l'indirizzo e le coordinate bancarie dei fornitori, queste informazioni verranno proposte al momento dell'inserimento dei dati di pagamento.

• Nella tabella Conti seleziona la vista Indirizzi (vedi Installazione)
• Per ogni fornitore indica l'indirizzo e le coordinate bancarie, come nome fornitore, conto IBAN e numero BIC.

Aggiungere i dati di pagamento

I dati di pagamento sono quelli necessari per effettuare un pagamento, come il nome del beneficiario, il suo conto IBAN, l'importo da versare. Queste informazioni vengono salvate a livello di riga nella tabella Registrazioni e verranno utilizzate durante la generazione dell'ordine di pagamento.

Ci sono diverse modalità per aggiungere i dati di pagamento:

• Direttamente nella tabella Registrazioni, cliccando sulla colonna Dati di Pagamento.  Se la riga riguarda la registrazione della fattura con il conto del fornitore, questi dati verranno ripresi in automatico.
   
• Scansionando un codice QR con il comando Report > Fornitori > Scan QR-Code... 
  In seguito alla scansione del codice QR verrà aggiunta una riga di registrazione con i relativi dati di pagamento.
  Vedi anche Configura lo scanner per la lettura dei codici QR (inglese)
   
• Selezionando il comando Report > Fornitori > Crea file di pagamento... 
  Questo comando visualizzerà il dialogo Crea file di pagamento con l'elenco dei dati di pagamento aperti. In questo dialogo è possibile aggiungere nuovi pagamenti con il pulsante Nuovo pagamento o Scansiona codice QR. Questi dati verranno salvati in nuove righe della tabella Registrazioni.

In tutti questi casi, i dati di pagamento vengono salvati nella colonna Dati di pagamento della tabella Registrazioni. Si può visualizzare o nascondere questa colonna con il comando Dati > Disponi colonne. Se la colonna Dati di Pagamento non è presente nell'elenco, si può aggiungerla con il comando Strumenti > Aggiungi/Rimuovi funzionalità... > Aggiungi funzionalità di pagamento.

Campi dei dati di pagamento 

• Payment Method
  Puoi scegliere tra pagamento bancario o postale (IBAN/QR-IBAN) per i pagamenti all'interno della Svizzera e trasferimenti SEPA per i pagamenti all'interno dell'Europa.
   
• Creditor Account ID
  Quando selezioni un creditore dall'elenco, i suoi dettagli verranno compilati automaticamente utilizzando le informazioni memorizzate nella tabella Conti. Se l'elenco è vuoto, verifica le impostazioni dell'estensione.
  Per visualizzare i conti, definiti nella tabella Conti, devi specificare il gruppo di creditori nelle impostazioni dell'estensione per i pagamenti. 
  Puoi includere più gruppi di creditori separandoli con un punto e virgola.
  Consulta il capitolo Configurare l'estensione pagamenti.

Creare l'ordine di pagamento

L'ordine di pagamento contiene i pagamenti che desideri trasmettere alla banca. Al termine della procedura viene generato un file XML pain.001 da caricare nel portale della banca.

Per creare l'ordine di pagamento:

1. Prepara i dati di pagamento come descritto nella sezione di questa pagina Aggiungere i dati dei pagamenti.
2. Seleziona il comando Report > Fornitori > Crea file di pagamento...
   Puoi anche selezionare dapprima le righe con i dati di pagamento nella tabella Registrazioni e poi con il menu contestuale (pulsante destro del mouse) selezionare il comando Crea file di pagamento...
3. Seleziona i pagamenti che si desiderano includere nell'ordine.  Se appare il testo ** sulla sinistra, significa che i dati non sono corretti o sono incompleti. Puoi modificarli con il pulsante Modifica pagamento.
4. Clicca Successivo. Questo pulsante è abilitato quando i pagamenti da includere selezionati sono completi e senza errori.
5. Completa con le informazioni del conto da addebitare.
6. Clicca Successivo. Verrà creato il file XML e visualizzato il suo contenuto.
7. Clicca Sfoglia... per selezionare la cartella di destinazione dove verrà salvato il file XML.
8. Clicca Esporta. Apparirà il dialogo per confermare il salvataggio del file XML.

Vedi anche:

• Ordini di pagamento per le fatture dei fornitori

In Banana non è possibile collegarsi direttamente alla banca per trasmettere il messaggio. Bisogna aprire l'applicazione o fare il login nel sito della banca e caricare il file XML, salvato in precedenza sul proprio computer. 

Gestire i dati e i file di pagamento

Modificare o rimuovere i dati di pagamento

I pagamenti sono memorizzati nella colonna Dati di Pagamento (PaymentData) della tabella Registrazioni. Ci sono due tipi di oggetti che possono essere memorizzati:

• payment/data oggetto che contiene le informazioni su uno specifico pagamento. Queste informazioni serviranno per completare l'ordine di pagamento.
• payment/file oggetto contenente le informazioni di un ordine di pagamento, incluso il file xml creato.

Per rimuovere questi dati è sufficiente cancellare la riga di registrazione oppure gli oggetti stessi.

Attenzione! Gli oggetti payment/file servono a determinare se un pagamento è stato eseguito o meno.
Si consiglia perciò di non rimuovere le righe contenenti questi oggetti, altrimenti i pagamenti già eseguiti continueranno a comparire tra quelli in sospeso, poiché il riferimento a tali pagamenti verrà eliminato insieme all'oggetto payment/file.

Stato dei pagamenti

Ci sono due stati di pagamento:

• Pending
  L'oggetto payment/data non è presente in nessun file di pagamento. 
• Downloaded
  L'oggetto payment/data è incluso in uno o più file di pagamento.

Elenco dei pagamenti

Questa tabella visualizza tutti i pagamenti inclusi nei file di pagamento (stato downloaded). È possibile filtrare e raggruppare in base alle opzioni presenti nel dialogo.

API

Payment API

Cronologia modifiche

Vedi la cronologia delle modifiche.