NAV
shell

Introduction

SELLinALL Developer Experience

Manage multiple channel selling with SELLinALL robust APIs. Open the door for multiple marketplaces such as eBay, Amazon, Lazada, Qoo10...

Welcome to the SELLinALL API! You can use our API to access SELLinALL API endpoints, which can get information on inventory and orders that are present on our system.

We have language bindings in Shell, Ruby, and Python! You can view code examples in the dark area to the right, and you can switch the programming language of the examples with the tabs in the top right.

This API documentation page was created by SELLinALL Team. Feel free to send feedbact to developer@sellinall.com for any query.

Authentication

To authorize, use this code:

require 'kittn'

api = Kittn::APIClient.authorize!('meowmeowmeow')
import kittn

api = kittn.authorize('meowmeowmeow')
# With shell, you can just pass the correct header with each request
curl "api_endpoint_here"
  -H "accountNumber: 12121212121212121"   
  -H "appKey: 2121212121"

Make sure to replace secret with your APP key.

SELLinALL uses APP keys to allow access to the developer APIs. To register your applicaion with us, please send an email to developer@sellinall.com .

SELLinALL expects APP key and seller account number to be included in all API requests to the server in the header that looks like the following:

accountNumber: <seller account number >

appKey: <Application key given to you >

Fields

Amount

All amount fields in SiA is using the below format amount

Field Meaning
amount Example if the amount is 10.99 it will be demoted as 1099
Currency code Example SGD, IDR, INR, USD ...

Create account

Kartrocket

require 'kittn'
                api = Kittn::APIClient.authorize!('meowmeowmeow')
                api.inventory.get(2)
                
            
import kittn
                api = kittn.authorize('meowmeowmeow')
                api.inventory.get(2)
                
            

curl "https://api.sellinall.com/v1/accounts/channels/kartrocket"
  -H "Content-Type: application/json"
  -H "appKey: 2121212121"

Request payload:

            
{
  "SELLinALLId": "testkartrocket@gmail.com",
  "name": "user name",
  "phoneNumber": "+915464645423",
  "kartrocket": {
    "kartrocketApiKey": "1f0e3dad99908345f7439f8ffabdffc4",
    "kartrocketWebUrl": "http://testaccount.kartrocket.co"
  }
}
            
            

Response payload:

                           
{
  "accountNumber": "5a4e44b3a67a6d000489e5a8",
  "status": "success",
  "url": "https://dev.sellonall.com/Dash/signup/index.html?userId=5a4e44b4e4b0b058034e7975&accountNumber=5a4e44b3a67a6d000489e5a8&isTrusted=true",
  "responseMessage": "Your account creation request has been successful. Fill the password and complete the registration."
}
            
            

Create SELLinALL account and add kartrocket account

HTTP Request

POST https://api.sellinall.com/v1/accounts/channels/kartrocket

Error message

Error message Meaning
failure The request might not be in correct format.

Request parameters

Field Type Description
SELLinALLId String User email ID
name String User name
phoneNumber int Phone number
pricingCategory String T - Trial account, P - Premium account
kartrocket Object
"kartrocket": {
  "kartrocketApiKey": "1f0e3dad99908345f7439f8ffabdffc4",
  "kartrocketWebUrl": "http://testaccount.kartrocket.co"
}
  • kartrocketApiKey :The kartrocket API KEY
  • kartrocketWebUrl :The kartrocket web URL

Lazada

require 'kittn'
                api = Kittn::APIClient.authorize!('meowmeowmeow')
                api.inventory.get(2)
                
            
import kittn
                api = kittn.authorize('meowmeowmeow')
                api.inventory.get(2)
                
            

curl "https://api.sellinall.com/v1/accounts/channels/lazada"
  -H "Content-Type: application/json"
  -H "appKey: 2121212121"

Request payload:

            
{
  "SELLinALLId": "testlazada@gmail.com",
  "name": "new account112",
  "phoneNumber": "+915464645423",
  "pricingCategory":"T",
  "lazada": {
    "userID": "abc",
    "apikey": "abcdef",
    "countryCode":"SG"
  }
}
            
            

Response payload:

                           
{
  "accountNumber": "5a4e46e7a67a6d000489e5ae",
  "status": "success",
  "url": "https://dev.sellonall.com/Dash/signup/index.html?userId=5a4e46e7e4b0b058034e7978&accountNumber=5a4e46e7a67a6d000489e5ae&isTrusted=true",
  "responseMessage": "Your account creation request has been successful. Fill the password and complete the registration."
}
            
            

Create SELLinALL account and add lazada account

HTTP Request

POST https://api.sellinall.com/v1/accounts/channels/lazada

Error message

Error message Meaning
failure The request might not be in correct format.

Request parameters

Field Type Description
SELLinALLId String User email ID
name String User name
phoneNumber int Phone number
pricingCategory String T - Trial account, P - Premium account
lazada Object
"lazada": {
  "userID": "abc",
  "apikey": "abcdef"
  "countryCode": "SG"
}
  • userID: The user id given by lazada
  • apikey: The apikey given by lazada
  • countryCode: The accepted country codes are SG, ID, MY, PH, TH.

Inventory

Create inventory

require 'kittn'
                api = Kittn::APIClient.authorize!('meowmeowmeow')
                api.inventory.get(2)
                
            
import kittn
                api = kittn.authorize('meowmeowmeow')
                api.inventory.get(2)
                
            

curl "https://api.sellinall.com/v1/inventory"
  -H "Content-Type: application/json"
  -H "accountNumber: 12121212121212121"   
  -H "appKey: 2121212121"

Request payload:

            
{
  "data": [
    {
      "customSKU": "ABC1",
      "itemTitle": "Create a inventory",
      "noOfItem": 5,
      "itemAmount": {
        "amount": 2300,
        "currencyCode": "SGD"
      }
    },
    {
      "customSKU": "ABC2",
      "itemTitle": "Create a inventory with Desc imageUrl",
      "noOfItem": 5,
      "imageURL": [
        "http://dev.sellonall.com/uploads/BSE/Shinmudra-1510663010/0c998926cd0211c195f08461040915d0.jpg",
        "http://lh4.ggpht.com/_hVfE2qcyzXU/TUrPL2S6QFI/AAAAAAAABzk/F_sr7JjtdI0/s800/creative-mugs-on-off.jpg"
      ],
      "itemDescription": "Test product",
      "itemAmount": {
        "amount": 3300,
        "currencyCode": "SGD"
      }
    },
    {
      "itemTitle": "Variant and add on items example",
      "itemDescription": "Variants",
      "variants": [
        {
          "title": "size",
          "names": [
            "XL",
            "XXL"
          ]
        },
        {
          "title": "color",
          "names": [
            "Red",
            "Blue"
          ]
        },
        {
          "title": "Warranty",
          "names": [
            "3 months cover",
            "6 months cover"
          ],
          "isOption":true
        }
      ],
      "variantSpecifics": [
        {
          "variantDetails": [
            {
              "title": "size",
              "name": "XL"
            },
            {
              "title": "color",
              "name": "Red"
            }
          ],
          "imageURL": [
            "https://1123566363.rsc.cdn77.org/app/uploads/2016/06/United-bottles-Packaging-bouteille-vertes-wn110.png"
          ],
          "noOfItem": 2,
          "itemAmount": {
            "amount": 1100,
            "currencyCode": "SGD"
          },
          "customSKU": "Variants001"
        },
        {
          "variantDetails": [
            {
              "title": "size",
              "name": "XL"
            },
            {
              "title": "color",
              "name": "Blue"
            }
          ],
          "imageURL": [
            "https://1123566363.rsc.cdn77.org/app/uploads/United-bottles-Packaging-blue-bottles-330ml-bn052.png"
          ],
          "noOfItem": 3,
          "itemAmount": {
            "amount": 2200,
            "currencyCode": "SGD"
          },
          "customSKU": "Variants002"
        },
        {
          "variantDetails": [
            {
              "title": "size",
              "name": "XXL"
            },
            {
              "title": "color",
              "name": "Red"
            }
          ],
          "imageURL": [
            "http://www.thecarycompany.com/media/catalog/product/1/2/12-oz-amber-heritage-beer-bottle_2.jpg"
          ],
          "noOfItem": 4,
          "itemAmount": {
            "amount": 3300,
            "currencyCode": "SGD"
          },
          "customSKU": "Variants003"
        },
        {
          "variantDetails": [
            {
              "title": "size",
              "name": "XXL"
            },
            {
              "title": "color",
              "name": "Blue"
            }
          ],
          "imageURL": [
            "https://ideon.co.uk/media/catalog/product/cache/1/image/900x760/9df78eab33525d08d6e5fb8d27136e95/3/3/330ml_mountain_bottle_1.jpg"
          ],
          "noOfItem": 5,
          "itemAmount": {
            "amount": 4400,
            "currencyCode": "SGD"
          },
          "customSKU": "Variants004"
        },
        {
          "variantDetails": [
            {
              "title": "Warranty",
              "name": "3 months cover"
            }
          ],
          "imageURL": [
            "https://ideon.co.uk/media/catalog/product/cache/1/image/900x760/9df78eab33525d08d6e5fb8d27136e95/3/3/330ml_mountain_bottle_1.jpg"
          ],
          "noOfItem": 1,
          "itemAmount": {
            "amount": 400,
            "currencyCode": "SGD"
          },
          "customSKU": "Variants005",
          "isOption": true
        },
        {
          "variantDetails": [
            {
              "title": "Warranty",
              "name": "6 months cover"
            }
          ],
          "imageURL": [
            "https://ideon.co.uk/media/catalog/product/cache/1/image/900x760/9df78eab33525d08d6e5fb8d27136e95/3/3/330ml_mountain_bottle_1.jpg"
          ],
          "noOfItem": 1,
          "itemAmount": {
            "amount": 600,
            "currencyCode": "SGD"
          },
          "customSKU": "Variants006",
          "isOption": true
        }
      ]
    }
  ]
}
            
            

Response payload:

                           
{
  "result": [
    {
      "response": {
        "itemTitle": "Create a inventory with external api",
        "customSKU": "ABC1",
        "noOfItem": 5,
        "itemAmount": {
          "amount": 2300,
          "currencyCode": "SGD"
        },
        "SKU": "BRD0000001"
      },
      "status": "success",
      "httpCode": 201
    },
    {
      "status": "failure",
      "errorMessage": "This customSKU [ ABC ] already exists for [ BRD0000003 ].",
      "response": {
        "customSKU": "ABC",
        "itemTitle": "toys",
        "noOfItem": 5,
        "itemAmount": {
          "amount": 2300,
          "currencyCode": "SGD"
        }
      },
      "httpCode": 400
    },
    {
      "status": "success",
      "response": {
        "itemTitle": "Variant and add on items example",
        "itemDescription": "Variants",
        "imageURL": [
          "http://dev.sellonall.com/uploads/BSE/Shinmudra-1514977993/1.png",
          "http://dev.sellonall.com/uploads/BSE/Shinmudra-1514977994/1.png",
          "http://dev.sellonall.com/uploads/BSE/Shinmudra-1514977995/1.jpeg",
          "http://dev.sellonall.com/uploads/BSE/Shinmudra-1514977995/2.jpeg",
          "http://dev.sellonall.com/uploads/BSE/Shinmudra-1514977999/1.jpeg",
          "http://dev.sellonall.com/uploads/BSE/Shinmudra-1514978001/1.jpeg"
        ],
        "variants": [
          {
            "title": "size",
            "names": [
              "XL",
              "XXL"
            ]
          },
          {
            "title": "color",
            "names": [
              "Red",
              "Blue"
            ]
          },
          {
            "title": "Warranty",
            "names": [
              "3 months cover",
              "6 months cover"
            ],
            "isOption": true
          }
        ],
        "variantSpecifics": [
          {
            "variantDetails": [
              {
                "title": "size",
                "name": "XL"
              },
              {
                "title": "color",
                "name": "Red"
              }
            ],
            "noOfItem": 2,
            "imageURL": [
              "http://dev.sellonall.com/uploads/BSE/Shinmudra-1514977993/1.png"
            ],
            "itemAmount": {
              "amount": 1100,
              "currencyCode": "SGD"
            },
            "customSKU": "Variants001"
          },
          {
            "variantDetails": [
              {
                "title": "size",
                "name": "XL"
              },
              {
                "title": "color",
                "name": "Blue"
              }
            ],
            "noOfItem": 3,
            "imageURL": [
              "http://dev.sellonall.com/uploads/BSE/Shinmudra-1514977994/1.png"
            ],
            "itemAmount": {
              "amount": 2200,
              "currencyCode": "SGD"
            },
            "customSKU": "Variants002"
          },
          {
            "variantDetails": [
              {
                "title": "size",
                "name": "XXL"
              },
              {
                "title": "color",
                "name": "Red"
              }
            ],
            "noOfItem": 4,
            "imageURL": [
              "http://dev.sellonall.com/uploads/BSE/Shinmudra-1514977995/1.jpeg"
            ],
            "itemAmount": {
              "amount": 3300,
              "currencyCode": "SGD"
            },
            "customSKU": "Variants003"
          },
          {
            "variantDetails": [
              {
                "title": "size",
                "name": "XXL"
              },
              {
                "title": "color",
                "name": "Blue"
              }
            ],
            "noOfItem": 5,
            "imageURL": [
              "http://dev.sellonall.com/uploads/BSE/Shinmudra-1514977995/2.jpeg"
            ],
            "itemAmount": {
              "amount": 4400,
              "currencyCode": "SGD"
            },
            "customSKU": "Variants004"
          },
          {
            "variantDetails": [
              {
                "title": "Warranty",
                "name": "3 months cover"
              }
            ],
            "noOfItem": 1,
            "imageURL": [
              "http://dev.sellonall.com/uploads/BSE/Shinmudra-1514977999/1.jpeg"
            ],
            "itemAmount": {
              "amount": 400,
              "currencyCode": "SGD"
            },
            "customSKU": "Variants005",
            "isOption": true
          },
          {
            "variantDetails": [
              {
                "title": "Warranty",
                "name": "6 months cover"
              }
            ],
            "noOfItem": 1,
            "imageURL": [
              "http://dev.sellonall.com/uploads/BSE/Shinmudra-1514978001/1.jpeg"
            ],
            "itemAmount": {
              "amount": 600,
              "currencyCode": "SGD"
            },
            "customSKU": "Variants006",
            "isOption": true
          }
        ],
        "SKU": "BRD0000005"
      },
      "httpCode": 201
    }
  ]
}
            
            

This endpoint create inventories.

HTTP Request

POST https://api.sellinall.com/v1/inventory

Error message

Error message Meaning
failure The request might not be in correct format.

Request parameters

Field Type Description
customSKU String Unique identifier for the product in the shop.The create inventory will fail, if the customSKU is duplicate.
itemTitle String The title of the product
noOfItem int The number of items
imageURL(optional) Array The image URLs of the item
itemDescription(optional) String Description of the item.
itemAmount Object
"itemAmount": {
  "amount": 2300,
  "currencyCode": "SGD"
}
  • amount :The price of the product
  • currencyCode :The currency specific to the marketplace
variants ArrayList
"variants": [
    {
      "title": "size",
      "names": [
        "XL",
        "XXL"
      ]
    },
    {
      "title": "color",
      "names": [
        "Red",
        "Blue"
      ]
    },
    {
      "title": "Warranty",
      "names": [
        "3 months cover",
        "6 months cover"
      ],
      "isOption":true
    }
  ]
  • title :The title of the variation.
  • names :The variation title specific names.
  • isOption :The flag "isOption": true is to indicates that the given variant is addOn
variantSpecifics ArrayList
"variantSpecifics": [
        {
          "variantDetails": [
            {
              "title": "size",
              "name": "XL"
            },
            {
              "title": "color",
              "name": "Red"
            }
          ],
          "imageURL": [
            "https://1123566363.rsc.cdn77.org/app/uploads/2016/06/United-bottles-Packaging-bouteille-vertes-wn110.png"
          ],
          "noOfItem": 2,
          "itemAmount": {
            "amount": 1100,
            "currencyCode": "SGD"
          },
          "customSKU": "Variants001"
        },
        {
          "variantDetails": [
            {
              "title": "size",
              "name": "XL"
            },
            {
              "title": "color",
              "name": "Blue"
            }
          ],
          "imageURL": [
            "https://1123566363.rsc.cdn77.org/app/uploads/United-bottles-Packaging-blue-bottles-330ml-bn052.png"
          ],
          "noOfItem": 3,
          "itemAmount": {
            "amount": 2200,
            "currencyCode": "SGD"
          },
          "customSKU": "Variants002"
        },
        {
          "variantDetails": [
            {
              "title": "size",
              "name": "XXL"
            },
            {
              "title": "color",
              "name": "Red"
            }
          ],
          "imageURL": [
            "http://www.thecarycompany.com/media/catalog/product/1/2/12-oz-amber-heritage-beer-bottle_2.jpg"
          ],
          "noOfItem": 4,
          "itemAmount": {
            "amount": 3300,
            "currencyCode": "SGD"
          },
          "customSKU": "Variants003"
        },
        {
          "variantDetails": [
            {
              "title": "size",
              "name": "XXL"
            },
            {
              "title": "color",
              "name": "Blue"
            }
          ],
          "imageURL": [
            "https://ideon.co.uk/media/catalog/product/cache/1/image/900x760/9df78eab33525d08d6e5fb8d27136e95/3/3/330ml_mountain_bottle_1.jpg"
          ],
          "noOfItem": 5,
          "itemAmount": {
            "amount": 4400,
            "currencyCode": "SGD"
          },
          "customSKU": "Variants004"
        },
        {
          "variantDetails": [
            {
              "title": "Warranty",
              "name": "3 months cover"
            }
          ],
          "imageURL": [
            "https://ideon.co.uk/media/catalog/product/cache/1/image/900x760/9df78eab33525d08d6e5fb8d27136e95/3/3/330ml_mountain_bottle_1.jpg"
          ],
          "noOfItem": 1,
          "itemAmount": {
            "amount": 400,
            "currencyCode": "SGD"
          },
          "customSKU": "Variants005",
          "isOption": true
        },
        {
          "variantDetails": [
            {
              "title": "Warranty",
              "name": "6 months cover"
            }
          ],
          "imageURL": [
            "https://ideon.co.uk/media/catalog/product/cache/1/image/900x760/9df78eab33525d08d6e5fb8d27136e95/3/3/330ml_mountain_bottle_1.jpg"
          ],
          "noOfItem": 1,
          "itemAmount": {
            "amount": 600,
            "currencyCode": "SGD"
          },
          "customSKU": "Variants006",
          "isOption": true
        }
      ]
    }
  ]
  • variantSpecifics :Contains list of variant item formed by the combination of variants title and name.
  • variantDetails :Combination formed by the variants title and name.
  • isOption :The flag "isOption": true is to indicates that the given variant is addOn

Update inventory

require 'kittn'
                api = Kittn::APIClient.authorize!('meowmeowmeow')
                api.inventory.get(2)
                
            
import kittn
                api = kittn.authorize('meowmeowmeow')
                api.inventory.get(2)
                
            

curl "https://api.sellinall.com/v1/inventory"
  -H "Content-Type: application/json"
  -H "accountNumber: 12121212121212121"   
  -H "appKey: 2121212121"

Request payload:

            
{
  "data": [
    {
      "customSKU": "ABC1",
      "noOfItem": 5,
      "itemAmount": {
        "amount": 2300,
        "currencyCode": "SGD"
      }
    },
    {
      "customSKU": "ABC2",
      "noOfItem": 5,
      "itemAmount": {
        "amount": 3300,
        "currencyCode": "SGD"
      }
    }
  ]
}
            
            

Response payload:

            
{
  "result": [
    {
      "customSKU": "ABC1",
      "httpCode": 200
    },
    {
      "customSKU": "ABC2",
      "errorMessage": "The customSKU not found",
      "httpCode": 404
    }
  ]
}
            
            

This endpoint updates the amount and quantity.

HTTP Request

PUT https://api.sellinall.com/v1/inventory

Error message

Error message Meaning
errorMessage customSKU does not exist

Update inventory quantity [Deprecated]

require 'kittn'
                api = Kittn::APIClient.authorize!('meowmeowmeow')
                api.inventory.get(2)
                
            
import kittn
                api = kittn.authorize('meowmeowmeow')
                api.inventory.get(2)
                
            

curl "https://api.sellinall.com/v1/inventory/quantity"
  -H "accountNumber: 12121212121212121"   
  -H "appKey: 2121212121"


            

Request payload:


{
  "data": [
    {
      "customSKU": "ABC0001",
      "quantity": 10
    },
    {
      "customSKU": "ABC0002",
      "quantity": 20
    }
  ]
}

            

Response payload:



{
 "result": [
   {
     "status": "success",
     "customSKU": "ABC0001",
     "updatedQuantity": 10,
     "httpCode": 200
   },
   {
    "status": "failure",
    "httpCode": 404,
    "customSKU": "ABC0002"
   }
 ]
}

            

Use this API to update the quantity - click here

This endpoint updates the quantity.

HTTP Request

PUT https://api.sellinall.com/v1/inventory/quantity

Request parameters

Field Type Description
customSKU String The given quantity will be updated to this customSKU.The update will fail, if the customSKU does not not exist.
quantity int The number of items to be updated

Update inventory quantity diff [Deprecated]

require 'kittn'
                api = Kittn::APIClient.authorize!('meowmeowmeow')
                api.inventory.get(2)
                
            
import kittn
                api = kittn.authorize('meowmeowmeow')
                api.inventory.get(2)
                
            

curl "https://api.sellinall.com/v1/inventory/quantityDiff"
  -H "accountNumber: 12121212121212121"   
  -H "appKey: 2121212121"


            

Request payload:


{
  "data": [
    {
      "customSKU": "ABC0001",
      "quantityDiff": 10
    },
    {
      "customSKU": "ABC0002",
      "quantityDiff": -10
    }
  ]
}

            

Response payload:



{
 "result": [
   {
     "status": "success",
     "customSKU": "ABC0001",
     "updatedQuantity": 55,
     "httpCode": 200
   },
   {
     "status": "failure",
     "httpCode": 404,
     "customSKU": "ABC0002"
   }
 ]
}

            

Use this API to update the quantity diff - click here

This endpoint updates the quantity diff.

HTTP Request

PUT https://api.sellinall.com/v1/inventory/quantityDiff

Request parameters

Field Type Description
customSKU String The given quantityDiff will be added to this customSKU.The update will fail, if the customSKU does not exist.
quantityDiff int The number of items to be added to the existing inventory

Add variant

require 'kittn'
                api = Kittn::APIClient.authorize!('meowmeowmeow')
                api.inventory.get(2)
                
            
import kittn
                api = kittn.authorize('meowmeowmeow')
                api.inventory.get(2)
                
            

curl "https://api.sellinall.com/v1/inventory/variants"
  -H "accountNumber: 12121212121212121"   
  -H "appKey: 2121212121"


            

Request payload:


{
  "data": [
    {
      "parentSKU": "ABC000005",
      "variantSpecifics": [
        {
          "variantDetails": [
            {
              "title": "Size",
              "name": "XLL"
            },
            {
              "title": "Color",
              "name": "Red"
            }
          ],
          "imageURL": [
            "http://test1.pupsikstudio.com/media/catalog/product/b/p/bpillow_nadya_49.jpg"
          ],
          "noOfItem": 2,
          "itemAmount": {
            "amount": 1100,
            "currencyCode": "SGD"
          },
          "customSKU": "Variants0001"
        },
        {
          "variantDetails": [
            {
              "title": "Size",
              "name": "XL"
            },
            {
              "title": "Color",
              "name": "Blue1"
            }
          ],
          "imageURL": [
            "http://test1.pupsikstudio.com/media/catalog/product/b/p/bpillow_nadya_49.jpg"
          ],
          "noOfItem": 3,
          "itemAmount": {
            "amount": 2200,
            "currencyCode": "SGD"
          },
          "customSKU": "Variants0002"
        }
      ]
    }
  ]
}

            

Response payload:



{
  "result": [
    {
      "response": {
        "parentSKU": "ABC000005",
        "variantSpecifics": [
          {
            "variantDetails": [
              {
                "title": "Size",
                "name": "XLL"
              },
              {
                "title": "Color",
                "name": "Red"
              }
            ],
            "imageURL": [
              "http://dev.sellonall.com/uploads/BRD/Shinmudra-1517565397/1.jpeg"
            ],
            "noOfItem": 2,
            "itemAmount": {
              "amount": 1100,
              "currencyCode": "SGD"
            },
            "customSKU": "Variants0001",
            "SKU": "ABC000005-05"
          },
          {
            "variantDetails": [
              {
                "title": "Size",
                "name": "XL"
              },
              {
                "title": "Color",
                "name": "Blue1"
              }
            ],
            "imageURL": [
              "http://dev.sellonall.com/uploads/BRD/Shinmudra-1517565401/1.jpeg"
            ],
            "noOfItem": 3,
            "itemAmount": {
              "amount": 2200,
              "currencyCode": "SGD"
            },
            "customSKU": "Variants0002",
            "SKU": "ABC000005-06"
          }
        ]
      },
      "httpCode": 201
    }
  ]
}

            

This endpoint used to add variant for existing inventory.

HTTP Request

POST https://api.sellinall.com/v1/inventory/variants

Request parameters

Field Type Description
parentSKU String Unique identifier for the product in the SELLinALL.
variantSpecifics ArrayList
"variantSpecifics": [
        {
          "variantDetails": [
            {
              "title": "Size",
              "name": "XLL"
            },
            {
              "title": "Color",
              "name": "Red"
            }
          ],
          "imageURL": [
            "http://test1.pupsikstudio.com/media/catalog/product/b/p/bpillow_nadya_49.jpg"
          ],
          "noOfItem": 2,
          "itemAmount": {
            "amount": 1100,
            "currencyCode": "SGD"
          },
          "customSKU": "Variants0001"
        },
        {
          "variantDetails": [
            {
              "title": "Size",
              "name": "XL"
            },
            {
              "title": "Color",
              "name": "Blue1"
            }
          ],
          "imageURL": [
            "http://test1.pupsikstudio.com/media/catalog/product/b/p/bpillow_nadya_49.jpg"
          ],
          "noOfItem": 3,
          "itemAmount": {
            "amount": 2200,
            "currencyCode": "SGD"
          },
          "customSKU": "Variants0002"
        }
      ]
  • variantSpecifics :Contains list of variant item formed by the combination of variants title and name.
  • variantDetails :Combination formed by the variants title and name.

Product Master

Create

require 'kittn'
                api = Kittn::APIClient.authorize!('meowmeowmeow')
                api.inventory.get(2)
                
            
import kittn
                api = kittn.authorize('meowmeowmeow')
                api.inventory.get(2)
                
            

curl "https://api.sellinall.com/v1/productMaster/item"
  -H "Content-Type: application/json"
  -H "appKey: 4c6a4356-345c-4d85-b0cf-ba74ba6hg9d4a"
  -H "accountNumber: 12121212121212121"

Request payload:

            
{
  "sellerSKU": "abcd",
  "productID": "Inventory01",
  "itemTitle": "100% Pure Cotton Baby Boy Girl Romper Summer Short Sleeved Cartoon Jumpsuit",
  "shortDescription": "short description",
  "itemDescription": "item description",
  "itemTitle_thTH": "ผ้าฝ้ายแท้ 100% เด็กทารกสาว Romper ฤดูร้อนการ์ตูน Jumpsuit แขนสั้น",
  "shortDescription_thTH": "คำอธิบายสั้น",
  "itemDescription_thTH": "รายละเอียดสินค้า",
  "imageURLs": [
    "https://images.sellinall.com/uploads/FMT/Shinmudra-U-FMT0002470/3.jpeg",
    "https://images.sellinall.com/uploads/FMT/Shinmudra-U-FMT0002470/3.jpeg"
  ],
  "sizeChartImageURL": "https://images.sellinall.com/uploads/FMT/Shinmudra-U-FMT0002470/3.jpeg",
  "quantities": [
    {
      "warehouseID": "satsaco-1",
      "quantity": 30
    },
    {
      "warehouseID": "infor-1",
      "quantity": 25
    }
  ],
  "price": [
    {
      "currencyCode": "SGD",
      "retailPrice": {
        "amount": 12000,
        "currencyCode": "SGD"
      },
      "salePrice": {
        "amount": 10000,
        "currencyCode": "SGD"
      }
    },
    {
      "currencyCode": "USD",
      "retailPrice": {
        "amount": 12000,
        "currencyCode": "USD"
      },
      "salePrice": {
        "amount": 11000,
        "currencyCode": "USD"
      }
    },
    {
      "currencyCode": "MYR",
      "retailPrice": {
        "amount": 12000,
        "currencyCode": "MYR"
      },
      "salePrice": {
        "amount": 11000,
        "currencyCode": "MYR"
      }
    }
  ],
  "variantAttributes": [
    {
      "key": "color-family",
      "value": "blue"
    },
    {
      "key": "Size",
      "value": "XL"
    },
    {
      "key_thTH": "สีของครอบครัว",
      "value_thTH": "สีน้ำเงิน"
    },
    {
      "key_thTH": "ขนาด",
      "value_thTH": "XL"
    }
  ],
  "otherAttributes": [
    {
      "key": "gender",
      "values": [
        "Male"
      ]
    },
    {
      "key": "brand",
      "values": [
        "PUMA"
      ]
    },
    {
      "key": "tags",
      "values": [
        "mobile",
        "back case"
      ]
    },
    {
      "key_thTH": "เพศ",
      "values_thTH": [
        "ชาย"
      ]
    },
    {
      "key_thTH": "ยี่ห้อ",
      "values_thTH": [
        "PUMA"
      ]
    },
    {
      "key_thTH": "แท็ก",
      "values_thTH": [
        "โทรศัพท์มือถือ",
        "กรณีหลัง"
      ]
    }
  ],
  "packageLengthInCM": 10,
  "packageWidthInCM": 10,
  "packageHeightInCM": 10,
  "packageWeightInKG": 1
}
            
            

Response payload:

             
SUCCESS:

HTTP status: 201 CREATED

FAILURE:

HTTP status: 400

{
    "errorMessage": "sellerSku : fxlm already exists"
}

            
            

Create product master

HTTP Request

POST https://api.sellinall.com/v1/productMaster/item

Request parameters

Field Type Required Description
sellerSKU String Yes The product SKU (stock keeping unit) is an identifier defined by a seller. This will be assigned to the product while listing to marketplaces
productID String Yes A productID defined by seller for the group for related skus. It is used to group the products while listing as variants.
itemTitle String Yes The title of the product
shortDescription String No Highlights of the product.
itemDescription String Yes Description of the product
itemTitle_thTH String No The title of the product in thai language
  • thTH: Combination of thai language code and Thailand countryCode in ISO standard
  • Language code: Should be in smaller case
  • Country code: Should be in upper case
  • Please refer ISO language codes and country codes
shortDescription_thTH String No Highlights of the product in thai language
itemDescription_thTH String No Description of the product in thai language
imageURLs Array Yes The image URLs of the product
sizeChartImageURL String No The SizeChartImage URL of the product
quantities Array Yes
quantities": [
    {
      "warehouseID": "satsaco-1",
      "quantity": 30
    },
    {
      "warehouseID": "infor-1",
      "quantity": 25
    }
  ]
Quantities based on warehouse
  • warehouseID: Use the warehouseIDs linked to SiA. Default warehouseID value is MyStock-1
price Array Yes
"price": [
    {
      "currencyCode": "SGD",
      "retailPrice": {
        "amount": 12000,
        "currencyCode": "SGD"
      },
      "salePrice": {
        "amount": 10000,
        "currencyCode": "SGD"
      }
    },
    {
      "currencyCode": "USD",
      "retailPrice": {
        "amount": 12000,
        "currencyCode": "USD"
      },
      "salePrice": {
        "amount": 11000,
        "currencyCode": "USD"
      }
    }
  ]
The price of the product in different currencies.
  • currencyCode: It should be unique in each object in the array. The retailPrice and salePrice is assigned based on the currencyCode in each object.
variantAttributes Array no
"variantAttributes": [
    {
      "key": "color-family",
      "value": "blue"
    },
    {
      "key": "Size",
      "value": "XL"
    },
    {
      "key_thTH": "สีของครอบครัว",
      "value_thTH": "สีน้ำเงิน"
    },
    {
      "key_thTH": "ขนาด",
      "value_thTH": "XL"
    }
  ]
The variant details of the product, this field is required, if the item belongs to variation.
  • key: represents variant name like color, size.
  • value: represent variant value like red, xl.
otherAttributes Array no
"otherAttributes": [
    {
      "key": "gender",
      "values": [
        "Male"
      ]
    },
    {
      "key": "brand",
      "values": [
        "PUMA"
      ]
    },
    {
      "key": "tags",
      "values": [
        "mobile",
        "back case"
      ]
    },
    {
      "key_thTH": "เพศ",
      "values_thTH": [
        "ชาย"
      ]
    },
    {
      "key_thTH": "ยี่ห้อ",
      "values_thTH": [
        "PUMA"
      ]
    },
    {
      "key_thTH": "แท็ก",
      "values_thTH": [
        "โทรศัพท์มือถือ",
        "กรณีหลัง"
      ]
    }
  ]
All common attributes of products.
  • key: It is an attribute name
  • values It must contain atleast one value
packageLenthInCM String Yes Package length. The unit is cm
packageWidthInCM String Yes Package width. The unit is cm
packageHeightInCM String Yes Package height. The unit is cm
packageWeightInKG String Yes Package weight. The unit is kg

Update

require 'kittn'
                api = Kittn::APIClient.authorize!('meowmeowmeow')
                api.inventory.get(2)
                
            
import kittn
                api = kittn.authorize('meowmeowmeow')
                api.inventory.get(2)
                
            

curl "https://api.sellinall.com/v1/productMaster/item"
  -H "Content-Type: application/json"
  -H "appKey: 4c6a4356-345c-4d85-b0cf-ba74ba6hg9d4a"
  -H "accountNumber: 12121212121212121"

Request payload:

            
Example payload 1:

{
  "sellerSKU": "abcd",
  "itemTitle": "100% Pure Cotton Sleeved Cartoon Jumpsuit",
  "shortDescription": "new short description"
}

Example payload 2:

{
  "sellerSKU": "abcd",
  "quantities": [
    {
      "warehouseID": "satsaco-1",
      "quantity": 5
    },
    {
      "warehouseID": "infor-1",
      "quantity": 4
    }
  ]
}


Example payload 3:

{
  "sellerSKU": "abcd",
  "productID": "Inventory01",
  "itemTitle": "100% Pure Cotton Baby Boy Girl Romper Summer Short Sleeved Cartoon Jumpsuit",
  "shortDescription": "short description",
  "itemDescription": "Test product",
  "imageURLs": [
    "https://images.sellinall.com/uploads/FMT/Shinmudra-U-FMT0002470/3.jpeg",
    "https://images.sellinall.com/uploads/FMT/Shinmudra-U-FMT0002470/3.jpeg"
  ],
  "quantities": [
    {
      "warehouseID": "satsaco-1",
      "quantity": 30
    },
    {
      "warehouseID": "infor-1",
      "quantity": 25
    }
  ],
  "price": [
    {
      "currencyCode": "SGD",
      "retailPrice": {
        "amount": 12000,
        "currencyCode": "SGD"
      },
      "salePrice": {
        "amount": 10000,
        "currencyCode": "SGD"
      }
    },
    {
      "currencyCode": "USD",
      "retailPrice": {
        "amount": 12000,
        "currencyCode": "USD"
      },
      "salePrice": {
        "amount": 11000,
        "currencyCode": "USD"
      }
    },
    {
      "currencyCode": "MYR",
      "retailPrice": {
        "amount": 12000,
        "currencyCode": "MYR"
      },
      "salePrice": {
        "amount": 11000,
        "currencyCode": "MYR"
      }
    }
  ],
  "variantAttributes": [
    {
      "key": "color-family",
      "value": "blue"
    },
    {
      "key": "Size",
      "value": "XL"
    }
  ],
  "otherAttributes": [
    {
      "key": "gender",
      "values": [
        "Male"
      ]
    },
    {
      "key": "brand",
      "values": [
        "PUMA"
      ]
    },
    {
      "key": "tags",
      "values": [
        "mobile",
        "back case"
      ]
    },
    {
      "key": "sizeChartImage",
      "values": [
        "https://images.sellinall.com/uploads/FMT/Shinmudra-U-FMT0002470/3.jpeg"
      ]
    }
  ],
  "packageLengthInCM": 10,
  "packageWidthInCM": 10,
  "packageHeightInCM": 10,
  "packageWeightInKG": 1
}
            
            

Response payload:

                           
SUCCESS:

HTTP status: 200 OK

FAILURE:

HTTP status: 404

{
    "errorMessage": "sellerSku : fxlm not found"
}
            
            

Update product master

HTTP Request

PUT https://api.sellinall.com/v1/productMaster/item

Request parameters

Field Type Required Description
sellerSKU String Yes The sellerSKU of product master needs to be updated
Send atleast one of the remaining field while updating product master. Rest of the fields are optional. Please refer example payload.

Bulk quantity update

require 'kittn'
                api = Kittn::APIClient.authorize!('meowmeowmeow')
                api.inventory.get(2)
                
            
import kittn
                api = kittn.authorize('meowmeowmeow')
                api.inventory.get(2)
                
            

curl "https://api.sellinall.com/v1/productMaster/quantitiesList"
  -H "Content-Type: application/json"
  -H "appKey: 4c6a4356-345c-4d85-b0cf-ba74ba6hg9d4a"
  -H "accountNumber: 5dd3dad95c11180004117c4d1"

Request payload:

            
Example payload:

{
  "data": [
    {
      "sellerSKU": "productmasterA",
      "quantities": [
        {
          "quantity": 30,
          "warehouseID": "satsaco-1"
        },
        {
          "quantity": 31,
          "warehouseID": "MyStock-1"
        }
      ]
    },
    {
      "sellerSKU": "productmasterB",
      "quantities": [
        {
          "quantity": 32,
          "warehouseID": "satsaco-1"
        },
        {
          "quantity": 33,
          "warehouseID": "infor-1"
        }
      ]
    },
    {
      "sellerSKU": "productmasterC",
      "quantities": [
        {
          "quantity": 32,
          "warehouseID": "MyStock-1"
        }
      ]
    }
  ]
}
            
            

Response payload:

                           
{
  "result": [
    {
      "sellerSKU": "productmasterA",
      "status": "success",
      "updatedQuantity": [
        {
          "warehouseID": "satsaco-1",
          "quantity": 30
        },
        {
          "warehouseID": "MyStock-1",
          "quantity": 31
        }
      ],
      "httpCode": 200
    },
    {
      "sellerSKU": "productmasterB",
      "status": "failure",
      "httpCode": 400
    },
    {
      "sellerSKU": "productmasterC",
      "updatedQuantity": [
        {
          "quantity": 32,
          "warehouseID": "MyStock-1"
        }
      ],
      "httpCode": 200
    }
  ]
}
            
            

Bulk quantity update

HTTP Request

PUT https://api.sellinall.com/v1/productMaster/quantitiesList

Request parameters

Field Type Required Description
sellerSKU String Yes The sellerSKU of product master needs to be updated
quantities Array Yes
quantities": [
    {
      "warehouseID": "satsaco-1",
      "quantity": 30
    },
    {
      "warehouseID": "infor-1",
      "quantity": 25
    }
  ]
Quantities based on warehouse
  • warehouseID: Use the warehouseIDs linked to SiA. Default warehouseID value is MyStock-1
  • quantity: Quantity to be updated

Bulk quantityDiff update

require 'kittn'
                api = Kittn::APIClient.authorize!('meowmeowmeow')
                api.inventory.get(2)
                
            
import kittn
                api = kittn.authorize('meowmeowmeow')
                api.inventory.get(2)
                
            

curl "https://api.sellinall.com/v1/productMaster/quantityDiffList"
  -H "Content-Type: application/json"
  -H "appKey: 4c6a4356-345c-4d85-b0cf-ba74ba6hg9d4a"
  -H "accountNumber: 5dd3dad95c11180004117c4d1"

Request payload:

            
Example payload:

{
  "data": [
    {
      "sellerSKU": "productmasterA",
      "quantityDiffs": [
        {
          "quantityDiff": 3,
          "warehouseID": "satsaco-1"
        },
        {
          "quantityDiff": 1,
          "warehouseID": "MyStock-1"
        }
      ]
    },
    {
      "sellerSKU": "productmasterB",
      "quantityDiffs": [
        {
          "quantityDiff": 3,
          "warehouseID": "satsaco-1"
        },
        {
          "quantityDiff": 3,
          "warehouseID": "infor-1"
        }
      ]
    },
    {
      "sellerSKU": "productmasterC",
      "quantityDiffs": [
        {
          "quantityDiff": 2,
          "warehouseID": "MyStock-1"
        }
      ]
    }
  ]
}
            
            

Response payload:

                           
{
  "result": [
    {
      "sellerSKU": "productmasterA",
      "status": "success",
      "updatedQuantity": [
        {
          "warehouseID": "satsaco-1",
          "quantity": 33
        },
        {
          "warehouseID": "MyStock-1",
          "quantity": 32
        }
      ],
      "httpCode": 200
    },
    {
      "sellerSKU": "productmasterB",
      "status": "failure",
      "httpCode": 400
    },
    {
      "sellerSKU": "productmasterC",
      "updatedQuantity": [
        {
          "quantity": 35,
          "warehouseID": "MyStock-1"
        }
      ],
      "httpCode": 200
    }
  ]
}
            
            

Bulk quantity update

HTTP Request

PUT https://api.sellinall.com/v1/productMaster/quantityDiffList

Request parameters

Field Type Required Description
sellerSKU String Yes The sellerSKU of product master needs to be updated
quantityDiff Array Yes
quantityDiffs": [
        {
          "quantityDiff": 3,
          "warehouseID": "satsaco-1"
        },
        {
          "quantityDiff": 1,
          "warehouseID": "MyStock-1"
        }
  ]
Quantities based on warehouse
  • warehouseID: Use the warehouseIDs linked to SiA. Default warehouseID value is MyStock-1
  • quantityDiff: Quantity to be added to the existing inventory

Orders

Get Orders

require 'kittn'
                api = Kittn::APIClient.authorize!('meowmeowmeow')
                api.orders.get(2)
                
            
import kittn
                api = kittn.authorize('meowmeowmeow')
                api.orders.get(2)
                
            

curl "https://api.sellinall.com/v1/orders?updatedAfter=1433390894&updatedBefore=1433563694&basicUnitCustomSKU=false&groupByCart=true&pageNumber=1&pageSize=200"
  -H "Content-Type: application/json"
  -H "accountNumber: 12121212121212121"   
  -H "appKey: 2121212121"

Response payload:

            
{
  "numberOfPages": 1,
  "numberOfRecords": 3,
  "history": [
    {
      "site": {
        "name": "qoo10",
        "nickNameID": "qoo10-1"
      },
      "orderID": "227973300",
      "buyerDetails": {
        "name": "Hui",
        "email": "samy-test@sellinall.com"
      },
      "orderNumber": "227973300",
      "orderItems": [
        {
          "orderItemID": "227973300",
          "SKU": "AIL0006416-01",
          "quantity": 12,
          "itemAmount": {
            "amount": 355,
            "currencyCode": "SGD"
          },
          "shippingAmount": {
            "amount": 390,
            "currencyCode": "SGD"
          },
          "orderType": "Delivery",
          "itemTitle": "[FNN] CARTON SALES COCOLIFE 100% COCONUT WATER 1L x 12",
          "settlementAmount": {
            "amount": 3962,
            "currencyCode": "SGD"
          },
          "imageURL": "http://images.sellinall.com/uploads/AIL/Shinmudra-U-AIL0004892-01/thumbnail/1.jpg",
          "variantDetails": [
            {
              "title": "Type",
              "name": "Cocolife Coconut Water 1L x 12"
            }
          ],
          "customSKU": "8888200702977",
          "isOption": false,
          "categoryName": "Drinks & Sweets/Others/Others ## 300000931",
          "categoryID": "300000931"
        }
      ],
      "orderStatus": "INITIATED",
      "paymentStatus": "NOT_INITIATED",
      "shippingStatus": "NOT_SHIPPED",
      "orderAmount": {
        "amount": 4260,
        "currencyCode": "SGD"
      },
      "shippingDetails": {
        "address": {
          "name": "Hui",
          "street1": "*******airN*******",
          "street2": "Boon Keng",
          "phone": "+65*******1872",
          "postalCode": "32***60",
          "country": "SG"
        },
        "shippingTrackingDetails": {
          "airwayBill": "SGP95722039",
          "courierName": "Store Pickup",
          "remarks": "Get the order between 9 am and 12 pm.",
          "pickupVoucherCode": "1234567891***"
        }
      },
      "timeCreated": 1504588069,
      "timeLastUpdated": 1504588069,
      "timeOrderCreated": 1504587886,
      "shippingAmount": {
        "amount": 390,
        "currencyCode": "SGD"
      },
      "sellerDiscountAmount": {
        "amount": 900,
        "currencyCode": "SGD"
      },
      "channelDiscountAmount": {
        "amount": 0,
        "currencyCode": "SGD"
      },
      "cartNumber": "113054733",
      "invoiceNumber": "INV0000001",
      "documents": {
        "shippingLabelUrl": "https://docs.sellinall.com/uploads/shippingLabels/AIL/qoo10-1/20033078YKWU3K.pdf"
      }
    },
    {
      "orderID": "34550403686697",
      "site": {
        "name": "lazada",
        "nickNameID": "lazada-1"
      },
      "buyerDetails": {
        "name": "Mark "
      },
      "channelDiscountAmount": {
        "amount": 0,
        "currencyCode": "SGD"
      },
      "invoiceNumber": "INV00012630",
      "orderAmount": {
        "amount": 5040,
        "currencyCode": "SGD"
      },
      "orderAmountInUSD": {
        "amount": 3622,
        "currencyCode": "USD"
      },
      "orderItems": [
        {
          "orderItemID": "34550403786697",
          "shopId": "SELLinALL Store",
          "SKU": "AIL0000755",
          "shippingAmount": {
            "amount": 75,
            "currencyCode": "SGD"
          },
          "customSKU": "248HT-970S",
          "shopSKU": "OE702HLAA9L5OUSGAMZ-19159282",
          "quantity": 1,
          "itemAmount": {
            "amount": 2520,
            "currencyCode": "SGD"
          },
          "itemTitle": "Hotery Professional Chef's Torch",
          "sellerDiscountAmount": {
            "amount": 0,
            "currencyCode": "SGD"
          },
          "deliveryType": "Dropshipping",
          "shippingProviderType": "standard",
          "timeOrderCreated": 1594212698,
          "paymentStatus": "REFUNDED",
          "orderStatus": "CANCELLED",
          "shippingStatus": "NOT_SHIPPED",
          "imageURL": "http://images.sellinall.com/uploads/AIL/Shinmudra-AIL0000755/thumbnail/1.jpeg",
          "isOption": false,
          "categoryName": "Outdoor & Garden:Outdoor:BBQ & Outdoor Dining:BBQ Accessories ## 10000792",
          "categoryID": "10000792",
          "itemSoldAmount": {
            "amount": 2520,
            "currencyCode": "SGD"
          }
        },
        {
          "orderItemID": "34550403886697",
          "shopId": "SELLinALL Store",
          "SKU": "AIL0000755",
          "shippingAmount": {
            "amount": 74,
            "currencyCode": "SGD"
          },
          "customSKU": "248HT-970S",
          "shopSKU": "OE702HLAA9L5OUSGAMZ-19159282",
          "quantity": 1,
          "itemAmount": {
            "amount": 2520,
            "currencyCode": "SGD"
          },
          "itemTitle": "Hotery Professional Chef's Torch",
          "sellerDiscountAmount": {
            "amount": 0,
            "currencyCode": "SGD"
          },
          "deliveryType": "Dropshipping",
          "shippingProviderType": "standard",
          "timeOrderCreated": 1594212698,
          "paymentStatus": "COMPLETED",
          "orderStatus": "PROCESSING",
          "shippingStatus": "READY_TO_SHIP",
          "shippingTrackingDetails": {
            "airwayBill": "NLSGD10778330",
            "courierName": "Pickup: NinjaVanSG, Delivery: NinjaVan"
          },
          "imageURL": "http://images.sellinall.com/uploads/AIL/Shinmudra-AIL0000755/thumbnail/1.jpeg",
          "isOption": false,
          "categoryName": "Outdoor & Garden:Outdoor:BBQ & Outdoor Dining:BBQ Accessories ## 10000792",
          "categoryID": "10000792",
          "itemSoldAmount": {
            "amount": 2520,
            "currencyCode": "SGD"
          }
        }
      ],
      "orderNumber": "34550403686697",
      "orderSoldAmount": {
        "amount": 5040,
        "currencyCode": "SGD"
      },
      "orderSoldAmountInUSD": {
        "amount": 3622,
        "currencyCode": "USD"
      },
      "orderStatus": "PROCESSING",
      "orderStatuses": [
        "CANCELLED",
        "PROCESSING"
      ],
      "paymentMethods": [
        "MIXEDCARD"
      ],
      "paymentStatus": "COMPLETED",
      "paymentStatuses": [
        "REFUNDED"
      ],
      "sellerDiscountAmount": {
        "amount": 0,
        "currencyCode": "SGD"
      },
      "shippingAmount": {
        "amount": 149,
        "currencyCode": "SGD"
      },
      "shippingDetails": {
        "address": {
          "name": "Mark",
          "street1": "****cNair********",
          "street2": "Boon Keng",
          "state": "Singapore",
          "city": "Singapore",
          "country": "Singapore",
          "phone": "***15818***",
          "postalCode": "32***60"
        },
        "shippingTrackingDetails": {
          "airwayBill": "NLSGD10778330",
          "courierName": "Pickup: NinjaVanSG, Delivery: NinjaVan"
        },
        "shippingTrackingDetailsList": [
          {
            "courierName": "Pickup: NinjaVanSG, Delivery: NinjaVan",
            "airwayBill": "NLSGD10778330"
          }
        ]
      },
      "shippingStatus": "READY_TO_SHIP",
      "shippingStatuses": [
        "READY_TO_SHIP",
        "NOT_SHIPPED"
      ],
      "documents": {
        "shippingLabelUrl": "https://docs.sellinall.com/uploads/shippingLabels/AIL/lazada-1/34550403686697.pdf"
      },
      "timeCancelled": 1594212835,
      "timeCreated": 1594212836,
      "timeLastUpdated": 1594258354,
      "timeOrderCreated": 1594212698,
      "updateStatus": "COMPLETE",
      "updateStartTime": 1594258054
    },
    {
      "orderID": "7446703243474",
      "site": {
        "name": "lazada",
        "nickNameID": "lazada-1"
      },
      "buyerDetails": {
        "name": "Teena Sehgal Chadha"
      },
      "channelDiscountAmount": {
        "amount": 412,
        "currencyCode": "SGD"
      },
      "orderAmount": {
        "amount": 6280,
        "currencyCode": "SGD"
      },
      "orderAmountInUSD": {
        "amount": 4559,
        "currencyCode": "USD"
      },
      "orderItems": [
        {
          "orderItemID": "7446703643474",
          "shopId": "SELLinALL Store",
          "shippingAmount": {
            "amount": 0,
            "currencyCode": "SGD"
          },
          "customSKU": "553256",
          "quantity": 1,
          "itemAmount": {
            "amount": 3490,
            "currencyCode": "SGD"
          },
          "itemTitle": "Jamie Oliver Round Baking Dish (Rustic Red)",
          "sellerDiscountAmount": {
            "amount": 0,
            "currencyCode": "SGD"
          },
          "deliveryType": "Own Warehouse",
          "shippingProviderType": "standard",
          "timeOrderCreated": 1540015389,
          "itemSoldAmount": {
            "amount": 3490,
            "currencyCode": "SGD"
          },
          "orderStatus": "RETURNED",
          "paymentStatus": "REFUNDED",
          "shippingStatus": "RETURNED",
          "shippingTrackingDetails": {
            "airwayBill": "NLRSG-10-9D981E6C6BD"
          }
        },
        {
          "orderItemID": "7446704343474",
          "shopId": "SELLinALL Store",
          "shippingAmount": {
            "amount": 0,
            "currencyCode": "SGD"
          },
          "customSKU": "553228",
          "quantity": 1,
          "itemAmount": {
            "amount": 2790,
            "currencyCode": "SGD"
          },
          "itemTitle": "Jamie Oliver Terracotta Bowl (Rustic Red)",
          "sellerDiscountAmount": {
            "amount": 0,
            "currencyCode": "SGD"
          },
          "deliveryType": "Dropshipping",
          "shippingProviderType": "economy",
          "timeOrderCreated": 1540015389,
          "itemSoldAmount": {
            "amount": 2790,
            "currencyCode": "SGD"
          },
          "orderStatus": "DELIVERED",
          "paymentStatus": "COMPLETED",
          "shippingStatus": "DELIVERED",
          "shippingTrackingDetails": {
            "airwayBill": "NLSGD00782761",
            "courierName": "Pickup: SpeedPost, Delivery: NinjaVan"
          }
        }
      ],
      "orderNumber": "7446703243474",
      "orderSoldAmount": {
        "amount": 6280,
        "currencyCode": "SGD"
      },
      "orderSoldAmountInUSD": {
        "amount": 4559,
        "currencyCode": "USD"
      },
      "orderStatus": "DELIVERED",
      "paymentMethods": [
        "MIXEDCARD"
      ],
      "paymentStatus": "COMPLETED",
      "sellerDiscountAmount": {
        "amount": 0,
        "currencyCode": "SGD"
      },
      "shippingAmount": {
        "amount": 0,
        "currencyCode": "SGD"
      },
      "shippingDetails": {
        "address": {
          "name": "Teena Sehgal Chadha",
          "street1": "************ Nakhoda, Holland G***********",
          "street2": "",
          "city": "Singapore",
          "country": "Singapore",
          "phone": "65******3702",
          "postalCode": "25****2"
        },
        "shippingTrackingDetails": {
          "airwayBill": "NLSGD00782761",
          "courierName": "Pickup: SpeedPost, Delivery: NinjaVan"
        },
        "shippingTrackingDetailsList": [
          {
            "airwayBill": "NLSGD00782761",
            "courierName": "Pickup: SpeedPost, Delivery: NinjaVan"
          },
          {
            "airwayBill": "NLRSG-10-9D981E6C6BD"
          }
        ]
      },
      "documents": {
        "shippingLabelUrl": "https://docs.sellinall.com/uploads/shippingLabels/AIL/lazada-1/34550403686697.pdf"
      },
      "shippingStatus": "DELIVERED",
      "timeCreated": 1564724322,
      "timeDelivered": 1564724322,
      "timeLastUpdated": 1564724322,
      "timeOrderCreated": 1540015389,
      "orderStatuses": [
        "DELIVERED",
        "RETURNED"
      ],
      "paymentStatuses": [
        "COMPLETED",
        "REFUNDED"
      ],
      "shippingStatuses": [
        "DELIVERED",
        "RETURNED"
      ]
    }
  ],
  "status": "success"
}
            
            

This endpoint retrieves orders, updated between the defined time intervals.

HTTP Request

GET https://api.sellinall.com/v1/orders?updatedAfter=1433390894&updatedBefore=1433563694&basicUnitCustomSKU=false&groupByCart=true&pageNumber=1&pageSize=200

URL Parameters

Query Parameter Description
updatedAfter The start time(Unix time) for fetching updated orders
updatedBefore The end time(Unix time) to stop fetching updated orders
basicUnitCustomSKU (optional) True if you want the quantity of the items to be in basic unit.
groupByCart (optional) Group the orders based on cartNumber.
pageNumber (optional) The page number to return.
pageSize (optional) The number of orders to be returned per page.

Error message

Error message Meaning
Time Range is mandatory The time range, updatedAfter and updatedBefore might not be given in the request.

Order properties

Field Type Description
numberOfPages Integer
Total number of pages
numberOfRecords Integer
Total number of order records
history Array
List of orders
site Object
"site":{  
  "name":"qoo10",
  "nickNameID":"qoo10-1"
}    
  • name - Market place name
  • nickNameID - unique identifier of the market place for the seller
orderID String
"orderID": "227973300"
Unique identifier of an order
orderNumber String
"orderNumber": "227973300"
Unique identifier of an order
buyerDetails Object
"buyerDetails":{
  "name": "Victoria",
  "email": "victoryas7@live.com.sg"
}
  • name - Buyer name
  • email - Buyer email address.
orderItems Array
"orderItems": [
{
  "orderItemID": "227973300",
  "SKU": "BBB0006416-01",
  "quantity": 12,
  "itemAmount": {
    "amount": 355,
    "currencyCode": "SGD"
  },
  "shippingAmount": {
    "amount": 390,
    "currencyCode": "SGD"
  },
  "orderType": "Delivery",
  "itemTitle": "[FNN] CARTON SALES COCOLIFE 100% COCONUT WATER 1L x 12",
  "settlementAmount": {
    "amount": 3962,
    "currencyCode": "SGD"
  },
  "imageURL": "http://images.sellinall.com/uploads/BBB/Shinmudra-U-BBB0004892-01/thumbnail/1.jpg",
  "variantDetails": [
    {
      "title": "Type",
      "name": "Cocolife Coconut Water 1L x 12"
    }
  ],
  "customSKU": "8888200702977",
  "isOption": false,
  "categoryName": "Drinks & Sweets/Others/Others ## 300000931",
  "categoryID": "300000931"
}
]
  • orderItemID : Id of the product that were purchased.
  • SKU : - Unique identifier for the product in SELLinALL.
  • quantity : The number of items that were purchased.
  • itemAmount : Purchased products price.
  • orderType : The valid values are Delivery and Pickup
    Note: qoo10 only has orderType
  • itemTitle : Title of the product.
  • shippingAmount :shipping price the products.
  • imageURL : Image URL of the product
  • categoryName : The name of category
  • categoryID : The identifier of category
  • Note: orderItems will have imageURL,categoryName,categoryID if the inventory exists in SELLinALL.
  • settlementAmount : The amount payable by the marketplace to the seller.
    Note: Qoo10 and lazada only has settlementAmount.
  • orderStatus : Partial order status for the item. This field only applicable for lazada.
  • paymentStatus : Partial payment status for the item. This field only applicable for lazada.
  • shippingStatus : Partial shipping status for the item. This field only applicable for lazada.
orderStatus String
"orderStatus": "PROCESSING"
Valid values are:
  • INITIATED : New order is initiated by the buyer
  • ACCEPTED : Order is accepted by the seller
  • PROCESSING :Order is being processed by the seller
  • DISPATCHED :Order has been shipped
  • DELIVERED :Order has been delivered
  • CANCELLED :Order has been cancelled
  • RETURNED :Order has been returned
  • CANCEL_PENDING :Order cancellation is pending
  • CANCEL_REQUESTED :Order requested for cancellation
  • RETURN_REQUESTED :Order requested for return
  • RETURN_SHIPPED :Order has been return shipped
  • RETURN_REJECTED :Order has been return rejected
  • DELIVERY_FAILED :Order has been delivery failed
paymentStatus String
"paymentStatus": "NOT_INITIATED"
Valid values are:
  • NOT_INITIATED: Payment is pending.
  • AUTHORIZED: Payment has been authorized
  • COMPLETED: Payments has been completed.
  • REFUNDED: Payments has been refunded
shippingStatus String
"shippingStatus": "NOT_SHIPPED"
Valid values are:
  • NOT_SHIPPED: Order has not been shipped.
  • SHIPPED: Order has been shipped.
  • READY_TO_SHIP: Order is ready for the shipment.
orderAmount Object
"orderAmount": {
  "amount": 4260,
  "currencyCode": "SGD"
}
Total price of an order
shippingAmount Object
"shippingAmount": {
  "amount": 390,
  "currencyCode": "SGD"
}
Total shipping amount of an order.
sellerDiscountAmount Object
 "sellerDiscountAmount": {
  "amount": 900,
  "currencyCode": "SGD"
}
Discount price offered by the seller for the buyer.
channelDiscountAmount Object
 "channelDiscountAmount": {
  "amount": 0,
  "currencyCode": "SGD"
}
Discount price offered by the marketplace for the buyer.
cartNumber String
"cartNumber": "113054733"
id of combined orders
Note: qoo10 and 11street only has cartNumber
invoiceNumber String
"invoiceNumber": "INV0000001"
Unique invoice sequence number generated by SELLinALL
shippingDetails Object
"shippingDetails": {
  "address": {
    "name": "Hui",
    "street1": "BISHAN VIEW 105 BISHAN STREET 12",
    "street2": "Block 105, Unit 06-234, Lift Lobby",
    "phone": "+6590287540",
    "postalCode": "570105",
    "country": "SG"
  },
  "shippingTrackingDetails": {
    "airwayBill": "SGP95722039",
    "courierName": "Store Pickup",
    "remarks": "Get the order between 9 am and 12 pm.",
    "pickupVoucherCode": "1234567891***"
  }
}
  • address :Buyer address.
  • airwayBill : Tracking number of an order.
  • courierName : The name of the company that ships an order.
  • remarks : Textual comment that explains, clarifies, or justifies the order info specified in CommentType.
  • pickupVoucherCode : The secret code to pick the order up from store, when courierName is "Store Pickup".
documents Object
"documents" : {
"shippingLabelUrl" : "https://docs.sellinall.com/uploads/shippingLabels/AIL/qoo10-1/20033078YKWU3K.pdf"
}
  • shippingLabelUrl :Shipping label URL.
  • Note: File formats are marketplace specific. For an instance png, html, pdf and so on.
timeCreated long
The unix time when the order synced in SELLinALL
timeLastUpdated long
The unix time when the order was last updated in SELLinALL
timeOrderCreated long
The unix time when the order was created in marketplace.

Get a Specific Order

require 'kittn'
                api = Kittn::APIClient.authorize!('meowmeowmeow')
                api.orders.get(2)
                
            
import kittn
                api = kittn.authorize('meowmeowmeow')
                api.orders.get(2)
                
            

curl "https://api.sellinall.com/v1/order/lazada-1/1514262635"
  -H "accountNumber: 12121212121212121"   
  -H "appKey: 2121212121"


            

Response payload:


{
  "site": {
    "name": "lazada",
    "nickNameID": "lazada-1"
  },
  "orderID": "1514262635",
  "orderNumber": "1514262635",
  "buyerDetails": {
    "name": "abs",
    "email": "abc@gmail.com"
  },
  "paymentMethods": "VISA/MasterCard",
  "orderStatus": "INITIATED",
  "paymentStatus": "COMPLETED",
  "shippingStatus": "NOT_SHIPPED",
  "shippingDetails": {
    "address": {
      "name": "abc",
      "street1": "abc",
      "street2": "abcd",
      "phone": 213123,
      "postalCode": 1212,
      "country": "Singapore"
    },
    "shippingTrackingDetails": {
      "airwayBill": "WNTTABZWECABYRXKXH28",
      "courierName": "Delivery"
    }
  },
  "shippingAmount": {
    "amount": 1521,
    "currencyCode": "SGD"
  },
  "sellerDiscountAmount": {
    "amount": 900,
    "currencyCode": "SGD"
  },
  "channelDiscountAmount": {
    "amount": 0,
    "currencyCode": "SGD"
  },
  "timeCreated": 1505889671,
  "timeLastUpdated": 1505889671,
  "timeOrderCreated": 1505889671,
  "orderItems": [
    {
      "itemTitle": "Export Drones Drones DJI  DJI Spark FLY More Combo (UK)",
      "itemAmount": {
        "amount": 18000,
        "currencyCode": "SGD"
      },
      "customSKU": "EXPDRONE",
      "variantDetails": [
        {
          "title": "Colour",
          "name": "Sunrise Yellow"
        }
      ],
      "quantity": 1,
      "settlementAmount": {
        "amount": 0,
        "currencyCode": "SGD"
      },
      "imageURL": ""
    }
  ],
  "orderAmount": {
    "amount": 18000,
    "currencyCode": "SGD"
  },
  "documents" : {
        "shippingLabelUrl" : "https://docs.sellinall.com/uploads/shippingLabels/AIL/lazada-1/20033078YKWU3K.pdf"
  },
  "status": "success"
}

            

This endpoint retrieves a specific request.

HTTP Request

GET https://api.sellinall.com/v1/order/<nickNameID>/<orderID>

URL Parameters

Parameter Description
orderID Unique identifier of an order
nickNameID Channel specific ID

Update Shipping Tracking Details

require 'kittn'
                api = Kittn::APIClient.authorize!('meowmeowmeow')
                api.orders.get(2)
                
            
import kittn
                api = kittn.authorize('meowmeowmeow')
                api.orders.get(2)
                
            

curl "https://api.sellinall.com/v1/orders"
  -H "Content-Type: application/json"
  -H "accountNumber: 12121212121212121"   
  -H "appKey: 2121212121"

            

Request payload :


{
  "data": [
    {
      "orderID": "31659500092762",
      "orderStatus": "ACCEPTED",
      "site": {
        "name": "lazada",
        "nickNameID": "lazada-1"
      },
      "orderItems": [
        {
          "orderItemID": "31685600492762",
          "sellerSKU": "testSKU1"
        },
        {
          "orderItemID": "31685600592734",
          "sellerSKU": "testSKU2"
        }
       ]
    },
    {
      "orderID": "152121",
      "orderStatus": "ACCEPTED",
      "site": {
        "name": "lazada",
        "nickNameID": "lazada-1"
      },
      "shippingTrackingDetails": {
        "courierName": "Singpost Registered Mail",
        "airwayBill": "22"
      }
    }
  ]
}
            

Response payload:

            
{
  "result": [
    {
      "response": {
        "orderID": "31659500092762",
        "orderStatus": "ACCEPTED",
        "site": {
          "name": "lazada",
          "nickNameID": "lazada-1"
        },
        "orderItems": [
        {
          "orderItemID": "31685600492762",
          "sellerSKU": "testSKU1"
        },
        {
          "orderItemID": "31685600592734",
          "sellerSKU": "testSKU2"
        }
       ]
      },
      "httpCode": 202
    },
    {
      "errorMessage": "Record Not Found",
      "response": {
        "orderID": "152121",
        "orderStatus": "ACCEPTED",
        "site": {
          "name": "lazada",
          "nickNameID": "lazada-1"
        },
        "shippingTrackingDetails": {
          "courierName": "Singpost Registered Mail",
          "airwayBill": "22"
        }
      },
      "httpCode": 404
    }
  ]
}
            
            

This endpoint updates, shipping tracking details of orders.

HTTP Request

PUT https://api.sellinall.com/v1/orders

Error message

Error message Meaning
Record Not Found The requested orderId does not exist.
Field Type Description
orderID String The shipping details will be updated to this orderId.This API will fail, if the orderId does not exist.
orderStatus String status of the order.
site Object
"site":{
  "name": "lazada",
  "nickNameID": "lazada-1"
}
  • name: Marketplace name.
  • nickNameID: SELLinALL unique Marketplace ID.
shippingTrackingDetails Object
"shippingTrackingDetails": {
  "courierName": "Singpost Registered Mail",
  "airwayBill": "22"
}
  • courierName: The name of the shipping company.
  • airwayBill: The tracking number for an order.
  • This field is optional. Applicable only for seller own fleet orders.
orderItems List
"orderItems": [
        {
          "orderItemID": "31685600492762",
          "sellerSKU": "testSKU1"
        },
        {
          "orderItemID": "31685600592734",
          "sellerSKU": "testSKU2"
        }
       ]
  • orderItems: This field is only applicable for partial order processing, which is supported only for Lazada.
  • orderItemID: Marketplace order item reference id. This is the unique id for the order item
  • sellerSKU: The product SKU (stock keeping unit) is an identifier defined by a seller. This will be assigned to the product while listing to marketplaces

Cancel order

require 'kittn'
                api = Kittn::APIClient.authorize!('meowmeowmeow')
                api.orders.get(2)
                
            
import kittn
                api = kittn.authorize('meowmeowmeow')
                api.orders.get(2)
                
            

curl "https://api.sellinall.com/v1/orders"
  -H "Content-Type: application/json"
  -H "accountNumber: 12121212121212121"   
  -H "appKey: 2121212121"

            

Request payload :


{
  "data": [
    {
      "orderID": "33615180083893",
      "orderStatus": "CANCELLED",
      "site": {
        "name": "lazada",
        "nickNameID": "lazada-1"
      },
      "needToUpdateOrder": true,
      "cancelDetails": {
        "cancelReason": "OUT_OF_STOCK"
      },
      "orderItems": [
        {
          "orderItemID": "3168533454934",
          "sellerSKU": "testSKU3"
        }
      ]
    }
  ]
}
            

Response payload:

            
{
  "result": [
    {
      "response": {
        "orderID": "33615180083893",
        "orderStatus": "CANCELLED",
        "site": {
          "name": "lazada",
          "nickNameID": "lazada-1"
        },
        "needToUpdateOrder": true,
        "cancelDetails": {
          "cancelReason": "OUT_OF_STOCK"
        },
        "orderItems": [
          {
            "orderItemID": "3168533454934",
            "sellerSKU": "testSKU3"
          }
        ]
      },
      "httpCode": 202
    }
  ]
}
            
            

This endpoint used to cancel the orders.

HTTP Request

PUT https://api.sellinall.com/v1/orders

Error message

Error message Meaning
Record Not Found The requested orderId does not exist.
Field Type Description
orderID String OrderID for the order that needs to be cancelled.
orderStatus String The order status. It should be CANCELLED
site Object
"site":{
  "name": "lazada",
  "nickNameID": "lazada-1"
}
  • name: Marketplace name.
  • nickNameID: SELLinALL unique Marketplace ID.
cancelDetails Object
"cancelDetails": {
  "cancelReason": "OUT_OF_STOCK",
}
  • cancelReason: The reason for the cancel order.
orderItems List
"orderItems": [
        {
          "orderItemID": "3168533454934",
          "sellerSKU": "testSKU3"
        }
       ]
  • orderItems: This field is only applicable for partial order processing, which is supported only for Lazada.
  • orderItemID: Marketplace order item reference id. This is the unique id for the order item
  • sellerSKU: The product SKU (stock keeping unit) is an identifier defined by a seller. This will be assigned to the product while listing to marketplaces

Errors

The Kittn API uses the following error codes:

Error Code Meaning
400 Bad Request – Your request sucks
401 Unauthorized – Your API key is wrong
403 Forbidden – The request requested is hidden for administrators only
404 Not Found – The specified request could not be found
405 Method Not Allowed – You tried to access a request with an invalid method
406 Not Acceptable – You requested a format that isn’t json
410 Gone – The request requested has been removed from our servers
418 I’m a teapot
429 Too Many Requests – You’re requesting too many orders! Slow down!
500 Internal Server Error – We had a problem with our server. Try again later.
503 Service Unavailable – We’re temporarially offline for maintanance. Please try again later.