Aan de slag met Simple-Simon API-integratie

Bescherm je data en optimaliseer je processen met de Simple-Simon API. Volg deze richtlijnen voor een veilige en efficiënte toepassing.

Belangrijkste restricties:

– Actieve licentie vereist: de gebruikersnaam en wachtwoord moeten gekoppeld zijn aan een actieve licentie voor de huidige maand. Dit hoeft geen extra gebruiker te zijn.
– API-toegang aanvragen: dien een eenmalig verzoek in bij Simon Support om de API te activeren. Je ontvangt een e-mail met een URL-link en documentatie voor elke methode.
– Verantwoordelijkheid: jij bent verantwoordelijk voor het beschermen tegen ongeautoriseerd gebruik en het waarborgen van de integriteit en kwaliteit van je data.
– Kosten: de eerste drie maanden zijn gratis. Daarna bedragen de kosten €395 per jaar.

Eigen koppeling maken

Om je eigen koppeling te realiseren, heb je het volgende nodig:
1. Simon licentiecode: een 16-cijferige Simon-licentiecode.
2. Simon kantoorgebruikersnaam: bijvoorbeeld het e-mailadres van je aanvraag.
3. Wachtwoord: het wachtwoord van deze gebruiker.
4. Eenmalige aanvraag: toegang tot de API moet één keer aangevraagd worden.

Ondersteuning: Simons Restserver ondersteunt HTTP GET/POST, geen SOAP.
Simons Restserver is Engelstalig opgezet. Ook de tabellen hebben Engelse namen.

Belangrijkste tabellen

– Customer: klant met één of meer Werkadressen.
– Location: werkadres gerelateerd aan de werkbon. Een werkadres kan zonder klant bestaan.
– WorkOrder: de werkbon, altijd gekoppeld aan een werkadres.
– ItemGroup: artikelgroep.
– Item: artikelen binnen een artikelgroep.
– User: gebruikers, zowel in het veld als op kantoor.
– Planning: bevat altijd een werkbon en een gebruiker.
– WorkOrderSurvey: vragenlijsten bij een werkbon, in Simon opgesteld.
– UsedItem: verbruikt materiaal op een werkbon.
– TimeSheet: reis- en werktijd op een werkbon.
– Workorder/DigitalPresentation: de werkbon als PDF.
– WorkOrderSurvey/DigitalPresentation: de ingevulde vragenlijst als PDF.

Algemeen

Haal het token op volgens de omschrijving met de volgende gegevens:
Key: 16-cijferige licentiecode.
Pwd: Je eigen wachtwoord.
Usr: Je gebruikersnaam.

Je ontvangt een token dat bij elk verzoek nodig is. Dit token verloopt, zorg ervoor dat je het regelmatig vernieuwt tijdens het gebruik van Simons Restserver. Bekijk de HELP-pagina bij login; het TOKEN moet bij elk verzoek in de HEADER worden meegegeven!

Methodiek
Simons

De restserver werkt uniform, ongeacht de tabel. De volgende uitleg voor de tabel “location” (werkadres) is van toepassing op alle tabellen:

Met de volgende acties kun je werkadressen toevoegen, wijzigen en verwijderen:

location/insert

location/update

location/delete

Voor “Update” en “Delete” moet je een Simon-Id meegeven. Simon kent altijd twee Id’s: het door Simon automatisch aangemaakte ID en jouw eigen sleutel/ID, genaamd ExtKey.

ExtKey mag leeg zijn of een unieke waarde hebben.

Om een Simon-ID te vinden, gebruik je: location/read. Je kunt hierbij filterwaarden meegeven; raadpleeg de documentatie voor meer informatie. Je krijgt een lijst met Sleutels terug: Simon.Id-Simon.ExtKey.

Vervolgens kun je location/read/{id} gebruiken, waarbij {id} het Simon.ID is.

Gebruik de methode location/readsync als je bijvoorbeeld een service wilt maken waarbij je jouw systemen gesynchroniseerd wilt houden met Simon. Geef de laatste mutatiedatum of het laatst gebruikte Simon-ID door en je ontvangt een lijst met alle Simon-ID’s na die datum of dat ID.

Voorwaarden voor het Gebruik van de Simple-Simon

API
Wanneer je de Simple-Simon API wilt gebruiken, gelden de volgende voorwaarden:
– Aanvraag indienen: stuur een e-mail naar support@simple-simon.net met het verzoek om toegang. Wij zorgen ervoor dat je omgeving geschikt wordt gemaakt voor het gebruik van onze API’s.
-Actieve licentie: je moet minimaal één actieve (betaalde) licentie hebben om de API te gebruiken. Tijdens de proefperiode is gebruik van de Simple-Simon API helaas niet mogelijk.
– Eigen risico: het verstoren van je eigen Simple-Simon omgeving, de integratie met je ERP-systeem en/of je agenda door gebruik van de API is op eigen risico.
– Ondersteuningskosten: als je ondersteuning van ons IT-team nodig hebt, bedragen de kosten €1.200 per mandag, met een minimale afname van één mandag.

Optimaliseer je workflow met de Simple-Simon API en integreer moeiteloos met je bestaande systemen!