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 Fr 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 à Fr 1.420 par jour de travail, ce qui correspond également à l’achat minimum.