Import z Magento

Wymagania

• Magento 2.x z aktywnym REST API
• Bearer Token (Integration Access Token)

Jak uzyskać Bearer Token

1. Zaloguj się do panelu Magento Admin
2. Przejdź do System → Extensions → Integrations
3. Kliknij Add New Integration
4. Ustaw nazwę (np. "DoSwiftly Import")
5. W zakładce API zaznacz:
   • Catalog > Inventory - odczyt
   • Catalog > Products - odczyt
   • Catalog > Categories - odczyt
   • Sales > Orders - odczyt
   • Marketing > Cart Price Rules - odczyt
6. Opcjonalnie zaznacz:
   • Customers - odczyt (jeśli chcesz importować klientów)
7. Zapisz i aktywuj integrację
8. Skopiuj Access Token

Co jest importowane

Produkty

• Nazwa, opis, krótki opis (z custom_attributes)
• SKU, cena, cena specjalna, koszt zakupu
• Stan magazynowy, waga
• Warianty (configurable products) z cenami, opcjami i stanami
• Atrybuty produktów (z EAV custom_attributes)
• Obrazy produktów
• Meta title, meta description (SEO)
• Kategoria domyślna

Atrybuty

• Magento nie posiada dedykowanego API atrybutów obsługiwanego przez import - automatyczna synchronizacja definicji niedostępna
• Aby importować atrybuty produktów (z EAV custom_attributes): utwórz definicje ręcznie w panelu DoSwiftly, następnie zaznacz "Atrybuty" + "Produkty" przy imporcie

Kategorie

• Hierarchia kategorii Magento
• Opis, meta title, meta description (SEO)
• Obrazy kategorii

Klienci

• Email, imię i nazwisko
• Nazwa firmy
• Adresy klientów (shipping/billing z flagami domyślnych)

Zamówienia

• Numer zamówienia (increment_id), email klienta
• Status zamówienia, płatności i realizacji
• Pozycje zamówienia (SKU, nazwa, ilość, cena)
• Adresy dostawy i rozliczeniowy
• Metoda płatności i wysyłki

Kody rabatowe (Sales Rules + Coupons)

• Kod i nazwa reguły
• Typ (procentowy, kwotowy, darmowa wysyłka)
• Limity użycia (per kupon i per klient)
• Daty ważności

Krok po kroku

1. W panelu DoSwiftly przejdź do Ustawienia → Import danych
2. Kliknij Nowy import i wybierz Magento
3. Wprowadź:
   • Store URL - adres Twojego sklepu
   • Bearer Token - token z integracji
4. Testuj połączenie i kontynuuj

Ograniczenia

• Warianty (configurable products) są pobierane w batchach - maksymalnie 200 wariantów na produkt
• Zamówienia importowane są jako historyczne (read-only) z prefiksem IMP-
• Opinie o produktach nie są importowane (Magento Review API ma ograniczony dostęp)
• Magento API może być wolniejsze - timeout ustawiony na 60s
• 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