In questo articolo

Strumenti Offerte e Fatture [BETA]

Produttività
Universale

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