Pour commencer
Afin de protéger vos données de la manière la plus sûre possible, les restrictions suivantes s’appliquent à l’utilisation de l’api :
- L’utilisateur/pass que vous utilisez doit avoir une licence active pour le mois en cours. Il ne doit pas nécessairement s’agir d’un utilisateur supplémentaire.
- Une fois que vous avez soumis une demande à Simon Support pour libérer l’api pour l’utilisation. Vous recevrez par mail un lien avec l’URL, chaque méthode y est documentée.
- La responsabilité de la protection contre l’utilisation non autorisée, ainsi que l’intégrité / la qualité des données vous incombe par la suite.
- Les trois premiers mois d’utilisation sont gratuits, après quoi le coût sera de 470 € par an.
Votre propre connexion
Pour créer votre propre connexion, vous aurez besoin des éléments suivants :
- Votre code de licence Simon à 16 chiffres
- Un nom d’utilisateur du bureau Simon (par exemple, l’adresse e-mail de votre application)
- Le mot de passe de cet utilisateur
- Demande unique d’accès à l’api
Le serveur résiduel de Simons supporte le HTTP GET/POST, pas le SOAP.
Le serveur Simon’s Rest est configuré en anglais. Les différentes tables ont également des noms anglais.
Les tableaux les plus importants sont :
Données de base
Customer: Client. Un client a une ou plusieurs adresses de travail
Location: Adresse de travail, à laquelle le bon de travail se réfère. L’adresse de travail sans le client peut
WorkOrder: Le bon de travail. a toujours une adresse de travail
ItemGroup: Groupe d’articles
Item: Articles. Un article peut se trouver dans un groupe d’articles
User: Utilisateurs sur le terrain OU utilisateurs au bureau
Scheduling: L’ordonnancement contient toujours un bon de travail et un utilisateur.
WorkOrderSurvey: Questionnaire(s) pour accompagner un ordre de travail. Le questionnaire lui-même est créé dans Simon
UsedItem: Matériel utilisé sur un bon de travail
TimeSheet: Déplacement et temps de travail sur un bon de travail
Workorder/digitalpresentation: Le bon de travail en format PDF
Workordersurvey/digitalpresentation: Le questionnaire rempli en format PDF
Général
Selon la description, récupérez le Token, avec les informations suivantes
Key = Code de licence à 16 chiffres
Pwd = votre propre mot de passe
Usr = votre nom d’utilisateur
Vous obtenez un jeton. Vous avez besoin de ce jeton à chaque requête. Un jeton expire, assurez-vous de rafraîchir le jeton régulièrement lorsque vous utilisez le serveur de repos de Simon !
Consultez la page d’AIDE à la connexion, vous devez entrer le TOKEN dans le HEADER de chaque requête !
Méthodologie
Le serveur Simons Rest fonctionne toujours de la même manière, quelle que soit la table. Ci-dessous l’explication pour la table Location (=adresse de travail), cette explication s’applique également à toutes les autres tables !
Avec les actions :
location/insert
location/update
location/delete
Vous pouvez ajouter, modifier et supprimer des adresses de travail. Pour la mise à jour et la suppression, vous devez donner un Simon-Id. Important : Simon connaît toujours 2 identifiants. L’identifiant Simon créé automatiquement et votre clé/identifiant. Dans Simon, cela s’appelle ExtKey. ExtKey peut être vide ou peut avoir une valeur UNIQUE.
Maintenant, pour trouver un Simon Id utiliser: location/read
Ici, vous pouvez passer un certain nombre de valeurs de filtre, se référer à la documentation comment le faire.
Vous obtiendrez une liste de clés: Simon.Id-Simon.ExtKey
Alors vous pouvez y aller avec :
location/read/{id} (où {id} est le Simon.Id)
Méthode : utilisez location/readsync si, par exemple, vous créez un Service où vous voulez garder votre ou vos systèmes synchronisés avec Simon. Vous passez une date de dernière mutation OU un dernier Simon-Id utilisé et vous obtenez en retour une liste de tous les Simon-Ids après cette date ou Simon-Id.
Conditions requises pour l’utilisation de l’api Simple-Simon
Si vous souhaitez utiliser l’api Simple-Simon, les conditions suivantes s’appliquent :
- Veuillez envoyer un courriel à support@simple-simon.net avec la demande d’utilisation. Nous ferons alors en sorte que votre environnement soit adapté à l’utilisation de nos API.
- Vous devez avoir au moins une licence active (payante) pour utiliser l’api. Pendant la période d’essai gratuite, il n’est malheureusement pas possible d’utiliser l’api de Simple-Simon.
- L’interruption de votre propre environnement Simple-Simon, l’intégration avec votre système ERP et/ou votre calendrier, en utilisant l’api de Simple-Simon est à votre propre risque.
- La responsabilité de la protection contre l’utilisation non autorisée, ainsi que l’intégrité / la qualité des données vous incombe par la suite.
- Si l’assistance de notre équipe informatique est nécessaire, les coûts s’élèvent à 1 200 € par jour de travail, ce qui correspond également à l’achat minimum.