Exemple fichier import écritures de ventes

Cet exemple aide à comprendre comment importer des pièces comptables dans un journal des ventes de la comptabilité à partir d’un fichier texte exporté depuis une autre application.
D’autres exemples de fichier pour import d’écritures de différents types de journaux sont aussi disponibles via clic sur le bouton ci-dessous.

Structure du fichier d’import

• Le fichier exemple des écritures de vente est un fichier délimité avec chaque colonne séparée par une tabulation.
• Chaque ligne contient 11 colonnes.
• Le regroupement des lignes par pièce est déterminé par des valeurs identiques du groupe de colonnes Jou, Date, N°.
• Le fichier représente 5 pièces différentes dont la dernière contient volontairement des anomalies.
• Les données du fichier sont compatibles avec le contexte de la société BIJOU.
• Ce fichier peut être utilisé avec Exemples / Projet d’application en C# .NET + JavaScript

	Jou	Date	N°	Général	Tiers	Libellé	Règlement	Echéance	Débit	Crédit
G	VTE	050620	001	4110000	BAGUES	Fact Bague’s en or	Chèque	310720	306,00	0,00
G	VTE	050620	001	4457120		Fact Bague’s en or			0,00	51,00
G	VTE	050620	001	701020		Fact Bague’s en or			0,00	240,00
G	VTE	050620	001	708500		Fact Bague’s en or			0,00	15,00
G	VTE	100620	002	4110000	CARAT	Fact Carat S.a.r.l	Virement	310720	460,80	0,00
G	VTE	100620	002	4457120		Fact Carat S.a.r.l			0,00	76,80
G	VTE	100620	002	701020		Fact Carat S.a.r.l			0,00	384,00
G	VTE	150620	003	4110000	CISEL	Fact Ciselure	LCR Acceptée	250620	309,00	0,00
G	VTE	150620	003	4110000	CISEL	Fact Ciselure	LCR Acceptée	140820	309,00	0,00
G	VTE	150620	003	4457120		Fact Ciselure			0,00	103,00
G	VTE	150620	003	701020		Fact Ciselure			0,00	500,00
G	VTE	150620	003	708500		Fact Ciselure			0,00	15,00
G	VTE	250620	004	4110000	CRIST	Fact Cristaux liquides	Chèque	310820	279,30	0,00
G	VTE	250620	004	6650000		Fact Cristaux liquides			5,70	0,00
G	VTE	250620	004	701090		Fact Cristaux liquides			0,00	285,00
G	VTA	300620	005	4110000	DIAMO	Fact Diamant Vert	Cheqque	310820	598,76	0,00
G	VTA	300620	005	4457125		Fact Diamant Vert			0,00	99,79
G	VTA	300620	005	701020		Fact Diamant Vert			0,00	498,96

Mappage fichier import et API

Description des différentes Propriétés/Ressources de l’API Sage Business Cloud Comptabilité à utiliser pour ajouter dans un journal des ventes de Sage Business Cloud Comptabilité les écritures de vente contenues dans le fichier d’import exemple.

Champs de l’import	Nb car.	propriété ressource Ecritures	Type propriété	Longueur maxi
Origine	1	Inutilisé
Code journal	6	journal *	single-valued navigation
Date de pièce	6	date *	datetime
N°pièce		incrémenté automatiquement	string	13
N°compte général	13	compte *	single-valued navigation
N°compte tiers	17	tiers	single-valued navigation
Libellé écriture	69	intitule	string	69
Mode de règlement	35	modeReglement	single-valued navigation
Date échéance	6	echeance/écritures	datetime
Montant débit	14	montant	double
Montant crédit	14	montant	double
		Sens *	Debit Credit

Pour éviter un retour en erreur de l’appel à creerPieceComptable les contrôles suivants seront à appliquer pour chaque ligne d’écriture d’une pièce et pour chaque pièce :

• Respect des longueurs maximales pour les propriétés string,
• Code journal doit exister dans la ressource Journaux, propriété code,
• Date de pièce doit être dans l’intervalle dateDebut et dateFin d’un exercice non clôturé (cloture=false) de la sous ressource Exercice de la ressource Informations Société,
• Une pièce est déterminée par des lignes ayant les mêmes valeurs dans les propriétés journal, date et piece.
• N°compte général doit exister dans la ressource Comptes, propriété numero,
• N°compte tiers, si renseigné, doit exister dans la ressource Tiers, propriété numero,
• Mode de règlement, si renseigné, doit exister dans la ressource modeReglement, propriété intitule,
• L’ensemble des écritures d’une pièce doit être équilibré (Total Montant débit = Total Montant crédit)
• Voir aussi Concepts clés / OData - Propriétés de Navigation pour les propriétés de type single-valued navigation.
• Il est recommandé d’effectuer un premier contrôle des lignes de la pièce pour vérifier si le journal, les comptes, les modes de règlement existent, puis une second contrôle en appelant creerPieceComptable avec le paramètre controle=true pour tester les autres règles métier. Par exemple ce second appel informera qu’il n’est pas possible d’ajouter des écritures sur un journal clôturé.

Remarques

• Il vous appartient de décider du comportement souhaité si un compte général ou un compte tiers est inexistant :
  • Lors de la phase de contrôle, ajouter par exemple dans un log d’anomalies les comptes inexistants et refuser l’import tant qu’un compte reste inconnu.
  • ou créer automatiquement les comptes inexistants avant d’importer les écritures,
  • ou identifier les comptes inexistants et proposer à l’utilisateur compte par compte s’il souhaite qu’il soit créé automatiquement.
• En utilisant l’action creerPieceComptable vous n’êtes pas responsable du respect de l’équilibre des pièces comptables dans la comptabilité, cette action se chargeant de la vérification, néanmoins un contrôle en amont est à privilégier notamment si la logique de votre import exige que la totalité des pièces soit équilibrée avant d’autoriser l’import des écritures du fichier à importer.
• Le N° de pièce étant incrémenté automatiquement dans la comptabilité, le N° de pièce mentionné dans le fichier d’import ne sert qu’à regrouper des lignes d’écritures en pièces distinctes. Pour conserver une trace du N° de pièce d’origine, il est possible par exemple de le stocker dans la propriété reference de chaque ligne d’écriture.

Tous les fichiers d’exemple d’import

Structure des fichiers d’import

Les fichiers exemple d’import ont tous la même structure :

• Fichiers délimités avec chaque colonne séparée par une tabulation.
• Chaque ligne contient 11 colonnes.
• Le regroupement des lignes par pièce est déterminé par des valeurs identiques du groupe de colonnes Jou, Date, N°.
• Les données du fichier sont compatibles avec le contexte de la société BIJOU.
• Les fichiers peuvent être utilisés avec Exemples / Projet d’application en C# .NET + JavaScript

Ecritures de ventes avec la dernière pièce en erreur

Ecritures de banques avec journal centralisation et journal sans centralisation

Ecritures de différents journaux sans aucune erreur

Ecritures de différents journaux toutes en erreur

Ecritures de factures d’avoir

Ecritures de ventes volumineux