DeltiaAide

Créer une sortie de stock depuis une règle

Faire ouvrir par une règle une sortie de stock en brouillon, qu'une personne valide ensuite dans le module Stocks

À quoi ça sert

L'action « Créer une sortie de stock (brouillon) » permet à une règle de préparer une sortie de marchandises sans que personne la saisisse : par exemple ouvrir une sortie « Casse / perte » quand un article passe au statut archivé, ou une sortie « Usage interne » à la création d'un contrat.

La règle ne fait jamais sortir les marchandises. Elle ouvre une opération de type « Sortie » au statut « Brouillon » dans le module Stocks. Une personne la relit puis la valide : tant qu'elle ne l'a pas fait, le stock, sa valorisation et les documents qui en dépendent ne bougent pas. Aucune action de règle ne valide une opération de stock.

Concepts clés

  • Sortie de stock — une opération qui retire des articles du stock d'un entrepôt. Les motifs proposés par l'action sont « Vente », « Casse / perte », « Usage interne », « Retour fournisseur » et « Autre ».
  • Brouillon — l'état dans lequel l'opération est créée. Elle reste modifiable et sans effet sur le stock.
  • Ligne — un article et une quantité, éventuellement avec un conditionnement. Une sortie compte de 1 à 50 lignes, nommées une par une dans la règle.
  • Périmètre — le groupe qui porte l'opération. Il est obligatoire : la règle doit le désigner.

Comment faire

Ouvrir une sortie en brouillon depuis une règle

  1. Dans le bloc « Actions », cliquez sur « Ajouter une action », puis choisissez « Créer une sortie de stock (brouillon) ».
  2. Dans les paramètres, reprenez l'exemple fourni et renseignez scopeId, le périmètre qui portera l'opération.
  3. Renseignez lines : un itemId et une quantity par ligne.
  4. Ajoutez si besoin reason (le motif), notes et warehouseId (l'entrepôt).
  5. Enregistrez la règle.

Quand la règle part, une opération « Sortie » apparaît au statut « Brouillon » dans le module Stocks.

Exemple, sur une règle au déclencheur « Stocks » qui part à la modification d'un article :

{
  "scopeId": "{{trigger.record.scopeId}}",
  "reason": "scrap",
  "lines": [{ "itemId": "{{trigger.record.id}}", "quantity": "1" }]
}

Les variables du déclencheur, les formules et les valeurs de l'analyse IA sont acceptées dans ces valeurs. Voir Configurer les actions.

Faire relire la sortie avant sa création

  1. Dans l'action, activez « Soumettre à validation ».
  2. Enregistrez la règle.

La règle n'ouvre alors le brouillon qu'après la décision d'un valideur. Dans la file « À valider », la sortie s'affiche en clair : le périmètre, le motif, l'entrepôt, les notes et les lignes sous la forme « 3 × nom de l'article ». Un valideur qui n'a pas accès au module Stocks voit les identifiants à la place des noms. Voir Valider les actions des automatisations.

Référence

Paramètres

CléContenuObligatoire
scopeIdLe périmètre qui portera l'opérationOui
linesDe 1 à 50 lignes : itemId, quantity, et packagingId en option. La quantité accepte un nombre, du texte ou une variableOui
reasonsale (« Vente »), scrap (« Casse / perte »), internal_use (« Usage interne »), supplier_return (« Retour fournisseur »), other (« Autre »)Non
notesUne note libreNon
warehouseIdL'entrepôt d'où sortent les articlesNon

Toute autre clé est refusée et fait échouer l'action.

Messages de refus

MessageCause
« Choisissez le périmètre qui portera la sortie de stock »Le paramètre scopeId est vide à l'enregistrement de la règle

Comportements automatiques

  • Les articles se nomment un par un : aucun filtre ne retire « tout ce qui figure dans une catégorie ».
  • Si le serveur est interrompu pendant l'action, le rattrapage peut la rejouer et ouvrir un second brouillon identique.
  • La règle peut être déclenchée par un article, un contrat, une facture ou n'importe quel autre déclencheur : l'action ne dépend pas du module qui démarre la règle.

Questions fréquentes

Puis-je faire valider la sortie par la règle elle-même ?

Non. Une règle ne peut qu'ouvrir un brouillon. Le stock ne bouge qu'après la validation d'une personne dans le module Stocks.

Puis-je sortir tous les articles d'une catégorie ?

Non pour l'instant : chaque article se nomme dans lines, avec sa quantité.

Puis-je faire une entrée de stock ou un transfert depuis une règle ?

Non. Seule la sortie est proposée.

Sur cette page