Documentation de l'API Sage Business Cloud Comptabilité

Démarrage rapide

En quelques minutes, testez votre première requête avec l'API.

Manuel de référence de l'API

Vous retrouvez ici la description de toutes les ressources disponibles pour l'API.

Tutoriels et exemples

Simplifiez votre apprentissage grâce aux différents tutos et exemples mis à votre disposition

FAQ - Questions les plus fréquentes

Ayez le bon réflexe, consultez les réponses aux principales questions référencées par thèmes.

Concepts clés

Retrouvez, regroupés dans cette section, les informations fréquemment nécessaires.

What's new

  • January 20 2021

    Changement url API

    Attention ! Nouvelle url de test pour l’API

    Attention ! Nouvelle url de test pour l’API

    Nouvelle url API

    1. Prenez connaissance de la nouvelle url de l’API Sage Business Cloud Comptabilité.

    2. L’exemple projet d’application en C# .NET + JavaScript a été mis à jour pour tenir compte de cette nouvelle url de l’API.

  • November 30 2020

    Améliorations API

    Publication de nouvelles propriétés sur les ressources Company et Tiers.

    Publication de nouvelles propriétés sur les ressources Company et Tiers.

    Nouveautés API

    1. Publication dans la ressource Informations société des propriétés sur la gestion des registres de taxes.

    2. Publication dans la ressource Tiers de la propriété simplifie pour indiquer que le tiers a été crée par la fonction création simplifiée des tiers dans l’application.

    3. L’ajout de pièces comptables via l’action creerPieceComptable tient compte du mode de gestion des registres de taxes pour générer les registres de taxes.

  • October 31 2020

    Améliorations API et environnement

    Publication des contacts pour tous les types de tiers, paramètres Services et Types de contact. Option contrôle pour action CreerPieceComptable sans création si pièces conformes. Action effacerDonneesPersonnelles. Nouvel environnement Bureau + API.

    Publication des contacts pour tous les types de tiers, paramètres Services et Types de contact. Option contrôle pour action CreerPieceComptable sans création si pièces conformes. Action effacerDonneesPersonnelles. Nouvel environnement Bureau + API.

    Nouveautés API

    1. Publication de la ressource Contacts sur tous les types de tiers.

    2. Publication des ressources Services des Contacts et Types de contacts.

    3. Ajout d’un paramètre controle à l’action creerPieceComptable .
      Grâce à ce paramètre il est possible de tester les règles métier en amont de la création réelle de la pièce.

    4. Sur tous les types de tiers, ajout d’une action effacerDonneesPersonnelles pour supprimer d’un point de vue RGPD les données personnelles tout en conservant les données légales ou fiscales liées au Client.

    Nouveautés environnement

    1. Un nouvel environnement pour l’API Sage Business Cloud Comptabilité en relation avec le Bureau Sage Business Cloud

    2. La cohérence entre les créations de sociétés et attributions des droits aux collaborateurs et la liste des sociétés accessible via l’API Sage Business Cloud Comptabilité.

    3. La possibilité dans le programme bêta de gérer deux bases société distinctes avec les données de démonstration ou données d’une base à forte volumétrie.

      img

      img

  • September 30 2020

    Améliorations API et Exemples

    Ajout d’une action creerPieceComptable, ajout de fonctions pour calcul de soldes, de mouvements, de dates dernière facture et règlement, augmentation de la pagination, exploration des métadonnées, version enrichie de l’exemple C# .NET + JavaScript.

    Ajout d’une action creerPieceComptable, ajout de fonctions pour calcul de soldes, de mouvements, de dates dernière facture et règlement, augmentation de la pagination, exploration des métadonnées, version enrichie de l’exemple C# .NET + JavaScript.

    Visionnez la vidéo complète des nouveautés
    Ou visionnez la vidéo courte

    Nouveautés API

    1. Ajout de l’action creerPieceComptable sur les journaux.
      Grâce à cette action vous pouvez créer des lots d’écritures avec la garantie du respect des règles métier.

      img

    2. Ajout de fonctions pour calcul de soldes, mouvements et dates dernière facture et règlement pour tous les types de Tiers (Clients, Fournisseurs, Tiers Salariés, Tiers Autres).

      img img

    3. Exploration des métadonnées.
      Comprenez l’organisation des métadonnées et explorez-les via un exemple interactif de navigation dans les ressources, propriétés, énumérations, relations, fonctions.

      img

    4. Pagination : Augmentation du nombre maximal d’enregistrements renvoyés à chaque appel API, la valeur maximale passe de 100 à 2000. Le temps de récupération d’un grand volume de données est ainsi fortement réduit.

      img

    Nouveautés exemple C# .NET / JavaScript

    Le projet d’application en C# .NET + JavaScript bénéficie de nombreuses améliorations facilitant encore la compréhension de l’exploitation de l’API.

    1. Améliorations générales
      • Gestion multi-sociétés
      • Outil de trace des appels API avec temps d’exécution et alerte si temps suspect (>3 secondes).
      • Normalisation de l’affichage des erreurs selon leur type (token expiré, erreur métier, erreur environnement).
      • Amélioration de l’organisation du code source.

    2. Onglet Requêtes :
      • Accès possible aux relations d’une ressource.
      • Coloration syntaxique des résultats.
      • Affichage dynamique de la construction de l’url appel API en fonction de la saisie des paramètres d’appel.
      • Icône pour passer en affichage plein écran du résultat.
      • Affichage du nombre d’enregistrements retournés.

    3. Onglet Clients :
      • Affichage en asynchrone du solde pour chaque client de la liste.
      • Affichage en asynchrone du solde, dates dernière facture et règlement en détail client.
      • Contrôle en cours de saisie du doublon compte de tiers en création d’un client.
      • Ajout de la liste des pays en création/modification de client.
      • Amélioration de l’interface de la liste des clients et des actions de pagination.
      • Ajout de la fonction de suppression d’un client.

    4. Onglet Import :
      • Mise à disposition de plusieurs exemples de fichiers d’import.
      • Interface améliorée pour gérer le workflow des étapes à effectuer.
      • Dissociation de l’étape de contrôle et de l’étape d’import.
      • Utilisation de l’action creerPieceComptable.
      • Affichage lors du contrôle, puis après l’import, de la liste des pièces avec affichage possible du détail.
      • Optimisation des temps de contrôle et traitements.

      img

    Nouveautés site documentation

    1. Migration progressive du nom de l’API : API Sage Business Cloud en remplacement de API Sage 100Saas.

    2. Ajout d’une liste de choix accès rapide pour faciliter l’accès aux exemples simples de requêtes et l’accès aux soldes, mouvements et dates dernière facture et règlement.

      img

    3. Refonte de la page Pagination suite au passage de 100 à 2000 enregistrements par lot.

  • July 30 2020

    Améliorations site + amélioration API

    Ajout des routes API dans le manuel de référence, ajout d’une page d’explication et exemple métadonnées de l’API, ajout des pays.

    Ajout des routes API dans le manuel de référence, ajout d’une page d’explication et exemple métadonnées de l’API, ajout des pays.

    Nouveautés site documentation

    1. Ajout des routes dans toutes les ressources sous la forme :

      img

    2. Ajout d’une page d’explication et exemple interactif de l’utilisation des métadonnées de l’API

      img

    3. Explications supplémentaires pour les ressources

    Nouveautés API

    Ajout de la ressource des pays.

  • July 22 2020

    Améliorations site retours Sage Developer Day

    Améliorations du site suite au premier Sage Developer Day

    Améliorations du site suite au premier Sage Developer Day

    Nouveautés

  • June 24 2020

    Nouveautés du site

    Un résumé des points importants modifiés sur le site depuis la version précédente.

    Un résumé des points importants modifiés sur le site depuis la version précédente.

    Nouveautés

    • Création adresse de correspondance [email protected]
    • Création tutoriel dédié à l’authentification
    • Ajout dans concepts de l’authentification
    • Ajout dans exemples de OpenID Connect C#
    • Alignement ressources API / Fonctionnel produit
    • Ajout tag inv pour propriétés présentes dans l’API mais absentes dans le produit
    • Ajout d’un tag BETA sur toutes les pages
    • Pour le parcours App Registry ajout d’un pavé BETA Sage Developers Day
    • Ajout de quelques FAQ
    • Page test Postman opérationnelle avec collection Postman conforme
    • Documentation métier Ecritures, ajout paramètres codification et collectifs tiers
    • Evolution exemple C#