How do I access the API?

Answer
Submit a request to support-oms@extensiv.com  in order to request access.

When your app is created it will automatically be hidden from the app store, the link for it will be emailed to you. Once your production app is tested and ready to go live please submit a request to support-oms@extensiv.com  and the API team will take care of validating everything and make your app visible to everyone.

How do I generate an access token?

Answer
Submit a request to support-oms@extensiv.com  in order to request access.

When your app is created it will automatically be hidden from the app store, the link for it will be emailed to you. Once your production app is tested and ready to go live please submit a request to support-oms@extensiv.com  and the API team will take care of validating everything and make your app visible to everyone.
 

How do I create a new app?

Answer
Submit a request to support-oms@extensiv.com  in order to request access.

* When your app is created it will automatically be hidden from the app store, the link for it will be emailed to you. Once your production app is tested and ready to go live please submit a request to support-oms@extensiv.com  and the API team will take care of validating everything and make your app visible to everyone.

I created a partner account and an app but when I log in I don't see anything, is something wrong?

Answer

Partners accounts are only used to maintain apps. To test your app and use the API you need to sign up for a new test user account. Instructions and the link to do so are in the email that was automatically sent to the partner's email address once the app was created.

How do I test my app?

Answer

Partners accounts are only used to maintain apps. To test your app and use the API you need to sign up for a new test user account. Instructions and the link to do so are in the email that was automatically sent to the partner's email address once the app was created.

Testing of my app is completed on the demo environment, what are the next steps?

Answer

You need to go through the same process but on production, the instructions were sent to you previously via email.

My app is ready for production, what are the next steps?

Answer

You need to go through the same process but on production, the instructions were sent to you previously via email.

I get a page not found while trying to test my app on production, what's wrong?

Answer

If your app is currently being tested (not live), it needs to be activated by the API team (submit a request to support-oms@extensiv.com  ). If your app has been made visible only to certain users, make sure you are logged in with these user accounts otherwise you won't be able to see the app

I have a technical error, where can I get technical support?

Answer

Please submit a request at our support-oms@extensiv.com  

I get this error message: "error":"Invalid value 'Can not deserialize instance of com.skubana.cerp.model.validation.ValidList out of START_OBJECT token\n at java.io.PushbackInputStream@59fca99d; line: 1, column: 1]' (line: 1 column: 1)

Answer

You are submitting invalid JSON. Please refer to our API documentation for valid JSON to start from. You can also validate your JSON using this site before submitting it to the API: https://jsonformatter.org/

I created orders using PUT /orders but I don't see them anywhere. What is wrong?

Answer

All orders created through the API will first go to the SKU_UNPROCESSED status. From there it can take up to 90 seconds for Order Manager to process them. Until they are processed orders are not editable.

The orders I created have the SKU_UNPROCESSED status, what is going on?

Answer

All orders created through the API will first go to the SKU_UNPROCESSED status. From there it can take up to 90 seconds for Order Manager to process them. Until they are processed orders are not editable.

I try to use the picklist with POST /inventory/pick and I get this error message: "ERR046: Cannot find any pickable stocks for the specified order"

Answer

Orders have to be in a picklist in order to be picked. Picklists can be created within the Order Manager UI. Go to Orders tab > Awaiting shipment > Check some orders > Print > Pick List(s).

Does your API support TLS 1.2?

Answer

Yes. See our load balancer security policy below

Why is there a delay for my data to show up successfully?

Answer

Order Manager is moving away from a monolithic service architecture to a microservices architecture operating on the principle of eventual consistency. What this means for the API: we guarantee that any operation that returns a successful status code will have eventually completed in our system. As our infrastructure becomes more robust and complex, we will continue to do our best to optimize performance and minimize response times. With that being said, we cannot guarantee API operations to complete immediately after returning.

Why is my app getting the response 429 Too Many Requests?

Answer

In order to prevent overstraining our system we put in place limits of how many requests an app can make in a given time period. Throttling limits vary and can be found in the documentation for each endpoint. If you find that 429's are being returned frequently, check your program logic to confirm that your requests are spaced out correctly. You should also confirm that you are only sending necessary requests. For example, you should not need to send duplicate inventory update requests for all skus when the inventory quantity has not changed.

Below you will find an explanation of how our leaky bucket algorithm works for throttling app requests.

Maximum Request quota - The number of requests that you can submit at one time without throttling. The request quota decreases with each request you submit, and increases at the restore rate.

Restore rate (also called the recovery rate) - The rate at which your request quota increases over time, up to the maximum request quota. (e.g. if restore rate is 250, it means one request is restored every 250 milliseconds or 0.25 seconds)

Hourly request quota - The maximum number of requests you can submit per hour

For example based on the get orders endpoints: If there's a restore rate of 1000ms and you have a maximum request quota of 5 you can make 5 requests without being throttled but after 1 second you will get one request back.