Import produktów (Excel / CSV)

Ten artykuł opisuje wszystkie pola, które mogą zostać zaimportowane do systemu Zamawiaj24, oraz wszystkie rozpoznawane nazwy kolumn w plikach Excel (XLSX) i CSV.

Import jest odporny na różnice w zapisie nagłówków (język, wielkość liter, spacje, myślniki itp.).

SPIS TREŚCI

• Obsługiwane formaty plików
• Jak system interpretuje nazwy kolumn (ważne)
• Lista obsługiwanych pól importu
  • 1. Nazwa produktu (pole wymagane)
  • 2. Kod / symbol / SKU
  • 3. ID zewnętrzne
  • 4. Numer katalogowy
  • 5. GTIN / EAN / kod kreskowy
  • 6. Opis produktu
  • 7. Jednostka podstawowa
  • 8. Ilość w opakowaniu / kartonie
  • 9. Jednostka opakowania zbiorczego
  • 10. Cena sprzedaży
  • 11. Cena zakupu
  • 12. Stawka VAT
  • 13. Aktywność produktu
  • 14. Kategoria produktu
• Specjalne wartości
• Rekomendowany komplet kolumn (pełny)

Obsługiwane formaty plików

• XLSX (Excel)

• CSV

Wymagania techniczne:

• pierwszy wiersz musi zawierać nagłówki kolumn,

• kolejne wiersze zawierają dane produktów,

• maksymalnie 1000 wierszy na jeden import.

Jak system interpretuje nazwy kolumn (ważne)

Podczas importu:

• wielkość liter nie ma znaczenia

• spacje, myślniki, kropki i ukośniki są traktowane identycznie

• polskie znaki są automatycznie normalizowane

Oznacza to, że np.:

• Nazwa skrócona

• nazwa-skrocona

• nazwa.skrocona

• nazwa_skrocona

zostaną rozpoznane jako to samo pole.

? Nie ma potrzeby zmieniania spacji na podkreślniki w pliku.

Lista obsługiwanych pól importu

Poniżej znajduje się pełna lista pól, które system potrafi zaimportować, wraz z wszystkimi rozpoznawanymi nazwami kolumn.

1. Nazwa produktu (pole wymagane)

Pole systemowe: name

Rozpoznawane nazwy kolumn:

• name

• nazwa

• produkt

• product

• towar

• nazwa produktu

Uwagi:

• pole wymagane,

• brak nazwy powoduje ostrzeżenie przy wierszu.

2. Kod / symbol / SKU

Pole systemowe: identifier

Rozpoznawane nazwy kolumn:

• identifier

• kod

• symbol

• sku

• indeks

• nazwa skrócona

• nazwa skrótowa

• identyfikator

3. ID zewnętrzne

Pole systemowe: external_id

Rozpoznawane nazwy kolumn:

• external id

• zew id

• id zewnetrzny

• ext id

• externalid

• kod zewnetrzny

4. Numer katalogowy

Pole systemowe: catalog_number

Rozpoznawane nazwy kolumn:

• catalog number

• nr katalogowy

• numer katalogowy

• katalog

• catalog

5. GTIN / EAN / kod kreskowy

Pole systemowe: gtin

Rozpoznawane nazwy kolumn:

• gtin

• ean

• ean13

• ean 13

• ean 8

• barcode

• kod kreskowy

Uwagi techniczne:

• system usuwa wszystkie znaki poza cyframi,

• długość inna niż 8–14 cyfr powoduje ostrzeżenie (nie blokuje importu).

6. Opis produktu

Pole systemowe: description

Rozpoznawane nazwy kolumn:

• description

• opis

• desc

7. Jednostka podstawowa

Pole systemowe: unit_name

Rozpoznawane nazwy kolumn:

• unit name

• jednostka

• jm

• unit

• jednostka podstawowa

8. Ilość w opakowaniu / kartonie

Pole systemowe: multipack_quantity

Rozpoznawane nazwy kolumn:

• multipack quantity

• ilosc w opak

• ilosc w opakowaniu

• ilosc w opakowaniu zbiorczym

• mp qty

• w kartonie

• karton

• ilosc w kartonie

• wielopak ilosc

9. Jednostka opakowania zbiorczego

Pole systemowe: multipack_unit_name

Rozpoznawane nazwy kolumn:

• multipack unit name

• jednostka opakowania

• opakowanie zbiorcze

• jm opak

• opakowanie

• mp unit

10. Cena sprzedaży

Pole systemowe: price

Rozpoznawane nazwy kolumn:

• price

• cena

• cena sprzedazy

• cennik detaliczny

• sales price

• net price

• cena netto

• cena 100

Obsługa danych:

• przecinek i kropka jako separator,

• automatyczne usuwanie spacji i znaków %.

11. Cena zakupu

Pole systemowe: pricepurchase

Rozpoznawane nazwy kolumn:

• pricepurchase

• cena zakupu

• purchase price

• buy price

• zakup

12. Stawka VAT

Pole systemowe: vat

Rozpoznawane nazwy kolumn:

• vat

• stawka vat

• podatek vat

• tax

• vat - procent

Przykładowe poprawne wartości:

• 23

• 23%

• 8 %

• 5

13. Aktywność produktu

Pole systemowe: is_active

Rozpoznawane nazwy kolumn:

• is active

• aktywny

• czy aktywny

• active

• enabled

Rozpoznawane wartości:

• TAK: 1, true, tak, yes, checked

• NIE: 0, false, nie, no, unchecked

Domyślnie: jeśli brak kolumny → produkt aktywny.

14. Kategoria produktu

Pole systemowe: category_name

Rozpoznawane nazwy kolumn:

• category name

• kategoria

• kategoria nazwa

• category

Specjalne wartości

Jeśli w komórce znajduje się:

• null

• -

• puste pole

…wartość zostanie potraktowana jako brak danych.

Rekomendowany komplet kolumn (pełny)

Dla pełnego importu produktów możesz użyć np.:

• Nazwa

• SKU

• EAN

• Numer katalogowy

• Jednostka

• Ilość w opakowaniu zbiorczym

• Jednostka opakowania

• Cena

• VAT

• Cena zakupu

• Kategoria

• Aktywny