Konfiguracja integracji z Erli

Integrację z Erli skonfigurujesz w panelu xSale V2 za pomocą kreatora integracji. Kreator prowadzi przez autoryzację konta, wybór zakresu działania, synchronizację ofert i zamówień, mapowanie statusów oraz parametry sprzedaży.

W tym artykule znajdziesz

• Co przygotować przed konfiguracją?
• Jak dodać integrację Erli?
• Jak przejść przez kreator?
• Co oznacza konfiguracja w V2?
• Co zrobić po zapisaniu konfiguracji?
• Co sprawdzić po uruchomieniu integracji?
• Jak rozwiązać najczęstsze problemy?

Co przygotować przed konfiguracją?

Przed dodaniem integracji przygotuj klucz API z konta Erli. Klucz jest potrzebny do połączenia xSale z kontem sprzedawcy i sprawdzenia poprawności danych dostępowych.

Jak dodać integrację Erli?

1. Zaloguj się do panelu xSale V2.
2. Przejdź do sekcji Konfiguracja → Integracje.
3. Wybierz opcję dodania nowej integracji i wskaż Erli.

4. Wprowadź klucz API z Erli.
5. Uruchom autoryzację. Jeśli klucz jest poprawny, xSale pobierze ze sklepu Erli identyfikator i nazwę sklepu.

Jak przejść przez kreator?

Po autoryzacji uzupełnij kolejne kroki kreatora zgodnie z tym, jaki zakres ma obsługiwać integracja.

Zakres integracji

W tym kroku określ, które procesy mają być obsługiwane przez integrację. Ustawienia wpływają na to, czy xSale będzie synchronizować oferty, zamówienia i powiązane dane.

Synchronizacja ofert

W kroku synchronizacji ofert ustaw sposób obsługi ofert i produktów. To tutaj określasz, czy xSale ma obsługiwać tworzenie i aktualizację ofert, a także dane takie jak ceny, stany, opisy, zdjęcia, EAN, SKU, kategorie i parametry.

Jeżeli korzystasz z importu ofert z Erli, kreator może uruchomić pobieranie danych ofertowych i parametrów sprzedaży ze sklepu.

Synchronizacja zamówień

W ustawieniach zamówień określ, od kiedy xSale ma pobierać zamówienia z Erli i jakie dane mają być synchronizowane. Integracja pobiera zamówienia, płatności oraz szczegóły zamówień udostępniane przez Erli.

Mapowanie płatności i dostaw

Mapowania decydują o tym, jak metody płatności i dostawy z Erli będą zapisane na zamówieniach w xSale. Uzupełnij je zgodnie z nazwami i procesami używanymi w Twojej firmie.

Mapowanie statusów zamówień

Mapowanie statusów określa, jaki status ma zostać wysłany z xSale do Erli. Dopasuj statusy do realnego procesu obsługi zamówień, np. osobno dla zamówień w realizacji, wysłanych i anulowanych.

Aktywacja integracji

Na końcu zdecyduj, czy integracja ma być aktywna. Po włączeniu integracji xSale zacznie wykonywać procesy zgodnie z ustawionym zakresem i mapowaniami.

Po sprawdzeniu ustawień zapisz konfigurację.

Co oznacza konfiguracja w V2?

Konfiguracja V2 jest nowszym sposobem obsługi integracji Erli w xSale. Wcześniejsza konfiguracja była bardziej techniczna i opierała się na ustawieniach integracji workerowej. W V2 użytkownik przechodzi przez kreator, który sprawdza dane API i pozwala ustawić działanie integracji z poziomu panelu.

Pod spodem integracja nadal korzysta z connectora Erli. Oznacza to, że po poprawnym skonfigurowaniu może obsługiwać oferty, towary, stany, ceny, parametry, zamówienia i płatności zgodnie z ustawionym zakresem.

Co zrobić po zapisaniu konfiguracji?

Po zapisaniu konfiguracji sprawdź mapowania dostaw, płatności i statusów. Te ustawienia decydują o tym, jak dane z Erli będą widoczne na zamówieniach w xSale oraz jakie statusy i numery przesyłek będą wysyłane z xSale do Erli.

Co sprawdzić po uruchomieniu integracji?

Po zapisaniu i włączeniu integracji sprawdź, czy podstawowe elementy konfiguracji są kompletne. Dzięki temu łatwiej wykryć brakujące ustawienia, zanim integracja zacznie obsługiwać bieżące zamówienia i oferty.

• Sprawdź, czy klucz API został poprawnie zaakceptowany przez kreator.
• Upewnij się, że integracja jest aktywna.
• Sprawdź, czy wybrano właściwy zakres działania integracji, np. synchronizację ofert, zamówień, cen i stanów.
• Zweryfikuj datę, od której xSale ma pobierać zamówienia z Erli.
• Uzupełnij mapowania płatności i dostaw, żeby dane z Erli były poprawnie widoczne na zamówieniu w xSale.
• Uzupełnij mapowania statusów zamówień, jeśli statusy mają być wysyłane z xSale do Erli.
• Sprawdź, czy na testowym zamówieniu poprawnie pobrały się dane kupującego, odbiorcy, pozycje zamówienia, płatność i dostawa.
• Jeżeli korzystasz z obsługi ofert, sprawdź na jednej ofercie testowej, czy wymagane dane Erli są uzupełnione i czy oferta może zostać utworzona albo zaktualizowana.

Najczęstsze problemy

Zamówienie nie pobrało się do xSale

Sprawdź, czy integracja jest aktywna, czy ustawiono poprawną datę pobierania zamówień oraz czy zamówienie w Erli ma status objęty synchronizacją. Jeżeli zamówienie jest starsze niż data ustawiona w kreatorze, może nie zostać pobrane.

Pozycja zamówienia nie dopasowała się do oferty lub towaru

xSale dopasowuje pozycje zamówienia na podstawie SKU i EAN. Sprawdź, czy SKU lub EAN z Erli odpowiada kodowi oferty, kodowi towaru albo kodowi EAN zapisanemu przy towarze w xSale.

Status zamówienia nie zmienił się w Erli

Sprawdź mapowanie statusów zamówień. W polu Status w sklepie należy wpisać techniczną wartość statusu Erli, np. inProgress, canceled albo sent, a nie polską nazwę statusu.

Numer przesyłki nie pojawił się w Erli

Sprawdź, czy numer listu przewozowego został zapisany na zamówieniu w xSale. Przekazywanie numeru przesyłki działa osobno od mapowania statusów. Jeżeli numer został wygenerowany po stronie usługi ErliPRO i Erli sam zapisuje go na zamówieniu, dodatkowe wysyłanie numeru przez xSale może nie być potrzebne.

Oferta nie została utworzona albo zaktualizowana

Sprawdź, czy oferta ma komplet danych wymaganych przez Erli, w tym kategorię, nazwę, SKU, EAN, cenę, stan, VAT, zdjęcia oraz wymagane parametry sprzedaży. Brak danych wymaganych przez marketplace może zablokować utworzenie lub aktualizację oferty.