Démarrez avec l’intégration API Simple-Simon

Protégez vos données et optimisez vos processus avec l’API Simple-Simon. Suivez ces directives pour une utilisation sûre et efficace.

Principales restrictions :

– Licence active requise : le nom d’utilisateur et le mot de passe doivent être liés à une licence active pour le mois en cours. Il n’est pas nécessaire que ce soit un utilisateur supplémentaire.
– Demande d’accès API : soumettez une demande unique auprès du support Simon pour activer l’API. Vous recevrez un e-mail contenant un lien URL et la documentation pour chaque méthode.
– Responsabilité : vous êtes responsable de la protection contre toute utilisation non autorisée et de la garantie de l’intégrité et de la qualité de vos données.
– Coûts : les trois premiers mois sont gratuits. Ensuite, le coût est de 395 € par an.

Créer votre propre connexion

Pour réaliser votre propre connexion, vous avez besoin des éléments suivants :

  1. Code de licence Simon : un code de licence Simon à 16 chiffres.

  2. Nom d’utilisateur bureau Simon : par exemple l’adresse e-mail utilisée lors de votre demande.

  3. Mot de passe : le mot de passe de cet utilisateur.

  4. Demande unique : l’accès à l’API doit être demandé une seule fois.

Assistance : le serveur Rest de Simon prend en charge HTTP GET/POST, pas SOAP. Le serveur Rest de Simon est configuré en anglais. Les tables portent également des noms en anglais.

Principales tables

  • Customer : client avec une ou plusieurs adresses de travail.

  • Location : adresse de travail liée au bon de travail. Une adresse de travail peut exister sans client.

  • WorkOrder : le bon de travail, toujours lié à une adresse de travail.

  • ItemGroup : groupe d’articles.

  • Item : articles au sein d’un groupe d’articles.

  • User : utilisateurs, sur le terrain comme au bureau.

  • Planning : contient toujours un bon de travail et un utilisateur.

  • WorkOrderSurvey : questionnaires liés à un bon de travail, créés dans Simon.

  • UsedItem : matériel utilisé sur un bon de travail.

  • TimeSheet : temps de trajet et de travail sur un bon de travail.

  • WorkOrder/DigitalPresentation : le bon de travail au format PDF.

  • WorkOrderSurvey/DigitalPresentation : le questionnaire rempli au format PDF.

Généralités

Récupérez le token selon la procédure suivante avec les informations ci-dessous :

  • Key : code de licence à 16 chiffres.

  • Pwd : votre propre mot de passe.

  • Usr : votre nom d’utilisateur.

Vous recevrez un token nécessaire pour chaque requête. Ce token expire, assurez-vous de le renouveler régulièrement lors de l’utilisation du serveur Rest de Simon. Consultez la page HELP lors de la connexion ; le TOKEN doit être inclus dans l’HEADER de chaque requête !

Méthodologie
Simon

Le serveur Rest fonctionne de manière uniforme, quel que soit le tableau. Les explications ci-dessous pour le tableau « location » (adresse de travail) s’appliquent à tous les tableaux :

Vous pouvez ajouter, modifier et supprimer des adresses de travail avec les actions suivantes :

location/insert

location/update

location/delete

Pour Update et Delete, vous devez fournir un Simon-ID. Simon utilise toujours deux IDs : l’ID généré automatiquement par Simon et votre propre clé/ID, appelée ExtKey.

ExtKey peut être vide ou contenir une valeur unique.

Pour trouver un Simon-ID, utilisez : location/read. Vous pouvez fournir des valeurs de filtre ; consultez la documentation pour plus de détails. Vous recevrez une liste de clés : Simon.Id-Simon.ExtKey.

Ensuite, vous pouvez utiliser location/read/{id} où {id} est le Simon.ID.

Utilisez la méthode location/readsync si vous souhaitez, par exemple, créer un service permettant de synchroniser vos systèmes avec Simon. Fournissez la date de dernière modification ou le dernier Simon-ID utilisé, et vous recevrez une liste de tous les Simon-ID après cette date ou cet ID.

Conditions d’utilisation de l’API Simple-Simon

Lorsque vous souhaitez utiliser l’API Simple-Simon, les conditions suivantes s’appliquent :

  • Soumission de demande : envoyez un e-mail à support@simple-simon.net pour demander l’accès. Nous nous assurons que votre environnement est prêt à l’utilisation de nos API.

  • Licence active : vous devez disposer d’au moins une licence active (payante) pour utiliser l’API. Pendant la période d’essai, l’utilisation de l’API Simple-Simon n’est malheureusement pas possible.

  • À vos risques et périls : toute perturbation de votre environnement Simple-Simon, de l’intégration avec votre système ERP et/ou votre agenda par l’utilisation de l’API se fait sous votre propre responsabilité.

  • Coûts de support : si vous avez besoin de l’assistance de notre équipe IT, le tarif est de 1 200 € par jour, avec une prise minimale d’un jour.

Optimisez votre workflow avec l’API Simple-Simon et intégrez-la facilement à vos systèmes existants !