API docs

https://sellar-io.github.io/integration-docs/

Overview

The primary goal of integrating with Sellar is to access information about orders that originate on the platform to use in your own systems. This help guide will cover a few best practises when:

• Mapping products between systems
• Pulling and processing orders
• Managing stock levels
• Managing and mapping customers

Products

There are two ways to establish a link between a product on Sellar and its counterpart in your own systems. Both with their own pros and cons:

Store the Sellar product id after retrieving it via the API

This identifier is stable. The pre-requisite is that it would require a user to manually map each product in your own system’s user interface. If a product was added to Sellar and a customer places an order for it, you would need a suitable way of handling the ‘unmapped’ product and prompting the user of your own systems to map it before the order can be processed and stock levels adjusted.

Store your system’s own product identifier or SKU number in the sku field in Sellar

The sku field can be accessed via the Sellar user interface. The benefit of this approach is that it would allow products to be identified without a manual mapping process within your own systems. The drawback is that it would require users of Sellar to remember to enter the appropriate ID or SKU value in this field each time. Similarly, as this field is editable, it’s open to user input error.

Either approach for mapping products is feasible so it is ultimately down to your own preference.

The SKU field available when adding a product item to Sellar.

Orders

When processing orders that are made available via the Sellar API, we recommend the following:

Adjust stock levels for ‘pending’ orders (order requests) as soon as they’re available

When a customer places an order, this creates an ‘order request’ on Sellar. Within our own systems we immediately adjust stock levels to prevent overselling. For example, a supplier has 10 kegs in stock. A customer places an order for 2 of them. We adjust our stock levels as following: