Intro & Documentation :

La documentation générale de notre API est disponible ici : https://documentation.tactill.com/docs

Prenons le cas d'usage suivant : vous souhaitez faire entrer 15 articles en stock que nous venons de recevoir de notre fournisseur.

1- Nous devons savoir que le fonctionnement du stock chez Tactill fonctionne selon une logique de mouvements d'entrée/sortie. Les articles n'ont pas de quantité de stock "en dur", mais un ensemble de mouvements d'entrée/sortie qui, additionnés, nous donnent l'indication de la quantité en stock dudit article.

2- Nous nous intéressons donc aux mouvements de stock, cela est en rapport avec la fonctionnalité de stock, vous trouverez donc d'avantage d'informations sur les routes disponibles sous "Stock" ici : https://api4.tactill.com/v1/stock/documentation

3- Nous voulons créer un mouvement d'entrée de stock, on s'intéresse donc à la route POST /movements.

La documentation technique de cette route est disponible ici : https://api4.tactill.com/v1/stock/documentation#!/v1/postMovements

4- Dans l'exemple nous utilisons le l'outil de requêtage Insomnia. Construisons la requête de type POST, l'URL est la suivante : https://api4.tactill.com/v1/stock/movements

Passez dans le body le détail de votre mouvement. Les champs obligatoires et/ou non obligatoires sont précisés sur la page de documentation. Ci-dessous, un exemple pour un mouvement de type "in" (entrée en stock), pour un article simple qu'on rentre en 10 exemplaires.

5- Passez votre clé d'API dans le header de la requête sous le paramètre x-api-key

6- Envoyez la requête, voici la réponse observée. Vous obtenez en réponse le mouvement complété par l'API. Vous y trouverez le numéro du mouvement, et la date exacte de traitement.

7- Le mouvement a bien été pris en compte. Vous pouvez vous connecter au tableau de bord ou via une app Tactill sur iOS pour vérifier la quantité en stock mise à jour.

Avez-vous trouvé votre réponse?