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”
date (YYYY-mm-dd) - format daty
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
stock_enabled
JSON
description: "Information whether the product affects the stock. Such as service.",
example: "pcs.",
type: "X (55)"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]"restocking_date
JSON
description: "Expected date of restock",
example: "2025-02-02",
type: "date (YYYY-mm-dd)"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"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"units
Dodanie sekcji units jest opcjonalne. Brak dodania tej sekcji nie zaktualizuje jednostek sprzedażowych
Definiując jednostki sprzedażowe w imporcie należy upewnić się, że jednostka o danym external_id została wcześniej zdefiniowana w Słownikach w panelu administratora
units_increase
JSON
description: "Information that units should be added if value is 1 or should be replaced when value is 0"
example: "1",
type: "[0-1] (1)"units
external_id
JSON
description: "Unique code identifying the sales unit. The unit must already exist and be defined in the system.",
example: "szt.",
type: "X (20)"primary_unit
JSON
description: "Specifies whether the unit is the primary unit for the product. All conversion rates are calculated relative to this unit, and stock levels are tracked in this unit.",
example: "1",
type: "[0-1] (1)"default_unit
JSON
description: "Specifies whether the unit is the default unit for the product. The default unit is automatically selected for the user when the product is displayed, but can be changed to another active unit.",
example: "1",
type: "[0-1] (1)"active
JSON
description: "Indicates whether the unit is active. Active units are visible to users and can be selected when placing an order.",
example: "1",
type: "[0-1] (1)"rate
JSON
description: "Conversion rate of this unit in relation to the product's primary unit.",
example: "10.00",
type: "R2"discount
JSON
description: "Discount percentage applied when this unit is selected.",
example: "10",
type: "[0-9]"minimum_sales_quantity
JSON
description: "Minimum number of items that must be ordered when using this unit.",
example: "1",
type: "[0-9]"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": {
"stock_enabled": "1",
"delivery_date": [
{
"delivery_format": {"pl": "7 dni", "en": "7 days", "de": "7 Tage"},
"delivery_hour": "168",
"warehouse_external_id": 1,
"restocking_date": "2025-02-02"
},
{
"delivery_format": {"pl": "7 dni", "en": "7 days", "de": "7 Tage"},
"delivery_hour": "168",
"warehouse_external_id": 2,
"restocking_date": "2025-02-02"
}
]
},
"package": {
"name": "Euro-pallet",
"dimensions": {
"height": "100.00",
"width": "100.00",
"length": "100.00",
"weight": "10.00"
}
},
"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"]
]
}
},
"units": {
"units_increase": 1,
"units": [
{
"external_id": "szt.",
"primary_unit": "1",
"default_unit": "1",
"active": "1",
"rate": "1.0",
"discount": "0",
"minimum_sales_quantity": "1"
},
{
"external_id": "opk",
"primary_unit": "0",
"default_unit": "0",
"active": "1",
"rate": "10.0",
"discount": "10",
"minimum_sales_quantity": "1"
}
]
}
}
]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]"restocking_date
JSON
description: "Expected date of restock",
example: "2025-02-02",
type: "date (YYYY-mm-dd)"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"units
Dodanie sekcji units jest opcjonalne. Brak dodania tej sekcji nie zaktualizuje jednostek sprzedażowych
Definiując jednostki sprzedażowe w imporcie należy upewnić się, że jednostka o danym external_id została wcześniej zdefiniowana w Słownikach w panelu administratora
units_increase
JSON
description: "Information that units should be added if value is 1 or should be replaced when value is 0"
example: "1",
type: "[0-1] (1)"units
external_id
JSON
description: "Unique code identifying the sales unit. The unit must already exist and be defined in the system.",
example: "szt.",
type: "X (20)"primary_unit
JSON
description: "Specifies whether the unit is the primary unit for the product. All conversion rates are calculated relative to this unit, and stock levels are tracked in this unit.",
example: "1",
type: "[0-1] (1)"default_unit
JSON
description: "Specifies whether the unit is the default unit for the product. The default unit is automatically selected for the user when the product is displayed, but can be changed to another active unit.",
example: "1",
type: "[0-1] (1)"active
JSON
description: "Indicates whether the unit is active. Active units are visible to users and can be selected when placing an order.",
example: "1",
type: "[0-1] (1)"rate
JSON
description: "Conversion rate of this unit in relation to the product's primary unit.",
example: "10.00",
type: "R2"discount
JSON
description: "Discount percentage applied when this unit is selected.",
example: "10",
type: "[0-9]"minimum_sales_quantity
JSON
description: "Minimum number of items that must be ordered when using this unit.",
example: "1",
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"
},
"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": {
"stock_enabled": "1",
"delivery_date": [
{
"delivery_format": {"pl": "7 dni", "en": "7 days", "de": "7 Tage"},
"delivery_hour": "168",
"warehouse_external_id": 1,
"restocking_date": "2025-02-02"
},
{
"delivery_format": {"pl": "7 dni", "en": "7 days", "de": "7 Tage"},
"delivery_hour": "168",
"warehouse_external_id": 2,
"restocking_date": "2025-02-02"
}
]
},
"package": {
"name": "Euro-pallet",
"dimensions": {
"height": "100.00",
"width": "100.00",
"length": "100.00",
"weight": "10.00"
}
},
"units": {
"units_increase": 1,
"units": [
{
"external_id": "szt.",
"primary_unit": "1",
"default_unit": "1",
"active": "1",
"rate": "1.0",
"discount": "0",
"minimum_sales_quantity": "1"
},
{
"external_id": "opk",
"primary_unit": "0",
"default_unit": "0",
"active": "1",
"rate": "10.0",
"discount": "10",
"minimum_sales_quantity": "1"
}
]
}
}
]