Articles - Vue d'ensemble

Le référentiel articles est le fondement de toutes les opérations logistiques dans EzyConnect. Aucune commande ni aucun approvisionnement ne peut être créé sans que les articles référencés existent au préalable.

Concepts clés

Identifiant unique

Chaque article est identifié par la combinaison activityCode + articleReference. L’articleReference doit être unique au sein d’une activité (max 16 caractères, alphanumériques + _, ., #, /, -).

Upsert automatique

L’endpoint POST /articles fonctionne en mode upsert : si un article avec la même activityCode + articleReference existe déjà, il est mis à jour. Sinon, il est créé.

Mode de gestion des variantes logistiques (VlMode)

Votre activité est configurée dans l’un de ces deux modes :

Mode	Description
skipVl	Le système gère automatiquement les variantes logistiques à partir des dimensions UVC/PCB/SPCB de l’article. Vous ne devez pas envoyer le champ logisticalVariants.
managedVl	Vous gérez explicitement les variantes logistiques. Vous devez envoyer les variantes dans le champ logisticalVariants.

Attention

Si votre activité est en mode skipVl et que vous envoyez des logisticalVariants, l’API retournera une erreur 200 : “logisticalVariants n’est pas autorisé dans votre contexte”.

Verrouillage après première réception

Après la première réception d’un article dans le WMS, certains champs deviennent en lecture seule :

Champs verrouillés	Condition
Dimensions UVC (poids, longueur, largeur, hauteur)	RTopVlNouvelle = false
Dimensions PCB, SPCB, SUP	RTopVlNouvelle = false
Quantités PCB, SPCB, SUP	RTopVlNouvelle = false
Codes logistiques (stockage, préparation, etc.)	RTopVlNouvelle = false
Données alcool (degré, contenance, type, etc.)	RTopVlNouvelle = false
Codes-barres	RTopVlNouvelle = false
Structure des variantes logistiques	NewLv = false sur la VL 30

Note

Le flag RTopVlNouvelle est interne et géré automatiquement. Il passe à false après la première réception. Les valeurs envoyées pour les champs verrouillés sont silencieusement ignorées (pas d’erreur, les anciennes valeurs sont conservées).

Variantes logistiques (VL)

Les variantes logistiques représentent les différents conditionnements d’un article :

Code	Libellé	Description
10	UVC	Unité de Vente Consommateur — le conditionnement de base
15	SPC	Sous-Palette Complète
20	PCB	Par Combien (carton)
30	SUP	Surpalette / palette — le conditionnement d’expédition

Les VL suivent une hiérarchie obligatoire :

30 (SUP) ─ contient ─► 20 (PCB) ─ contient ─► 15 (SPC) ─ contient ─► 10 (UVC)

Règles de structure :

• Il doit y avoir exactement une VL 10 avec baseLv = true
• Il doit y avoir exactement une VL 30 avec packagingLv = true
• subpackagingLvCode doit référencer une VL parente existante
• Les quantités doivent être mathématiquement cohérentes

Codes-barres

Chaque article peut avoir plusieurs codes-barres. Un code-barre est lié à une unité logistique :

Unité	Code VL	Description
UVC	10	Code-barre de l’unité consommateur
SPC	15	Code-barre du sous-colis
PCB	20	Code-barre du carton
SUP	30	Code-barre de la palette

Astuce

Vous pouvez spécifier l’unité soit par barcodeUnit (ex: "PCB") soit par logisticalVariantCode (ex: "20"). Si les deux sont fournis, barcodeUnit est prioritaire.

Données alcool

Si l’article est un produit alcoolisé, vous pouvez renseigner l’objet alcool avec les informations réglementaires (degré, contenance, type fiscal). Le champ itemType est obligatoire dans ce cas :

• "010" = Acquit
• "020" = CRD (Capsule Représentative de Droit)

Types d’articles

Valeur	Signification
0	Stockable (défaut)
1	Consommable
2	Service

Endpoints

Méthode	Endpoint	Description
GET	/articles	Lister les articles
GET	/articles/{articleReference}	Obtenir un article spécifique
POST	/articles	Créer ou mettre à jour des articles
GET	/articles/stock	Snapshot du stock
GET	/articles/movements	Mouvements de stock
GET	/articles/{articleReference}/movements	Mouvements d’un article