ID INFORMATIQUE – AMCAN Connecteur SAGE – API de communication 1
Connecteur SAGE – API de communication
Objectif :
Ce document résume les fonctionnalités du connecteur SAGE et qui consiste à une
intégration des bons de commandes saisis dans la boutique (Site E-commerce AMCAN) dans
le logiciel SAGE gestion commerciale.
Liste des flux
I- De la boutique vers Sage
La boutique doit pouvoir créer et éditer des données sur Sage, l’API nous permettra d'effectuer les
opérations suivantes :
1- Création de bons de commandes
2- Création des adresses de livraison
3- Création d’adresses de facturation
4- Gestion des Stocks des articles commandés
5- Gestion des statuts de document.
1- Création de bons de commandes
La saisie d’un bon de commande dans la boutique renseigne les données suivantes :
- Réf WEB : Référence du document provenant du Web.
- Date du document
- Date de Livraison
- Client: Code et intitulé du client.
- Le pays du client.
- le mode de règlement
- Adresse de livraison.
- Mode d’expédition.
- Adresse de facturation.
- Frais de port HT (montant en €).
- Total HT du bon de commande (montant en €).
- Total TTC du bon de commande (montant en €).
- Lignes d'articles
Réf Article.
Désignation Article.
Quantité Commandée
Prix Unitaire HT (montant en €).
Code TVA
Taux TVA
Remise appliquée à l’article (Taux)
ID INFORMATIQUE – AMCAN Connecteur SAGE – API de communication 2
Le bon de commande, intégré dans SAGE, sera complété par les informations suivantes :
- Réf WEB : Référence du document provenant du Web.
- Date: Date du document
- Date de Livraison
- Client: Code client Unique par catégorie tarifaire « A Définir : AMCAN ».
- Statut: Le statut est à définir avec le client.
- Code analytique : à définir avec AMCAN.
- Catégorie Tarifaire: Le pays du client détermine la catégorie tarifaire
d’attribution dans SAGE.
- Mode de règlement : AMCAN doit voir avec le service comptable pour le
choix de l’affectation des modes de règlement (CB, AMEX,….)
La création d’une table de correspondance est nécessaire entre les codes SAGE
et les codes utilisés dans la boutique.
- Adresse de livraison: L'adresse de livraison est affectée au client
« AMCAN».
- Mode d’expédition: Le mode d’expédition est géré dans la boutique ce qui
nécessite la création d’une table de correspondance entre les codes SAGE et les
codes utilisés dans la boutique.
- Infos libres contenants l'adresse de facturation.
[Fac-Nom Prénom] : Nom et Prénom du client provenant du web.
[Fac-Tel / E-mail] : Téléphone du client provenant du web.
[Fac-Adresse] : adresse du client provenant du web.
[Fac-Complément] : complément adresse du client provenant du web.
[Fac-CP Ville] : ville du client provenant du web.
[Fac-Pays] : pays du client provenant du web.
[Liv-Nom Prénom] :info facultative.
[Liv-Adresse] :info facultative.
[Liv-Complément] :info facultative.
[Liv-CP Ville] :info facultative.
[Liv-Pays] :info facultative.
- Frais de port HT (montant en €). : Définir un code pour les frais de port.
- Lignes d'articles
Réf Article: Le code article
Désignation Article : désignation article
Quantité : quantité commandée
Prix Unitaire HT: prix unitaire de l'article en €
Code TVA
Taux TVA
Remise appliquée à l’article (Taux)
2- Création des adresses de livraison :
Afin d’intégré les données des adresses de livraison dans SAGE, la boutique fournira les
informations suivantes à chaque création de bon de commande:
ID INFORMATIQUE – AMCAN Connecteur SAGE – API de communication 3
- Nom Complet : Le nom complet du destinataire de la livraison.
- Civilité
- Adresse : La rue et le numéro de la rue où la commande doit être livrée.
- Complément d'Adresse (optionnel) : Toute information supplémentaire
nécessaire pour trouver facilement le lieu de livraison (par exemple, numéro
d'appartement, étage, etc.).
- Ville : La ville où la commande doit être livrée.
- Code Postal : Le code postal de la région de livraison.
- Pays : Le pays de destination de la livraison.
- Numéro de Téléphone : Un numéro de téléphone de contact pour le
destinataire de la livraison.
- Instructions de Livraison (optionnel) : Des instructions spéciales pour le
livreur, telles que des indications pour trouver l'adresse, des préférences de
livraison, etc. Cette information sera intégrée en ligne de commentaire dans le
document de vente.
3- Création d’adresses de facturation :
Affectation des informations de facturations dans des champs libres cités dans la section Bon
de commande.
4- Gestion des Stocks des articles commandés
Les stocks des produits contenus dans les bons de commandes provenant de la boutique
seront gérés au moment du déversement dans SAGE.
Cette gestion se fera en fonction du type de suivi en stock définie dans SAGE dans la fiche
article.
5- Gestion des statuts de document.
Afin de géré l’annulation d’un bon de commande par un client, la boutique transmet cette
information en fournissant les données suivantes :
- Réf WEB
- Statut : Annulé.
Cette information sera gérée par l’API et transmise au connecteur afin de générer une alerte par mail
(Destinataires à définir) concernant les documents annulés et qui ont le statut préparation de
livraison ou bon de livraison dans SAGE.
II- De SAGE vers la boutique :
Aucune information à transmettre de sage vers le site.
ID INFORMATIQUE – AMCAN Connecteur SAGE – API de communication 4
