Product

Products are arrays filled with information about products. There is key 'images' which is array with data about product images.


Product properties

availability "availability": 1

Flags this indicate if product is available for sale and is visibile in a store. In one of this condition is not true, then this product is unavailable.
buy_if_empty "buy_if_empty": 0

State informing if you can still can buy this product if items in stock is equal to zero.
categories "categories": "[
{
    "id" : 32,
    "uuid" : "a9af98e3-c932-4f05-bf3d-553cbec405f5",
    "parent" : 0,
    "title" : "Delikatesy",
    "tree" : "0-32",
},
{
    "id" : 46,
    "uuid" : "25f30198-d93d-4c1e-8ea4-df525eb7944b",
    "parent" : 0,
    "title" : "Spożywcze",
    "tree" : "0-46",
}]"


List of categories objects where product belong. Each category has the following properties:
  • id - numeric identifier of the category.
  • uuid - identifier of the category.
  • parent - numeric identifier of the parent category.
  • title - name of the category.
  • tree - dash separeted list of categories identifiers to which category belong.
collections "collections": "[
{
    "id" : 2,
    "uuid" : "7b11eb69-c3cb-4926-b3b1-3ea6a432ecb6",
    "title" : "Bestsellers",
},
{
    "id" : 6,
    "uuid" : "347d431d-be61-4788-98c8-a750ee0aed67",
    "title" : "Autumn Collection",
}]"


List of collections objects where product belong. Each collection has the following properties:
  • id - numeric identifier of the collection.
  • uuid - identifier of the collection.
  • title - name of the collection.
created_at "created_at": "2012-09-18 14:20:55"

Date and time when a product was created in format YYYY-MM-DD HH:ii:ss.
depth "depth": 200

Depth of the product.
description "description": "Najwyższej jakości makaron wyprodukowany w 100% z semoliny z pszenicy durum. Najlepiej smakuje z sosem pomidorowym z boczkiem, mięsem lub rybami."

Short description of the product.
diameter "diameter": 300

Diameter of the product.
height "height": 400

Height of the product.
id "id": 74

Unique numeric product identifier. Each id is unique only in the store. Across Shoplo platform product identifier can be repeated.
uuid "uuid": "d592ef11-2074-4673-87c6-e2289c42ae2b"

Unique product identifier. Main object identifier in the future API.
images "images": "[
{
    "id" : 432,
    "uuid" : "83b7addb-c0a7-4ed0-b6b9-0389a48cfcae",
    "position" : 1,
    "product_id" : 74,
    "created_at" : "2011-05-20 18:13:26",
    "updated_at" : "2011-05-20 18:13:26",
    "ext" : "jpg",
    "title" : "89-IMG_2070",
    "src" : "https://localhost/shoplo/static/0001/products/th640/aaab/89-IMG_2070.jpg",
},
{
    "id" : 434,
    "uuid" : "62b4f5c6-2179-480d-aa14-a79cb89a94fd",
    "position" : 2,
    "product_id" : 74,
    "created_at" : "2011-05-20 18:13:32",
    "updated_at" : "2011-05-20 18:13:32",
    "ext" : "jpg",
    "title" : "90-IMG_2075",
    "src" : "https://localhost/shoplo/static/0001/products/th640/aaab/90-IMG_2075.jpg",
}]"


List of image objects, each one representing an image associated with the product. Each object contains the following properties:
  • created_at - Date and time when the image was created in format YYYY-MM-DD HH:ii:ss.
  • ext - Image extension.
  • id - Numeric identifier of the image.
  • uuid - Identifier of the image.
  • position - Position of the image.
  • product_id - Product identifier to which image belong.
  • src - Full url path of the image.
  • updated_at - Date and time when the image was updated in format YYYY-MM-DD HH:ii:ss.
metadata "metadata": "{
    "meta_title" : null,
    "meta_description" : null,
    "meta_keywords" : null,
}"


Object of additional information about product.
name "name": "Penne Rigate makaron pióra 500g"

Name of the product.
price_min "price_min": 16500

Minimal price of a product. Each product can contains multiple variants and each variant can very of price.
price_max "price_max": 27500

Maximal price which can have this product.
promotion_id "promotion_id": 0

If a product is in promotion, in this field You can find promotion identifier. Product can belong only to one promotion in the same time.
require_shipping "require_shipping": 1

States whether or not the product need fulfillment. Values are: 0 or 1.
short_description "short_description": ""

Short description of a product.
tags "tags": "makaron,penne"

Comma separeted list of product tags. Commonly used for filtering and searching.
tax "tax": 23

Tax amount of a product.
tax_type "tax_type": "other"

Type of the tax which was applied to the product. Possible options are: zw (zwolniony), np (nie podlega) and other.
thumbnail "thumbnail": "https://cdn.shoplo.com/static/0001/products/th640/aaab/144-image-1.jpg"

Url of the main image of the product (deprecated).
width "width": 300

Width of the product.
updated_at "updated_at": "2012-09-18 14:20:55"

Date and time when a product was updated in format YYYY-MM-DD HH:ii:ss.
url "url": "penne-rigate-makaron-piora-500g"

Product url which is visible in browser.
variant_properties "variant_properties": "[
{
    "id" : 12,
"uuid" : "1c759c45-7888-42fe-b14a-a232920fb2ff",
    "name" : "Size",
    "pos" : 1,
},
{
    "id" : 22,
"uuid" : "5268b360-ff4f-4c2b-98ae-c25201934a66",
    "name" : "Material",
    "pos" : 2,
}
]"


List of product properties objects. Each object contains:
  • id - Numeric identifier of the product property.
  • uuid - Identifier of the product property.
  • name - Property name.
  • pos - Position of the property.
variants "variants": "[
{
    "availability" : 1,
    "availability_description" : 24,
    "availability_type" : "hours",
    "barcode" : "123456789",
    "buy_if_empty" : 0,
    "created_at" : "2012-09-18 14:20:55",
    "id" : 86,
    "uuid" : "1010183b-6638-41e3-bc9f-e760984825e4",
    "magazine_group" : 0,
    "position" : 1
    "price" : 619,
    "price_regular" : 619,
    "product_id" : 74,
    "property_name_1" : "",
    "property_name_2" : "",
    "property_name_3" : "",
    "quantity" : 97,
    "sku" : "sku20",
    "thumbnail" : "https://localhost/shoplo/static/0001/products/th640/aaab/127-image-1.jpg",
    "title" : "Penne Rigate makaron pióra 500g",
    "updated_at" : "2012-09-18 14:20:55",
    "weight" : 50,
},
]"


List of variant objects, each one representing a slightly different version of the product. For example, if a product comes in different sizes and colors, each size and color permutation (such as small black, medium black, large blue), would be a variant. It contains the following properties:
  • availability - Flag indicates if the product variant is available for sale.
  • availability_description - Description indicates when this variant is available. If the availability_type is equal to "own", then this field is filled by store owner with his own description. In other options this field is numeric.
  • availability_type - Type of availability. Possible options are:
    • own - With this options store owner write own description in field availability_description.
    • hours - Product variant is available in hours. Information in about how many hours this product variant is available is described in field availability_description.
    • days - Product variant is available in days. Information in about how many hours this product variant is available is described in field availability_description.
    • weeks - Product variant is available in weeks. Information in about how many hours this product variant is available is described in field availability_description.
    • months - Product variant is available in months. Information in about how many hours this product variant is available is described in field availability_description.
  • barcode - Barcode, UPC, or ISBN number for the product.
  • buy_if_empty - State informing if you can still can buy this product if items in stock is equal to zero.
  • created_at - Date and time when the variant was created in format YYYY-MM-DD HH:ii:ss.
  • id - Unique number identifier of the product variant.
  • uuid - Unique identifier of the product variant.
  • magazine_group - Identifier of the magazine group to which one belong product. If product not belong to any group the value will be 0.
  • position - The order of the product variant in the list of product variants.
  • price - Price of the product variant.
  • price_regular - If there is no promotion on the product. Price and price_regular are the same. If the variant is in promotion, field price_regular is showing us price before promotion.
  • product_id - Product numeric identifier.
  • property_name_1 - custom first property value, eg. Small (for property Size).
  • property_name_2 - custom second property value, eg. Blue (for property Colour).
  • property_name_3 - custom third property value, eg.
  • quantity - Number of items in stock for this product variant.
  • sku - Unique identifier for the product in the shop (stock keeping unit).
  • thumbnail - Url of the image of the variant.
  • title - Title of the product variant.
  • updated_at - Date and time when the variant was updated in format YYYY-MM-DD HH:ii:ss.
  • weight - Weight of the product variant.
vendor "vendor": "Barilla"

Name of the vendor of the product.


Receive a list of all Products

Query parameters:
  • fields - list of fields returning in response
  • limit - number of returned products (default: 50, max: 200)
  • page - currently displayed page (default: 1)
  • since_id - restrict products to greater identifiers than specified id
  • url - filter with url address
  • category_id - filter with category id
  • collection_id - filter with collection id
  • vendor_id - filter with vendor id
  • sku - filter with product sku
  • require_shipping - filter with products which require shipping or not if specified
  • created_at_min - shows products, which creation date was later than specified (format: 2011-06-19 13:18:50)
  • created_at_max - shows products, which creation date was earlier than specified (format: 2011-06-19 13:18:50)
  • updated_at_min - shows products, which modification date was later than specified (format: 2011-06-19 13:18:50)
  • updated_at_max - shows products, which modification date was earlier than specified (format: 2011-06-19 13:18:50)
GET /services/products

Returns all products

HTTP/1.1 200 OK
{
	"products": [
		{
			"id" : "74",
			"uuid" : "84128534-87e2-42bd-ac48-cd3e80d182dc",
			"name" : "Penne Rigate makaron pióra 500g",
			"url" : "penne-rigate-makaron-piora-500g",
			"description" : "Najwyższej jakości makaron wyprodukowany w 100% z semoliny z pszenicy durum. Najlepiej smakuje z sosem pomidorowym z boczkiem, mięsem lub rybami.",
			"short_description" : "",
			"require_shipping" : "1",
			"availability" : "1",
			"tax" : "23",
			"tax_type" : "other",
            "price_min" : "16500",
            "price_max" : "27500",
			"buy_if_empty" : "0",
            "promotion_id" : "0",
			"width" : "0",
			"height" : "0",
			"depth" : "0",
			"diameter" : "0",
			"thumbnail" : "https://localhost/shoplo/static/0001/products/th640/aaab/144-image-1.jpg",
			"created_at" : "2012-09-18 14:20:55",
			"updated_at" : "2012-09-18 14:20:55",
			"images" : [
				{
                    "id" : 432,
					"uuid" : "f60bf744-01a7-4624-b77f-d2b8c041d224",
                    "position" : 1,
					"product_id" : 74,
					"created_at" : "2011-05-20 18:13:26",
					"updated_at" : "2011-05-20 18:13:26",
					"ext" : "jpg",
					"title": "89-IMG_2070",
					"src" : "https://localhost/shoplo/static/0001/products/th640/aaab/89-IMG_2070.jpg",
				},
				{
                    "id" : 434,
					"uuid" : "8138bf21-15a2-44b3-b70c-a3d6ee31fa4e",
                    "position" : 2,
					"product_id" : 74,
					"created_at" : "2011-05-20 18:13:32",
					"updated_at" : "2011-05-20 18:13:32",
					"ext" : "jpg",
					"title": "90-IMG_2075",
					"src" : "https://localhost/shoplo/static/0001/products/th640/aaab/90-IMG_2075.jpg",
				},
			],
			"vendor" : "Barilla",
			"metadata" : {
				"meta_title" : null,
				"meta_description" : null,
				"meta_keywords" : null,
			},
			"variants" : [
				{
					"id" : "86",
					"uuid" : "6b6395e2-ab47-4084-83df-ce5b4ee56b07",
					"product_id" : "74",
					"sku" : "20",
					"property_name_1" : "",
					"property_name_2" : "",
					"property_name_3" : "",
					"price" : "619",
					"price_regular" : "619",
					"quantity" : "97",
					"weight" : "50",
					"add_to_magazine" : "1",
					"magazine_group" : "0",
					"buy_if_empty" : "0",
                    "thumbnail" : "https://localhost/shoplo/static/0001/products/th640/aaab/127-image-1.jpg",
					"availability" : "1",
                    "availability_description" : "24",
                    "availability_type" : "hours",
					"barcode" : "123456789",
					"created_at" : "2012-09-18 14:20:55",
					"updated_at" : "2012-09-18 14:20:55",
					"title" : "Penne Rigate makaron pióra 500g",
                    "position" : 1
				},
			],
			"categories" : [
				{
					"id" : "32",
					"uuid" : "d4e9a700-1473-400c-8887-a1508cb77309",
					"parent" : "0",
					"title" : "Delikatesy",
					"tree" : "0-32",
				}, 
				{
					"id" : "46",
					"uuid" : "29e46305-a35e-43ad-8c9e-28ec982a818a",
					"parent" : "0",
					"title" : "Spożywcze",
					"tree" : "0-46",
				},
				{
					"id" : "50",
					"uuid" : "d4387c3c-41f2-49b3-9810-91e339f8ca07",
					"parent" : "0",
					"title" : "Artykuły sypkie",
					"tree" : "0-50",
				},
				{
					"id" : "52",
					"uuid" : "4717e37d-28ee-4f5f-b81b-19aa51772c9e",
					"parent" : "0",
					"title" : "Makarony",
					"tree" : "0-52",
				},
			],
		},
	],
}

Receive a count of all Products

Query parameters:
  • since_id - restrict products to greater identifiers than specified id
  • category_id - filter with category id
  • collection_id - filter with collection id
  • vendor_id - filter with vendor id
  • require_shipping - filter with products which require shipping or not if specified
  • created_at_min - counts products, which creation date was later than specified (format: 2011-06-19 13:18:50)
  • created_at_max - counts products, which creation date was earlier than specified (format: 2011-06-19 13:18:50)
  • updated_at_min - counts products, which modification date was later than specified (format: 2011-06-19 13:18:50)
  • updated_at_max - counts products, which modification date was earlier than specified (format: 2011-06-19 13:18:50)
GET /services/products/count

Receive a count of all Products

HTTP/1.1 200 OK
{
	"count": 8920
}

Receive a single Product

Query parameters:
  • fields - list of fields returning in response
GET services/products/{id}

Receive a single Product

Response
HTTP/1.1 200 OK
{
	"product": {
		"id" : "74",
		"uuid" : "84128534-87e2-42bd-ac48-cd3e80d182dc",
		"name" : "Penne Rigate makaron pióra 500g",
		"url" : "penne-rigate-makaron-piora-500g",
		"description" : "Najwyższej jakości makaron wyprodukowany w 100% z semoliny z pszenicy durum. Najlepiej smakuje z sosem pomidorowym z boczkiem, mięsem lub rybami.",
		"short_description" : "",
		"require_shipping" : "1",
		"availability" : "1",
		"tax" : "23",
		"tax_type" : "other",
        "price_min" : "16500",
        "price_max" : "27500",
		"buy_if_empty" : "0",
        "promotion_id" : "0",
		"width" : "0",
		"height" : "0",
		"depth" : "0",
		"diameter" : "0",
		"thumbnail" : "https://localhost/shoplo/static/0001/products/th640/aaab/144-image-1.jpg",
		"created_at" : "2012-09-18 14:20:55",
		"updated_at" : "2012-09-18 14:20:55",
		"images" : [
			{
                "id" : 432,
				"uuid" : "f60bf744-01a7-4624-b77f-d2b8c041d224",
                "position" : 1,
                "product_id" : 74,
				"created_at" : "2011-05-20 18:13:26",
				"updated_at" : "2011-05-20 18:13:26",
				"ext" : "jpg",
				"title": "89-IMG_2070",
				"src" : "https://localhost/shoplo/static/0001/products/th640/aaab/89-IMG_2070.jpg",
			},				
			{
                "id" : 434,
				"uuid" : "8138bf21-15a2-44b3-b70c-a3d6ee31fa4e",
                "position" : 2,
				"product_id" : 74,
				"created_at" : "2011-05-20 18:13:32",
				"updated_at" : "2011-05-20 18:13:32",
				"ext" : "jpg",
				"title": "90-IMG_2075",
				"src" : "https://localhost/shoplo/static/0001/products/th640/aaab/90-IMG_2075.jpg",
			},
		],
		"vendor" : "Barilla",
		"metadata" : {
			"meta_title" : null,
			"meta_description" : null,
			"meta_keywords" : null,
        },
		"variants" : [
			{
				"id" : "86",
				"uuid" : "6b6395e2-ab47-4084-83df-ce5b4ee56b07",
				"product_id" : "74",
				"sku" : "20",
				"property_name_1" : "",
				"property_name_2" : "",
				"property_name_3" : "",
				"price" : "619",
				"price_regular" : "619",
				"quantity" : "97",
				"weight" : "50",
				"add_to_magazine" : "1",
				"magazine_group" : "0",
				"buy_if_empty" : "0",
                "thumbnail" : "https://localhost/shoplo/static/0001/products/th640/aaab/127-image-1.jpg",
				"availability" : "1",
                "availability_description" : "2",
                "availability_type" : "weeks",
				"barcode" : "123456789",
				"created_at" : "2012-09-18 14:20:55",
				"updated_at" : "2012-09-18 14:20:55",
				"title" : "Penne Rigate makaron pióra 500g",
                "position" : 1
			},
		],
		"categories" : [
			{
				"id" : "32",
				"uuid" : "d4e9a700-1473-400c-8887-a1508cb77309",
				"parent" : "0",
				"title" : "Delikatesy",
				"tree" : "0-32",
			},
			{
				"id" : "46",
				"uuid" : "29e46305-a35e-43ad-8c9e-28ec982a818a",
				"parent" : "0",
				"title" : "Spożywcze",
				"tree" : "0-46",
			},
			{
				"id" : "50",
				"uuid" : "d4387c3c-41f2-49b3-9810-91e339f8ca07",
				"parent" : "0",
				"title" : "Artykuły sypkie",
				"tree" : "0-50",
			},
			{
				"id" : "52",
				"uuid" : "4717e37d-28ee-4f5f-b81b-19aa51772c9e",
				"parent" : "0",
				"title" : "Makarony",
				"tree" : "0-52",
			},
		],
	},
}

Create a Product

POST services/products

Create product with specified parameters

Request
{
	"product": {
		"title" : "Penne Rigate makaron pióra 500g",
		"description" : "Najwyższej jakości makaron wyprodukowany w 100% z semoliny z pszenicy durum. Najlepiej smakuje z sosem pomidorowym z boczkiem, mięsem lub rybami.",
		"short_description" : "",
		"require_shipping" : "1",
		"availability" : "1",
		"visibility" : "1",
		"sku" : "PR-500-P",
		"width" : "0",
		"height" : "0",
		"depth" : "0",
		"diameter" : "0",
		"buy_if_empty" : "0",
		"quantity" : "1",
		"price" : "619",
		"price_regular" : "619",
		"tax" : "23",
		"images" : [
			{
				"src" : "https://localhost/products/89-IMG_2070.jpg",
				"title" : "",
				"img_main"	: false,
			},				
			{
				"src" : "https://localhost/products/90-IMG_2075.jpg",
				"title" : "",
				"img_main"	: false,
			},
		],
		"vendor" : "Barilla",
        "metadata" : {
            "meta_title" : null,
            "meta_description" : null,
            "meta_keywords" : null,
        },
		"variants" : [
			{
				"sku" : "PR-500-P-1",
				"property_1" : "Kolor",
				"property_name_1" : "Czerwony",
				"property_2" : "Rozmiar",
				"property_name_2" : "XXL",
				"price_regular" : "619",
				"quantity" : "97",
				"weight" : "50",
				"magazine_group" : "0",
				"buy_if_empty" : "0",
				"availability" : "1",
                "availability_description" : "3",
                "availability_type" : "days",
				"barcode" : "123456789",
			},
		],
		"category" : {
                    "Delikatesy",
                    "Makarony",
                    50
                },
                "collection" : {
                    "Zdrowa żywność",
                    "Frontpage"
                },
		"tags"	: "penne,makaron,zdrowy",
	},
}
Response
HTTP/1.1 200 OK
{
	"product": {
		"id" : "74",
		"uuid" : "84128534-87e2-42bd-ac48-cd3e80d182dc",
		"name" : "Penne Rigate makaron pióra 500g",
		"url" : "penne-rigate-makaron-piora-500g",
		"description" : "Najwyższej jakości makaron wyprodukowany w 100% z semoliny z pszenicy durum. Najlepiej smakuje z sosem pomidorowym z boczkiem, mięsem lub rybami.",
		"short_description" : "",
		"require_shipping" : "1",
		"availability" : "1",
		"tax" : "23",
		"tax_type": "other",
        "price_min" : "16500",
        "price_max" : "27500",
		"buy_if_empty" : "0",
        "promotion_id" : "0",
		"width" : "0",
		"height" : "0",
		"depth" : "0",
		"diameter" : "0",
		"thumbnail" : "https://localhost/shoplo/static/0001/products/th640/aaab/144-image-1.jpg",
		"created_at" : "2012-09-18 14:20:55",
		"updated_at" : "2012-09-18 14:20:55",
		"images" : [
			{
                "id" : 432,
				"uuid" : "f60bf744-01a7-4624-b77f-d2b8c041d224",
                "position" : 1,
				"product_id" : 74,
				"created_at" : "2011-05-20 18:13:26",
				"updated_at" : "2011-05-20 18:13:26",
				"ext" : "jpg",
				"title": "89-IMG_2070",
				"src" : "https://localhost/shoplo/static/0001/products/th640/aaab/89-IMG_2070.jpg",
			},
			{
                "id" : 434,
				"uuid" : "8138bf21-15a2-44b3-b70c-a3d6ee31fa4e",
                "position" : 2,
				"product_id" : 74,
				"created_at" : "2011-05-20 18:13:32",
				"updated_at" : "2011-05-20 18:13:32",
				"ext" : "jpg",
				"title": "90-IMG_2075",
				"src" : "https://localhost/shoplo/static/0001/products/th640/aaab/90-IMG_2075.jpg",
			},
		],
		"vendor" : "Barilla",
        "metadata" : {
            "meta_title" : null,
            "meta_description" : null,
            "meta_keywords" : null,
        },
		"variants" : [
			{
				"id" : "86",
				"uuid" : "6b6395e2-ab47-4084-83df-ce5b4ee56b07",
				"product_id" : "74",
				"sku" : "PR-500-P-1",
				"property_name_1" : "Czerwony",
				"property_name_2" : "XXL",
				"property_name_3" : "",
				"price" : "619",
				"price_regular" : "619",
				"quantity" : "97",
				"weight" : "50",
				"add_to_magazine" : "1",
				"magazine_group" : "0",
				"buy_if_empty" : "0",
                "thumbnail" : "https://localhost/shoplo/static/0001/products/th640/aaab/127-image-1.jpg",
				"availability" : "1",
                "availability_description" : "1",
                "availability_type" : "months",
				"barcode" : "123456789",
				"created_at" : "2012-09-18 14:20:55",
				"updated_at" : "2012-09-18 14:20:55",
				"title" : "Penne Rigate makaron pióra 500g",
                "position" : 1
			},
		],
		"categories" : [
			{
				"id" : "32",
				"uuid" : "d4e9a700-1473-400c-8887-a1508cb77309",
				"parent" : "0",
				"title" : "Delikatesy",
				"tree" : "0-32",
			},
			{
				"id" : "46",
				"uuid" : "29e46305-a35e-43ad-8c9e-28ec982a818a",
				"parent" : "0",
				"title" : "Spożywcze",
				"tree" : "0-46",
			},
			{
				"id" : "50",
				"uuid" : "d4387c3c-41f2-49b3-9810-91e339f8ca07",
				"parent" : "0",
				"title" : "Artykuły sypkie",
				"tree" : "0-50",
			},
			{
				"id" : "52",
				"uuid" : "4717e37d-28ee-4f5f-b81b-19aa51772c9e",
				"parent" : "0",
				"title" : "Makarony",
				"tree" : "0-52",
			},
		],
	},
}

Update an existing Product

PUT services/products/{id}

You can modify many details using these parameters: title, url, description, short_description, require_shipping, availability, quantity, price, price_regular, tax, sku, buy_if_empty, width, height, depth, diameter, vendor, metadata, tags.

Request
{
	"product": {
		"title" : "Al Dente Penne Rigate makaron pióra 500g",
	},
}
Response
HTTP/1.1 200 OK
{
	"product": {
		"id" : "74",
		"uuid" : "84128534-87e2-42bd-ac48-cd3e80d182dc",
		"name" : "Al Dente Penne Rigate makaron pióra 500g",
		"url" : "al-dente-penne-rigate-makaron-piora-500g",
		"description" : "Najwyższej jakości makaron wyprodukowany w 100% z semoliny z pszenicy durum. Najlepiej smakuje z sosem pomidorowym z boczkiem, mięsem lub rybami.",
		"short_description" : "",
		"require_shipping" : "1",
		"availability" : "1",
		"tax" : "23",
		"tax_type" : "other",
        "price_min" : "16500",
        "price_max" : "27500",
		"buy_if_empty" : "0",
        "promotion_id" : "0",
		"width" : "0",
		"height" : "0",
		"depth" : "0",
		"diameter" : "0",
		"thumbnail" : "https://localhost/shoplo/static/0001/products/th640/aaab/144-image-1.jpg",
		"created_at" : "2012-09-18 14:20:55",
		"updated_at" : "2012-09-18 14:20:55",
		"images" : [
			{
                "id" : 432,
				"uuid" : "f60bf744-01a7-4624-b77f-d2b8c041d224",
                "position" : 1,
				"product_id" : 74,
				"created_at" : "2011-05-20 18:13:26",
				"updated_at" : "2011-05-20 18:13:26",
				"ext" : "jpg",
				"title": "89-IMG_2070",
				"src" : "https://localhost/shoplo/static/0001/products/th640/aaab/89-IMG_2070.jpg",
			},				
			{
                "id" : 434,
				"uuid" : "8138bf21-15a2-44b3-b70c-a3d6ee31fa4e",
                "position" : 2,
				"product_id" : 74,
				"created_at" : "2011-05-20 18:13:32",
				"updated_at" : "2011-05-20 18:13:32",
				"ext" : "jpg",
				"title": "90-IMG_2075",
				"src" : "https://localhost/shoplo/static/0001/products/th640/aaab/90-IMG_2075.jpg",
			},
		],
		"vendor" : "Barilla",
		"metadata" : {
			"meta_title" : null,
			"meta_description" : null,
			"meta_keywords" : null,
		},
		"variants" : [
			{
				"id" : "86",
				"uuid" : "6b6395e2-ab47-4084-83df-ce5b4ee56b07",
				"product_id" : "74",
				"sku" : "20",
				"property_name_1" : "",
				"property_name_2" : "",
				"property_name_3" : "",
				"price" : "619",
				"price_regular" : "619",
				"quantity" : "97",
				"weight" : "50",
				"add_to_magazine" : "1",
				"magazine_group" : "0",
				"buy_if_empty" : "0",
                "thumbnail" : "https://localhost/shoplo/static/0001/products/th640/aaab/127-image-1.jpg",
				"availability" : "1",
                "availability_description" : "24",
                "availability_type" : "hours",
				"barcode" : "123456789",
				"created_at" : "2012-09-18 14:20:55",
				"updated_at" : "2012-09-18 14:20:55",
				"title" : "Al Dente Penne Rigate makaron pióra 500g",
                "position" : 1
			},
		],
		"categories" : [
			{
				"id" : "32",
				"uuid" : "d4e9a700-1473-400c-8887-a1508cb77309",
				"parent" : "0",
				"title" : "Delikatesy",
				"tree" : "0-32",
			},
			{
				"id" : "46",
				"uuid" : "29e46305-a35e-43ad-8c9e-28ec982a818a",
				"parent" : "0",
				"title" : "Spożywcze",
				"tree" : "0-46",
			},
			{
				"id" : "50",
				"uuid" : "d4387c3c-41f2-49b3-9810-91e339f8ca07",
				"parent" : "0",
				"title" : "Artykuły sypkie",
				"tree" : "0-50",
			},
			{
				"id" : "52",
				"uuid" : "4717e37d-28ee-4f5f-b81b-19aa51772c9e",
				"parent" : "0",
				"title" : "Makarony",
				"tree" : "0-52",
			},
		],
	},
}

Delete an existing Product

DELETE services/products/{id}

Delete an existing product from a shop

Response
HTTP/1.1 200 OK
{
	"status"	: "ok",
}

Create Products - bulk

POST services/products_bulk

Create many products in one query

Request
{
"products":[
        {
            "title" : "Penne Rigate makaron pióra 500g",
            "description" : "Najwyższej jakości makaron wyprodukowany w 100% z semoliny z pszenicy durum. Najlepiej smakuje z sosem pomidorowym z boczkiem, mięsem lub rybami.",
            "short_description" : "",
            "require_shipping" : "1",
            "availability" : "1",
            "visibility" : "1",
            "sku" : "PR-500-P",
            "width" : "0",
            "height" : "0",
            "depth" : "0",
            "diameter" : "0",
            "buy_if_empty" : "0",
            "quantity" : "1",
            "price" : "619",
            "price_regular" : "619",
            "tax" : "23",
            "images" : [
                {
                    "src" : "https://localhost/products/89-IMG_2070.jpg",
                    "title" : "",
                    "img_main"	: false,
                },
                {
                    "src" : "https://localhost/products/90-IMG_2075.jpg",
                    "title" : "",
                    "img_main"	: false,
                },
            ],
            "vendor" : "Barilla",
            "metadata" : {
            "meta_title" : null,
            "meta_description" : null,
            "meta_keywords" : null,
            },
            "variants" : [
                {
                    "sku" : "PR-500-P-1",
                    "property_1" : "Kolor",
                    "property_name_1" : "Czerwony",
                    "property_2" : "Rozmiar",
                    "property_name_2" : "XXL",
                    "price_regular" : "619",
                    "quantity" : "97",
                    "weight" : "50",
                    "magazine_group" : "0",
                    "buy_if_empty" : "0",
                    "availability" : "1",
                    "availability_description" : "3",
                    "availability_type" : "days",
					"barcode" : "123456789",
                },
            ],
            "category" : {
                    "Delikatesy",
                    "Makarony",
                    50
            },
            "collection" : {
                    "Zdrowa żywność",
                    "Frontpage"
            },
            "tags"	: "penne,makaron,zdrowy",
        },
        {
            "title" : "Penne Rigate makaron rurki 500g",
            "description" : "Najwyższej jakości makaron wyprodukowany w 100% z semoliny z pszenicy durum. Najlepiej smakuje z sosem pomidorowym z boczkiem, mięsem lub rybami.",
            "short_description" : "",
            "require_shipping" : "1",
            "availability" : "1",
            "visibility" : "1",
            "sku" : "PR-501-P",
            "weight" : "50",
            "width" : "0",
            "height" : "0",
            "depth" : "0",
            "diameter" : "0",
            "buy_if_empty" : "0",
            "quantity" : "1",
            "price" : "619",
            "price_regular" : "619",
            "tax" : "23",
            "images" : [
                {
                    "src" : "https://localhost/products/91-IMG_2070.jpg",
                    "title" : "",
                    "img_main"	: false,
                },
                {
                    "src" : "https://localhost/products/92-IMG_2075.jpg",
                    "title" : "",
                    "img_main"	: false,
                },
            ],
            "vendor" : "Barilla",
            "metadata" : {
            "meta_title" : null,
            "meta_description" : null,
            "meta_keywords" : null,
            },
            "variants" : [
                {
                    "sku" : "PR-501-P-1",
                    "property_1" : "Kolor",
                    "property_name_1" : "Czerwony",
                    "property_2" : "Rozmiar",
                    "property_name_2" : "XXL",
                    "price_regular" : "619",
                    "quantity" : "97",
                    "weight" : "50",
                    "magazine_group" : "0",
                    "buy_if_empty" : "0",
                    "availability" : "1",
                    "availability_description" : "3",
                    "availability_type" : "days",
					"barcode" : "123456789",
                },
            ],
            "category" : {
                    "Delikatesy",
                    "Makarony",
                    50
            },
            "collection" : {
                    "Zdrowa żywność",
                    "Frontpage"
            },
            "tags"	: "penne,makaron,zdrowy",
        }
    ]
}
Response
HTTP/1.1 200 OK
{
    "products": [
        {
            "id" : "74",
			"uuid": "7a95c8cc-a310-4328-b310-5341fb88800f",
            "name" : "Penne Rigate makaron pióra 500g",
            "url" : "penne-rigate-makaron-piora-500g",
            "description" : "Najwyższej jakości makaron wyprodukowany w 100% z semoliny z pszenicy durum. Najlepiej smakuje z sosem pomidorowym z boczkiem, mięsem lub rybami.",
            "short_description" : "",
            "require_shipping" : "1",
            "availability" : "1",
            "tax" : "23",
			"tax_type" : "other",
            "price_min" : "16500",
            "price_max" : "27500",
            "buy_if_empty" : "0",
            "promotion_id" : "0",
            "width" : "0",
            "height" : "0",
            "depth" : "0",
            "diameter" : "0",
            "thumbnail" : "https://localhost/shoplo/static/0001/products/th640/aaab/144-image-1.jpg",
            "created_at" : "2012-09-18 14:20:55",
            "updated_at" : "2012-09-18 14:20:55",
            "images" : [
                {
                    "id" : 432,
					"uuid": "c2a516ff-08cd-4e27-9ec8-17df97a86bfb",
                    "position" : 1,
                    "product_id" : 74,
                    "created_at" : "2011-05-20 18:13:26",
                    "updated_at" : "2011-05-20 18:13:26",
					"ext" : "jpg",
					"title": "89-IMG_2070",
                    "src" : "https://localhost/shoplo/static/0001/products/th640/aaab/89-IMG_2070.jpg",
                },
                {
                    "id" : 434,
					"uuid": "2d76b973-064e-4652-ba9e-e5030ec5c1ab",
                    "position" : 2,
                    "product_id" : 74,
                    "created_at" : "2011-05-20 18:13:32",
                    "updated_at" : "2011-05-20 18:13:32",
					"ext" : "jpg",
					"title": "90-IMG_2075",
                    "src" : "https://localhost/shoplo/static/0001/products/th640/aaab/90-IMG_2075.jpg",
                },
            ],
            "vendor" : "Barilla",
            "metadata" : {
                "meta_title" : null,
                "meta_description" : null,
                "meta_keywords" : null,
            },
            "variants" : [
                {
                    "id" : "86",
					"uuid": "0a84f71a-a8b1-49a1-acd9-0d96ec651305",
                    "product_id" : "74",
                    "sku" : "PR-500-P-1",
                    "property_name_1" : "Czerwony",
                    "property_name_2" : "XXL",
                    "property_name_3" : "",
                    "price" : "619",
                    "price_regular" : "619",
                    "quantity" : "97",
                    "weight" : "50",
                    "add_to_magazine" : "1",
                    "magazine_group" : "0",
                    "buy_if_empty" : "0",
                    "thumbnail" : "https://localhost/shoplo/static/0001/products/th640/aaab/127-image-1.jpg",
                    "availability" : "1",
                    "availability_description" : "1",
                    "availability_type" : "months",
					"barcode" : "123456789",
                    "created_at" : "2012-09-18 14:20:55",
                    "updated_at" : "2012-09-18 14:20:55",
                    "title" : "Penne Rigate makaron pióra 500g",
                    "position" : 1
                }
            ],
            "categories" : [
				{
					"id" : "32",
					"uuid": "aab0622f-b69d-457a-8128-57d433654cc2",
					"parent" : "0",
					"title" : "Delikatesy",
					"tree" : "0-32",
				},
				{
					"id" : "46",
					"uuid": "92d619c8-f5c3-44dd-8e57-f376c41d11f7",
					"parent" : "0",
					"title" : "Spożywcze",
					"tree" : "0-46",
				},
				{
					"id" : "50",
					"uuid": "2d76b973-064e-4652-ba9e-e5030ec5c1ab",
					"parent" : "0",
					"title" : "Artykuły sypkie",
					"tree" : "0-50",
				},
				{
					"id" : "52",
					"uuid": "326274fb-416d-4952-91aa-4332ffa8f9fa",
					"parent" : "0",
					"title" : "Makarony",
					"tree" : "0-52",
				},
			]
        },
        {
            "id" : "74",
			"uuid": "31c31536-e51f-45c1-95dd-b7235d29567b",
            "name" : "Penne Rigate makaron rurki 500g",
            "url" : "penne-rigate-makaron-rurki-500g",
            "description" : "Najwyższej jakości makaron wyprodukowany w 100% z semoliny z pszenicy durum. Najlepiej smakuje z sosem pomidorowym z boczkiem, mięsem lub rybami.",
            "short_description" : "",
            "require_shipping" : "1",
            "availability" : "1",
            "tax" : "23",
            "price_min" : "16500",
            "price_max" : "27500",
            "buy_if_empty" : "0",
            "promotion_id" : "0",
            "width" : "0",
            "height" : "0",
            "depth" : "0",
            "diameter" : "0",
            "thumbnail" : "https://localhost/shoplo/static/0001/products/th640/aaab/144-image-1.jpg",
            "created_at" : "2012-09-18 14:20:55",
            "updated_at" : "2012-09-18 14:20:55",
            "images" : [
                {
                    "id" : 432,
					"uuid": "0ddb2488-8d15-4364-9b8b-07b3607fb16f",
                    "position" : 1,
                    "product_id" : 74,
                    "created_at" : "2011-05-20 18:13:26",
                    "updated_at" : "2011-05-20 18:13:26",
					"ext" : "jpg",
					"title": "91-IMG_2070",
                    "src" : "https://localhost/shoplo/static/0001/products/th640/aaab/91-IMG_2070.jpg",
                },
                {
                    "id" : 434,
					"uuid": "ef30631b-b24f-455c-81d7-844b98666be9",
                    "position" : 2,
                    "product_id" : 74,
                    "created_at" : "2011-05-20 18:13:32",
                    "updated_at" : "2011-05-20 18:13:32",
					"ext" : "jpg",
					"title": "92-IMG_2075",
                    "src" : "https://localhost/shoplo/static/0001/products/th640/aaab/92-IMG_2075.jpg",
                },
            ],
            "vendor" : "Barilla",
            "metadata" : {
                "meta_title" : null,
                "meta_description" : null,
                "meta_keywords" : null,
            },
            "variants" : [
                {
                    "id" : "86",
					"uuid": "139b324c-45e1-4c64-802c-7b5f8d5f4aab",
                    "product_id" : "74",
                    "sku" : "PR-500-P-1",
                    "property_name_1" : "Czerwony",
                    "property_name_2" : "XXL",
                    "property_name_3" : "",
                    "price" : "619",
                    "price_regular" : "619",
                    "quantity" : "97",
                    "weight" : "50",
                    "add_to_magazine" : "1",
                    "magazine_group" : "0",
                    "buy_if_empty" : "0",
                    "thumbnail" : "https://localhost/shoplo/static/0001/products/th640/aaab/127-image-1.jpg",
                    "availability" : "1",
                    "availability_description" : "1",
                    "availability_type" : "months",
					"barcode" : "123456789",
                    "created_at" : "2012-09-18 14:20:55",
                    "updated_at" : "2012-09-18 14:20:55",
                    "title" : "Penne Rigate makaron rurki 500g",
                    "position" : 1
                },
            ],
            "categories" : [
				{
					"id" : "32",
					"uuid": "022e418c-4a63-4417-925f-32a9278c49d7",
					"parent" : "0",
					"title" : "Delikatesy",
					"tree" : "0-32",
				},
				{
					"id" : "46",
					"uuid": "c9ba1659-d1bf-4175-88bc-fde33dea9d54",
					"parent" : "0",
					"title" : "Spożywcze",
					"tree" : "0-46",
				},
				{
					"id" : "50",
					"uuid": "19f50cbe-0cb3-4118-9bc5-353df5f54266",
					"parent" : "0",
					"title" : "Artykuły sypkie",
					"tree" : "0-50",
				},
				{
					"id" : "52",
					"uuid": "cde20dae-eb88-454a-8f6b-8808715d4049",
					"parent" : "0",
					"title" : "Makarony",
					"tree" : "0-52",
				},
			],
            }
    ]
}

Update an existing Products

PUT services/products_bulk

You can modify many details in many products using these parameters: title, url, description, short_description, require_shipping, availability, quantity, price, price_regular, tax, sku, buy_if_empty, width, height, depth, diameter, vendor, metadata, tags.

Request
{
"products": [
    {
        "id": "74",
        "title" : "Al Dente Penne Rigate makaron pióra 500g",
    },
    {
        "id": "86",
        "title" : "Al Dente Penne Rigate makaron rurki 500g",
    }
]
}
Response
HTTP/1.1 200 OK
{
    "products": [
         {
            "id" : "74",
			"uuid": "832b4dbc-7c6c-4152-bc61-f00543a20ef3",
            "name" : "Al Dente Penne Rigate makaron pióra 500g",
            "url" : "al-dente-penne-rigate-makaron-piora-500g",
            "description" : "Najwyższej jakości makaron wyprodukowany w 100% z semoliny z pszenicy durum. Najlepiej smakuje z sosem pomidorowym z boczkiem, mięsem lub rybami.",
            "short_description" : "",
            "require_shipping" : "1",
            "availability" : "1",
            "tax" : "23",
			"tax_type" : "other",
            "price_min" : "16500",
            "price_max" : "27500",
            "buy_if_empty" : "0",
            "promotion_id" : "0",
            "width" : "0",
            "height" : "0",
            "depth" : "0",
            "diameter" : "0",
            "thumbnail" : "https://localhost/shoplo/static/0001/products/th640/aaab/144-image-1.jpg",
            "created_at" : "2012-09-18 14:20:55",
            "updated_at" : "2012-09-18 14:20:55",
            "images" : [
                {
                    "id" : 432,
					"uuid": "fe00ef02-2ce9-4fd1-bd18-c1f7f27e5a92",
                    "position" : 1,
                    "product_id" : 74,
                    "created_at" : "2011-05-20 18:13:26",
                    "updated_at" : "2011-05-20 18:13:26",
					"ext" : "jpg",
					"title": "89-IMG_2070",
                    "src" : "https://localhost/shoplo/static/0001/products/th640/aaab/89-IMG_2070.jpg",
                },
                {
                    "id" : 434,
					"uuid": "5a252376-e474-4d5e-9b31-6df477148a49",
                    "position" : 2,
                    "product_id" : 74,
                    "created_at" : "2011-05-20 18:13:32",
                    "updated_at" : "2011-05-20 18:13:32",
					"ext" : "jpg",
					"title": "90-IMG_2075",
                    "src" : "https://localhost/shoplo/static/0001/products/th640/aaab/90-IMG_2075.jpg",
                },
            ],
            "vendor" : "Barilla",
            "metadata" : {
                "meta_title" : null,
                "meta_description" : null,
                "meta_keywords" : null,
            },
            "variants" : [
                {
                    "id" : "86",
					"uuid": "a075dfba-6736-44b4-8486-d76190685ee2",
                    "product_id" : "74",
                    "sku" : "20",
                    "property_name_1" : "",
                    "property_name_2" : "",
                    "property_name_3" : "",
                    "price" : "619",
                    "price_regular" : "619",
                    "quantity" : "97",
                    "weight" : "50",
                    "add_to_magazine" : "1",
                    "magazine_group" : "0",
                    "buy_if_empty" : "0",
                    "thumbnail" : "https://localhost/shoplo/static/0001/products/th640/aaab/127-image-1.jpg",
                    "availability" : "1",
                    "availability_description" : "24",
                    "availability_type" : "hours",
					"barcode" : "123456789",
                    "created_at" : "2012-09-18 14:20:55",
                    "updated_at" : "2012-09-18 14:20:55",
                    "title" : "Al Dente Penne Rigate makaron pióra 500g",
                    "position" : 1
                },
            ],
            "categories" : [
				{
					"id" : "32",
					"uuid": "bd048a6d-39a7-4430-85d4-2d6bf506a8a5",
					"parent" : "0",
					"title" : "Delikatesy",
					"tree" : "0-32",
				},
				{
					"id" : "46",
					"uuid": "40a2fab2-8af0-40ba-8963-a575193f98ab",
					"parent" : "0",
					"title" : "Spożywcze",
					"tree" : "0-46",
				},
				{
					"id" : "50",
					"uuid": "e55fe3bd-2701-4150-ada7-9581bfc5fbcb",
					"parent" : "0",
					"title" : "Artykuły sypkie",
					"tree" : "0-50",
				},
				{
					"id" : "52",
					"uuid": "cbeddba6-be8b-4773-91bb-8aceb4569f06",
					"parent" : "0",
					"title" : "Makarony",
					"tree" : "0-52",
				},
			]
         },
         {
            "id" : "74",
			"uuid": "63f0c702-3e32-4420-be01-940067f56b7b",
            "name" : "Al Dente Penne Rigate makaron rurki 500g",
            "url" : "al-dente-penne-rigate-makaron-rurki-500g",
            "description" : "Najwyższej jakości makaron wyprodukowany w 100% z semoliny z pszenicy durum. Najlepiej smakuje z sosem pomidorowym z boczkiem, mięsem lub rybami.",
            "short_description" : "",
            "require_shipping" : "1",
            "availability" : "1",
            "tax" : "23",
			"tax_type" : "other",
            "price_min" : "16500",
            "price_max" : "27500",
            "buy_if_empty" : "0",
            "promotion_id" : "0",
            "width" : "0",
            "height" : "0",
            "depth" : "0",
            "diameter" : "0",
            "thumbnail" : "https://localhost/shoplo/static/0001/products/th640/aaab/144-image-1.jpg",
            "created_at" : "2012-09-18 14:20:55",
            "updated_at" : "2012-09-18 14:20:55",
            "images" : [
                    {
                    "id" : 432,
					"uuid": "e2fa5f81-4dfb-4d31-a88c-fc19ffb3376b",
                    "position" : 1,
                    "product_id" : 74,
                    "created_at" : "2011-05-20 18:13:26",
                    "updated_at" : "2011-05-20 18:13:26",
					"title": "89-IMG_2070",
                    "src" : "https://localhost/shoplo/static/0001/products/th640/aaab/89-IMG_2070.jpg",
                },
                {
                    "id" : 434,
					"uuid": "8ea503d1-d938-47a9-9421-0b6d323720f1",
                    "position" : 2,
                    "product_id" : 74,
                    "created_at" : "2011-05-20 18:13:32",
                    "updated_at" : "2011-05-20 18:13:32",
					"title": "90-IMG_2075",
                    "src" : "https://localhost/shoplo/static/0001/products/th640/aaab/90-IMG_2075.jpg",
                },
            ],
            "vendor" : "Barilla",
            "metadata" : {
                "meta_title" : null,
                "meta_description" : null,
                "meta_keywords" : null,
            },
            "variants" : [
                {
                    "id" : "86",
					"uuid": "6c84274d-1bed-4043-8af1-3d43197f3843",
                    "product_id" : "74",
                    "sku" : "20",
                    "property_name_1" : "",
                    "property_name_2" : "",
                    "property_name_3" : "",
                    "price" : "619",
                    "price_regular" : "619",
                    "quantity" : "97",
                    "weight" : "50",
                    "add_to_magazine" : "1",
                    "magazine_group" : "0",
                    "buy_if_empty" : "0",
                    "thumbnail" : "https://localhost/shoplo/static/0001/products/th640/aaab/127-image-1.jpg",
                    "availability" : "1",
                    "availability_description" : "24",
                    "availability_type" : "hours",
					"barcode" : "123456789",
                    "created_at" : "2012-09-18 14:20:55",
                    "updated_at" : "2012-09-18 14:20:55",
                    "title" : "Al Dente Penne Rigate makaron rurki 500g",
                    "position" : 1
                },
            ],
            "categories" : [
				{
					"id" : "32",
					"uuid": "0dde5cb9-8e7a-4495-943a-0c4efb30be4f",
					"parent" : "0",
					"title" : "Delikatesy",
					"tree" : "0-32",
				},
				{
					"id" : "46",
					"uuid": "d7c6260a-0aef-4197-ad83-b1514e835825",
					"parent" : "0",
					"title" : "Spożywcze",
					"tree" : "0-46",
				},
				{
					"id" : "50",
					"uuid": "5d14935f-acfd-43bd-a5aa-6a55d48752b0",
					"parent" : "0",
					"title" : "Artykuły sypkie",
					"tree" : "0-50",
				},
				{
					"id" : "52",
					"uuid": "2194473b-84e8-4ec6-9f2e-17fb1e6c38e9",
					"parent" : "0",
					"title" : "Makarony",
					"tree" : "0-52",
				},
			],
        }
    ]
}