Intégration écritures comptables (V10.6)
- Bertrand Littel
Type de dataset | Ecritures comptables |
|---|---|
DatasetType (10) | IMPECR |
Nature de fichier joint | DATAHUB_ECR |
Code chemin | DATAHUB_JOINT_ECR |
Fichier pivot | Simple : les données à importer sont dans le fichier principal au format XML |
Fichier compagnon | Oui, format XML contenant les données du devis |
Fichier trace | Oui |
Règles de gestion
Dans le cas d'une intégration sans erreur, le numéro réel de l'écriture intégrée est indiqué dans le fichier de trace. En cas d’erreur le fichier de trace indique les messages d’erreurs
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: IMPECR pour indiquer qu’il s’agit d’un flux intégration d'écritures comptables |
<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 |
<Dossier>valeurChaine</Dossier> | Oui | 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 |
<FichierPrincipal>valeurChaine</FichierPrincipal> | Oui | Nom du fichier principal. Ce fichier au format XML indique l’action (import ou export) et les données concernées (tables, champs) |
Détails du fichier principal
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 |
|---|---|---|
<DIVALTO> | Oui | Balise principale |
<ECRITURE> | Oui | Balise ouverture écriture |
Ecriture* | Oui | Détails d’une ou plusieurs écritures |
</ECRITURE> | Oui | Balise fermeture écriture |
</DIVALTO> | Oui |
|
|
|
|
Ecriture : |
|
|
<EnteteEcriture> | Oui | Détail de l’entête d'écriture. Un seul entête par écriture. Comporte notamment : DOS, DOSG, ETB et DEV |
<NomDuChamp>Valeur</NomDuChamp> | Rec | Données, champ par champ, de l’entête écriture Exemple : <TIERS>F000001</TIERS> |
<Lignes> | Rec | Balise ouvrante détails lignes |
LigneEcriture* | Oui |
|
LigneTVA* | Rec |
|
LigneAxe* | Rec |
|
LignePiece* | Rec |
|
</Lignes> | Rec | Balise fermante détails lignes |
</EnteteEcriture> |
|
|
|
|
|
LigneEcriture : |
|
|
<LigneEcriture> |
| Balise ouvrante du détail d’une ligne écriture |
<NomDuChamp>Valeur</NomDuChamp> | Rec | Données, champ par champ, de la ligne d'écriture Exemple : <TIERS>F000001</TIERS> |
</LigneEcriture> |
| Balise fermante du détail d’une ligne écriture |
|
|
|
LigneTVA : |
|
|
<LigneTVA> |
| Balise ouvrante du détail ventilation TVA |
<NomDuChamp>Valeur</NomDuChamp> |
| Données, champ par champ, des ventilation de TVA associées à la ligne d’écriture |
</LigneTVA> |
| Balise fermante du détail ventilation TVA |
|
|
|
LigneAxe : |
|
|
<LigneAxe> |
| Balise ouvrante du détail ventilation axe analytique |
<NomDuChamp>Valeur</NomDuChamp> |
| Données, champ par champ, des ventilation d’axe analytique associées à la ligne d’écriture |
</LigneAxe> |
| Balise fermante du détail ventilation axe analytique |
|
|
|
LignePiece : |
|
|
<LignePiece> |
| Balise ouvrante du détail ventilation pièce |
<NomDuChamp>Valeur</NomDuChamp> |
| Données, champ par champ, des ventilation par pièces et échéance de la ligne d’écriture |
</LignePiece> |
| Balise fermante du détail ventilation pièce |
NOTE : Les données DOS,DOSG,ETB et DEV d'une écriture sont initialisées à partir des données de l'entité <ENTETEECRITURE>. Le numéro de l'écriture intégrée est attribué en automatique.
Exemples de fichiers
Exemple de fichier pivot pour intégration écriture comptables (pivot_impecr.dhub)
<?xml version="1.0" encoding="UTF-8"?>
<DataHub DataSetType="IMPECR">
<Source>EXTERNE</Source>
<Dossier>998</Dossier>
<Etablissement></Etablissement>
<FichierPrincipal>Ecr1.xml</FichierPrincipal>
</DataHub>
Exemple de fichier principal (Ecr1.xml)
<DIVALTO>
<ECRITURE>
<ENTETEECRITURE>
<DOS>998</DOS>
<JNL>A2</JNL>
<CPT>F0000001</CPT>
<TIERS>F0000001</TIERS>
<TIERSTYPE>2</TIERSTYPE>
<ECRDT>26/02/2021</ECRDT>
<PIECECPT>97704</PIECECPT>
<PIECE>9999999</PIECE>
<MT>6000</MT>
<MTDEV>6000</MTDEV>
<DEV>EUR</DEV>
<REG>N30</REG>
<ECHDT>26/03/2021</ECHDT>
</ENTETEECRITURE>
<LIGNES>
<LIGNEECRITURE>
<DOS>998</DOS>
<JNL>A2</JNL>
<DEV>EUR</DEV>
<ECRDT>26/02/2021</ECRDT>
<CPT>F0000001</CPT>
<MT>6000</MT>
<MTDEV>6000</MTDEV>
<SENS>2</SENS>
<PIECE>9999999</PIECE>
<CPTCOL>40100000</CPTCOL>
<PIECECPT>97704</PIECECPT>
<ECHDT>26/03/2021</ECHDT>
</LIGNEECRITURE>
</LIGNES>
<LIGNES>
<LIGNEECRITURE>
<DOS>998</DOS>
<JNL>A2</JNL>
<DEV>EUR</DEV>
<ECRDT>26/02/2021</ECRDT>
<CPT>60710000</CPT>
<MTDEV>5000</MTDEV>
<MT>5000</MT>
<SENS>1</SENS>
<PIECE>9999999</PIECE>
<PIECECPT>97704</PIECECPT>
<ECHDT>26/03/2021</ECHDT>
</LIGNEECRITURE>
<LIGNETVA>
<TVAART>1</TVAART>
<TVATIE>0</TVATIE>
<MTHT>5000</MTHT>
<MTTVA>1000</MTTVA>
<TVATYP>1</TVATYP>
</LIGNETVA>
<LIGNEPIECE>
<REG>N30</REG>
<ETATREG>C10</ETATREG>
<PIECE>9999999</PIECE>
<ECHDT>29/03/2021</ECHDT>
<MT>4000</MT>
<MTDEV>4000</MTDEV>
</LIGNEPIECE>
<LIGNEPIECE>
<REG>T60</REG>
<ETATREG>C10</ETATREG>
<PIECE>9999999</PIECE>
<ECHDT>29/04/2021</ECHDT>
<MT>1000</MT>
<MTDEV>1000</MTDEV>
</LIGNEPIECE>
<LIGNEAXE>
<MT>2000</MT>
<MTDEV>2000</MTDEV>
<AXE indice="1">11</AXE>
<AXE indice="2">21</AXE>
<AXE indice="3">NICE</AXE>
<AXE indice="4"></AXE>
</LIGNEAXE>
<LIGNEAXE>
<MT>3000</MT>
<MTDEV>3000</MTDEV>
<AXE indice="1">12</AXE>
<AXE indice="2">22</AXE>
<AXE indice="3">PARIS</AXE>
<AXE indice="4"></AXE>
</LIGNEAXE>
</LIGNES>
<LIGNES>
<LIGNEECRITURE>
<DOS>998</DOS>
<JNL>A2</JNL>
<DEV>EUR</DEV>
<ECRDT>26/02/2021</ECRDT>
<CPT>44566000</CPT>
<MT>1000</MT>
<MTDEV>1000</MTDEV>
<SENS>1</SENS>
<PIECE>9999999</PIECE>
<PIECECPT>97704</PIECECPT>
<ECHDT>26/03/2021</ECHDT>
</LIGNEECRITURE>
</LIGNES>
</ECRITURE>
</DIVALTO>