Paramétrage SCM AZAP

Gestion de l'écran

Ecran de saisie

Principes de fonctionnement

Le traitement par l'interface s'effectue par le biais de fichiers .csv.

Informations générales sur les fichiers

• Format : .csv
• Type : ASCII (modifiable par point d'entrée, voir ci-après)
• Les champs sont de longueur variable avec séparateur ";"  (modifiable par point d'entrée, voir ci-après)
• Les nombres ont comme séparateur décimal : le point.
• Les dates sont renseignées sous la forme "AAAAMMJJHHmm" ou "AAAAMMJJ"
• Les durées sont exprimées en heures
• Les booléens peuvent prendre comme valeur : soit 0 (faux), soit 1 (vrai)
• Les fichiers sont des fichiers DOS (caractères de fin de lignes : \013\010 ou \r\n).
• Les fichiers ont des entêtes.

La description des lignes chacun de ces fichiers est donnée par un Pivot précisant l'ordre des zones, leur taille et décrivant leur alimentation (directement via des zones de tables ou via des fonctions).

Le nom des fichiers, leur description ainsi que les pivots utilisés par défaut sont indiqués ci-dessous.

 Informations non transmises

• Les valorisations : elles ne sont pas gérées dans cette interface. Aucune information sur les montants, les devises (aussi bien sur les articles que sur les ventes) ne sera transmise en standard, via cette interface.
• Les événements exceptionnels, c'est à dire les phénomènes non systématiques qui perturbent les ventes (exemple : les promotions).

Flux d'export : X3 --- AZAP

Fichiers attendus		Pivots
produits.csv	Articles / Produits	SCMAITM
conversion.csv	Articles / Conversions	SCMAITMTCO
critstr.csv	Articles / Critères	SCMAITMCRI
sites.csv	Sites	SCMAFCY
critstrsite.csv	Sites / Critères	SCMACRIFCY
ventes.csv	Historique de ventes	SCMAHSOH
carnet.csv	En-cours commandes / Carnet de commandes	SCMASOH

Flux d'import : AZAP --- X3

Fichiers attendus		Pivots
previsions.csv	Prévisions de ventes	SCMASOS

Points d'entrée

Le point d'entrée PIVOTSFILE du traitement CONNECTFCT permet de modifier le type de codage des fichiers et le séparateur de colonnes.

Descriptif des fichiers exportés depuis Sage X3

Articles : produits.csv

Pivot : SCMAITM

Fichier	N°	Libellé	Type	Lg max	Optionnel	Pivot	Code table	Code champ	Intitulé	Zone non gérée
	1	Code Host Produit	A	20	Non		ITMMASTER	ITMREF	Article	Non
	2	Libellé Article	A	30	Oui		ITMMASTER	ITMDES1	Désignation 1	Non
	3	Libellé 2 article	A	30	Oui		ITMMASTER	ITMDES2	Désignation 2	Non
	4	Unité de vente	A	3	Oui		ITMMASTER	SAU	Unité vente	Non

Remarques :

• L'en-tête du fichier est constitué avec les codes des colonnes paramétrés sur le pivot.
• Seuls les articles de type "Vendu" (information portée par la catégorie de l'article) sont exportés.
• Le paramétrage autorise la saisie d'une sélection d'articles : pour les articles sélectionnés, les informations de conversion ainsi que les critères sont exportés dans des fichiers séparés : conversion.csv et critstr.csv

Articles / Conversions : conversion.csv

Pivot : SCMAITMTCO

Fichier	N°	Libellé	Type	Lg max	Optionnel	Pivot	Code table	Code champ	Intitulé	Zone non gérée
	1	Code Host Produit	A	20	Non		ITMMASTER	ITMREF	Article	Non
	2	Unité 1	A	3	Non		ITMMASTER	WUOM1		Non
	3	Unité 2	A	3	Non		ITMMASTER	WUOM2		Non
	4	Coefficient	N		Non		ITMMASTER	WCOEUOM		Non

Remarques :

• L'en-tête du fichier est constitué avec les codes des colonnes paramétrés sur le pivot.
• Pour chaque article, le fichier contient :
   
  - Une première ligne avec les informations de conversion entre l'unité de vente et l'unité de stock. Cette ligne est toujours présente même si l'unité de vente et l'unité de stock sont identiques.
   
  - Des lignes facultatives sur les conversions entre les 4 unités de conditionnement et l'unité de stock, en fonction du paramétrage effectué.

Articles / Critères : critstr.csv

Pivot : SCMAITMCRI

Fichier	N°	Libellé	Type	Lg max	Optionnel	Pivot	Code table	Code champ	Intitulé	Zone non gérée
	1	Code Host Produit	A	20	Non		ITMMASTER	ITMREF	Article	Non
	2	Statut AZAP (1)	A		Non		ITMMASTER	WAZAPSTA	Statut AZAP	Non
	3	Statut article (2)	A		Non		ITMMASTER	ITMSTA	Statut article	Non
	4	Famille statistique 1	A		Oui		ITMMASTER	WTSICOD0	Famille stat 1	Non
	5	Famille statistique 2	A		Oui		ITMMASTER	WTSICOD1	Famille stat 2	Non
	6	Famille statistique 3	A		Oui		ITMMASTER	WTSICOD2	Famille stat 3	Non
	7	Famille statistique 4	A		Oui		ITMMASTER	WTSICOD3	Famille stat 4	Non
	8	Famille statistique 5	A		Oui		ITMMASTER	WTSICOD4	Famille stat 5	Non
	9	Catégorie	A		Oui		ITMMASTER	TCLCOD	Catégorie	Non
	10	Ligne de produit	A		Oui		ITMMASTER	CFGLIN	Ligne produit	Non
	11	Gestionnaire	A		Oui		ITMMASTER	PLANNER	Planificateur	Non

(1) Le statut AZAP a pour valeur 1 pour les articles de statut actif et 0 dans les autres cas.
(2) Les statuts Article sont définis dans le Menu local 246.

Remarques :

• L'en-tête du fichier est constitué avec les intitulés des colonnes paramétrés sur le pivot. Les intitulés ne doivent pas dépasser 15 caractères.
• En fonction du paramétrage effectué, il est possible, pour chacun des critères, d'avoir le code seul, le libellé seul, ou les deux : code et libellé.
• Les critères 4 à 11 peuvent être exportés ou non, en fonction du paramétrage effectué. Lorsqu'ils ne sont pas exportés, les colonnes ne sont pas présentes dans le fichier.

Sites : sites.csv

Pivot : SCMAFCY

Fichier	N°	Libellé	Type	Lg max	Optionnel	Pivot	Code table	Code champ	Intitulé	Zone non gérée
	1	Code Host Site Client ou Site pour X3	A	15	Non		FACILITY	FCY	Site	Non
	2	Libellé long	A	35	Oui		FACILITY	FCYNAM	Nom	Non
	3	Libellé court	A	10	Oui		FACILITY	FCYSHO	Intitulé court	Non

Remarques :

• L'en-tête du fichier est constitué avec les codes des colonnes paramétrés sur le pivot.
• Les sites au sens AZAP sont des clients ou des dépôts. Tous les clients et tous les sites de stockage sont donc exportés via ce fichier. La différenciation se fera directement dans AZAP.
• Les critères des sites  sont exportés dans un fichier séparé : critstrsite.csv

Sites / Critères : critstrsite.csv

Pivot : SCMACRIFCY

Fichier	N°	Libellé	Type	Lg max	Optionnel	Pivot	Code table	Code champ	Intitulé	Zone non gérée
	1	Code Host Site Client ou Site pour X3	A	15	Non		FACILITY	FCY	Site	Non
	2	Pays	A		Non		BPARTNER	CRY	Pays	Non
	3	Catégorie)	A		Oui		BPCUSTOMER	BCGCOD	Catégorie	Non
	4	Famille statistique 1	A		Oui		BPCUSTOMER	WTSCCOD0	Famille stat 1	Non
	5	Famille statistique 2	A		Oui		BPCUSTOMER	WTSCCOD1	Famille stat 2	Non
	6	Famille statistique 3	A		Oui		BPCUSTOMER	WTSCCOD2	Famille stat 3	Non
	7	Famille statistique 4	A		Oui		BPCUSTOMER	WTSCCOD3	Famille stat 4	Non
	8	Famille statistique 5	A		Oui		BPCUSTOMER	WTSCCOD4	Famille stat 5	Non
	9	Client facturé	A		Oui		BPCUSTOMER	BPCINV	Client facture	Non
	10	Client groupe	A		Oui		BPCUSTOMER	BPCGRU	Client groupe	Non

Remarques :

• L'en-tête du fichier est constitué avec les intitulés des colonnes paramétrés sur le pivot. Ces intitulés ne doivent pas dépasser 15 caractères. 
• Les sites au sens AZAP sont des clients ou des dépôts. Tous les clients et tous les sites de stockage sont donc exportés via ce fichier. La différenciation se fera directement dans AZAP.
• En fonction du paramétrage effectué, il est possible, pour chacun des critères, d'avoir le code seul, le libellé seul, ou les deux : code et libellé.
• Les critères 2 à 10 peuvent être exportés ou non, en fonction du paramétrage effectué. Lorsqu'ils ne sont pas exportés, les colonnes ne sont pas présentes dans le fichier.

Historique de ventes : ventes.csv

Pivot : SCMAHSOH

Fichier	N°	Libellé	Type	Lg max	Optionnel	Pivot	Code table	Code champ	Intitulé	Zone non gérée
	1	Date de livraison demandée ou Date de livraison ou période (1)	D		Non		SORDERQ	DEMDLVDAT	Date liv. demandée	Non
	2	Code Host Site Vente Donneur d'ordre pour X3	A		Non		SORDERQ	BPCORD	Client commande	Non
	3	Code Host Produit	A		Non		SORDERQ	ITMREF	Article	Non
	4	Quantité en UV (2)	N		Non		SORDERQ	QTY	Qté commandée	Non
	5	Code Host Site Origine Site expéditeur pour X3	A		Non		SORDERQ	STOFCY	Site expédition	Non

 
(1) Selon le niveau d'agrégation choisi, c'est la date effective ou de la date de début de période (semaine ou mois) qui est considérée pour le regroupement des données.
(2) La quantité doit être exprimée en UV : unité de vente.

Remarques :

• L'en-tête du fichier est constitué avec les codes des colonnes paramétrés sur le pivot. 
• Si l'historique provient des commandes soldées, l'export porte sur les lignes de commandes soldées dont une quantité a été livrée ou facturée. Le paramétrage autorise la saisie d'une sélection de commandes.
• Si l'historique provient des livraisons/factures, l'export porte sur le réalisé, c'est-à-dire sur les flux réels :
  + les livraisons validées
  + les factures directes validées avec mouvement de stock
  + les factures "commande" validées avec mouvement de stock
  + les lignes de facture "livraison" validées avec mouvement de stock sans numéro de livraison
  - les retours de livraison
  - les avoirs directs validés avec mouvement de stock
  - les avoirs sur facture validés avec mouvement de stock
  Le paramétrage autorise la saisie d'une sélection de livraisons/factures.

En-cours commandes : carnet.csv

Pivot : SCMASOH

Fichier	N°	Libellé	Type	Lg max	Optionnel	Pivot	Code table	Code champ	Intitulé	Zone non gérée
	1	Date de livraison prévue (1) (2)	D		Non		SORDERQ	EXTDLVDAT	Date liv. prévue	Non
	2	Code Host Site Vente Donneur d'ordre pour X3	A		Non		SORDERQ	BPCORD	Client commande	Non
	3	Code Host Produit	A		Non		SORDERQ	ITMREF	Article	Non
	4	Quantité en UV (3) (4)	N		Non		SORDERQ	TDLQTY	Qté à livrer	Non
	5	Code Host Site Origine Site expéditeur pour X3	A		Non		SORDERQ	STOFCY	Site expédition	Non

(1) Pour les commandes ouvertes, il s'agit de la date de livraison demandée : DEMDLVDAT
(2) Selon le niveau d'agrégation choisi, c'est la date effective ou de la date de début de période (semaine ou mois) qui est considérée pour le regroupement des données.
(3) La quantité doit être exprimée en UV : unité de vente.
(4) Une commande (du carnet) non soldée pouvant avoir déjà une quantité livrée (prise en compte dans l'historique), la quantité prise en compte dans le carnet est donc la quantité restant à livrer.

Remarques :

• L'en-tête du fichier est constitué avec les codes des colonnes paramétrés sur le pivot.  
• L'export porte sur les lignes de commandes non soldées.
• Le paramétrage autorise la saisie d'une sélection de commandes.

Descriptif des fichiers importés dans Sage X3

Prévisions de ventes : previsions.csv

Pivot : SCMASOS

Fichier	N°	Libellé	Type	Lg max	Optionnel	Pivot	Code table	Code champ	Intitulé	Zone non gérée
	1	Date prévision(1)	D		Non		ORDERS	ENDDAT	Date fin	Non
	2	Code Host Site Origine Site expéditeur pour X3	A		Non		ORDERS	STOFCY	Site stockage	Non
	3	Code Host Produit	A		Non		ORDERS	ITMREF	Article	Non
	4	Quantité en US (2)	N		Non		ORDERS	EXTQTY	Qté prévue	Non

(1)  Selon le niveau d'agrégation choisi dans AZAP, il s'agira de la date effective ou de la date de fin de période.
(2) La quantité doit être exprimée en US : unité de stock.

Remarques :

• L'import porte sur les prévisions de vente réalisées dans AZAP.
• Le fichier attendu doit avoir un en-tête.  
• Il est possible, par paramétrage, de demander la suppression :
  - soit des anciennes prévisions de chacun des articles du fichier importé, avant d'importer les nouvelles,
  - soit de toutes les prévisions, avant le traitement du fichier.

Messages d'erreur

Il n'y a pas de message d'erreur autre que les messages d'erreur génériques.

Tables mises en oeuvre

Reportez-vous à la documentation de Mise en oeuvre