Module Dolimport: Difference between revisions

Jump to navigation Jump to search
no edit summary
No edit summary
Tag: 2017 source edit
No edit summary
Line 52: Line 52:
*The period of time you want to show in the list of transaction
*The period of time you want to show in the list of transaction


====Bank card====
== Connect to QONTO API ==
If you want to use the module with a csv file, you have nothing more to do.
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.
To connect Qonto to Dolibarr, go to the bank account card in Dolibarr.


Line 64: Line 63:
=====Extrafield ID API & KEY API setup=====
=====Extrafield ID API & KEY API setup=====
Go to your QONTO account : [https://app.qonto.eu/ | QONTO]
Go to your QONTO account : [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."
On the left menu of the QONTO web page, select "paramètres."
[[File:QONTO API configuration 1.png|200px|QONTO paramètres]]
<br clear=all>


<br clear="all">
[[File:QONTO_API_configuration_2.png|alt=|border|left|271x271px]]
On the left menu select "intégration API".
On the left menu select "intégration API".
[[File:QONTO API configuration 2.png|200px|QONTO intégration API]]
 
<br clear=all>
<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.
Now you can go back to Dolibarr and fill the ID and KEY API with the info found on the QONTO website.


===Menu===
==Menu==
You can see this module in the left menu of the "bank" top menu.
You can see this module in the left menu of the "bank" top menu.
If you choose the QONTO API option, only one link will appear in the menu, this is the list of transactions.


If you choose the QONTO API option, only one link will appear in the menu, this is the list of transactions.
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.


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.
==Import a file (only if you use CSV files)==
Go to the page : "load a csv file".
<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.


===Import a file===
# Select the date format as it is on the csv file
Select a csv file from your bank account and click upload button.
# Select how the amount (credit and debit) are shown in the csv file
<div class="divforimgcentpercent">
# 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.
[[File:CaptureImportBankFromCsv3.PNG]]
 
</div>
 
The right section of this page show the csv statement already importes. You can delete the statement doing click on the trash bin icon.


===Setting of the lines===
===Setting of the lines===
Once your csv file is uploaded, select the category of each column (date of operation, date of value, amount, label, secondary label). You can choose a category only once (except for amount categorie that can be credit and debit). Press the hide column button to make the view easier to read.
Once your csv file is uploaded, select the category of each column (date of operation, date of value, amount, label, secondary label).  
 
The fields operation date, label and amount are required, the other fields are optionnals.
 
Uncheck the lines that you do not want to import (for example if there is a title line).
<div class="divforimgcentpercent">
<div class="divforimgcentpercent">
[[File:CaptureImportBankFromCsv1.PNG]]
[[File:DOLIMPORT API Import csv page 3.png]]
</div>
</div>


Choose for each line the categorie of the line (provider invoice, charge, VAT, salary, loan, customer invoice). Let the categorie blank for the line you don't want to import.


Before to import give a name to the bank statement, it will help to reconcile.
Before to import give a name to the bank statement, it will help to reconcile.


===Select the statement===
<br />
In the billing | payment menu choose 'List of imported statements' and select the bank statement you want to transform as Dolibarr elements.
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.
 
== Generate Dolibarr elements from the list of transaction ==
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.
<br />


===Generate the elements (invoices, taxes, salaries,loan...)===
===Generate the elements (invoices, taxes, salaries,loan...)===
In the process page you can now check the information and click import to generate the new element (invoice, VAT, salary...).
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.


<div class="divforimgcentpercent">
<div class="divforimgcentpercent">
[[File:CaptureImportBankFromCsv2.PNG]]
[[File:DOLIMPORT List of transactions 2.png]]
</div>
</div>Select the icon depending of the type of element you want to generate.
 
[[File:DOLIMPORT generation of vendor invoice.png|border]]<br />
<br />If you prefer to generate a new file manually (without the help of the module), click the delete button.
 
The customer invoices are not generate by this module, we  considere the customer invoices are already made by the user and the user will help to link the invoice to the payment from the bank account.<br />
134

edits

Navigation menu