Nous continuons d'étendre les possibilités de l'API publique v2 dans RO App. Désormais, via l'API, vous pouvez gérer les tâches des employés, définir des niveaux de stock minimum et maximum pour les produits dans les entrepôts et associer plus précisément les factures aux commandes. Cela vous aide à synchroniser les données avec d'autres systèmes sans les saisir manuellement. De plus, de nouveaux webhooks sont disponibles pour les tâches.
Les tâches via l'API
L'API publique v2 propose désormais des endpoints pour travailler avec les tâches. Ils prennent en charge les statuts et la priorité des tâches : les données de l'API correspondent donc à ce que vous voyez dans RO App.
Vous pouvez désormais :
obtenir la liste des tâches ou une tâche précise – avec son nom, sa description, son statut, sa priorité, son auteur, ses responsables, sa date d'échéance et l'enregistrement associé ;
créer, modifier et supprimer des tâches ;
changer le statut d'une tâche et y ajouter des commentaires ;
obtenir la liste des statuts des tâches.
Vous pouvez filtrer les tâches par statut, priorité, auteur, responsables, date de création et date d'échéance. Des filtres distincts sont également disponibles pour les tâches en retard et les tâches sans responsable. Vous pouvez trier la liste par date de création, date de modification, date d'échéance ou priorité.
Remarque : une nouvelle tâche est toujours créée avec le statut initial, que vous pouvez modifier par une requête distincte. Via l'API, vous ne pouvez définir qu'un statut disponible pour le rôle de l'employé, comme dans la version web. Un changement de statut via l'API est enregistré dans la tâche de la même manière qu'un changement manuel.
Nous avons également ajouté de nouveaux webhooks pour les tâches – pour les changements de statut et de priorité. Ainsi, d'autres systèmes en sont informés immédiatement, sans requêtes régulières à l'API. Pour les activer, lors de la configuration du webhook, sélectionnez les événements "Statut modifié" et "Priorité modifiée" dans le bloc "Tâches".
Pour en savoir plus, consultez la documentation des endpoints pour les tâches.
Niveaux de stock minimum et maximum
Désormais, vous pouvez définir les niveaux de stock minimum et maximum des produits via l'API – séparément pour chaque entrepôt. Vous pouvez :
obtenir les niveaux de stock minimum et maximum d'un produit dans tous les entrepôts ou dans un entrepôt précis ;
les définir et les modifier pour un entrepôt ;
les supprimer pour un entrepôt s'ils ne sont plus nécessaires.
Les produits dont le stock est inférieur au minimum apparaissent sur la page "Produits à commander à nouveau". Si vous planifiez vos achats dans un autre système, vous pouvez transférer automatiquement ces paramètres depuis ce système au lieu de remplir manuellement les fiches produits.
Pour en savoir plus, consultez la documentation des endpoints pour les niveaux de stock minimum et maximum.
Factures et commandes
Nous avons également amélioré les endpoints pour travailler avec les factures, afin que vous puissiez associer plus facilement les factures aux commandes. Désormais :
les articles de la facture contiennent l'ID de la commande à partir de laquelle ils ont été ajoutés ;
vous pouvez filtrer la liste des factures par commande – vous obtiendrez toutes les factures contenant au moins un article de cette commande ;
un nouvel endpoint permet d'ajouter à une facture des articles issus des commandes.
Pour en savoir plus, consultez la documentation de l'endpoint pour ajouter des articles de commandes à une facture.
Comment les nouveaux endpoints aident votre entreprise
Par exemple, ils vous permettent de :
synchroniser les tâches avec des gestionnaires de tâches et les calendriers des employés ;
créer automatiquement des tâches en fonction d'événements dans d'autres systèmes – par exemple, un rappel pour recontacter un client ;
créer vos propres rapports sur l'exécution et les retards des tâches ;
mettre à jour en une seule fois les niveaux de stock minimum et maximum pour de nombreux produits et entrepôts – par exemple, avant la saison ;
facturer automatiquement les articles des commandes et vérifier que tout a déjà été facturé au client.
Accès aux endpoints
La clé API appartient à un employé précis de RO App et dispose des mêmes droits d'accès que lui. Par exemple, pour travailler avec les tâches via l'API, l'employé a besoin des droits correspondants dans son rôle : consulter, créer, modifier ou supprimer des tâches.
Si vous avez des questions, des suggestions ou des commentaires concernant l'API publique et les webhooks de RO App, contactez-nous via le chat d'assistance.