Příklad, co dělat [badge:Úplný příklad|info]

Krok 1 – Nasměrujte uživatele na entitu [navigate:/products|Otevřít produkty|shopping-cart]

Otevřete sekci produktů: [navigate:/products|Produkty]

Přidat nový produkt: [navigate:/products/new|Nové produkty]

Přejděte na obrazovku importu: [navigate:../api/imports.md|Importy|upload]

Přejděte na Mapovač: [navigate:/mapper|Mapovač|mapper]

Přidat produkt: [navigate:/products/new|Přidat produkt|plus]

Krok 2 – Použijte filtr

Filtrovat všechny viditelné produkty NIKE:

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

Krok 3 – (Volitelné) Hromadná aktualizace filtrované sady

Před exportem můžete všem odpovídajícím produktům hromadně přiřadit exportní kanál:

{
  "export_channel": "eshop-de"
}

Krok 4 – (Volitelné) Použijte AI pro obohacení popisů před exportem

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

Krok 5 – Spusťte dotaz pro kontrolu dat

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

Krok 5b – Blok prostého dotazu (bez entity, pouze pro kopírování)

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

Krok 6 – Import produktů z CSV

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

Krok 6b – Blok prostého importu (bez entity, pouze pro kopírování)

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

Krok 7 – Mapování dat feedu na produkty pomocí Mapovače

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

Krok 7b – Blok prostého mapovače (bez entity, pouze pro kopírování)

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

Krok 8 – Vytvořte export s tímto filtrem

Přejděte na konfiguraci exportu: [navigate:/exports/new|Konfigurace exportu]

Použijte tam stejný výraz filtru:

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

Krok 8b – Blok prostého filtru (bez entity, pouze pro čtení)

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

Zástupné symboly

Tělo článku může odkazovat na hodnoty za běhu pomocí zástupných symbolů.

Odeslat dotaz na koncový bod API pro společnost {companyId}:

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

Zástupný symbol {HOSTNAME} se přeloží na aktuální původ aplikace (např. {HOSTNAME}). Zástupný symbol {companyId} se přeloží na ID aktuální organizace.

Vložené úseky kódu

Použijte pole visibility pro řízení dostupnosti produktu. Nastavte jej na visible, hidden nebo catalog. Cesta koncového bodu je /api/v1/products a metoda je GET.

Bloky s upozorněním

Toto je **informační** blok s upozorněním. Použijte jej pro tipy, poznámky a neutrální kontext.

**Varování:** Změna pole `matchBy` po prvním importu způsobí duplicity.

**Tip:** Více filtrů můžete kombinovat pomocí operátorů `and` / `or`.

**Nebezpečí:** Smazání mapování feedu je nevratné. Ujistěte se, že máte zálohu.

Tabulky GFM s oddělovači

Vícejazyč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. Otevřete **Produkty** v levé navigaci.
2. Klikněte na **Filtry** a přidejte `visibility = 'visible'`.
3. Vyberte všechny odpovídající produkty pomocí zaškrtávacího políčka.
4. Z nabídky akcí zvolte **Hromadná aktualizace**.
5. Nastavte `export_channel` a potvrďte.

Karty mřížky funkcí

card: Synchronizace v reálném čase
icon: refresh-cw
Automaticky synchronizujte produktová data mezi vaším ERP a všemi připojenými kanály.

card: Flexibilní mapování
icon: workflow
Mapujte libovolné zdrojové pole na libovolné cílové pole pomocí vizuálního editoru Mapovače.

card: Chytré filtrování
icon: filter
Použijte výkonné výrazy WHERE k přesnému zacílení produktů, které potřebujete.

Tlačítko CTA „Vyzkoušet“

Importujte své první produkty nyní: [try:/imports/new|Spustit průvodce importem|upload]

Vložené odznaky

Pole visibility přijímá tři hodnoty: [badge:visible|success] [badge:hidden|warning] [badge:catalog|info]

Tato funkce je [badge:Beta|warning] a API je [badge:Stabilní|success].

Související články

• [navigate:/help/en/user-flows/product-catalog-sync|Synchronizace katalogu produktů|refresh-ccw]
• [navigate:/help/en/user-flows/ai-chat-sessions|Chat relace a výzvy|bot]
• [navigate:/help/en/api/imports|Dokumentace importního systému|upload]
• [navigate:/help/en/keyboard-shortcuts|Klávesové zkratky|keyboard]