Príklad, čo robiť [badge:Úplný príklad|info]

Krok 1 – Nasmerujte používateľa na entitu [navigate:/products|Otvoriť produkty|shopping-cart]

Otvorte sekciu produktov: [navigate:/products|Produkty]

Pridať nový produkt: [navigate:/products/new|Nové produkty]

Prejdite na obrazovku importu: [navigate:../api/imports.md|Importy|upload]

Prejdite na Mapovač: [navigate:/mapper|Mapovač|mapper]

Pridať produkt: [navigate:/products/new|Pridať produkt|plus]

Krok 2 – Použiť filter

Filtrovať všetky viditeľné produkty NIKE:

brand_id = 'code:NIKE' and visibility in ('visible')

Krok 3 – (Voliteľné) Hromadná aktualizácia filtrovanej sady

Pred exportom môžete hromadne priradiť exportný kanál všetkým zodpovedajúcim produktom:

{
  "export_channel": "eshop-de"
}

Krok 4 – (Voliteľné) Použite AI na obohatenie popisov pred exportom

{
  "prompt": "Write a short product description suitable for the German market.",
  "fields": ["description_de"]
}

Krok 5 – Spustite dotaz na kontrolu dát

{
  "fields": ["code", "name", "price", "visibility"],
  "where": "visibility = 'visible'",
  "limit": 10
}

Krok 5b – Blok jednoduchého dotazu (bez entity, iba kopírovateľné zobrazenie)

products(where: "visibility = 'visible'", limit: 10) {
    id
    code
    name
    price
}

Krok 6 – Import produktov z CSV

{
  "columns": {
    "code": "PRODUCT_CODE",
    "name": "PRODUCT_NAME",
    "price": "PRICE_EUR"
  },
  "matchBy": "code"
}

Krok 6b – Blok jednoduchého importu (bez entity, iba kopírovateľné zobrazenie)

{
  "columns": {
    "code": "PRODUCT_CODE",
    "name": "PRODUCT_NAME"
  },
  "matchBy": "code"
}

Krok 7 – Mapovanie dát feedu na produkty pomocou Mapovača

products = '$.items[*]' {
  code = 'CODE',
  name = 'NAME',
  price = 'PRICE'
}

Krok 7b – Blok jednoduchého mapovača (bez entity, iba kopírovateľné zobrazenie)

products = '$.items[*]' {
  code = 'CODE',
  name = 'NAME'
}

Krok 8 – Vytvorte export s týmto filtrom

Prejdite na konfiguráciu exportu: [navigate:/exports/new|Konfigurácia exportu]

Použite tam rovnaký výraz filtra:

brand_id = 'code:NIKE' and visibility in ('visible')

Krok 8b – Blok jednoduchého filtra (bez entity, iba na čítanie)

brand_id = 'code:NIKE' and visibility in ('visible')

Zástupné symboly

Telo článku môže odkazovať na hodnoty za behu pomocou zástupných symbolov.

Odošlite dotaz na koncový bod API pre spoločnosť {companyId}:

POST {HOSTNAME}/api/query
Authorization: Bearer <token>
X-Company-Id: {companyId}

Zástupný symbol {HOSTNAME} sa prekladá na aktuálny pôvod aplikácie (napr. {HOSTNAME}). Zástupný symbol {companyId} sa prekladá na ID aktuálnej organizácie.

Vložené úseky kódu

Použite pole visibility na kontrolu dostupnosti produktu. Nastavte ho na visible, hidden alebo catalog. Cesta koncového bodu je /api/v1/products a metóda je GET.

Bloky s upozorneniami

Toto je **informačný** blok s upozornením. Použite ho pre tipy, poznámky a neutrálny kontext.

**Upozornenie:** Zmena poľa `matchBy` po prvom importe spôsobí duplikáty.

**Tip:** Viacero filtrov môžete kombinovať pomocou operátorov `and` / `or`.

**Nebezpečenstvo:** Vymazanie mapovania feedu je nezvratné. Uistite sa, že máte zálohu.

Tabuľky GFM pipe

Viacjazyčné záložky kódu

tab: JSON
{
  "code": "PROD-001",
  "name": "Running Shoes",
  "price": 99.90
}
---
tab: XML
<product>
  <code>PROD-001</code>
  <name>Running Shoes</name>
  <price>99.90</price>
</product>
---
tab: CSV
code,name,price
PROD-001,Running Shoes,99.90

Číslované kroky

1. Otvorte **Produkty** v ľavej navigácii.
2. Kliknite na **Filtre** a pridajte `visibility = 'visible'`.
3. Vyberte všetky zodpovedajúce produkty pomocou zaškrtávacieho políčka.
4. Z ponuky akcií vyberte **Hromadná aktualizácia**.
5. Nastavte `export_channel` a potvrďte.

Karty mriežky funkcií

card: Synchronizácia v reálnom čase
icon: refresh-cw
Automaticky synchronizujte produktové dáta medzi vaším ERP a všetkými pripojenými kanálmi.

card: Flexibilné mapovanie
icon: workflow
Mapujte akékoľvek zdrojové pole na akékoľvek cieľové pole pomocou vizuálneho editora Mapovača.

card: Inteligentné filtrovanie
icon: filter
Použite výkonné výrazy WHERE na zacielenie presne na produkty, ktoré potrebujete.

Tlačidlo CTA „Vyskúšajte to“

Importujte svoje prvé produkty teraz: [try:/imports/new|Spustiť sprievodcu importom|upload]

Vložené odznaky

Pole visibility akceptuje tri hodnoty: [badge:viditeľné|success] [badge:skryté|warning] [badge:katalóg|info]

Táto funkcia je [badge:Beta|warning] a API je [badge:Stabilné|success].

Súvisiace články

• [navigate:/help/en/user-flows/product-catalog-sync|Synchronizácia katalógu produktov|refresh-ccw]
• [navigate:/help/en/user-flows/ai-chat-sessions|Rozhovor AI – relácie a výzvy|bot]
• [navigate:/help/en/api/imports|Dokumentácia importného systému|upload]
• [navigate:/help/en/keyboard-shortcuts|Klávesové skratky|keyboard]