Sellercloud

Sellercloud

Sellercloud is the US e-commerce operations platform for multichannel sellers: orders from Amazon, eBay, Walmart, Shopify and other channels, the product catalog, inventory across warehouses, purchasing from vendors, returns (RMAs) and warehouse work. This connector uses the Sellercloud REST API and is read-only.

Setup

1. SELLERCLOUD_API_URL: the REST API endpoint of your Sellercloud server. Open https://api.sellercloud.com/api/server-by-team/?team=<your team name> in a browser (the team name is the one you sign in to Sellercloud with) and copy the RestApiEndpoint value, e.g. https://xx.api.sellercloud.com/rest or https://xxxxxxx.api.sellercloud.us/rest, without a trailing slash.
2. SELLERCLOUD_USERNAME and SELLERCLOUD_PASSWORD: a Sellercloud employee (user) login. Sellercloud recommends a separate employee for each integration; give it the Delta permissions for the data the AI should read (orders, products, inventory, purchasing, customers).

The connector signs in with POST /api/token and sends the returned access_token as Authorization: Bearer on every call. A token lasts 30 to 60 minutes; the connector signs in again by itself before it expires and after a 401.

Start here

• Orders: sellercloud_list_orders with order_status=[2] (InProcess) and shipping_status=1 (Unshipped) for open orders, or created_range=1 for today's orders; then sellercloud_get_order, sellercloud_get_order_notes and sellercloud_list_order_packages for tracking.
• Saved views: sellercloud_list_order_views and sellercloud_list_orders_by_view return exactly what a view in Sellercloud shows.
• Stock: sellercloud_get_inventory for one SKU, sellercloud_get_inventory_by_warehouse for its quantity per warehouse, sellercloud_list_inventory with physical_qty_to=0 for products out of stock.
• Purchasing: sellercloud_list_purchase_orders with statuses=[1] (Ordered) and received_statuses=[0,1], then sellercloud_get_purchase_order_items.
• Returns: sellercloud_list_rmas with statuses=[0], then sellercloud_get_rma_items.

Ids, statuses, dates

Orders, purchase orders, RMAs, customers, vendors, companies and warehouses have integer ids; products are identified by their product id (SKU) string. Statuses and channels are integer codes listed in each parameter (e.g. order status 1 ShoppingCart, 2 InProcess, 3 Completed, 100 ProblemOrder, 200 OnHold, 300 Quote, 999 Void, -1 Cancelled); answers carry the same codes. The full enumerations are under Resources in the Sellercloud API docs. Dates are sent as MM/DD/YYYY HH:MM. Amounts of international orders are converted to USD when the order is created; see CurrencyRateFromUSD in the order.

Pages

Lists return Items (or Results) and TotalResults. page_size is 10 by default and at most 50; raise page_number for the next page.

Limits

10,800 requests per hour per user and IP address. Over the limit Sellercloud answers "Too many requests." with a RateLimitResetTime; wait until then.

Writes

None. Creating or updating orders, products, inventory, purchase orders and RMAs is not part of this connector.