NAV Navbar
Logo
shell

Introduction

Platform

The MySale Marketplace platform is a universal e-commerce platform. It allows merchants to upload and manage stock for sale on all MySale sites presenting e-shops in different countries.

Create SKUs
Combine SKUs into Products
Constantly update Prices and Inventory
Get Orders
Send back Shipment Notifications & Cancellations
You are creating Skus which includes descriptions, prices and images. This can be done in one easy step.
This function is allowing you to group different sizes and colours into products.
You can constantly updates prices and inventory anytime that is necessary to keep stock levels and prices up to date.
You can get orders from our system anytime (instantly / hourly / daily etc.).
Once orders dispatched, you will need to send us the tracking ids which includes any cancellations.

*All of the above steps can be easily done in our user friendly Marketplace portal or API

API

Marketplace provides all necessary API methods to merchants to upload their stock, start sales, receive and process orders and handle customer issues.

The REST API lets you interact with Marketplace from any site that can operate with HTTP requests. Marketplace REST API allows you easily create your Marketplace client software written in any programming language and deployed on any platform anywhere across the World.

This site provides documentation for integrating to MySale Marketplace API. This API gives a programmable alternative to the UI version of MySale Marketplace platform.

How To

You have to register in MySale Marketplace prior to start using MySale Marketplace Portal or start developing your own Marketplace client software. Please refer to our Merchant Welcome Page to apply if you haven’t yet registered on MySale Marketplace.

The Security issues are described in details in the “Authentication” chapter.

If you have any difficulties in developing Marketplace client software by yourself, please let us know and we shall help you.

Marketplace Glossary

Products vs SKUs

To start selling in Marketplace you should upload your stock first. Marketplace manages your stock as list of SKUs grouped by Products.

A Product is a named item, containing a number of SKUs.

SKUs (Stock-keeping units) describe different variants of the same Product, e.g. by sizes, colors etc.

A Product may have its own images. If not, then it takes images from its last updated SKU.

If you don’t want your SKU to be opened for sale immediately after upload, please use the enable / disable flag.

Please refer to Taxonomy chapter to have a detailed instruction about how to use MySale Marketplace categories of Products.

Sales vs Retails

Marketplace may sell your stock in Retail mode as well as by Sales. A Marketplace Sale is a Flash Sale in general. That means that the Sale begins and ends at predefined time and that stock is limited to a specific amount.

To make you able starting your own Sales, Marketplace provides a separate API. Using it you easily describe your Sale, select MySale shops (sites) where to sell your stock, select Products and/or SKUs to be sold there. Moreover you can make different Sale descriptions and banners for different sites presented in different countries for better sales.

Orders, Shipments and Refunds

Order is a set of Order items with a unique ID provided by Marketplace. Each Order item describes SKU and corresponding Qty. You should confirm the Order before Order expiration date.

Each Order leads to either Shipment or Refund. Both refer to an original Order. Refund may be done on one or more Order Items.


Authentication

Marketplace uses API keys to provide access to API. You can register a new Marketplace API key contacting our staff. Please keep your API key secured and don’t share it with others.


SKUs

Upload or Update SKU

curl "/v1/merchant-skus/{merchant_sku_id}/"
  -H "Authorization: Bearer XyZAlexYustasu::NeSHarit00Etot42klyuch"
  -X PUT -d "{json data, see sample below}"

Example Request body:

  {
    "name": "Musky Newbies Rib 3/4 Sleeve T-Shirt",
    "description": "Musky Newbies Rib 3/4 Sleeve T-Shirt",
    "country_of_origin": "Australia",
    "size": "0 (6-12) Months",
    "weight":
    {
        "value": 200,
        "unit": "g"
    },
    "volume":
    {
        "height": 343,
        "width": 200,
        "length": 343,
        "unit": "cm3"
    },
    "standard_product_codes":
    [{
        "code": "2-266-11156-6",
        "type": "isbn-10"
    }],
    "barcodes": ["3495984357288"],
    "brand": "Nike",
    "taxonomy_id": "EB45D097-B7DB-4977-A58B-F7D2758F2466"
  }

Example Response:

  {
    "merchant_sku_id": "B756N-36B-Musky-Pink-0(6-12)Months",
    "sku_id": "AD6739D7-2EFC-4BFA-B62F-0F4D87EA73E8",
    "name": "Musky Newbies Rib 3/4 Sleeve T-Shirt",
    "description": "Musky Newbies Rib 3/4 Sleeve T-Shirt",
    "country_of_origin": "Australia",
    "size": "0 (6-12) Months",
    "weight":
    {
        "value": 200,
        "unit": "g"
    },
    "volume":
    {
        "height": 343,
        "width": 200,
        "length": 343,
        "unit": "cm3"
    },
    "standard_product_codes":
    [{
        "code": "2-266-11156-6",
        "type": "isbn-10"
    }],
    "barcodes": ["3495984357288"],
    "brand": "Nike",
    "taxonomy_id": "EB45D097-B7DB-4977-A58B-F7D2758F2466",
    "enabled": false
  }

This endpoint creates new SKU or updates existing.

HTTP Request

put/v1/merchant-skus/{merchant_sku_id}/

Request body

Sku

Field Type Description
merchant_sku_id string. Maximum of 100 chars The unique sku identifier
sku_id guid The unique sku identifier
name string Name of Sku
description string Description of Sku
country_of_origin string Country of origin of Sku
size string Size of Sku
weight Weight Weight of Sku
volume Volume Volume of Sku
standard_product_codes Array of StandardProductCode List of Standard product codes
barcodes Array of string Barcodes of Sku
brand string Brand name of Sku
taxonomy_id Guid Internal Id of Sku Taxonomy
enabled bool true - Sku can be sold and be added to shops and sales, false - Sku is not for sale

Weight

Field Type Description
value decimal Value of Sku weight
unit string Unit of the value

Volume

Field Type Description
height decimal Height of Sku
width decimal Width of Sku
length decimal Length of Sku
unit string Unit of the values

StandardProductCode

Field Type Description
code string. Maximum of 100 chars Product code
type enum Allowed values: EAN, UPC, ISBN_10, ISBN_13, GTIN_14

Response body

Returns created or updated Sku. For structure of returned Sku see Request body.

Retrieve All SKUs

curl "/v1/merchant-skus/?offset={offset}&limit={limit}"
  -H "Authorization: Bearer XyZAlexYustasu::NeSHarit00Etot42klyuch"

Example Response:

{
  "skus":
  [
    {
      "merchant_sku_id": "B756N-36B-Musky-Pink-0(6-12)Months",
      "sku_id": "AD6739D7-2EFC-4BFA-B62F-0F4D87EA73E8"
    },
    {
      "merchant_sku_id": "BBA2-RZNE1A-YU7-PurWhiStr-0(6-12)Months",
      "sku_id": "EB45D097-B7DB-4977-A58B-F7D2758F2466"
    }
  ]
}

This endpoint retrieves all SKUs.

HTTP Request

get/v1/merchant-skus/?offset={offset}&limit={limit}

Query Parameters

Parameter Default Description
offset 0 The result will skip Sku’s with number less than specified.
limit 50 The result will return maximum of specified items.

Response body

Field Type Description
merchant_sku_id string. Maximum of 100 chars The unique sku identifier
sku_id guid The unique sku identifier

Retrieve a Specific SKU

curl "/v1/merchant-skus/{merchant_sku_id}/"
  -H "Authorization: Bearer XyZAlexYustasu::NeSHarit00Etot42klyuch"

Example Response:

  {
    "merchant_sku_id": "B756N-36B-Musky-Pink-0(6-12)Months",
    "sku_id": "AD6739D7-2EFC-4BFA-B62F-0F4D87EA73E8",
    "name": "Musky Newbies Rib 3/4 Sleeve T-Shirt",
    "description": "Musky Newbies Rib 3/4 Sleeve T-Shirt",
    "country_of_origin": "Australia",
    "size": "0 (6-12) Months",
    "weight":
    {
        "value": 200,
        "unit": "g"
    },
    "volume":
    {
        "height": 343,
        "width": 200,
        "length": 343,
        "unit": "cm3"
    },
    "standard_product_codes":
    [{
        "code": "2-266-11156-6",
        "type": "isbn-10"
    }],
    "barcodes": ["3495984357288"],
    "brand": "Nike",
    "taxonomy_id": "EB45D097-B7DB-4977-A58B-F7D2758F2466",
    "enabled": true
  }

Retrieves the details of an existing Sku.

HTTP Request

get/v1/merchant-skus/{merchant_sku_id}/

Query Parameters

Parameter Default Description
merchant_sku_id - The previously created ID you will use to track and update your Sku

Response body

Sku

Field Type Description
merchant_sku_id string. Maximum of 100 chars The unique sku identifier
sku_id guid The unique sku identifier
name string Name of Sku
description string Description of Sku
country_of_origin string Country of origin of Sku
size string Size of Sku
weight Weight Weight of Sku
volume Volume Volume of Sku
standard_product_codes Array of StandardProductCode List of Standard product codes
barcodes Array of string Barcodes of Sku
brand string Brand name of Sku
taxonomy_id Guid Internal Id of Sku Taxonomy
enabled bool true - Sku can be sold and be added to shops and sales, false - Sku is not for sale

Weight

Field Type Description
value decimal Value of Sku weight
unit string Unit of the value

Volume

Field Type Description
height decimal Height of Sku
width decimal Width of Sku
length decimal Length of Sku
unit string Unit of the values

StandardProductCode

Field Type Description
code string. Maximum of 100 chars Product code
type enum Allowed values: EAN, UPC, ISBN_10, ISBN_13, GTIN_14

Enable SKU for sale

curl "/v1/merchant-skus/{merchant_sku_id}:enable/"
  -H "Authorization: Bearer XyZAlexYustasu::NeSHarit00Etot42klyuch"
  -X POST "{json data, see sample below}"

Enables Sku for Sale. If Sku is enabled for sale it can be added to sales and can be sold. If Sku is disabled for sales - it can not be sold.

HTTP Request

post/v1/merchant-skus/{merchant_sku_id}:enable/

Query Parameters

Parameter Default Description
merchant_sku_id - The previously created ID you will use to track and update your Sku

Disable SKU for sale

curl "/v1/merchant-skus/{merchant_sku_id}:disable/"
  -H "Authorization: Bearer XyZAlexYustasu::NeSHarit00Etot42klyuch"
  -X POST "{json data, see sample below}"

Disables Sku for Sale. If Sku is disabled for sale it can be added to sales but it can not be sold.

HTTP Request

post/v1/merchant-skus/{merchant_sku_id}:disable/

Query Parameters

Parameter Default Description
merchant_sku_id - The previously created ID you will use to track and update your Sku

Upload SKU images

curl "/v1/merchant-skus/{merchant_sku_id}/images/"
  -H "Authorization: Bearer XyZAlexYustasu::NeSHarit00Etot42klyuch"
  -X PUT -d "{json data, see sample below}"

Example Request body:

  {
      "images": [
      {
          "merchant_url": "https://supplier.com/mysku01-a.jpg"
      },
      {
          "merchant_url": "https://supplier.com/mysku01-b.jpg"
      },
      {
          "merchant_url": "https://supplier.com/mysku01-c.jpg"
      }]
  }

Example Response:

   {
       "images": [
       {
           "merchant_url": "https://supplier.com/not-existing-image.jpg",
           "error": "404. Failed to load"
       },
       {
           "merchant_url": "https://supplier.com/mysku01-b.jpg",
           "url": "https://cdn.mysalemarketplace.com/C10FD09ECA/mysku01-b.jpg"  
       },
       {
           "merchant_url": "https://supplier.com/mysku01-c.jpg"
       }]
   }

This endpoint uploads images for existing SKU.

HTTP Request

put/v1/merchant-skus/{merchant_sku_id}/images/

Request body

ImagesModel

Field Type Description
Images Array of ImageModel List of objects which contain information about images to upload

ImageModel

Field Type Description
merchant_url string Url of image to upload
url string Url of image at MySale Marketplace CDN
error string Displays a reason if an image failed to load to MySale Marketplace CDN

Response body

Returns uploaded Sku images.

ImagesModel

Field Type Description
Images Array of ImageModel List of objects which contain information about images to upload

ImageModel

Field Type Description
merchant_url string Initial image url
url string Uploaded image url

Retrieve SKU images

curl "/v1/merchant-skus/{merchant_sku_id}/images/"
  -H "Authorization: Bearer XyZAlexYustasu::NeSHarit00Etot42klyuch"

Example Response:

   {
       "images": [
       {
           "merchant_url": "https://supplier.com/not-existing-image.jpg",
           "error": "404. Failed to load"
       },
       {
           "merchant_url": "https://supplier.com/mysku01-b.jpg",
           "url": "https://cdn.mysalemarketplace.com/C10FD09ECA/mysku01-b.jpg"  
       },
       {
           "merchant_url": "https://supplier.com/mysku01-c.jpg"
       }]
   }

This endpoint images for existing SKU.

HTTP Request

get/v1/merchant-skus/{merchant_sku_id}/images/

Response body

Returns uploaded Sku images.

ImagesModel

Field Type Description
Images Array of ImageModel List of objects which contain information about images to upload

ImageModel

Field Type Description
merchant_url string Url of image to upload
url string Url of image at MySale Marketplace CDN
error string Displays a reason if an image failed to load to MySale Marketplace CDN

url | string | Uploaded image url

Upload SKU prices

curl "/v1/merchant-skus/{merchant_sku_id}/prices/"
  -H "Authorization: Bearer XyZAlexYustasu::NeSHarit00Etot42klyuch"
  -X PUT -d "{json data, see sample below}"

Example Request body:

{
    "prices": {
        "cost": {
            "currency": "AUD",
            "value": "40"
        },
        "sell": {
            "currency": "AUD",
            "value": "100"
        },
        "rrp": {
            "currency": "AUD",
            "value": "200"
        }
    }
}

Example Response:

{
    "prices": {
        "cost": {
            "currency": "AUD",
            "value": "40"
        },
        "sell": {
            "currency": "AUD",
            "value": "100"
        },
        "rrp": {
            "currency": "AUD",
            "value": "200"
        }
    }
}

This endpoint uploads prices for existing SKU.

HTTP Request

put/v1/merchant-skus/{merchant_sku_id}/prices/

Request body

PricesModel

Field Type Description
Prices Array of PricesListModel List of objects which contain information about images to upload

PricesListModel

Field Type Description
cost PriceValueModel Cost price
sell PriceValueModel Sell price
rrp PriceValueModel Rrp price

PriceValueModel

Field Type Description
currency string Price currency
value decimal Price value

Response body

Returns Sku prices. For structure of returned prices see Request body.

Retrieve SKU prices

curl "/v1/merchant-skus/{merchant_sku_id}/prices/"
  -H "Authorization: Bearer XyZAlexYustasu::NeSHarit00Etot42klyuch"

Example Response:

{
    "prices": {
        "cost": {
            "currency": "AUD",
            "value": "40"
        },
        "sell": {
            "currency": "AUD",
            "value": "100"
        },
        "rrp": {
            "currency": "AUD",
            "value": "200"
        }
    }
}

This endpoint prices for existing SKU.

HTTP Request

get/v1/merchant-skus/{merchant_sku_id}/prices/

Response body

Returns uploaded Sku prices.

PricesModel

Field Type Description
Prices Array of PricesListModel List of objects which contain information about images to upload

PricesListModel

Field Type Description
cost PriceValueModel Cost price
sell PriceValueModel Sell price
rrp PriceValueModel Rrp price

PriceValueModel

Field Type Description
currency string Price currency
value decimal Price value

Upload SKU inventory

curl "/v1/merchant-skus/{merchant_sku_id}/inventory/"
  -H "Authorization: Bearer XyZAlexYustasu::NeSHarit00Etot42klyuch"
  -P PUT -d "{json data, see sample below"}

Example Request body:

{
    "inventory": [
    {
        "location": "Australia Warehouse",
        "quantity": "50"
    },
    {
        "location": "United Kingdom Warehouse",
        "quantity": "100"
    }]
}

Example Response:

{
    "inventory": [
    {
        "location": "Australia Warehouse",
        "quantity": "50"
    },
    {
        "location": "United Kingdom Warehouse",
        "quantity": "100"
    }]
}

This endpoint uploads inventory for existing SKU.

HTTP Request

put/v1/merchant-skus/{merchant_sku_id}/inventory/

Request body

InventoryModel

Field Type Description
Sku string Merchant sku Id
LocationQuantities Array of LocationQuantityModel Merchant sku Id

LocationQuantityModel

Field Type Description
LocationId string Sku location
Quantity int Number of Skus available on location

Response body

Returns Sku inventory. For structure of returned inventory see Request body.

Retrieve SKU inventory

curl "/v1/merchant-skus/{merchant_sku_id}/inventory/"
  -H "Authorization: Bearer XyZAlexYustasu::NeSHarit00Etot42klyuch"

Example Response:

{
    "inventory": [
    {
        "location": "Australia Warehouse",
        "quantity": "50"
    },
    {
        "location": "United Kingdom Warehouse",
        "quantity": "100"
    }]
}

This endpoint inventory for existing SKU.

HTTP Request

get/v1/merchant-skus/{merchant_sku_id}/inventory/

Response body

Returns uploaded Sku inventories.

InventoryModel

Field Type Description
Sku string Merchant sku Id
LocationQuantities Array of LocationQuantityModel Merchant sku Id

LocationQuantityModel

Field Type Description
LocationId string Sku location
Quantity int Number of Skus available on location


Products

Upload or Update Product

curl "/v1/merchant-products/{merchant_product_id}/"
  -H "Authorization: Bearer XyZAlexYustasu::NeSHarit00Etot42klyuch"
  -X PUT -d "{json data, see sample below}"

Example Request body:

{
    "name": "Super Nike product",
    "description": "This is cool product",
    "skus": [
    {
        "merchant_sku_id": "MySKU01"
    },
    {
        "merchant_sku_id": "MySKU02"
    },
    {
        "merchant_sku_id": "MySKU03"
    }]
}

Example Response:

{
    "product_id": "3C2A6CE4-1F55-4696-B895-4B23EDE915EA",
    "merchant_product_id": "Merchant_Product_1",
    "name": "Super Nike product",
    "description": "This is a terrific product",
    "skus": [
    {
        "merchant_sku_id": "MySKU01"
    },
    {
        "merchant_sku_id": "MySKU02"
    },
    {
        "merchant_sku_id": "MySKU03"
    }]
}

This endpoint uploads or updates Product

HTTP Request

put/v1/merchant-products/{merchant_product_id}/

Request body

ProductModel

Field Type Description
merchant_product_id string. Maximum of 100 chars The unique Product identifier
product_id Guid The unique Product identifier
name string Name of Product
description string Description of Product
skus Array of Sku Attached Skus

Sku

Field Type Description
merchant_sku_id string. Maximum of 100 chars The unique Sku identifier
sku_id guid The unique Sku identifier

Response body

Returns created or updated Product. For structure of returned Product see Request body.

Retrieve All Products

curl "/v1/merchant-products/?offset={offset}&limit={limit}"
  -H "Authorization: Bearer XyZAlexYustasu::NeSHarit00Etot42klyuch"

Example Response:

{
    "products": [
    {
        "product_id": "ef084dc7-c22d-40f6-9b16-456cc8ec9d46",
        "merchant_product_id": "myProduct01"
    },
    {
        "product_id": "3C2A6CE4-1F55-4696-B895-4B23EDE915EA",
        "merchant_product_id": "myProduct02"
    }]
}

This endpoint retrieves all Products.

HTTP Request

get/v1/merchant-products/?offset={offset}&limit={limit}

Query Parameters

Parameter Default Description
offset 0 The result will skip Product’s with number less than specified.
limit 50 The result will return maximum of specified items.

Response body

Field Type Description
merchant_product_id string. Maximum of 100 chars The unique Product identifier
product_id guid The unique Product identifier

Retrieve a Specific Product

curl "/v1/merchant-products/{merchant_product_id}/"
  -H "Authorization: Bearer XyZAlexYustasu::NeSHarit00Etot42klyuch"

Example Response:


{
    "product_id": "3C2A6CE4-1F55-4696-B895-4B23EDE915EA",
    "merchant_product_id": "MyProduct01",
    "name": "Super Nike product",
    "description": "This is a terrific product",
    "skus": [
    {
        "merchant_sku_id": "MySKU01",
        "sku_id": "AD6739D7-2EFC-4BFA-B62F-0F4D87EA73E8"
    },
    {
        "merchant_sku_id": "MySKU02",
        "sku_id": "16D8EC73-634D-44DB-BBF4-202C0048513C"
    },
    {
        "merchant_sku_id": "MySKU03",
        "sku_id": "C10FD09E-D388-4CED-9693-CACB9CBB45CA"
    }]
}

Retrieves the details of an existing Product.

HTTP Request

get/v1/merchant-products/{merchant_product_id}/

Response body

ProductModel

Field Type Description
merchant_product_id string. Maximum of 100 chars The unique Product identifier
product_id guid The unique Product identifier
name string Name of Product
description string Description of Product
skus Array of Sku Attached Skus

Sku

Field Type Description
merchant_sku_id string. Maximum of 100 chars The unique Sku identifier
sku_id guid The unique Sku identifier

Upload Product images

curl "/v1/merchant-products/{merchant_product_id}/images/"
  -H "Authorization: Bearer XyZAlexYustasu::NeSHarit00Etot42klyuch"
  -X PUT -d "{json data, see sample below}"

Example Request body:

  {
      "images": [
      {
          "merchant_url": "https://supplier.com/not-existing-image.jpg"
      },
      {
          "merchant_url": "https://supplier.com/mysku01-b.jpg"
      },
      {
          "merchant_url": "https://supplier.com/mysku01-c.jpg"
      }]
  }

Example Response:

   {
       "images": [
       {
           "merchant_url": "https://supplier.com/not-existing-image.jpg",
           "error": "404. Failed to load"
       },
       {
           "merchant_url": "https://supplier.com/mysku01-b.jpg",
           "url": "https://cdn.mysalemarketplace.com/C10FD09ECA/mysku01-b.jpg"  
       },
       {
           "merchant_url": "https://supplier.com/mysku01-c.jpg"
       }]
   }

This endpoint uploads images for existing Product.

HTTP Request

put/v1/merchant-products/{merchant_product_id}/images/

Request body

ImagesModel

Field Type Description
images Array of ImageModel List of objects which contain information about images to upload

ImageModel

Field Type Description
merchant_url string Url of image to upload
url string Url of image at MySale Marketplace CDN
error string Displays a reason if an image failed to load to MySale Marketplace CDN

Response body

Returns uploaded Product images.

ImagesModel

Field Type Description
Images Array of ImageModel List of objects which contain information about images to upload

ImageModel

Field Type Description
merchant_Url string Initial image url
url string Uploaded image url

Retrieve Product images

curl "/v1/merchant-products/{merchant_product_id}/images/"
  -H "Authorization: Bearer XyZAlexYustasu::NeSHarit00Etot42klyuch"

Example Response:

   {
       "images": [
       {
           "merchant_url": "https://supplier.com/not-existing-image.jpg",
           "error": "404. Failed to load"
       },
       {
           "merchant_url": "https://supplier.com/mysku01-b.jpg",
           "url": "https://cdn.mysalemarketplace.com/C10FD09ECA/mysku01-b.jpg"  
       },
       {
           "merchant_url": "https://supplier.com/mysku01-c.jpg"
       }]
   }

This endpoint retrieves images for existing Product.

HTTP Request

get/v1/merchant-products/{merchant_product_id}/images/

Response body

Returns uploaded Product images.

ImagesModel

Field Type Description
images Array of ImageModel List of objects which contain information about images to upload

ImageModel

Field Type Description
merchant_url string Url of image to upload
url string Url of image at MySale Marketplace CDN
error string Displays a reason if an image failed to load to MySale Marketplace CDN


Taxonomy

Retrieve list of Taxonomy branches

curl "/v1/taxonomy/?offset=0&limit=100"
  -H "Authorization: Bearer XyZAlexYustasu::NeSHarit00Etot42klyuch"

Example Response:


{
  "branches": [
    "e7e47671-07b0-4e95-8dee-c0fa5a96a1b7",
    "d8ddd5e5-868f-4891-b416-8c92590a29c4",
    "4de932b7-a107-49ab-9e8f-cdf0b75f86fd"
  ]
}

This endpoint retrieves the list of Taxonomy branches

HTTP Request

get/v1/taxonomy/?offset={offset}&limit={limit}

Response body

Returns the list of taxonomy branches ids. Taxonomy id is of guid type.

Retrieve a specific Taxonomy branch

curl "/v1/taxonomy/e7e47671-07b0-4e95-8dee-c0fa5a96a1b7/"
  -H "Authorization: Bearer XyZAlexYustasu::NeSHarit00Etot42klyuch"

Example Response:

{
    "branch_id": "e7e47671-07b0-4e95-8dee-c0fa5a96a1b7",
    "parent_id": "d8ddd5e5-868f-4891-b416-8c92590a29c4",
    "level": 1,
    "name": "Denim",
    "keywords": [
      "jean",
      "jeans",
      "denim",
      "denims"
    ],
    "is_main_category": true
}

This endpoint returns a taxonomy branch.

HTTP Request

get/v1/taxonomy/{branch_id}/

Query Parameters

Parameter Description
branch_id The id of the requested branch. Id is of guid type.

Response body

Field Type Description
branch_id guid The unique Taxonomy branch identifier
parent_id guid The unique Taxonomy branch porent identifier
level int Level of tha Taxonomy branch int the Taxonomy tree
name string Name of the Taxxonomy branch
keywords string[] Enumeration of keywords for the Taxonomy branch
is_main_category bool The flag that indicates that the Taxonomy branch can be assigned to a SKU


Orders

Life-cycle

New Order is created by MySale upon selling the Basket to a Customer. The Basket contains a list of Order Items and some other fields. Order Item is a record of SKU + Qty, i.e. how many pieces of this SKU has been ordered. Sum of all Order Item Quantities is an Order Qty. Order Status list:

Status Meaning Initiatorv
new The order has been placed and is ready to be processed by merchant MySale
acknowledged The order has been accepted by the merchant and is awaiting fulfillment Merchant
inprogress The order has been partially shipped Merchant
complete The order is completely shipped Merchant

Status “new” The new Order is created with the “new” Status. Merchant periodically checks the Order tray in MP using Get Order List method for “new” Status. Recommended frequency is once an hour. If there are some Orders in “new” Status, the list will be returned with corresponding Order Ids. Merchant should take then the newly created Orders one by one using Get Order method.

Status “acknowledged”

To not have all viewed Orders in a list again Merchant can mark an Order using Acknowledge method:


Status “inprogress” vs “complete”

Merchant processes the Order and, then it becomes dispatched, notifies MP about that using Add New Shipment method. Order may contain several Shipments. For each Shipment Merchant provides a shipment item list and Tracking Number.

In case of inability to ship the Order Merchant can call the Add New Cancellation method and report the reason:

Cancellation Reason Meaning
no_stock no_stock
fraud_high_risk Fraud High Risk
fraud_charge_back Fraud ChargeBack
fraud_confirmed Fraud Confirmed
customer_cancelled_sale_error Customer Cancelled: Sale Error
customer_cancelled_delayed Customer Cancelled: Delayed
customer_cancelled_change_of_mind Customer Cancelled: Change of mind
unfulfillable_address Unfulfillable address
other other

Sum of all Quantities from all Order Shipments and Order Cancellations is a Processed Order Qty.

The Order moves to “complete” Status only when it receives all necessary Shipments and Cancellations, i.e. Processed Order Qty EQUALS to Order Qty:


In some cases the Order cannot be shipped or cancelled completely at once. In this case Merchant calls consequently the Add New Shipment and Add New Cancellation methods until Processed Order Qty is equal to Order Qty.

Partial Shipment or Cancellation should not exactly correspond to an Order Item. It may contain several Order Items or only a part of one Order Item (Qty less, then Order Item Qty). Here the Order will be moved to the “inprogress” Status. Imagine we have an Order with 3 Order Items with Quantities correspondingly 3,4 and 5:

  1. Order Items 1 and 2 can be shipped right now and Order Item 3 is not yet processed. Here we have One Shipment.
  2. Order Item 1 can be shipped right now and Order Item 2 can be shipped one week later. Order Item 3 is not yet processed. Here we have One Shipment with one Expected delivery date and another - with the date week later.
  3. Order Item 1 is shipped, Order Item 2 is Cancelled, Order Item 3 is not yet processed. Here we have 1 Shipment and one Cancellation.
  4. Order Item 1 is shipped (Qty = 3), Order Item 2 is unfulfillable, i.e. Merchant can only deliver 3 of 4 (Qty = 3). Here we have normal Shipment 1 for Order Item 1, partial Shipment 2 for Qty = 3 and partial cancellation of Order Item 3 for Qty = 1.

In case when Processed Order Qty is not equal to Order Qty:


Retrive Order List

curl "/v1/orders/new/"
  -H "Authorization: Bearer XyZAlexYustasu::NeSHarit00Etot42klyuch"
curl "/v1/orders/acknowledged/"
  -H "Authorization: Bearer XyZAlexYustasu::NeSHarit00Etot42klyuch"
curl "/v1/orders/inprogress/"
  -H "Authorization: Bearer XyZAlexYustasu::NeSHarit00Etot42klyuch"
curl "/v1/orders/completed/"
  -H "Authorization: Bearer XyZAlexYustasu::NeSHarit00Etot42klyuch"

Example Response:

[
  {
    "order_id": "03c8f4c6-f5d0-44c9-a9b0-a0972dd3fa50",
    "merchant_order_id": "19e1b803-5f93-41ec-b37a-336ac5ea6518"
  },
  {
    "order_id": "8f491c6f-0e4f-4fa5-b458-ccab9b018c24"
  },
  {
    "order_id": "443c14b3-714b-47dc-9d32-8381d9a41fc3",
    "merchant_order_id": "Product_XXX"
  }
]

Using this endpoint you can access the first 1000 orders in a certain status.

HTTP Request

get/v1/orders/new/

Response body

Field Type Description
order_id Guid The unique order identifier
merchant_order_id Guid The unique order identifier. Not obligatory field

HTTP Request

get/v1/orders/acknowledged/

Response body

Field Type Description
order_id Guid The unique order identifier
merchant_order_id Guid The unique order identifier. Not obligatory field

HTTP Request

get/v1/orders/inprogress/

Response body

Field Type Description
order_id Guid The unique order identifier
merchant_order_id Guid The unique order identifier. Not obligatory field

HTTP Request

get/v1/orders/completed/

Response body

Field Type Description
order_id Guid The unique order identifier
merchant_order_id Guid The unique order identifier. Not obligatory field

Retrive a Specific Order

curl "/v1/orders/{order_id}/"
  -H "Authorization: Bearer XyZAlexYustasu::NeSHarit00Etot42klyuch"

Example Response:

{
  "order_id": "7edc8036-b35d-43b7-9577-441879e0f7d9",
  "merchant_order_id": "05d246b1-e033-4376-92b7-09e251dd9faa",
  "customer_order_reference":"",
  "order_date": "2017-05-18T09:42:02.4025446+00:00",
  "order_status": "complete",
  "recipient": {
    "name": "Gatsby",
    "email": "tesr@tutu.ru",
    "phone_number": "8-965-55-86-98",
    "address": {
      "country_code": "78",
      "address_line": "line",
      "city": "Detroit",
      "state": "No state",
      "postcode": "196487",
      "authority_to_leave": "AuthorityTooooLeave"
    },
    "billing_address": {
      "country_code": "78",
      "address_line": "line",
      "city": "Detroit",
      "state": "No state",
      "postcode": "196487",
      "authority_to_leave": "AuthorityTooooLeave"
    },
    "pickup_point": {
      "id": "dlkut",
      "carrier": "Carrier",
      "name": "Pockkie",
      "address_line": "line",
      "city": "Detroit",
      "state": "No state",
      "postcode": "196487"
    }
  },
  "order_items": [
    {
      "order_item_id": "1f0c8771-703b-4302-abe8-863e78a8be16",
      "merchant_order_item_id": "17616d68-e711-4792-8325-660ceae03a54",
      "sku_id": "69081a07-496d-4af7-86fa-e1229ee5f4ea",
      "merchant_sku_id": "f55b3074-79d5-4647-ba1c-774720b19b35",
      "sku_qty": 3,
      "item_cost_price": {
        "currency": "RUB",
        "amount": 30
      },
      "item_sell_price": {
        "currency": "RUB",
        "amount": 33
      }
    },
    {
      "order_item_id": "f82ed263-c020-4132-85eb-f770e24b14e3",
      "merchant_order_item_id": "4a7d0554-d0b2-4578-a443-bc8330b7d36a",
      "sku_id": "8ca9ca3f-9ec0-4234-a1d3-9af522e5427c",
      "merchant_sku_id": "fec7fefd-0ce1-41e4-8844-ada3b5af761d",
      "sku_qty": 8,
      "item_cost_price": {
        "currency": "RUB",
        "amount": 38
      },
      "item_sell_price": {
        "currency": "RUB",
        "amount": 22
      }
    },
    {
      "order_item_id": "4ac1c1ed-ed20-42d7-850f-33929dad63d5",
      "merchant_order_item_id": "d6509113-bb3e-4c37-8b21-b2714ef939a7",
      "sku_id": "1626d79c-fcd0-4254-9cbf-19b5f09bfb51",
      "merchant_sku_id": "efdf5c8b-4bbf-4369-84a8-0628b4f48a8a",
      "sku_qty": 5,
      "item_cost_price": {
        "currency": "RUB",
        "amount": 41
      },
      "item_sell_price": {
        "currency": "RUB",
        "amount": 44
      }
    }
  ]
}

This endpoint gets first 1000 in progress Orders.

HTTP Request

get/v1/orders/{order_id}

Response body

Order

Field Type Description
order_id Guid The unique order identifier
merchant_order_id Guid The unique order identifier. Not obligatory field
customer_order_reference string MySale human readable order ID number that may have a small chance of collision overtime.
order_date Date The date the merchant order was placed.
order_status string
Status descriptions:
New,
Acknowledged,
Inprogress,
Complete
Current status of the order. Status descriptions:
‘new’ - order was created by MySale and ready to be acknowledged by merchant
'acknowledged’ - order was acknowledged by merchant
'inprogress’ - one part of the order has been shipped or cancelled
'complete’ - all parts of the order have shipped or cancelled
recipient Recipient Who is receiving the order
order_items OrderItem[] List of Order items (SKU + QTY)

Recipient

Field Type Description
name string The name of the person
email Guid The email for the person above
phone_number string The phone number for the person above
address Address Where the order is being shipped to
billing_address Address Where the bill to be sent to
pickup_point PickupPoint Optional pickup point identification if ordered to be delivered to pickup point

Address

Field Type Description
country_code string Alpha-2 ISO country code
address_line string Address info
city string City of the address
state string State of the address
postcode string Post code of the address
authority_to_leave string If filled out, when a carrier has permission to leave a parcel without obtaining a signature in case if recipient is e.g. at work at a time of delivery.

PickupPoint

Field Type Description
id string Internal pickup point identifier
carrier string Post service name
name string Pickup point name
address_line string Pickup point address
city string City of the address
state string State of the address
postcode string Post code of the address

OrderItem

Field Type Description
order_item_id Guid MySale unique ID for a given Merchant order item
merchant_order_item_id string Optional Merchant supplied order item ID.
sku_id Guid MySale unique ID for SKU
merchant_sku_id string Identification of SKU given by Merchant
sku_qty int Quantity of this SKU
item_cost_price Price Price the retailer sets
item_sell_price Price Price the customer pays
item_shipping_price Price Price of delivery

Price

Field Type Description
currency string Alpha-3 ISO currency code
amount decimal Cost amount

Acknowledge Order

curl "/v1/orderd/{order_id}/acknowledge/"
  -H "Authorization: Bearer XyZAlexYustasu::NeSHarit00Etot42klyuch"
  -X PUT -d "{json data, see sample below}"

Example Request body:

{
    "merchant_order_id": "ASM97218-17",
    "order_items": [
        {
            "order_item_id": "83589b6c-2b96-4b5e-b4a9-b65ce8a861a9",
            "merchant_order_item_id": "MYORDERITEMID1"
        },
        {
            "order_item_id": "8f1d9e54-a8d1-4989-b9b8-c579b499f999",
            "merchant_order_item_id": "MYORDERITEMID1"
        }
    ]
}

This endpoint acknowledges Order

HTTP Request

put/v1/orders/{order_id}/acknowledge/

Request body

Acknowledgment

Field Type Description
merchant_order_id string. Maximum of 100 chars Optional Merchant supplied order ID.
order_items AcknowledgementOrderItem List of Order items (SKU + QTY)

AcknowledgementOrderItem

Field Type Description
order_item_id Guid MySale unique ID for a given Merchant order item
merchant_order_item_id string Optional Merchant supplied order item ID.

Upload Shipment

curl "/v1/orderd/{order_id}/shipments/"
  -H "Authorization: Bearer XyZAlexYustasu::NeSHarit00Etot42klyuch"
  -X POST -d "{json data, see sample below}"

Example Request body:

{
    "merchant_order_id": "ASM97218-17",
    "merchant_shipment_id": "96B8A04E-141A-452D-9DE8-F63E1933B004",
    "tracking_number": "ASM-991475/17-022",
    "delivery_option": "pickup_point",
    "carrier": "Auspost",
    "carrier_shipment_method": "Express",
    "dispatch_date": "2017-06-15T12:35:22.0000000-07:00",
    "expected_delivery_date": "2017-06-16T12:35:22.0000000-07:00",
    "shipment_items": [
    {
        "merchant_shipment_item_id": "MYORDERITEMID1",
        "merchant_sku_id": "MYSKU02",
        "sku_id": "7B798536-B9B7-4613-B0C7-996BACE854E7",
        "sku_qty": 1
    }]
}

Example Response:


    "3764e178-ae78-4996-8eef-40dbe9f543ef"

This endpoint adds Shipment to the Order

HTTP Request

post/v1/orders/{order_id}/shipments/

Request body

Shipment

Field Type Description
shipment_id Guid MySale unique ID for Shipment
merchant_shipment_id string Identification of Shipment given by Merchant
tracking_number string Merchant tracking number
delivery_option string Delivery option
carrier string Post service name
carrier_shipment_method string Post service option
dispatch_date Date Date/Time that a given shipment was shipped.
expected_delivery_date Date Date/Time that a given shipment is expected to be delivered. This needs to be after order_date.
shipment_items ShipmentItem List of items to be shipped

ShipmentItem

Field Type Description
merchant_shipment_item_id Guid Identification of Shipment Item given by Merchant
merchant_sku_id string Identification of SKU given by Merchant
sku_id Guid MySale unique ID for SKU
sku_qty string Quantity of this SKU to be shipped

Response body

Returns created Shippment Id (Guid)

Update Shipment

curl "/v1/orderd/{order_id}/shipments/{shipment_id}"
  -H "Authorization: Bearer XyZAlexYustasu::NeSHarit00Etot42klyuch"
  -X PUT -d "{json data, see sample below}"

Example Request body:

{
  "merchant_shipment_id": "96B8A04E-141A-452D-9DE8-F63E1933B004",
  "tracking_number": "New tracking number",
  "delivery_option": "pickup_point",
  "carrier": "Auspost",
  "carrier_shipment_method": "Express",
  "dispatch_date": "2017-06-15T19:35:22+00:00",
  "expected_delivery_date": "2017-06-16T19:35:22+00:00",
  "shipment_items": [
    {
      "merchant_shipment_item_id": "MYORDERITEMID1",
      "merchant_sku_id": "MYSKU02",
      "sku_id": "ee06f701-e403-4dd9-82fc-927209d18dd1",
      "sku_qty": 1
    }
  ]
}

This endpoint Updates Shipment of the Order

HTTP Request

put/v1/orders/{order_id}/shipments/{shipment_id}

Request body

Shipment

Field Type Description
merchant_shipment_id string Identification of Shipment given by Merchant
tracking_number string Merchant tracking number
delivery_option string Delivery option
carrier string Post service name
carrier_shipment_method string Post service option
expected_delivery_date Date Date/Time that a given shipment is expected to be delivered. This needs to be after order_date.
shipment_items ShipmentItem List of items to be shipped

ShipmentItem

Field Type Description
merchant_shipment_item_id Guid Identification of Shipment Item given by Merchant
merchant_sku_id string Identification of SKU given by Merchant
sku_id Guid MySale unique ID for SKU
sku_qty string Quantity of this SKU to be shipped

Response body

Returns NoContent

Retrive all Shipments

curl "/v1/orderd/{order_id}/shipments/"
  -H "Authorization: Bearer XyZAlexYustasu::NeSHarit00Etot42klyuch"

Example Response body:

{
  "shipments": [
    {
      "shipment_id": "3764e178-ae78-4996-8eef-40dbe9f543ef",
      "merchant_shipment_id": "96B8A04E-141A-452D-9DE8-F63E1933B004",
      "tracking_number": "New tracking number",
      "delivery_option": "pickup_point",
      "carrier": "Auspost",
      "carrier_shipment_method": "Express",
      "dispatch_date": "2017-06-02T13:55:14.2851813+00:00",
      "expected_delivery_date": "2017-06-16T19:35:22+00:00",
      "shipment_items": [
        {
          "merchant_shipment_item_id": "MYORDERITEMID1",
          "merchant_sku_id": "MYSKU02",
          "sku_id": "ee06f701-e403-4dd9-82fc-927209d18dd1",
          "sku_qty": 1
        }
      ]
    }
  ]
}

This endpoint Retrives all Shipments of the Order

HTTP Request

get/v1/orders/{order_id}/shipments/

Response body

Shipment

Field Type Description
shipment_id Guid MySale unique ID for Shipment
merchant_shipment_id string Identification of Shipment given by Merchant
tracking_number string Merchant tracking number
delivery_option string Delivery option
carrier string Post service name
carrier_shipment_method string Post service option
dispatch_date Date Date/Time that a given shipment was shipped.
expected_delivery_date Date Date/Time that a given shipment is expected to be delivered. This needs to be after order_date.
shipment_items ShipmentItem List of items to be shipped

ShipmentItem

Field Type Description
merchant_shipment_item_id Guid Identification of Shipment Item given by Merchant
merchant_sku_id string Identification of SKU given by Merchant
sku_id Guid MySale unique ID for SKU
sku_qty string Quantity of this SKU to be shipped

Retrive a Specific Shipment

curl "/v1/orderd/{order_id}/shipments/{shipment_id}/"
  -H "Authorization: Bearer XyZAlexYustasu::NeSHarit00Etot42klyuch"

Example Response body:

{
  "merchant_shipment_id": "96B8A04E-141A-452D-9DE8-F63E1933B004",
  "tracking_number": "New tracking number",
  "delivery_option": "pickup_point",
  "carrier": "Auspost",
  "carrier_shipment_method": "Express",
  "dispatch_date": "2017-06-15T19:35:22+00:00",
  "expected_delivery_date": "2017-06-16T19:35:22+00:00",
  "shipment_items": [
    {
      "merchant_shipment_item_id": "MYORDERITEMID1",
      "merchant_sku_id": "MYSKU02",
      "sku_id": "ee06f701-e403-4dd9-82fc-927209d18dd1",
      "sku_qty": 1
    }
  ]
}

This endpoint Retrives Shipment of the Order

HTTP Request

get/v1/orders/{order_id}/shipments/{shipment_id}/

Response body

Shipment

Field Type Description
shipment_id Guid MySale unique ID for Shipment
merchant_shipment_id string Identification of Shipment given by Merchant
tracking_number string Merchant tracking number
delivery_option string Delivery option
carrier string Post service name
carrier_shipment_method string Post service option
dispatch_date Date Date/Time that a given shipment was shipped.
expected_delivery_date Date Date/Time that a given shipment is expected to be delivered. This needs to be after order_date.
shipment_items ShipmentItem List of items to be shipped

ShipmentItem

Field Type Description
merchant_shipment_item_id Guid Identification of Shipment Item given by Merchant
merchant_sku_id string Identification of SKU given by Merchant
sku_id Guid MySale unique ID for SKU
sku_qty string Quantity of this SKU to be shipped

Upload Cancellation

curl "/v1/orderd/{order_id}/cancellations/"
  -H "Authorization: Bearer XyZAlexYustasu::NeSHarit00Etot42klyuch"
  -X POST -d "{json data, see sample below}"

Example Request body:

{
  "cancelled_items": [
    {
      "merchant_cancel_item_id": "MYORDERITEMIDCAN1",
            "merchant_sku_id": "MYSKU01",
            "sku_id": "7b798536-b9b7-4613-b0c7-996bace854e8",
            "sku_qty": 2,
            "cancellation_reason": "no_stock"
    },
    {
      "merchant_cancel_item_id": "MYORDERITEMIDCAN1",
            "merchant_sku_id": "MYSKU01",
            "sku_id": "7b798536-b9b7-4613-b0c7-996bace854e8",
            "sku_qty": 1,
            "cancellation_reason": "no_stock"
    }
  ]
}

Example Response:


    "3764e178-ae78-4996-8eef-40dbe9f543ef"

This endpoint adds Cancellation to the Order

HTTP Request

post/v1/orders/{order_id}/cancellations/

Request body

Cancellation

Field Type Description
cancellation_id Guid MySale unique ID for Cancellation
cancelled_items CancelledItem List of items to be cancelled

CancelledItem

Field Type Description
merchant_cancel_item_id string Identification of Cancellation Item given by Merchant
merchant_sku_id string Identification of SKU given by Merchant
sku_id Guid MySale unique ID for SKU
sku_qty int Quantity of this SKU to be cancalled
cancellation_reason string
Status descriptions:
no_stock,
fraud_high_risk,
fraud_charge_back,
fraud_confirmed,
customer_cancelled_sale_error,
customer_cancelled_delayed,
customer_cancelled_change_of_mind,
unfulfillable_address,
other
Reason of cancellation

Response body

Returns created Cancellation Id (Guid)

Retrive All Cancellations

curl "/v1/orderd/{order_id}/cancellations/"
  -H "Authorization: Bearer XyZAlexYustasu::NeSHarit00Etot42klyuch"

Example Request body:

{
  "cancellations": [
    {
      "cancellation_id": "1c8720df-d785-4eff-bb7d-59492acc35a8",
      "cancelled_items": [
        {
          "merchant_cancel_item_id": "MYORDERITEMIDCAN1",
          "merchant_sku_id": "MYSKU01",
          "sku_id": "ee06f701-e403-4dd9-82fc-927209d18dd1",
          "sku_qty": 2,
          "cancellation_reason": "no_stock"
        }
      ]
    }
  ]
}

Example Response:


    "3764e178-ae78-4996-8eef-40dbe9f543ef"

This endpoint gets all Cancellations of the Order

HTTP Request

get/v1/orders/{order_id}/cancellations/

Response body

Cancellation

Field Type Description
cancellation_id Guid MySale unique ID for Cancellation
cancelled_items CancelledItem List of items to be cancelled

CancelledItem

Field Type Description
merchant_cancel_item_id string Identification of Cancellation Item given by Merchant
merchant_sku_id string Identification of SKU given by Merchant
sku_id Guid MySale unique ID for SKU
sku_qty int Quantity of this SKU to be cancalled
cancellation_reason string
Status descriptions:
no_stock,
fraud_high_risk,
fraud_charge_back,
fraud_confirmed,
customer_cancelled_sale_error,
customer_cancelled_delayed,
customer_cancelled_change_of_mind,
unfulfillable_address,
other
Reason of cancellation

Retrive a Specific Cancellation

curl "/v1/orderd/{order_id}/cancellations/{cancellation_id}/"
  -H "Authorization: Bearer XyZAlexYustasu::NeSHarit00Etot42klyuch"

Example Request body:

{
  "cancelled_items": [
    {
      "merchant_cancel_item_id": "MYORDERITEMIDCAN1",
            "merchant_sku_id": "MYSKU01",
            "sku_id": "7b798536-b9b7-4613-b0c7-996bace854e8",
            "sku_qty": 2,
            "cancellation_reason": "no_stock"
    },
    {
      "merchant_cancel_item_id": "MYORDERITEMIDCAN1",
            "merchant_sku_id": "MYSKU01",
            "sku_id": "7b798536-b9b7-4613-b0c7-996bace854e8",
            "sku_qty": 1,
            "cancellation_reason": "no_stock"
    }
  ]
}

Example Response:


    "3764e178-ae78-4996-8eef-40dbe9f543ef"

This endpoint adds Cancellation to the Order

HTTP Request

get/v1/orders/{order_id}/cancellations/{cancellation_id}/

Response body

Cancellation

Field Type Description
cancellation_id Guid MySale unique ID for Cancellation
cancelled_items CancelledItem List of items to be cancelled

CancelledItem

Field Type Description
merchant_cancel_item_id string Identification of Cancellation Item given by Merchant
merchant_sku_id string Identification of SKU given by Merchant
sku_id Guid MySale unique ID for SKU
sku_qty int Quantity of this SKU to be cancalled
cancellation_reason string
Status descriptions:
no_stock,
fraud_high_risk,
fraud_charge_back,
fraud_confirmed,
customer_cancelled_sale_error,
customer_cancelled_delayed,
customer_cancelled_change_of_mind,
unfulfillable_address,
other
Reason of cancellation

Errors

The Marketplace Merchant API uses the following error codes:

Error Code Meaning
400 Bad Request – Bad request. See details in response content
401 Unauthorized – Invalid authorization header
404 Not Found – The specified entity doesn’t exist or could not be found
405 Method Not Allowed – You tried to access an entity with an invalid method
406 Not Acceptable – You requested a format that isn’t json
429 Too Many Requests – You’re requesting too often
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.