Connaitre la structure d'un fichier au format RImport
Description

Les fichiers RImport.txt qui respectent la structure, détaillée ci-dessous, peuvent être importés dans les logiciels de comptabilité Ciel Compta / Gestion Intégrale ou Sage 50.

Cause
Resolution

Description globale

LibelléValeur
 Type de fichier Texte
 Encoding Extended Windows ANSI, Unicode
 Format Variable, de type Tab-Return (séparateur tabulation de Excel)
 Nom de détection RImport.txt
 Extension .txt


Lignes

Le format des fichiers RImport est relativement léger et facile à consulter (avec Excel par exemple). C’est un format de type texte qui permet de transférer des lignes d’écritures comptables. Chaque ligne peut contenir plusieurs champs de longueur variable, séparés par des tabulations, et se termine par un retour à la ligne.

Exemple : 

4646484354         411666          Facture      240.47D       Banque “Crédit maritime”
4646484355         411666          Facture     15.03D          Banque “Crédit maritime”

Sections

En plus des lignes d’écriture, le fichier peut contenir des informations supplémentaires, comme par exemple les informations des comptes tiers. Ces informations sont contenues dans des sections introduites par une ligne de commande qui commence par ##Section.

 Exemple : 

          ##Section            Tiers
          411666       Compte client           Léon                Rue de la paix           75000           Paris

Format

Il est également possible de modifier le format de certaines données. Les modifications s’appliquent pour les données comprises entre les lignes de commande ##DebFmt et ##FinFmt.

On peut par exemple redéfinir le séparateur décimal pour un certain nombre de lignes.

 Exemple : 

##DebFmt                         SepDec = .                      
… (données)                      
##FinFmt                          SepDec

On peut avoir des déclarations de format imbriquées les unes dans les autres. Si un même format est défini plusieurs fois avec des valeurs différentes, la dernière définition écrase la précédente et s’applique jusqu’à la ligne ##FinFmt correspondante. La définition précédente s’applique à nouveau ensuite (même fonctionnement qu’une pile).

Si le fichier ne compte pas exactement le même nombre de lignes ##DebFmt et ##FinFmt, il y a une erreur.

Caractères

Les applications Sage 50 et Ciel utilisent les caractères Windows ANSI étendus pour la génération des fichiers RImport. Les fichiers importés peuvent cependant utiliser les caractères au format Unicode, ils seront reconnus (si toutefois le marqueur unicode 0xFEFF est présent en début de fichier).


Structure détaillée

ElémentContenuDescription
Fichier RImport

<Ligne><Retour à la ligne>

<Ligne><Retour à la ligne>

<Ligne><Retour à la ligne>

Un fichier RImport est composé de plusieurs lignes séparées par des retours à la ligne. 

Le retour à la ligne suivant la dernière ligne n’est pas obligatoire

Ligne<Ligne de données> ou <Ligne de commande>Une ligne peut être de type « Ligne d’écriture », « Début de section », « Début de format » ou « Fin de format »
Retour à la ligne

CR ou

LF ou

CR LF ou

LF CR

Le retour chariot (CR, code ASCII 0x0D) et Line feed (LF, code ASCII 0x0A), ainsi que leurs combinaisons sont acceptées comme séparateurs de lignes.
Ligne de données

<Donnée><Tabulation>…

<Tabulation><Donnée>

Les données sont les valeurs affectées aux différents champs qui composent une ligne d'écriture. Elles sont séparées par des tabulations. S’il n’y a rien entre deux tabulations, c’est la valeur par défaut de la rubrique qui sera prise.
Donnée
TypeExemple
Texte nu411AB111
Texte encapsulé“Compte de Trésorerie”
Valeur vide“”
Valeur par défaut
Texte représentant la valeur d’un champ dans une ligne d’écriture. Le texte peut être nu ou encapsulé dans des “”. Tous les caractères sont acceptés. Cependant, si le texte contient des tabulations ou des retours à la ligne, il doit être encapsulé. Si un texte encapsulé contient des “”, elles doivent être doublées. La valeur vide est représentée par “”. Si la donnée ne contient aucun texte, c’est la valeur par défaut du champ qui sera prise lors de l'import du fichier.
Ligne de commande
##<Commande><Tabulation><Paramètre(s)>Une ligne de commande peut contenir 0, 1 ou plusieurs paramètres. Il existe une commande pour définir les sections et des commandes pour définir le format de certaines données.
Commande Fichier##Fichier <Type>Informations sur le fichier
TypeRImportCette information doit impérativement figurer en début de fichier
Commande Section##Section<Tabulation><Nom section>Indique le début d’une section.
Commande début de format
    1. DebFmt<Tabulation><NomFormat> = <Format>

Non prise en compte pour l’instant

Spécification d’un format de donnée. Ce format sera appliqué sur toutes les lignes suivantes jusqu’au prochain marqueur ##FinFmt.
Commande fin de format
    1. FinFmt

Non prise en compte pour l’instant

Le format spécifié après le marqueur ##DebFmt reprend la valeur qu’il avait précédemment.
Nom section
Type de sectionNom section
SociétéSoc
DossierDos
MouvementsMvt
JournauxJnl
Comptes de tiersTiers
Modes de paiementMdP
DeviseDv
Les sections n’ont pas d’ordre déterminé. Le début d’une section indique la fin de la section précédente.
Nom Format
Nom FormatDescription
Aucun pour l’instant
Nom d’un format à modifier, comme par exemple, SepDec pour le séparateur décimal.
Format
Nom FormatFormats possibles
Aucun pour l’instant
Valeur d’un format à modifier, comme par exemple / pour le séparateur des dates.

Description du contenu

Types utilisés pour les rubriques

Entier :

  • Les valeurs 0 et vide sont identiques
  • Les caractères reconnus sont les chiffres de 0 à 9 et le signe – en début de rubrique, tous les autres caractères sont ignorés.

EXEMPLE : 

-45,9 8 8 sera interprété comme -45 988
45a6 comme 456

ATTENTION : Ces exemples ne génèrent pas d’erreur.

Flottant

  • Le séparateur décimal est indifféremment le point ou la virgule (si la rubrique en contient plusieurs, c’est le plus à droite qui est pris en compte)
  • Les valeurs 0 et vide sont identiques
  • Peut être précédé du signe moins (y compris pour 0 ou vide)
  • Tous les autres caractères sont ignorés (espaces, lettres …)
  • La précision peut aller de 0 à 8 décimales

EXEMPLE : 

12.123.555 sera interprété comme 12 123,555
-78-568,44 comme 78 568,44

Date :

  • Au format JJ/MM/AA ou JJ/MM/AAAA
  • Les dates relatives ne sont pas autorisées

Heure :

  • Au format HH :MM

Booléen :

  • 0 ou vide ou "" pour faux (s’il y a des espaces, ils sont trimés)
  • Tous les autres caractères pour vrai

Texte :

  • Tous les caractères sont autorisés.
  • Si le texte d’une rubrique contient des tabulations ou retours à la ligne, il doit être entre doubles cotes.

EXEMPLE : 
                   "Texte avec tabulation"

  • S’il contient lui-même des doubles cotes, elles sont répétées.

EXEMPLE : 
                   “ Rubrique contenant des : ““ double cotes ”” ”

Rubriques

Rubriques obligatoires

Les rubriques marquées d’un * doivent obligatoirement être renseignées.

Rubriques de la section Soc

(Ignorée pour l’instant)

Rubriques de la section Dos

PositionNomTypeContrainteVide autoriséValeur par défautCommentaire
 1Code monnaie origineTexteLongueur maximum 3 ouiMonnaie du dossier


Rubriques de la section Mvt

PositionNomTypeContrainteVide autoriséValeur par défautCommentaire
 1N° Mouvement *EntierValeur maximum< 2 147 483 647 non

 2Code journal*TexteLongueur maximum 8 non

 3Date écriture *Date
 non

 4N° de compte*TexteLongueur maximum 13 non

 5Intitulé du compteTexteLongueur maximum 40 non

 6Montant *Flottant
 non
 Précision de 0 à 3
 7Sens montant*TexteLongueur maximum 1 non
 D (débit) ou C (crédit)
 8Code statutTexteLongueur maximum 1 oui B B (brouillard), V (validé) ou S (simulation)
 9Libellé écritureTexteLongueur maximum 50 oui

 10N° de pièceTexteLongueur maximum 15 oui

 11TypeEntier TexteLongueur 35 oui
 1 à 15 ou {Recette, Facture client, Facture fournisseur, Règlement client, Règlement fournisseur, Virement, Réimputation, Amortissement, Opération diverse, Avoir client, Acompte client, Acompte fournisseur, Centralisation}
 12Code mode de paiementTexteLongueur maximum 20 oui

 13Date échéanceDate
 oui

 14Code analytiqueTexteLongueur maximum 13 oui

 15Libellé code analytiqueTexteLongueur maximum 35(sans les sous-niveaux) oui
 Dans le cas d’un code analytique multi-niveaux, le libellé analytique contient le détail des sous niveaux (Libellé, Niveau et Montant analytiques)
 16 Code pointage Texte Longueur maximum 12 oui

 17 Date pointage Date
 oui

 18 Réf pointage Texte Longueur maximum 15 oui

 19 Code devise Texte Longueur maximum 3 oui

 20 Taux devise Flottant
 oui

 21 Montant devise Flottant
 oui

 22 Quantité Flottant
 oui

 23Libellé mouvement  Texte Longueur maximum 50 oui

 24 Code lettrageTexte  Longueur maximum 3 oui

 25  Date lettrageDate 
 oui

Code analytique multi-niveau

Le code analytique peut être défini sur plusieurs niveaux. Dans ce cas, les sous-niveaux sont détaillés dans le libellé du code analytique de la manière suivante :

“ <Libellé code principal><Retour à la ligne>
<<Code>^<Libellé>^<Niveau>^<Montant>^<Montant devise>^<Saisissable>
<Retour à la ligne>> n fois ” 

Il est possible d'avoir une multi-ventilation sur le niveau 1. La rubrique <code analytique principal> doit être égale à "<Multiple>". On notera également que chacun des codes analytiques du niveau 1 peut contenir des codes analytiques de niveau 2 à 3.

EXEMPLES : 

Exemple d'une répartition à 3 niveaux :

"39"    "VT"    "01/10/2012"    "707000"    "Ventes"    "1 000,00"    C    B    "Ligne à 3 niveaux"        "10"            "B"    "B Libellé
B1^B1 Libellé^2^500,00^0^0^0^0
B11^B11 Libellé^3^300,00^0^0^0^0
B12^B12 Libellé^3^200,00^0^0^0^0
B2^B2 Libellé^2^500,00^0^0^0^0
B21^B21 Libellé^3^300,00^0^0^0^0
B22^B22 Libellé^3^200,00^0^0^0^0"

Exemple d'une multi-ventilation sur le niveau 1 (Avec le code A réparti sur un niveau 2) :

"39"    "VT"    "01/10/2012"    "707000"    "Ventes"    "1 000,00"    C    B    "Ligne à répartition multiple"        "10"            "<Multiple>"    "Plusieurs codes analytiques
ACT1^Activité 1^1^500,00^0^0^0^0
ACT2^Activité 2^1^250,00^0^0^0^0
ACT3^Activité 3^1^250,00^0^0^0^0
A^A Libellé^1^1 000,00^0^0^0^0
A1^A1 Libellé^2^500,00^0^0^0^0
A2^A2 Libellé^2^500,00^0^0^0^0"

PositionNomTypeContrainteVide autoriséValeur par défautCommentaire
 1Sous-code analytiqueTexteLongueur maximum 13oui

 2Libellé sous-code analytiqueTexteLongueur maximum 35Pas de tabulationPas de retour à la ligneoui si le sous-code analytique est vide

 3Niveau analytiqueEntier
oui si le sous-code analytique est vide
 1, 2 ou 3
 4Montant analytiqueFlottant
oui si le sous-code analytique est vide, sinon mettre 0

 5Montant deviseFlottant
oui si le sous-code analytique est vide, sinon mettre 0

 6SaisissableBooléen
oui faux
 7AjustéBooléen
oui faux
 8Ajusté deviseBooléen
oui faux


Rubriques de la section Tiers

PositionNomTypeContrainteVide autoriséValeur par défaut si videCommentaire
1N° de compteTexteLongueur maximum 13non

2Intitulé du compteTexteLongueur maximum 40non

3Rayon banqueTexteLongueur maximum 2non
SR (sur rayon) ou HR (hors rayon)
4Nom banqueTexteLongueur maximum 35


5Nom client/fournisseurTexteLongueur maximum 35oui

6Adresse 1TexteLongueur maximum 35oui

7Adresse 2TexteLongueur maximum 35oui

8Adresse 3TexteLongueur maximum 35oui

9Code postalTexteLongueur maximum 10oui

10VilleTexteLongueur maximum 35oui

11TéléphoneTexteLongueur maximum 25oui

12PortableTexteLongueur maximum 25oui

13TélexTexteLongueur maximum 25oui

14FaxTexteLongueur maximum 25oui

15Mode règlementTexteLongueur maximum 20oui

16N° de TVA intracomTexteLongueur maximum 19oui

17EmailTexteLongueur maximum 127oui

18Adresse internetTexteLongueur maximum 127oui

19Code paysTexteLongueur maximum 35oui


Rubriques de la section Jnl

NomTypeContrainteVide autoriséValeur par défaut si videCommentaire
Code journal*TexteLongueur maximum 8non

Intitulé du journalTexteLongueur maximum 40ouiCode journal
Type du journalTexteLongueur maximum 1ouiOO (OD), A (Achats), V (Ventes),T (Trésorerie) ou N (A-Nouveaux)


Rubriques de la section MdP

NomTypeContrainteVide autoriséValeur par défaut si videCommentaire
Code mode de paiement*TexteLongueur maximum 20non

Intitulé mode de paiementTexteLongueur maximum 35ouiCode mode de paiement
Type mode de paiementEntier ou texteLongueur maximum 35non
De 1 à 14 ou {Agios et frais, Carte bancaire, Chèque, Divers, Traite, Espèces, Prélèvement, Virement, LCR acceptée, LCR non acceptée, Billet à ordre, Aucun, TIP, Retrait espèces}
MagnétiqueBooléen
ouifaux Mettre "M" si magnétique


Rubriques de la section Dv

NomTypeContrainteVide autoriséValeur par défaut si videCommentaire
Code devise*TexteLongueur maximum 3non

Intitulé deviseTexteLongueur maximum 35ouiCode devise


EXEMPLE DE FICHIER : 

##Transfert
##Section Dos
EUR
##Section Mvt
"20451"    "OD"    "16/03/2022"    "411666"    "554,520"    D    B    "Echéance Spéciale"    "1"    "23/04/2022"
"20451"    "OD"    "16/03/2022"    "411666"    "672,320"    C    B    "Echéance Spéciale"    "1"    "23/04/2022"
"20451"    "OD"    "16/03/2022"    "411666"    "840,560"    C    B    "Echéance Spéciale"    "1"    "23/04/2022"

"20550"    "OD"    "27/04/2022"    "411000"    "152,690"    C    B    "Règlement Facture"    "50"    "USD"     "0,889"    "-847,590"    "10,5"
##Section Tiers
"411000"    "Crédit agricole"    "HR"    "Barbatruc"    "20, Rue Pouchkine"    "Tour A"    "Appt 102"    "99000"    "Rio"    "CHQ"    "TVAAAA"
"411666"    "Compte du démon"    "SR"     "Satanas"    "Quartier des Nbolok"    "Rue des Diables"    "Maison des brulots"
##Section Jnl
"OD"    "Opérations diverses"    "O"
##Section Dv
"USD"    "US Dollar"    "KIP" "Lao kip"
##Section MdP
"CB"    "Carte bleue"    "CHQ"    "Chèque"


Steps to duplicate
Related Solutions