Getting Started

Selro provides a RESTfull Webservice API for sellers to manage their inventory and orders. API keys required to connect to the API is available in Channel Integration settings section

API keys

API Keys will be available under Channel Settings API tab

https://[server name].selro.com/api

The API

The Selro API is a full web service that allows sellers to manage their orders/inventory and listing into their selling channels via Selro. All the marketplaces and ecommerce stores supported by Selro will be supported by the API as well.

HTTP Codes

HTTP codes are used to differentiate between successful and failed responses.

As per the HTTP standard:
20x codes are for successful requests,
40x codes for errors with validation or permissions,
50x codes for unexpected internal server errors.

Every response with a 40x code will include an errors property with the error description.

Authentication

All requests must be authenticated by sending your API key and secret key as a GET parameter, for example:

/orders?key=abc14323&secret=adfd4344

Request format

All body payloads must be in JSON format, unless stated otherwise. Therefore, the Content-Type header must be set to application/json.

Environments

Currently Selro API does not provides a sandbox environment for testing. Any testing needs to be performed in your Selro account. You can find the API key/secret in the Channel Settings API section of your Selro account.

Products

Products resource can be used to create/update/delete products and also to download the product catalogue from your Selro inventory

Get Products

This endpoint will return all the products from your Selro Inventory.

GET /products?key=xxxx&secret=yyyy&page=1

Attributes
  • page

    For each page 100 items will be returned. You can iterate through get products with increment page numbers until the response products are empty

  • created_from

    Created Date From
    Date format yyyy-MM-dd'T'HH:mm:ss e.g 2018-01-28

  • created_to

    Created Date To
    Date format yyyy-MM-dd'T'HH:mm:ss e.g 2018-01-28

  • modified_from

    Modified Date To
    Date format yyyy-MM-dd'T'HH:mm:ss e.g 2018-01-28

  • modified_to

    Modified Date To
    Date format yyyy-MM-dd'T'HH:mm:ss e.g 2018-01-28

Product

Product resource can be used to create/update/delete products and also to download the product catalogue from your Selro inventory

Get Product (By Id)

This endpoint will return the product for the given product id. The product id is the Selro's unique product id

GET /products/product_id

Attributes
  • Product Id

    Selro internal product id. Must be present if sku is empty

Get Product (By SKU or Barcode )

This endpoint will return the product for the given SKU or barcode (EAN or UPC).

GET /product?sku=sku or /product?ean=ean value or /product?upc=upc value

Attributes
  • SKU

    SKU value

  • UPC

    UPC Value

  • EAN

    EAN Value

Create Product

This endpoint will create a new product

POST /product

Attributes
  • title

    Product Title

  • description

    Product description

  • shortdescription

    Short description

  • productsummary1

    Product Summary 1

  • productsummary2

    Product Summary 2

  • productsummary3

    Product Summary 3

  • productsummary4

    Product Summary 4

  • productsummary5

    Product Summary 5

  • sku

    Product sku

  • sellingprice

    Selling Price

  • rrpprice

    Recommended Retail Price

  • costprice

    Cost price

  • ean

    EAN

  • upc

    UPC

  • department

    Department

  • brand

    Brand

  • Array of images

    Image Urls

  • Array of Name and Value

    Attributes

  • variations

    Array list (name and value) of variations such as color or size

Update Product

This endpoint will update the given product

PUT /products/product_id

Attributes
  • id

    Product Id

  • title

    Product Title

  • description

    Product description

  • shortdecription

    Short description

  • productsummary1

    Product Summary 1

  • productsummary2

    Product Summary 2

  • productsummary3

    Product Summary 3

  • productsummary4

    Product Summary 4

  • productsummary5

    Product Summary 5

  • sku

    Product sku (Mandatory)

  • sellingprice

    Selling Price

  • rrpprice

    Recommended Retail Price

  • costprice

    Cost price

  • ean

    EAN

  • upc

    UPC

  • department

    Department

  • brand

    Brand

  • Array of images

    Image Urls

  • Array of Name and Value

    Attributes

Delete Product

This endpoint will delete a given product

DELETE /products/product_id

Attributes
  • id

    Optional : Selro internal product id. Must be present if sku is empty

  • sku

    Optional: Product SKU - Stock Keeping Unit. Must be present if id is empty

Orders

You can use the orders API to retrieve orders and update order status back

Get Orders

This endpoint will return all the orders for the given order status. If the order status is empty, all orders will be returned

GET /orders?key=xxxx&secret=yyyy

Possible Order statuses are displayed below

Order Status Description
Shipped Shipped orders
Canceled Canceled orders either by seller or buyer
Pending Pending orders. Orders that are not completed and payment not received or not cleared
Unshipped Completed orders but not yet shipped.
Draft Orders that are in draft status. This is mainly for manual orders
Processing Orders that are unshipped but in the processing queue
Unconfirmed Orders that are not yet confirmed by the sellers. This is only applicable for NOTHS (NotInTheHighStreet) orders
Attributes
  • page

    Page number

  • pagesize

    Number of orders per page. By default upto 100 orders will be returned

  • id

    This is the channel Order Id. e.g eBay /Amazon

  • status

    This is the order status. If this is empty, all orders will be sent.

  • from_date

    This is the last order update date. If this is empty, all orders will be sent.
    Date format yyyy-MM-dd'T'HH:mm:ss e.g 2018-01-28

  • to_date

    This is the last order status. If this is empty, all orders upto the current time willbe sent
    Date format yyyy-MM-dd'T'HH:mm:ss e.g 2018-01-28

  • fulfilment_warehouse_id

    This is the fulfilment warehouse id (e.g Huboo warehouse id). Orders assigned to this fulfilment centre will be returned

Get Orders for Warehouse

This endpoint will return all the orders for the given order status and Warehouse Id. If the order status is empty, all orders will be returned.

GET /orders?key=xxxx&secret=yyyy&status=order status&warehouseid=Warehouse id

Possible Order statuses are displayed below

Order Status Description
Shipped Shipped orders
Canceled Canceled orders either by seller or buyer
Pending Pending orders. Orders that are not completed and payment not received or not cleared
Unshipped Completed orders but not yet shipped.
Draft Orders that are in draft status. This is mainly for manual orders
Processing Orders that are unshipped but in the processing queue
Unconfirmed Orders that are not yet confirmed by the sellers. This is only applicable for NOTHS (NotInTheHighStreet) orders
Attributes
  • page

    Page number

  • pagesize

    Number of orders per page. By default upto 100 orders will be returned

  • id

    This is the channel Order Id. e.g eBay /Amazon

  • status

    This is the order status. If this is empty, all orders will be sent.

  • warehouseid

    This is the warehouse id. Orders with Products assigned to warehouse will be returned. Warehouse Id can be found by going into Settings->Warehouse section

  • from_date

    This is the last order update date. If this is empty, all orders will be sent.
    Date format yyyy-MM-dd'T'HH:mm:ss e.g 2018-01-28

  • to_date

    This is the last order status. If this is empty, all orders upto the current time willbe sent
    Date format yyyy-MM-dd'T'HH:mm:ss e.g 2018-01-28

Order

You can use the order API to retrieve order and update order status back

Get Order

This endpoint returns the order for the given order id.

GET  /order?order_id=channel order id&key=xxxx&secret=yyyy

Attributes
  • page

    Page number

  • pagesize

    Number of orders per page. By default upto 100 orders will be returned

  • order_id

    This is the channel Order Id. e.g eBay /Amazon order id

  • status

    This is the order status. If this is empty, all orders will be sent.

Create Order

This endpoint creates a new order

POST  /order?key=xxxx&secret=yyyy

Attributes
  • order_id

    Order Id for the new order. If empty, a unique order id will be created

  • status

    This is the order status. If this is empty, the new order will be created in un-shipped status. Valid values for this are
    Shipped
    Cancelled
    Pending
    Unshipped

  • order details

    Please see the sample JSON request

A Sample JSON Request

A Sample JSON text is shown below



								{"orderId":"23232abc232434","shipPostalCode":"RG2 6UU","shipAddress1":"450 Richborough Close","shipAddress2":"Line 2","shipCity":"City","shipCountry":"UK","shipCountryCode":"GB","channelSales":[{"qty":1,"title":"Test","sku":"1234","price":23.39,"totalprice":34.56,"taxamount":12.33}],"channelId":608}


								


							

Update Order Status

This endpoint will update the order status for the given order id. Order status will be updated to the respective channel

PUT  /orders?order_id=channel order id&key=xxxx&secret=yyyy

Attributes
  • order_id

    This is the channel order id.

  • status

    One of following Order status Values:
    Shipped, Cancelled, Pending, Unshipped, Complete,

  • tracking_id

    Tracking number

  • carrier

    Carrier name

  • weight_kg

    Weight in Kg

  • weight_g

    Weight in grams

  • weight_lb

    Weight in Lb

  • weight_oz

    Weight in Ounces

  • shipping_method

    Shipping Method for the carrier

  • shipment_date

    Order fulfill/shipped date
    (yyyy-MM-dd'T'HH:mm:ss e.g 2018-01-28)

  • cancel_reason

    Cancel reason only for cancelled orders

  • channel

    Channel for this order. This is optional but recommened to use the correct channel name while updating order status incase if the same order id exists in more than one channel. Valid channel values for some are :
    ebay, amazon, woocommerce, magento, shopify, bigcommerce, sears
    For the full list, please use the API GET method channels

Move To A Folder

This endpoint will make the given order to a folder

PUT  /moveordertofolder?selro_order_id=&key=&secret=&foldername=

Attributes
  • selro_order_id

    This is the Selro order id.

  • foldername

    Folder Name. If the folder name doesn't exist in Selro, this will create a new folder and move the order to that folder. If the folder name is empty, the order will be moved out of the current folder.

Update Stock Levels

This endpoint will update the stock levels into selling channels

Update Inventory Levels

This endpoint will update the stock levels into selling channels

PUT  /stock?sku=xxx&qty=yyy

Attributes
  • qty

    Quantity

  • listingqty

    Listing Qty. If this is empty full qty will be sent to channels. Please note that listing Qty value will apply for all channels

  • sku

    Product SKU - Stock Keeping Unit. Must be present if id is empty

  • warehouseid

    Warehouse Id. You can find the warehouse id from Warehouse setting. This is optional and if the warehouse id is specified, the stock will be allocated for that warehouse/SKU. If there is not location allocated for the SKU, the new location will be created. If there more than one location available for the SKU, the stock will be allocated to the first location. Qty specified must be the full qty available for that location as the given qty will be applied for the warehouse/location.

Get Stock Levels

This endpoint gets inventory levels from your Selro inventory

GET  /stock

Attributes
  • page

    Page number

Get Stock Level for SKU

This endpoint will inventory levels from your Selro inventory

GET  /stock?sku={sku}

Attributes
  • sku

    SKU - Stock Keeping Unit

  • warehouseid

    This is optional. You can find the warehouse id from Warehouse setting. If the warehouse id is specified, the stock level will be from the given warehouse.

Get Categories

This endpoint provides the capability to manage the Selro categories

Get Categories

This endpoint will return all the Selro categories

GET  /categories

Attributes
  • None


API keys

API Keys and URL will be available under Channel Settings API tab

Please check the API URL under API tab in your Selro account
Please check the API URL under API tab in your Selro account

Add Category

This endpoint will add a new category

POST  /category

Attributes
  • name

    Category name

  • parentId

    Parent Id (optional)

API keys

API Keys will be available under Channel Settings API tab

https://[server name].selro.com/api

Delete Category

This endpoint will delete the category

DELETE  /category?id={id}

Attributes
  • sku

    SKU - Stock Keeping Unit

API keys

API Keys will be available under Channel Settings API tab

https://[server name].selro.com/api