In questo articolo

    Strumenti Offerte e Fatture [BETA]

    Produttività
    Universale
    Visualizza su Github

    Questa estensione è pensata esclusivamente per l'Applicativo Offerte e Fatture.
    Mette a disposizione comandi utili per:

    • Importare dati di offerte e fatture generati da altri software o da Excel, direttamente nell'applicativo Offerte e Fatture.
    • Esportare offerte e fatture create con l'applicativo Offerte e Fatture in formato .csv.

    Per installare l'estensione cliccare sul menu Estensioni > Gestione estensioni, tra quelle online cercare "Strumenti Offerte e Fatture" e cliccare su installa.

    Prerequisiti

    Per utilizzare l'estensione devi:

    Specifiche

    Per importare ed esportare i dati è necessario utilizzare il formato csv (comma-separated values), dove:

    • I valori sono separati da una "," (virgola).
    • I valori di testo sono delimitati da virgolette '"".
    • I valori di testo non possono contenere virgolette, le virgolette sono sostituite da apostrofi '`'.
    • I valori delle date sono nel formato ISO "2022-10-24" (aaaa-mm-gg).
    • I valori degli importi hanno un punto "." come separatore decimale e non hanno il separatore delle migliaia.

    Qui si può vedere un esempio:

    
InvoiceDate,CustomerNumber,ItemDescription,ItemTotal,ItemVatRate,ItemVatTotal
2022-10-24,120001,"Red roses",100.00,V77,7.70
2022-10-24,120001,"White tulips",20.00,V77,1.54
2022-10-25,120002,"Garofani",12.00,V77,V77,0.92
2022-10-25,120002,"Rododendrus",20.00,V77,1.54

    Importazione offerte e fatture

    Per importare i dati delle Offerte e Fatture in Banana Plus dall'esterno (ad esempio da un altro software, da Excel, ecc.) è necessario poter generare un file *.csv oppure un file *txt con intestazioni predefinite.

    Una volta che avete il file *.csv o *.txt con i dati che volete importare, aprite il vostro file Offerte Fatture (.ac2) e dal menu Estensioni selezionate "Strumenti Offerte e Fatture" e selezionate ciò che volete importare. Se i dati sono corretti, verrà visualizzata una finestra con un'anteprima di tutte le righe che verranno importate; fare clic su OK per terminare l'importazione.

    Intestazioni da utilizzare per creare un file *csv o *txt con le fatture da importare:

    Colonne base

    • CustomerNumber
      • Campo obbligatorio.
      • Il numero/ID del cliente definito nella tabella Contatti.
    • InvoiceNumber
      • Campo obbligatorio.
      • Il numero della fattura.
    • InvoiceDate
      • Campo obbligatorio.
      • La data della fattura. La data deve essere inserita nel formato YYYY-MM-DD.
    • InvoiceDescription
      • L'oggetto/titolo della fattura inserito prima dei dettagli.
    • InvoiceCurrency
      • Campo obbligatorio.
      • La moneta della fattura.
    • ItemDescription
      • Campo obbligatorio.
      • La descrizione dell'articolo.
    • ItemQuantity
      • Campo obbligatorio.
      • La quantità dell'articolo da fatturare. La quantità minima richiesta è 1.
    • ItemUnit
      • L'unità dell'articolo da fatturare.
    • ItemUnitPrice
      • Campo obbligatorio.
      • Prezzo unitario dell'articolo.

    Colonne avanzate

    • InvoiceDueDate
      • La data di scadenza della fattura. La data deve essere inserita nel formato YYYY-MM-DD.
    • InvoiceDiscount
      • Lo sconto da applicare al totale della fattura.
    • ItemNumber
      • Il numero/ID dell'articolo.
    • ItemDiscount
      • Lo sconto da applicare sul prezzo unitario dell'articolo.
    • InvoiceRoundingTotal
      • L'arrotondamento dei totali. Il valore predefinito è 0.05 se non viene indicato niente. Valore indicato nel campo "Arrotondamento totali" nel dialgo di creazione/modifica fattura.
    • ItemTotal
      • Il totale della riga (articolo). Se l'importo è al netto (IVA esclusa) il totale è senza IVA. Se l'importo è al lordo (IVA inclusa) nel totale è inclusa l'IVA.

    Colonne IVA

    • InvoiceAmountType
      • vat_excl (importo al netto, IVA esclusa). È il valore predefinito se non viene indicato niente.
      • vat_incl (importo al lordo, IVA inclusa).
      • vat_none (senza IVA).
    • ItemVatCode
      • Il codice IVA applicato sull'articolo.
    • ItemVatRate
      • L'aliquota IVA applicata sull'articolo.

    Colonne di controllo

    • InvoiceTotalToPay
      • Valore non utilizzato per l'importazione. Serve a verificare se dopo l'importazione l'importo della fattura calcolato in Banana e l'importo nel file importato corrispondono.
    • InvoiceVatTotal
      • Valore non utilizzato per l'importazione. Serve a verificare se dopo l'importazione l'importo totale IVA calcolato in Banana e l'importo indicato ne file importato corrispondono.
    • CustomerName
      • Valore non utilizzato per l'importazione. Contiene il nome dell'organizzazione o il nome e cognome e la località.
    • ItemVatTotal
      • Non utilizzato per l'importazione.

    Regole di importazione

    • Il numero di fattura/offerta viene sostituito con un numero di fattura/offerta interno.
    • Il numero di cliente deve esistere nella tabella Contatti.
    • Il numero dell'articolo deve esistere nella tabella Articoli
    • Il codice IVA deve esistere nella tabella Codici IVA.
    • Viene mostrato un messaggio di errore se:
      • Si importano le fatture/offerte senza aver aggiunto i contatti nella tabella Contatti.
      • Nel file .csv manca un campo obbligatorio (vedi Colonne Base).
      • Un campo non corrisponde al formato corretto.
    • In caso di errore, la fattura non viene importata. Risolvere il problema e riprovare l'importazione.
      Per eventuali messaggi di errori durante l'importazione, visitare la documentazione Messaggi d'errore e risoluzione problemi.

    Esempio di file *.csv con alcune fatture:

    InvoiceNumber,InvoiceDate,InvoiceDueDate,InvoiceDescription,InvoiceDiscount,InvoiceVatTotal,InvoiceTotalToPay,InvoiceCurrency,InvoiceRoundingTotal,InvoiceAmountType,CustomerNumber,CustomerName,ItemNumber,ItemDescription,ItemQuantity,ItemUnitPrice,ItemUnit,ItemVatRate,ItemVatCode,ItemDiscount,ItemTotal,ItemVatTotal
10,2022-06-17,2022-07-17,Invoice,,,67.50,EUR,0.05,vat_none,1," ",1000,Green tea,24.00,2.50,pc,,,,60.00,
10,2022-06-17,2022-07-17,Invoice,,,67.50,EUR,0.05,vat_none,1," ",6000,Shipping expenses,1.00,7.50,pc,,,,7.50,
20,2022-08-07,2022-09-06,Invoice,,2.44,107.50,EUR,0.05,vat_incl,2,"Customer 1 ",1000,Green tea,40.00,2.50,pc,2.50,V25,,100.00,2.44
20,2022-08-07,2022-09-06,Invoice,,2.44,107.50,EUR,0.05,vat_incl,2,Customer 1,6000,Shipping expenses,1.00,7.50,pc,,,,7.50,
30,2022-10-15,2022-11-14,Invoice,,1.00,48.50,EUR,0.05,vat_excl,3,Customer 2,1000,Green tea,16.00,2.50,pc,2.50,V25,,40.00,1.00
30,2022-10-15,2022-11-14,Invoice,,1.00,48.50,EUR,0.05,vat_excl,3,Customer 2,6000,Shipping expenses,1.00,7.50,pc,,,,7.50,

    Esempio di file *.csv con alcune Offerte:

    InvoiceNumber,InvoiceDate,InvoiceDueDate,InvoiceDescription,InvoiceDiscount,InvoiceVatTotal,InvoiceTotalToPay,InvoiceCurrency,InvoiceRoundingTotal,InvoiceAmountType,CustomerNumber,CustomerName,ItemNumber,ItemDescription,ItemQuantity,ItemUnitPrice,ItemUnit,ItemVatRate,ItemVatCode,ItemDiscount,ItemTotal,ItemVatTotal
1,2023-12-15,2024-01-13,Estimate 1,0.07,0.19,2.60,CHF,0.05,vat_excl,2,Peter Ridge,1000,Tea,1,2.50,pc,7.70,V77,,2.50,0.19
2,2023-06-17,2023-07-17,Estimate 2,2.04,1.96,27.40,CHF,0.05,vat_excl,1, ,1200,Herbal teas,4.00,5.00,pc,7.70,V77,,20.00,1.54
2,2023-06-17,2023-07-17,Estimate 2,2.04,1.96,27.40,CHF,0.05,vat_excl,1, ,6000,Shipping fees,1,7.50,pc,7.70,V77,,7.50,0.58
3,2023-06-17,2023-07-17,Estimate 3,2.32,10.03,140.20,CHF,0.05,vat_excl,2,Peter Ridge,1000,Tea,50.00,2.50,pc,7.70,V77,,125.00,9.63

     

    Esportazione offerte e fatture

    L'esportazione genera un file *.csv contenente i dati esportati. Quando si esporta, vengono esportati i dati di tutte le colonne; il file *csv generato ha la stessa struttura definita per l'importazione.

    Quando si esporta è possibile decidere:

    • Il nome del file generato.
    • Se aprire immediatamente un'anteprima del file

    I dati generati non possono essere importati in un modello di fatturazione integrata.

    Messaggi d'errore e risoluzione problemi

    • "[Fatture] ID contatto xx non trovato nella tabella contatti. Hai importato i contatti?"
      • Se si importano le fatture senza prima aver importato i contatti, viene mostrato questo messaggio. Il programma importerà la fattura senza nessun dato del contatto.
      • Soluzione: Importare tutti i contatti nella tabella Contatti, poi ripetere l'importazione delle fatture.
    • "xx è un campo obbligatorio"
      • Questo messaggio viene mostrato se nel file .csv o .txt la colonna "xx" è vuota. Quel campo è obbligatorio e non deve essere vuoto. La fattura non verrà importata.
      • Soluzione: Inserire un testo nel campo obbligatorio e ripetere l'importazione.
    • Dopo l'importazione nella tabella Fatture, le fatture non sono visibili: vengono visualizzate solo delle righe vuote.
      • Soluzione: Usa il comando dal menu Fatture > Ricalcola tutto.

     

    Aiutaci a migliorare la documentazione

    Sono benvenuti suggerimenti per come migliorare questa pagina.

    Informaci quale tema necessita di una spiegazione migliore o come chiarire meglio un argomento.

    Condividi questo articolo: Twitter | Facebook | LinkedIn | Email