Flusso
Importazione: rilascia un file o esporta modelli. Fattura: controlla i dati o inseriscili manualmente. Uscita: scegli formato, linee, sfondo, nomenclatura e comportamento batch.
Swiss QR Invoice
Supporto
Primi passi, aiuto con l’importazione e risposte alle domande frequenti su Swiss QR Invoice.
Indice
Crea una fattura QR in tre passaggi
- Crea una singola fattura o importa una tabella con più fatture. L’elaborazione in batch è inclusa in Pro.
- Controlla l’assegnazione delle colonne e i messaggi di verifica. Verifica il beneficiario, i dati di pagamento, gli importi e l’anteprima.
- Scegli il formato di output ed esporta i PDF. Salva le impostazioni ricorrenti in un profilo.
Modello di importazione
Il file di esempio usa le stesse colonne del modello nell’app. Sostituisci i dati di esempio con i tuoi. Puoi anche esportare modelli TXT e XLSX direttamente dall’app.
Solo dati di esempio. Non usare per pagamenti reali.
Uso
Crea fatture QR, prepara file di importazione ed esporta PDF correttamente.
Validazione
Anteprima e validazione mostrano se la fattura attuale può essere esportata. Con dati di esempio l’indicazione resta neutra.
Fattura
Le card seguono l’ordine sulla fattura QR: Conto / Pagabile a, Riferimento, Messaggio, Pagabile da e Importo. I dati importati restano bloccati.
Uscita
A4 posiziona la parte pagamento in basso. 210 x 105 mm crea solo la parte pagamento e non consente uno sfondo. L’abbondanza crea TrimBox, BleedBox e segni di taglio.
Nomenclatura
I nomi file possono usare segnaposto come {nummer}, {referenz}, {zahler} e {empfaenger}. Il numero progressivo controlla {nummer}.
Barra laterale destra
La barra laterale mostra i dettagli e le fatture importate. Apri il registro con l’icona dell’orologio nella barra degli strumenti.
Assegnazione colonne
Controlla i dati condivisi e ogni fattura nell’anteprima. Ogni riga può generare più fatture; i blocchi vuoti vengono ignorati. Riapri le assegnazioni da Importa → Modifica assegnazione colonne. Una nuova importazione sostituisce, dopo conferma, le modifiche successive alle fatture.
Profili
Apri la gestione dei profili dalla barra degli strumenti o dall’assegnazione delle colonne. I profili salvano impostazioni di output, beneficiario e assegnazioni opzionali, ma non le righe importate. Puoi salvare, caricare, aggiornare, rinominare, duplicare, eliminare, importare ed esportare i profili. I nomi devono essere univoci.
Esportazione batch
Fattura 1, Fattura 2 e così via vengono esportate in cartelle separate. Definisci un modello di nome per ogni gruppo. Scegli un PDF unico o un PDF per fattura; Suddividi in batch limita le fatture per batch. Il filtro dell’anteprima non cambia la selezione di esportazione. Usa le caselle per esportare una selezione.
Registro esportazioni
Apri il registro con l’icona dell’orologio. Mostra le ultime 20 esportazioni con stato, numero, durata e destinazione. Mostra la destinazione nel Finder, salva un rapporto TXT o riutilizza le impostazioni di output. L’annullamento chiude l’avanzamento; i file già scritti restano presenti. Viene registrato nel registro, non nella validazione. Svuotare il registro non elimina i file esportati.
Campi importazione
La prima riga contiene i nomi delle colonne. Ogni riga può generare una o più fatture in base alle assegnazioni. Le colonne non assegnate e i blocchi di fattura vuoti vengono ignorati.
spracheOpzionale
Lingua di uscita dei termini visibili della fattura QR.
Sono ammessi de, fr, it, rm ed en. Se vuoto o sconosciuto, Swiss QR Invoice usa il tedesco.
Esempio: de
Alias: language, lang, locale
ibanObbligatorio
Conto del beneficiario, registrato nel codice QR come IBAN/QR-IBAN.
IBAN CH o LI con cifra di controllo modulo 97 valida. Per tipo riferimento QRR deve essere un QR-IBAN con IID 30000-31999; per SCOR/NON non deve essere un QR-IBAN.
Esempio: CH6431961000004421557
Alias: account, qriban, konto
empfaengernameObbligatorio
Nome del beneficiario, cioe "Conto / Pagabile a".
Massimo 70 caratteri. Pagabile a e obbligatorio secondo SIX.
Esempio: Max Muster & Söhne
Alias: creditorname, zahlungsempfaenger, zahlbaran
empfaengerstrasseOpzionale
Via del beneficiario.
Massimo 70 caratteri. Swiss QR Invoice avvisa se manca la via.
Esempio: Musterstrasse
Alias: creditorstreet, strasseempfaenger
empfaengernrOpzionale
Numero civico del beneficiario.
Massimo 16 caratteri.
Esempio: 123
Alias: creditorbuildingnumber, creditornumber, nrempfaenger
empfaengerplzObbligatorio
NPA del beneficiario.
Massimo 16 caratteri. Necessario per l’indirizzo strutturato nella fattura QR.
Esempio: 8000
Alias: creditorpostalcode, plzempfaenger
empfaengerortObbligatorio
Località del beneficiario.
Massimo 35 caratteri. Necessario per l’indirizzo strutturato nella fattura QR.
Esempio: Seldwyla
Alias: creditortown, ortempfaenger
empfaengerlandObbligatorio
Paese del beneficiario.
Codice paese ISO a due lettere. Se vuoto, Swiss QR Invoice imposta CH.
Esempio: CH
Alias: creditorcountry, landempfaenger
referenztypOpzionale
Determina quale logica di riferimento viene usata per il pagamento.
QRR = riferimento QR, SCOR = Creditor Reference, NON = senza riferimento. Se vuoto o sconosciuto, Swiss QR Invoice usa QRR.
Esempio: QRR
Alias: referencekind
referenzOpzionale
Riferimento di pagamento per la registrazione automatica.
Per QRR esattamente 27 cifre con cifra di controllo modulo 10 recursive. Per SCOR un riferimento RF valido da 5 a 25 caratteri. Per NON lasciare vuoto.
Esempio: 000008207791225857421286694
Alias: reference
betragOpzionale
Importo da pagare.
Numero decimale con punto o virgola, minimo 0.00 e massimo 999999999.99. Vuoto significa importo non prestampato. Con 0.00 Swiss QR Invoice imposta il messaggio obbligatorio di non pagamento.
Esempio: 50.00
Alias: amount
waehrungOpzionale
Valuta dellimporto.
Sono ammessi CHF ed EUR. In Swiss QR Invoice QRR e consentito solo con CHF. Se vuoto o sconosciuto, viene usato CHF.
Esempio: CHF
Alias: currency
zahlernameOpzionale
Persona o azienda debitrice, indicata sulla fattura QR come "Pagabile da".
Facoltativo. Se indicato, massimo 70 caratteri; anche l’indirizzo deve essere plausibile.
Esempio: Simon Muster
Alias: debtorname, zahlungspflichtiger, zahlbardurch
zahlerstrasseOpzionale
Via del debitore.
Massimo 70 caratteri. Swiss QR Invoice avvisa se manca la via per un debitore indicato.
Esempio: Musterstrasse
Alias: debtorstreet, strassezahler
zahlernrOpzionale
Numero civico del debitore.
Massimo 16 caratteri.
Esempio: 1
Alias: debtorbuildingnumber, debtornumber, nrzahler
zahlerplzOpzionale
NPA del debitore.
Massimo 16 caratteri. Necessario se viene usato "Pagabile da".
Esempio: 8000
Alias: debtorpostalcode, plzzahler
zahlerortOpzionale
Località del debitore.
Massimo 35 caratteri. Necessario se viene usato "Pagabile da".
Esempio: Seldwyla
Alias: debtortown, ortzahler
zahlerlandOpzionale
Paese del debitore.
Codice paese ISO a due lettere. Se vuoto, Swiss QR Invoice imposta CH.
Esempio: CH
Alias: debtorcountry, landzahler
mitteilungOpzionale
Messaggio non strutturato nellarea "Informazioni aggiuntive".
Massimo 140 caratteri. Insieme a "rechnungsinformationen" sono ammessi al massimo 140 caratteri.
Esempio: Bezahlung der Reise
Alias: message, zusatzinformationen
rechnungsinformationenOpzionale
Informazioni di fatturazione strutturate per l’elaborazione automatica, ad es. secondo sintassi SWICO.
Facoltativo, massimo 140 caratteri. Insieme a "mitteilung" sono ammessi al massimo 140 caratteri.
Esempio: //S1/10/10201409/11/200701
Alias: billinginformation, strdbkginf
alternativesverfahren1Opzionale
Prima riga per una procedura di pagamento alternativa.
Facoltativo, massimo 100 caratteri. Usare solo se si vuole indicare consapevolmente una procedura alternativa supportata.
Alias: alternativeprocedure1, altpmt1, av1
alternativesverfahren2Opzionale
Seconda riga per una procedura di pagamento alternativa.
Facoltativo, massimo 100 caratteri. Usare solo se si vuole indicare consapevolmente una procedura alternativa supportata.
Alias: alternativeprocedure2, altpmt2, av2
Validazione
La validazione globale si trova in basso al centro. Controlla campi obbligatori, IBAN, riferimento, importo e lunghezza dei testi. I dettagli degli errori sono disponibili lì; le fatture importate non valide vengono ignorate durante l’esportazione. Annullare un’esportazione non cambia la validazione. I controlli non verificano il titolare del conto né l’esecuzione del pagamento.
Regole SIX importanti
- QRR richiede un QR-IBAN con IID 30000-31999 e un riferimento QR di 27 cifre con cifra di controllo modulo 10 corretta.
- SCOR usa una ISO Creditor Reference con prefisso RF e controllo modulo 97. NON significa senza riferimento; il campo riferimento resta vuoto.
- Messaggio e informazioni di fatturazione strutturate condividono nel codice QR larea "Informazioni aggiuntive" e possono occupare insieme al massimo 140 caratteri.
- Pagabile a e obbligatorio. Pagabile da è facoltativo, ma deve essere completo e valido se viene indicato un nome.
Le regole dei campi di importazione seguono la logica Swiss QR-Bill/SIX e la validazione attuale in Swiss QR Invoice.
Novità
Note di versione dall’App Store
Versione 2.0
- Aggiunta l’esportazione separata di più gruppi di fatture
- Aggiunti modelli di nomi file specifici per ogni gruppo
- Aggiunti profili riutilizzabili per velocizzare il lavoro
- Interfaccia macOS rinnovata per una navigazione più semplice
- Migliorate l’importazione Excel e l’assegnazione delle colonne
- Potenziata la verifica dei codici QR e dei PDF
- Aggiornati la guida e le traduzioni
- Miglioramenti generali e correzioni di bug
Domande frequenti
Quali file posso importare?
I file TXT, CSV, TSV e XLSX vengono importati come gruppi di fatture. I PDF e le immagini vengono analizzati per individuare un codice QR incorporato.
Le colonne non vengono riconosciute correttamente.
Controlla i nomi delle colonne nella prima riga e la loro assegnazione nell’app. Parti dal modello. Il file di esempio usa la codifica UTF-8 e il punto e virgola come separatore.
L’app segnala dati di pagamento non validi.
Controlla i campi segnalati e il messaggio di verifica. Verifica IBAN, tipo di riferimento, riferimento e indirizzi richiesti. Correggi gli errori prima di esportare.
Come esporto più fatture?
Pro permette di importare più fatture ed esportare PDF singoli o combinati. Controlla i gruppi selezionati, il formato di output e i nomi dei file prima dell’esportazione.
Il PDF viene ridotto durante la stampa.
Controlla il formato della carta e stampa al 100% o nelle dimensioni effettive. Disattiva l’adattamento automatico se modifica il formato di output scelto.
Pro non viene riconosciuto dopo l’acquisto.
Usa lo stesso account Apple dell’acquisto e scegli Ripristina acquisti nell’app. Acquisti, abbonamenti e rimborsi sono gestiti tramite l’App Store.
I dati delle fatture vengono caricati online?
Swiss QR Invoice elabora i dati delle fatture localmente sul tuo Mac. L’elaborazione non richiede un account né un servizio cloud proprietario.
Contatto
Scrivici con una breve descrizione del problema. Includi queste informazioni:
- Versione dell’app e versione di macOS
- Passaggio eseguito e messaggio di errore esatto
- Per problemi di importazione: formato del file e nomi delle colonne anonimizzati
Non inviare fatture reali, dati bancari o dati dei clienti. Usa solo dati anonimizzati negli esempi.