Latest revision as of 14:20, 27 May 2020

Informations

Module name	DOLIMPORT API & DOLIMPORT CSV
Editor / Editeur	Florian DUFOURG - demo
Download or buy page / Page achat ou téléchargement	External module - www.dolistore.com
Status / Statut / Estado	Stable
Prerequisites / Prérequis	Dolibarr min version: See on Dolistore Dolibarr max version: See on Dolistore
Last update date / Date mise à jour fiche / Fecha última actualización	2020-05-27
Note / Nota

Fonctionnalités

Importez vos relevés bancaires depuis un fichier CSV ou directement depuis une connexion automatisé à l'API de la banque QONTO (module DOLIMPORT API). Ce module permet de réaliser les actions ci-dessous :

Créer et payer une facture client
Créer et payer une facture fournisseur
Créer et payer la TVA
Créer et payer un salaire
Créer et payer des charges sociales ou fiscales
Payer une facture client existante
Payer une facture fournisseur existante
Payer un emprunt
Payer une note de frais
Lié une transaction à un paiement existant

Si l'option de rapprochement du compte bancaire est seléctionnée alors le rapprochement sera réalisé automatiquement.

Dans le cas de DOLIMPORT API, il est possible de récupérer directement vos fichiers joints à QONTO depuis Dolibarr. Les TVA inscrites dans QONTO seront prise en compte par le module DOLIMPORT.

Installation

Télécharger le fichier archive du module (.zip) depuis le site web www.dolistore.com ou le récupérer par tout autre manière.

Placer le répertoire du module dans le répertoire custom de Dolibarr:
- Pour cela, aller dans Accueil - Configuration - Modules - Déployer/installer une app/module externe
- Téléverser le fichier. Note: Si cela échoue, vous pouvez manuellement dézipper le fichier dans le répertoire custom via la ligne de commande: aller dans le répertoire *custom* et décompressez le zip avec la commande: unzip fichiermodule.zip

Le module est opérationnel et peut être activé.

Configuration

Pour utiliser ce module, il vous faut d'abord l'activer. Pour cela, après s'être connecté avec un compte administrateur, aller sur la page "Accueil - Configuration - Modules".

Choisissez l'onglet dans lequel apparaît le module puis cliquez sur "Activer".

Le module est alors activé.

Si un pictogramme apparaît sur la vignette ou à la fin de la ligne du module, cliquez dessus pour accéder à la page de paramétrage spécifique à ce module.

Configuration du module

Paramètres du module

Modifier les paramètres depuis la page de configuration du module. Vous pouvez définir les options suivantes :

Choisissez le projet par défaut (cette valeur peut être modifiée également au moment de l'importation)
Le montant de TVA par défaut (cette valeur peut être modifiée également au moment de l'importation ou il peut être défini par QONTO ou dans le fichier CSV)
Options : Montrer seulement les projets ouverts
Options : Ajouter un numéro unique aux références fournisseur (permet d'éviter les erreurs liées aux doublons)
La période à montrer sur la page de la liste des transactions

Connexion à QONTO

Cette section concerne seulement les utilisateurs de DOLIMPORT API qui souhaite connecter leur compte en banque QONTO au module.

Vous devez récupérer plusieurs informations depuis votre espace personnel de Qonto.

DOLIMPORT API ajoute automatiquement 3 nouveaux champs (extrafields) aux compte en banque Dolibarr :

Extrafield BANK API setup

Sélectionnez Qonto (seule option possible pour le moment)

Extrafield ID API & KEY API setup

Connectez vous à votre compte en banque : | QONTO

Dans le menu de gauche choisissez "paramètres".

Dans le menu de gauche choisissez "intégration API".

Vous pouvez désormais retourner sur Dolibarr et remplir les champs ID et KEY API trouvé sur la page web QONTO

Charger un fichier CSV

Aller sur la page "charger le fichier CSV"

La partie gauche de cette page permet de préparer le chargement du fichier. Les paramètres sont automatiquement sauvegardé pour le prochain chargement de fichier.

Sélectionnez le format de date tel qu'il est formaté dans votre fichier CSV
Sélectionnez la manière dont est présenté le montant des transaction (une colonne ou 2 colonnes)
Sélectionnez la manière dont le mode de paiement est présenté dans votre fichier CSV. Si le mode de paiement est inscrit dans le fichier CSV alors vous devez indiquer les traductions afin que Dolibarr le reconnaisse. Pour chaque mode de paiement de la liste indiquez la traduction dans votre fichier CSV.*

La partie droite de cette page montre la liste des fichiers CSV déjà importés.

Configuration des lignes

Une fois le fichier CSV chargé, sélectionnez une catégorie pour chaque colonne.

Dé-selectionner les lignes que vous ne souhaitez pas importer (par exemple la ligne de titre).

Avant l'importation, Donnez un nom au relevé de compte. Ainsi si le rapprochement bancaire est activé, le nom du relevé sera pré-rempli.

Parfois PHP limite la quantité d'information pouvant être importée (limite des données POST). Si un message indique qu'il y a trop de colonnes et de lignes dans le fichier CSV, vous devez supprimer des colonnes ou diviser votre fichier CSV en plusieurs fichiers par exemple.

Génération des éléments Dolibarr depuis la liste des transactions

Si vous avez réussi le chargement du fichier CSV ou si vous êtes connecté à l'API de QONTO (DOLIMPORT API), vous pouvez voir la liste des transactions en faisans un click sur le nom de la banque dans le menu.

Génération des éléments (factures, taxes, salaires, emprunts...)

Pour générer un élément Dolibarr (factures, notes de frais, TVA, taxes, salaires, emprunts, paiement...), cliquez sur l'icone correspondant à droite de la ligne de la transaction.

Sélectionnez l'icone correspondant au type d'élément à créer et remplissez le formulaire qui apparait.

@@ Line 2: / Line 2: @@
 <!-- Do NOT edit this section
       Links below are automatically managed by PolyglotBot
-      You can edit links on the English source page : Module_easy_dashboard -->
+      You can edit links on the English source page : Module_Dolimport -->
 [[en:Module_Dolimport]]
-[[fr:Module_Dolimport fr]]
 <!-- END interlang links -->
@@ Line 16: / Line 15: @@
 =Informations=
 {{TemplateModuleInfo
-|modulename=DOLIMPORT API
+|modulename=DOLIMPORT API & DOLIMPORT CSV
 |editor=Florian DUFOURG
-|web=[http://dolitest.vps100069.mylogin.co demo]
+|web=[http://dolitest.vps100069.mylogin.co/custom/bankimportapi/bankimportapiindex.php?id_bank=1&idmenu=6 demo]
-|webbuy={{LinkToPluginDownloadDoliStore|keyword=dolimport_api}}
+|webbuy={{LinkToPluginDownloadDoliStore|keyword=Dolimport_csv}}
 |status=stable
 |prerequisites=
@@ Line 26: / Line 25: @@
 }}
-=Features=
+=Fonctionnalités=
-Import your bank statements from a csv file or connect directly the information from your QONTO bank account. Then many options are available :
+Importez vos relevés bancaires depuis un fichier CSV ou directement depuis une connexion automatisé à l'API de la banque QONTO (module DOLIMPORT API).
+Ce module permet de réaliser les actions ci-dessous :
+#Créer et payer une facture client
+#Créer et payer une facture fournisseur
+#Créer et payer la TVA
+#Créer et payer un salaire
+#Créer et payer des charges sociales ou fiscales
+#Payer une facture client existante
+#Payer une facture fournisseur existante
+#Payer un emprunt
+#Payer une note de frais
+#Lié une transaction à un paiement existant
-#Create and paye a customer invoice
+Si l'option de rapprochement du compte bancaire est seléctionnée alors le rapprochement sera réalisé automatiquement.
-#Create and paye a vendor invoice
-#Create and pay a VAT
-#Create and pay a salary
-#Create and pay a social and fiscal taxes
-#Pay an existing customer invoice
-#Pay an existing vendor invoice
-#Pay a loan
-#Pay an expense report
-#Link a payment to a transaction
-If you use QONTO API, you can download the attached files of QONTO directly from Dolibarr. Also the VAT and all other usefull information will be used to generate the Dolibarr elements.
+Dans le cas de DOLIMPORT API, il est possible de récupérer directement vos fichiers joints à QONTO depuis Dolibarr. Les TVA inscrites dans QONTO seront prise en compte par le module DOLIMPORT.
-If the reconciliation option of the bank account is activated in Dolibarr, Dolimport API will also automaticaly reconciliate the statement.
+=Installation=
+{{InstallModuleDoliStoreFr|keyword=dolimport}}
-=Install=
+=Configuration=
-{{InstallModuleDoliStoreEn|keyword=dolimport_api}}
+{{ActivationModuleFr}}
-=Setup=
+===Configuration du module===
-{{ActivationModuleEn}}
+====Paramètres du module====
+Modifier les paramètres depuis la page de configuration du module. Vous pouvez définir les options suivantes :
+*Choisissez le projet par défaut (cette valeur peut être modifiée également au moment de l'importation)
+*Le montant de TVA par défaut (cette valeur peut être modifiée également au moment de l'importation ou il peut être défini par QONTO ou dans le fichier CSV)
+*Options : Montrer seulement les projets ouverts
+*Options : Ajouter un numéro unique aux références fournisseur (permet d'éviter les erreurs liées aux doublons)
+*La période à montrer sur la page de la liste des transactions
-===Module Configuration===
+=Connexion à QONTO=
-====Module setup page====
+ Cette section concerne seulement les utilisateurs de DOLIMPORT API qui souhaite connecter leur compte en banque QONTO au module.
-Configure the module from the module setup page, you can define :
-*The default project you want to link the element (this value can be change later in the form)
+Vous devez récupérer plusieurs informations depuis votre espace personnel de Qonto.
-*The default VAT value (this value can be change later in the form or directly define in the CSV file or in QONTO)
-*An option to show only open project in dolimport API form or all projects
-*An option to add a unique number for vendor reference (avoid double reference)
-*The period of time you want to show in the list of transaction
-=Connect to QONTO API=
+DOLIMPORT API ajoute automatiquement 3 nouveaux champs (extrafields) aux compte en banque Dolibarr :
- If you want to use the module with a csv file, you have nothing more to do.
-To connect Qonto to Dolibarr, go to the bank account card in Dolibarr.
-Dolimport API automatically add 3 fields : ID API, KEY API and BANK API.
 ===Extrafield BANK API setup===
-Select QONTO as BANK API value (for now it is the only option).
+Sélectionnez Qonto (seule option possible pour le moment)
 ===Extrafield ID API & KEY API setup===
-Go to your QONTO account : [https://app.qonto.eu/ | QONTO]
+Connectez vous à votre compte en banque : [https://app.qonto.eu/ | QONTO]
 <br />
 [[File:QONTO_API_configuration_1.png|alt=|border|left|202x202px]]
-On the left menu of the QONTO web page, select "paramètres."
+Dans le menu de gauche choisissez "paramètres".
 <br clear="all">
 [[File:QONTO_API_configuration_2.png|alt=|border|left|271x271px]]
-On the left menu select "intégration API".
+Dans le menu de gauche choisissez "intégration API".
 <br clear="all">
-Now you can go back to Dolibarr and fill the ID and KEY API with the info found on the QONTO website.
+Vous pouvez désormais retourner sur Dolibarr et remplir les champs ID et KEY API trouvé sur la page web QONTO
 =Menu=
-You can see this module in the left menu of the "bank" top menu.
+Le module DOLIMPORT apparait automatiquement dans le menu de gauche du module "banque"
-  If you choose the QONTO API option, only one link will appear in the menu, this is the list of transactions.
+  Si vous choisissez l'option QONTO API, seul le lien vers la liste des transactions apparait
-  If you are not using QONTO API (so you are using CSV import), 2 links will appears in the menu, one to import transaction from a csv file and an other to see and process the transactions.
+  Si vous n'utilisez pas QONTO API (vous utilisez donc l'importation par CSV), 2 liens apparaissent dans le menu, un lien pour uploader un fichier CSV et un autre avec la liste des transactions.
-=Import a file (only if you use CSV files)=
+=Charger un fichier CSV=
-Go to the page : "load a csv file".
+Aller sur la page "charger le fichier CSV"
 <div class="divforimgcentpercent">
 [[File:DOLIMPORT API Import csv page 2.png]]
-</div>The left section of this page allows to prepare the import of the CSV file. All the parameters are saved for the next import.
+</div>
+La partie gauche de cette page permet de préparer le chargement du fichier. Les paramètres sont automatiquement sauvegardé pour le prochain chargement de fichier.
-#Select the date format as it is on the csv file
-#Select how the amount (credit and debit) are shown in the csv file
-#Select how the payment is defined in the csv file, if the payment mode is define so we need the translation between the Dolibarr payment mode and your bank statement csv file. The files below "translation" allow to explain how the payment mode are named in the csv file.
+#Sélectionnez le format de date tel qu'il est formaté dans votre fichier CSV
+#Sélectionnez la manière dont est présenté le montant des transaction (une colonne ou 2 colonnes)
+#Sélectionnez la manière dont le mode de paiement est présenté dans votre fichier CSV. Si le mode de paiement est inscrit dans le fichier CSV alors vous devez indiquer les traductions afin que Dolibarr le reconnaisse. Pour chaque mode de paiement de la liste indiquez la traduction dans votre fichier CSV.*
-The right section of this page show the csv statement already importes. You can delete the statement doing click on the trash bin icon.
+La partie droite de cette page montre la liste des fichiers CSV déjà importés.
-===Setting of the lines===
+===Configuration des lignes===
-Once your csv file is uploaded, select the category of each column (date of operation, date of value, amount, label, secondary label).
+Une fois le fichier CSV chargé, sélectionnez une catégorie pour chaque colonne.
-The fields operation date, label and amount are required, the other fields are optionnals.
+Dé-selectionner les lignes que vous ne souhaitez pas importer (par exemple la ligne de titre).
-Uncheck the lines that you do not want to import (for example if there is a title line).
 <div class="divforimgcentpercent">
 [[File:DOLIMPORT API Import csv page 3.png]]
 </div>
+Avant l'importation, Donnez un nom au relevé de compte. Ainsi si le rapprochement bancaire est activé, le nom du relevé sera pré-rempli.
-Before to import give a name to the bank statement, it will help to reconcile.
 <br />
-  Sometime PHP limits the quantity of datas you can import, if a message shows that there is too much columns and rows, you should delete columns in the csv file or divide the csv file in many files.
+  Parfois PHP limite la quantité d'information pouvant être importée (limite des données POST). Si un message indique qu'il y a trop de colonnes et de lignes dans le fichier CSV, vous devez supprimer des colonnes ou diviser votre fichier CSV en plusieurs fichiers par exemple.
-=Generate Dolibarr elements from the list of transaction=
+=Génération des éléments Dolibarr depuis la liste des transactions=
-If you already successfully load a csv file or if your QONTO bank account is connected to Dolibarr, you can see the list of the transaction doing click on the name of the bank account in the menu.
+Si vous avez réussi le chargement du fichier CSV ou si vous êtes connecté à l'API de QONTO (DOLIMPORT API), vous pouvez voir la liste des transactions en faisans un click sur le nom de la banque dans le menu.
 <br />
-===Generate the elements (invoices, taxes, salaries,loan...)===
+===Génération des éléments (factures, taxes, salaires, emprunts...)===
-To generate a Dolibarr element (invoice, expense report, payment, loan...) you have to make a click on an icon on the right of the click.
+Pour générer un élément Dolibarr (factures, notes de frais, TVA, taxes, salaires, emprunts, paiement...), cliquez sur l'icone correspondant à droite de la ligne de la transaction.
 <div class="divforimgcentpercent">
 [[File:DOLIMPORT List of transactions 2.png]]
-</div>Select the icon depending of the type of element you want to generate.
+</div>Sélectionnez l'icone correspondant au type d'élément à créer et remplissez le formulaire qui apparait.
 [[File:DOLIMPORT_generation_of_vendor_invoice.png|1200x1200px]]
 <br />

Module Dolimport fr: Difference between revisions