Import products into catalogue

Function catalog/import (http://<DOMAIN>/api/catalog/import/)

Parameters:

token - authorization key obtained via the auth function
products[] - product list
- products[i].title.en - value in English (optional)
- products[i].title.ro - value in Romanian (optional)
- products[i].title - common value for all languages
- products[i].description.en - value in English (optional)
- products[i].description.ro - value in Romanian (optional)
- products[i].description - common value for all languages
- products[i].seo_title.en - value in English (optional)
- products[i].seo_title.ro - value in Romanian (optional)
- products[i].seo_title - common value for all languages
- products[i].seo_keywords.en - value in English (optional)
- products[i].seo_keywords.ro - value in Romanian (optional)
- products[i].seo_keywords - common value for all languages
- products[i].seo_description.en - value in English (optional)
- products[i].seo_description.ro - value in Romanian (optional)
- products[i].seo_description - common value for all languages
- products[i].marketplace_description - description for marketplaces
- products[i].parent_article - article of the parent product. Necessary for creating/merging variants. If the product is a parent, thid field is not necessary (or specify the value of the product article). If you update an existing item but do not specify this field, the current parent article from the database will be taken as the value If the product is new and no value is specified, the parent article will be taken from the products[i].article field
- products[i].article - product article (mandatory parameter)
- products[i].article_for_display - model article (optional). If filled in, it will be displayed on the site instead of the product article
- products[i].title - product name (mandatory parameter in case of adding a new product)
- products[i].mod_title - product variant name (optional)
  - products[i].mod_title.en - value in English (optional)
  - products[i].mod_title.ro - value in Romanian (optional)
  - products[i].mod_title - common value for all languages
- products[i].display_in_showcase - display product (true|false|1|0)
- products[i].presence - product availability. Attention: availability statuses can be transferred only if the Stock Accounting function is disabled. Available values:
  - in stock
  - out of stock
  - coming soon
  - Also any other availability statuses added to your site
- products[i].price - product price
- products[i].price_old - product old price
- products[i].discount - relative discount on the product
- products[i].short_description — short description
- products[i].color — color
- products[i].gtin — barcode (GTIN (EAN, UPC, ISBN))
- products[i].mpn — manufacturer part number (MPN)
- products[i].popularity — popularity
- products[i].guarantee_shop — warranty type
- products[i].guarantee_length — warranty period, months.
- products[i].countdown_end_time — promotion end date and time
- products[i].countdown_description — promotion text
- products[i].currency - currency of the product. Available values (by default):
  - UAH
  - USD
  - EUR
  - PLN
  - RON
  - MDL
  - Note that the currency name may be different on your site, if you have renamed it. Before importing the currency you must check the currency name in the site admin panel
- products[i].parent - path / to / section (Educational toys / Toys for babies) (mandatory parameter when adding new products)
- products[i].parent.id - catalog section identifier (used instead of products[i].parent, recommended instead of just the section path). Section identifiers can be obtained with the pages/export function
- products[i].alt_parent - array of additional sections. Each element is specified in the same way as the products[i].parent field
  - products[i].alt_parent[n] - path / to / section (Educational toys / Toys for babies)
  - products[i].alt_parent[n].id - catalog section identifier (used instead of products[i].alt_parent[n])
  - the above options for additional sections can be combined
- products[i].forceAliasUpdate - need to regenerate the product reference (boolean value, true/false)
- products[i].slug - product alias. Works only for new item, or if the parameter forceAliasUpdate == true. The alias will be inserted into the product link and converted according to the rules of forming product links
- products[i].brand - brand name
- products[i].description - product description
- products[i].adult - for adults only (Google Merchant Center)
- products[i].uktzed - “УКТ ЗЕД” (UCC FEA) code
- products[i].condition - product condition (e.g. "New", "Used", "Refurbished")
- products[i].condition.id - product condition ID (used instead of products[i].condition)
- products[i].icons - Icons (["Sale", "New", "Bestseller"]). Also other parameters with the "Multiselect" type or "Selection from list" with the mark "multi" can be passed in the same format
- products[i].seo_title - SEO title for product
- products[i].seo_keywords - SEO keywords for product
- products[i].seo_description - SEO description for product
- products[i].h1_title.en - h1 header for the product (English version)
- products[i].h1_title.ro - h1 header for the product (Romanian version)
- products[i].export_to_marketplace - enable uploading to marketplaces. Specify names of marketplaces with semicolon: "marketplace 1;marketplace2;...".
- products[i].characteristics[] - product attributes (optional)
  - products[i].characteristics.material - Material
  - products[i].characteristics.weight - Weight
  - products[i].characteristics.consist - Composition
  - products[i].characteristics.country - Country
  - products[i].characteristics.gender - Gender
  - products[i].characteristics.age - Age
  - products[i].characteristics.physics - Physical development (enter values with ;)
  - products[i].characteristics.brain - Mental development (specify values with ;)
  - products[i].characteristics.social - Social development (enter values with ;)

<aside> ℹ️ New parameters since version 3.15.15

</aside>

products[i].accessories - product accessories (array). Overwrites existing accessories
- products[i].accessories[n] - product article (string)
- products[i].accessories[n].article - direct indication of the product article
- products[i].accessories[n].page - path / to / section (Educational toys / Toys for babies)
- products[i].accessories[n].page.id - section ID
products[i].gifts - gifts for the product (array). Will only work if the site has gifts enabled. Overwrites existing gifts
products[i].residues - product stock in warehouses. Works only if the site has stock accounting enabled
products[i].images - product variant images
products[i].gallery_common - common gallery for all variants
products[i].gallery_360 - 360-degree view

<aside> ✅ New parameters since version 4.0

</aside>

For projects with wholesale functionality (example query)

products[i].price_levels - prices of different types

For all projects

products[i].multiplicity — multiplicity (step of adding to cart). Integer number.
products[i].minimal_order — minimum order. Integer, must be a multiple of the "Multiplicity" field.