Type de dataset | Création de facture fournisseur |
---|---|
DatasetType (2) | FACFOU |
Nature de fichier joint | DATAHUB_FACFOU |
Code chemin | DATAHUB_JOINT_FACFOU |
Fichier pivot | Complet : intègre les données de la facture. Peut utiliser la complétion |
Fichier compagnon | PDF : scan ou document numérique de la facture fournisseur |
Fichier trace | Non concerné |
Détails du fichier pivot
Le tableau suivant indique le format de balisage XML attendu
Les types traités sont :
valeurChaine indique une valeur de type chaîne de caractères alphanumériques
valeurDate indique une valeur de type date au format YYYYMMDD
valeurNum indique une valeur numérique sans séparateur de milliers
La colonne indique si la balise et sa valeur sont obligatoires ou non. 'Rec' signifie 'Recommandé' pour un traitement total automatique
Balise XML | Obligatoire | Observation |
<?xml version="1.0" encoding="UTF-8"?> | Oui | Indique le format d’encodage des chaînes de caractères |
<DataHub DataSetType=valeurChaine> | Oui | L’attribut DATASETTYPE indique le type de pivot. Valeur : FACFOU pour indiquer qu’il s’agit d’un flux fournisseur |
Entête* | Oui | Entête de description de la facture |
Détail des commandes ou BL*
| Non | Obligatoire si la facture concerne une commande existante dans Divalto Sinon on est dans un circuit de facture fournisseur sans commande |
Fichiers* | Non | Fichiers complémentaires au fichier principal et au pivot |
Erreurs* | Non | Messages d’erreurs concernant les documents compagnons du pivot |
</DATAHUB> | Oui |
|
| ||
Entête : |
| Un seul entête par fichier |
<Source>valeurChaine</Source> | Rec | Permet d’identifier l’émetteur du pivot dans le dataset |
<Systeme>valeurChaine</Systeme> | Rec | Permet d’identifier le système émetteur dans le dataset |
<IdExterne>valeurChaine</IdExterne > | Rec | Permet d’indiquer l’identifiant unique d’un logiciel externe dans le but de donner un premier pivot pour complétion ultérieure par un second pivot. |
<Dossier>valeurChaine</Dossier> | Rec | Code de dossier Divalto |
<Etablissement>valeurChaine</Etablissement> | Rec | Code d’établissement Divalto, si gestion du dossier par établissement |
<SwTicketNo>0</SwTicketNo> | Rec | Numéro de ticket de demande. LA présence de la balise indique qu’on veut avoir un ticket en retour |
<CodeFournisseur>valeurChaine</CodeFournisseur> | Rec | Code de fournisseur émetteur de la facture |
<NomFournisseur>valeurChaine</NomFournisseur> | Non | Nom du fournisseur émetteur de la facture |
<Affaire>valeurChaine</Affaire> | Non | Code affaire divalto |
<DateFacture> valeurDate </DateFacture> | Rec | Date de la facture fournisseur |
<DateEcheance> valeurDate </DateEcheance> | Non | Date d’échéance du paiement. Rec selon le mode de règlement |
<NoFactureFournisseur>valeurChaine</NoFactureFournisseur> Ou <NoFactureFournisseur Avoir=’oui’>valeurChaine</NoFactureFournisseur> Ou <NoFactureFournisseur Inconnu=’oui’>valeurChaine</NoFactureFournisseur> | Rec | Numéro de facture du fournisseur Ou Numéro d’avoir fournisseur Ou Numéro de facture ou d’avoir, mais l’information n’est pas déterminée |
<DevisePiece>valeurChaine</DevisePiece> | Non | Code devise Divalto (EUR) |
<MontantTTC> valeurNum </MontantTTC> | Rec | Montant TTC de la facture |
<MontantHT> valeurNum </MontantHT> | Rec | Montant HT de la facture |
<MontantTVA> valeurNum </MontantHT> | Non | Montant de TVA de la facture |
<MontantEscompte> valeurNum < MontantEscompte> | Non | Montant d’escompte de la facture |
<MontantPied1> valeurNum </MontantPied1> | Non | Montant de pied 1 de la facture |
<MontantPied2> valeurNum </MontantPied2> | Non | Montant de pied 2 de la facture |
<MontantPied3> valeurNum </MontantPied3> | Non | Montant de pied 3 de la facture |
<FichierPrincipal Signature=’nomSignature’> valeurChaine</FichierPrincipal> | Non | Nom du fichier principal associé au pivot (nom du PDF par exemple). Le fichier peut être dans un sous-répertoire du pivot, on indiquera donc le chemin relatif. L’attribut optionnel Signature= permet d’indiquer un nomSignature |
<PersonneEnCharge>valeurChaine</PersonneEnCharge> | Non | Code collaborateur de la personne en charge du traitement de la facture |
<Valideur>valeurChaine</Valideur> | Non | Code collaborateur de la personne en charge de valider la facture |
<GroupeEnCharge>valeurChaine</GroupeEnCharge> | Non | Code du groupe utilisateur en charge du traitement de la facture |
| ||
Détail des commandes ou BL : |
|
|
<Pieces> | Oui | Balise ouvrante de pièces |
Commandes* | Non | Description d’une commande |
Bons de livraison* | Non | Description d’un bon de livraison. Attention : n’est traité que le cas de BL direct qui n’a pas fait l’objet d’une commande. Sinon utiliser le groupe de balises pour une Commande |
</Pieces> | Oui | Balise fermante de pièces |
| ||
Commandes : |
|
|
<Commande> | Oui | Balise ouvrante de commande |
<NoCommandeFournisseur> valeurChaine </NoCommandeFournisseur> | Oui | Numéro de commande du fournisseur |
<NoCommandeDivalto> valeurChaine </NoCommandeDivalto> | Oui | Numéro de commande du fournisseur dans Divalto |
Lignes* | Non | Description de lignes de pièce |
</Commande> | Oui | Balise fermante de commande |
| ||
Bons de livraison : |
|
|
<BonLivraison> | Oui | Balise ouvrante de commande |
<NoBLFournisseur> valeurChaine </NoBLFournisseur> | Oui | Numéro de bon de livraison du fournisseur |
<NoBLDivalto> valeurChaine </NoBLDivalto> | Oui | Numéro de bon de livraison du fournisseur dans Divalto |
Lignes* | Non | Description de lignes de pièce |
</BonLivraison> | Oui | Balise fermante de commande |
| ||
Lignes : |
| VOIR NOTE1 |
<Ligne> | Oui | Balise ouvrante de ligne de pièce |
<Reference> valeurChaine </Reference> | Rec | Référence article |
<IndiceArticle> valeurChaine</IndiceArticle> | Non | Indice article (si c’est vide l’indice en cours sera pris) |
<Designation> valeurChaine </Designation> | Non | Désignation article |
<SousReference1> valeurChaine </SousReference1> | Non | Sous-référence 1 article |
<SousReference2> valeurChaine </SousReference2> | Non | Sous-référence 2 article |
<QuantiteLigne> valeurNum </QuantiteLigne> | Rec | Quantité de la ligne |
<MontantLigne> valeurNum </MontantLigne> | Non | Montant de la ligne |
<MontantRemise> valeurNum </MontantRemise> | Non | Montant de remise de la ligne |
<EnrNo> valeurNum </EnrNo> | Rec | Numéro interne Divalto identifiant le mouvement en commande |
<PrixUnitaire> valeurNum </PrixUnitaire> | Rec | Prix unitaire |
<PrixPar> valeurNum </PrixPar> | Non | Indication de prix par quantité multiple |
<Remise1> valeurNum </Remise1> | Non | Remise en pourcentage |
<TypeRemise1> valeurNum </TypeRemise1> | Non | Valeurs possibles :1 Cumulé, 2 Successif, 3 Différée Prix Brut, 4 Différée Prix Net |
<Remise2> valeurNum </Remise2> | Non | Remise en pourcentage |
<TypeRemise2> valeurNum </TypeRemise2> | Non | Valeurs possibles :1 Cumulé, 2 Successif, 3 Différée Prix Brut, 4 Différée Prix Net |
<Remise3> valeurNum </Remise3> | Non | Remise en pourcentage |
<TypeRemise3> valeurNum </TypeRemise3> | Non | Valeurs possibles :1 Cumulé, 2 Successif, 3 Différée Prix Brut, 4 Différée Prix Net |
Taxes* | ||
<Ligne> | Oui | Balise fermante de ligne de pièce |
|
|
|
Taxes : | ||
<Taxe> | ||
<Code> valeurChaine</Code> | Oui | Code la taxe complémentaire |
<Libelle>valeurChaine</Libelle> | Non | Libellé |
<PrixUnitaire>valeurNum </PrixUnitaire> | Oui | Prix de la taxe |
</Taxe> | ||
Fichiers : |
|
|
<Fichiers> | Oui | Balise ouvrante de fichiers |
<Fichier> valeurChaine </Fichier> | Oui | Nom du fichier compagnon complémentaire (hors fichier principal qui a une balise dédiée). Le fichier peut être dans un sous-répertoire du pivot, on indiquera donc le chemin relatif |
</Fichiers> | Oui | Balise fermante de fichiers |
|
|
|
Erreurs : |
|
|
<MsgErreurs> | Oui | Balise ouvrante d’erreurs |
<MsgErreur> | Oui | Balise ouvrante d’erreur |
<NumErreur> valeurNum </NumErreur> | Non | Numéro du message d’erreur |
<TexteErreur> valeurChaine </TexteErreur> | Non | Texte du message d’erreur |
</MsgErreur> | Oui | Balise fermante d’erreur |
</MsgErreurs> | Oui | Balise fermante de pièces |
NOTE1 : Numéro interne ENRNO
Lorsque la balise <ENRNO> (donc le numéro interne de mouvement) est transmise, les autres informations ne sont pas nécessaires.
A l’inverse sans ENRNO les valeurs pour REFERENCE, QUANTITELIGNE, PRIXUNITAIRE sont obligatoires
Exemples de fichiers
Exemple de fichier pivot simple pour facture fournisseur (pivot_facfou1.dhub)
<?xml version="1.0" encoding="UTF-8"?> <DataHub DataSetType="FACFOU"> <Source>LAD</Source> <Systeme>SOP1</Systeme> <Dossier>998</Dossier> <Etablissement></Etablissement> <CodeFournisseur>F0000006</CodeFournisseur> <NomFournisseur>ANCONA</NomFournisseur> <DateFacture>20170130</DateFacture> <DateEcheance>20170205</DateEcheance> <NoFactureFournisseur>FA2017-1</NoFactureFournisseur> <Pieces> <Commande> <NoCommandeFournisseur>12090152</NoCommandeFournisseur> <NoCommandeDivalto>12090152</NoCommandeDivalto> </Commande> </Pieces> <DevisePiece>EUR</DevisePiece> <MontantTTC>12345</MontantTTC> <MontantHT>10000</MontantHT> <FichierPrincipal Signature="RGS**">facfou.pdf</FichierPrincipal> </DataHub>
Exemple de fichier pivot pour complétion ultérieure pour facture fournisseur (pivot_facfou2.dhub)
<?xml version="1.0" encoding="UTF-8"?> <DataHub DataSetType="FACFOU"> <Source>LAD</Source> <Systeme>SOP1</Systeme> <IdExterne>1234</IdExterne > <FichierPrincipal>facture_c0000001.pdf</FichierPrincipal> </DataHub>
Exemple de fichier pivot plus complet pour facture fournisseur (pivot_facfou3.dhub)
<?xml version="1.0" encoding="UTF-8"?> <DataHub DataSetType="FACFOU"> <Source>LADSOP1</Source> <Systeme>SOP1</Systeme> <IdExterne>1234</IdExterne> <Dossier>998</Dossier> <Etablissement></Etablissement> <CodeFournisseur>F0000006</CodeFournisseur> <NomFournisseur>ANCONA</NomFournisseur> <DateFacture>20170130</DateFacture> <DateEcheance>20170205</DateEcheance> <NoFactureFournisseur>FA2017-1</NoFactureFournisseur> <PersonneEnCharge></PersonneEnCharge> <Valideur></Valideur> <Pieces> <Commande> <NoCommandeFournisseur>12090152</NoCommandeFournisseur> <NoCommandeDivalto>12090152</NoCommandeDivalto> <Ligne> <Reference>ALB0001</Reference> <QuantiteLigne>2,5</QuantiteLigne> <MontantLigne>50,60</MontantLigne> </Ligne> </Commande> <Commande> <NoCommandeFournisseur>12090153</NoCommandeFournisseur> <NoCommandeDivalto>12090153</NoCommandeDivalto> <Ligne> <Reference>ALB0002</Reference> <QuantiteLigne>24,5</QuantiteLigne> <MontantLigne>59,60</MontantLigne> </Ligne> </Commande> </Pieces> <DevisePiece>EUR</DevisePiece> <MontantTTC>12345</MontantTTC> <MontantHT>10000</MontantHT> <MontantEscompte>1234,50</MontantEscompte> <MontantPied1>1234,50</MontantPied1> <FichierPrincipal Signature="RGS**">facture_c0000001.pdf</FichierPrincipal> <Fichiers> <Fichier>ent_998.dhvw</Fichier> <Fichier>ent_998b.dhvw</Fichier> </Fichiers> <MsgErreurs> <MsgErreur> <NumErreur>1250</NumErreur> <TexteErreur>Signature non vérifiée</TexteErreur> </MsgErreur> </MsgErreurs> </DataHub>
Exemple d’extrait de ligne avec taxes complémentaires
<Ligne> <Reference>ALB0001</Reference> <QuantiteLigne>1</QuantiteLigne> <PrixUnitaire>37.80</> <Taxe> <Code>ECO</Code> <Libelle>Eco-contribution</Libelle> <PrixUnitaire>0.35</PrixUnitaire> </Taxe> <Taxe> <Code>BOIS</Code> <Libelle>Taxe bois</Libelle> <PrixUnitaire>0.29</PrixUnitaire> </Taxe> </Ligne>
Exemple de fichier compagnon PDF facture fournisseur (facfou.pdf)