The Planning Receive API is a unified interface where you post your planning to. You should be aware of the format we would expect from you.
For the Planning Receive API we use the following URIs:
Production URL :
Staging URL :
As mentioned before, you should have requested your access_token from the Auth API. Next, make sure you are setting
the correct headers for the filetype you are sending, so set your
Content-Type to one of the following:
Keep in mind that this request only works, if you have a bearer token and set the correct Content-Type. Include these in the header. In this example we post to the staging URL:
curl --data "@/path/to/filename.json" -H "Content-Type: application/json" -H "Authorization: Bearer eyXXX" -X POST -i https://planning-receive-api-stg.services.simacan.com/trips/insertOrUpdate
If everything went fine, you should receive an HTTP status code 200 OK and a body which looks like this
Great! Your planning has been delivered to our platform. On success you will get the UUID for the specific file you've just sent us. Keep in mind, this is just a confirmation that we received your file. This is not a confirmation that your planning is processing.
To see the status of your delivered file, check the next chapter on the Planning Status API.
|401||Unauthorized Whenever you will get a 401 status, you have either provided the wrong credentials or none at all. Check if you bearer token has not expired|
|403||Forbidden You will receive this status, when you successfully supplied credentials, but your username does not have the necessary permissions for the resource. If you are sure you are using the correct account, please get in touch with us|
|404||Not Found Whenever you will get a 404, you are probably using a malformed or incorrect URL|
|415||Unsupported Media File The request's Content-Type is not supported.|