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 Comptabilité vers Sage Moyens de paiement.

Application source	Application de destination	
APISoft Comptabilité V 4	Sage Moyens de paiement 	

Données pouvant être récupérées :
-	Les comptes généraux
-	Les comptes tiers
-	Les échéances à régler

Données pouvant être récupérées dans API 
-	Les écritures de règlements

Pour pouvoir récupérer les données correctement, veuillez lire attentivement les consignes données et respecter l'ordre des étapes indiqué. Ce document décrit le mode opératoire pour la récupération d'éléments entre Comptabilité API et Sage Moyens de paiement.

Important ! Par défaut les factures clients sont affectées en mode de règlement Remises de chèques (Débit) Virements émis (Crédit) pour les fournisseurs (ces paramètres sont modifiables). L’application API ne permettant pas d’exporter le mode de règlement.

Le tableau ci-dessous vous récapitule le lieu de stockage des différents fichiers de récupération des données.

Nom de fichier	Chemin	Description	
Exemple API.mdp / Exemple API.mae	[Documents partagés]\Sage\iMoyens de paiement\Modèles d’importation\API	Bases Moyens de paiement prêtes à l’emploi	
Import comptes généraux API.ema	[Documents partagés]\Sage\iMoyens de paiement\Modèles d’importation\API	Fichier d’import paramétrable pour les comptes généraux et tiers	
Import écritures API.ema	[Documents partagés]\Sage\iMoyens de paiement\Modèles d’importation\API	Fichier d’import paramétrable pour les écritures	
Import coordonnées tiers API.ema	[[Documents partagés]\Sage\iMoyens de paiement\Modèles d’importation\API	Fichier d’import paramétrable pour les adresses des comptes tiers	
Export écritures MDP.emd	[[Documents partagés]\Sage\iMoyens de paiement\Modèles d’importation\API	Fichier d’export paramétrable pour créer les   écritures de règlement pour API	
ExportEcrituresAPI.txt / RgltMDP.TXT / ExporttiersAPI.txt / ExportComptesAPI.txt	[[Documents partagés]\Sage\iMoyens de paiement\Modèles d’importation\API	Fichiers d’exemples	

Exportation des données à partir de APISoft Comptabilité
1.	Exportation des comptes généraux
2.	Exportation des comptes tiers
3.	Exportation des écritures à régler

Opération à réaliser dans Sage Moyens de paiement
4.	Ouvrir le fichier Exemple API livré avec Sage Moyens de Paiement
5.	Création des codes journaux à l’identique du produit API 
6.	Création des banques
7.	Importation des comptes généraux,
8.	Importation des adresses des comptes clients et fournisseurs
9.	Importation écritures comptables des journaux d’achat et vente pour créer automatiquement les échéances correspondantes dans Sage Moyens de Paiement.

Exportation des écritures de règlement à partir  Sage Moyens de paiement
10.	Après traitement des échéances (impression des bordereaux de remises, génération des fichiers magnétiques…) exportation des écritures de règlement.

Importation dans API
11.	Importation des écritures de règlement.
Exports des données à partir de APISoft Comptabilité
Dans Comptabilité API, vous allez dans un premier temps exporter les éléments à récupérer en passant par le menu "Utilitaires / Export / Export des données"……….

1.	Export des comptes généraux

Depuis Comptabilité API, allez dans le menu "Utilitaires / Export / Export des données
/ Export paramétrable".
Dans le champ « Nom de l’export », saisissez «COMPTES GENERAUX».
Parmi les « Tables à exporter », choisissez "PLANCP" et cliquez sur le bouton "Valider". Dans le champ « Type d’export », choisissez «ASCII Délimité ».
Dans le champ « Nom du fichier à générer », saisissez «ExportComptesAPI.txt».
Dans le champ « Enregistrement d’entête », sélectionnez «Non».
Dans le champ « Séparateurs», saisissez « ;»
Dans le champ « Suppression des espaces », sélectionnez «Non».

Dans la liste des champs, cliquez alternativement deux fois sur /

Champ APISoft	Equivalence Sage Comptabilité	
Compte	N°compte	
Nom	Intitulé	

A ce stade, vous allez enregistrez votre modèle d’export en cliquant sur le bouton « Valider »
Dans le champ « Nom de l’export », sélectionnez « COMPTES GENERAUX» que vous venez d’enregistrer.
Cliquez sur le bouton « Exporter » et répondez « Oui » au message Souhaitez-vous lancer la procédure d’exportation qui vous est proposé puis « Oui » au message de fin.

Restez dans la fenêtre « Export de données » pour la suite

2.	Export des comptes tiers

Dans le champ « Nom de l’export », remplacez « COMPTES GENERAUX » par «EXPORTTIERSAPI ».
Parmi les « Tables à exporter », remplacez "PLANCP" par « PLANTIERS » et cliquez sur le bouton "Valider".
Dans le champ « Nom du fichier à générer », saisissez «ExporttiersAPI.txt».

Gardez les champs « Type d’export », « Enregistrement d’entête », « Séparateurs » et « Suppression des espaces » inchangés.

Dans la liste des champs, cliquez alternativement deux fois sur «

Champ APISoft	Equivalence Sage Comptabilité	
Compte	Numéro de compte	
Adresse	Adresse	
Code postal	Code postal	
Ville	Ville	
Pays	Pays	
Identifiant	N° identifiant	
Domiciliation	Intitulé de la banque	
Etablissement	Code banque	
Guichet	Code guichet	
Compte bancaire	N° de compte	
Clé Rib	Clé	
Compte (une seconde fois)	Numéro de compte	

A ce stade, vous allez enregistrez votre modèle d’export en cliquant sur le bouton « Valider »
Dans le champ « Nom de l’export », sélectionnez « EXPORTTIERSAPI» que vous venez d’enregistrer.
Cliquez sur le bouton « Exporter » et répondez « Oui » au message Souhaitez-vous lancer la procédure d’exportation qui vous est proposé puis « Oui » au message de fin.

3.	Export des écritures comptables

Dans le champ « Nom de l’export », remplacez «EXPORTTIERSAPI» par « EXPORTECRITURESAPI ».
Parmi les « Tables à exporter », remplacez " PLANTIERS  " par « ECRITURES» et cliquez sur le bouton "Valider".
Dans le champ « Nom du fichier à générer », saisissez « ExportEcrituresAPI.txt»

Gardez les champs « Type d’export », « Enregistrement d’entête », « Séparateurs » et « Suppression des espaces » inchangés.

Dans la liste des champs, cliquez alternativement deux fois sur :

Champ APISoft	Equivalence Sage Comptabilité	
Journal	Code journal	
Date	Date	
Date (une seconde fois)	Date échéance	
Référence	Référence	
Pièce	N° pièce	
Compte	Numéro de compte	
Montant	Montant	
Sens	Débit ou crédit	
Libellé écriture	Libellé écriture	

Cliquez ensuite sur le bouton filtre, il est nécessaire d’exporter uniquement vos journaux d’achats et de ventes, complétez le filtre en ajoutant un critère de date ou en sélectionnant uniquement les écritures non lettrées, veuillez consultez votre manuel API pour de plus amples précisions.
A ce stade, vous allez enregistrez votre modèle d’export en cliquant sur le bouton « Valider »
Dans le champ « Nom de l’export », sélectionnez « EXPORTECRITURESAPI » que vous venez d’enregistrer.
Cliquez sur le bouton « Exporter » et répondez « Oui » au message Souhaitez-vous lancer la procédure d’exportation qui vous est proposé puis « Oui » au message de fin.

Imports SAGE L100

1.	Ouverture du fichier exemple pour API
Depuis Sage Moyens de paiement, dans le menu « Fichier / Ouvrir » sélectionner les fichiers « Exemple API.mdp » et « Exemple API.mae »
Remarque : vous pouvez bien entendu les renommer en leur donnant le nom de votre société.
2.	Création des codes journaux
Depuis Sage Moyens de paiement, dans le menu « Structure / Code journaux » créer les journaux à l’identique de votre application API.
3.	Création des banques
Depuis Sage Moyens de paiement, dans le menu « Structure / Banques» créer les banques en indiquant leurs coordonnées et en leur affectant un code journal.
4.	Import des comptes généraux
Depuis Sage Moyens de paiement, dans le menu " Fichier / Format import/export paramétrable / Importer ",
Sélectionnez et ouvrez le modèle " Import comptes généraux API.ema "

Dans la fenêtre "Ouvrir le fichier d'import", sélectionnez le fichier «ExportcomptesAPI.txt» que vous aviez créé lors de l'export des comptes depuis API afin de démarrer l'importation.

5.	Import des coordonnées des comptes tiers (adresse, banque…)
Depuis Sage Moyens de paiement, dans le menu " Fichier / Format import/export paramétrable / Importer ",
Sélectionnez et ouvrez le modèle " Import coordonnées Tiers API.emd "

Dans la fenêtre "Ouvrir le fichier d'import", sélectionnez le fichier «ExporttiersAPI.txt» que vous aviez créé lors de l'export des comptes depuis API afin de démarrer l'importation.

Remarque : API ne permet pas d’exporter les coordonnées des comptes tiers (Adresse, banque…) et la désignation du compte correspondant. La procédure d’importation décrite récupère en désignation le numéro de compte. Il sera nécessaire d’ajuster en conséquence les désignations ainsi créées.

6.	Importation des écritures comptables.
Depuis Sage Moyens de paiement, dans le menu " Fichier / Format import/export paramétrable / Importer ", ouvrez le modèle " Import écritures API.ema".

Dans la fenêtre "Ouvrir le fichier d'import", sélectionnez le fichier « ExportecrituresAPI.txt ».que vous aviez attribué lors de l'export des écritures depuis API
Exports dans Sage Moyens de paiement

7.	Export des écritures de règlement de Sage Moyens de paiement
Une fois les écritures remises en banque, depuis Sage Moyens de paiement, dans le menu « Traitement / Mise à jour de la comptabilité », cliquer sur le bouton « Exporter » puis choisir « Export paramétrable »,
Sélectionnez et ouvrez le modèle « Export écritures MDP.emd»,
Indiquez  un nom de fichier, par exemple « RGLTMDP.TXT»

Imports dans API
8.	Import des écritures de règlement dans Ciel Compta

Il est nécessaire au préalable de définir un format d’importation dans API, le modèle ainsi défini sera réutilisé à chaque importation des écritures de règlement générées à partir de Moyens de paiement.
Depuis Comptabilité API, allez dans le menu « Utilitaires / Import des données », 
Dans le champ, Paramétrage, saisissez « IMPORTREGLEMENTMDP »,
Dans le champ « Séparateurs», saisissez « ;»
Dans le champ « Convers. Caractère », laissez à Oui,
Dans le champ « Nom fichier écriture », saisissez «RGLTMDP.TXT»,
Dans le champ « Format Date », sélectionnez 1 - JJMMAA
Dans le champ « Type montant », sélectionnez 3 – Un champ montant et un champ sens »,
Dans le champ « Sens crédit », indiquez « C »

Dans la partie gauche de l’écran, veuillez indiquer les positions suivantes
Nom des rubriques	Position	
Journal	1	
Pièce	7	
Compte	3	
Date	2	
Libmanu	4	
Montant	6	
Sens	5	

A ce stade, vous allez enregistrez votre modèle d’importation en cliquant sur le bouton « Valider »
Dans le champ « Paramétrage », sélectionnez « IMPORTRGLTMDP » que vous venez d’enregistrer.
Cliquez sur le bouton « Importer » et sélectionnez le fichier généré à partir de Moyens de paiement RGLTMDP.TXT à partir de la zone « Fichier Ecriture ».
Confirmez ensuite l’importation du fichier spécifié.