Modèle d'import/export > Module Ventes > Modèle d'import/export SDH (Livraisons) 

Utilisez cette fonction pour importer des bons de livraison. Cet import ne fonctionne qu’en mode création. Les imports de livraison en mode modification et suppression ne sont pas gérés.

Lorsque l’import porte sur un grand nombre d’enregistrements, la durée du traitement peut s’avérer non négligeable.
Cette durée peut être réduite grâce à la mise en place d'une solution consistant à décliner les enregistrements multi-législations, pour chacune des législations du dossier.

Exemple : les législations FRA, POR et USA sont utilisées dans un dossier. Si les législations FRA et POR ont le même paramétrage, il est préconisé de créer un enregistrement pour la législation FRA et un enregistrement pour la législation POR, au lieu d’avoir un seul enregistrement pour toutes les législations.
Pour afficher plus d'informations sur le principe d'amélioration des performances lié à la multi-législation et connaître la liste des objets que vous pouvez décliner par législation, reportez-vous au document :
 Amélioration des performances : Liste des objets multi-législations

Les bons de livraison importés sont de type direct ou liés à des commandes ou des demandes de livraison. Ils peuvent être importés dans l’état Non validé,Validéou Facturé.

Import d'un bon de livraison dans l’état Non validé(champ CFMFLGnon présent dans le modèle ou présent mais a pour valeur Non validé).

Les lignes le composant sont toutes allouées en détaillé ou contiennent des ruptures si la gestion de l’article le permet (stock négatif autorisé). La manière dont les lignes sont allouées dépend des informations contenues dans le modèle d’import. En effet, si le modèle ne contient que les tables des bons de livraison, l’allocation détaillée sera effectuée automatiquement par le système en respectant les règles d’allocation et de sortie liées à la catégorie de l’article. Si une rupture est constatée et autorisée pour l’article, celle-ci ne précisera pas les caractéristiques du stock en rupture.

Dans ce contexte on peut influer sur l’allocation en important les champs suivants de la table des lignes de livraison :

LOT

Ce champ permet de filtrer de manière exclusive un lot particulier ou un groupe de lot (utilisation des jokers ? et *) si l’article est géré par lot.

STA

Ce champ permet de filtrer de manière exclusive un statut particulier ou un groupe de statuts (utilisation des jokers ? et *).

LOC

Ce champ permet de considérer de manière prioritaire un emplacement ou un groupe d’emplacements (utilisation des jokers ? et *). Si aucun stock n’est trouvé dans ces emplacements, le système appliquera normalement la règle d’allocation.

Si le modèle d’import contient une hiérarchie supplémentaire s’appuyant sur des éléments de la table STOJOU, alors le système suivra exactement les informations précisées pour procéder à l’allocation détaillée. En cas d’incohérence entre la demande d’allocation inscrite dans le fichier d’import et les stocks, le système rejettera le bon de livraison à importer. A ce niveau de hiérarchie, certaines informations sont obligatoires :

La quantité

Elle peut être exprimée sous deux formes. La quantité en unité de stock (champ QTYSTU) ou la quantité en unité de conditionnement (champ QTYPCU). Si la quantité est exprimée en unité de conditionnement il faudra impérativement renseigner l’unité de conditionnement (champ PCU). Dans tous les cas, la somme des quantités des lignes d’allocation importées devra être égale à la quantité livrée sur la ligne de livraison.

Les caractéristiques de stock

En fonction de la typologie des articles importés, le modèle devra contenir au minimum l’ensemble de toutes les caractéristiques des articles importés (lot, sous-lot, numéro de série, emplacement). Par exemple si un des articles importé est géré par lot, il faudra que le modèle contienne le champ LOT.

Le statut

Il n'est pas obligatoire. Par contre s’il figure dans le modèle, il sera strictement exploité. S’il n’est pas dans le modèle, le système exploitera la règle de sortie de l’article pour en choisir un.

Si l’article autorise les stocks négatifs et si la quantité à sortir est indisponible, une rupture sera générée sur les caractéristiques du stock précisées dans le fichier d’import.

Import de lignes de livraison liées à des lignes de commandes ou à des demandes de livraisons

Il faudra ajouter dans le modèle d’import les champs suivants :

  • Pour des lignes de commandes, les champs de SOHNUM et SOPLIN du fichier des lignes de livraison devront être présents dans le modèle d’import.
  • Pour des demandes de livraison, les champs SOHNUM, SOPLIN et SOQSEQ du fichier des lignes de livraison devront être présents dans le modèle d’import.
Import de livraison non liée à une commande 
  • Le type de livraison est mis à jour à partir du type de livraison indiqué dans le fichier.
    Lorsque la catégorie est également indiquée dans le fichier, l'import est rejeté si la catégorie n'est pas cohérente avec le type de livraison indiqué.
  • Si le type de livraison n'est pas indiqué dans le fichier d'import mais que la catégorie est précisée, le type de livraison est alimenté à partir du type de livraison précisé par le paramètre correspondant à la catégorie :
  • Si aucun type de livraison ni aucune catégorie ne sont indiqués dans le fichier d'import, ces champs sont alimentés de la façon suivante :
      • Catégorie : 'Normale'
      • Type de livraison : il s'agit du premier (dans la liste) type de livraison qui respecte les contraintes de catégorie, site et législation qui est pris en compte.
Import de livraison liée à une commande

La commande est automatiquement mise à jour.
L’import d’une livraison de commande est impossible lorsque le client est bloqué même si la commande, elle, n’est pas bloquée (contrairement à la livraison interactive de commande où le non blocage d’une commande est suffisant pour autoriser la livraison).

Import de livraison liée à une ou plusieurs commandes

L’allocation détaillée s’effectuera de la manière suivante, si la ligne de commande d’origine est elle-même allouée en détaillée (si la commande est allouée en globale ou non allouée, l’allocation s’effectuera comme en import de livraison directe) :

  • Si le modèle d’import de la livraison ne dispose d’aucune information relative à l'identification du stock, alors l’allocation détaillée de la ligne de commande sera redescendue sur la ligne de livraison (comme en interactif).
  • Si le modèle d’import dispose d’informations de filtre exclusif ou prioritaire de la ligne de livraison, celles-ci ne seront pas exploités dans ce contexte. L’allocation détaillée de la ligne de commande sera redescendue sur la ligne de livraison.
  • Si le modèle d’import dispose du détail de l’allocation à effectuer (table STOJOU) alors l’allocation considérée sur la livraison sera l’allocation décrite dans le fichier d’import. Les allocations présentes sur la commande seront dés-allouées.
Import de livraison de prêt

Le modèle doit impérativement comporter le champ LNDRTNDAT (date retour prêt) afin que ce champ soit calculé. S'il n'est pas présent dans le modèle d'import, il ne sera pas automatiquement calculé et la livraison ne sera donc pas créée.

Import d'un bon de livraison dans l’état Validé (le champCFMFLG est présent sur le modèle et a pour valeur 'Validé')

Les lignes qui composent le bon de livraison provoquent un mouvement de stock ou un mouvement en attente si le stock est indisponible et si le stock négatif est autorisé pour l’article. Ces bons de livraison pourront être facturés par la suite. Comme pour l’import de bons de livraison non validés, les mouvements de stock seront générés à partir des règles d’allocation et de sorties si le modèle d’import ne contient pas le fichier des mouvements de stock. Vous pourrez, malgré tout dans ce contexte, utiliser les filtres exclusifs et les filtres préférentiels du fichier des lignes de livraison pour orienter le choix du détail stock (même fonctionnement que pour l’allocation). Si le modèle d’import contient le détail du stock sorti, alors le système appliquera exactement les informations du fichier d’import pour effectuer les mouvements de stock. Les contraintes sont les mêmes que celles décrites pour l’allocation détaillée en import de bons de livraison non validés.

Vous pouvez également importer des bons de livraison validés liés à des lignes de commandes ou à des demandes de livraisons en précisant le lien dans le modèle d’import. Si les lignes de commandes sont allouées en détaillé, le fonctionnement concernant la reprise des allocations pour générer des mouvements de sortie est le même que lors du transfert des allocations sur une livraison non validée.

Import d'un bon de livraison dans l’état 'Facturé' (le champINVFLG est présent sur le modèle et a pour valeur 'Facturée')

Cet import est considéré comme un import à des fins statistiques. Aucun mouvement de stock n'est effectué. Pour ce type d’import, il ne faut pas préciser le fichier STOJOU dans le modèle.

Import de livraison contenant des kits commerciaux 

Dans tous les cas, on considère que les informations importées sont réputées exactes puisque le mouvement de sortie est effectué ou est sur le point d'être effectué. Le kit ou la nomenclature ne seront donc pas contrôlés en import. Si la livraison est liée à une commande, celle-ci sera normalement mise à jour.

Import des textes associés aux bons de livraisons

Utilisez les variables GIMP :

  • de 71..78 contiennent le texte d’entête du bon de livraison
  • de 81..88 contiennent le texte de pied du bon de livraison.
  • de 91..98 contiennent le texte de chaque ligne du bon de livraison.

Chaque occurrence contient 99 caractères.

Import des axes analytiques à la ligne

Il n’est pas possible de forcer un axe analytique à vide. Par conséquent, si des champs de sections analytiques sont paramétrés dans le modèle mais que ces champs sont renseignés à vide dans le fichier d’import, ces champs seront tout de même initialisés avec les codes sections par défaut liés au document.
Pour importer les sections analytiques d'une ligne de document, un niveau supplémentaire doit être ajouté pour renseigner la table commune contenant les informations analytiques à la ligne (CPTANALIN).
SEEREFERTTO Voir le modèle d'import SDHFL.

Import des éléments de facturation

La valeur saisie des éléments de facturation peut être importée dans les différents documents au travers des champs INVDTAAMT. (SQH, SOH, SDH).

SEEINFO Le modèle d'import des livraisons ne prend pas en compte les bons de préparation, même si les numéros de bons de préparation sont inclus dans le modèle.

Import du code affaire et impact sur les prix et remises
  • Gestion du code affaire :

    Il est nécessaire de distinguer la gestion mono-affaire de la gestion multi-affaires des documents. Ce mode de gestion est déterminé par le paramètre PJTNSGDOC - Une affaire par document (chapitre TC, groupe PRP).
     
    1/ Gestion mono-affaire des documents :
     

     Modèle d'import avec
    le code affaire ... 

     Gestion du code affaire
    sur la livraison

     ... en en-tête

     ... sur la ligne

     OUI

    NON

    En-tête = Valeur du fichier import en-tête 
    Ligne = Valeur de l'en-tête

     OUI

    OUI

    En-tête = Valeur du fichier import en-tête
    Ligne = Valeur du fichier import ligne, 
    ou valeur de l'en-tête si la valeur de la ligne est différente de l'en-tête

     NON

    OUI

    En-tête = Valeur vide
    Ligne = Valeur vide (+ message informatif si tentative
    d'import d'un code affaire non vide)


     
    2/ Gestion multi-affaires des documents:
     

     Modèle d'import avec
    le code affaire ... 

     Gestion du code affaire
    sur la livraison

     ... en en-tête

     ... sur la ligne

     OUI

    NON

     En-tête = Valeur du fichier import en-tête
    Ligne = Valeur de l'en-tête

     OUI

     OUI

     En-tête = Valeur du fichier import en-tête
    Ligne = Valeur du fichier import ligne

     NON

    OUI

     En-tête = Valeur vide
    Ligne = Valeur du fichier import ligne


     
  • Impact sur les prix et remises :
     
    Aucun re-calcul des prix et remises n'est effectué lors de l'import. Toutefois, le comportement diffère suivant que le prix est renseigné ou non dans le fichier d'import :
     
    1/ Si le prix n'est pas renseigné dans le fichier, alors les prix et remises sont issus de la recherche tarifaire basée sur le code affaire du devis.
     
    2/ Le prix est renseigné dans le fichier d'import, alors le prix correspond à celui renseigné dans le fichier d'import.
Import des livraisons retournées (sur lesquelles des retours ont été effectués)

Les livraisons sont importées mais l’état de retour de ces livraisons a pour valeur ‘Non retournée’. Les quantités retournées ne sont pas non plus prises en compte pour l’import.

Pré-requis

Pour que l'import fonctionne correctement, les données utilisées dans l'import relatives aux tables suivantes doivent préalablement exister :

  • Table des sites
  • Table des articles
  • Table des articles/site
  • Table des clients
  • Table des clients livrés

Champs obligatoires du modèle

Dans cet import, les champs obligatoires sont les suivants :

Table SDELIVERY

  • Client commande (BPCORD)

Attention, si le site de stockage et le site de vente ne sont pas présent dans le modèle d’import, les sites seront déterminés par le site de stockage et le site de vente par défaut de la session exécutant l’import.

Table SDELIVERYD

  • Référence article (ITMREF)
  • Quantité en unité de vente (QTY)

Si l’unité de vente n’est pas précisée, l’unité déterminée sera dans l’ordre celle du client puis celle de l’article.

Table STOJOU

Si cette table fait partie de la hiérarchie, les champs suivant sont obligatoires :

  • Quantité en unité de stock (QTYSTU)

Ou

  • Quantité en unité de conditionnement (QTYPCU)
  • Unité de conditionnement (PCU)

Les champs suivants sont obligatoires en fonction des caractéristiques des articles :

  • Lot (LOT)
  • Sous-lot (SLO)
  • Numéro de série (SERNUM)
  • Emplacement (LOC)

Messages d'erreur

Outre les messages génériques, les messages d'erreur suivants peuvent apparaître lors de la saisie :

Ligne n° X, Article Y : le stock à sortir n'a pas été déterminé. Quantité ligne de document N1 Quantité traitée N2

Ce message d'erreur peut apparaître lorsque l'on importe le détail stock sur une livraison (Fichier STOJOU) et lorsque ce fichier est incomplet du point de vue des caractérisitiques de stock devant être mentionnées ou des quantités importées en regard de la quantité livrée de la ligne.

Tables mises en oeuvre

Ce modèle est utilisable à la fois en import et en export. Les données sont mises à jour dans les tables suivantes :

Table

Intitulé Table

BPARTNER [BPR]

Business Partner

BPCUSTMVT [MVC]

Mouvements clients

BPCUSTOMER [BPC]

Clients

BPDLVCUST [BPD]

Clients livrés

BPSUPPLIER [BPS]

Fournisseurs

CPTANALIN [CAL]

Lignes comptables analytiques

FACILITY [FCY]

Sites

ITMBPC [ITU]

Articles - Clients

ITMCATEG [ITG]

Catégorie article

ITMFACILIT [ITF]

Articles - Sites

ITMMASTER [ITM]

Articles

ITMMVT [ITV]

Cumuls Article-Site

ITMSALES [ITS]

Articles - ventes

ITMWRH [ITW]

Articles - Dépôts

LPN [LPN]

Identifiant contenant interne

PRICSTRUCT [PRS]

Structure Tarifs (cli/four)

SALESREP [REP]

Représentant

SCOMAT [SCM]

Ordre sous-traitance Matières

SDELIVERY [SDH]

Entête de livraison

SDELIVERYD [SDD]

Détail livraison

SORDER [SOH]

Commandes de vente - Entête

SORDERC [SOC]

Commandes de vente - Cumul A/R

SORDERP [SOP]

Commandes de vente - Prix

SORDERQ [SOQ]

Commandes de vente - Quantités

SPREASON [SPR]

Motifs tarifs ventes

SPRICLINK [SPK]

Recherche tarifs vente (link)

STOALL [STA]

Allocations

STOCK [STO]

Stocks

STOJOU [STJ]

Journal des Stocks

STOLOT [STL]

Numéros de lot

STOPRED [PRE]

Bon de préparation détail

STOPREH [PRH]

Bon de préparation entête

STOREO [REO]

Réapprovisionnement

STOSER [STS]

Numéros de série

SVCRFOOT [SVF]

Document ventes - Elt pied

SVCRVAT [SVV]

Document ventes - Taxes

TABCOUNTRY [TCY]

Table des Pays

TABCUR [TCU]

Table des Devises

TABPRTMOD [TPM]

Table des modèles d'éditions

TABSDHTYP [TSD]

Table types livraisons

TABUNIT [TUN]

Table des unités

WAREHOUSE [WRH]

Dépôts