43
Sage 100 Webservices Version 15.50 Installation

Version 15.50 Installation - FGS Conseils - Centre de ...€¦ · Compte tenu des contraintes inhérentes à la présentation sous forme de manuel ... Sage 30, Sage 100, Intégrale,

Embed Size (px)

Citation preview

Page 1: Version 15.50 Installation - FGS Conseils - Centre de ...€¦ · Compte tenu des contraintes inhérentes à la présentation sous forme de manuel ... Sage 30, Sage 100, Intégrale,

Sage 100

Webservices

Version 15.50

Installation

Page 2: Version 15.50 Installation - FGS Conseils - Centre de ...€¦ · Compte tenu des contraintes inhérentes à la présentation sous forme de manuel ... Sage 30, Sage 100, Intégrale,

© Sage

Composition du progiciel

Votre progiciel est composé d'un boîtier de rangement comprenant :

le cédérom sur lequel est enregistré le programme,

la documentation électronique, présente sur le cédérom.

Propriété & Usage

Tout usage, représentation ou reproduction intégral ou partiel, fait sans le consentement de Sage est illicite (Loi du 11 Mars 1957 - Loi du 3

Juillet 1985). Ils constitueraient une contrefaçon sanctionnée par les articles 425 et suivants du Code Pénal.

Tous droits réservés dans tous pays.

Logiciel original développé par Sage. Documentation Sage.

Toute utilisation, à quelque titre que ce soit, non autorisée dans le cadre de la convention de licence, est strictement interdite sous peine de sanc-

tions pénales (Loi du 3 Juillet 1985, Art. 46).

Conformité & Mise en garde

Compte tenu des contraintes inhérentes à la présentation sous forme de manuel électronique, les spécifications visées dans la présente docu-

mentation constituent une illustration aussi proche que possible des spécifications. Il appartient au client, parallèlement à la documentation, de

mettre en œuvre le progiciel pour permettre de mesurer exactement l'adéquation de ses besoins aux fonctionnalités. Il est important, pour une

utilisation sûre et opérationnelle du progiciel, de lire préalablement la documentation.

Evolution

La documentation correspond à la version référencée. Entre deux versions, des mises à jour du logiciel peuvent être opérées sans modification

de la documentation. Toutefois, un additif peut être joint à la documentation existante pour présenter les modifications et améliorations appor-

tées à ces mises à jour.

La fiche Suggestion

Sage recherche une constante amélioration du progiciel et de sa documentation. Nous invitons notre clientèle à nous faire parvenir ses sugges-

tions et les éventuels défauts ou erreurs qu'elle pourrait relever sur la fiche suggestion figurant en dernière page du manuel.

Marques

Start, Sage 30, Sage 100, Intégrale, et Sage 1000 sont des marques déposées appartenant à Sage.

Windows 2000, Windows 2003 Server, Windows XP, Windows Vista, les logiciels Microsoft Excel, Microsoft Word, Microsoft Outlook, Inter-

net Explorer et gamme Office sont des marques déposées de Microsoft Corporation.

Macintosh, MAC/OS sont des marques déposées de Apple Computer Inc.

SAGE SAS - Société par Actions Simplifiée au capital social de 500.000 euros

Siège social : 10, rue Fructidor 75017 Paris - 313 966 129 R.C.S. Paris - Code APE 722 A

Sage est locataire gérante des sociétés Adonix Applications et Services, Adonix et Sage Coala.

Page 3: Version 15.50 Installation - FGS Conseils - Centre de ...€¦ · Compte tenu des contraintes inhérentes à la présentation sous forme de manuel ... Sage 30, Sage 100, Intégrale,

Sommaire

© Sage 3

Sommaire

Généralités sur Sage 100 Webservices_____________________ 5

Définition de Sage 100 Webservices _______________________ 6

Architecture de fonctionnement____________________________ 7

Données mises en relation__________________________________ 8

Real Time Data View_______________________________________11

Services de prix ____________________________________________13

Installation de Sage 100 Webservices_____________________14

Pré requis obligatoires_____________________________________15

Installation _________________________________________________17

Paramétrage des composants de Sage 100

Webservices________________________________________________21

Service Sage Serveur Web_________________________________22

Configuration des sociétés Sage 100______________________27

Description des entités ____________________________________35

Catégorie tarifaire / PricingList ____________________________36

Famille / ProductFamily ____________________________________36

Conditionnement / UOMFamily_____________________________37

Enuméré de conditionnement article / UOM_______________37

Article / NewProduct _______________________________________37

Page 4: Version 15.50 Installation - FGS Conseils - Centre de ...€¦ · Compte tenu des contraintes inhérentes à la présentation sous forme de manuel ... Sage 30, Sage 100, Intégrale,

Sommaire

4 © Sage

Tarif article / Pricing _______________________________________ 38

Client-Fournisseur / Account ______________________________ 38

Adresse Client-Fournisseur / Address _____________________ 39

Lieu de livraison Client / Address__________________________ 39

Téléphone Client-Fournisseur / Phones____________________ 40

Télécopie Client-Fournisseur / Phones ____________________ 40

Email Client-Fournisseur / Email___________________________ 40

Contact Client-Fournisseur / Person_______________________ 41

Représentant / Representant ______________________________ 41

Devis / Quote _______________________________________________ 41

Bon de commande / Order _________________________________ 42

Ligne de document d’un Devis / QuoteItems ______________ 43

Ligne de document d’un Bon de commande /

OrderItems _________________________________________________ 43

Page 5: Version 15.50 Installation - FGS Conseils - Centre de ...€¦ · Compte tenu des contraintes inhérentes à la présentation sous forme de manuel ... Sage 30, Sage 100, Intégrale,

Généralités sur Sage 100 Webservices

© Sage 5

Généralités sur Sage 100

Webservices

Définition de Sage 100 Webservices _______________________ 6

Architecture de fonctionnement____________________________ 7

Données mises en relation__________________________________ 8

Entités principales ................................................................................................. 9

Sous entités......................................................................................................... 10

Real Time Data View_______________________________________11

Services de prix ____________________________________________13

Page 6: Version 15.50 Installation - FGS Conseils - Centre de ...€¦ · Compte tenu des contraintes inhérentes à la présentation sous forme de manuel ... Sage 30, Sage 100, Intégrale,

Généralités sur Sage 100 Webservices

6 © Sage

Définition de Sage 100 Webservices

Sage 100 Webservices est une application permettant de publier les données des bases Sage 100

Gestion commerciale en vue d’une synchronisation avec les données des bases Sage CRM. Les

données exposées par Sage 100 Webservices concernent, les catégories tarifaires, les familles, les

articles, les clients et fournisseurs, les représentants ainsi que les documents de vente de type Devis et

Bon de commande.

Sage 100 Webservices implémente également certaines fonctionnalités permettant à Sage CRM,

d’afficher des données des bases Sage 100 en temps réel : Real Time Data View et Services de prix.

La synchronisation des données entre Sage 100 et Sage CRM ainsi que l’exploitation des fonctions

temps réel ne peuvent être réalisés qu’après la création d’une intégration à partir de Sage CRM.

Ce manuel décrit la procédure d’installation et la configuration des composants installés par Sage 100

Webservices. Les thèmes se rapportant à la configuration et au fonctionnement du service

d’intégration de Sage CRM ne sont pas abordés dans ce manuel. Ces points sont traités dans le manuel

intitulé FR_Guide de l’intégration Sage 100 de l’utilisateur et de l’administration de Sage CRM

6.1.pdf stocké dans le répertoire Sage\Documentation du cd-rom de Sage CRM.

Page 7: Version 15.50 Installation - FGS Conseils - Centre de ...€¦ · Compte tenu des contraintes inhérentes à la présentation sous forme de manuel ... Sage 30, Sage 100, Intégrale,

Généralités sur Sage 100 Webservices

© Sage 7

Architecture de fonctionnement

Sage 100 Webservices permet de synchroniser les données entre les bases de données de Sage 100

Gestion commerciale et les bases de données Sage CRM.

Pour l’utilisateur, cela se traduit par :

La création de sociétés permettant de définir les fichiers Sage 100 Comptabilité (*.mae) et Sage

100 Gestion commerciale (*.gcm) à utiliser.

Sous Sage CRM, la création d’une ou plusieurs intégrations permettant de mettre en relation, les

sociétés Sage 100 préalablement créées avec la base de données Sage CRM.

Page 8: Version 15.50 Installation - FGS Conseils - Centre de ...€¦ · Compte tenu des contraintes inhérentes à la présentation sous forme de manuel ... Sage 30, Sage 100, Intégrale,

Généralités sur Sage 100 Webservices

8 © Sage

Données mises en relation

Les données ou entités mises en relation entre Sage 100 Gestion commerciale et Sage CRM sont les

suivantes :

Catégories tarifaires,

Familles,

Articles,

Clients et fournisseurs,

Représentants,

Devis et bons de commande.

Une entité représente une abstraction élémentaire de données provenant d’un progiciel.

L’entité représentant n’existe pas par défaut dans la base Sage CRM. Cette entité est publiée dans la base CRM lors de la création d’une intégration.

Le mappage entre les entités Sage 100 et les entités Sage CRM ainsi que le détail des types de

synchronisation supportés sont décrits ci-après.

Page 9: Version 15.50 Installation - FGS Conseils - Centre de ...€¦ · Compte tenu des contraintes inhérentes à la présentation sous forme de manuel ... Sage 30, Sage 100, Intégrale,

Généralités sur Sage 100 Webservices

© Sage 9

Entités principales

Entité Sage 100 Entité Sage CRM Création Modification Suppression

Catégorie tarifaire PricingList Sage 100 vers

Sage CRM

Sage 100 vers

Sage CRM

Impossible

Conditionnement UOMFamily Sage 100 vers

Sage CRM

Sage 100 vers

Sage CRM

Impossible

Famille ProductFamily Sage 100 vers

Sage CRM

Sage 100 vers

Sage CRM

Impossible

Article NewProduct Sage 100 vers

Sage CRM

Sage 100 vers

Sage CRM

Impossible

Client / Fournisseur Account Bidirectionnelle Bidirectionnelle Sage CRM vers

Sage 100

Représentant Representant Sage 100 vers

Sage CRM

Sage 100 vers

Sage CRM

Impossible

Devis client Quote Sage CRM vers

Sage 100

Impossible Impossible

Bon de commande

client

Order Sage CRM vers

Sage 100

Impossible Impossible

Les clients et Fournisseurs pour lesquels l’option « Mise en sommeil » est activée dans la base Sage 100, ne sont pas transmis à Sage CRM.

Les articles nomenclatures de type « Commerciale/composant » et « Commerciale/composé » ne sont pas transmis à Sage CRM.

Les articles à gammes de la base Sage 100 génèrent dans la base Sage CRM, autant d’articles qu’ils contiennent d’énumérés de gammes. Par exemple, un article à simple gamme composée de 3 énumérés génèrera 3 articles dans la base Sage CRM, un article à double gamme pour lesquelles la gamme 1 est composée de 5 énumérés et la gamme 2 est composée de 2 énumérés, générera 10 articles dans la base Sage CRM (5*2). Le code du produit Sage CRM d’un article à gamme sera construit à partir de la référence gamme de l’article Sage 100.

Page 10: Version 15.50 Installation - FGS Conseils - Centre de ...€¦ · Compte tenu des contraintes inhérentes à la présentation sous forme de manuel ... Sage 30, Sage 100, Intégrale,

Généralités sur Sage 100 Webservices

10 © Sage

Sous entités

Une sous entité représente une collection d’éléments associée à une entité principale (relation de 0 à

n). Par exemple, l’entité principale Devis, publie la sous entité Ligne de document permettant

d’accéder aux lignes du document. Les sous entités publiées dans le cadre de Sage 100 Webservices

sont les suivantes :

Sous Entité / Champ Sage 100

Entité Sage CRM

Création Modification Suppression

Enuméré de conditionnement article

UOM Sage 100 vers Sage CRM

Sage 100 vers Sage CRM

Impossible

Tarif article Pricing Sage 100 vers Sage CRM

Sage 100 vers Sage CRM

Impossible

Contact Client / Fournisseur Person Bidirectionnelle Bidirectionnelle Sage CRM vers Sage 100

Adresse de livraison Client Address Bidirectionnelle Bidirectionnelle Sage CRM vers Sage 100

Téléphone et Fax Client / Fournisseur

Phone Bidirectionnelle Bidirectionnelle Sage CRM vers Sage 100

Email Client / Fournisseur Email Bidirectionnelle Bidirectionnelle Sage CRM vers Sage 100

Ligne de document d’un Devis

QuoteItems Sage CRM vers Sage 100

Impossible Impossible

Ligne de document d’un Bon de commande

OrderItems Sage CRM vers Sage 100

Impossible Impossible

Page 11: Version 15.50 Installation - FGS Conseils - Centre de ...€¦ · Compte tenu des contraintes inhérentes à la présentation sous forme de manuel ... Sage 30, Sage 100, Intégrale,

Généralités sur Sage 100 Webservices

© Sage 11

Real Time Data View

Pour les Comptes Sage CRM de type Client synchronisés avec des Clients Sage 100, des informations

en lien direct avec les données des bases Sage 100 sont disponibles. Ces informations, appelées

RTDV (Real Time Data View) sont accessibles depuis les fiches des Comptes Sage CRM. Elles

permettent d’afficher les données suivantes :

Solvabilité : affiche les éléments de solvabilité de la fiche client Sage 100.

Cumuls : affiche le cumul des écritures comptables du client Sage 100.

Ecritures : affiche la liste des écritures comptables du client Sage 100.

Document commerciaux : affiche la liste des documents de vente saisis pour le client Sage 100.

Pour chacun des documents, il est possible d’accéder directement au détail des lignes qui le

composent à partir d’un lien hypertexte (fonction Drill Down).

Interrogation commerciale : affiche la liste des lignes de documents de vente saisis pour le client

Sage 100.

Pour les RTDV Documents commerciaux et Interrogation commerciale, des critères de sélection

permettant de filtrer les données ont été implémentés. Ces filtres sont disponibles pour les champs

suivants :

RTDV Documents commerciaux :

Nom Type Valeur Description

Date Fourchette de date Date du document comprise entre une date de début et une date de fin

DE Document de type Devis

BC Document de type Bon de commande

PL Document de type Préparation de livraison

BL Document de type Bon de livraison

BR Document de type Bon de retour

BA Document de type Bon d’avoir

FA Document de type Facture (standard, retour et avoir)

FC Document de type Facture comptabilisée

Type Liste

Tout Document de type Devis à Facture comptabilisé

Page 12: Version 15.50 Installation - FGS Conseils - Centre de ...€¦ · Compte tenu des contraintes inhérentes à la présentation sous forme de manuel ... Sage 30, Sage 100, Intégrale,

Généralités sur Sage 100 Webservices

12 © Sage

RTDV Interrogation commerciale :

Nom Type Valeur Description

Date Fourchette de date Date de la ligne de document comprise entre une date de début et une date de fin

DE Ligne de document de type Devis

BC Ligne de document de type Bon de commande

PL Ligne de document de type Préparation de livraison

BL Ligne de document de type Bon de livraison

BR Ligne de document de type Bon de retour

BA Ligne de document de type Bon d’avoir

FA Ligne de document de type Facture (standard, retour et avoir)

FC Ligne de document de type Facture comptabilisée

Type Liste

Tout Ligne de document de type Devis à Facture comptabilisé

No de pièce Chaîne alphanumérique majuscule : 8 car. max.

Numéro de pièce de la ligne de document

Référence article Chaîne alphanumérique majuscule : 18 car. max.

Référence article de la ligne de document

Page 13: Version 15.50 Installation - FGS Conseils - Centre de ...€¦ · Compte tenu des contraintes inhérentes à la présentation sous forme de manuel ... Sage 30, Sage 100, Intégrale,

Généralités sur Sage 100 Webservices

© Sage 13

Services de prix

Sage CRM dispose de son propre système de gestion de tarifs pour les produits (articles dans Sage

100). Cependant, lors de la saisie de devis ou bons de commande pour des Comptes Sage CRM

(synchronisés ou non avec des Clients Sage 100), il est possible de faire appel à des services de

tarification permettant de retourner les informations de valorisation telles qu’elles sont dans Sage 100

Gestion commerciale.

Ainsi, lors de la saisie d’une ligne de produit, le service « Contrôle du prix » permet de récupérer le

tarif Sage 100 (prix, remise et taxe) en fonction du produit sélectionné, de la quantité et du Compte

(client dans Sage 100) sur lequel le document est créé.

Page 14: Version 15.50 Installation - FGS Conseils - Centre de ...€¦ · Compte tenu des contraintes inhérentes à la présentation sous forme de manuel ... Sage 30, Sage 100, Intégrale,

Installation de Sage 100 Webservices

14 © Sage

Installation de Sage 100

Webservices

Pré requis obligatoires_____________________________________ 15

Configuration........................................................................................................15 Matériel ................................................................................................................15 Compatibilité ........................................................................................................16

Installation _________________________________________________ 17

! Bienvenue.......................................................................................................................17

Cette partie du manuel décrit la procédure d’installation de Sage 100 Webservices. Veuillez respecter

les consignes données sous le titre Pré Requis obligatoires avant d’installer Sage 100 Webservices.

Le non respect de ces consignes pourrait, dans certains cas, entrainer l’apparition de messages à

l’installation.

Page 15: Version 15.50 Installation - FGS Conseils - Centre de ...€¦ · Compte tenu des contraintes inhérentes à la présentation sous forme de manuel ... Sage 30, Sage 100, Intégrale,

Installation de Sage 100 Webservices

© Sage 15

Pré requis obligatoires

L’installation de Sage 100 Webservices doit être réalisée à partir d’un compte utilisateur Windows

disposant des droits Administrateur sur la machine. Le programme d’installation se trouve dans le

répertoire Sage100WS stocké à la racine cd-rom de Sage CRM6.1 version Française.

Configuration

L’environnement d’installation doit être au minimum Microsoft Windows 2000.

Remarque : Sage 100 Webservices n’est pas compatible avec les environnements Microsoft Windows

95, 98, Millenium et NT.

Pour que Sage 100 Webservices puisse accéder aux bases de données Sage 100 en cours d’utilisation

par d’autres postes clients, il est nécessaire d’installer la partie client de Sage 100 Serveur sur le poste

sur lequel Sage 100 Webservices est installé, et la partie serveur de Sage 100 Serveur sur le poste sur

lequel les bases de données Sage 100 sont stockées.

Matériel

Configuration minimale :

Processeur : Pentium IV 1 Ghz,

512 Mo de RAM.

Configuration conseillée :

Processeur : Pentium IV 2,8 Ghz,

1 Go de RAM.

Sage 100 Webservices peut être installé sur le même serveur que le serveur Sage CRM ou sur un serveur distinct. Pour des raisons d’optimisation, il est conseillé d’installer Sage 100 Webservices et Sage CRM sur un seul et même serveur. Pour ce type d’installation, il sera nécessaire d’adapter la configuration du serveur aux besoins de Sage 100 Webservices et de Sage CRM.

Page 16: Version 15.50 Installation - FGS Conseils - Centre de ...€¦ · Compte tenu des contraintes inhérentes à la présentation sous forme de manuel ... Sage 30, Sage 100, Intégrale,

Installation de Sage 100 Webservices

16 © Sage

Compatibilité

Sage 100 WebServices est compatible avec Sage CRM 6.1 et les applications Sage 100 suivantes :

Sage 100 Windows version 15.xx,

Sage 100 pour SQL Server version 15.5x,

Sage 100 pour SageSQL version 15.5x.

Page 17: Version 15.50 Installation - FGS Conseils - Centre de ...€¦ · Compte tenu des contraintes inhérentes à la présentation sous forme de manuel ... Sage 30, Sage 100, Intégrale,

Installation de Sage 100 Webservices

© Sage 17

Installation

Le programme d’installation de Sage 100 Webservices version 15.50 est disponible en téléchargement

sur la base de connaissance du site Sage (fiche KB33076).

Pour réaliser la première installation du programme sur le disque dur, effectuez les opérations

suivantes :

Allumez le micro-ordinateur et attendez que les opérations d’initialisation s’exécutent.

Introduisez le cd-rom dans le lecteur.

Cliquez sur le bouton Démarrer et attendez que la liste s’ouvre.

Sélectionnez la commande Exécuter.

Saisissez l’emplacement sous lequel le programme d’installation a été téléchargé.

Cliquez sur le bouton OK ou validez (pressez la touche ENTREE).

Vous pouvez également utiliser le bouton Parcourir pour sélectionner le fichier SETUP.EXE.

Cliquez sur le bouton OK pour continuer l’installation ou sur Annuler pour l’arrêter.

Bienvenue

Une succession d’écrans va alors apparaître pour vous aider à installer le logiciel. Elle commence par

celui intitulé Bienvenue. Suivez très exactement les consignes qui y sont portées et répondez aux

questions posées. Nous détaillons ci-après les points les plus importants de l’installation.

Page 18: Version 15.50 Installation - FGS Conseils - Centre de ...€¦ · Compte tenu des contraintes inhérentes à la présentation sous forme de manuel ... Sage 30, Sage 100, Intégrale,

Installation de Sage 100 Webservices

18 © Sage

Pour passer d’un écran au suivant tout en validant les saisies éventuellement faites, il suffit de cliquer

sur le bouton Suivant.

Le programme d’installation de Sage 100 Webservices démarre :

Le répertoire d’installation proposé par défaut est C:\Program Files\Sage Webservices. Pour

modifier cet emplacement, utiliser la commande Parcourir et dans la fenêtre Choisissez un dossier,

sélectionner le répertoire de destination.

Page 19: Version 15.50 Installation - FGS Conseils - Centre de ...€¦ · Compte tenu des contraintes inhérentes à la présentation sous forme de manuel ... Sage 30, Sage 100, Intégrale,

Installation de Sage 100 Webservices

© Sage 19

Valider la fenêtre de sélection du dossier d’installation et cliquer sur Suivant pour poursuivre

l’installation.

Prenez connaissance des conditions générales d’utilisation et cliquer sur Oui pour les accepter. Le

programme d’installation copie alors les fichiers de l’application

Page 20: Version 15.50 Installation - FGS Conseils - Centre de ...€¦ · Compte tenu des contraintes inhérentes à la présentation sous forme de manuel ... Sage 30, Sage 100, Intégrale,

Installation de Sage 100 Webservices

20 © Sage

Lorsque le processus d’installation s’est correctement déroulé, la fenêtre suivante apparaît

Cliquer sur Terminer

Page 21: Version 15.50 Installation - FGS Conseils - Centre de ...€¦ · Compte tenu des contraintes inhérentes à la présentation sous forme de manuel ... Sage 30, Sage 100, Intégrale,

Paramétrage des composants de Sage 100 Webservices

© Sage 21

Paramétrage des composants de

Sage 100 Webservices

Service Sage Serveur Web_________________________________22

Démarrage du service Sage Serveur Web .......................................................... 23

Arrêt du service Sage Serveur Web .................................................................... 25

URL du service.................................................................................................... 26

Configuration des sociétés Sage 100______________________27

Gestionnaire des sociétés ................................................................................... 28

Ajout d’une société .............................................................................................. 30

Modification d’une société ................................................................................... 33

Suppression d’une société .................................................................................. 34

Page 22: Version 15.50 Installation - FGS Conseils - Centre de ...€¦ · Compte tenu des contraintes inhérentes à la présentation sous forme de manuel ... Sage 30, Sage 100, Intégrale,

Paramétrage des composants de Sage 100 Webservices

22 © Sage

Service Sage Serveur Web

Lors de l’installation de Sage 100 Webservices, le service Sage Serveur Web est automatiquement

installé dans la liste des services de Microsoft Windows.

Ce service permet de démarrer un serveur http nécessaire pour synchroniser les données entre les

bases Sage 100 et les bases Sage CRM.

Le service Sage Serveur Web est installé avec le type de démarrage Automatique. Ceci signifie que le

service est automatiquement démarré au démarrage de la machine.

Page 23: Version 15.50 Installation - FGS Conseils - Centre de ...€¦ · Compte tenu des contraintes inhérentes à la présentation sous forme de manuel ... Sage 30, Sage 100, Intégrale,

Paramétrage des composants de Sage 100 Webservices

© Sage 23

Démarrage du service Sage Serveur Web

Pour accéder au paramétrage du service Sage Serveur Web, se placer dans le Panneau de

configuration de Windows puis sélectionner l’icône Outils d’administration. Dans la liste des outils,

sélectionner l’icône Services :

Page 24: Version 15.50 Installation - FGS Conseils - Centre de ...€¦ · Compte tenu des contraintes inhérentes à la présentation sous forme de manuel ... Sage 30, Sage 100, Intégrale,

Paramétrage des composants de Sage 100 Webservices

24 © Sage

Pour démarrer le service Sage Serveur Web, effectuer un clic-droit sur le service et dans le menu

contextuel, sélectionner Démarrer. Il est également possible de démarrer le service à partir de ses

propriétés :

Page 25: Version 15.50 Installation - FGS Conseils - Centre de ...€¦ · Compte tenu des contraintes inhérentes à la présentation sous forme de manuel ... Sage 30, Sage 100, Intégrale,

Paramétrage des composants de Sage 100 Webservices

© Sage 25

Arrêt du service Sage Serveur Web

Pour arrêter le service Sage Serveur Web, effectuer un clic-droit sur le service et dans le menu

contextuel, sélectionner Arrêter. Il est également possible d’arrêter le service à partir de ses

propriétés :

Page 26: Version 15.50 Installation - FGS Conseils - Centre de ...€¦ · Compte tenu des contraintes inhérentes à la présentation sous forme de manuel ... Sage 30, Sage 100, Intégrale,

Paramétrage des composants de Sage 100 Webservices

26 © Sage

URL du service

Lorsque le service Sage Serveur Web est démarré, les fonctions publiées par Sage 100 Webservices

sont disponibles depuis une url codée de la manière suivante :

http://[Nom de la machine]:[Port]/sagecrm.asmx

[Nom de la machine] : correspond au nom de la machine sur laquelle Sage 100 Webservices est

installé

[Port] : correspond au numéro de port utilisé par Sage 100 Webservices. Après installation de Sage

100 Webservices, le numéro de port défini par défaut est le : 8080. Ce numéro de port est modifiable.

Ainsi, si pour des besoins spécifiques il est nécessaire de modifier le port utilisé, procéder comme

suit :

Lancer l’éditeur de base de registre (Démarrer \ Exécuter \ Regedit).

Se placer sous l’arborescence : HKEY_LOCAL_MACHINE\SOFTWARE\Sage\Serveur Web

Sélectionner la clé Port

Positionner le paramètre Base sur Décimale et saisir le nouveau numéro de port. Par exemple :

Cliquer sur la commande Ok pour valider les modifications

Avant toute modification d’un paramètre dans la base de registre, créer un point de restauration du système d’exploitation.

Pour cet exemple, si Sage 100 Webservices est installé sur une machine nommée SRVWS100, l’url à

renseigner lors de la création de l’intégration à partir de Sage CRM sera donc la suivante :

http://SRVWS100:8081/sagecrm.asmx

Page 27: Version 15.50 Installation - FGS Conseils - Centre de ...€¦ · Compte tenu des contraintes inhérentes à la présentation sous forme de manuel ... Sage 30, Sage 100, Intégrale,

Paramétrage des composants de Sage 100 Webservices

© Sage 27

Configuration des sociétés Sage 100

La création d’une intégration entre Sage 100 et Sage CRM nécessite de renseigner, dans les

paramètres de l’intégration sous Sage CRM, le nom de la société Sage 100 avec laquelle les données

seront synchronisées.

Ainsi, une société est un point d’entrée pour lequel le chemin d’accès à la base comptable et à la base

commerciale Sage 100 (fichiers *.mae et *.gcm) doit être défini. Pour chaque société, il est également

possible de renseigner un numéro de compte client d’attente. Ce paramètre est utilisé par les services

de valorisation de document lorsque le compte Sage CRM n’est pas encore synchronisé avec un

compte Client Sage 100.

Page 28: Version 15.50 Installation - FGS Conseils - Centre de ...€¦ · Compte tenu des contraintes inhérentes à la présentation sous forme de manuel ... Sage 30, Sage 100, Intégrale,

Paramétrage des composants de Sage 100 Webservices

28 © Sage

Gestionnaire des sociétés

Lors de l’installation de Sage 100 Webservices, un programme spécifique à la gestion des sociétés

Sage 100 est installé dans le Panneau de configuration (Démarrer/Paramètres) :

Pour accéder au programme permettant la gestion des sociétés, double-cliquer sur l’icône Sage 100

Webservices :

Page 29: Version 15.50 Installation - FGS Conseils - Centre de ...€¦ · Compte tenu des contraintes inhérentes à la présentation sous forme de manuel ... Sage 30, Sage 100, Intégrale,

Paramétrage des composants de Sage 100 Webservices

© Sage 29

Les commandes Ajouter, Modifier et Supprimer permettent respectivement, de créer une nouvelle

société, de modifier et supprimer une société existante.

Les commandes Modifier et Supprimer ne sont accessibles que lorsqu’un élément est sélectionné dans la liste.

Par défaut, une société a été créée lors de l’installation :

Cette société utilise des fichiers d’exemples qui ont été copiés durant l’installation de l’application.

Ces fichiers sont stockés dans le répertoire :

C:\Documents and Settings\All Users\Documents\Sage\Sage Webservices

Page 30: Version 15.50 Installation - FGS Conseils - Centre de ...€¦ · Compte tenu des contraintes inhérentes à la présentation sous forme de manuel ... Sage 30, Sage 100, Intégrale,

Paramétrage des composants de Sage 100 Webservices

30 © Sage

Ajout d’une société

La commande Ajouter permet de créer une nouvelle société. Pour chaque société, il est nécessaire de

renseigner, un intitulé, l’emplacement du fichier comptable et l’emplacement du fichier commercial :

Intitulé : représente le code de la société devant être créée. Cette zone est limitée à 50 caractères

maximum. Tous les caractères sont autorisés. L’intitulé d’une société est un identifiant unique.

Client d’attente : représente le numéro de compte client Sage 100 qui sera utilisé pour l’appel des

services de valorisation des documents lorsque le compte CRM n’est pas encore synchronisé avec

un Tiers Sage 100. Cette zone est limitée à 17 caractères maximum.

A la validation des paramètres, aucun contrôle sur l’existence du compte n’est réalisé. Il convient donc de vérifier scrupuleusement que le numéro de compte saisi dans la zone Client d’attente existe dans la base comptable Sage 100 à laquelle la société est associée.

Fichier comptable : représente l’emplacement permettant d’accéder au fichier comptable (mae).

La saisie manuelle de l’emplacement n’est pas possible. La sélection de l’emplacement s’effectue

par une fenêtre de sélection de fichier :

Page 31: Version 15.50 Installation - FGS Conseils - Centre de ...€¦ · Compte tenu des contraintes inhérentes à la présentation sous forme de manuel ... Sage 30, Sage 100, Intégrale,

Paramétrage des composants de Sage 100 Webservices

© Sage 31

Fichier commercial : représente l’emplacement permettant d’accéder au fichier commercial

(gcm). La saisie manuelle de l’emplacement n’est pas possible. La sélection de l’emplacement

s’effectue par une fenêtre de sélection de fichier :

Ok : cette commande permet, après contrôle sur l’unicité de l’intitulé de société, d’enregistrer les

paramètres de la société. Dans le cas où une société avec le même intitulé existe déjà, le message

suivant est renvoyé :

Page 32: Version 15.50 Installation - FGS Conseils - Centre de ...€¦ · Compte tenu des contraintes inhérentes à la présentation sous forme de manuel ... Sage 30, Sage 100, Intégrale,

Paramétrage des composants de Sage 100 Webservices

32 © Sage

Annuler : cette commande permet de fermer la fenêtre de saisie du détail de la société sans

enregistrer les données.

Page 33: Version 15.50 Installation - FGS Conseils - Centre de ...€¦ · Compte tenu des contraintes inhérentes à la présentation sous forme de manuel ... Sage 30, Sage 100, Intégrale,

Paramétrage des composants de Sage 100 Webservices

© Sage 33

Modification d’une société

La commande Modifier permet de modifier pour la société sélectionnée dans la liste, l’intitulé, le

client d’attente ainsi que les emplacements d’accès aux fichiers de comptabilité et gestion

commerciale :

Les modifications ne sont prises en compte qu’après validation par la commande OK.

La commande Annuler permet de fermer la fenêtre de saisie du détail de la société sans enregistrer les

modifications.

Lors de la création d’une intégration sous Sage CRM, il est nécessaire de renseigner un utilisateur Sage 100 ayant les droits de connexion aux fichiers Sage 100 associés à la société. Ainsi, cet utilisateur doit exister dans les bases de comptabilité et gestion commerciale Sage 100 (code et mot de passe identiques dans les fichiers mae et gcm) sans quoi il ne sera pas possible de s’y connecter.

Page 34: Version 15.50 Installation - FGS Conseils - Centre de ...€¦ · Compte tenu des contraintes inhérentes à la présentation sous forme de manuel ... Sage 30, Sage 100, Intégrale,

Paramétrage des composants de Sage 100 Webservices

34 © Sage

Suppression d’une société

La commande Supprimer permet de supprimer la société sélectionnée dans la liste. Avant la

suppression définitive, une confirmation de suppression apparaît :

Pour supprimer définitivement la société, cliquer sur Oui.

Page 35: Version 15.50 Installation - FGS Conseils - Centre de ...€¦ · Compte tenu des contraintes inhérentes à la présentation sous forme de manuel ... Sage 30, Sage 100, Intégrale,

Description des entités

© Sage 35

Description des entités

Catégorie tarifaire / PricingList ____________________________36

Famille / ProductFamily ____________________________________36

Conditionnement / UOMFamily_____________________________37

Enuméré de conditionnement article / UOM_______________37

Article / NewProduct _______________________________________37

Tarif article / Pricing _______________________________________38

Client-Fournisseur / Account_______________________________38

Adresse Client-Fournisseur / Address _____________________39

Lieu de livraison Client / Address__________________________39

Téléphone Client-Fournisseur / Phones____________________40

Télécopie Client-Fournisseur / Phones ____________________40

Email Client-Fournisseur / Email ___________________________40

Contact Client-Fournisseur / Person _______________________41

Représentant / Representant ______________________________41

Devis / Quote _______________________________________________41

Bon de commande / Order _________________________________42

Ligne de document d’un Devis / QuoteItems ______________43

Ligne de document d’un Bon de commande /

OrderItems _________________________________________________43

Page 36: Version 15.50 Installation - FGS Conseils - Centre de ...€¦ · Compte tenu des contraintes inhérentes à la présentation sous forme de manuel ... Sage 30, Sage 100, Intégrale,

Description des entités

36 © Sage

Le mappage entre les champs des entités de Sage 100 et de Sage CRM est défini en interne dans Sage

100 Webservices. Ce paramétrage n’est donc pas modifiable. Ainsi, il n’est pas possible de créer ou

modifier les liens entre les champs publiés par les entités Sage 100 et ceux publiés par les entités Sage

CRM.

Vous trouverez ci-après, le détail du mappage des champs entre les entités Sage 100 et les entités Sage

CRM.

Catégorie tarifaire / PricingList

Champs Sage 100 Champs Sage CRM

Intitulé Nom

Intitulé Description

Inexistant. Valeur par défaut : Oui Actif

Inexistant. Valeurs : Oui ou Non Valeur par défaut

La première catégorie tarifaire de la base Sage 100 est intégrée en tant que Pricing par défaut dans la base Sage CRM. Cette information n’est pas directement visible au niveau de l’application Sage CRM.

Famille / ProductFamily

Champs Sage 100 Champs Sage CRM

Intitulé Nom

Intitulé Description

Inexistant. Valeur par défaut : Oui Actif

Page 37: Version 15.50 Installation - FGS Conseils - Centre de ...€¦ · Compte tenu des contraintes inhérentes à la présentation sous forme de manuel ... Sage 30, Sage 100, Intégrale,

Description des entités

© Sage 37

Conditionnement / UOMFamily

Champs Sage 100 Champs Sage CRM

Intitulé + " (" + référence article + ")" Nom

Intitulé + " (" + référence article + ")" Description

Inexistant. Valeur par défaut : Oui Actif

Une famille d’unité de mesure nommée « Aucune » est automatiquement créée par l’intégration dans la base Sage CRM. Cette famille est utilisée pour la gestion des articles sans conditionnement.

Enuméré de conditionnement article / UOM

Champs Sage 100 Champs Sage CRM

Enuméré Nom

Enuméré Description

Intitulé + " (" + référence article + ")" Fourchette des unités de mesure

Inexistant. Valeur par défaut : Oui Actif

Quantité Unités

Une unité de mesure nommée « Aucune » est automatiquement créée par l’intégration dans la base Sage CRM. Cette unité de mesure est utilisée pour la gestion des articles ne possédant aucun énuméré de conditionnement.

Article / NewProduct

Champs Sage 100 Champs Sage CRM

Désignation article + " " + Enuméré gamme 1 + " " + Enuméré gamme 2

Nom de produit

Référence article / Référence gamme Code du produit

Code famille Famille de produit

Conditionnement Unité de mesure

Page 38: Version 15.50 Installation - FGS Conseils - Centre de ...€¦ · Compte tenu des contraintes inhérentes à la présentation sous forme de manuel ... Sage 30, Sage 100, Intégrale,

Description des entités

38 © Sage

Champs Sage 100 Champs Sage CRM

Inexistant. Valeur par défaut : Oui Actif

La référence gamme est affectée au Code du produit lorsque l’article est un article à gamme. Dans le cas où la référence gamme est à vide, ce sera alors la référence article qui sera affectée au Code du produit.

Tarif article / Pricing

Champs Sage 100 Champs Sage CRM

Conditionnement Unité de mesure

Catégorie tarifaire Tarif

Référence article Code du produit

Code ISO Devise Devise

Prix Prix

Inexistant. Valeur par défaut : Oui Actif

Client-Fournisseur / Account

Champs Sage 100 Champs Sage CRM

Type : Customer (Client) ou Supplier (Fournisseur) Type de compte

Numéro de compte Code comptable

Intitulé Nom du compte

Devise Devise

Numéro d’identifiant Référence

Encours maximum autorisé Limite de crédit

Site web Site web

Catégorie comptable Taux de tva

Catégorie tarifaire Tarif

Taux d’escompte Remise pour paiement anticipé

Taux de remise Remise sur gamme

Taux de remise Remise sur facture

Page 39: Version 15.50 Installation - FGS Conseils - Centre de ...€¦ · Compte tenu des contraintes inhérentes à la présentation sous forme de manuel ... Sage 30, Sage 100, Intégrale,

Description des entités

© Sage 39

Champs Sage 100 Champs Sage CRM

Représentant Représentant

Contact (onglet identification) Contact onglet identification

Les champs « Représentant » et « Catégorie tarifaire » ne sont gérés que sur les tiers de type Client.

Adresse Client-Fournisseur / Address

Champs Sage 100 Champs Sage CRM

Inexistant. Valeur par défaut : Adresse principale Intitulé

Adresse Address 1

Complément Address 2

Code postal Code postal

Ville Ville

Région Etat

Pays Pays

Adresse principale Définir comme adresse par défaut

Inexistant. Valeurs : Billing (Facturation) ou Shipping (Expédition)

Type : Facturation ou Expédition

L’adresse définie sur l’onglet Identification de la fiche Tiers est transmise à Sage CRM avec l’intitulé « Adresse principale ». Cette adresse est définie comme l’adresse par défaut du compte Sage CRM et est transmise avec le type Billing.

Lieu de livraison Client / Address

Champs Sage 100 Champs Sage CRM

Intitulé Intitulé

Adresse Address 1

Complément Address 2

Code postal Code postal

Page 40: Version 15.50 Installation - FGS Conseils - Centre de ...€¦ · Compte tenu des contraintes inhérentes à la présentation sous forme de manuel ... Sage 30, Sage 100, Intégrale,

Description des entités

40 © Sage

Champs Sage 100 Champs Sage CRM

Ville Ville

Région Etat

Pays Pays

Adresse principale Définir comme adresse par défaut

Inexistant. Valeur par défaut : Shipping (Expédition) Type : Facturation ou Expédition

Les adresses définies sur l’onglet Livraisons de la fiche client sont transmises avec le type Shipping.

Téléphone Client-Fournisseur / Phones

Champs Sage 100 Champs Sage CRM

Téléphone Numéro

Inexistant. Valeur par défaut : Business Type : Professionnel

Télécopie Client-Fournisseur / Phones

Champs Sage 100 Champs Sage CRM

Télécopie Numéro

Inexistant. Valeur par défaut : Fax Type : Fax

Email Client-Fournisseur / Email

Champs Sage 100 Champs Sage CRM

E-Mail Adresse électronique

Inexistant. Valeur par défaut : Business Type : Professionnel

Page 41: Version 15.50 Installation - FGS Conseils - Centre de ...€¦ · Compte tenu des contraintes inhérentes à la présentation sous forme de manuel ... Sage 30, Sage 100, Intégrale,

Description des entités

© Sage 41

Contact Client-Fournisseur / Person

Champs Sage 100 Champs Sage CRM

Nom Nom

Prénom Prénom

Civilité Civilité

Inexistant. Valeur par défaut : Null Deuxième prénom

Inexistant. Valeur par défaut : Null Suffixe

Fonction Titre

Service Service

La notion de contact par défaut n’existe pas dans les bases Sage 100. Ainsi, aucun contact n’est créé dans la base Sage CRM avec l’option « Définir comme contact par défaut » activée.

Représentant / Representant

Champs Sage 100 Champs Sage CRM

Nom Nom

Prénom Prénom

Fonction Fonction

Seuls les collaborateurs Sage 100 avec l’option « Vendeur/représentant » activée sont transférés dans la base Sage CRM. La notion de représentant n’est disponible sous le CRM que sur les fiches des comptes de type Client.

Devis / Quote

Champs Sage 100 Champs Sage CRM

Numéro de compte client Code comptable

Devise Devise

Catégorie comptable Informations sur le taux de TVA

Page 42: Version 15.50 Installation - FGS Conseils - Centre de ...€¦ · Compte tenu des contraintes inhérentes à la présentation sous forme de manuel ... Sage 30, Sage 100, Intégrale,

Description des entités

42 © Sage

Champs Sage 100 Champs Sage CRM

Catégorie tarifaire Liste de prix

Référence Référence

Date Ouvert

Taux d’escompte % de remise

Date de livraison Ouvert

Représentant Représentant

Sous Sage CRM, la création de Devis n’est possible que pour les Comptes de type Client.

Bon de commande / Order

Champs Sage 100 Champs Sage CRM

Numéro de compte client Code comptable

Devise Devise

Catégorie comptable Informations sur le taux de TVA

Catégorie tarifaire Liste de prix

Référence Référence

Date Ouvert

Taux d’escompte % de remise

Date de livraison Ouvert

Mode d’expédition Mode de livraison

Représentant Représentant

Sous Sage CRM, la création de Bon de commande n’est possible que pour les Comptes de type Client.

Pour que le mode de livraison Sage CRM soit correctement repris lors de l’intégration du document dans la base Sage 100, l’intitulé de ce mode doit exister en tant que mode d’expédition dans la base Sage 100 (respect de la casse). Dans le cas où le mode n’existe pas, le mode affecté sera celui de l’adresse de livraison principale du Client Sage 100.

Page 43: Version 15.50 Installation - FGS Conseils - Centre de ...€¦ · Compte tenu des contraintes inhérentes à la présentation sous forme de manuel ... Sage 30, Sage 100, Intégrale,

Description des entités

© Sage 43

Ligne de document d’un Devis / QuoteItems

Champs Sage 100 Champs Sage CRM

Référence article Produit

Désignation Description

Quantité Quantité

Prix unitaire Prix standard

Remise Remise à la ligne

Les articles à gamme et à conditionnement sont gérés automatiquement par Sage 100 Webservices. Ainsi, c’est le code interne du produit Sage CRM qui permettra de déterminer les gammes ou le conditionnement à utiliser lors de la génération de la ligne de document dans la base Sage 100.

Ligne de document d’un Bon de commande / OrderItems

Champs Sage 100 Champs Sage CRM

Référence article Produit

Désignation Description

Quantité Quantité

Prix unitaire Prix standard

Remise Remise à la ligne

Les articles à gamme et à conditionnement sont gérés automatiquement par Sage 100 Webservices. Ainsi, c’est le code interne du produit Sage CRM qui permettra de déterminer les gammes ou le conditionnement à utiliser lors de la génération de la ligne de document dans la base Sage 100.