Integrator plików XML/CSV

Instrukcja importu danych

Spis treści:
Import CSV
Import XML
Aktualizacja cen i ilości wariantów za pomocą eksportu CSV
Importowanie plików PDF do produktu za pomocą ścieżki lokalnej
Importowanie plików PDF do produktu za pomocą linku
Najczęściej zadawane pytania, FAQ

Zobacz opis możliwości modułu integratora XML i CSV.

 

Więcej na temat wariantów i opcji produktów znajdziesz na tej stronie warianty i opcje produktów.

 

Import CSV

W menu IMPORTY / Integrator plików XML/CSV utwórz nowy schemat.Lista schematów
W kroku 1 wpisz własną nazwę schematu, w kroku 2 wybierz przypisanie produktów do odpowiedniego importera. Możesz dodawać importerów aby stworzyć niezależne integracje z różnymi dostawcami.

Schemat CSV

kroku 3 wybierz klucz importu jako kod importu lub kod EAN, który posłuży do parowania produktów znajdujących się w pliku importu z produktami w bazie sklepu. Według tego klucza będą te aktualizowane produkty w sklepie.

klucz, tryb i typ

Dostępne możliwość i w krokach 4 i 5 (tryb importu i typ produktów):

  • Dodawanie i aktualizacja + produkty bez wariantów: dodaje lub aktualizuje produkty bez wariantów czyli operacje wykonuje tylko na głównych produktach.
    Zastosowanie: dodanie lub aktualizacja produktów bez wariantów
  • Dodawanie i aktualizacja + dodawanie i aktualizacja wariantów: dodaje lub aktualizuje produkty główne bez wariantów, sprawdza czy wariant istnieje w sklepie, jeśli tak to aktualizuje wariant, jeśli nie to go tworzy.
    Zastosowanie: Chcemy dodać nowe produkty + utworzyć warianty
  • Dodawanie i aktualizacja + tylko aktualizacja wariantów: dodaje lub aktualizuje produkty główne bez wariantów, sprawdza czy wariant istnieje w sklepie, jeśli tak to aktualizuje wariant.
    Zastosowanie: dodanie lub aktualizacja produktów bez wariantów, tylko aktualizacja wariantów
  • Tylko dodawanie produktów + produkty bez wariantów: dodaje produkt jeśli nie istnieje, jeśli produkt istnieje pomija dodawanie.
    Zastosowanie: dodawanie tylko nowych produktów bez wariantów
  • Tylko dodawanie produktów + dodawanie i aktualizacja wariantów: dodaje produkt z wariantami jeśli nie istnieje, jeśli produkt istnieje pomija dodawanie i aktualizację wariantów.
    Zastosowanie: dodawanie tylko nowych produktów z wariantami
  • Tylko dodawanie produktów + tylko aktualizacja wariantów: kombinacja jest wykluczona z użycia.
  • Tylko aktualizacja + produkty bez wariantów: aktualizuje produkty (wg klucza importu: kod importu lub EAN) bez wariantów czyli operacje wykonuje tylko na głównych produktach.
    Zastosowanie: aktualizacja wybranych danych o produktach bez wariantów (cena, ilość, opisy, zdjęcia…)
  • Tylko aktualizacja + dodawanie i aktualizacja wariantów: aktualizuje produkty główne bez wariantów, sprawdza czy wariant istnieje w sklepie, jeśli tak to aktualizuje wariant, jeśli nie to go tworzy.
    Zastosowanie: aktualizacja produktów i tworzenie wariantów dla istniejących produktów.
  • Tylko aktualizacja + tylko aktualizacja wariantów: aktualizuje produkty główne (wg klucza importu: kod importu lub EAN) bez wariantów, sprawdza czy wariant istnieje w sklepie, jeśli tak to aktualizuje wariant.
    Zastosowanie: aktualizacja danych o produktach i danych o wariantach (ceny, ilości, VAT…).

W 6 kroku wybierz format danych: CSV lub XML (struktura dowolna, kodowanie UTF-8), a w kroku 7 typ sposób pobierania danych. Zapisz schemat w 8 kroku.Ustawienia źródła

Na liście schematów kliknij w Modyfikuj przy dodanym schemacie.

Lista schematówW kroku 9:

a) jeśli importujesz plik CSV to w sekcji Ustawienia formatu pliku wybierz odpowiedni separator komórek. Opcjonalnie zaznacz checkbox „Pierwszy wiersz zawiera nazwy kolumn” (krok 10) i zapisz zmiany (krok 11).

b) jeśli importujesz plik XML to w sekcji Ustawienia formatu pliku wybierz odpowiedni Tag produktu, w którym zawierają się dane produktów i zapisz zmiany (krok 11).

Ustawienia formatu pliku

Po poprawnym zapisie uaktywni się przycisk Następny krok. Kliknij ten przycisk.

W sekcji Dane ogólne (krok 12) domyślnie wybrane są Dane według powiązania oznacza to że w sekcji Powiązywanie pól należy przypisać te dane do odpowiednich danych z pliku (krok 13).

Dane ogólne
Wybierając inną opcję niż Dane według powiązania  zastosujesz wspólne wartości do wszystkich importowanych pozycji. Jeżeli wybierzesz np. opcję Stawka vat  to importer zastosuje ją dla wszystkich importowany produktów.

Stawka VAT

W sekcji Powiązywanie pól (krok 13) parujemy kolumnę Przykładowe dane (dane z pliku) z kolumną Powiązanie (pola w bazie sklepu).

Powiązywanie pól
Tak wygląda przykładowe parowanie danych:

Powiązane pola

W przedostatnim kroku 14 kliknij Zapisz i importuj Zapisz i importuj

W kroku 15 zostanie zaimportowany produkt kliknij Uruchom import.Uruchom import

 

 

Import XML

Import XML od CSV dzieli ledwie mały krok bo w sekcji Ustawienia formatu pliku dla Tag produktu wybieramy właściwy tag z danymi do importu oraz właściwy format czyli XML jak na obrazku poniżej

Import XML

Parujemy wymagane dane z kolumny Przykładowe dane i kolumny Powiązanie, a poniżej przykład powiązanych pól.

Import XML pozwiązywanie pól

 

Aktualizacja cen i ilości wariantów za pomocą eksportu CSV

W menu IMPORTY /  Eksport produktów do CSV utwórz nowy schemat np.
Po wybraniu pól związanych z wariantami pojawią się w eksporcie tylko te produkty, które mają warianty.

Schemat eksportu wariantów

Nanieś zmiany w kolumnach B i C.
Kolumny Wariant: Nazwa oraz Nazwa produktu były wyeksportowane tylko do odczytu.

Schemat eksportu wariantów

Dodaj nowy schemat w integratorze za pomocą Klucz importu -> ID Wariantu

Schemat importu wariantów

Wykonaj powiązanie aby zaktualizować ceny oraz ilość wariantów wg klucza Wariant:ID, a kolumny c_3 i c_4 nie są importowane.

Schemat importu wariantów

Importowanie plików PDF

1) Importowanie plików PDF do produktu za pomocą ścieżki lokalnej.

Za pomocą klienta FTP prześlij pliki do /products_files lub w menu NARZĘDZIA / Menadżer plików dodaj pliki PDF.

Importowanie PDF

W kolumnie A znajduje się kod importu za pomocą którego są parowane dane z pliku CSV do produktów w sklepie, na przykładzie poniżej nie używamy prefixu (symbolu importera) kodu importu gdyż aktualizowany produkt go nie posiada.

Kod importu

W kolumnie B znajdują się pliki pdf wcześniej wgrane do /products_files, a w kolumnach C i D przykłady ścieżek do innego katalogu np. products_files/plik.
Możesz zastosować różne typy ścieżek np. pdf1.pdf, plik/pdf3.pdf
Nie importuj jednocześnie plików ze ścieżek lokalnych i linków

Importowanie PDF - CSV

Konfiguracja schematu integratora

Konfiguracja schematu

W kolejnym kroku wykonaj pozwiązywanie pól.

powiązywanie pól

Dla c_1 w ustawienia pola

powiązywanie pól

Zapisz i importuj.
W edycji produktu wybierz więcej opcji i pliki do pobrania.

Pliki do pobrania

W sekcji pliki ogólnie dostępne w opisie produktu znajdziesz zaimportowane pliki PDF do produktu.

Pliki ogólne

Strona produktu po imporcie plików pdf.

Strona produktu

W kolejnym kroku wykonaj pozwiązywanie pól.

Powiązywanie pól import z linku

2) Importowanie plików PDF do produktu za pomocą linku.

Konfiguracja schematu integratora.

Schemat do importu linkiem

Podaj URL do plików oddzielając je przecinkami.
Nie importuj jednocześnie plików ze ścieżek lokalnych i linków

Link do PDF w CSV

W c_4 wybierz Ustawienie pola i wybierz Linki do pobrania

Opcje dodatkowe dla linku z PDF

Możesz podać nazwę katalogu w polu input → Wgraj pliki do podkatalogu:
Katalog zostanie założony w /products_files.
Zapisz i importuj

 

Najczęściej zadawane pytania, FAQ

Jak wyliczyć brutto z kwoty 12.1 netto, a wielkość stawki VAT dla podanej kwoty to 23% ?

Zostanie zastosowane obliczenie wg wzoru: 12.1 x 1.23 = 14.883

Czyli po imporcie zaokrąglona cena produktu to 14.88zł brutto

cena brutto

Jak obliczyć 25% procent z kwoty brutto?

Zostanie zastosowane obliczenie wg wzoru: 12.1 * 0.25 = 3.025

Czyli po imporcie zaokrąglona cena produktu to 3.03zł brutto

Import XML

 

Jak zaplanować automatyczne synchronizacje ?

W menu IMPORTY / Integrator plików XML/CSV kliknij w przycisk Zadania automatyczne

Zadania automatyczne
następnie kliknij w przycisk Dodaj schemat

Zadania automatyczne

Zgodnie z krokami na obrazku poniżej zaplanuj zadanie automatyczne.

Zadania automatyczne

Czy importując produkt mogę dodać kategorię ?

Jeśli w pliku importu znajduje się ścieżka do kategorii np. Męskie/Koszulki i zostanie prawidłowo powiązana w sekcji „Powiązywanie pól” oraz użyjesz poprawnego separatora oddzielającego kategorie to integrator utworzy kategorię i doda do niej produkty.

Jakie wartości powinien zawierać plik importu aby poprawnie importować status dostępności ?

W pliku XML/CSV możesz użyć dowolnego zestawu znaków, pamiętaj aby dokładnie zmapować wartości z plików do statusów dostępności w sklepie.