Welcome to the Acenda API. This guide provides the essential information you need to start integrating with our platform.

Your primary endpoint for accessing the Acenda catalog API is:

https://api.acenda.io/v1/

All API requests should be directed to this URL.

For comprehensive details on all available endpoints, request methods, parameters, and example responses, please refer to our official Postman documentation.

View the Acenda API Documentation

Important Note: In Acenda, what are commonly known as "orders" are referred to as Ship Advice. This is because a single customer order may be split into multiple Ship Advices if items are fulfilled from different warehouses.

To authenticate your requests, you will need an API key. Follow these steps to obtain your key:

Best Practice: If you are working with outside contractors or third-party developers, we strongly recommend creating unique API keys for each partner. This enhances security and allows for better management of API access.

Here is a common workflow for retrieving and processing new orders (Ship Advices).

To get new, unacknowledged Ship Advices for your store, perform a GET request to the ship_advice endpoint. You'll need to pass your API token and the x-astur-organization as headers, as documented here.

A properly formatted call for your store, filtering for fulfillment_provider_id: 1 and warehouses: 1,2,3,4, will look like this:

The unacked=true parameter is crucial as it ensures you only pull Ship Advices that you have not yet processed.

Once you have successfully received a Ship Advice in your system, you must acknowledge it. This removes it from the queue of unacknowledged Ship Advices for your next API call.

After you have fulfilled the Ship Advice, the final step is to add the tracking number back into Acenda.