Przejdź do głównej zawartości

Import z Swell.is

Wymagania​

  • Aktywne konto Swell.is
  • Store ID i Secret Key

Jak uzyskać dane dostępowe​

  1. Zaloguj się do panelu Swell
  2. Przejdź do Developer → API keys
  3. Skopiuj Store ID (widoczny w URL panelu)
  4. Utwórz nowy Secret Key lub skopiuj istniejący

Co jest importowane​

Produkty​

  • Nazwa, opis, krótki opis (summary), cena, cena promocyjna, koszt zakupu
  • SKU i stan magazynowy
  • Slug produktu (URL z Swell)
  • Waga (z shipment_weight, w gramach)
  • Tagi
  • Meta title i meta description (SEO)
  • Typ produktu: standardowy → PHYSICAL, subskrypcja → SUBSCRIPTION, karta podarunkowa → GIFT_CARD
  • Warianty z opcjami
  • Obrazy produktów
  • Kategoria (pierwsza przypisana)
  • Atrybuty produktów z wartościami
Produkty typu bundle

Produkty typu bundle nie są importowane - DoSwiftly nie obsługuje obecnie bundli.

Atrybuty​

  • Definicje atrybutów automatycznie synchronizowane z endpoint /attributes (jedyna platforma z pełnym pre-sync)
  • Opcje (values) dla typów SELECT, CHECKBOX, RADIO
  • Synchronizowane przed produktami - import produktów referencjonuje gotowe definicje
  • Zaznacz "Atrybuty" w selektorze encji, aby zsynchronizować definicje

Kategorie​

  • Pełna hierarchia kategorii (z relacjami parent/child)
  • Nazwy, slugi, opisy
  • Obrazy kategorii

Klienci​

  • Email, imię i nazwisko
  • Numer telefonu
  • Typ klienta (osoba fizyczna / firma) - na podstawie pola type w Swell
  • Numer VAT (dla klientów firmowych)
  • Zgody marketingowe (email) - na podstawie zgody email_optin w Swell
  • Język, notatki
  • Adresy dostawy i rozliczeniowy

Zamówienia​

  • Numer zamówienia, email klienta
  • Status zamówienia, płatności i realizacji
  • Pozycje zamówienia z cenami
  • Adresy dostawy i rozliczeniowy
  • Metoda płatności i wysyłki
  • Dane podatkowe (stawki, strefy) - automatycznie wykrywane z historii zamówień (patrz niżej)

Kody rabatowe (kupony)​

  • Kod i nazwa
  • Typ (procentowy, kwotowy)
  • Limity użycia i aktualne zużycie
  • Daty ważności

Krok po kroku​

  1. W panelu DoSwiftly przejdź do Ustawienia → Import danych
  2. Kliknij Nowy import i wybierz Swell
  3. Wprowadź Store ID i Secret Key
  4. Kliknij Testuj połączenie
  5. Wybierz dane do importu - zobaczysz liczbę rekordów w źródle
  6. Potwierdź i rozpocznij import

Automatyczna konfiguracja podatkowa​

Po zakończeniu importu zamówień system automatycznie tworzy podstawową konfigurację podatkową na podstawie danych podatkowych z historii zamówień Swell:

  • Tworzona jest klasa podatkowa „Standard" (domyślna) - jeśli jeszcze nie istnieje
  • Dla każdej wykrytej stawki podatkowej tworzona jest strefa podatkowa (np. „Polska 23%")
  • Stawki podatkowe łączone są z klasą domyślną

Mechanizm uruchamia się tylko wtedy, gdy w sklepie nie ma jeszcze żadnych stawek podatkowych - nie nadpisuje istniejącej konfiguracji.

Co dzieje się przy cofnięciu importu?

Jeśli cofniesz import, automatycznie stworzone klasy, strefy i stawki podatkowe zostaną usunięte - z wyjątkiem tych, które były już używane przez produkty lub zostały uzupełnione przez Ciebie ręcznie. W takim przypadku system je zachowa i wyświetli informację w raporcie cofnięcia.

Ograniczenia​

  • Maksymalnie 1000 rekordów na stronę przy pobieraniu danych
  • Ceny są konwertowane z waluty sklepu Swell do groszy
  • Zamówienia importowane są jako historyczne (read-only) z prefiksem IMP-
  • Opinie o produktach nie są importowane (Swell nie posiada publicznego API opinii)
  • Archiwalne/usunięte produkty (archived=true w Swell) są pomijane - po imporcie nie znajdziesz ich w sklepie
  • Nazwa oraz pola SEO dłuższe niż mieści sklep (255 znaków nazwa i meta tytuł, 500 meta opis) są przycinane, a nie pomijane - produkt importuje się w całości

Co dzieje się z produktami konfigurowalnymi​

Po imporcie każdy produkt jest poprawnie umieszczony w sklepie, ale zaawansowane opcje konfiguratora (dopłaty za warianty, powiązanie opcji atrybutu z konkretnym produktem składowym) wymagają manualnej konfiguracji w DoSwiftly. Dzieje się tak dlatego, że Swell nie udostępnia tych danych w swoim API w sposób jednoznaczny.

Co wypełniamy automatycznie:

  • Widoczność (PUBLIC / HIDDEN / BUNDLE_ONLY) jest ustawiana jednoznacznie na podstawie stanu w Swell - aktywne produkty są publiczne, nieaktywne ukryte, a produkty typu bundle dostają specjalny status BUNDLE_ONLY (niewidoczne w katalogu, dostępne jako komponenty innych produktów).
  • Zestaw atrybutów (template konfiguratora) - jeśli w oknie startu importu wybierzesz zestaw, wszystkie zaimportowane produkty zostaną do niego przypisane od razu.
  • Pola atrybutów (material, kolor, wymiary itp.) są tworzone jako pola wypełniane przez merchanta (fillingMode=MERCHANT) bez dopłat. Możesz je później zmienić na pola wypełniane przez klienta w koszyku.

Co wymaga konfiguracji po imporcie:

  • Dopłaty za opcje (surchargeAmount) - Swell nie udostępnia cen per-wartość opcji, więc wszystkie opcje są importowane jako darmowe. Ustaw dopłaty w zakładce Atrybuty → Edytuj opcje.
  • Powiązanie opcji z wariantem (linkedVariantId) - aby opcja atrybutu zużywała stan konkretnego wariantu, musisz utworzyć to powiązanie ręcznie w Konfigurator → Nadpisania opcji.
  • Komponenty bundle - produkty bundle są importowane ze statusem BUNDLE_ONLY, ale połączenia z komponentami (ich warianty, ceny) nie są jeszcze rozwiązywane automatycznie. Kolejna aktualizacja importera to zrobi; do tego czasu skonfiguruj bundle ręcznie.