EN
Ten wpis wyjaśnia, jak uzupełnić plik konfiguracyjny potrzebny do przygotowania integracji xSale z IdoSell (IAI). Dane z formularza są używane do połączenia xSale ze sklepem, pobierania zamówień, synchronizacji płatności, mapowania dostaw oraz obsługi towarów i ofert.
Do uzupełnienia możesz wykorzystać formularz wdrożeniowy oraz przykładowo wypełniony plik:
W tym artykule znajdziesz:
- jak uzupełnić dane dostępowe do sklepu IdoSell (IAI)
- jak przygotować mapowanie statusów zamówień
- jak uzupełnić mapowanie sposobów dostawy
- jak uzupełnić mapowanie form płatności
- jak opisać typ ceny i powiązanie towarów
- co wpisać przy produktach wielowariantowych
- o czym warto pamiętać przed przekazaniem pliku
Dane dostępowe do sklepu IdoSell (IAI)
W pierwszej części formularza podaj dane, które umożliwią xSale połączenie ze sklepem IdoSell. Integracja korzysta z adresu API sklepu oraz danych użytkownika. Na ich podstawie xSale autoryzuje zapytania do IdoSell, m.in. przy pobieraniu zamówień, płatności, kategorii, towarów, stanów i parametrów.
Adres URL sklepu to adres Twojego sklepu widoczny w przeglądarce. Jeżeli sklep działa pod własną domeną, wpisz właśnie ten adres, np. https://twojsklep.pl. Adres powinien prowadzić do działającego sklepu i mieć poprawny certyfikat SSL.
Login administratora to login użytkownika IdoSell, który ma uprawnienia potrzebne do obsługi integracji. Może to być istniejący użytkownik albo osobny użytkownik utworzony specjalnie dla xSale.
Hasło administratora to hasło tego użytkownika. W kodzie integracji hasło jest używane do wygenerowania klucza autoryzacyjnego wymaganego przez API IdoSell, dlatego musi być aktualne i zgodne z użytkownikiem wpisanym w polu loginu.
Mapowanie statusów zamówień
W tej części formularza wpisz nazwy statusów zamówień używanych w IdoSell. Statusy decydują o tym, które zamówienia i płatności mają być pobierane oraz jaki status ma zostać ustawiony w sklepie po poprawnym imporcie albo po błędzie.
Nazwy statusów sprawdzisz w panelu IdoSell na przykład na podglądzie lub edycji zamówienia w sekcji Sprzedaż → Zamówienia. W formularzu wpisuj dokładnie takie wartości, jakie są używane w sklepie. Wielkość liter, spacje i znaki specjalne mają znaczenie.
| Co uzupełnić w formularzu | Jak rozumieć to pole |
|---|---|
| Status zamówienia importowanego do ERP | Status w IdoSell, z którym zamówienie ma zostać pobrane do xSale i przekazane dalej zgodnie z konfiguracją. |
| Status po poprawnym imporcie | Status, który może zostać ustawiony w IdoSell po poprawnym przetworzeniu zamówienia. |
| Status płatności importowanej do ERP | Status używany przy pobieraniu płatności z IdoSell. |
| Status po błędzie importu | Status, który pozwala oznaczyć w IdoSell zamówienie wymagające weryfikacji. |
Mapowanie sposobów dostawy
Mapowanie sposobów dostawy łączy nazwę dostawy z IdoSell z usługą transportową w ERP. Jeżeli klient wybierze płatną dostawę, taka usługa może zostać dodana do dokumentu ERP jako osobna pozycja, np. na rezerwacji, zamówieniu lub fakturze.
Dla każdej formy dostawy możesz wskazać inną usługę transportową z ERP albo użyć jednej wspólnej usługi, np. TRANSPORT. Jeżeli w formularzu zostawisz pole puste, konieczne będzie późniejsze ustalenie, jaka usługa ma być używana domyślnie.
Przykładowe mapowanie osobnych usług:
- InPost Kurier by IAI – standard → INPOST
- InPost Paczkomaty 24/7 by IAI – tylko wielkość B → PACZKOMATY
- Kurier DHL → DHL
- Allegro Kurier DPD → ALLEGRO DPD
Przykładowe mapowanie jednej wspólnej usługi:
- InPost Kurier by IAI – standard → TRANSPORT
- InPost Paczkomaty 24/7 by IAI → TRANSPORT
- Kurier DHL → TRANSPORT
- Allegro Kurier DPD → TRANSPORT
Mapowanie form płatności
Mapowanie form płatności łączy nazwę płatności ze sklepu z formą płatności w xSale i, jeżeli integracja jest połączona z ERP, z odpowiednimi danymi ERP. Dzięki temu zamówienie otrzymuje właściwą formę płatności, a płatności mogą być przekazywane dalej zgodnie z konfiguracją.
W formularzu uzupełnij nazwę formy płatności z IdoSell, odpowiadającą jej formę płatności w ERP oraz, jeśli jest używany, rejestr bankowy lub kasowy. Rejestr jest istotny głównie przy płatnościach online, które mają zostać zapisane w ERP jako płatność. Przy pobraniu albo zwykłym przelewie rejestr może nie być wymagany, zależnie od konfiguracji ERP.
| Forma płatności w IdoSell | Płatność ERP | Rejestr w ERP |
|---|---|---|
| przedpłata | przelew | |
| pobranie | pobranie |
Ważne: nazwy wpisane w mapowaniach muszą odpowiadać wartościom zwracanym przez sklep. Duże litery, spacje i znaki specjalne mogą decydować o tym, czy mapowanie zadziała prawidłowo.
Typ ceny i powiązanie towarów
W polu dotyczącym typu ceny wpisz, który cennik z ERP ma być używany do synchronizacji cen do IdoSell. Może to być np. cena detaliczna, hurtowa albo osobny cennik przygotowany dla sklepu internetowego.
Uzupełnij również informację, czy kody produktów w IdoSell są takie same jak kody towarów w ERP. To ważne dla powiązania ofert z kartotekami towarów. Jeżeli kody są różne, wpisz to w formularzu, aby można było dobrać właściwy sposób powiązania danych.
Przykład różnicy: kod produktu w IdoSell to 7894587894, a kod towaru w ERP to Buty A487. W takiej sytuacji integracja wymaga dodatkowego ustalenia, po jakim identyfikatorze towary mają być łączone.
Produkty wielowariantowe
W formularzu zaznacz, czy w sklepie IdoSell masz produkty wielowariantowe, czyli takie, w których klient wybiera wariant produktu, np. rozmiar, kolor, długość albo inny parametr. Jeżeli takie produkty występują, podaj szacunkowo, jaki procent oferty stanowią.
Ta informacja pomaga dobrać sposób konfiguracji i sprawdzić, czy warianty będą prawidłowo powiązane z towarami oraz ofertami w xSale.
O czym warto pamiętać
- Adres sklepu musi być adresem, pod którym działa sklep i API IdoSell.
- Użytkownik podany w formularzu powinien mieć uprawnienia potrzebne do obsługi integracji.
- Mapowania statusów, dostaw i płatności wpisuj dokładnie tak, jak występują w IdoSell.
- Jeżeli nazwy płatności, dostaw albo statusów różnią się między sklepem, xSale i ERP, opisz to w formularzu.
- Jeżeli kody produktów w IdoSell i ERP są różne, nie zostawiaj tej informacji bez komentarza. Ma to wpływ na powiązanie towarów.