API Gestion Elaboration créer Elaboration Ligne

 

Version : 5.0-00

Edition spéciale ES1

Package : fr.ACE.metier.bc4j.tarif.common

GestionElaborationcreerElaborationLigne

Schémas d’entrée et de sortie : IN OUT

Cette API permet de créer une ligne d’élaboration à partir d’un en-tête d’élaboration et d’un produit sélectionné. Chaque information de la ligne provient de l’en-tête de l’élaboration ou est calculée à partir des éléments connus. Les règles de gestion sont différentes selon le type de tarif : permanent achat, promotion achat, permanent vente, promotion vente ou tarif de cession (voir documentation « Prix de cession »).

Lors de l’ajout d’un produit de référence dans une élaboration, l’API ajoute automatiquement les variantes associées qui ont leur propre tarif. Dans un contexte magasin, seules sont retenues les variantes qui sont dans l’assortiment du magasin.

Il vous est possible de détacher ou non la variante produit de son produit de référence en création de ligne d’élaboration.

API imbriquées : aucune.

Contraintes et limites de fonctionnement (hors périmètre)

Cette API est indispensable pour pouvoir faire de la création multiple.

Paramétrage (PPE)

ELA_02POLINCDEVNATCTSCRETARPVGMULVA1TARREV -

Processus, contrôles et règles de gestion

Etape Description du Processus
Initialisation

La ligne est créée par défaut avec les informations de l’en-tête :

  • type élaboration,
  • sigle fournisseur,
  • code achat/vente,
  • numéro d’élaboration,
  • code état,
  • prix d’achat fixe,
  • taux d’évolution fixe achat (peut être négatif),
  • prix de vente fixe,
  • taux d’évolution fixe vente (peut être négatif),
  • incidence sur PV,
  • date de début : si non renseignée alors alimentée avec la date du jour,
  • date de fin,
  • type de promotion vente (catégorie),
  • indicateur « remise sur »,
  • indicateur ‘tarif de référence’.

Un numéro d’ordre est affecté à la nouvelle ligne. On prend le dernier numéro d’ordre de l’élaboration auquel on ajoute 1. Pour la première création de ligne, on commence à 1.

Le logiciel mémorise sur la ligne l’entité à l’origine de la création (tal.codsoc_phy).

Contrôles

La création est refusée si :

  • le produit n’existe pas,
  • à l’achat, si le produit n’existe pas chez le fournisseur (lien PRC ).

La devise

(tal.coddev)

Sur une élaboration de type achat, on gère sur la ligne à la fois un tarif achat et un tarif vente. On mémorise donc la devise du fournisseur dans la champ tal.coddev. La devise à la vente est toujours la devise nationale (paramètre DEVNAT).

Sur une élaboration de type vente, on ne gère qu’un tarif vente. On mémorise donc la devise nationale dans le champ « tal.coddev ».

Les unités L’unité de vente du produit et l’unité d’achat du produit chez le fournisseur sont mémorisées dans des zones paramétrées de la ligne (paramètre ELA_02).

La catégorie

(tal.codcre)

La règle de gestion dépend du type de tarif.

  • Permanent achat : alimentée avec le A2 du paramètre ELA_02 pour la condition tarifaire qui sera associée au taux de remise achat si pas d’accord fournisseur,
  • Promotion achat : alimentée avec le A1 du paramètre CTSCRE pour la condition tarifaire qui sera associée à la promotion achat en prix net.
  • Promotion vente : alimentée avec celle de l’entête. Définit le type de promotion : prix net ou pourcentage (cf. paramètre CTSCRE – A1 ou A2).
Tarif de référence

Provient de l’en-tête.

Alimenté par les règles de gestion du paramètre ELA_02.

Accord fournisseur

(tal.numcnt)

Il s’agit de l’accord fournisseur applicable et le plus favorable à la date de l’élaboration (date de début). L’accord n’est pas modifiable. Il faut donc procéder à la saisie des nouveaux accords fournisseurs avant de créer le tarif prévisionnel et on souhaite le voir apparaître ici.

Uniquement sur le tarif permanent achat (tal.numcnt).

Taux de remise achat

(tal.tauach)

Alimenté avec le taux de remise moyen entre le prix achat tarif HT et le prix d’achat net HT.

Incidence PV

(tal.polinc)

Les règles de gestion d’affectation sur les lignes de l’élaboration sont les suivantes :

q en création de tarif, si l’incidence sur PV non saisie sur l’en-tête,

On récupère

celle du produit,

à défaut, on récupère celle du fournisseur

à défaut celle du magasin.

q si elle est saisie sur l'entête du tarif en création,

On récupère l'incidence sur PV de l’entête sur tous les produits.

Paramètre POLINC.

Nouveau tarif achat HT

(tal.prxach1)

Uniquement sur le permanent achat et promotion achat.

Pour le permanent achat, le nouveau tarif achat est :

  • alimenté avec le prix achat fixe de l’entête s’il est saisi,
  • ou calculé à partir du taux d’évolution achat de l’entête appliqué sur le tarif achat permanent actuel, si le taux est saisi,
  • ou à défaut, égal au tarif achat permanent actuel.

Pour la promotion achat, le nouveau tarif achat (tal.prxach1) est :

  • alimenté avec le prix achat fixe de l’entête s’il est saisi,
  • ou calculé à partir du taux d’évolution achat de l’entête si le taux est saisi. Le taux est appliqué soit sur le prix tarif permanent actuel ou sur le prix tarif permanent net actuel selon l’indicateur de ‘Remise sur’.
  • ou à défaut, égal au tarif achat permanent actuel.

Nouveau tarif vente TTC

(tal.prxstd1)

Pour le permanent achat et promotion achat, il est calculé en fonction de l’incidence sur PV.

Incidence sur PV Nouveau PV Permanent Nouvelle marge
Maintien de marge Prix de vente calculé à partir de la nouvelle marge Marge actuelle
Maintien PV Prix de vente actuel Calculé à partir du prix de vente
PV Conseillé Prix de vente conseillé Calculé à partir du PVC
Marge conseillé Calculé à partir de la marge conseillé Marge conseillé par la centrale
Non renseigné Aucune incidence Aucune incidence

Pour le permanent vente, le nouveau tarif vente est :

  • alimenté avec le prix vente fixe de l’en-tête s’il est saisi,
  • ou calculé à partir du taux d’évolution vente de l’en-tête appliqué sur le tarif vente permanent actuel, si le taux est saisi,
  • ou à défaut, égal au tarif vente permanent actuel.

Pour la promotion vente, le nouveau tarif vente est :

  • alimenté avec le prix vente fixe de l’en-tête s’il est saisi,
  • ou calculé à partir du taux d’évolution vente de l’en-tête appliqué sur le tarif vente permanent actuel, si le taux est saisi.

Nouvelle marge

(tal.marge1)

Elle est alimentée sur un permanent achat et sur un promotion achat dans le but d’être transmis au magasin lors de la mise à disposition et de servir de marge conseillée par la centrale.

Sur un permanent achat, la marge est calculée entre le nouveau prix achat net permanent et le nouveau prix de vente permanent.

Sur un promotion achat, la marge est calculée entre la nouvelle promotion achat et la nouvelle promotion vente.

Marge = (PV HT – PA HT) * 100 / PV HT.

Tarif de cessionde cession

Si le code achat/vente = « A », un algorithme permet de propager les champs politique d’incidence PV, taux d’évolution PV et PV fixe de l’entête de l’élaboration sur la ligne en cours de création.

Ce traitement est également réalisé dans le cas d’un type achat/vente = « G » : propagation des infos incidence PVG , taux PVG et PVG fixe ainsi que l’incidence PR, taux PR et PR fixe.

Les prix, les marges de la ligne d’élaboration de type grossiste et l’unité du prix de cession sont automatiquement initialisés.

Modification du prix de cession :

· Recherche du contrat fournisseur applicable à la date de l’élaboration,

· Application des condition tarifaires pour obtenir le prix remisé,

· Pour un tarif de cession, la référence du PA est mémorisée lorsque ce tarif de cession devient le tarif origine du PVG calculé (voir paramètre TARPVG, N1=1).

Les modifications du taux ou prix de revient fixé en en-tête d’élaboration sont répercutées sur les lignes.

La politique d’incidence de revient saisie en en-tête d’élaboration est également prise en compte :

· maintien du coefficient de revient,

· maintien du prix de revient ou incidence non renseignée,

· taux et prix de revient non renseignés,

· prix de revient supérieur au prix d’achat net (Si ce n’est pas le cas, le prix de revient est forcé avec le prix d’achat).

· La référence du PR est mémorisée si le PR correspond au tarif origine du PVG (TARPVG N1=2).

Les modifications du taux ou prix de cession fixé en en-tête d’élaboration sont répercutées sur les lignes.

Contrôle de marge en centrale (code entité de l’élaboration (codsoc) = code entité propriétaire (codsoc_phy))

1 – le prix de référence est le PVG au lieu du PA pour le contrôle de la marge magasin minimale.

2 –le contrôle de la marge grossiste minimale est aussi effectué.

Définition de la marge minimale :

· La marge minimale (champ « pro.margemini » représente la marge conseillée par la centrale à appliquer en magasin.

· La marge minimale « Prc.Margemini » correspond à une marge grossiste pour les entrepôts et une marge magasin pour les magasins. Le magasin est un tiers de type « DEP » et de nature « PDV » alors que l’entrepôt est un tiers de type « DEP » et de nature « DEP ».

Les prix d’achat, de revient, de cession calculés et les marges calculées sont arrondis à deux décimales. Le prix de vente est arrondi en fonction de la règle d’arrondi, utiliser la méthode arrondirPrix.

Produits à variantes

Disponible en ACE 1.3.

Lors de l’ajout d’un produit de référence (voir zone N3 du paramètre MULVA1) dans une élaboration, cette API ajoute automatiquement les variantes associées qui ont leur propre tarif. Pour une connexion magasin, seules sont retenues les variantes qui sont dans l’assortiment du magasin.

Si on ajoute PR (Produit de référence) dans une élaboration, on crée des lignes d’élaboration seulement pour les variantes détachées tarifairement du PR. Si ensuite on essaie d’ajouter une de ces variantes, on a un message bloquant qui dit que la ligne d’élaboration existe déjà.

Si PR (Produit de référence) n’est pas dans l’élaboration et on ajoute une de ces variantes détachée tarifairement, on crée une ligne d’élaboration sans renseigner le champ tal.proref.

Si PR (Produit de référence) n’est pas dans l’élaboration et on ajoute une de ces variantes non détachée tarifairement avec modeDetachement=NULL ou false, alors on interdit la création par le message VAT_REFNPE.

Si PR (Produit de référence) n’est pas dans l’élaboration et on ajoute une de ces variantes non détachée tarifairement avec modeDetachement=true :

si MULVA1.N3 = 1

On interdit la création par le message VAR_DT_INT

Sinon

On détache la variante et on crée une ligne d’élaboration sans renseigner le champ tal.proref

Si on ajoute le PR dans une élaboration où on a déjà des lignes d’élaboration pour certaines des variantes du PR, on fait renseigner le champs tal.proref avec les code produit du PR.

Cas d’erreurs

Cause Effet
TAL_EX : la ligne d’élaboration que l’on essaie de créer existe déjà.  
TIE_INEX : à l’achat, le fournisseur n’existe pas.  
CHP_OBLIG : fournisseur obligatoire à l’achat.  
CHP_OBLIG : la date de fin est obligatoire pour les promotions.  
PROPASPRC : à l’achat, le produit n’existe pas dans le catalogue fournisseur.  
CMPDAT : la date de fin doit être supérieure ou égale à la date de début.  
I_CODDEVIN : la devise est inexistante.  
PRO_INEX : le produit n’existe pas.  
POLINC_INEX : la politique d’incidence sur PV n’existe pas.  
CRE_INEX : la catégorie n’existe pas.  
ERR_INDREM : l’indicateur ‘Remise sur’ n’existe pas.