Modèle d'import/export >  Module Ventes >  Modèle d'import/export SIH (Factures de ventes)  

Afficher tout Masquer tout

L’import de factures permet de créer et de modifier des factures ou des avoirs directs.

Le modèle d'import SIH n'est pas un modèle exhaustif, la configuration proposée l'est à titre indicatif. Il permet l'import des quatre premiers éléments de facturation.

Une facture de vente est constituée de deux fichiers d'entête (SINVOICE et SINVOICEV) et d'un fichier de lignes SINVOICED. Il est donc nécessaire de paramétrer deux identificateurs sur le modèle d'import, un pour le fichier entête SINVOICEV, un pour le fichier détail SINVOICED. Il n'est pas nécessaire de définir un indicateur pour la table SINVOICE car le lien entre SINVOICEV et SINVOICE est décrit dans l'objet.

Il est possible d'importer des factures ou avoirs validés ou non validés. Cela dépend de la présence du champ INVSTA (table SINVOICEV) dans le modèle d'import ainsi que de sa valeur. Si le champ n'est pas présent dans le modèle d'import, la facture ou l'avoir seront créés dans le système dans l'état non validé et non imprimé.

Contraintes de l'import en modification :

Lors de l'import d'une ligne détail, le système recherche si la ligne est une nouvelle ligne à créer ou une ligne à modifier. Pour faire cette reconnaissance, le système s'appuie sur les champs discriminants de la ligne. Ces champs sont : le numéro de ligne attribué par X3 (SIDLIN) et la référence article (ITMREF).

  • Si SIDLIN est paramétré dans le modèle et s'il est renseigné et différent de 0, on s'appuie sur ce champ, sinon sur ITMREF.
    Ainsi, si une ligne existe avec la valeur de SIDLIN, cette ligne est modifiée. Sinon une nouvelle ligne est créée.
  • Si SIDLIN n'est pas paramétré ou s'il est à 0, on s'appuie sur le champ ITMREF.
    Ainsi, si une ligne existe avec une valeur correspondant à la valeur contenue dans le champ ITMREF, cette ligne est modifiée. Sinon une nouvelle ligne est créée.

SEEWARNING Dans ce contexte, si deux lignes ont la même référence article, il est nécessaire de paramétrer le numéro de ligne et de le renseigner afin de les différencier. Sinon c'est toujours la première ligne rencontrée qui est modifiée.

Même si le numéro de ligne contenu dans SIDLIN est attribué par X3, il est nécessaire de le renseigner, même en création, pour que le système fonctionne correctement (X3 attribue quand même son numéro).

L'import de facture en modification ne traite pas la mise à jour des stocks. S'il existe des lignes importées en modification avec mise à jour de stock, le système rejette l'import. Le message : "Numéro de facture : Code article : Facture avec mouvement de stock non autorisé" apparaît dans la trace.

Lors d'un import de facture ou d'avoir, on peut soit laisser le système calculer automatiquement le pied de la facture ou alors importer le pied sans que le système ne procède à un recalcul. Le choix dépend de la présence dans le modèle d'import des données liées à la valorisation du pied de facture. S'ils sont présents, le système ne recalculera pas la facture (notamment si le champ AMTATI de la table SINVOICE est présent dans le modèle).

Il est possible d'importer la valeur calculée des éléments de facturation au travers d'un niveau supplémentaire lié à la table stockant le calcul de chaque élément de facturation SVCRFOOT.
Il est également possible d'importer la valeur calculée des éléments de taxation au travers d'un niveau supplémentaire lié à la table stockant le calcul de chaque élément de taxe SVCRVAT. Voir le modèle d'import SIHIMPNCAL permettant d'importer des factures sans déclencher les méthodes de valorisation de facture.

Lors de l'import d'une facture avec un modèle permettant le calcul du pied de facture, les éléments de facturation sont importés des champs INVDTAAMT de la table SINVOICEV.

Il est possible d'importer des factures avec mouvement de stock lorsqu'il s'agit d'une facture directe à condition que la facture importée soit dans l'état non validé. Dans le cas contraire, aucun mouvement de stock ne sera effectué et le flag mouvement de stock sera repositionné à Non.
Pour importer des factures directes non validées avec mouvement de stock, il convient alors d'ajouter le champ STOMVTFLG de la table SINVOICEV dans le modèle d'import et de positionner correctement sa valeur dans le fichier d'import. Le stock à sortir est déterminé par les règles d'allocation de la catégorie de l'article. En aucun cas il n'est possible d'importer des avoirs avec mouvements de stock, le champ STOMVTFLG est ignoré dans ce contexte et positionné à Non.

Import des kits et nomenclatures : Seules les factures sont concernées par l'import des kits et nomenclatures.
Les avoirs ne permettent pas de gérer le kit en tant que groupe d'articles. Chaque élément de la nomenclature est géré individuellement.

Il existe deux manières d’importer des kits et nomenclatures sur une facture :

  • Le champ LINTYP n’est pas présent dans le modèle. Dans ce cas, il ne faudra importer que l’article
    composé (les composants n’étant pas considérés comme appartenant au kit ou à la nomenclature mais traités comme des articles classiques). L’import du composé entraîne alors la génération automatique de tous les composants définis par la première alternative. Les composants de type Option ou Alternative sont également générés pour la première option et la première variante.
  • Le champ LINTYP est présent dans le modèle. Dans ce cas, l’import du composé ne déclenche pas la génération automatique des composants. Les lignes de composants devront être importées en précisant la valeur de LINTYP correspondant. On pourra ainsi, pour des kits ou nomenclatures contenant des options ou des variantes, préciser les composants choisis.

Import de textes : lorsque cela est nécessaire, il est possible d'importer des textes en en-tête de facture, en pied de facture et la ligne de facture. Ceci peut se paramétrer dans le modèle d'import en utilisant la variable globale GIMP (dans le modèle, les zones *71, etc... doivent être mentionnées).

  • GIMP(71..78) permet d’importer des textes liés à l’entête de facture. On peut donc importer un texte de 8*100 caractères soit 800 caractères.
  • GIMP(81..88) permet d’importer des textes liés au pied de facture.
  • GIMP(91..98) permet d’importer des textes liés aux lignes de facture.

Particularités de l'import de facture :

Il est possible en import de préciser le client commande dans le modèle d'import. Celui-ci sera exploité lors de la création de la facture. Notamment pour la détermination des prix et remises si ceux-ci ne font pas partis du modèle d'import.
Il est possible d'importer des champs de lien permettant de préciser l'origine de la facture ou de l'avoir ou de l'origine des lignes des factures et des avoirs. Ces informations seront purement informatives, en aucun cas une mise à jour des documents d'origine, s'ils existent dans le système, ne sera effectuée.

Import des axes analytiques à la ligne : 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).
SEEREFERTO Voir le modèle d'import SIHFL.

SEEWARNINGLes échéances ne sont pas importées. Elles sont calculées à-partir de la condition de paiement de la facture.

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 SINVOICEV :

  • Client facturé (Champ BPCINV)

SEEWARNING Si le site de vente et le site de stockage (pour les factures avec mouvement de stock) ne sont pas présent dans le modèle d’import, les sites seront déterminés par le site de vente et le site de stockage par défaut de la session exécutant l’import.

Table SINVOICED

  • Référence article (Champ ITMREF)
  • Quantité en unité de vente (Champ 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 SIVTYP (type de facture).
Si le type de facture n'est pas précisé, le système choisi le premier de la liste par ordre alphabétique. Cela détermine le type de facture ou d'avoir (même si INVTYP dans le modèle).

Si les champs Statut de la facture (INVSTA) ou Mouvement de stock (STOMVTFLG) ne sont pas présents dans le modèle d'import, alors ils sont positionnés à non.

Messages d'erreur

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

Tous les contrôles effectués par l’objet en saisie interactive sont également effectués en import de facture. On retrouve les principaux contrôles tels que :

Site de vente inexistant : Message de contrôle du site de vente de la facture.

Site de stockage inexistant : Message de contrôle du site de stockage de la facture lors d'un import de facture avec mouvement de stock.

Client XXX fiche inexistante : Message de contrôle de l’existence du client.

Article YYY fiche inexistante : Message de contrôle de l’existence de l’article et de l’article vente.

Unité ZZZ fiche inexistante : Message de contrôle de l’existence et de la validité de l’unité pour l’article.

QTY zone obligatoire : Message de contrôle correspondant à l’existence de cette information lors de l’import d’une facture.

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

CONTSERV [CON]

Contrat de service

CPTANALIN [CAL]

Lignes comptables analytiques

FACILITY [FCY]

Sites

GACCCODE [CAC]

Codes comptables

GACCOUNT [GAC]

Comptes

GTYPACCENT [GTE]

Type de pièces

HDKTASKINV [HDI]

Consommations à facturer

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

PRICSTRUCT [PRS]

Structure Tarifs (cli/four)

SALESREP [REP]

Représentant

SDELIVERY [SDH]

Entête livraison

SDELIVERYD [SDD]

Détail livraison

SERREQUEST [SRE]

Demandes de service

SFOOTINV [SFI]

Eléments de facturation

SINVOICE [SIH]

Factures vente

SINVOICED [SID]

Détail facture de vente

SINVOICEV [SIV]

Facture vente valorisation

SORDER [SOH]

Commandes de vente - Entête

SORDERP [SOP]

Commandes de vente - Prix

SORDERQ [SOQ]

Commandes de vente - Quantités

SPRICLINK [SPK]

Recherche tarifs vente (link)

SPRICLIST [SPL]

Tarifs clients

SRETURND [SRD]

Détail retour vente

STOCK [STO]

Stocks

STOJOU [STJ]

Journal des Stocks

STOLOT [STL]

Numéros de lot

SVCRFOOT [SVF]

Document ventes - Elt pied

SVCRVAT [SVV]

Document ventes - Taxes

TABCUR [TCU]

Table des Devises

TABPRTMOD [TPM]

Table des modèles d'éditions

TABSIVTYP [TSV]

Table types facture client

TABUNIT [TUN]

Table des unités

WAREHOUSE [WRH]

Dépôts