Konfiguracja integracji z AtomStore

W tym wpisie znajdziesz opis krok po kroku, jak skonfigurować integrację xSale z AtomStore.

Instrukcja obejmuje zarówno dane potrzebne do autoryzacji, jak i ustawienia synchronizacji, mapowania płatności, dostaw, jednostek oraz statusów zamówień.

Uwaga: Opisana poniżej instrukcja i widoczne ścieżki dotyczą działania integracji w xSale V1.

W tym artykule znajdziesz

• jak dodać integrację z AtomStore
• jak uzupełnić dane autoryzacyjne
• jak ustawić zakres synchronizacji
• jak ustawić ceny brutto i netto
• jak przygotować mapowanie płatności
• jak przygotować mapowanie sposobów dostawy
• jak działa mapowanie jednostek
• jak ustawić mapowanie statusów
• jakie ustawienia trzeba dodatkowo sprawdzić w AtomStore

Dodanie integracji

1. Przejdź do sekcji Konfiguracja > Integracje.
2. Na liście integracji kliknij + Dodaj integrację.
3. Z listy dostępnych integracji wybierz AtomStore.

Dane podstawowe i autoryzacja

Na pierwszym ekranie uzupełnij podstawowe informacje o integracji:

• Nazwa integracji – zalecamy nazwę w formacie AtomStore_NazwaSklepu.
• Język – wybierz domyślny język dla integracji z listy dostępnych języków.
• Nazwa statusu, na który mają być pobierane zamówienia – wpisz Nowe.
• Nazwa statusu, na który mają być pobierane płatności – wpisz Nowe.
• Włączone – zaznacz to pole, jeśli integracja ma być aktywna od razu po zapisaniu.

Po uzupełnieniu danych kliknij Zapisz i przejdź do instalatora.

W pierwszym kroku instalatora wpisz:

• login do panelu administracyjnego AtomStore,
• hasło do panelu administracyjnego AtomStore,
• adres sklepu w formacie https://demo.atomstore.pl/atom_api/call/atom_api.

Na końcu kliknij Autoryzuj i przejdź do kolejnego kroku.

Ustawienia synchronizacji

W drugim kroku określasz, jakie dane mają być synchronizowane pomiędzy xSale i AtomStore.

W tej części uzupełnij:

• Nazwa statusu w AtomStore po poprawnym imporcie zamówienia,
• Nazwa statusu w AtomStore po błędzie importu zamówienia.

Następnie zaznacz, które dane mają być synchronizowane:

• opisy produktów,
• zdjęcia produktów,
• ceny,
• parametry na ofercie,
• płatności,
• grupy i parametry,
• zamówienia.

Jeżeli zaznaczysz synchronizację zamówień, wskaż również datę, od której zamówienia mają być pobierane do xSale.

Ceny netto i brutto

W kolejnym kroku ustawisz sposób obsługi cen w zamówieniach i ofertach.

• Pobieraj ceny brutto – zaznacz, jeśli ceny w zamówieniach AtomStore są podawane jako brutto. Jeśli w sklepie pracujesz na cenach netto, pole pozostaw odznaczone.
• Wysyłaj ceny brutto – zaznacz, jeśli do ofert w AtomStore chcesz wysyłać ceny brutto. Jeśli do sklepu mają trafiać ceny netto, pozostaw to pole odznaczone.

Mapowanie form płatności

W kroku mapowania płatności połącz formy płatności z AtomStore z odpowiednimi ustawieniami po stronie ERP.

• W kolumnie Sklep wpisz dokładną nazwę formy płatności z AtomStore.
• W kolumnie ERP wpisz odpowiadającą jej formę płatności z systemu ERP.
• Jeśli płatności mają być zapisywane na wskazany rejestr kasowo-bankowy w ERP, uzupełnij także kolumnę Rejestr w formacie REJESTR;TYPOPERACJI.

Przykład: jeśli w sklepie występuje płatność Płatność przy odbiorze, a w ERP odpowiada jej forma Pobranie, takie mapowanie powinno zostać zapisane właśnie w tym kroku.

Uwaga: Wartości wpisane w mapowaniach muszą być zgodne z rzeczywistymi nazwami używanymi w sklepie i w ERP. Wielkość liter, spacje i zapis skrótów mają znaczenie.

Mapowanie sposobów dostawy

Po zapisaniu mapowań płatności kliknij Dalej i przejdź do mapowania dostaw.

• W kolumnie Sklep wpisz dokładną nazwę formy dostawy z AtomStore.
• W kolumnie ERP wpisz odpowiadający jej sposób dostawy z systemu ERP.
• W kolumnie Transport wpisz kod usługi transportowej, która ma zostać dodana do zamówienia w ERP jako pozycja z kosztem dostawy.

Każdy wpis w kolumnie ERP powinien mieć swój odpowiednik na liście sposobów dostawy w xSale:

Konfiguracja > Sposoby dostawy

Każdy wpis w kolumnie Transport powinien odpowiadać ofercie istniejącej w xSale, ponieważ to ta oferta zostanie użyta do zapisania kosztu transportu na zamówieniu.

Mapowanie jednostek

Kolejny krok to Mapowanie jednostek pomiędzy systemem ERP i AtomStore.

W tym miejscu określasz, jak mają odpowiadać sobie jednostki używane w obu systemach, aby synchronizacja ofert i zamówień przebiegała poprawnie.

Mapowanie statusów

W ostatnim kroku możesz uzupełnić mapowanie statusów pomiędzy xSale i AtomStore.

Dzięki temu zmiana statusu w xSale może automatycznie ustawić odpowiedni status na zamówieniu w AtomStore.

Przykład:

• Sklep: Wysłane
• ERP / xSale: Zrealizowane

Po kliknięciu Zapisz integracja z AtomStore zostanie dodana.

Dodatkowe ustawienia po stronie AtomStore

Po konfiguracji integracji w xSale warto sprawdzić jeszcze dwa ustawienia bezpośrednio w panelu AtomStore.

Uwaga: W sekcji Ustawienia > Kraje zalecamy ustawienie dwuliterowego kodu kraju PL zapisanego wielkimi literami. W innym przypadku mogą występować problemy z wczytywaniem zamówień do systemu ERP.

Ważne: W panelu AtomStore trzeba zaznaczyć opcję: Ustawienia -> Konfiguracja sklepu -> API i integracje FK/ERP -> Atom SOAP API -> Pobieranie zamówień (GetOrdersSpecified) -> produkty -> zwracaj warianty z jsonową postacią atrybutów wariantowych. Bez tego pobieranie zamówień z produktami wielowariantowymi może nie działać poprawnie.