Généralités
Introduction
Cette documentation vous décrit la version 1.03 de l’interface AGILIX assurant les échanges de données entre ACE (version 1.3) et AGILserver (version 3.76.1000). Le paramétrage de cette interface repose sur l’offre Pack d’ACE.
- prérequis et paramétrage préalable nécessaire,
- extraction des données d’ACE,
- principe des extractions vers AGIL.
|
Pour en savoir plus sur la structure des échanges entre AGIL et ACE, consultez la documentation de référence “ AGILIX : architecture des échanges entre AGIL et ACE ». |
Synthèse des données échangées
| Domaine | Entité ACE | Sens | Entité Agil |
| Tables générales | |||
| · TVA | Hiérarchie produit | -> | Propriété modèle |
| · Magasins | Fiche produit | -> | Modèle et article |
| · Modes de paiement | Complément produit | -> | Propriété modèle |
| · Unités | Unité | -> | Unité |
| · Civilités | Civilité client | -> | Civilité |
| Référentiel produit | |||
| · Hiérarchie produit 10 niveaux | Hiérarchie produit | -> | Propriété modèle |
| · Produits (modèle et déclinaison) | Fiche produit | -> | Modèle et article |
| · Données complémentaires produit | Complément produit | -> | Propriété modèle |
| · GENCOD | GENCOD | -> | GENCOD |
| · Assortiment | Assortiment | -> | Gamme |
| Tarifs | |||
| · Prix de vente de référence | Prix de vente standard en centrale | -> | PVREF |
| · Prix de vente spécial centrale | Prix de vente standard en magasin | -> | PVSC |
| · Prix de vente spécial promotionnel | Prix de vente promo en magasin | -> | PVSP |
| Stocks | Stock magasin et mouvements | -> | Stock magasin |
| Clients | |||
| · Fiche client | Fiche client – données institutionnelles et données dynamiques | <- -> | Le système maître de la fiche client est paramétrable |
| · Compte client | Encours client et blocage client | A définir. | Compte client |
| Opérations commerciales | Pas d’échange de données. | ||
| Fidélisation client | Pas d’échange de données. | ||
L’utilisation de cette interface est réalisée dans le contexte où ACE est utilisé en tant que back office magasin ce qui signifie que ACE est maître des données du référencement Produit et Tarif.
ACE est maître des stocks avec mise à jour depuis les ventes réalisées en caisse. Une image du stock initial ainsi que les mouvements de stocks constatés sont émis depuis ACE vers AGIL pour mise à jour du stock connu dans AGIL (permet d’avoir une information relativement à jour des stocks lors d’un fonctionnement en stand-alone des caisses).
Les opérations commerciales orientées B2C sont gérées exclusivement dans AGIL.
L’option fidélisation et la gestion client comptoir associée est également gérée exclusivement dans AGIL dans ce contexte.
Concernant les clients, un choix de paramétrage est à faire lors de l’implantation d’Agilix pour déterminer le système maître des clients AGIL ou ACE.
Paramétrage et prérequis
Codification de certains éléments
Codification des produits
Un produit non multivariante est déclaré en tant que modèle et en tant que produit ce qui induit que la codification des produits dans ACE ne doit pas dépasser 15 caractères qui est la limite actuelle d’AGIL.
Codification des magasins
Dans le but d’harmoniser la codification des magasins entre ACE et AGIL, cette dernière est réalisée dans AGIL suivant l’identifiant entité de connexion du magasin dans ACE (quatre caractères numériques).
L’interface de mise à jour des magasins d’ACE vers AGIL assure la cohérence de cette codification.
Dans le cas particulier d’une enseigne utilisatrice d’Agil qui devient utilisatrice d’ACE, une étude préalable doit être menée pour faire le lien entre les deux codifications adoptées (utilisation éventuelle d’une table de correspondance).
Codification des civilités, des pays et des langues
La codification de ces rubriques dans ACE impose d’être limitée à deux caractères pour harmonisation sur les contraintes AGIL.
Harmonisation des codifications
Paramétrage général
Le paramètre GC2AG permet de piloter les tables utilisées lors du traitement d’extraction des données d’ACE vers AGIL.
Tables utilisateurs
- Transcodification des pays
Cette table définie la liste des codes pays utilisés dans l’interface AGILIX ainsi que la correspondance de la position fiscale du pays utilisée pour identifier la TVA appliquée dans le pays du magasin (voir documentation du paramètreGC2AG).
Champ Signification Codtbl Code table identifiant les codes pays (gc2ag.para1) Cletbl Code pays tel que défini dans AGIL Lib Libellé du pays Lir Position fiscale à utiliser pour le pays du magasin - Liste des propriétés (modèle et article)
Cette table définie la liste et le paramétrage des propriétés modèles et article dans l’interface AGILIX. Les propriétés modèles et article sont soit les éléments de la hiérarchie produit, soit des données complémentaires produits (voir documentation du paramètre GC2AG).
Champs Signification Codtbl Identifiant de la table des propriétés pour AGIL (gc2ag.para1) Cletbl Code table identifiant la propriété pour AGIL Lib Libellé de la propriété Lir - Pour la hiérarchie produit : nom du champ associé (en minuscule)
- Pour une donnée complémentaire produit : identifiant défini dans gtzon
Lib2 MOD pour identifier une propriété modèle
ART Pour identifier une propriété article
Lib3 Type de table associée à la propriété via gtzon (TBL, TIE ou PRO) Num01 Niveau hiérarchique de 1 à 10 associé au niveau hiérarchique Num02 Longueur de l’identifiant de la propriété Num03 Longueur du libellé de la propriété Dec1 Indique si (=1) la propriété est stockée sur ZOD ou (=0) sur PRO - Liste des unités
Cette table définie la liste et le paramétrage des unités dans l’interface AGILIX. Les informations associées à l’unité sont celles qui correspondent à la gestion des unités dans AGIL (voir documentation du paramètre GC2AG).
Champs Signification Codtbl Identifiant de la table des unités pour AGIL (gc2ag.para3) Cletbl Code table identifiant l’unité Lib Libellé de l’unité Lir Gestion du nombre d’unités (O/N) Num2 Gestion du multiple de l’unité (Nombre par lequel l’article doit être vendu) Num3 Vérification du multiple dans AGIL :
- 1 : Demander.la quantité à l’ajout d’un article
- 2 : Vérifier.la quantité avant l’encaissement (quand tous les articles sont saisis)
Num01 Nombre de décimales gérées sur l’unité Dec1 Valeur de l’arrondi appliqué sur l’unité - Date de dernier traitement d’extraction
Cette table définie la date et heure de début et de fin de la dernière extraction à destination d’AGIL. Le flag (lir) de dernière extraction en cours permet d’empêcher la simultanéité des traitements d’extraction (voir documentation du paramètre GC2AG).
Champs Signification Codtbl Identifiant de la table de dernière axtraction pour AGIL (gc2ag.parm1) Cletbl Clé occurrence table date de traitement ‘GC2AG’ Lib Libellé Lir Flag de dernière extraction (1=extraction en cours, ‘ ‘=Extraction terminée) Lib2 Date de début d’extraction (aaaammjjhhmnss) Lib3 Date de fin d’extraction (aaaammjjhhmnss) Lib4 Date de dernière extraction des magasins Lib5 Date de dernière extraction des propriétés - Liste des mouvements de stock
Cette table définie la liste des opérations de stock qui doivent générer un mouvement à destination d’AGIL. NB : Ces opérations doivent être indiquées avec génération de mouvements dans msk (voir documentation du paramètreGC2AG).
Champs Signification Codtbl Identifiant de la table des mouvements de stock pour AGIL (gc2ag.parm2) Cletbl Code opération de stock (osk.codosk) Lib Libellé du mouvement - Nature de tiers et famille de tiers autorisés en extraction
Cette table définie les natures de tiers et famille de tiers extraits par AGILIX. Si cette table est vide aucun tiers ne sera extrait d’ACE vers AGIL. Les tiers extraits sont ceux identifiés par les natures ET les familles décrites dans cette table de paramétrage (voir documentation du paramètre GC2AG).
Champs Signification Codtbl Identifiant de la table des familles et natures de tiers pour AGIL (gc2ag.parn1) Cletbl Code famille (tie.famtie) ou code nature (tie.codett) Lib Libellé de l’élément Lir ETT indique que cletbl vaut une nature de tiers
FAM indique que cletbl vaut une famille de tiers
Extraction d’ACE vers AGIL
Tables générales
Les codes TVA
Dans ACE, il est possible de définir plusieurs taux de tva pour chaque position fiscale identifiée.
Exemple : Si le code TVA est « TVA réduite », le taux de tva peut être de 5,5% en France mais 3,3% en Angleterre. Agil ne gérant pas les positions fiscales, l’identifiant TVA dans Agil est la concaténation du code TVA d’ACE avec la position fiscale associée au pays (cf paramétrage
| TVA | Libellé | Position A | Position B | … |
| 0 | Exonéré | A0 = 0,00 | B0 = 0,00 | |
| 1 | Réduit | A1 = 5,50 | B1 = 3,30 | |
| 2 | Standard | A2 = 19,60 | B2 = 15,00 | |
| 3 | Majoré | A3 = 30,00 | A4 = 15,00 | |
| … |
Cette table est mise à disposition en mode initialisation uniquement, le code TVA M d’ACE est ignoré (gestion de TAV multiples).
Format
@TVA->CINIT
ID TVA (2car)->taux de tva (2,2)
&TVA
Les magasins
L’extraction des magasins a lieu en mode CINIT pour l’initialisation du système par ACE, elle est traitée en mode MAJOUT en fonctionnement journalier par écart.
La date de dernière extraction des magasins (voir Chapitre table utilisateur : date de traitement)) est valorisée suite à ce traitement pour permettre de n’extraire que les magasins modifiés depuis la dernière extraction.
| Libelles Colonnes | Données | Types | Tables source | Données |
| Identifiant du magasin | ID MAGASIN | C4 | TIE | SIGTIE |
| Nom du magasin | NOM MAGASIN | C30 | TIE | NOMTIE |
| Adresse du magasin | ADRESSE 1 | C30 | ADR | LIBADR50 |
| Adresse du magasin | ADRESSE 2 | C30 | ADR | LIBADR50_1 |
| Adresse du magasin | ADRESSE 3 | C30 | ADR | LIBADR50_2 |
| Code postal du magasin | CODE POSTAL | C5 | ADR | CODPOS_10 |
| Ville du magasin | VILLE | C30 | ADR | CENPOS50 |
| Pays du magasin | PAYS | C20 | TBL PAY | LIB1 |
| Numéro de Téléphone du magasin | TELEPHONE | C20 | ADR | TEL |
| Numéro de Fax du magasin | FAX | C20 | ADR | FAX |
| Indique si le magasin est en rechargement | RECHARGE | N1 | ||
| Indique si le magasin peut saisir des prix de vente spéciaux locaux | SAISIE PVSL | N1 | ||
| Indique la langue utilisée par le magasin | IDLANGUE | C2 | ADR | CODLAN |
| Indique le pays du magasin | IDPAYS | C2 | ADR | CODPAY |
| Indique le type du magasin. | ID TYPE MAGASIN | C4 |
Format :
@MAGASINS->CINIT ou MAJOUT
IDMAG->NOMMAG->ADR1->ADR2->ADR3->CP->VILLE->PAYS->TEL->FAX->RECGARGE->SAIPVSL->IDPAYS->IDTYPMAG
&MAGASINS
Les civilités
La liste des civilités est extraites en mode CINIT uniquement et ce depuis la table de contrôle des civilités pilotée par le paramètre CTRCIV positionné sur la cible AGXCLI.
L’identification de la civilité est limitée à 2 caractères dans AGIL ce qui nécessite une codification harmonisée dans ACE sur cette longueur.
Format :
@CIVILITES->CINIT
ID CIV->LIBELLE
&CIVILITES
Les modes de règlement
- En initialisation : l’ensemble du contenu de la table est extrait pour AGIL,
- En mise à jour et suppression : la trace de la mise à jour et envoyée à AGIL.
L’identifiant mode de règlement d’AGIL qui est géré sur 3 caractères est harmonisé sur la codification d’ACE (2 caractères).
NB : Seul le code et le libellé du mode de règlement sont échangés avec AGIL, toute création d’un nouveau mode nécessite sur AGIL un paramétrage complémentaire du comportement souhaité.
Format :
@MODESPAIEMENT
ID MRG->LIBELLE
&MODESPAIEMENT
Les unités de vente
Les unités et leur paramétrage associé sont envoyés uniquement en mode initialisation à AGIL.
Les paramètres complémentaires nécessaires à AGIL sont à compléter directement dans la table paramètre associée (Cf chapitre tables utilisateurs).
L’unité décrite dans AGILIX est l’unité de facturation d’ACE (unité dans laquelle est exprimée le prix de vente, UVC dans la majorité des cas). Il est possible par ce biais de gérer des unités dites « gérées en nombre d’unités » qui permettent en caisse sur AGIL de saisir par exemple : 2 rouleau de 3,5m à 10ETTC le m donnent 70ETTC.
Pour assurer une gestion de stock cohérente entre ACE et AGIL, l’unité de facturation doit être utilisée en tant qu’unité de stockage.
Les données échangées :
| Libelles Colonnes | Données | Types | Tables source | Données |
| Identifiant de l’unité | ID UNITE | C03 | TBL | CLETBL |
| Indique s’il faut saisir un nombre d’unités | GESTION NB UNITE | N01 | TBL | LIR |
| Nombre de décimales après la virgule | NB DECIMAL | N01 | TBL | NUM01 |
| Valeur de l’arrondi | ARRONDI | D4,6 | TBL | DEC1 |
| Nombre par lequel l’article doit être vendu | MULTIPLE | N04 | TBL | NUM02 |
| Mode d’interface pour la vérification des multiples | ITF MULTIPLE | N01 | TBL | NUM03 |
Format :
@UNITES->CINIT
ID UNI->GESTION UNI->NB DEC->ARRONDI->MULITPLE->ITF MULTIPLE
&UNITES
Le référentiel produit
La liste des propriétés modèles et articles
Les propriétés modèles et article concernent les niveaux hiérarchiques des produits sur dix niveaux ainsi que les données complémentaires produits d’ACE.
Cette liste est envoyée en mode initialisation uniquement
La liste des propriétés modèle et article gérées dans AGILIX est paramétrée dans la table de liste des propriétés (cf Chapitre Tables utilisateurs).
Les données échangées :
| Libelles Colonnes | Données | Types | Tables source | Données | |
| Identifiant de la propriété | ID PROP | C3 | TBL | CLETBL | |
| Libellé de la propriété | LIBELLE | C30 | TBL | LIB1 | |
| Longueur de l’ID Propriété | LONGUEUR ID | N2 | TBL | NUM02 | |
| Longueur du libellé | LONGUEUR LIBELLE | N2 | TBL | NUM03 |
Format :
@LISTEPROPRIETESARTICLES ou MODELES
ID PROP->LIBELLE->longueur ID->longueur Libellé
&LISTEPROPRIETESARTICLES
Les propriétés modèles et articles
Les propriétés modèles et articles correspondent à la liste de valeurs associée aux propriétés.
Cette extraction est réalisée en mode initialisation ou ajout. Dans ce cas ce sont les modifications réalisées depuis la dernière extraction des propriétés modèles qui sont extraites (voir Chapitre table utilisateur : date de traitement).
Remarque :
L’unicité de la propriété liée au niveau hiérarchique des produits est gérée par concaténation des codes hiérarchiques associés.
- Dans le rayon 01
- La famille 01
- Les sous familles 01 et 02
- La famille 01
- Rayon 01
- Famille 0101
- Sous famille 010101 et 010102
Les données échangées :
| Libelles Colonnes | Données | Types | Tables source | Données |
| Identifiant de la propriété | ID PROP | C | FAM / TBL / TIE | Concaténation des hiérarchies / CLETBL / SIGTIE |
| Libellé de la propriété | LIBELLE | C | FAM / TBL / TIE | LIBFAM / LIB1 / NOMTIE |
Format :
@PROPRIETESARTICLES ou MODELES->CINIT ou MAJOUT
ID PROP->LIBELLE
&PROPRIETESARTICLES
Les modèles et articles
Pour chaque produit ACE non géré en déclinaison multivariante, un modèle AGIL et un article AGIL sont gérés. Dans le cas du multivariante, le produit de référence est extrait sous forme de modèle et les déclinaisons associées sous forme d’articles.
Cette extraction est réalise soit en mode initialisation soit en mode ajout. Dans ce cas les traces de dernières modifications sont extraites pour AGIL.
L’ensemble des produits d’ACE sont mis à disposition d’Agil au travers de cette interface hormis les produits de nature modèle ‘MDL’ utilisé dans le cycle de création des produits multivariante et de nature fournisseur ‘FOU’
Dans Agil, la seule manière de supprimer les articles est d’utiliser la méthode d’intégration « CINIT » qui consiste à purger la table avant de la réinitialiser avec l’ensemble des produits.
Gestion des unités : L’unité d’expression du produit dans AGIL (porté par le modèle) est celui d’expression de son prix unitaire. Il n’y a pas de gestion du poids variable dans AGILIX et les ventes sont toujours exprimées en unité de facturation. A compter du moment où un modèle est suivi en nombre d’unité, cela signifie que son stock l’est également et cette unité doit donc également représenter l’unité de stockage d’ACE pour assure rune homogénéité des définitions. L’unité du modèle n’est fournie que si il y a gestion du nombre d’unité sur cette dernière.
| Libelles Colonnes | Données | Types | Tables source | Données |
| Identifiant du modèle | ID MODELE | C15 | PRO | codpro |
| libelleé modèle | NOM MODELE | C30 | PRO | nompro |
| code TVA | ID TVA | C02 | PRO | Concaténation position fiscale du ppe POSFIS et du codtva |
| code guelte | ID GUELTE | C02 | ||
| code unité | ID UNITE | C03 | TSC à la vente | Coduni |
| Type de mise à jour des stocks (par défaut QTE) | TYPE MAJ STOCKS | C05 | ‘QTE’ ou ‘NBUNI’ si produit suivi en unité | |
| Type de mise à jour du nombre d’articles affiché | TYPE MAJ NB ART | C05 | 'QTE' | |
| Type de mise à jour des statistiques de vente | TYPE MAJ STAT | C05 | 'QTE' | |
| concaténtaion des propriétés modèles | ID PROP MODELE | Cxx | Liste des propriétés modèles rattachées |
Format :
@MODELES->MAJOUT->CODE PROPRIETE MODELE (n propriétés, 3car)
ID MODELE (15car)->NOM MODELE (30car)->IDTVA (2car)->ID GUELTE (2car)->ID UNITE (3car)->TYPE MAJ STK (5car)->TYPE MAJ NB ARTICLE (5car)->TYPE MAJ STATISTIQUES (5car)->ID PROPRIETE (n propriétés)
&MODELES
| Libelles Colonnes | Données | Types | Tables source | Données |
| Identifiant article | ID ARTICLE | C20 | PRO | Codpro |
| Libellé caisse | LIBELLE COURT | C27 | PRO | Nompro |
| Libellé écran | LIBELLE LONG | C45 | PRO | design1 |
| code traitement | CODE TRAITEMENT | C02 | P si typpro = PST | |
| modèle associé | ID MODELE | C15 | PRO | PROREF ou CODPRO si non variante |
| Article générique | GENERIQUE | N01 | ||
| concaténtaion des propriétés articles | ID PROPRIETE ARTICLE | Cxx | Liste des propriétés article |
Les produits de type prestation (typpro = PST) sont échangés avec le code traitement P dans AGIL.
Format :
@ARTICLES->MAJOUT->CODE PROPRIETE ARTICLE (n propriétés, 3car)
ID ARTICLE (16car)->LIBELLE COURT (27car)->LIBELLE LONG (30car)->CODE TRAITEMENT (1car)->ID MODELE (15car)->GENERIQUE (5car)->ID PROPRIETE (n propriétés)
&ARTICLES
Les GENCOD
Les articles peuvent être affectés à plusieurs gencods ; de même que les gencods peuvent identifier plusieurs articles. Les GENCOD considérés sont le GENCOD principal de la fiche produit et les GENCOD des variantes logistique du plan de palettisation identifié en mode multigencod (code variante MG).
La liste des GENCOD peut être extraite en mode initialisation ou en mode ajout (trace des modifications extraite pour AGIL)
La suppression d’un GENCOD est gérée, elle est tracée et extraite pour AGIL
Les données échangées :
| Libelles Colonnes | Données | Types | Tables source | Données |
| Identifiant article | ID ART | C20 | PRO / PRL | CODPRO |
| Gencod | CODE BARRE | C20 | PRO / PRL | GENCOD / DUN14 |
Format :
@CODE_BARRE->MAJOUT ou CINIT ou @CODE_BARRE_DELETE
ID PART->CODE BARRE
&CODE_BARRE ou @CODE_BARRE_DELETE
Les gammes
La notion de gamme AGIL correspond au référencement ACE. Un seul référencement par magasin est géré dans ACE et donc une seule gamme par magasin (identifié par lui-même) est extraite pour AGIL.
Le désassortiment d’un produit d’une gamme est également géré en cas de suppression du référencement magasin.
La liste des gammes peut être extraite en mode initialisation ou en mode ajout ainsi qu’en mode suppression d’un produit d’une gamme (trace des modifications extraite pour AGIL)
Les données échangées :
| Libelles Colonnes | Données | Types | Tables source | Données | |
| Identifiant article | ID ART | C15 | PRC | CODPRO |
Format :
@GAMME->Magasin->A->CINIT ou MAJOUT
ID ART
&GAMME
@GAMME_MAGASIN->Magasin
Magasin
&GAMME_MAGASIN
Les tarifs de vente
Les prix de vente de référence
Prix de vente commun à tous les magasins (en TTC) positionné au niveau de la centrale. Les prix de ventes sont extraits en mode initialisation ou en mode ajout (les traces de mise à jour de prix de vente sont extraites pour AGIL)
La valorisation du prix envoyé à AGIL est réalisée par le biais d’un appel prix géré par le mot clé RPRX en mode 8 (prix permanent), la date d’application est celle positionnée sur le tarif.
Les données échangées :
| Libelles Colonnes | Données | Types | Tables source | Données |
| Identifiant de la propriété | ID ART | C20 | TSC | CODPRO |
| Date de début de validité | DATE APPLICATION | DATE | Date d’application (RPRX) | |
| Prix | PVREF | Nombre | Prix permanent (RPRX) |
Format :
@TAR_PVREF->MAJOUT
ID ARTICLE (16car)->DATE APPLICATION->PVREF
&TAR_PVREF
Les prix de vente spécial central
Prix de vente pour un magasin (en TTC). Les prix de ventes sont extraits en mode initialisation ou en mode ajout (les traces de mise à jour de prix de vente sont extraites pour AGIL)
La valorisation du prix envoyé à AGIL est réalisée par le biais d’un appel prix géré par le mot clé RPRX en mode 8 (prix permanent), la date d’application est celle positionnée sur le tarif.
Les données échangées :
| Libelles Colonnes | Données | Types | Tables source | Données |
| Identifiant de la propriété | ID ART | C20 | TSC | CODPRO |
| Date de début de validité | DATE APPLICATION | DATE | Date d’application (RPRX) | |
| Prix | PVSC | Nombre | Prix permanent (RPRX) |
Format :
@TAR_PVSC->IDMAG->MAJOUT
ID ARTICLE (16car)->DATE APPLICATION->PVSC
&TAR_PVSC
Les prix de vente général promo
Le prix de vente promo pour tous les magasins (en TTC) est défini en Centrale.
Les prix promo sont déduits des conditions promos de type de catégorie paramétré dans le paramètre CTSCRE.
Les prix de promo sont extraits en mode initialisation ou en mode ajout (les traces de mise à jour de la condition promo sont extraites pour AGIL)
La valorisation du prix envoyé à AGIL est réalisée par le biais d’un appel prix géré par le mot clé RPRX en mode 4 (prix promo), les dates d’application sont celle positionnées sur le tarif.
NB : ce mode ne permet pas de gérer des périodes promotionnelles se chevauchant (exemple : promo du 01 mai au 31 mai et promo supplémentaire du 15 au 17 mai pour le même produit).
Les données échangées :
| Libelles Colonnes | Données | Types | Tables source | Données |
| Identifiant de la propriété | ID ART | C20 | TSC | CODPRO |
| Date de début de validité | DATE DEBUT APPLICATION | DATE | Date d’application (RPRX) | |
| Date de fin de validité | DATE DEBUT APPLICATION | DATE | Date d’application (RPRX) | |
| Prix | PVGP | Nombre | Prix permanent (RPRX) |
Format :
@TAR_PVGP->DATE MAJ->MAJOUT
ID ARTICLE (16car)->DATE DEBUT APPLICATION->DATE FIN APPLICATION->PVGP
&TAR_PVGP
Les prix de vente spécial promotionnel
Prix de vente promo pour un magasin (en TTC).
Les prix promo sont déduits des conditions promos de type de catégorie paramétré dans le paramètre CTSCRE.
Les prix de promo sont extraits en mode initialisation ou en mode ajout (les traces de mise à jour de la condition promo sont extraites pour AGIL)
La valorisation du prix envoyé à AGIL est réalisée par le biais d’un appel prix géré par le mot clé RPRX en mode 4 (prix promo), les dates d’application sont celle positionnées sur le tarif.
NB : ce mode ne permet pas de gérer des périodes promotionnelles se chevauchant (exemple : promo du 01 mai au 31 mai et promo supplémentaire du 15 au 17 mai pour le même produit).
Les données échangées :
| Libelles Colonnes | Données | Types | Tables source | Données |
| Identifiant de la propriété | ID ART | C20 | TSC | CODPRO |
| Date de début de validité | DATE DEBUT APPLICATION | DATE | Date d’application (RPRX) | |
| Date de fin de validité | DATE DEBUT APPLICATION | DATE | Date d’application (RPRX) | |
| Prix | PVSP | Nombre | Prix permanent (RPRX) |
Format :
@TAR_PVSP->IDMAG->DATE MAJ->MAJOUT
ID ARTICLE (16car)->DATE DEBUT APPLICATION->DATE FIN APPLICATION->PVSP
&TAR_PVSP
Les stocks
Image de stock
ACE est maître des stocks mais informe AGIL du niveau de stock connu.
L’image des stocks peut être extraite à destination d’AGIL, les quantités sont exprimées en unité de stockage des produits (voir paragraphe unités), cette extraction est réalisée depuis l’ensemble des fiches stock. La quantité transmise à AGIL est pilotée par un compteur virtuel défini dans le paramètre GC2AG.
NB : Cette section ne peut être intégrée dans AGIL que lors de la clôture de la caisse.
Les données échangées :
| Libelles Colonnes | Données | Types | Tables source | Données |
| Identifiant article | ID ART | C20 | DSK | CODPRO |
| Quantité en stock | QUANTITE | Numérique | Valorisation compteur virtuel |
Format :
@STOCKS->BRUT->ID MAG-> Date-> Heure
ID article->quantité(7,2)
&STOCKS
Mise à jour des stocks
Lors de chaque mouvement de stock, ce dernier est identifié si doit être envoyé à AGIL ou non depuis la table utilisateur des mouvements de stock (cf Chapitre tables utilisateurs). Une section AVIS permet d’informer le magasin des mouvements de stock. Ils sont répartis en avis de sortie de stock (avis groupe B) et d’entrée en stock (avis groupe A).
NB : Cette section peut être intégrée au fil de l’eau dans AGIL sans clôture particulière
Les données échangées :
| Libelles Colonnes | Données | Types | Tables source | Données |
| Niveau | NIVEAU | C1 | Non renseigné | |
| Identifiant de la propriété | ID ART | C20 | AGILIX | AGX_CODCLE (MSK.CODPRO) |
| Quantité du mouvement | QUANTITE | Numérique | AGILIX | AGX_VALEUR (MSK.QTEMVT) |
Format :
@BRD_AVIS->GROUPE->MAG EMET->MAG DEST->Code Frs->Code client->noref->commentaire->Date prev->heure prev->date cre->heure cre
Niveau->ID article->quantité(7,2)
&BRD_AVIS
Les clients
Détermination du système maître des clients
C’est le couple client/contact d’Agil qui est échangé avec ACE, l’identifiant client d’Agil est réutilisé en tant qu’identifiant client ACE.
Le contact Agil est géré en tant que contact rattaché au client dans ACE (porte l’identifiant contact et le numéro de carte importé d’Agil).
- Dans le cas ou AGIL est maître des clients :
- l’ensemble des fiches clients d’AGIL sont extraites à destination d’ACE
- La tranche de gestion des numéros de clients sur ACE doit être en correspondance avec celle paramétrée sur AGIL
- La numérotation des clients doit obligatoirement être déclarée numérique sur ACE (l’identifiant client AGIL est l’identifiant client ACE). Le paramétrage du format de l’identifiant client est piloté par le paramètre NUMTIE sur la cible AGXCLI.
- Le paramétrage d’extraction des clients d’ACE vers AGIL doit être désactivé (voir guide de mise en œuvre).
- Dans le cas ou ACE est maître des clients :
- Seules les fiches clients d’ACE dont la nature de tiers et la famille de tiers autorisée sont extraites à destination d’AGIL
- Le paramétrage d’extraction des clients de AGIL vers ACE doit être désactivé (voir guide de mise en œuvre).
- La numérotation des clients doit obligatoirement être déclarée numérique sur ACE (l’identifiant client AGIL est l’identifiant client ACE).
- La tranche de gestion des numéros de clients sur ACE doit être en correspondance avec celle paramétrée sur AGIL
- Le contact est numéroté par ACE lors de l’extraction vers AGIL avec le compteur NUMCTC déclaré dans UCPT .
- La tranche de gestion du numéro de contact sur ACE doit être en correspondance avec celle paramétrée sur AGIL
- Le numéro de carte AGIL peut soit être initialisé par AGILIX avec le numéro client ACE soit laissé à blanc pour permettre à AGIL d’assurer la gestion des cartes.
- Les données par défaut de la fiche client d’ACE (pour celles non alimentées par AGIL) sont initialisées lors de la création avec celles définies sur le tiers modèle paramétré sur la cible AGXCLI.
Extraction des clients
Les données institutionnelles et données dynamiques des clients sont extraites à destination d’AGIL.
Seuls les clients ayant un contact déclaré sont extraits à destination d’AGIL.
Les clients ayant un code incident de paiement paramétré dans ACE avec blocage d’événement sont transmis à AGIL au statut bloqué (booléen vrai/faux).
La liste des informations dynamiques échangées entre AGIL et ACE est paramétrée dans la table utilisateur pilotée par le paramètre AG2GC. Les données dynamiques ne peuvent être stockées que dans les données complémentaires datées du client (zod sans gestion de date) et qui sont réutilisables dans la segmentation client d’ACE.
Les clients sont extraits en mode initialisation ou en mode ajout (trace des modifications du client, adresse ou contact à destination d’AGIL).
| Libelles Colonnes | Données | Types | Tables source | Données |
| Numéro identifiant le client (ce numéro permet de regrouper plusieurs contacts sur le même client) | IDENTIFIANT CLIENT | Entier long | TIE | SIGTIE |
| Numéro identifiant le contact | IDENTIFIANT CONTACT | Entier long | CTC | NUMCTC_AGIL |
| Numéro de carte du contact | NUMERO DE CARTE | Caractère, 20 | CTC | CARTE_AGIL |
| Code de la civilité | CODE DE LA CIVILITE | Caractère, 2 | CTC | CODCIV |
| Nom du contact | NOM | Caractère, 30 | CTC | CONTAC |
| Prénom du contact | PRENOM | Caractère, 30 | CTC | PRENOM |
| Adresse1 du client | ADRESSE1 | Caractère, 30 | ADR | LIGADR50_1 |
| Adresse2 du client | ADRESSE2 | Caractère, 30 | ADR | LIGADR50_2 |
| Code postal du client | CODE POSTAL | Caractère, 10 | ADR | CODPOS_10 |
| Ville du client | VILLE | Caractère, 30 | ADR | LOCALI50 |
| Code du pays du client | CODE DU PAYS | Caractère, 2 | ADR | CODPAY |
| Code de l’état du client | CODE DE L’ETAT | Caractère, 2 | ADR | CODSEC |
| Le client n’habite pas à l’adresse indiquée | NPAI | Booléen | ||
| Le client est bloqué | BLOQUE | Booléen | TIE | CODINC (accès table ENB) |
| Numéro de téléphone du contact | NUMERO DE TELEPHONE | Caractère, 20 | CTC | TEL |
| Date de naissance du contact | DATE DE NAISSANCE | Date | CTC | DATNAI |
| E-mail du contact | Caractère, 60 | CTC | EMAIL256 | |
| Permet d’indiquer si le contact est le contact principal | CONTACT PRINCIPAL | Booléen | CTC | INDCONPRI |
| Code de la langue du contact | CODE LANGUE | Caractère, 2 | CTC | CODLAN |
| Code du magasin recruteur du client | CODE MAGASIN RECRUTEUR | Caractère, 4 | ||
| Date de recrutement du client | DATE RECRUTEMENT | Date | ||
| Solde de points du client | SOLDE POINTS | Entier | ||
| Date de dernière mise à jour des points du client | DATE MISE A JOUR POINTS | Date | ||
| Date de fin de validité des points du client | DATE DE FIN DE VALIDITE DES POINTS | Date | ||
| Date de dernière mise à jour de la fiche client | DATE DE MISE A JOUR DU CLIENT | Date | TIE | DATMOD |
| Valeur de l’information dynamique | IDDYNINFO_XXX | ? | ZOD | VALZOD |
| … | ||||
| Valeur de l’information dynamique | IDDYNINFO_YYY | ? | ZOD | VALZOD |
Format :
@CUSTOMER->Code info dynamique 1-> Code info dynamique 2-> …
Identifiant client->Identifiant contact-> numéro de carte->code de la civilité-> Nom->Prénom-> adresse1-> adresse2-> Code postal-> Ville-> Pays-> Etat (secteur géographique)-> NPAI (NS)->Client bloqué->No de téléphone-> Date de naissance-> E-mail-> Contact principal-> Code langue-> Magasin recruteur (NS)->Date de recrutement(NS)->Solde points (NS)-> Date de mise à jour des points (NS) ->Date de fin de validité des points (NS) ->Date de mise à jour client -> Info dynamique 1-> Info dynamique 2…
&CUSTOMER
Principe des extractions d’ACE vers AGIL
Pilotage de l’extraction
Les données sont transmises à AGIL sous forme d’un fichier contenant les sections d’échanges traduisibles par AGIL. Le fichier utilisé est unique pour un échange donné. Il est nommé de cette manière « gce2agilaaaammjjhhmnss.ech ».
Une table utilisateur (définie par l’option M1 du paramètre GC2AG) permet d’identifier la date de début et de fin de l’extraction et si une extraction est en cours ou non.
Cette gestion peut être faite dans une procédure réunissant les différents éléments d’extraction d’ACE vers AGIL.
Ce fichier est « ouvert » par le premier élément de procédure dit de début d’extraction qui ne peut se déclencher que si aucune extraction n’est en cours (sinon abort en statut 5).
Le fichier est ensuite enrichi par les extractions des données d’ACE.
La fermeture du fichier d’échange est réalisée par le dernier élément de procédure qui consigne l’heure de fin, précise qu’il n’y a plus d’extraction en cours et génère un fichier témoin (gce2agilaaaammjjhhmmss.go) à destination de TradeXpress ACE pour transmission à AGILserver.
Procédure d’initialisation
Une première procédure permet de réaliser une extraction d’initialisation des données d’ACE à destination d’AGIL. Elle extrait l’ensemble des données concernées sans limitation de dates (hormis pour les tarifs ou les tarifs échus sont extraits).
Procédure AGILIX_DOWN_INI
| INIT | CODFCT | CODPLED | TITEDT |
| 1 | AGILIXE2 | EXTDEB | AGILIX : contrôle début extraction |
| 2 | AGILIXE2 | INITBL | AGILIX : extraction des TBL |
| 3 | AGILIXE2 | INITVA | AGILIX : extraction des TVA |
| 4 | AGILIXE2 | INIMAG | AGILIX : initialisation des magasins |
| 5 | AGILIXE2 | INILPP | AGILIX : extraction liste propriété pro |
| 6 | AGILIXE2 | INIPRP | AGILIX : initialisatio propriété produit |
| 7 | AGILIXE2 | INIMOD | AGILIX : initialisation des modèles |
| 8 | AGILIXE2 | INIART | AGILIX : initialisation des articles |
| 9 | AGILIXE2 | INIEAN | AGILIX : initialisation des EAN |
| 10 | AGILIXE2 | INIGAM | AGILIX : initialisation des GAMMES |
| 11 | AGILIXE2 | INITAR | AGILIX : initial. des tarifs de vente |
| 11 | AGILIXE2 | INITAR | AGILIX : initial. des tarifs de vente |
| 12 | AGILIXE2 | INISTK | AGILIX : initialisation des stocks |
| 13 | AGILIXE2 | INICLI | AGILIX : initialisation des clients |
| 14 | AGILIXE2 | EXTFIN | AGILIX : contrôle fin extraction |
Procédure de mise à jour
- Les tables TVA, TBL et liste de propriétés sont extraites dans leur intégralité,
- Les tables magasins, et propriétés produits, les données extraites sont celles dont le champs datmod a évolué depuis la dernière extraction réalisé les concernant,
- Pour les autres tables, les mises à jour extraites le sont sur la base des traces de mises à jour (voir chapitre suivant).
Procédure AGILIX_DOWN_MAJ
| MAJ | CODFCT | CODPLED | TITEDT |
| 1 | AGILIXE2 | EXTDEB | AGILIX : contrôle début extraction |
| 2 | AGILIXE2 | INITBL | AGILIX : extraction des TBL |
| 3 | AGILIXE2 | INITVA | AGILIX : extraction des TVA |
| 4 | AGILIXE2 | MAJMAG | AGILIX : mise à jour des magasins |
| 5 | AGILIXE2 | INILPP | AGILIX : extraction liste propriété pro |
| 6 | AGILIXE2 | MAJPRP | AGILIX : mise à jour propriété produit |
| 7 | AGILIXE2 | MAJMOD | AGILIX : mise à jour modèles |
| 8 | AGILIXE2 | MAJART | AGILIX : mise à jour articles |
| 9 | AGILIXE2 | MAJEAN | AGILIX : mise à jour des EAN |
| 10 | AGILIXE2 | MAJGAM | AGILIX : mise à jour des GAMMES |
| 11 | AGILIXE2 | MAJTAR | AGILIX : mise à jour des tarifs de vente |
| 12 | AGILIXE2 | MAJSTK | AGILIX : mise à jour des stocks |
| 13 | AGILIXE2 | MAJCLI | AGILIX : mise à jour des clients |
| 14 | AGILIXE2 | EXTFIN | AGILIX : contrôle fin extraction |
Traces de mise à jour
Les données tracées en mise à jour le sont par le biais de déclencheurs positionnés dans la base de données sur les tables concernées (Produit, Gencod, Mouvements de stocks, assortiment , tarifs permanent et promotionnel).
Le déclencheur alimente la table trace : agilix
| Rubrique | Désignation |
| NUMIDX | Numéro de séquence |
| CODSOC | Société de l'entité AGILIX |
| CODENT | Code entité (TSC, CTS, MSK, PRC, PRL) |
| SEGMENT | Sous ensemble dépendant de l'entité |
| ORAACT | UDP, INS, DEL |
| SOC | Société de l'élément tracé |
| AGX_CODCLE | Clé primaire de l'élément tracé |
| AGX_VALEUR | Valeur complémentaire suivant le cas |
| UTIMOD | Utilisateur |
| DATMOD | Date de dernière modification |
| AGX_HEUMOD | Heure de modification |
Cette table de trace est utilisée comme guide d’extraction des données à destination d’AGIL en mode mise à jour. Les occurrences extraites sont purgées au fur et à mesure de leur traitement lors de l’extraction
