Questo layout di stampa fatture, tramite il dialogo Impostazioni, ti permette di cambiare le impostazioni di stampa. Le impostazioni sono simili al layout UNI11 con in più la possibilità di stampare il QR Code Svizzero.

Vedi anche:

• Informazioni generali sulla Personalizzazione della stampa fatture.
• Offerte e fatture
  • Stampa Offerte e Fatture.
  • Come fare per la stampa delle Offerte e Fatture.
• Fatture in contabilità
  • Stampa fatture.
  • Come fare per la stampa delle fatture integrate in contabilità.

Dialogo impostazioni fattura

Per accedere al dialogo impostazioni dei parametri della fattura hai due possibilità:

• Dal dialogo di stampa fatture, sezione Layout, bottone Impostazioni.
  • Dialogo Stampa Fatture per la fatturazione integrata nella contabilità.
  • Dialogo Stampa Fatture per l'Applicativo Offerte e Fatture.
• Dall'Anteprima di stampa, cliccando sul simbolo rotellina dentata (impostazioni).

Il dialogo è composto da diversi livelli e sottolivelli che permettono di intervenire su parti specifiche della fattura:

• Stampa
  Gli elementi che compongono la stampa della fattura, con la possibilità di personalizzarli.
• Testi
  I testi, nelle diverse lingue, che sono usati per la stampa.
• QR-Code
  Le impostazioni per la stampa del QR-Code svizzero.
• Stili
  Cambia il carattere e i colori.
• Programmazione (proprio File JavaScript/CSS)
  È un livello ancora più alto di personalizzazione, che però richiede conoscenze di programmazione.
  Si può intervenire sui diversi elementi di stampa, cambiandoli o sostituendoli.

Il bottone Ripristina valori predefiniti del dialogo azzera tutte le impostazioni, ripristinandole con i valori predefiniti.
Confermando con Ok, confermi e salvi i parametri inseriti.
Puoi annullare e ripristinare le modifiche fatte ai parametri con il comando Menu → Modifica → Annulla operazione.

Proprietà Stampa

Con questo livello si definiscono quali elementi della fattura includere e quali invece escludere dalla stampa della fattura.

È diviso in più sottolivelli, ognuno dei quali permette di gestire un elemento diverso della fattura.

Intestazione

Elemento del dialogo che permette di definire l'intestazione nella parte superiore della pagina della fattura.

• Intestazione pagina
  Vista la casella per includere l'indirizzo del mittente nell'intestazione della fattura.
  L'indirizzo viene ripreso in automatico dai dati base del file, definito in File → Proprietà file (Dati base) → Indirizzo. Il codice IVA è obbligatorio e deve essere inserito nell'apposito campo.
• Testo riga 1 ... Testo riga 5
  Se non vuoi utilizzare i dati base dell'indirizzo, puoi inserire manualmente i testi che vuoi usare.
  Questi testi saranno visualizzati nell'intestazione e sostituiscono quelli eventualmente definiti nelle Proprietà file.
  In questo caso il numero IVA non è stampato in automatico. Siccome è obbligatorio, è necessario aggiungerlo manualmente in una delle righe.
• Logo
  Vista la casella per includere il logo nell’intestazione.
  Il logo è definito tramite il comando in File → Imposta logo, dove puoi impostare anche la dimensione, scegliere come allinearlo (sinistra, centro, destra), e scegliere anche come allineare l'indirizzo rispetto al logo.
• Nome logo
  Inserisci il nome della personalizzazione del logo definito nel menu File → Imposta logo, rispettando maiuscole  e minuscole.

Indirizzo cliente

Elemento del dialogo che permette di impostare alcuni parametri relativi alla stampa dell'indirizzo di fatturazione.

Gli indirizzi dei clienti sono ripresi dalle colonne della tabella Conti → vista Indirizzi per la fatturazione integrata, e dalla tabella Contatti per l'applicativo Offerte e Fatture.

• Testo indirizzo mittente
  Sopra l’indirizzo del cliente puoi inserire una riga nella quale indicare l’indirizzo del mittente.
  Lascia vuoto per utilizzare l’indirizzo definito in File → Proprietà file (Dati base) → Indirizzo, oppure inserisci un testo manualmente.
  Inserisci <none> per non inserire la riga del mittente.
• Composizione indirizzo
  Decidi come comporre l'indirizzo. Inserisci i nomi XML delle colonne degli indirizzi nell'ordine che preferisci: per la fatturazione integrata tabella Conti (vista Indirizzo), per l'applicativo Offerte e Fatture tabella Contatti. Ogni nome colonna deve essere incluso tra i segni "<" e ">".
  Puoi visualizzare il nome XML di ogni colonna con il comando disponi colonne, scheda Impostazioni.
  
  Puoi utilizzare solo le seguenti colonne (altre colonne non sono utilizzabili):
  
  Colonna Prefisso (nome XML = NamePrefix).
  Colonna Organizzazione (nome XML = OrganisationName).
  Colonna Nome (nome XML = FirstName).
  Colonna Cognome (nome XML = FamilyName).
  Colonna Via (nome XML = Street).
  Colonna IndirizzoExtra (nome XML = AddressExtra).
  Colonna CasellaPostale (nome XML = POBox).
  Colonna CodicePostale (nome XML = PostalCode).
  Colonna Località (nome XML = Locality).
  Colonna Regione (nome XML = Region).
  Colonna Nazione (nome XML = Country).
  Colonna NazioneCodice (nome XML = CountryCode).
  Colonna EmailLavoro (nome XML = EmailWork).
  
  Alcuni esempi:
  • Includere nome organizzazione, indirizzo, codice postale e località:
    <OrganisationName>
    <Street>
    <PostalCode> <Locality>
  • Includere prefisso, nome, cognome, indirizzo, codice postale e località:
    <NamePrefix>
    <FirstName> <FamilyName>
    <Street>
    <PostalCode> <Locality>
  • Includi indirizzo extra, casella postale e codice nazione:
    <OrganisationName>
    <NamePrefix>
    <FirstName> <FamilyName>
    <Street> <AddressExtra>
    <POBox>
    <CountryCode> - <PostalCode> <Locality>
     
• Allinea a sinistra
  Vista la casella per stampare l'indirizzo a sinistra, in caso contrario sarà stampato sulla destra.
• Sposta orizzontalmente
  Inserisci un valore in cm per spostare a destra (valore positivo) o a sinistra (valore negativo) l'indirizzo del cliente.
• Sposta verticalmente
  Inserisci un valore in cm per spostare in basso (valore positivo) o in alto (valore negativo) l'indirizzo del cliente.
• Indirizzo di spedizione
  Disponibile solo per la fatturazione integrata nella contabilità.
  Viene stampato anche l’indirizzo di spedizione.
  L'indirizzo di spedizione viene inserito tramite il codice :sadr nella colonna TipoDoc della tabella Registrazioni per definire l'indirizzo di spedizione.

Informazioni

Elemento del dialogo che permette di definire quali informazioni della fattura includere e quali invece escludere dalla stampa (in alto a sinistra).

Fatturazione integrata:

• Numero fattura / nota di credito
  Indicato nella colonna DocInvoice della tabella Registrazioni.
• Data fattura
  Indicata nella colonna Data della tabella Registrazioni.
• Numero ordine
  Indicato nella colonna TipoDoc della tabella Registrazioni tramite il codice :ordn
• Data ordine
  Indicato nella colonna TipoDoc della tabella Registrazioni tramite il codice :ordd
• Numero cliente
  Indicato nella registrazione della fattura nella tabella Registrazioni.
• Numero IVA cliente
  Indicato nella colonna Numero IVA della tabella Conti, vista Varia.
• Numero fiscale cliente
  Indicato nella colonna Numero Fiscale della tabella Conti, vista Varia.
• Scadenza fattura
  La data di scadenza di una fattura può essere impostata in modi diversi. Per maggiori informazioni si rimanda alla pagina Scadenze e termini di pagamento.
• Numero pagina
  Il numero di pagina corrente.

Applicativo Offerte e Fatture:

• Numero fattura / offerta
  Indicato nella colonna Id della tabella Fatture / Offerte.
• Data fattura
  Indicata nella colonna Data della tabella Fatture / Offerte.
• Numero ordine
  Indicato nel campo Nr ordine del dialogo di creazione/modifica della fattura.
• Data ordine
  Indicato nel campo Data ordine del dialogo di creazione/modifica della fattura.
• Numero cliente
  Indicato nella colonna Contatto Id della tabella Fatture / Offerte.
• Numero IVA cliente
  Indicato nella colonna Numero IVA della tabella Contatti.
• Numero fiscale cliente
  Indicato nella colonna Numero Fiscale della tabella Contatti.
• Scadenza fattura
  Indicata nella colonna Scadenza della tabella Fatture / Offerte.
  La data di scadenza di una fattura può essere impostata in modi diversi. Per maggiori informazioni si rimanda a Impostare il termine di pagamento.
• Numero pagina
  Il numero di pagina corrente.
• Campi personalizzati
  Solo con il Piano Advanced.
  Vengono aggiunti tutti i campi di informazioni aggiuntive personalizzati definiti nella sezione Fattura del Dialogo fattura.

Dettagli fattura

Per dettagli fattura si intende la tabella che indica gli articoli, quantità, prezzi e totali.

Personalizzazioni colonne predefinite

Permette di selezionare le colonne da visualizzare nei dettagli della fattura direttamente da un elenco.
L'elenco comprende alcune personalizzazioni di colonne già predisposte tra cui scegliere. Alcune di esse richiedono il Piano Advanced di Banana Contabilità Plus.

Seleziona una composizione di colonne dalla lista e conferma.
I valori delle proprietà Nomi colonne, Larghezza colonne, Allineamento titoli, Allineamento testi della sezione Dettagli fattura, e la proprietà Nomi colonne dettagli fattura della sezione Testi, vengono impostati in automatico dal programma.

Disponibile dalla versione 10.0.10.21348 o più recente di Banana Contabilità Plus.

Logica della disposizione delle colonne

Le colonne da visualizzare possono essere definite manualmente in questo modo:

• Nei nomi colonne si indicano i nomi XML delle colonne da stampare.
• Nei campi successivi si indicano le caratteristiche di stampa delle singole colonne.
  • Larghezza colonna.
  • Allineamento titoli.
  • Allineamento testi.
• Nella sezione Testi si indicano i testi dell'intestazione delle colonne.
  • Per ogni lingua bisogna indicare il testo per l'intestazione.

Selezionando un'impostazione delle Colonne predefinite, vengono invece cambiati tutti gli elementi in automatico.

Valido per tutti gli elementi

• Gli elementi sono separati da ";" e devono essere del numero delle colonne definite.
• Se uno di questi elementi viene lasciato vuoto, vengono ripresi i valori predefiniti.

Nomi colonne

Indica manualmente quali colonne visualizzare nei dettagli della fattura.
Inserisci i nomi XML delle colonne della tabella Registrazioni. Puoi visualizzare il nome XML di ogni colonna con il comando disponi colonne, scheda Impostazioni. Separa i nomi delle colonne con un ";" (punto e virgola).

Le colonne predefinite sono:

• Per le fatture integrata in contabilità:
  • Number (Id articolo). Questo vale sia per la colonna Id della tabella Articoli nell'applicativo Offerte e Fatture, sia per la colonna Articolo della tabella Registrazioni nella fatturazione integrata.
  • Description
  • Quantity
  • ReferenceUnit
  • UnitPrice
  • Amount
  • VatRate
• In più per l'applicativo Offerte fatture:
  • Date
  • Discount

Con il Piano Advanced di Banana Contabilità Plus, puoi stampare altre colonne delle tabelle Registrazioni (per la fatturazione integrata) e Articoli (fatturazione integrata e applicativo Offerte e Fatture) non comprese nell'elenco precedente.

• Tabella Registrazioni (Transactions).
  • La sintassi da utilizzare è T.NomeColonna.
    "T." indica che si tratta di una colonna della tabella Registrazioni, "NomeColonna" è il nome XML della colonna (es. "T.Notes", "T.DateWork", ecc.).
• Tabella Articoli (Items).
  • La sintassi da utilizzare è I.NomeColonna.
    "I." indica che si tratta di una colonna della tabella Articoli, "NomeColonna" è il nome XML della colonna (es. "I.Links", ecc.).

Larghezza colonne

Inserisci la larghezza di ogni colonna con un valore percentuale. Ogni valore definisce quanto spazio occupa una colonna rispetto alla larghezza totale della pagina. La somma deve essere 100%.
Separa le larghezze delle colonne con un ";" (punto e virgola).

Allineamento titoli

Inserisci l'allineamento del titolo per ogni colonna. Puoi allineare il testo a sinistra (left), al centro (center) e a destra (right). Separa ogni allineamento con un ";" (punto e virgola).

Allineamento testi

Inserisci l'allineamento del testo di ogni colonna. Puoi allineare il testo a sinistra (left), al centro (center) e a destra (right). Separa ogni allineamento con un ";" (punto e virgola).

Importi lordi (IVA inclusa)

Puoi decidere se utilizzare importi al lordo con IVA inclusa oppure importi al netto con IVA esclusa.

Stampa descrizioni supplementari

Disponibile solo per la fatturazione integrata nella contabilità.
Puoi decidere se inserire delle descrizioni supplementari su più righe.

• Nella tabella Registrazioni, con il comando Disponi colonne aggiungi una o più colonne di descrizioni aggiuntive.
  Per ogni riga di descrizione aggiuntiva devi aggiungere una colonna apposita.
  Crea le colonne di tipo Testo con il nome "Description" seguito da un numero (es. "Description1", "Description2", "Description3", ecc.).
  Il "nome XML" di ogni colonna deve iniziare con la parola "Description" (in inglese) seguito da un numero.
  Nel campo "Nome" puoi inserire quello che vuoi.
  
  
   
• In queste colonne inserisci i testi aggiuntivi per le descrizioni delle fatture.
  Il testo di ogni colonna sarà visualizzato su una nuova riga nella descrizione della fattura.

Esempio completo alla pagina Fattura con descrizioni su più righe (fatturazione integrata).

Alcuni esempi

• Includi le colonne Descrizione, Quantità, Unità, Prezzo Unità e Importo:
  • Description;Quantity;ReferenceUnit;UnitPrice;Amount
    50%;10%;10%;15%;15%
    center;center;center;center;center
    left;center;center;right;right
• Includi solo le colonne Descrizioni e Importo:
  • Description;Amount
    70%;30%
    center;right
    left;right
• Includi le colonne Descrizione, Note e Importo. Note non è una colonna predefinita, il nome deve essere preceduto da "T.". Richiede il Piano Advanced di Banana Contabilità Plus.
  • Description;T.Notes;Amount
    35%;35%;30%
    left;left;right
    left;left;right
• Includi le colonne Descrizione, Data lavoro, Quantità, Unità, Prezzo Unità e Importo (DateWork è una colonna creata manualmente, il nome deve essere preceduto da "T."). Richiede il Piano Advanced di Banana Contabilità Plus.
  • Description;T.DateWork;Quantity;ReferenceUnit;UnitPrice;Amount
    35%;15%;10%;10%;15%;15%
    left;center;center;center;right;right
    left;center;center;center;right;right
• Per applicativo Offerte e Fatture: includi le colonne Numero, Data, Descrizione, Quantità, Unità, Prezzo, Sconto e Importo.
  • Item;Date;Description;Quantity;ReferenceUnit;UnitPrice;Discount;Amount
    10%;10%;50%;10%;10%,10%;15%;15%
    left;left;left;right;right;right;right;right
    left;left;left;right;right;right;right;right

Piè di pagina

Elemento del dialogo che permette di inserire un piè di pagina.

• Stampa piè di pagina.
  Indica se includere in stampa il piè di pagina.
• Stampa bordo separazione.
  Indica se includere il bordo di separazione (una linea orizzontale) sopra il testo del piè di pagina.

Il piè di pagina è composto da tre colonne: una a sinistra, una centrale e una a destra.
I testi del piè di pagina si inseriscono nella sezione Testi > Piè di pagina testo sinistra / centro / destra (vedi capitolo "Proprietà Testi"), dove per ogni colonna è possibile inserire un testo.

Il piè di pagina può essere inserito solamente se il codice QR è escluso dalla stampa. Quando si include il codice QR, il piè di pagina viene automaticamente escluso dalla stampa.

La sezione del piè di pagina può essere personalizzata tramite programmazione javascript con la funzione hook_print_footer() (richiede il piano Advanced).

Proprietà Testi

Con questo livello si definiscono tutti i testi della fattura, che sono raggruppati e suddivisi in base alla lingua.

Lingue

Si possono cambiare i testi da usare per ogni lingua e aggiungere anche delle traduzioni in altre lingue.

La lingua da usare viene scelta in base alla lingua indicata per il cliente:

• Per la fatturazione integrata, viene definita nella tabella Conti, vista Indirizzo, colonna Lingua.
• Per l'applicativo Offerte e Fatture, viene definita nella tabella Contatti, colonna Lingua.

Se per il cliente non è indicata alcuna lingua viene usata quella predefinita della contabilità.

Le lingue predefinite per le quali esiste una traduzione completa sono: tedesco, inglese, francese e italiano.

La prima lingua ad apparire nel dialogo è sempre la lingua corrente del file, definita in File → Proprietà file (Dati base) → Varia. Le rimanenti sono elencate in ordine alfabetico.

Definire le lingue

• Valori predefiniti: de;en;fr;it
• Inserire la lista delle lingue utilizzando il codice a due caratteri.
  • de = tedesco
  • en = inglese
  • fr = francese
  • it = italiano
• Separare i codici delle lingue con un ";" (punto e virgola).

Aggiungere lingue

• Nella casella Lingue aggiungi la sigla della lingua che si vuole aggiungere.
• Clicca su OK.
• Riapri il dialogo Impostazioni. Vedrai che vi è una nuova sezione per la lingua con i testi in inglese.
• Nella sezione della lingua aggiunta, sostituisci i testi esistenti con quelli corretti.

Rimuovere lingue

• Nella casella Lingua cancella il codice della lingua che si desidera rimuovere.
• Clicca su OK del dialogo impostazioni.
• Conferma con Si per rimuovere la lingua dalla lista e con essa anche tutti i testi inseriti.
• Clicca nuovamente su Impostazioni e vedrai che la sezione della lingua è stata rimossa.

Sezione testi per ogni lingua

Per ogni lingua definita vi è una sezione che inizia con il codice della lingua. Contiene l'elenco dei testi che puoi modificare.
Se si cancella il contenuto, quando si conferma con Ok, verrà ripreso in automatico il testo predefinito.

• Numero fattura.
  Testo nelle informazioni che precede il numero della fattura.
• Data fattura.
  Testo nelle informazioni che precede la data della fattura.
• Ordine fattura.
  Testo nelle informazioni che precede il numero di ordine.
• Data ordine.
  Testo nelle informazioni che precede la data dell'ordine.
• Numero cliente.
  Testo nelle informazioni che precede il numero del cliente.
• Numero IVA cliente.
  Testo nelle informazioni che precede il numero IVA del cliente.
• Numero fiscale cliente.
  Testo nelle informazioni che precede il numero fiscale del cliente.
• Scadenza fattura.
  Testo nelle informazioni che precede la data di scadenza della fattura.
• Numero pagina.
  Testo nelle informazioni che precede il numero di pagina.
• Indirizzo spedizione.
  Testo che appare sopra l'indirizzo di spedizione.
• Titolo fattura.
  Testo facoltativo inserito prima della tabella dei dettagli.
  Inserisci <none> per non visualizzare nessun testo.
• Titolo nota di credito
  Testo facoltativo inserito prima della tabella dei dettagli.
  Inserisci <none> per non visualizzare nessun testo.
• Testo iniziale
  Testo facoltativo, su una o più righe, inserito subito dopo il titolo della fattura.
• Nomi colonne dettagli fattura.
  Testi delle intestazioni delle varie colonne dei dettagli fattura.
  Devono essere separati da un ";" (punto e virgola).
  Quando cambi le colonne da visualizzare nella fattura (sezione Stampa, Dettagli fattura, Nomi colonne), devi sempre adattare anche i testi per le intestazioni delle colonne.
• Totale fattura.
  Testo che appare nella riga del totale della fattura.
• Testo finale
  Testo facoltativo, su una o più righe, inserito alla fine della fattura.
  Questo testo ha la priorità sul testo aggiunto dal dialogo Stampa fatture → Opzioni → Testo finale.
• Piè di pagina testo sinistro/centro/destro.
  Il codice <Pagina> viene sostituito con il numero di pagina.
  Inserisci <none> per non visualizzare nessun testo.

Testi specifici per la stampa di Fatture Proforma, Offerte, Bollettini di consegna, Conferme d'ordine e Richiami (richiede il Piano Advanced):

• Fattura Proforma
  • Titolo.
    Testo facoltativo inserito prima della tabella dei dettagli. Inserisci <none> per non visualizzare nessun testo.
  • Testo iniziale.
    Testo facoltativo, su una o più righe, inserito subito dopo il titolo della fattura proforma.
  • Testo finale.
    Testo facoltativo, su una o più righe, inserito alla fine della fattura proforma.
• Offerta
  • Numero.
    Testo nelle informazioni che precede il numero dell'offerta.
  • Data.
    Testo nelle informazioni che precede la data dell'offerta.
  • Validità.
    Testo nelle informazioni che precede la data di validità dell'offerta.
  • Titolo.
    Testo facoltativo inserito prima della tabella dei dettagli.
  • Testo iniziale.
    Testo facoltativo, su una o più righe, inserito subito dopo il titolo dell'offerta.
  • Testo finale.
    Testo facoltativo, su una o più righe, inserito alla fine dell'offerta.
• Bollettino di consegna
  • Numero bollettino di consegna.
    Testo nelle informazioni che precede il numero del bollettino di consegna.
  • Data bollettino di consegna.
    Testo nelle informazioni che precede la data del bollettino di consegna.
  • Titolo.
    Testo facoltativo inserito prima della tabella dei dettagli. Inserisci <none> per non visualizzare nessun testo.
  • Testo iniziale.
    Testo facoltativo, su una o più righe, inserito subito dopo il titolo del bollettino di consegna.
  • Testo finale.
    Testo facoltativo, su una o più righe, inserito alla fine del bollettino di consegna.
• Conferma d'ordine
  • Numero conferma d'ordine.
    Testo nelle informazioni che precede il numero della conferma d'ordine.
  • Data conferma d'ordine.
    Testo nelle informazioni che precede la data della conferma d'ordine.
  • Titolo.
    Testo facoltativo inserito prima della tabella dei dettagli. Inserisci <none> per non visualizzare nessun testo.
  • Testo iniziale.
    Testo facoltativo, su una o più righe, inserito subito dopo il titolo.
  • Testo finale.
    Testo facoltativo, su una o più righe, inserito alla fine della conferma d'ordine.
• Richiamo
  • Data fattura (solo per la fatturazione integrata nella contabilità.
    Testo nelle informazioni che precede la data della fattura.
    Utilizzato se esiste la registrazione con data del richiamo creata tramite il comando Report > Clienti > Stampa richiami.
  • Data (solo per la fatturazione integrata nella contabilità).
    Testo nelle informazioni che precede la data del richiamo.
    Utilizzato se esiste la registrazione con data del richiamo creata tramite il comando Report > Clienti > Stampa richiami.
  • Scadenza (solo per la fatturazione integrata nella contabilità).
    Testo nelle informazioni che precede la data di scadenza del richiamo.
    Utilizzato se esiste la registrazione con data del richiamo creata tramite il comando Report > Clienti > Stampa richiami.
  • Titolo.
    Testo facoltativo inserito prima della tabella dei dettagli. Inserisci <none> per non visualizzare nessun testo.
  • Testo iniziale.
    Testo facoltativo, su una o più righe, inserito subito dopo il titolo del richiamo.
  • Testo finale.
    Testo facoltativo, su una o più righe, inserito alla fine del richiamo.

Grassetto

Con un'annotazione specifica puoi applicare lo stile grassetto ad alcuni testi. Per farlo, includi i testi desiderati tra doppi asterischi ** .

Applicabile a:

• Testo iniziale.
• Testo finale.
• Descrizioni degli elementi che appaiono nei dettagli della fattura.

Esempi:

**testo** = testo
**testo1 testo2**, testo3 = testo1 testo2, testo3

Personalizzare titolo, testo iniziale e testo finale

I dati relativi al titolo, testo iniziale e testo finale, vengono ripresi e inseriti in automatico in ogni nuova fattura.

Se in questi testi vuoi inserire anche delle informazioni relative al cliente (nome, cognome, ecc.) o il numero di fattura:

• Con il Piano Professional i dati devono essere inseriti manualmente ogni volta che crei una fattura.
• Con il Piano Advanced puoi automatizzare l'inserimento dei dati su tutte le fatture.

Per la ripresa automatizzata dei dati (solo con il Piano Advanced) devi utilizzare le colonne predefinite, da cui i dati vengono ripresi:

• Colonne indirizzo cliente
  • Nella fatturazione integrata, dalla tabella Conti, vista Indirizzo.
  • Nell'applicativo Offerte e Fatture, dalla tabella Contatti.
• Colonna numero fattura
  • Nella fatturazione integrata, dalla tabella Registrazioni, colonna Fattura.
  • Nell'applicativo Offerte e Fatture, dalla tabella Fatture, colonna Id.

Nei testi devi inserire le seguenti colonne, specificando il nome XML delle colonne tra i segni "<" e ">".

• Indirizzo
  • <NamePrefix>, <OrganisationName>, <FirstName>, <FamilyName>, <Street>, <AddressExtra>, <POBox>, <PostalCode>, <Locality>, <Region>, <Country>, <CountryCode>, <EmailWork>.
• Numero fattura
  • <DocInvoice>.
    In questo caso DocInvoice viene utilizzato sia per la fatturazione integrata sia per l'applicativo offerte e fatture.

Per visualizzare il nome XML di ogni colonna utilizzare il comando disponi colonne, sezione Impostazioni.

Al momento della creazione della fattura questi testi vengono sostituiti con i valori reali.

Esempi:

• Il testo "Fattura <DocInvoice>" viene convertito in "Fattura 10".
• Il testo "Fattura <DocInvoice>, <FirstName> <FamilyName>" viene convertito in "Fattura 10, James Johnson".

Proprietà Stili

In questo livello si definiscono i parametri che riguardano l'aspetto visivo della fattura, dal tipo/dimensione del carattere ai colori.

Tipo e Dimensioni carattere

Il tipo e la dimensione del carattere sono applicati a tutti i testi della fattura, ad eccezione dell'intestazione che ha una dimensione fissa modificabile unicamente tramite la personalizzazione con il CSS.

La dimensione del titolo e della riga totale vengono ridimensionati in base alla dimensione del carattere scelto.

Per maggiori informazioni riguardanti il tipo di carattere utilizzabile e l'esportazione in PDF consultare la pagina Crea PDF.

Colori

Inserisci i colori che vuoi applicare alla stampa della fattura.

• Colore testo.
  Il colore applicato a tutti i testi della fattura: intestazione, informazioni, indirizzo, testo iniziale, dettagli fattura, testo finale, piè di pagina.
  Il colore del bollettino QR non può essere cambiato.
• Colore sfondo intestazione dettagli.
  Il colore principale della fattura. Viene applicato a: intestazione dettagli fattura, righe orizzontali.
• Colore testo intestazione dettagli.
  Il colore dei testi nelle intestazioni delle colonne della tabella dettagli fattura.
• Colore sfondo per righe alternate.
  Il colore dello sfondo applicato alle righe delle varie voci della fattura.
• Colore titolo e totale.
  Il colore del titolo e della riga del totale (testo e sottolineatura).

Per inserire un colore hai due possibilità:

• Seleziona un colore tra quelli disponibili.
• Inserisci il codice esadecimale del colore (HEX). È un codice che inizia con # seguito da sei caratteri (es. #000000, #009FE3, #FF00EA).
  I codici dei colori si trovano facilmente su internet. Ad esempio, puoi consultare la tabella al sito https://www.w3schools.com/cssref/css_colors.asp.

Se non si inserisce nessun colore (si lascia il campo vuoto), viene impostato il colore predefinito. Vale per ogni campo colore. È utile se si vuole reimpostare con i colori originali.

Testi fatturazione integrata

Nella fatturazione integrata si possono definire alcuni testi anche nella tabella Registrazioni, quando si inseriscono i dati della fattura.

• Titolo fattura / nota di credito.
  • Inserire nella colonna TipoDoc il comando 10:tit (12:tit per nota di credito).
  • Inserire nella colonna Descrizione il testo desiderato.
  • Ha la priorità sull'eventuale testo definito nelle impostazioni del layout fattura.
• Testo iniziale.
  • Inserire nella colonna TipoDoc il comando 10:beg.
  • Inserire nella colonna Descrizione il testo desiderato.
  • È possibile inserire solamente una riga di testo.
  • Ha la priorità sull'eventuale testo definito nelle impostazioni del layout fattura.
• Note.
  • Inserire nella colonna TipoDoc il comando 10:not.
  • Inserire nella colonna Descrizione il testo desiderato.
  • Si possono inserire più righe di note. Ogni nota deve essere definita su una nuova riga nella tabella Registrazioni.
• Saluti.
  • Inserire nella colonna TipoDoc il comando 10:gre.
  • Inserire nella colonna Descrizione il testo desiderato.
  • È possibile inserire solamente una riga di saluti.

Priorità Titolo e Testo iniziale:

Priorità Testo finale:

Messaggi errore

• @error Nomi testi e colonne non corrispondono.
  Il numero delle colonne dei dettagli della fattura (sezione Stampa → Dettagli fattura → Nomi colonne) non corrisponde ai testi da stampare (sezione Testi → codice lingua → Nomi colonne dettagli fattura). Controllare le impostazioni della fattura.

Questa pagina spiega come impostare la stampa del QR-Code Svizzero sulle fatture e rimanda anche a informazioni tecniche sulle possibilità di personalizzazione, uso dei formati indirizzi e altro.

Per quanto riguarda le specifiche tecniche si rimanda ai Riferimenti e Standard del QR-Code.

Importazione dati bancari

• Nell'estratto bancario elettronico (camt.053 e camt.054), ci sono gli elementi che sono stati stampati sulla QR-Fattura.
• Il programma, con l'estensione di importazione Estratto bancario Camt ISO 20022 (Svizzera), legge queste informazioni e completa la registrazione con il conto del cliente e numero fattura.
• Puoi vedere le fatture pagate e quelle ancora in sospeso o pagate solo parzialmente dall'estratto delle fatture aperte.

Sezione QR

Nelle impostazioni della fattura c'è una sezione apposita per l'immissione dei dati per la stampa della sezione QR.

• Per stampare il QR sulla fattura devi vistare la casella "Stampa QR Code".

C'è poi una scelta molto importante da fare. Il sistema QR-Code ha due modalità principali a dipendenza del tipo di conto che vuoi utilizzare. Nel Tipo di riferimento devi indicare il sistema che vuoi usare .

• Stampa QR-fatture con il normale Conto IBAN (scelta predefinita)
  • Puoi iniziare immediatamente a stampare fatture con il QR usando il tuo conto esistente IBAN.
  • I dati dei pagamenti sono registrati sul tuo normale conto IBAN assieme a tutti gli altri movimenti.
  • Per importare i dati usi il formato Camt.053.
• Stampa QR-fatture con lo speciale Conto QR-IBAN
  • Devi chiedere alla tua banca di attribuirti un numero di conto speciale QR-IBAN.
  • I dati dei pagamenti sono registrati dalla banca sul conto speciale QR-IBAN.
    Sul normale conto IBAN, vedrai solo la registrazione del totale incassato giornaliero.
  • È utile quindi per chi ha molti movimenti di incasso e li vuole tenere separati dal normale conto IBAN.
  • È il sistema compatibile con il sistema PVR che usa il numero di riferimento di 27 caratteri numerici.
  • I dati dei pagamenti sono messi a disposizione dalla banca nel formato dell'estratto conto elettronico Camt 054.

Infine seguono le impostazioni disponibili indipendentemente dal Tipo riferimento QR scelto.

Indirizzi

• Indirizzo pagabile a
  Il programma imposta l'indirizzo di chi riceve il pagamento usando i dati dell'indirizzo nelle proprietà del file. In questo caso l'indirizzo sarà di tipo combinato (K).
  Si può però indicare un altro indirizzo completando i campi nella sezione Pagabile a. In quest'ultimo caso invece l'indirizzo sarà di tipo strutturato (S).
  Per maggiori informazioni consulta il paragrafo Informazioni tecniche.
• Tipo indirizzo cliente
  Seleziona il tipo di indirizzo da utilizzare, strutturato (S) oppure combinato (K).
  Per maggiori informazioni consulta il paragrafo Informazioni tecniche.

Gli indirizzi nelle sezioni "Pagabile a" e “Pagabile da” del QR devono sempre contenere o il nome dell’organizzazione o il nome e cognome.
Il nome dell'organizzazione ha la priorità rispetto al nome/cognome: se è presente sarà quindi inserito il nome dell’organizzazione, altrimenti sarà inserito il nome/cognome.
Inserire entrambi non è possibile in quanto le righe sono limitate e ogni riga deve contenere un'informazione precisa.
La struttura degli indirizzi è la seguente:

• nome organizzazione oppure nome e cognome
• via e numero civico
• codice postale e località

Gli indirizzi che compaiono nel QR sotto le voci "Pagabile a" e "Pagabile da" seguono le norme dello standard del Swiss QR.
Non è possibile aggiungere righe o modificare in alcun modo la composizione degli indirizzi sul QR.

Includi / escludi dalla stampa

• Includi informazioni aggiuntive (nome XML della colonna)
  Puoi inserire delle informazioni aggiuntive riguardo la fattura da visualizzare sul bollettino QR, nella sezione "Informazioni aggiuntive".
  
  
  
  Nella finestra di dialogo delle impostazioni della fattura → sezione QR → Includi informazioni aggiuntive, inserisci il nome XML della colonna utilizzata da dove riprendere le informazioni aggiuntive.
  Vedi come visualizzare i nomi XML delle colonne.
  Vedi come aggiungere nuove colonne.
   
  • Fatturazione integrata
    Nella tabella Registrazioni aggiungi una nuova colonna dove inserire l'informazione aggiuntiva, oppure utilizza una colonna esistente come ad esempio la colonna Note.
    
    
     
  • Applicativo Offerte e Fatture
    Nella tabella Fatture aggiungi una nuova colonna dove inserire l'informazione aggiuntiva, ad esempio Info.
    Non utilizzare la colonna Note poiché questa è utilizzata per visualizzare i testi finali della fattura.
    
    
     
• Includi informazioni di fatturazione (opzionale)
  Aggiungi le informazioni di fatturazione strutturate generate in automatico.
  Se presenti, vengono aggiunte dopo le informazioni aggiuntive (vedi punto precedente).
• Escludi indirizzo fattura
  Escludi l'indirizzo di fatturazione del cliente e lascia un riquadro vuoto per inserire l'indirizzo a mano.
• Escludi importo fattura
  Escludi l'importo della fattura e lascia un riquadro vuoto per inserire l'importo a mano.
  Da usare quando il cliente può scegliere l'importo da pagare.
  

Formato di stampa sezione QR

• QR su pagina separata
  Stampa le sezioni di pagamento e ricevuta della QR-fattura su una pagina separata.
  In questo modo vi è più spazio per la fattura.
• Stampa bordo di separazione
  Stampa un bordo di separazione tratteggiato per separare la fattura dalle sezioni di pagamento e ricevuta.
• Stampa simbolo forbici
  Stampa il simbolo delle forbici sul bordo di separazione.
• QR Posizione X e QR Posizione Y (opzionale)
  Cambia la posizione orizzontale e verticale della sezione QR Code - di solito non è necessario modificare i valori di default.

Altre informazioni

• Gli indirizzi che compaiono sulle sezioni pagamento e ricevuta devono contenere:
  • Nome e cognome oppure nome ditta (il nome della ditta ha la priorità nel caso siano definiti entrambi).
  • Indirizzo.
  • CAP e Località.
  • Codice nazione (non viene indicato sulla stampa ma è incluso nel codice QR).
• Il codice nazione è di due caratteri conforme allo standard ISO 3166-1 (es. CH, LI, AT, DE, IT, FR).
  • Il codice nazione del mittente della fattura lo si imposta da File → Proprietà file (dati base) → sezione Indirizzo, campo Codice Nazione.
  • Il codice nazione del cliente, lo si imposta nella colonna Codice Nazione della tabella Conti, vista Indirizzo.

Informazioni tecniche

Nel codice QR della QR-Fattura, gli indirizzi dell'emittente della fattura e del cliente possono essere di due tipi: combinato o strutturato.
Il tipo definisce in che modo i dati dell'indirizzo vengono rappresentati all'interno dell'immagine del codice QR.

Di norma viene utilizzato l'indirizzo di tipo combinato (K). È però possibile in alcuni casi avere la necessità utilizzare il tipo di indirizzo strutturato (S) perché magari la banca lo richiede.

Indipendentemente dal tipo scelto la stampa dell'indirizzo sulla polizza QR, sia nella sezione ricevuta sia nella sezione pagamento, sarà la medesima.

• Indirizzo combinato (K)
  • È utilizzato come impostazione predefinita.
  • Gli elementi dell'indirizzo vengono combinati e inseriti in massimo 4 campi nel codice QR.
  • L'indirizzo combinato è così composto:
    • Campo 1: nome ditta o nome e cognome cliente (massimo 70 caratteri consentiti).
    • Campo 2: via e numero civico, casella postale (massimo 70 caratteri consentiti).
    • Campo 3: codice postale e città (massimo 70 caratteri consentiti).
    • Campo 4: codice nazione (due caratteri conforme allo standard ISO 3166-1).
  • Nella stampa sulla fattura, la struttura degli indirizzi è la seguente:
    • nome organizzazione o nome/cognome
    • via e numero civico
    • codice postale e località
• Indirizzo strutturato (S)
  • Gli elementi dell'indirizzo vengono suddivisi e inseriti in massimo 6 campi nel codice QR.
  • L'indirizzo strutturato è così composto:
    • Campo 1: nome ditta o nome e cognome cliente (massimo 70 caratteri consentiti).
    • Campo 2: via e casella postale (massimo 70 caratteri consentiti).
    • Campo 3: numero civico o riga indirizzo 2 (massimo 16 caratteri consentiti).
    • Campo 4: codice postale (massimo 16 caratteri consentiti).
    • Campo 5: città (massimo 35 caratteri consentiti).
    • Campo 6: codice nazione (due caratteri conforme allo standard ISO 3166-1).
  • Nella stampa sulla fattura, la struttura degli indirizzi è la seguente:
    • nome organizzazione o nome/cognome
    • via e numero civico
    • codice postale e località

Qui lo schema riassuntivo ripreso dalla documentazione del formato standard (solo inglese) a pagina 35.  A pagina 29, i dettagli delle sezioni indirizzo.

Indirizzo emittente

L'indirizzo dell'emittente della fattura può essere di due tipi:

•  Indirizzo combinato (K)
  • L'indirizzo viene ripreso da File → Proprietà file (Dati base) → Indirizzo.
  • Utilizzare il campo Indirizzo1 per inserire via e numero civico.
  • Nelle impostazioni fattura si lascia vuota la sezione Codice QR → Pagabile a.
• Indirizzo strutturato (S)
  • L'indirizzo viene ripreso dalle impostazioni fattura, sezione Codice QR → Pagabile a.
    • Vistare la sezione Codice QR → Pagabile a.
    • Inserire i dati dell'indirizzo negli appositi campi sottostanti.
      
      

Indirizzo cliente

L'indirizzo del cliente della fattura può essere di due tipi:

• Indirizzo combinato (K)
  • L'indirizzo viene ripreso dalla tabella Conti → vista Indirizzo.
  • Utilizzare la colonna Indirizzo per inserire via e numero civico.
    
    
     
  • Nelle impostazioni fattura, sezione Codice QR → Tipo indirizzo cliente, selezionare K.
• Indirizzo strutturato (S)
  • L'indirizzo viene ripreso dalla tabella Conti → vista Indirizzo.
  • Utilizzare la colonna Indirizzo per inserire la via.
  • Utilizzare la colonna Indirizzo Extra per inserire il numero civico (utilizzare il comando Dati → Disponi colonne per visualizzare la colonna se è nascosta).
    
    
     
  • Nelle impostazioni fattura, sezione Codice QR → Tipo indirizzo cliente, selezionare S.

Stampa e invio in formato cartaceo

La QR-fattura può essere stampata e inviata in formato cartaceo. Per farlo è necessario utilizzare un apposito foglio di carta bianca perforato.

Testa il QR-Code

I pdf delle fatture con il codice QR possono essere testati con la seguente pagina di validazione ufficiale:

• Crea e salva il pdf della fattura QR.
• Vai alla pagina di validazione ufficiale https://www.swiss-qr-invoice.org/validator
• Trascina il pdf dentro l'area blu.

La pagina mostra il contenuto del codice QR se il codice è corretto. Se ci sono problemi li segnala in rosso.

Se non vengono mostrati dei messaggi in rosso, il QR è da considerarsi corretto (vedi esempio seguente).

Le seguenti funzionalità di personalizzazione avanzata richiedono il piano Advanced di Banana Contabilità Plus.

Personalizzazione avanzata del layout (con programmazione)

Il layout CH10 può essere personalizzato con una programmazione specifica.

• Programmazione in Javascript (documentazione in inglese).
  • Puoi adattare ancora maggiormente la stampa con la creazione di funzioni che sostituiscono quelle predefinite, per la stampa dell'intestazione, indirizzi, dettagli, testi e piè di pagina.
• Creazione di stili CSS (documentazione in inglese).
  • Puoi adattare ancora maggiormente la stampa con la creazione di stili personalizzati in modo da poter modificare l'aspetto della fattura (formattazione del testo, posizionamento degli elementi, ecc.).

Creazione di propri layout di stampa

• Personalizzazione tramite la creazione di un proprio Layout personalizzato (documentazione in inglese).
  • Richiede la programmazione in Javascript.
  • Puoi usare il layout esistente e modificarlo a piacimento.

The Banana invoice is constructed with a Javascript program. The Extension also allows you to add Javascript programming so that you can completely customize the content and format of the invoice (this functionality requires the Advanced plan).

See more about Banana Accounting API Extensions Reference.

Add your custom Javascript file

Three steps are required to define and use your Javascript file:

1. Add the document table to the Banana Accounting file.
   If it is not already present you need to add the Documents table in the Banana document with the menu command Tools > Add new features > Add document table.
2. Add a new Javascript type document to the document table.
   1. In the ID column enter the file name including the extension .js (e.g. "myFile.js").
      If the id is missing the ".js" at the end, it won't work.
   2. In the Description column enter a comment (optional).
   3. In the Attachments column, double click on the cell or select the edit symbol, then select Javascript Code and confirm with OK.
   4. An editor will open in which you can write the code.
   5. Delete everything in it.
   6. Insert the Javascript code. You can modify the content at any time.
      
      
      Documents table - Javascript Code attachment
       
3. Tell the invoice layout to use the customized Javascript attachment file.
   1. Select Settings of the Print invoices dialogue.
   2. In the Javascript/CSS > JS file name, enter the name of the newly created Javascript attachment file with the extension ".js" at the end (e.g. "myFile.js").
   3. Click Ok to confirm.
      
      
      Settings Dialogue - Javascript File Property

Javascript Hook Replacement Functions

The invoice layout is created with a set of predefined Javascript functions.

The hook functions are Javascript replacements functions to be used instead of the the predefined.

The hook functions should be defined in the ".js" file of the Documents table.

• The name of the hook function is the name of the predefined function used in the layout, preceded by the text "hook_".
  For example, if you want to change the header printing you have to define the hook_print_header() that will replace the predefined print_header() function.
  • The parameters must be the same as those used in the main function.
  • If you create your own hook function, it is necessary to know how it works the function you want to replaces.
• When generating the invoice, the layout extension checks for the existence of a hook replacement function and, if available, utilizes it to substitute the predefined function.
• Hook functions let you selectively change some part of how the invoice is build, without directly modifying the original script of the invoice Layout.

Graphic explanation of the Hook functions

With the hook functions, you can customize the following sections of the invoice.

(1) hook_print_header()

Function that prints the header part of the invoice (logo and texts).

(2) hook_print_info_first_page() and hook_print_info_other_pages()

Functions that print the information parts of the invoice.

(3) hook_print_customer_address()

Function that prints the customer address part of the invoice.

(4) hook_print_shipping_address()

Function that prints the shipping address part of the invoice (in case it exists).

(5) hook_print_text_begin()

Function that prints the title and begin text parts of the invoice.

(6) hook_print_details_net_amounts() and hook_print_details_gross_amounts()

Functions that print the invoice details using net/gross amounts.
Use the hook_formatItemsValue() function to change the format and style of the items.

(7) hook_print_final_texts()

Function that prints the final texts, notes and greetings parts of the invoice, right after the invoice details.

(8) hook_print_footer()

Function that prints the footer at the bottom of the page (usable only when not printing the QR slip).

List of Hook functions

This file contains all the available hook functions with their parameters and an empty function body, that should be replaced with your implementation. 

• See examples of invoice customization.
   

// Function used to set all the variable values used by the invoice layout script
function hook_set_variables(variables, userParam) {...}
// Function used to print the header at the top of the page (logo and text address)
function hook_print_header(repDocObj, userParam, repStyleObj, invoiceObj, texts) {...}
// Function used to print the invoice information on the first page
function hook_print_info_first_page(repDocObj, invoiceObj, texts, userParam) {...}
// Function used to print the invoice information from page 2 onward
function hook_print_info_other_pages(repDocObj, invoiceObj, texts, userParam) {...}
// Function used to print the customer address
function hook_print_customer_address(repDocObj, invoiceObj, userParam) {...}
// Function used to print the shipping address
function hook_print_shipping_address(repDocObj, invoiceObj, texts, userParam) {...}
// Function used to print the text before the invoice details (title and begin text)
function hook_print_text_begin(repDocObj, invoiceObj, texts, userParam) {...}
// Function used to print the invoice details using net amounts (VAT excluded)
function hook_print_details_net_amounts(banDoc, repDocObj, invoiceObj, texts, userParam, detailsTable, variables) {...}
// Function used to print the invoice details using gross amounts (VAT included)
function hook_print_details_gross_amounts(banDoc, repDocObj, invoiceObj, texts, userParam, detailsTable, variables) {...}
// Function used to print the text after the invoice details (notes, greetings, etc.)
function hook_print_final_texts(repDocObj, invoiceObj, userParam) {...}
// Function used to print the footer at the bottom of the page. Usable only when not printing the QR slip part.
function hook_print_footer(repDocObj, texts, userParam) {...}
// Function used to format the value and set the className of the item
function hook_formatItemsValue(value, variables, columnName, className, item) {...}
// Function used to modify the QR settings
function hook_modify_settings_qr(invoiceObj, qrcodeData) {...}

Examples of a hook functions 

Within your hook function you can call the original hook function. This way you can limit the changes to the code.
For example this hook function call the original one, only in a specific case.

/** 
 * This function prints the final text only for INVOICES and not for CREDIT NOTES.
 * Invoices = DocType 10
 * Credit notes = DocType 12
 */
function hook_print_final_texts(sectionClassFinalTexts, invoiceObj, userParam) {
   // We can check the DocType and print the text only when is not 12
   if (invoiceObj.document_info.doc_type !== "12") {
      print_final_texts(sectionClassFinalTexts, invoiceObj, userParam);
   }
}

Predefined variables

The predefined variables are the default used by the invoice layout script.

The variables for decimals start with "decimals_". (decimals_quantity, decimals_unit_price, decimals_amounts).

The variable that start with "$" are template variable that you can use in the CSS styles ($font_family, $font_size, $text_color, ...).
Example of an extract of the predefined CSS invoice layout.

body {
  font-family: $font_family;
  font-size: $font_size;
  color: $text_color;
}

List of all predefined variables and their default values that you can override with the hook_set_variables() function:

/* Variable that sets the decimals of the Quantity column */
variables.decimals_quantity = "";
/* Variable that sets the decimals of the Unit Price column */
variables.decimals_unit_price = 2;
/* Variable that sets the decimals of the Amount column */
variables.decimals_amounts = 2;
/* Variables that set the colors */
variables.$text_color = userParam.text_color;
variables.$background_color_details_header = userParam.background_color_details_header;
variables.$text_color_details_header = userParam.text_color_details_header;
variables.$background_color_alternate_lines = userParam.background_color_alternate_lines;
variables.$color_title_total = userParam.color_title_total;
/* Variables that set the font */
variables.$font_family = userParam.font_family;
variables.$font_size = userParam.font_size+"pt";
/* Variables that set the font size and margins of the Invoice Begin Text */
variables.$font_size_title = userParam.font_size*1.4 +"pt";
/* Variables that set font size, margins, padding and borders of the Invoice Details */
variables.$font_size_header = userParam.font_size*1.2 +"pt";
variables.$font_size_total = userParam.font_size*1.2 +"pt";
/* Variables that set the position of the invoice address
 * Default margins when the address on right: 12.3cm margin left, 4.5cm margin top
 * Default margins when the address on left: 2.2cm margin left, 5.5cm margin top
 * Sum userParam dX and dY adjustments to default values */
variables.$right_address_margin_left = parseFloat(12.3) + parseFloat(userParam.address_position_dX)+"cm";
variables.$right_address_margin_top = parseFloat(4.5) + parseFloat(userParam.address_position_dY)+"cm";
variables.$left_address_margin_left = parseFloat(2.2) + parseFloat(userParam.address_position_dX)+"cm";
variables.$left_address_margin_top = parseFloat(5.5) + parseFloat(userParam.address_position_dY)+"cm"; 

Example of 'hook_set_variables' function

You can overwrite the predefined variable with the hook_set_variables() function. 
Only use the variable that you want to replace. 

// Example of hook function usage that sets
// the decimals of the Amounts columns to 4
// the font type to Times New Roman
function hook_set_variables(variables, userParam) {
   variables.decimals_amounts = 4;
   variables.$font_family = "Times New Roman";
}

Banana invoices are formatted through a CSS Stylesheet. The extension allows you to use a customized stylesheet so you can fully modify the appearance of the invoice (this functionality requires the Advanced plan).

Following you will find information and examples that let anyone understand the basic of the CSS so that you are able to do a lot of customization to your invoice, even if you are not a CSS professional.

• See also the page CSS Examples. 

Banana CSS Stylesheet file

The CSS file property let you specify an CSS stylesheet file to be used for formatting the invoice. You have to enter the name of a CSS document, contained in the Documents table.

The properties you define in the custom CSS file will extend or overwrite the styles of the default stylesheet.

Cascading Style Sheet (CSS) is a specification language that allows to customize the appearance of web pages, and a subset of the whole CSS specification is also used in Banana to prepare reports. 
Here are some basics about CSS Stylesheet formatting.

• The document, in our case the invoice, is composed by a series of Elements that contains all the data of the invoice.
• Each element can have one or more class properties that specify which style should be used for that element.
• Each element can contain other elements.
• In the CSS stylesheet you specify the formatting properties of each class of style.
• The elements hynnerit the styles of the parent element.
• The main element for the invoice is the Document.

Add your custom CSS stylesheet

Three steps are required to define and use your CSS file:

1. Add the document table to the Banana Accounting file.
   If it is not already present you need to add the Documents table in the Banana document with the menu command Tools > Add new features > Add document table.
2. Add a new CSS type document to the document table.
   1. In the ID column enter the file name including the extension .css (e.g. "myStyle.css").
      If the id is missing the ".css" at the end, it won't work.
   2. In the Description column enter a comment (optional).
   3. In the Attachments column, double click on the cell or select the edit symbol, then select CSS stylesheet and confirm with Ok.
   4. An editor will open in which you can write the code.
   5. Enter or edit the script and confirm with Ok.
   6. Save the Banana Accounting file.
      
      
      Documents table - CSS stylesheet attachment
       
3. Specify the CSS file created in the invoice layout extension.
   1. Select Settings of the Print invoices dialogue.
   2. In the Javascript/CSS > CSS file name, enter the name of the newly created CSS attachment file with the extension ".css" at the end (e.g. "myFile.css").
   3. Click Ok to confirm.
      
      
      Settings Dialogue - CSS File Property

Syntax of a CSS stylesheet

The syntax of the CSS is quite simple as you see in this style definition that set the size of the Invoice title text element to 14 points and without bold.

/* this two lines are comment 
   title_text is for the invoice number */
.title_text {
  font-family: Arial;
  font-size: 14;
  font-weight: normal;
  color: #6495ED;
}

Syntax rules:

• Element are case sensitive.
• You specify the style name ".title_text" starting with a dot (".") and followed by the  curly open bracket "{".
  • Property name, followed by the colon ":"
  • Values followed by the semicolon ";"
  • You can have has many allowed properties you need.
• End with the curly close bracket "}".
• You can have has many allowed style classes.
• The defined values overwrite the predefined one.

Comments:

• Add comments to the css by including the text within a /*    comment */,
  It help you remember the purpose of the code.
  See the comments in the predefined CSS for explanations of the elements.

Most used properties

Font

• font-family
  Specify the font name.
• font-size
  Specify the font size in points.
• font-weight
  Specify the font weight: normal, bold or value between 1-1000.

Text alignment

• text-align
  Specify the horizontal alignment of the text.
  It is used for example to align on the right of the cell all the amounts of the invoice (i.e. "text-align: right").

Colors

For the main colors you can use the name in English (black, yellow, white, blue, red, ...) or the hexadecimal values (HEX) preceded by the # sign (e.g. #000000, #009FE3, #FF00EA).
For codes see the table at https://www.w3schools.com/cssref/css_colors.asp.

• color
  Define the color of a text.
• background-color
  Define the background color of an element.
  It is used for example to set the background color of the header row of the invoice details.

Positioning

All elements in the invoice are positioned relative to the prior element. You can change the positioning.

• margin
  • margin-top
    To set the margin on the top of the element.
  • margin-right
    To set the margin on the right side of the element.
  • margin-bottom
    To set the margin on the bottom of the element.
  • margin-left
    To set the margin on the left side of the element.
    It is used for example in case it is required to move an element a bit to the right. More margin on the left means move the element to the right.
• padding
  • padding-top
    Sets the height of the area on the top of an element.
  • padding-right
    Sets the width of the area on the right of an element.
  • padding-bottom
    Sets the height of the area on the bottom of an element.
  • padding-left
    Sets the width of the area on the left of an element.

/* For example it is used for the details table, to avoid that
all the texts are printed too close to the table border. */
.doc_table td {
  padding-top: 5px;
  padding-bottom: 1px;
  padding-left: 4px;
  padding-right: 4px;
}

Absolute positioning

Some elements are positioned relative to the begin of the document. The position of these elements does not depend on any other element in the document.

• postion
  •  For the logo, header text and address elements it is used the absolute positioning ("position: absolute").

Borders

To apply borders to tables and table rows.

• border-style
  Sets the line style for all four sides of an element's border.
  • border-top-style
  • border-right-style
  • border-bottom-style
  • border-left-style
• border-color
  Sets the color for all four sides of an element's border.
  • border-top-color
  • border-right-color
  • border-bottom-color
  • border-left-color
• border-width
  Sets the width for all four sides of an element's border.
  • border-top-width
  • border-right-width
  • border-bottom-width
  • border-left-width

/* For example use it to apply a double underline
 to the total line of the invoice. */
  .total_cell {
  border-bottom-style: double;
  border-bottom-color: #337ab7;
  border-bottom-width: 1px;
}

Display / Hide element

Set the attribute display to none to hide an element.  In this case the Invoice number is hidden.

.title_text {
   display: none;
}

Predefined CSS stylesheet

The Javascript layout create a document with elements that include a specific class, that is then positioned and formatted based on the CSS style definition.
If you want to add other styles class you have to modify the Javascript code by using the hook functions.

Here you can see the complete CSS stylesheet used for invoices documents.

• Some styles are initialized with the predefined values set by the users (value that begin with the $. 
  For example The $font_family is replaced with the font name family specified by the user or initialized with the Javascript variable initialization function.
• Test starting with /* and ending with */ are comments

/* Page definition.
   Sets margins of the document.
   Each elements of the invoice is positioned relative to these margins. */
@page {
  margin-top: 0cm;
  margin-bottom: 0cm;
  margin-left: 0cm;
  margin-right: 0cm;
}
/* Properties for all the content of the document.
   This values will be used for all elements, unless there is not a specific definition.
   Sets font family, font size and text color. */
body {
  font-family: $font_family;
  font-size: $font_size;
  color: $text_color;
}
/* Vertically align the content of a cell in a table. */
td {
  vertical-align: top;
}
/* Text that is right aligned. 
   This class is used in combination of others */
.right {
  text-align: right;
}
/* Text that is center aligned. 
   This class is used in combination of others */
.center {
  text-align: center;
}
/* Font that is bold. */
.bold {
  font-weight: bold;
}
/* The width of the area on the right of an element.
   This value is the space between an element and its border. */
.padding-right {
  padding-right: 20px;
}
/* The width of the area on the left of an element.
   This value is the space between an element and its border. */
.padding-left {
  padding-left: 20px;
}
/* The top border of an element.
   Sets the line style, the line color and the line width of the border. 
   Used for example as horizontal line between the items and the total net */
.border-top {
  border-top-style: solid;
  border-top-color: $color_title_total;
  border-top-width: thin;
}
/* Text of the header when printed on the right of the document.
   Sets margins and position relative to the document.
   When no logo is used, text alignment is set to right. */
.header_text {
  margin-top: 1.2cm;
  margin-left: 1.2cm;
  margin-right: 1.2cm;
  text-align: right;
  position: absolute;
}
/* Text of the row 1 of the header (if defined through Invoice settings).
   Sets bold and size 16 of the font. */
.header_row_1 {
  font-weight: bold;
  font-size:16pt;
}
/* Text of the row 2, row 3, row 4 and row 5 of the header (if defined through Invoice settings).
   Sets bold and size 10 of the font. */
.header_row_2_to_5 {
  font-weight: bold;
  font-size: 10pt;
}
/* Logo positioning.
   Sets margins and position relative to the document. */
.logo {
  margin-top: 1.2cm;
  margin-left: 1.34cm;
  margin-right: 1.2cm;
  position: absolute;
}
/* Text of the information table when printed on the left of the document.
   Sets font size and margins relative to the document and the prior element. */
.info_table_left {
  font-size: $font_size;
  margin-top: 4.5cm;
  margin-left: 1.2cm;
  margin-right: 1.2cm;
}
/* Text of the information table when printed on the right of the document.
   Sets font size and margins relative to the document and the prior element. */
.info_table_right {
  font-size: $font_size;
  margin-top: 5.5cm;
  margin-left: 12.3cm;
  margin-right: 1.2cm;
}
/* Text of the information table when printed on page 2 and above.
   Sets font size and margins relative to the document and the prior element. */
.info_table_row0 {
  font-size: $font_size;
  margin-top: 4.5cm;
  margin-left: 1.2cm;
  margin-right: 1.2cm;
}
/* Cells of the information table rows when printed on the left.
   Sets the space between the text in the cell and the cell border (top and bottom). */
table.info_table_left td {
  padding-top: 0px;
  padding-bottom: 0px;
}
/* Cells of the information table rows when printed on the right.
   Sets the space between the text in the cell and the cell border (top and bottom). */
table.info_table_right td {
  padding-top: 0px;
  padding-bottom: 0px;
}
/* Cells of the information table rows when printed on page 2 and above.
   Sets the space between the text in the cell and the cell border (top and bottom). */
table.info_table_row0 td {
  padding-top: 0px;
  padding-bottom: 0px;
}
/* Display the information table for pages 2 and above.
   For pages 2 and above it is used a different information table (.info_table_row0).
   This table is not displayed on first view of the document (page 1).
   On first page it is used the other one (.info_table_left or .info_table_right). */
@page:first-view table.info_table_row0 {
  display: none;
}
/* Can be used to set the column width of the first column of info table 
   width: 100px */
.info_table_first_column {
}
/* Can be used to set the column width of the second column of info table 
   width: 100px */
.info_table_second_column {
}
/* Address positioning when printed on the right.
   Sets margins and position relative to the document.
   Sets also the font size. */
.address_table_right {
  font-size: $font_size;
  top: 4.5cm;
  left: 12.3cm;
  width: 7.5cm;
  position: absolute;
}
/* Address positioning when printed on the left.
   Sets margins and position relative to the document.
   Sets also the font size. */
.address_table_left {
  top: 5.5cm;
  left: 2.2cm;
  width: 7.5cm;
  position: absolute;
}
/* Address positioning when printed on the right,
   and moved horizontally/vertically through Invoice settings.
   Sets margins and position relative to the document.
   Sets also the font size. */
.custom_address_table_right {
  font-size: $font_size;
  top: $right_address_margin_top;
  left: $right_address_margin_left;
  width: 7.5cm;
  position: absolute;
}
/* Address positioning when printed on the left,
   and moved horizontally/vertically through Invoice settings.
   Sets margins and position relative to the document.
   Sets also the font size. */
.custom_address_table_left {
  top: $left_address_margin_top;
  left: $left_address_margin_left;
  width: 7.5cm;
  position: absolute;
}
/* Small address line of the sender, above the customer's address.
   Sets font size, text alignment.
   Sets also a bottom border used as underline. */
.small_address {
  font-size: 7pt;
  text-align: center;
  border-bottom-style: solid;
  border-bottom-color: $text_color;
  border-bottom-width: 1px;
  margin-bottom: 0.3cm;
}
/* Shipping address positioning.
   Sets font size and margins relative to the information table. */
.shipping_address {
  font-size: $font_size;
  margin-top: 0.4cm;
  margin-left: 1.2cm;
  margin-right: 1.2cm;
}
/* Shipping address title.
   Sets font weight and color of the text. */
.title_shipping_address {
  font-weight: bold;
  color: $color_title_total;
}
/* Invoice title.
   Sets font size, font weight and color of the text. */
.title_text {
  font-size: $font_size_title;
  font-weight: bold;
  color: $color_title_total;
}
/* Begin text positioning.
   Sets margins relative to the prior element.
   It is used all the available width of the document to insert the text. */
.section_class_begin {
  margin-top: 1.0cm;
  margin-left: 1.2cm;
  margin-right: 1.2cm;
  width: 100%;
}
/* Table for the begin text.
   Use all the available width of the document. */
.begin_text_table {
  width: 100%;
}
/* Begin text style.
   Sets the font size of the text. */
.begin_text {
  font-size: $font_size;
}
/* Invoice details positioning, first page.
   Sets the top margin relative to the prior element (begin text/title) */
.section_class_details:first-view {
  margin-top: 0.5cm;
}
/* Invoice details positioning, page 2 and above.
   Sets the margins relative to the prior element (information) */
.section_class_details {
  font-size: $font_size;
  margin-top: 0.5cm;
  margin-bottom: 0.5cm;
  margin-left: 1.3cm;
  margin-right: 1.2cm;
}
/* Invoice details table width.
   Use all the available width of the document. */
.doc_table {
  width: 100%;
}
/* Header row of the invoice details.
   Sets font size, font weight, text color and background color. */
.doc_table_header {
  font-size: $font_size_header;
  font-weight: bold;
  color: $text_color_details_header;
  background-color: $background_color_details_header;
  border-bottom: thin solid $color_title_total;
}
/* Cells of the invoice details table.
   Sets the space between the text in the cell and the cell border (top, bottom, left and right). */
.doc_table td {
  padding-top: 5px;
  padding-bottom: 1px;
  padding-left: 0px;
  padding-right: 0px;
}
/* Cells of header row of the invoice details table.
   Sets the space between the text in the cell and the cell border (top, bottom, left and right). */
.doc_table_header td {
  padding-top: 4px;
  padding-bottom: 2px;
  padding-left: 0px;
  padding-right: 0px;
}
/* Item row of the invoice details.
   Sets font weight. */
.item_cell {
  
}
/* Total row of the invoice details.
   Sets font size, font weight and text color. 
   Sets also a bottom border used as double underline for the entire row. */
.total_cell {
  font-size: $font_size_total;
  font-weight: bold;
  color: $color_title_total;
  border-bottom-style: double;
  border-bottom-color: $color_title_total;
  border-bottom-width: 1px;
}
/* Subtotal row of the invoice details.
   Sets the font weight and a bottom border used as underline for the entire row. */
.subtotal_cell {
  font-weight: bold;
  border-bottom-style: solid;
  border-bottom-color: $color_title_total;
  border-bottom-width: thin;
}
/* Header cell of the invoice details.
   Sets the font weight as bold. */
.header_cell {
  font-weight: bold;
}
/* VAT text style of the invoice details.
   Sets the font size of the text.
   Used when printing the invoice details using gross amounts, through Invoice settings. */
.vat_info {
  font-size: $font_size;
}
/* Even rows style of the invoice details.
   Sets the background color for even rows. */
.even_rows_background_color {
  background-color: $background_color_alternate_lines;
}
/* Final texts positioning.
   Sets margins relative to the prior element (invoice details).
   Applied to notes, greetings and final texts. */
.section_class_final_texts {
  margin-top: 0cm;
  margin-bottom: 0.5cm;
  margin-left: 1.26cm;
  margin-right: 1.0cm;
}
/* Footer top border positioning. 
   Sets margins relative to the prior element (final texts).
   Sets also a top border line over the text. */
.footer_line {
  margin-left: 1.2cm;
  margin-right: 1.0cm;
  border-top-style: solid;
  border-top-color: $color_title_total;
  border-top-width: thin;
}
/* Footer positioning and style.
   Sets margins relative to the prior element (footer line). 
   Sets also font size and use all the available width of the document. */
.footer_table {
  font-size: 8pt;
  margin-bottom: 2.0cm;
  margin-left: 1.2cm;
  margin-right: 1.0cm;
  width: 100%;
}

Messaggi di errore

@error QR-IBAN mancante

• Il codice QR-IBAN deve essere indicato nelle impostazioni della fattura, sotto la relativa voce QR-IBAN.
• Verificare che il codice QR-IBAN non sia stato inserito nei dati base File → Proprietà file (Dati base) → Indirizzo.

@error QR-IBAN non corretto

Verificare che il codice QR-IBAN inserito nelle impostazioni della fattura sia corretto. Si prega di vedere anche il paragrafo QR-IBAN Account della nostra pagina web QR-fattura con utilizzo del conto speciale QR-IBAN.

@error IBAN mancante

• L'IBAN per un conto in CHF può essere indicato in due modi:
  • Nei dati base File → Proprietà file (Dati base) → Indirizzo.
  • Nelle impostazioni della fattura, sotto la relativa voce IBAN.
• L'IBAN per un conto in EUR deve essere indicato nelle impostazioni della fattura, alla voce IBAN EUR.

@error IBAN non corretto

• Il codice IBAN inserito nei dati base File → Proprietà file (Dati base) → Indirizzo o nelle impostazioni della fattura non è corretto.
• Oppure si è inserito un codice QR-IBAN nei dati base File → Proprietà file (Dati base) → Indirizzo. Se si vuole utilizzare il codice QR-IBAN bisogna inserirlo nell'apposita sezione nelle impostazioni della fattura.

@error Indirizzo: nome/società mancante

Impostare nome e cognome oppure nome società del mittente da File → Proprietà file (dati base) → sezione Indirizzo, e del cliente nella tabella Conti → vista Indirizzo.

@error Indirizzo: CAP mancante

Impostare il CAP del mittente da File → Proprietà file (dati base) → sezione Indirizzo, e del cliente nella tabella Conti → vista Indirizzo.

@error Indirizzo: località mancante

Impostare la località del mittente da File → Proprietà file (dati base) → sezione Indirizzo, e del cliente nella tabella Conti → vista Indirizzo.

@error Indirizzo: codice nazione mancante

Impostare il codice della nazione del mittente da File → Proprietà file (dati base) → sezione Indirizzo campo Codice Nazione, e del cliente nella tabella Conti → vista Indirizzo colonna Codice Nazione.

@error Indirizzo: codice nazione non corretto

Il codice nazione deve essere di due caratteri conforme allo standard ISO 3166-1 (es. CH, LI, AT, DE, IT, FR).

@error isrId too long, max 8 chars. Your isrId %1

Il numero di adesione inserito nelle impostazioni del layout fattura è troppo lungo. La lunghezza massima consentita è di 8 cifre. Per maggiori informazioni Riferimento QR (QRR).

@error isrId invalid, only digits are permitted. Your isrId %1

Il numero di adesione inserito nelle impostazioni del layout fattura non è valido. Può essere composto solo da numeri. Per maggiori informazioni Riferimento QR (QRR).

@error customerNo too long, max 7 digits. Your customerNo %1

Il numero cliente è troppo lungo. La lunghezza massima consentita è di 7 cifre. Per maggiori informazioni Riferimento QR (QRR).

@error customerNo invalid, only digits are permitted. Your customerNo %1

Il numero cliente non è valido. Può essere composto solo da numeri. Non deve contenere lettere dell'alfabeto ASCII (A-Z), spazi, separatori o altri caratteri. Per maggiori informazioni Riferimento QR (QRR).

@error invoiceNo too long, max 7 digits. Your invoiceNo %1

Il numero fattura è troppo lungo. La lunghezza massima consentita è di 7 cifre. Per maggiori informazioni Riferimento QR (QRR).

@error invoiceNo invalid, only digits are permitted. Your invoiceNo %1

Il numero fattura non è valido. Può essere composto solo da numeri. Non deve contenere lettere dell'alfabeto ASCII (A-Z), spazi, separatori o altri caratteri. Per maggiori informazioni Riferimento QR (QRR).

@error Nome troppo lungo, max 70 caratteri

Il nome è troppo lungo. La lunghezza massima consentita è di 70 caratteri. Per maggiori informazioni Informazioni tecniche.

@error Indirizzo troppo lungo, max 70 caratteri

L'indirizzo è troppo lungo. La lunghezza massima consentita è di 70 caratteri. Per maggiori informazioni Informazioni tecniche.

@error Numero civico troppo lungo, max 16 caratteri

Il numero civico è troppo lungo. La lunghezza massima consentita è di 16 caratteri. Per maggiori informazioni Informazioni tecniche.

@error Codice postale troppo lungo, max 16 caratteri

Il codice postale è troppo lungo. La lunghezza massima consentita è di 16 caratteri. Per maggiori informazioni Informazioni tecniche.

@error Località troppo lungo, max 35 caratteri

Il testo della località è troppo lungo. La lunghezza massima consentita è di 35 caratteri. Per maggiori informazioni Informazioni tecniche.

@error Codice postale+Località troppo lungo, max 70 caratteri

Il testo del codice postale e della località è troppo lungo. La lunghezza massima consentita è di 70 caratteri. Per maggiori informazioni Informazioni tecniche.

In questa pagina vengono mostrati alcuni esempi di possibili stampe di QR fatture.

• Scarica il file tutorial utilizzato per gli esempi.

Fattura con impostazioni predefinite

• Utilizza le impostazioni predefinite del dialogo impostazioni fattura.
• Inserisci un conto IBAN nei dati base File → Proprietà file (Dati base) → Indirizzo oppure nelle impostazioni fattura.

Stampa di esempio:

Fattura con logo

Tramite il dialogo File → Imposta logo:

• Definisci il logo, la dimensione e l'allineamento.
• Imposta l'allineamento del testo dell'intestazione della fattura.
  Definisci il testo dell'intestazione in File → Proprietà file (Dati base) → Indirizzo oppure utilizzando i campi del dialogo impostazioni fattura.

Esempio fattura con logo allineato a sinistra e testo a destra:

Esempio fattura con logo allineato a destra e testo a sinistra:

Fattura con logo tipo carta intestata (formato A4)

Questo esempio spiega come impostare un logo a tutta pagina (tipo carta intestata). Viene utilizzata un'immagine con un logo nella parte superiore e un piè di pagina nella parte inferiore. Quello che si vuole ottenere è una stampa della fattura con:

• Sulle pagine dove ci sono i dettagli della fattura, viene visualizzato il logo e il piè di pagina.
• Sull'ultima pagina con il bollettino QR, viene visualizzato solo il logo senza piè di pagina.

È utile se si vuole ad esempio stampare una fattura QR con anche il piè di pagina, perché normalmente il piè di pagina può essere inserito solamente se il bollettino QR è escluso dalla stampa.

Ecco come fare:

• Crea un'immagine in formato A4 della carta intestata con il logo nella parte superiore e il piè di pagina nella parte inferiore.
  Esempio:
  
  
   
• Inserisci l'immagine creata come logo dal menu File > Imposta logo.
  • Definisci la dimensione: larghezza 21cm e altezza 29.7cm (se le dimensioni dell'immagine sono già esatte, puoi omettere queste due impostazioni).
  • Definisci l'allinameneto a sinistra.
  • La posizione e l'allineamento del testo sono irrilevanti in quanto nessun testo verrà stampato nell'intestazione.
• Utilizza la personalizzazione con il CSS per cambiare i margini del logo.
  Nella tabella Documenti, in una nuova riga inserisci il CSS come allegato.
  • Nella colonna ID inserisci un id (ad es. logo.css). Deve terminare con ".css".
  • Nella colonna Allegati, fai doppio clic nella cella seleziona Foglio stile CSS.
  • Nell'editor che si apre incolla il seguente codice:

  • .logo {
      margin-top: 0cm;
      margin-left: 0cm;
      margin-right: 0cm;
    }

• Imposta alcuni parametri nel dialogo impostazioni della fattura:
  • Nella sezione Stampa > Intestazione, togli la spunta a Intestazione pagina.
  • Nella sezione Stampa > Intestazione, metti la spunta a Logo.
  • Nella sezione Stampa > Intestazione, campo Composizione per allineamento logo e intestazione inserisci il nome della personalizzazione che hai definito in File > Imposta logo > Personalizzazione > Nome (impostazione predefinita "Logo").
  • Nella sezione Codice QR, metti la spunta a QR su pagina separata.
  • Nella sezione Javascript / CSS, nel campo Nome file CSS inserisci l'id dell'allegato CSS che hai definito nella tabella Documenti (ad es. logo.css).

Esempio di fattura QR, sulla prima pagina logo e piè di pagina, sulla seconda pagina logo e bollettino QR:

  

Fattura senza logo e indirizzo intestazione a sinistra

Accedi al dialogo File > Imposta logo:

• Non aggiungere nessun logo.
• Come posizione del Testo, specifica le seguenti impostazioni:
  • Posizione relativa al logo: Sulla sinistra
  • Allineamento orizzontale: Sinistra.
• Vai nella sezione Personalizzazione e nel campo Nome inserisci un nome per la personalizzazione (es. "Logo").

Ora accedi al dialogo impostazioni della fattura, sezione Stampa > Intestazione:

• Vista la casella Intestazione pagina.
• Vista la casella Logo (anche se non verrà caricata nessuna immagine logo).
• Nel campo Composizione per allineamento logo e intestazione inserisci il nome della personalizzazione che hai definito precedentemente nel dialogo Imposta logo > Personalizzazione > Nome (es. "Logo").

Stampa di esempio:

Fattura con indirizzo clienti a sinistra

Tramite il dialogo impostazioni della fattura, sezione Indirizzo cliente:

• Definisci la composizione dell'indirizzo specificando i nomi XML delle colonne indirizzi della tabella Conti.
• Vista la casella Allinea a sinistra per stampare l'indirizzo a sinistra e la parte delle informazioni sulla destra.
  
  

Stampa di esempio:

Fattura con intestazioni e totali intermedi nei dettagli

In alcuni casi potrebbe essere utile aggiungere intestazioni e totali intermedi nei dettagli della fattura.

Nella tabella Registrazioni definisci le righe di intestazione e di totali intermedi utilizzando la colonna Tipo:

• Righe di intestazione: inserisci il comando 10:hdr e il testo nella colonna Descrizione.
• Righe di totali intermedi: inserisci il comando 10:tot e il testo nella colonna Descrizione.
  
  

Esempio fattura su più pagine:
  

Fattura con indirizzo di spedizione e colonne Descrizione e Importo

Tramite il dialogo impostazioni della fattura:

• Nella sezione Indirizzo cliente vista la casella Indirizzo spedizione.
• Nella sezione Dettagli fattura definisci:
  • I nomi delle colonne da utilizzare, specificando i nomi XML delle colonne tabella Registrazioni.
  • La larghezza di ogni colonna.
  • Gli allineamenti di titoli e testi delle colonne.
• Nella sezione Testi definisci il testo dell'intestazione di ogni colonna.
  Aggiungi la traduzione per ogni lingua che intendi utilizzare.
  
  

Esempio stampa fattura con altri stili (caratteri o colori):

Usa colonne tabella Registrazioni

Requisiti:

• Piano Advanced di Banana Contabilità Plus.

Oltre alle colonne predefinite (Descrizione, Quantità, Unità, Prezzo unità e Importo) nella stampa della fattura è possibile aggiungere altre colonne della tabella Registrazioni, comprese quelle che sono state aggiunte manualmente alla tabella.

In alcuni casi potrebbe essere utile includere nei dettagli della fattura una colonna propria, ad esempio per indicare la data di esecuzione di un lavoro.

Creazione colonna:

• Con il comando Disponi colonne aggiungi una colonna nella tabella Registrazioni.
• Crea una colonna di tipo Data con il nome DateWork.
  Il nome XML di ogni colonna di tipo Data deve iniziare con la parola "Date" (es. DateWork, DateExecution, DateXXX).
  Nella stampa della fattura, il programma utilizza il formato della data definito nelle impostazioni del proprio sistema operativo.
  
  
   
• Inserisci le tue registrazioni per creare la fattura e in questa colonna indica la data di esecuzione del lavoro.

Tramite il dialogo impostazioni della fattura:

• Nella sezione Dettagli fattura definisci:
  • I nomi delle colonne da utilizzare, specificando i nomi XML delle colonne tabella Registrazioni.
    Inserisci la colonna creata in questo modo: T.DateWork (le colonne proprie devono essere precedute da "T.").
  • Aggiungi la larghezza della colonna aggiunta, e adatta quelle esistenti.
  • Aggiungi gli allineamenti di titoli e testi della colonna aggiunta, e adatta quelle esistenti.
• Nella sezione Testi definisci il testo dell'intestazione di ogni colonna.
  • Aggiungi il testo della colonna aggiunta ed eventualmente adatta quelli esistenti.
  • Aggiungi la traduzione per ogni lingua che intendi utilizzare.
    
    

Con la personalizzazione avanzata in Javascript è possibile creare una funzione che modifica il formato in cui la data viene stampata. Per maggiori informazioni vedi Use another date format.

Esempio stampa fattura:

Fattura con testo iniziale, finale, note e saluti

Nella tabella Registrazioni definisci i testi iniziali, le note e i saluti utilizzando la colonna Tipo:

• Testo iniziale: inserisci il comando 10:beg e il testo nella colonna Descrizione.
• Note: inserisci il comando 10:not e il testo nella colonna Descrizione.
• Saluti: inserisci il comando 10:gre e il testo nella colonna Descrizione.
• Il testo inserito tra i doppi asterischi (**) viene visualizzato in grassetto.
  
  
   

Tramite il dialogo impostazioni della fattura:

• Nella sezione Testi definisci il testo finale da includere subito dopo i dettagli della fattura.
  Il testo inserito tra i doppi asterischi (**) viene visualizzato in grassetto.
  
  

Esempio stampa fattura:

Fattura senza importo

Si usa quando si vuole lasciare la possibilità di scegliere l'importo da pagare alla persona che effettua il pagamento (ad esempio per una donazione).
Nella parte del QR l'importo è escluso, lasciando un riquadro vuoto dove inserire l'importo a mano.

Nella tabella Registrazioni inserisci la registrazione della donazione senza importo.

Tramite il dialogo impostazioni della fattura, nella sezione Codice QR vista la casella Escludi importo fattura.

Esempio stampa fattura:

Fattura con descrizioni su più righe (fatturazione integrata)

Questo esempio per la fatturazione integrata mostra come creare delle fatture utilizzando delle descrizioni su più righe.

I passi da seguire sono i seguenti:

• Con il comando Disponi colonne aggiungi una o più colonne di descrizioni aggiuntive nella tabella Registrazioni.
  Crea le colonne di tipo Testo con il nome "Description" seguito da un numero (es. "Description1", "Description2", "Description3", ecc.).
  Il nome XML di ogni colonna deve iniziare con la parola "Description" (in inglese) seguito da un numero.
  
  
   
• Nelle colonne appena create inserisci i testi aggiuntivi per le descrizioni delle fatture.
  Il testo di ogni colonna sarà visualizzato su una nuova riga nella descrizione della fattura.
  
  
   
• Tramite il dialogo impostazioni della fattura, nella sezione Stampa → Dettagli fattura, vista la casella Stampa descrizioni supplementari.
  
  

A questo punto, se nella tabella Registrazioni esistono delle colonne di descrizioni aggiuntive e se contengono dei testi, questi testi saranno aggiunti sulla stampa della fattura.

Esempio stampa fattura:

Fattura con descrizioni su più righe (offerte-fatture)

Questo esempio per l'applicativo Offerte e Fatture mostra come creare delle fatture con delle descrizioni su più righe.

• Nel dialogo di creazione/modifica fattura, sezione Dettagli fattura, colonna Descrizione:
  • Inserisci i testi delle descrizioni.
  • Puoi andare a capo e inserire tutte le righe che vuoi.
  • Puoi lasciare anche delle righe vuote.
  • Puoi inserire uno o più testi tra doppi asterischi per applicare lo stile grassetto (es. **Testo in grassetto**).
  • Puoi inserire l'importo nella stessa riga dove hai inserito la descrizione con più righe, o anche su una riga nuova (vedi immagine).
    
    

Quando stampi la fattura le descrizioni sono visualizzate su più righe come nel dialogo.

Esempio stampa fattura:

Fattura con colonna Sconto articolo

Questo esempio per la fatturazione con l'applicativo Offerte e Fatture mostra come aggiungere nei dettagli della fattura la colonna Sconto dell'articolo.

Requisiti:

• Piano Advanced di Banana Contabilità Plus.
• Versione Beta Release dell'applicativo offerte e fatture.

I passi da seguire sono i seguenti:

• Crea le fatture utilizzando la colonna Sconto. Inserisci una percentuale oppure un valore.
  
  
   
• Tramite il dialogo impostazioni della fattura:
  • Nella sezione Stampa → Dettagli fattura aggiungi la colonna Discount, imposta le larghezze delle colonne e l'allineamento dei titoli e dei testi.
    • Description;Quantity;ReferenceUnit;UnitPrice;Discount;Amount
      35%;10%;10%;15%;15%;15%
      left;center;center;right;right;right
      left;center;center;right;right;right
  • Nella sezione Testi → Intestazione colonne dettagli fattura, per ogni lingua imposta i testi delle intestazioni della tabella, aggiungendo anche il testo per la colonna Sconto.
    • Descrizione;Quantità;Unità;Prezzo Unità;Sconto;Importo

Esempio stampa fattura:

Fattura con immagini prodotti

Questo esempio mostra come aggiungere e stampare nei dettagli della fattura le immagini dei prodotti.

Requisiti

• Piano Advanced di Banana Contabilità Plus.
• Personalizzazione avanzata con javascript.

Passaggi

1. Aggiungi le immagini dei prodotti.
   • Salva le immagini di ogni prodotto.
     Usa la stessa cartella dove si trova il file .ac2 o una sottocartella.
     I formati supportati sono PNG e JPG.
     Usa immagini di piccole dimensioni per ridurre il peso del file PDF generato.
2. Modifica la tabella Articoli
   • Aggiungi la colonna Links.
     Nella tabella Articoli, rendi visibile la colonna Links con il comando Disponi colonne.
   • Collega le immagini agli articoli.
     Nella colonna Links della tabella Articoli, aggiungi il link all'immagine per ogni prodotto della tabella.
     Clicca sull'icona in alto a destra della cella e seleziona l'immagine corrispondente.
3. Aggiungi la tabella Documenti.
   • Se non è già presente, aggiungi la tabella Documenti.
     Dal menu Strumenti > Aggiungi nuove funzionalità > Tabella Documenti.
4. Aggiungi il codice JavaScript come allegato nella tabella Documenti.
   • Nella colonna ID, inserisci il nome dell'allegato inclusa l'estensione .js (es. "mioFile.js").
   • Nella colonna Allegati, clicca sul simbolo in alto a destra e seleziona Codice Javascript.
     Si apre un editor dove è possibile inserire il codice javascript. Cancella tutto.
   • Copia e incolla il codice javascript della funzione 'hook_print_details_net_amounts' (funzione che stampa la fattura con gli importi al netto).
   • Copia e incolla il codice javascript della funzione 'hook_print_details_gross_amounts' (funzione che stampa la fattura con gli importi al lordo).
   • Clicca OK.
5. Imposta i parametri del layout fattura.
   • Nelle Impostazioni della fattura:
     • Sezione Dettagli fattura, aggiungi le colonne "I.Links" (colonna per le immagini) e "Number" (colonna per il numero articolo).
       
       I.Links;Number;Description;Quantity;ReferenceUnit;UnitPrice;Amount
       10%;10%;30%;10%;10%;15%;15%
       left;left;left;right;center;right;right
       left;left;left;right;center;right;right
        
     • Sezione Testi, aggiungi i testi per le intestazioni delle colonne (es. "Image;Item;Description;Quantity;Unit;Unit Price;Amount").
     • Sezione Javascript / CSS > Nome file JS, inserisci l'id dell'allegato che contiene il codice javascript (es. "mioFile.js").

Nella stampa della fattura saranno incluse anche le immagini dei prodotti

Esempio stampa: