Strumenti Offerte e Fatture [BETA]

Questa estensione fornisce i comandi per importare o esportare in Banana i dati dai tuoi file Offerte e Fatture, più precisamente ti permette di importare ed esportare:

• Offerte
• Fatture

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

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.

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.