Přeskočit na hlavní obsah

Hromadné úpravy produktů pomocí CSV souboru

Potřebujete některé produkty upravit ručně, ale nechce se Vám je upravovat jeden po druhém? Využijte možnost hromadných úprav pomocí CSV souboru!

Jak má CSV vypadat

V CSV souboru musí být použitý jako oddělovač sloupečků středník. Seznam možných sloupečků:

Název sloupce

Význam

Příklad

productId

Interní unikátní identifikátor produktu (UUID)

code

Kód produktu (volitelný, manuálně přidělený)

externalId

Externí identifikátor varianty – typicky kombinace čísla modelu, barvy a velikosti

status

Stav produktu v systému (schválení / viditelnost)

approved, rejected, pending

pairCode

Kód pro párování variant – všechny varianty jednoho produktu sdílejí stejný kód

supplier

Název dodavatele

title

Plný název produktu včetně variantních údajů (barva, velikost apod.)

manufacturer

Název výrobce

ean

Čárový kód produktu (EAN-13)

price.amount

Prodejní cena bez/s DPH (dle nastavení feedu)

2550

price.currency

Měna prodejní ceny (ISO 4217)

CZK, EUR

sellingTaxRate

Sazba DPH v procentech

21

purchasePrice.amount

Nákupní cena (od dodavatele)

199

purchasePrice.currency

Měna nákupní ceny

CZK, EUR

commonPrice.amount

Běžná / doporučená maloobchodní cena

299

commonPrice.currency

Měna běžné ceny

CZK, EUR

perex

Krátký popis produktu (anotace)

description

Podrobný popis produktu (může obsahovat HTML)

weight

Hmotnost produktu (typicky v kg)

1.85, 0.24

url

URL adresa produktu na zdrojovém e-shopu

categories.path 1...X

Stromová cesta kategorie (oddělovač >)

Kategorie > Podkategorie > Podkategorie

categories.code 1...X

Kód kategorie

images.url 1...X

URL obrázku produktu

images.alt 1...X

Alternativní text (alt) obrázku

(prázdné)

variantImages.url 1...X

URL obrázku specifického pro konkrétní variantu

tags.title 1...X

Štítek (tag) přiřazený k produktu

parameters.title 1...X

Název parametru produktu

Velikost

parameters.values 1...X

Hodnota parametru

L

parameters.group 1...X

Skupina, do které parametr patří

default

variantParameters.title 1...X

Název parametru specifického pro variantu (odlišuje varianty mezi sebou)

Velikost

variantParameters.values 1...X

Hodnota variantního parametru

L, XL

variantParameters.group 1...X

Skupina variantního parametru

default

attachments.title 1...X

Název přílohy (PDF, dokument apod.)

attachments.url 1...X

URL přílohy ke stažení

videos.title 1...X

Název videa

videos.url 1...X

URL videa (YouTube, Vimeo apod.)

Vzorový CSV soubor

Příklad CSV souboru si můžete stáhnout zde.

Jak provést export?

Nejjednodušší způsob, jak údaje upravovat, je udělat nejprve export do CSV, soubor si otevřít v Excelu a upravená data zpátky naimportovat. Export provedete velmi jednoduše:

  1. přejděte v Napojse na Produkty > Přehled

  2. vyfiltrujte si produkty, které chcete

  3. klikněte na ... a Export

  • zvolte vlastnosti produktu, které v exportovaném souboru chcete mít. Automaticky se exportuje též element ID, což je unikátní identifikátor daného produktu/varianty určený pro jednoduchý zpětný import csv do Napojse.

  • klikněte na Exportovat. Vygenerovaný soubor si uložte do PC a otevřete v Excelu.

TIP: zvolte pro export minimum elementů, tedy jednak ty, které si přejete v exportovaném souboru upravovat, a navíc také nějaký, který Vám pomůže v orientaci, typicky název nebo kód produktu.

Jak provést import?

  • přejděte na Produkty > Přehled

  • klikněte na ... a Import

  • pokud importujete soubor, který jste předtím z Napojse exportovali, v nastavení oddělovače sloupců, párovacím elementu a kódování souboru nemusíte nic měnit

  • pokud párujete podle kódu produktu a chcete upravit pouze produkt vybraného dodavatele (kódy mohou být pro více dodavatelů shodné), vyberte dodavatele v poli Import provést pro

  • vložte CSV

  • stiskněte tlačítko Importovat

Napojse nepodporuje import csv se sloupci, se kterými není možné uživatelsky pracovat, typicky Kód dodavatele, Obrázky a Dodavatelské kategorie. V případě importu csv obsahujícího tyto sloupce dojde k chybě a import nebude úspěšný - pokud tyto sloupce v csv máte, před importem je odstraňte.

Import nebude úspěšný také tehdy, nebude-li obsahovat sloupec s povinným identifikátorem. Je nutné, aby csv obsahovalo alespoň jeden z následujících identifikátorů, na základě kterého dochází k aktualizaci produktů v Napojse dle přiloženého souboru: ID (vygenerované při exportu), kód produktu, kód u dodavatele, či EAN.

Co se po importu stane?

Dojde k upravení vlastností u produktů s daným identifikátorem. Při importu mohou nastat tři situace:

  • sloupeček je v CSV uvedený a JE vyplněný - vlastnost produktu se přepíše a uloží se jako manuální úprava, aby ji dodavatel následným importem jeho dat zase nepřepsal

  • sloupeček je v CSV uvedený a NENÍ vyplněný - vlastnost produktu se smaže

  • sloupeček neni v CSV uvedený - vlastnost se přeskočí, na produktu se nezmění

Jak hromadně změnit kód produktu?

V CSV musí být uvedený sloupeček ID, podle kterého se budou produkty párovat. Pak stačí změnit kód produktu ve sloupci Kód

Kódování souboru

Při exportu i importu je nutné zvolit kódování, v kterém bude soubor vyexportovaný. Pro import Napojse obvykle dokáže formát rozpoznat samo. Pokud zvolíte kódovaní nesprávně, písmena s diakritikou se mohou zobrazovat "deformovaná".

  • Pro Windows je nejčastější kódování Windows 1250

  • Pro Linux/Mac UTF-8

Dostali jste odpověď na svou otázku?