Dans cet article
Outils Offres et Factures [BETA]
Cette extension fournit des commandes pour importer dans Banana ou exporter depuis Banana les données de vos fichiers Offres et Factures, plus précisément, vous pouvez importer ou exporter :
- Factures
- Offres
Pour installer l'extension, cliquez sur le menu Extensions-> Gérer extensions, parmi celles en ligne, recherchez "Outils Offres et Factures" et cliquez sur installer.
Détails
Pour importer et exporter des données, vous devez utiliser des fichiers csv (valeurs séparées par des virgules), où :
- Les valeurs sont séparées par une "," (virgule).
- Les valeurs de texte sont délimitées par des guillemets '"'.
- Les valeurs de texte ne peuvent pas contenir de guillemets, les guillemets sont remplacés par des apostrophes '`'.
- Les valeurs de dates sont au format ISO "24-10-2022" (jj-mm-aaaa).
- Les valeurs de montant ont un point "." comme séparateur décimal, et non comme séparateur de milliers.
Ici vous pouvez voir un exemple :
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
Importation
Pour importer vos données de devis et de factures dans Banana depuis l'extérieur (par exemple un autre logiciel), vous devez pouvoir générer un fichier *.csv avec des en-têtes prédéfinis.
Une fois que vous avez le fichier *.csv avec les données que vous souhaitez importer, ouvrez votre fichier Offres et factures (.ac2) et dans le menu Extensions, sélectionnez "Outils Offres et Factures" et sélectionnez ce que vous souhaitez importer. Si les données sont correctes, une fenêtre s'affichera avec un aperçu de toutes les lignes qui seront importées, cliquez sur OK pour terminer l'importation.
Factures
En-têtes à utiliser pour créer un fichier *csv avec les Factures à importer :
- InvoiceNumber: En important, il sera remplacé par le numéro interne.
- InvoiceDate: Champs obligatoire
- InvoiceDueDate
- InvoiceDescription
- InvoiceDiscount
- InvoiceVatTotal: Valeur non utilisée pour l'importation, sert à vérifier si après l'importation les montants correspondent.
- InvoiceTotalToPay: Valeur non utilisée pour l'importation, sert à vérifier si après l'importation les montants correspondent.
- InvoiceCurrency
- InvoiceRoundingTotal
- InvoiceAmountType: vat_excl, vat_incl, vat_none (par défaut c'est vat_excl).
- CustomerNumber: Champs obligatoire
- CustomerName: Valeur non utilisée pour l'importation, contient le Nom de l'Organisation ou le Prénom et le Nom de Famille plus la localisation.
- ItemNumber
- ItemDescription: Champs obligatoire
- ItemQuantity
- ItemUnitPrice
- ItemUnit
- ItemVatRate
- ItemVatCode
- ItemDiscount
- ItemTotal: Champ obligatoire, contient la TVA totale exclusive si InvoiceAmountType est vat_excl, sinon il contient la TVA totale incluse.
- ItemVatTotal: Non utilisé pour l'importation.
Règles d'importation
- Le numéro de facture sera remplacé par un numéro de facture interne.
- Le numéro de client doit exister dans le tableau des contacts.
- Le numéro d'article doit exister dans le tableau des articles
- Le code TVA doit exister dans le tableau des Codes TVA
- Vous pouvez également obtenir une erreur :
- Si un champ obligatoire manque, vous obtenez une erreur
- Si un champ ne correspond pas au format, une erreur est renvoyée.
- En cas d'erreur, la facture n'est pas importée. Corrigez le problème, puis réessayez avec l'importation.
Exemple de fichier *.csv avec quelques factures :
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,
Offres
En-têtes à utiliser pour créer un fichier *csv avec les offres à importer :
- InvoiceNumber: En important, il sera remplacé par le numéro interne.
- InvoiceDate: Champs obligatoire
- InvoiceDueDate
- InvoiceDescription
- InvoiceDiscount
- InvoiceVatTotal: Valeur non utilisée pour l'importation, sert à vérifier si après l'importation les montants correspondent.
- InvoiceTotalToPay: Valeur non utilisée pour l'importation, sert à vérifier si après l'importation les montants correspondent.
- InvoiceCurrency
- InvoiceRoundingTotal
- InvoiceAmountType: vat_excl, vat_incl, vat_none (par défaut c'est vat_excl).
- CustomerNumber: Champs obligatoire
- CustomerName: Valeur non utilisée pour l'importation, contient le Nom de l'Organisation ou le Prénom et le Nom de Famille plus la localisation.
- ItemNumber
- ItemDescription: Champs obligatoire
- ItemQuantity
- ItemUnitPrice
- ItemUnit
- ItemVatRate
- ItemVatCode
- ItemDiscount
- ItemTotal: Champ obligatoire, contient la TVA totale exclusive si InvoiceAmountType est vat_excl, sinon il contient la TVA totale incluse.
- ItemVatTotal: Non utilisé pour l'importation.
Règles d'importation
- Le numéro de facture sera remplacé par un numéro de facture interne.
- Le numéro de client doit exister dans le tableau des contacts.
- Le numéro d'article doit exister dans le tableau des articles
- Le code TVA doit exister dans le tableau des Codes TVA
- Vous pouvez également obtenir une erreur :
- Si un champ obligatoire manque, vous obtenez une erreur
- Si un champ ne correspond pas au format, une erreur est renvoyée.
- En cas d'erreur, la facture n'est pas importée. Corrigez le problème, puis réessayez avec l'importation.
Exemple de fichier *.csv avec quelques offres :
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
Exportation
L'exportation génère un fichier *.csv contenant les données exportées. Lors de l'exportation, les données de toutes les colonnes sont exportées ; le fichier *csv généré a la même structure que celle définie pour l'importation.
Lorsque vous exportez, vous pouvez décider :
- Du nom du fichier généré.
- S'il faut ouvrir immédiatement un aperçu du fichier.