Get Started with the Simple-Simon API Integration

Protect your data and optimise your workflows with the Simple-Simon API. Follow these best practices for a secure and efficient implementation.

Key Restrictions for Using the Simple-Simon API:

– Active licence required: The username and password used must be linked to an active licence for the current month. This does not have to be an additional user account.
– API access request: Submit a one-time request to Simon Support to activate API access. You’ll receive an email containing a URL and full documentation for each available method.
– Your responsibility: You are solely responsible for protecting your API credentials from unauthorised access and for maintaining the integrity and quality of your data.
– Costs: The first three months of API usage are free. After that, the service costs €395 per year.

Create your own integration

To build your own custom integration with Simple-Simon, you’ll need the following:
1. Simon Licence Code: A 16-digit Simon licence key.
2. Simon Office Username: For example, the email address used in your request.
3. Password: The password associated with this user account.
4. One-Time Request: API access must be requested once to activate the integration.

Support Details:
Simple-Simon’s REST server supports HTTP GET/POST methods, SOAP is not supported. The REST API is available in English only, and all table names are also in English.

Key Tables in the Simple-Simon API

– Customer: Represents a customer. A customer can have one or more associated work locations.
– Location: The job or work address linked to a work order. A location can also exist without being linked to a customer.
– WorkOrder: The actual work order. Every work order is always linked to a location.
– ItemGroup: A group of items or materials, used for organising inventory.
– Item: Individual articles or materials within an item group.
– User: Represents both office staff and field workers.
– Planning: Always contains a link between a work order and a user (for scheduling).
– WorkOrderSurvey: Digital forms or checklists created in Simon, linked to a specific work order.
– UsedItem: Materials used or consumed on a work order.
– TimeSheet: Travel and working hours associated with a work order.
– Workorder/DigitalPresentation: The digital work order exported as a PDF.
– WorkOrderSurvey/DigitalPresentation: The completed survey or checklist exported as a PDF.

General

To authenticate with the Simple-Simon API (Restserver), you must first retrieve an access token using the following credentials:
Key: Your 16-digit Simple-Simon license code
Pwd: Your user password
Usr: Your Simon username

Upon successful authentication, you will receive a token that is required for all subsequent API requests. This token has an expiration time. Make sure to refresh it regularly to maintain uninterrupted access during your session. For detailed instructions, refer to the HELP section on the login endpoint of Simon’s Restserver.

Methodology Simons

The Simon Restserver follows a consistent and uniform structure across all tables. The following example using the location table (representing a job site or work address) applies similarly to other available tables.

You can perform the following operations on work addresses:

location/insert

location/update

location/delete

For update and delete operations, you are required to provide the Simon.Id. Simon always uses two identifiers: The automatically created Simon-ID and your own key/ID named ExtKey.

ExtKey may be left empty or have a unique value

To find a Simon.ID for a specific location, you use location/read. You can supply filter parameters to narrow down the results. Refer to the API documentation for supported filters. The response will return a list of key pairs: Simon.Id – Simon.ExtKey.

You can then use: location/read/{id}, where {id} your Simon.ID is.

Use the method location/read/{id} if you’d want to sync Simon and your own systems with a service. Insert the last mutation date or last used Simon-ID to receive a list of Simon-ID’s after that date or that exact ID.

Terms of Use for the Simple-Simon API

When using the Simple-Simon API, the following terms and conditions apply:
– Access Request: To gain access, send an email to support@simple-simon.net requesting API activation. We will ensure your environment is configured appropriately for API usage.
-Active Licence Required: You must have at least one active (paid) Simple-Simon licence to use the API. Unfortunately, API access is not available during the trial period.
– At Your Own Risk: Any disruptions caused to your Simple-Simon environment, ERP integration, or calendar setup through API usage are entirely at your own risk.
– Support Costs: Should you require assistance from our IT team, support is charged at €1,200 per man-day, with a minimum charge of one full man-day.

Optimise your workflow with the Simple-Simon API
Seamlessly integrate Simple-Simon with your existing business systems and improve efficiency across the board!