Procédures de récupération de données API

Ce document vous décrit le mode opératoire pour la récupération des données APISoft Gestion Commerciale vers Sage Gestion Commerciale 100/30.

Application source	Application de destination	
APISost Gestion Commerciale V 4	Sage Gestion Commerciale 100 V 16.01	
	Sage Gestion Commerciale 30 V 16.01	

Données pouvant être récupérées :
-	Les clients
-	Les fournisseurs
-	Les familles d’articles
-	Les articles
-	Les tarifs de vente
-	Les tarifs fournisseurs
-	Les documents

Pour pouvoir récupérer les données correctement, veuillez lire attentivement les consignes données et respecter l'ordre des étapes indiqué. En effet, certaines données font référence à d'autres. Ce qui implique nécessairement une importation préalable des données liées. Par exemple, pour pouvoir importer les tarifs fournisseurs, il est nécessaire d'importer ou de créer préalablement les articles et les fournisseurs.

Pour réussir la récupération de vos données, veuillez respecter l'ordre des opérations suivantes.

Exportation des données à partir de APISoft Gestion Commerciale
1.	Exportation des clients
2.	Exportation des fournisseurs
3.	Exportation des familles d’articles
4.	Exportation des articles
5.	Exportation des tarifs de vente
6.	Exportation des tarifs fournisseurs
7.	Exportation des documents

Opération à réaliser dans Sage Ligne 100/30
8.	Création des fichiers comptable et commercial en renseignement les paramètres et les options nécessaires à l'exploitation.
9.	Importation ou création des données comptables (Comptes généraux, etc…)
10.	Importation des clients
11.	Importation des fournisseurs
12.	Importation des familles d’articles
13.	Importation des articles
14.	Importation des tarifs de vente
15.	Importation des tarifs fournisseurs
16.	Importation des documents

Exportation des données à partir de APISoft Gestion Commerciale

L’exportation des données commerciales s’effectue à partir de la fonction Export du menu Utilitaire de APISoft Gestion commerciale. Nous vous décrivons les paramètres à définir et les champs définis dans les fichiers Formats d’import paramétrables installés par défaut par Sage Gestion Commerciale 100/30. Si vous modifiez l’ordre ou la liste des données à récupérer dans APISoft Gestion Commerciale, il faudra modifier impérativement les formats d’import paramétrable en conséquence.

Les paramètres des fichiers d’export à définir dans APISOft Gestion Commerciale sont les suivants :

-	Type d’export : ASCII Délimité
-	Enregistrement d’entête : Non
-	Séparateur : ; (Point virgule)
-	Nom du Fichier à générer : indiquer ici le chemin et le nom du fichier des données exporté (au format txt)

1.	Exportation des clients

Table à exporter : CLIENT

Champ
Sage Gestion Commerciale	 Champ APISoft	Commentaire	
N° compte client 	Code		
Intitulé 	Nom		
N° compte collectif 	Compte comptable		
Qualité 	Civilité		
Contact 	Interlocuteur		
Adresse 	Adresse		
Complément adresse 	Adresse suite		
Code postal 	Code postal		
Ville 	Ville		
Pays 	Pays		
N° identifiant 	Identification		
Téléphone 	Téléphone		
Télécopie 	Télécopie		
E-mail 	E-Mail		
Site 	Site internet		
Catégorie comptable 	Catégorie de vente		
Intitulé banque 	Domiciliation		
Code banque 	Etablissement		
Code guichet 	Guichet		
Numéro de compte banque	Compte banque		
Clé RIB 	Clé RIB		
Intitulé livraison 	LivNom		
Adresse livraison 	Adresse (Livraison)		
Complément livraison 	Adresse suite (Livraison)		
Code postal livraison 	Code postal (Livraison)		
Ville livraison 	Ville (Livraison)		
Pays livraison	Pays (Livraison)		
Catégorie tarifaire 	Tarif		
Taux remise 	PRemise		
Taux escompte 	PEscompte		

2.	Exportation des fournisseurs

Table à exporter : FOURNISSEUR

Champ
Sage Gestion Commerciale	 Champ APISoft	Commentaire	
N° compte fournisseur 	Code		
Intitulé 	Nom		
N° compte collectif 	Compte		
Qualité 	Civilité		
Contact 	Correspondant		
Adresse 	Adresse		
Complément adresse 	Adresse suite		
Code postal 	Code postal		
Ville 	Ville		
Pays 	Pays		
Téléphone 	Téléphone		
Télécopie 	Fax		
E-mail	E-Mail		
Site 	SiteInternet		
Catégorie comptable 	Catégorie Achat		
Intitulé banque 	Domiciliation		
Code banque	Etablissement		
Code guichet 	Guichet		
Numéro de compte 	Compte bancaire		
Clé RIB 	Clé Rib		
Taux remise 	PRemise		
Taux escompte 	PEscompte		

3.	Exportation des familles d’articles

Table à exporter : FAMILLEARTICLE

Champ
Sage Gestion Commerciale	 Champ APISoft	Commentaire	
Code	Code		
Intitulé	Libellé		
Unité de vente	Unité vente		
Suivi stock	Gestion stock		
Coefficient	Coefficient		

4.	Exportation des articles

Table à exporter : ARTICLE

Champ
Sage Gestion Commerciale	 Champ APISoft	Commentaire	
Référence	Code		
Désignation	Libellé		
Famille	Famille		
Prix d’achat	Dernier prix d’achat		
Coefficient	Coefficient		
Prix de vente	Prix base HT		
Unité vente	Unité vente		
Poids net	Poids		
Poids brut	Poids brut		
Code barres	Code barre		
Suivi stock	Gestion de stock		

5.	Exportation des tarifs de vente

Table à exporter : TARIF

Champ
Sage Gestion Commerciale	 Champ APISoft	Commentaire	
Référence article	Code article		
Coefficient (Indice)	Coefficient		
Prix de vente (Indice)	Prix		
Inutilisé	Tarif	Filtre de sélection dans APISoft : Exemple : ajouter le filtre Tarif = 1 pour le premier tarif.

Générer un fichier pour chaque tarif.

6.	Exportation des tarifs fournisseurs

Table à exporter : FOURNISSEURARTICLE

Champ
Sage Gestion Commerciale	 Champ APISoft	Commentaire	
Référence article	CodeArticle		
N° fournisseur	CodeFournisseur		
Référence frs	Référence		
Principal	Principal		
Prix d’achat	PrixAchat		
Unité d’achat	Unité d’achat		

7.	Exportation des documents

Table à exporter : LIGNESDEVIS

Champ
Sage Gestion Commerciale	 Champ APISoft	Commentaire	
N° pièce	Code Document		
Date	Date		
Tiers	Code Client		
Référence article	Code Article		
Désignation	Libellé Article		
Prix unitaire	Prix Unitaire		
Quantité	Quantité		
Poids net global	Poids		
Remise	Remise		
Prix revient unitaire	Prix de revient unitaire		
Taux taxe 1	Taux TVA		
Taux taxe 2	TauxTvaTPF1		
Dépôt	Depot		
Type document		Champ non présent dans le fichier d’import servant à identifier le type de données à importer. La valeur par défaut doit être modifiée pour chaque type de document.

Exemple : La valeur par défaut pour les lignes de devis est 0.	

Création du fichier commerciale dans Sage Gestion Commerciale 100/30

Pour pouvoir importer les données dans Sage Gestion Commerciale 100/30, il est nécessaire de créer préalablement le fichier commercial dans Sage Gestion Commerciale 100/30 et définir les options de votre dossier.

-	Catégories tarifaires pour les tarifs articles
-	Catégories comptables de vente et d’achat pour la définition de la passerelle comptable de vente et d’achat
-	Unité de vente et d’achat
-	Devises
-	Etc…

Veuillez vous réferer au manuel de référence pour plus de précisions sur les différentes options à créer.
Importation des données dans Sage Gestion Commerciale 100/30
L’importation des données dans Sage Gestion Commerciale 100/30 s’effectue à partir de la fonction Importer/Format paramétrable du menu Fichier. Les données doivent être importées dans l’ordre suivant :

-	Importation des clients
-	Importation des fournisseurs
-	Importation des familles d’articles
-	Importation des articles
-	Importation des tarifs de vente
-	Importation des tarifs fournisseurs
-	Importation des documents

Remarque : Si les données à importer font référence à des données comptables (Comptes généraux, taux de taxes, etc…), il est nécessaire d’importer au préalable ces données ou de les créer dans le fichier de destination avant de procéder à l’importation des données commerciales.

Particularités
L’importation des données au format paramétrable permet de transformer les comptes généraux de racine 401, 411 et 4210 en comptes collectifs 401000000, 411000000 et 421000000 et de créer les tiers avec les autres caractères du N° initial.

Exemple : A partir des comptes API 401DUPOND et 401MARTIN, on retrouvera en comptabilité 100 le compte collectif 401000000 et les tiers de type fournisseur DUPOND et MARTIN.

Dans ce cadre, il est impératif de vérifier le plan de comptes API afin de référencer d’éventuels doublons issus de clients et fournisseurs ayants le même N°, hors racine.
(401DUPOND et 411DUPOND par exemple). Dans ce cas, le paramétrage de reprise des comptes doit être modifié dans Sage Comptabilité 100/30 ou Sage Gestion Commerciale 100/30 .

Avant toute opération, vérifiez si parmi vos comptes, il existe des tiers ayant le même numéro. Exemple 401DUPOND et 411DUPOND, ce qui obligerait un paramétrage spécifique en import Sage L100/30. Il est nécessaire d’utiliser les mêmes paramètres de conversion et d’affectation des comptes dans Sage Comptabilité 100/30 et Sage Gestion Commerciale 100/30.

Pour procéder à l’importation des données commerciales, veuillez procéder comme suit :

-	Ouvrir le fichier de gestion dans Sage Gestion Commerciale
-	Lancer la fonction Importer/Format paramétrable
-	Sélectionner le format paramétrable correspondant aux données à importer

Nom de fichier	Chemin	Description	
Import articles API.egc	[Documents partagés]\Sage\Gestion commerciale\Modèles d’importation\API	Fichier d’import paramétrable pour les articles	
Import clients API.egc	[Documents partagés]\Sage\Gestion commerciale\Modèles d’importation\API	Fichier d’import paramétrable pour les clients	
Import familles d'articles API.egc	[Documents partagés]\Sage\Gestion commerciale\Modèles d’importation\API	Fichier d’import paramétrable pour les familles d’articles	
Import fournisseurs API.egc	[Documents partagés]\Sage\Gestion commerciale\Modèles d’importation\API	Fichier d’import paramétrable pour les fournisseurs	
Import lignes de devis API.egc	[Documents partagés]\Sage\Gestion commerciale\Modèles d’importation\API	Fichier d’import paramétrable pour les devis	
Import tarifs fournisseurs API.egc	[Documents partagés]\Sage\Gestion commerciale\Modèles d’importation\API	Fichier d’import paramétrable pour les tarifs fournisseurs	
Import tarifs ventes API.egc	[Documents partagés]\Sage\Gestion commerciale\Modèles d’importation\API	Fichier d’import paramétrable pour les tarifs de ventes	

-	Sélectionner le fichier texte correspondant aux données à importer généré par APISoft Gestion Commerciale

Attention ! la structure des bases de données est différente entre les deux logiciels. Les fichiers de paramètres d'import contiennent les données ayant une correspondance logique entre APISoft Gestion Commerciale et Sage Gestion Commerciale 100/30. Si vous modifiez les paramètres d’export que nous vous décrivons, il est nécessaire de modifier les fichiers Format d’import paramétrable en conséquence. Pour les champs ayant une correspondance, il est indispensable de vérifier que le paramètrage effectué par défaut est adapté aux options de votre société. Dans le cas contraire, il est nécessaire de le modifier avant de procéder à l’importation des données.

Si la codification de vos données à importer comporte des caractères non acceptés par Sage Ligne 100/30 (Exemple des points dans les numéros de tiers), il est nécessaire de supprimer ces caractères ou de les remplacer par d’autres avant de procéder à l’importation.