58 lines
1.6 KiB
Markdown
58 lines
1.6 KiB
Markdown
# Dolbarr documentation
|
|
|
|
### Créer une instance de dev
|
|
|
|
Pour créer une instance de développement, nous allons utiliser l'image docker de dolibarr:
|
|
https://hub.docker.com/r/tuxgasy/dolibarr/
|
|
|
|
pour simplifier l'installation, un docker-compose est disponible a la racine du projet `./docker-compose-dolibarr.yml`
|
|
|
|
pour lancer dolibarr:
|
|
```shell
|
|
$ docker compose -f docker-compose-dolibarr.yml up
|
|
```
|
|
|
|
ensuite il faut se rendre sur http://0.0.0.0/ puis se login avec les credentials par défault (admin, admin)
|
|
|
|
|
|
### Api flow
|
|
|
|
Base url: http://0.0.0.0/api/index.php/
|
|
|
|
Pour commencer, il faut récupérer l'api token d'un utilisateur pour pouvoir faire des requêtes api, assurer vous bien que l'utilisateurs a bien les permissions nécéssaires:
|
|
|
|
|
|
|
|
|
|
ensuite vous pouvez utiliser ce token pour chaque route API en ajoutant dans les headers:
|
|
DOLAPIKEY = {{votre_ap_token}}
|
|
|
|
Récupérer le warehouse de base et vérifier son existance :
|
|
|
|
```
|
|
Method: GET
|
|
Url: warehouses/{id}
|
|
```
|
|
|
|
|
|
Récupérer les produits disponibles:
|
|
|
|
```
|
|
Method: GET
|
|
Url: products?sortfield=t.ref&sortorder=ASC&limit=10000
|
|
```
|
|
|
|
Pour créer un mouvement de stock:
|
|
|
|
```
|
|
Method: POST
|
|
Url: stockmovements?sortfield=t.rowid&sortorder=ASC&limit=100
|
|
Body (JSON):
|
|
{
|
|
"product_id": "1", //string, - id of the product to move
|
|
"warehouse_id": "1", //string - id of the warehourse
|
|
"qty": 60, //int - quantity to move (1 for positive or -1 to remove one item)
|
|
"movementcode": "S-1", //string - code of the mouvement
|
|
"movementlabel": "Abc" //string - label of the mouvement
|
|
}
|
|
``` |