Integracja z Apilo

Moduł Integracja z Apilo łączy Wirtualizera z platformą Apilo. Wysyła produkty, ceny, stany, zdjęcia, kategorie i atrybuty oraz obsługuje zamówienia w obie strony. 

Główne zalety integracji Apilo

• Jedna baza produktów — katalog, ceny i stany idą z Wirtualizera do Apilo bez ręcznego przepisywania.
• Oddzielne operacje — eksport, ceny, stany, katalog, media, kategorie i atrybuty uruchamiasz osobno, bez mieszania danych.
• Praca w tle — synchronizacja nie blokuje panelu, gdy skończona - dostajesz powiadomienie jako alert.
• Tylko to, co się zmieniło — system pomija identyczne ceny, stany, atrybuty i zdjęcia, więc Apilo nie jest przeciążane.
• Zakres pod kontrolą — zaznaczone pozycje, bieżący filtr albo cały katalog kwalifikujący się do Apilo.
• Automatyczny cron — regularny import i eksport bez wchodzenia do panelu.

Obsługiwane flow — panel

W panelu operacje Apilo uruchamiasz z list: Produkty, Kategorie i Cechy. Każde flow idzie jako zadanie w tle.

Produkty (Magazyn → Produkty → Operacje Apilo)

Wspólne możliwości zakresu: zaznaczone produkty, produkty z filtra albo wszystkie kwalifikujące się. Limit jednej operacji: do 20 000 produktów.

1. Eksport produktów do Apilo

Tworzy w Apilo karty produktów, których jeszcze tam nie ma (SKU, nazwa, VAT, status, stan, cena, opis, EAN, waga).

Możliwości:

• tworzenie tylko nowych produktów (bez nadpisywania istniejących),
• po eksporcie automatyczna kolejka synchronizacji zdjęć,
• z powiadomienia o syncu: szybkie „dodaj brakujące produkty do Apilo”.

Zalety: szybkie pierwsze podpięcie oferty; brak duplikatów dzięki mapowaniu ID; zdjęcia mogą ruszyć od razu po utworzeniu kart.

2. Synchronizacja cen w Apilo

Wysyła wyłącznie cenę brutto z cennika głównej waluty sklepu. Nie rusza nazwy, opisu ani stanu.

Możliwości:

• aktualizacja tylko produktów już powiązanych z Apilo,
• pominięcie produktów bez mapowania (w dzwonku: „wymagają eksportu”),
• brak wysyłki, gdy cena w Apilo jest już taka sama.

Zalety: częste zmiany cen bez ryzyka nadpisania katalogu; osobny, szybki kanał od stanów i opisów.

3. Synchronizacja stanów w Apilo

Aktualizuje w Apilo tylko ilość i status dostępności.

Możliwości:

• osobny flow od cen i opisów,
• produkty bez powiązania są raportowane, nie blokują reszty,
• identyczny stan nie jest zapisywany ponownie.

Zalety: bieżący magazyn w Apilo bez ruszania karty produktu; bezpieczne przy dużej liczbie SKU.

4. Synchronizacja mediów (zdjęć) w Apilo

Wysyła zdjęcia galerii produktu: nowe, zmienione, w nowej kolejności. Opcjonalnie pełne ponowne wysłanie oraz odpięcie wyłączonych zdjęć.

Możliwości:

• tryb przyrostowy (tylko różnice) albo pełny,
• odpinanie zdjęć wyłączonych w Wirtualizerze,
• raport: dodane, zastąpione, bez zmian, brak pliku, błąd uploadu.

Zalety: galeria w Apilo zgodna ze sklepem; nie ładuje ponownie tych samych plików.

5. Synchronizacja katalogu w Apilo

Aktualizuje wybrane pola karty: nazwa, opis, krótki opis, EAN, waga, stawka VAT. Domyślnie nazwa i opis, bez aktualizacji ceny (osobny flow) oraz bez SKU (element niezmienny). 

Możliwości:

• zaznaczenie tylko tych pól, które mają się zmienić,
• produkty bez mapowania: CTA do eksportu z dzwonka,
• oddzielnie od cen i stanów.

Zalety: poprawki opisów i EAN bez nadpisywania ceny i stanu w Apilo.

Wydajność: partie po 500, API do 128 na żądanie.

Kategorie (Magazyn → Kategorie → Operacje Apilo)

Zakres: zaznaczone kategorie, filtr albo wszystkie z włączonym eksportem do Apilo.

1. Synchronizacja kategorii (struktura drzewa)

Tworzy i wiąże kategorie w Apilo według drzewa Wirtualizera (nazwa Apilo albo nazwa PL).

Możliwości:

• tworzenie brakujących kategorii i powiązanie już istniejących,
• pominięcie kategorii z ręcznym nadpisaniem w mapowaniu,
• multioperacje: kopiuj nazwę PL → nazwa Apilo, włącz/wyłącz eksport.

Zalety: spójne drzewo kategorii przed przypisaniem produktów; bez kasowania ręcznych wyjątków.

2. Przypisanie kategorii do produktów

Ustawia w Apilo kategorie na produktach, które mają już mapowanie produktu i kategorii.

Możliwości: zakres z listy kategorii; pełny łańcuch „najpierw drzewo, potem przypisanie”.

Zalety: produkty lądują w właściwych działach Apilo po jednej operacji łańcuchowej.

3. Pełna synchronizacja kategorii (drzewo → przypisanie)

Jedno kliknięcie: po zakończeniu struktury automatycznie startuje przypisanie produktów.

Zalety: nie trzeba pilnować kolejności; drugi krok rusza sam, gdy pierwszy się uda.

Cechy i atrybuty (Cechy → Synchronizacja atrybutów Apilo)

Zakres cech: zaznaczone, z filtra albo wszystkie oznaczone do Apilo.

1. Definicje atrybutów (B1)

Tworzy i wiąże definicje cech Wirtualizera z atrybutami w Apilo.

Zalety: raz zmapowana cecha służy do słowników i wartości na produktach.

2. Słowniki cech wyboru (B3)

Synchronizuje wartości słownikowe cech typu wyboru (type=16) do Apilo.

Zalety: te same opcje cechy w sklepie i w Apilo, bez ręcznego uzupełniania list.

3. Wartości atrybutów na produktach (B2)

Wysyła wartości cech na produkty już obecne w Apilo.

Możliwości: zakres cech + wszystkie kwalifikujące się produkty; czyszczenie wartości, których już nie ma w Wirtualizerze.

Zalety: karty w Apilo mają te same parametry co w sklepie (np. kolor, rozmiar, materiał).

4. Pełna synchronizacja atrybutów (B1 → B3 → B2)

Łańcuch: definicje, potem słowniki, na końcu wartości na produktach (partiami).

Zalety: jedna akcja, poprawna kolejność, bez ręcznego czekania na każdy krok.

Obsługiwane flow — cron (automat)

Cron robi te same integracje cyklicznie. Zamówienia i usługi systemowe są tylko w cronie (nie ma ich w menu list produktów).

1. Import zamówień z Apilo — pobiera zamówienia z Apilo i zakłada je w Wirtualizerze (kontrahent, pozycje, statusy). Zaleta: sprzedaż z Apilo wpada do realizacji w Wirtualizerze bez ręcznego przepisywania.
2. Eksport produktów — tworzy brakujące karty (jak w panelu).
3. Eksport usług systemowych — zakłada w Apilo karty usług (transport, płatność) potrzebne przy eksporcie zamówień. Zaleta: kompletne zamówienie z kosztami dostawy i płatności.
4. Synchronizacja stanów — PATCH ilości; do 500 produktów na przebieg + pomijanie bez zmian.
5. Aktualizacja produktów (pełna karta) — zapis nazwy, VAT, statusu, stanu i ceny na produktach już zmapowanych. Do codziennych cen i stanów lepiej używać osobnych flow cen/stanów.
6. Synchronizacja cen — tylko cena brutto; do 500 na przebieg + pomijanie identycznych cen.
7. Definicje atrybutów (B1) — jak w panelu, na całym zestawie cech do Apilo.
8. Słowniki cech (B3) — jak w panelu, automatycznie.
9. Wartości atrybutów na produktach (B2) — przyrostowo od ostatniego produktu (kursor) + pomijanie bez zmian.
10. Synchronizacja mediów — przyrostowo od kursora; domyślnie do 50 produktów na przebieg (upload jest cięższy niż ceny/stany). Opcje pełnego przebiegu i odpinania wyłączonych zdjęć.
11. Synchronizacja kategorii — całe drzewo z włączonym eksportem.
12. Przypisanie kategorii produktów — skan z kursorem, domyślnie do 200 produktów na przebieg.
13. Eksport zamówień do Apilo — wysyła zamówienia z Wirtualizera (adresy, pozycje towarowe i usługi, status płatności). Zaleta: zamówienia ze sklepu widać w Apilo.

Rekomendowana kolejność startowa katalogu: eksport produktów → eksport usług → eksport zamówień.
Ceny, stany, media i atrybuty można odpalać niezależnie, gdy karty już istnieją w Apilo.

Alertowanie — dzwonek i stany

Po zakończeniu operacji wynik wpada na dzwonek powiadomień w panelu. Nie trzeba odświeżać listy ani czekać na ekranie.

Stany zadania

• Oczekuje — zlecenie jest w kolejce.
• W toku — worker przetwarza partie.
• Zakończone — operacja skończona (także gdy część rekordów pominięto jako „bez zmian”).
• Nieudane — zadanie padło (np. błąd API, brak konfiguracji).
• Anulowane — bez alertu na dzwonku.

Kolory i treść dzwonka

• Sukces — zielony: krótki tytuł z liczbami (np. „Zsynchronizowano stany 120 produktów”, „Utworzono 15 produktów w Apilo”).
• Częściowy wynik — informacyjny: część się udała, część wymaga uwagi (błędy partii, brak plików zdjęć, produkty bez eksportu).
• Błąd — czerwony: operacja nieudana albo zakończona z błędami.

W treści alertu są konkretne liczniki: utworzono, zsynchronizowano, bez zmian, wymaga eksportu, błędy. Przy cenach, stanach, katalogu i mediach dzwonek może podać przycisk dodania brakujących produktów do Apilo (i od razu mediów, jeśli to sync zdjęć).

Panel: dzwonek zawsze dla osoby, która zleciła zadanie (sukces, częściowy wynik i błąd). Cron: błąd i wynik częściowy idą do administratora automatycznie; czysty sukces crona — tylko gdy włączysz powiadomienie o zakończeniu. Podzadania partii nie spamują dzwonka — jeden alert na całą operację.

Jeśli to samo flow już trwa, panel nie zleca drugiego i pokazuje numer istniejącego zadania.

Wykonywanie w tle — jak to działa

Kliknięcie w panelu nie czeka na Apilo. System dodaje zadanie do kolejki. Worker dzieli duży zakres na partie i wysyła je do API. Po całości składa podsumowanie i publikuje dzwonek.

Zalety tego modelu:

• panel zostaje responsywny przy tysiącach SKU,
• awaria jednej partii nie kasuje całej operacji — w alercie widać, co przeszło, a co nie,
• łańcuchy (kategorie, atrybuty, eksport + media) startują kolejny krok same,
• cron i panel korzystają z tych samych mechanizmów zapisu do Apilo,
• przy chwilowych błędach sieci Apilo ponawia zapytanie (do 3 prób), a przy limicie zapytań bezpiecznie kończy przebieg zamiast zapychać kolejkę.

Wydajność flow

Integracja Apilo skaluje się od kilkudziesięciu do wielu tysięcy produktów, a codzienny sync cen i stanów zostaje lekki, bo do Apilo idą tylko realne zmiany.

• Ceny i stany — najszybsze: tylko 1–2 pola, paczki 128, skip bez zmian, w panelu 500 SKU na partię zadania.
• Eksport i katalog — 500 SKU na partię zadania, 128 na żądanie API.
• Atrybuty na produktach — jak wyżej + w cronie pomijanie niezmienionych kart (odcisk danych).
• Media — 200 produktów na partię; bez zmian = zero uploadu; cron celowo mniejszy (50), bo wysyłka plików jest najcięższa.
• Kategorie — jeden zrzut drzewa Apilo + pauzy przy bardzo dużych strukturach.
• Przypisanie kategorii — przyrostowy kursor, kontrolowane tempo do API.
• Zamówienia — import do 512, eksport do 100 na przebieg crona, bez blokowania panelu.

W cenie

• Bezterminowa licencja.
• Instalacja i konfiguracja.
• Szkolenie online z obsługi.

Do ceny modułu należy doliczyć cenę miesięcznej opieki i aktualizacji. Cena uzależnionej od ilości produktów i zamówień.