T-IOT-901_convoyor/docs/dolibarr/README.md

# 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:

![Api token user](../resources/image.png)


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
} 
```