Aktualizacja produktów
Sposób działania
Za pomocą endpointu POST/import/product/update, można dodawać paczki produktów, które mają być zaktualizowane. Produkty z paczki zostaną dodane do kolejki. Natomiast na instancji w tle system aktualizuje produkty wg zdefiniowanej kolejki. W przypadku tego endpointu wysyłany tylko to co chcemy, aby zostało zaktualizowane oraz wymagane pola dla danego typu produktu.
Typy produktów
Aktualizować możemy następujące typy produktów:
Produkt pojedynczy
Definicja rodziny produktów
Wariant rodziny
Dokumentacja
Poniżej znajduje się dokumentacja, z wyszczególnionymi następującymi polami:
description- Jest to krótki opis czy dane pole jest,example- przykładowa wartość polatype- format* - pole wymagane
X - wszystkie znaki
[0-1] - tylko 0 lub 1
[0-9] - tylko liczby
R2 - liczba w systemie dziesiętnym z dwoma miejscami po przecinku
JSON - format JSON
(x) - limit znaków wynosi x, np: “(1) - limit znaków wynosi 1”
Aktualizacja produktu pojedynczego
code*
JSON
description: "Unique identifier code of product for the Saly",
example: "5907595646406",
type: "X (255) *"additional_code
ean
JSON
description: "International Article Number - thirteen-digit number used to identify product",
example: "5907595646406",
type: "[0-9] (13)"sku
JSON
description: "Stock keeping unit - identifier code of product",
example: "Mac Book Air 13,3",
type: "X (45)"supplier_product_code
JSON
description: "Unique number issued by supplier to identify individual product",
example: "5907595646406",
type: "X (255)"information
name
JSON
description: "Name identify product in different languages (available languages: pl, en, de, ru, es, fr, it). Data format must be preserved from the example,
example: {
"pl": "MacBook Air 13 gwiezdna szarość",
"en": "MacBook Air 13 Space Gray",
"de": "MacBook Air 13 Space Grua"
},
type: "JSON"description
JSON
description: "Description identify product in different languages (available languages: pl, en, de, ru, es, fr, it). Data format must be preserved from the example,
example: {
"pl": "<h4>MacBook Air 13 gwiezdna szarość</h4><p>przykładowy tekst</p>",
"en": "<h4>MacBook Air 13 Space Gray</h4><p>example text</p>",
"de": "<h4>MacBook Air 13 Space Grua</h4><p>Beispieltext</p>"
},
type: "JSON"is_active
JSON
description: "whether the product is published on frontOffice (available values: 0 - unpublished (default option), 1 - published)",
example: "1",
type: "[0-1] (1)"is_promoted
JSON
description: "whether the product is promoted on frontOffice (available values: 0 - unpromoted (default option), 1 - promoted)",
example: "0",
type: "[0-1] (1)"metadata
metatitle
JSON
description: "SEO data - Metatitle identify product in different languages (available languages: pl, en, de, ru, es, fr, it). Data format must be preserved from the example,
example: {
"pl": "MacBook Air 13 gwiezdna szarość",
"en": "MacBook Air 13 Space Gray",
"de": "MacBook Air 13 Space Grua"
},
type: "JSON"keywords
JSON
description: "SEO data - Keywords identify product in different languages (available languages: pl, en, de, ru, es, fr, it). Data format must be preserved from the example,
example: {
"pl": "MacBook,Air,13,gwiezdna szarość",
"en": "MacBook,Air,13,Space Gray",
"de": "MacBook,Air,13,Space Grua"
},
type: "JSON"metadescription
JSON
description: "SEO data - metadescription identify product in different languages (available languages: pl, en, de, ru, es, fr, it). Data format must be preserved from the example,
example: {
"pl": "MacBook Air 13 gwiezdna szarość - najlepsza cena",
"en": "MacBook Air 13 Space Gray - Best Price",
"de": "MacBook Air 13 Space Grua - bester Preis"
},
type: "JSON"slug
JSON
description: "Name used to friendly URL (english example: https://domain/en,productView,MacBook_Air_13_Space_Gray,8,42161.html. Data format must be preserved from the example,
example: {
"pl": "MacBook_Air_13_gwiezdna_szarosc",
"en": "MacBook_Air_13_Space_Gray",
"de": "MacBook_Air_13_Space_Grua"
},
type: "JSON"categories
categories_increase
JSON
description: "Information that categories should be added if value is 1 or should be replace when value is 0"
example: "1",
type: "[0-1] (1)"paths
JSON
description: "All categories in which the product exists. The first category will be the main category. Enter the full path of the category, where '/' is used as a separator (available languages: pl, en, de, ru, es, fr, it). Data format must be preserved from the example,
example: [
{
"pl": "Laptopy/Apple/MacBook Air 13",
"en": "Laptops/Apple/MacBook Air 13",
"de": "Laptops/Apple/MacBook Air 13"
},
{
"pl": "Apple/Laptopy/MacBook Air 13",
"en": "Apple/Laptops/MacBook Air 13",
"de": "Apple/Laptops/MacBook Air 13"
}
],
type: "JSON"price
base_netto
JSON
description: "The minimum net price for which a product can be sold",
example: "4000.00",
type: "R2"purchase_netto
JSON
description: "The net price at which the product was purchased",
example: "3300.99",
type: "R2"srp_netto
JSON
description: "Suggested retail price net for which the product can be sold",
example: "4499.99",
type: "R2"vat
JSON
description: "vat rate of the product",
example: "23",
type: "[0-9]"manufacturer
name
JSON
description: "The name of the manufacturer of the specified product",
example: "Apple",
type: "X (45)"logo
JSON
description: "Url, where the logo of a particular manufacturer is located",
example: "https://www.apple.com/logo.png",
type: "X (255)"energy_class
energy_class
JSON
description: "Energy class of a specific product",
example: "A",
type: "[A-G] (1)"energy_label_link
JSON
description: "Link to energy class label pdf of a specific product",
example: "https://link_to_energy_class_label.pdf",
type: "X (255)"energy_card_information_link
JSON
description: "Link to energy card information pdf of a specific product",
example: "https://link_to_energy_card_information_link.pdf",
type: "X (255)"stock
unit
JSON
description: "The name of the sales unit of a specific product",
example: "pcs.",
type: "X (55)"stock_enabled
JSON
description: "Information whether the product affects the stock. Such as service.",
example: "pcs.",
type: "X (55)"minimum_purchase_quantity
JSON
description: "The minimum quantity of the basic sales unit required to place an order for this product.",
example: "3",
type: "[0-9]"delivery_date
delivery_format
JSON
description: "Delivery time for this product. This information is saved to any existing warehouse. If this information is empty, the information is propagated from the warehouse.",
example: {"pl": "7 dni", "en": "7 days", "de": "7 Tage"},
type: "JSON"delivery_hour
JSON
description: "Delivery time of this product, given in hours",
example: "168",
type: "[0-9]"warehouse_external_id
JSON
description: "External id of the warehouse to which the delivery data relates,
example: "1",
type: "[0-9]"package
name
JSON
description: "The name of the package previously defined in the system in which the product should be transported",
example: "Euro-pallet",
type: "X (255)"dimensions
height
JSON
description: "The packaging height of a given product in centimeters",
example: "100.00",
type: "R2"width
JSON
description: "The packaging width of a given product in centimeters",
example: "100.00",
type: "R2"length
JSON
description: "The packaging length of a given product in centimeters",
example: "100.00",
type: "R2"weight
JSON
description: "The packaging weight of a given product in kilograms",
example: "10.00",
type: "R2"collective_packages
is_active
JSON
description: "whether the product is available for purchase in collective packages (available values: 0 - not available for purchase in collective packages (default option), 1 - available for purchase in collective packages)",
example: "0",
type: "[0-1] (1)"is_only_packages
JSON
description: "whether the product is available for purchase only in collective packages (available values: 0 - available not only in collective packages (default option), 1 - available only in collective packages)",
example: "0",
type: "[0-1] (1)"package_size
JSON
description: "how many products are in collective packages",
example: "12",
type: "[0-9]”price
discount
JSON
description: "Percentage price modification",
example: "10",
type: "[0-9]"is_includes_the_charge
JSON
description: "Wether the discount be added to the price first? (available values: 0 - standard price minus discount for clients used collective packages, standard price for clients not used collective packages (default option), 1 - standard price for clients used collective packages, standard price plus discount for clients not used collective packages)",
example: "0",
type: "[0-1] (1)"attributes
attributes_increase
JSON
description: "Information that attributes should be added if value is 1 or should be replace when value is 0"
example: "1",
type: "[0-1] (1)"attribute_group_filter_enabled
JSON
description: "When the value is equal to 1, attributes should be added or replaced exclusively within the provided attribute group.
example: "1",
type: "[0-1] (1)"attributes
JSON
description: "Product technical parameters arranged in groups and in the target order in which they are to be displayed on FrontOffice. These parameters can be in different languages (available languages: pl, en, de, ru, es, fr, it). Data format must be preserved from the example,
example: {
"pl": [
{
"Dane techniczne": [
["Kolor", "czerwony"],
["Rozmiar", "średni"]
]
},
{
"Dane dodatkowe" : [
["Produkt wyprodukowany w UE", "tak"]
]
}
],
"en": [
{
"Technical data": [
["Color", "red"],
["Size", "medium"]
]
},
{
"Additional data" : [
["Product manufactured in the EU", "yes"]
]
}
]
},
type: "JSON"multimedia
photos
photos_increase
JSON
description: "Information that photos should be added if value is 1 or should be replace when value is 0"
example: "1",
type: "[0-1] (1)"photos
JSON
description: "Urls, where the photos of a particular product is located. The number of this urls is not limited. Data format must be preserved from the example,
example: [
"https://example.com/photo1.jpg",
"https://example.com/photo2.jpg",
"https://example.com/photo3.jpg"
],
type: "JSON"files
files_increase
JSON
description: "Information that files should be added if value is 1 or should be replace when value is 0"
example: "1",
type: "[0-1] (1)"files
JSON
description: "Urls, where the files of a particular product is located, with they name representation. The number of this urls is not limited. Data format must be preserved from the example,
example: [
["file1.pdf","https://example.com/file1.pdf"],
["file2.pdf","https://example.com/file2.pdf"],
["file3.pdf","https://example.com/file3.pdf"]
],
type: "JSON"Przykładowy plik aktualizacyjny produktu pojedynczego
JSON
[
{
"code": "5907595646406",
"additional_code": {
"ean": "5907595646406",
"sku": "Mac Book Air 13,3",
"supplier_product_code": "5907595646406"
},
"information": {
"name": {
"pl": "MacBook Air 13 gwiezdna szarość",
"en": "MacBook Air 13 Space Gray",
"de": "MacBook Air 13 Space Grua"
},
"description": {
"pl": "<h4>MacBook Air 13 gwiezdna szarość</h4><p>przykładowy tekst</p>",
"en": "<h4>MacBook Air 13 Space Gray</h4><p>example text</p>",
"de": "<h4>MacBook Air 13 Space Grua</h4><p>Beispieltext</p>"
},
"is_active": "1",
"is_promoted": "0"
},
"metadata": {
"metatitle": {
"pl": "MacBook Air 13 gwiezdna szarość",
"en": "MacBook Air 13 Space Gray",
"de": "MacBook Air 13 Space Grua"
},
"keywords": {
"pl": "MacBook,Air,13,gwiezdna szarość",
"en": "MacBook,Air,13,Space Gray",
"de": "MacBook,Air,13,Space Grua"
},
"metadescription": {
"pl": "MacBook Air 13 gwiezdna szarość - najlepsza cena",
"en": "MacBook Air 13 Space Gray - Best Price",
"de": "MacBook Air 13 Space Grua - bester Preis"
},
"slug": {
"pl": "MacBook_Air_13_gwiezdna_szarosc",
"en": "MacBook_Air_13_Space_Gray",
"de": "MacBook_Air_13_Space_Grua"
}
},
"categories": {
"categories_increase": 1,
"paths": [
{
"pl": "Laptopy/Apple/MacBook Air 13",
"en": "Laptops/Apple/MacBook Air 13",
"de": "Laptops/Apple/MacBook Air 13"
},
{
"pl": "Apple/Laptopy/MacBook Air 13",
"en": "Apple/Laptops/MacBook Air 13",
"de": "Apple/Laptops/MacBook Air 13"
}
]
},
"price":{
"base_netto": "4000.00",
"purchase_netto": "3300.99",
"srp_netto": "4499.99",
"vat": "23"
},
"manufacturer": {
"name": "Apple",
"logo": "https://www.apple.com/logo.png"
},
"energy_class": {
"energy_class": "A",
"energy_label_link": "https://link_to_energy_class_label.pdf",
"energy_card_information_link": "https://link_to_energy_card_information_link.pdf"
},
"stock": {
"unit": "pcs.",
"stock_enabled": "1",
"minimum_purchase_quantity": "3",
"delivery_date": [
{
"delivery_format": {"pl": "7 dni", "en": "7 days", "de": "7 Tage"},
"delivery_hour": "168",
"warehouse_external_id": 1
},
{
"delivery_format": {"pl": "7 dni", "en": "7 days", "de": "7 Tage"},
"delivery_hour": "168",
"warehouse_external_id": 2
}
]
},
"package": {
"name": "Euro-pallet",
"dimensions": {
"height": "100.00",
"width": "100.00",
"length": "100.00",
"weight": "10.00"
}
},
"collective_packages": {
"is_active": 1,
"is_only_packages": "0",
"package_size": "12",
"price": {
"discount": "10",
"is_includes_the_charge": 0
}
},
"attributes": {
"attributes_increase": 1,
"attribute_group_filter_enabled": 1,
"attributes": {
"pl": [
{
"Dane techniczne": [
["Kolor", "czerwony"],
["Rozmiar", "średni"]
]
},
{
"Dane dodatkowe" : [
["Produkt wyprodukowany w UE", "tak"]
]
}
],
"en": [
{
"Technical data": [
["Color", "red"],
["Size", "medium"]
]
},
{
"Additional data" : [
["Product manufactured in the EU", "yes"]
]
}
]
}
},
"multimedia": {
"photos": {
"photos_increase": 1,
"photos": [
"https://example.com/photo1.jpg",
"https://example.com/photo2.jpg",
"https://example.com/photo3.jpg"
]
},
"files": {
"files_increase": 1,
"files": [
["file1.pdf","https://example.com/file1.pdf"],
["file2.pdf","https://example.com/file2.pdf"],
["file3.pdf","https://example.com/file3.pdf"]
]
}
}
}
]Aktualizacja definicji rodziny produktów
family
family_id*
JSON
description: "Unique identifier code of product family for the Saly",
example: "IMPORT-RODZIN-1",
type: "X (255) *"col1 - col15
JSON
description: "Definition of the distinguishing feature in different languages (available languages: pl, en, de, ru, es, fr, it)",
example: {
"pl": "Kolor",
"en": "Color",
"de": "Farbe"
},
type: "JSON" information
name
JSON
description: "Name identify product in different languages (available languages: pl, en, de, ru, es, fr, it). Data format must be preserved from the example,
example: {
"pl": "MacBook Air 13 gwiezdna szarość",
"en": "MacBook Air 13 Space Gray",
"de": "MacBook Air 13 Space Grua"
},
type: "JSON"description
JSON
description: "Description identify product in different languages (available languages: pl, en, de, ru, es, fr, it). Data format must be preserved from the example,
example: {
"pl": "<h4>MacBook Air 13 gwiezdna szarość</h4><p>przykładowy tekst</p>",
"en": "<h4>MacBook Air 13 Space Gray</h4><p>example text</p>",
"de": "<h4>MacBook Air 13 Space Grua</h4><p>Beispieltext</p>"
},
type: "JSON"is_active
JSON
description: "whether the product is published on frontOffice (available values: 0 - unpublished (default option), 1 - published)",
example: "1",
type: "[0-1] (1)"is_promoted
JSON
description: "whether the product is promoted on frontOffice (available values: 0 - unpromoted (default option), 1 - promoted)",
example: "0",
type: "[0-1] (1)"metadata
metatitle
JSON
description: "SEO data - Metatitle identify product in different languages (available languages: pl, en, de, ru, es, fr, it). Data format must be preserved from the example,
example: {
"pl": "MacBook Air 13 gwiezdna szarość",
"en": "MacBook Air 13 Space Gray",
"de": "MacBook Air 13 Space Grua"
},
type: "JSON"keywords
JSON
description: "SEO data - Keywords identify product in different languages (available languages: pl, en, de, ru, es, fr, it). Data format must be preserved from the example,
example: {
"pl": "MacBook,Air,13,gwiezdna szarość",
"en": "MacBook,Air,13,Space Gray",
"de": "MacBook,Air,13,Space Grua"
},
type: "JSON"metadescription
JSON
description: "SEO data - metadescription identify product in different languages (available languages: pl, en, de, ru, es, fr, it). Data format must be preserved from the example,
example: {
"pl": "MacBook Air 13 gwiezdna szarość - najlepsza cena",
"en": "MacBook Air 13 Space Gray - Best Price",
"de": "MacBook Air 13 Space Grua - bester Preis"
},
type: "JSON"slug
JSON
description: "Name used to friendly URL (english example: https://domain/en,productView,MacBook_Air_13_Space_Gray,8,42161.html. Data format must be preserved from the example,
example: {
"pl": "MacBook_Air_13_gwiezdna_szarosc",
"en": "MacBook_Air_13_Space_Gray",
"de": "MacBook_Air_13_Space_Grua"
},
type: "JSON"categories
categories_increase
JSON
description: "Information that categories should be added if value is 1 or should be replace when value is 0"
example: "1",
type: "[0-1] (1)"paths
JSON
description: "All categories in which the product exists. The first category will be the main category. Enter the full path of the category, where '/' is used as a separator (available languages: pl, en, de, ru, es, fr, it). Data format must be preserved from the example,
example: [
{
"pl": "Laptopy/Apple/MacBook Air 13",
"en": "Laptops/Apple/MacBook Air 13",
"de": "Laptops/Apple/MacBook Air 13"
},
{
"pl": "Apple/Laptopy/MacBook Air 13",
"en": "Apple/Laptops/MacBook Air 13",
"de": "Apple/Laptops/MacBook Air 13"
}
],
type: "JSON"manufacturer
name
JSON
description: "The name of the manufacturer of the specified product",
example: "Apple",
type: "X (45)"logo
JSON
description: "Url, where the logo of a particular manufacturer is located",
example: "https://www.apple.com/logo.png",
type: "X (255)"collective_packages
is_active
JSON
description: "whether the product is available for purchase in collective packages (available values: 0 - not available for purchase in collective packages (default option), 1 - available for purchase in collective packages)",
example: "0",
type: "[0-1] (1)"is_only_packages
JSON
description: "whether the product is available for purchase only in collective packages (available values: 0 - available not only in collective packages (default option), 1 - available only in collective packages)",
example: "0",
type: "[0-1] (1)"price
discount
JSON
description: "Percentage price modification",
example: "10",
type: "[0-9]"is_includes_the_charge
JSON
description: "Wether the discount be added to the price first? (available values: 0 - standard price minus discount for clients used collective packages, standard price for clients not used collective packages (default option), 1 - standard price for clients used collective packages, standard price plus discount for clients not used collective packages)",
example: "0",
type: "[0-1] (1)"attributes
attributes_increase
JSON
description: "Information that attributes should be added if value is 1 or should be replace when value is 0"
example: "1",
type: "[0-1] (1)"attribute_group_filter_enabled
JSON
description: "When the value is equal to 1, attributes should be added or replaced exclusively within the provided attribute group.
example: "1",
type: "[0-1] (1)"attributes
JSON
description: "Product technical parameters arranged in groups and in the target order in which they are to be displayed on FrontOffice. These parameters can be in different languages (available languages: pl, en, de, ru, es, fr, it). Data format must be preserved from the example,
example: {
"pl": [
{
"Dane techniczne": [
["Kolor", "czerwony"],
["Rozmiar", "średni"]
]
},
{
"Dane dodatkowe" : [
["Produkt wyprodukowany w UE", "tak"]
]
}
],
"en": [
{
"Technical data": [
["Color", "red"],
["Size", "medium"]
]
},
{
"Additional data" : [
["Product manufactured in the EU", "yes"]
]
}
]
},
type: "JSON"multimedia
photos
photos_increase
JSON
description: "Information that photos should be added if value is 1 or should be replace when value is 0"
example: "1",
type: "[0-1] (1)"photos
JSON
description: "Urls, where the photos of a particular product is located. The number of this urls is not limited. Data format must be preserved from the example,
example: [
"https://example.com/photo1.jpg",
"https://example.com/photo2.jpg",
"https://example.com/photo3.jpg"
],
type: "JSON"files
files_increase
JSON
description: "Information that files should be added if value is 1 or should be replace when value is 0"
example: "1",
type: "[0-1] (1)"files
JSON
description: "Urls, where the files of a particular product is located, with they name representation. The number of this urls is not limited. Data format must be preserved from the example,
example: [
["file1.pdf","https://example.com/file1.pdf"],
["file2.pdf","https://example.com/file2.pdf"],
["file3.pdf","https://example.com/file3.pdf"]
],
type: "JSON"Przykładowy plik definicji rodziny
JSON
[
{
"family": {
"family_id": "IMPORT-RODZIN-1",
"col1": {
"pl": "Kolor",
"en": "Color",
"de": "Farbe"
},
"col2": {
"pl": "Materiał",
"en": "Material",
"de": "Kunststoff"
},
"col3": {
"pl": "Rozmiar",
"en": "Size",
"de": "Größe"
}
},
"information": {
"name": {
"pl": "MacBook Air 13 gwiezdna szarość",
"en": "MacBook Air 13 Space Gray",
"de": "MacBook Air 13 Space Grua"
},
"description": {
"pl": "<h4>MacBook Air 13 gwiezdna szarość</h4><p>przykładowy tekst</p>",
"en": "<h4>MacBook Air 13 Space Gray</h4><p>example text</p>",
"de": "<h4>MacBook Air 13 Space Grua</h4><p>Beispieltext</p>"
},
"is_active": "1",
"is_promoted": "0"
},
"metadata": {
"metatitle": {
"pl": "MacBook Air 13 gwiezdna szarość",
"en": "MacBook Air 13 Space Gray",
"de": "MacBook Air 13 Space Grua"
},
"keywords": {
"pl": "MacBook,Air,13,gwiezdna szarość",
"en": "MacBook,Air,13,Space Gray",
"de": "MacBook,Air,13,Space Grua"
},
"metadescription": {
"pl": "MacBook Air 13 gwiezdna szarość - najlepsza cena",
"en": "MacBook Air 13 Space Gray - Best Price",
"de": "MacBook Air 13 Space Grua - bester Preis"
},
"slug": {
"pl": "MacBook_Air_13_gwiezdna_szarosc",
"en": "MacBook_Air_13_Space_Gray",
"de": "MacBook_Air_13_Space_Grua"
}
},
"categories": {
"categories_increase": 1,
"paths": [
{
"pl": "Laptopy/Apple/MacBook Air 13",
"en": "Laptops/Apple/MacBook Air 13",
"de": "Laptops/Apple/MacBook Air 13"
},
{
"pl": "Apple/Laptopy/MacBook Air 13",
"en": "Apple/Laptops/MacBook Air 13",
"de": "Apple/Laptops/MacBook Air 13"
}
]
},
"manufacturer": {
"name": "Apple",
"logo": "https://www.apple.com/logo.png"
},
"collective_packages": {
"is_active": "0",
"is_only_packages": "0",
"price": {
"discount": "10",
"is_includes_the_charge": "0"
}
},
"attributes": {
"attributes_increase": 1,
"attribute_group_filter_enabled": 1,
"attributes": {
"pl": [
{
"Dane techniczne": [
["Kolor", "czerwony"],
["Rozmiar", "średni"]
]
},
{
"Dane dodatkowe" : [
["Produkt wyprodukowany w UE", "tak"]
]
}
],
"en": [
{
"Technical data": [
["Color", "red"],
["Size", "medium"]
]
},
{
"Additional data" : [
["Product manufactured in the EU", "yes"]
]
}
]
}
},
"multimedia": {
"photos": {
"photos_increase": 1,
"photos": [
"https://example.com/photo1.jpg",
"https://example.com/photo2.jpg",
"https://example.com/photo3.jpg"
]
},
"files": {
"files_increase": 1,
"files": [
["file1.pdf","https://example.com/file1.pdf"],
["file2.pdf","https://example.com/file2.pdf"],
["file3.pdf","https://example.com/file3.pdf"]
]
}
}
}
]Aktualizacja warianty rodziny
family
family_id*
JSON
description: "Unique identifier code of product family for the Saly",
example: "IMPORT-RODZIN-1",
type: "X (255) *"variant_name
JSON
description: "Name of product family variant",
example: "IMPORT-RODZIN-1-1",
type: "X (255)"variant_is_active
JSON
description: "Whether the product variant is active (available values: 0 - inactive, 1 - active(default option))",
example: "1",
type: "[0-1] (1)"variant_position
JSON
description: "Defines the position or order of the product variant within a list of variants. Lower values indicate higher priority or placement in the list (e.g., 1 for the first position, 2 for the second, etc.)",
example: "1",
type: "[0-9] (3)"col1 - col15
JSON
description: "Definition of the distinguishing feature in different languages (available languages: pl, en, de, ru, es, fr, it)",
example: {
"pl": "Kolor",
"en": "Color",
"de": "Farbe"
},
type: "JSON" code
JSON
description: "Unique identifier code of product for the Saly",
example: "5907595646406",
type: "X (255) *"additional_code
ean
JSON
description: "International Article Number - thirteen-digit number used to identify product",
example: "5907595646406",
type: "[0-9] (13)"sku
JSON
description: "Stock keeping unit - identifier code of product",
example: "Mac Book Air 13,3",
type: "X (45)"supplier_product_code
JSON
description: "Unique number issued by supplier to identify individual product",
example: "5907595646406",
type: "X (255)"price
base_netto
JSON
description: "The minimum net price for which a product can be sold",
example: "4000.00",
type: "R2"purchase_netto
JSON
description: "The net price at which the product was purchased",
example: "3300.99",
type: "R2"srp_netto
JSON
description: "Suggested retail price net for which the product can be sold",
example: "4499.99",
type: "R2"vat
JSON
description: "vat rate of the product",
example: "23",
type: "[0-9]"manufacturer
name
JSON
description: "The name of the manufacturer of the specified product",
example: "Apple",
type: "X (45)"logo
JSON
description: "Url, where the logo of a particular manufacturer is located",
example: "https://www.apple.com/logo.png",
type: "X (255)"energy_class
energy_class
JSON
description: "Energy class of a specific product",
example: "A",
type: "[A-G] (1)"energy_label_link
JSON
description: "Link to energy class label pdf of a specific product",
example: "https://link_to_energy_class_label.pdf",
type: "X (255)"energy_card_information_link
JSON
description: "Link to energy card information pdf of a specific product",
example: "https://link_to_energy_card_information_link.pdf",
type: "X (255)"stock
unit
JSON
description: "The name of the sales unit of a specific product",
example: "pcs.",
type: "X (55)"stock_enabled
JSON
description: "Information whether the product affects the stock. Such as service.",
example: "pcs.",
type: "X (55)"minimum_purchase_quantity
JSON
description: "The minimum quantity of the basic sales unit required to place an order for this product.",
example: "3",
type: "[0-9]"delivery_date
delivery_format
JSON
description: "Delivery time for this product. This information is saved to any existing warehouse. If this information is empty, the information is propagated from the warehouse.",
example: {"pl": "7 dni", "en": "7 days", "de": "7 Tage"},
type: "JSON"delivery_hour
JSON
description: "Delivery time of this product, given in hours",
example: "168",
type: "[0-9]"warehouse_external_id
JSON
description: "External id of the warehouse to which the delivery data relates,
example: "1",
type: "[0-9]"package
name
JSON
description: "The name of the package previously defined in the system in which the product should be transported",
example: "Euro-pallet",
type: "X (255)"dimensions
height
JSON
description: "The packaging height of a given product in centimeters",
example: "100.00",
type: "R2"width
JSON
description: "The packaging width of a given product in centimeters",
example: "100.00",
type: "R2"length
JSON
description: "The packaging length of a given product in centimeters",
example: "100.00",
type: "R2"weight
JSON
description: "The packaging weight of a given product in kilograms",
example: "10.00",
type: "R2"collective_packages
package_size
JSON
description: "how many products are in collective packages",
example: "12",
type: "[0-9]”Przykładowy plik wariantu rodziny
JSON
[
{
"family": {
"family_id": "IMPORT-RODZIN-1",
"variant_name": "IMPORT-RODZIN-1-1",
"variant_is_active": "1",
"variant_position": "1",
"col1": {
"pl": "Czarny",
"en": "Black",
"de": "Schwarz"
},
"col2": {
"pl": "Materiał",
"en": "Material",
"de": "Kunststoff"
},
"col3": {
"pl": "Rozmiar",
"en": "Size",
"de": "Größe"
}
},
"information": {
"name": {
"pl": "MacBook Air 13 gwiezdna szarość",
"en": "MacBook Air 13 Space Gray",
"de": "MacBook Air 13 Space Grua"
},
"description": {
"pl": "<h4>MacBook Air 13 gwiezdna szarość</h4><p>przykładowy tekst</p>",
"en": "<h4>MacBook Air 13 Space Gray</h4><p>example text</p>",
"de": "<h4>MacBook Air 13 Space Grua</h4><p>Beispieltext</p>"
}
},
"code": "5907595646406",
"additional_code": {
"ean": "5907595646406",
"sku": "Mac Book Air 13,3",
"supplier_product_code": "5907595646406"
},
"price":{
"base_netto": "4000.00",
"purchase_netto": "3300.99",
"srp_netto": "4499.99",
"vat": "23"
},
"manufacturer": {
"name": "Apple",
"logo": "https://www.apple.com/logo.png"
},
"collective_packages": {
"package_size": "12"
},
"energy_class": {
"energy_class": "A",
"energy_label_link": "https://link_to_energy_class_label.pdf",
"energy_card_information_link": "https://link_to_energy_card_information_link.pdf"
},
"stock": {
"unit": "pcs.",
"stock_enabled": "1",
"minimum_purchase_quantity": "3",
"delivery_date": [
{
"delivery_format": {"pl": "7 dni", "en": "7 days", "de": "7 Tage"},
"delivery_hour": "168",
"warehouse_external_id": 1
},
{
"delivery_format": {"pl": "7 dni", "en": "7 days", "de": "7 Tage"},
"delivery_hour": "168",
"warehouse_external_id": 2
}
]
},
"package": {
"name": "Euro-pallet",
"dimensions": {
"height": "100.00",
"width": "100.00",
"length": "100.00",
"weight": "10.00"
}
}
}
]