Integracja z eParagony.pl

Summary: Sprawdź, w jaki sposób skonfigurować ustawienia integracji z eParagonami w sklepie na platformie AtomStore.

Z artykułu dowiesz się, w jaki sposób skonfigurować ustawienia integracji z eParagony.pl w sklepie na platformie AtomStore.

---

Skąd pobrać dane dostępowe?

1. Dane dostępowe takie jak: ID klienta, hasło klienta oraz webhook secret należy uzyskać bezpośrednio od dostawcy integracji – serwisu eParagony.pl.

---

Konfiguracja ustawień w panelu AtomStore

1. Przejdź do Ustawienia Konfiguracja sklepu API i integracje FK/ERP eParagony .

2. Po rozwinięciu listy ustawień skonfiguruj:

• Automatyczne generowanie paragonu po otrzymaniu statusu – ustawienie, które pozwala na wybranie statusu zamówienia, po którego nadaniu paragon będzie wystawiany w sposób automatyczny;
• Atrybut zawierający kody EAN produktów – w ustawieniu należy zmapować atrybut, który zawiera w sobie kod EAN produktu. Jest to ustawienie opcjonalne w sytuacji, gdy EAN nie jest głównym kodem produktów.

3. Następnie rozwiń zakładkę Dane dostępowe . W tym miejscu skonfiguruj:

• ID klienta (client_id) – ID klienta uzyskane od serwisu eParagony.pl;
• Hasło klienta (client_secret) – hasło klienta do konta w serwisie eParagony.pl;
• Identyfikator sklepu (posId) – nazwa Twojego sklepu;
• Webhook Secret – klucz secret, który również należy otrzymać z serwisu eParagony.pl;
• Tryb testowy – w przypadku, gdy chcesz przetestować integrację, zaznacz opcję Tak . Należy pamiętać, aby wcześniej zgłosić się bezpośrednio do serwisu eParagony.pl w celu otrzymania dostępu do konta sandbox (środowisko testowe), a także ID i hasła. 

4. Zapisz dane.

5. W przypadku konfiguracji e-paragonów należy również pamiętać, aby skonfigurować wcześniej stawki podatków. Szczególnie istotne jest określenie typu stawki podatkowej (litery od A do G) na kasie fiskalnej. Instrukcję dotyczącą konfiguracji podatków znajdziesz w tym miejscu. 

6. Dodatkowo w Ustawienia Mapowanie obiektów zmapuj również formy płatności do integracji z eParagony.pl. 

7. Kliknij Dodaj wpis . W tym miejscu można wstawić obiekt wewnętrzny i nazwę zewnętrzną, a także ID zewnętrzne. 

8. Co ważne, po uruchomieniu i skonfigurowaniu integracji, przechodząc do: Ustawienia Konfiguracja sklepu Maile systemowe znajdziesz szablon: Wystawianie e-Paragonu . Jest on dostępny wyłącznie w przypadku aktywnej integracji.

---

Wystawianie e-paragonu w AtomStore

Przykład 1 – automatyczne wystawianie paragonu:

W panelu AtomStore zostało złożone zamówienie. W ustawieniach konfiguracji automatyczne wystawianie paragonu zostało skonfigurowane na status: “Wysłany”. 

1. Przejdź do Sprzedaż Zamówienia .

2. W sytuacji, gdy zamówienie jest opłacone i przygotowane do wysyłki, zmień status na Wysłany .

3. Po zmianie statusu wejdź w szczegóły zamówienia i wybierz zakładkę Faktury i kliknij Pobierz .

4. Paragon zostanie wyświetlony w oddzielnym oknie.

5. Klient otrzymuje również na adres e-mail informację o wystawionym paragonie. Z otrzymanej wiadomości można bezpośrednio przejść do widoku paragonu, klikając Otwórz e-paragon . Poniższy zrzut ekranu obrazuje przykładową wiadomość:

Przykład 2 – ręczne wystawianie paragonu:

W panelu AtomStore zostało złożone zamówienie. Po zmianie statusu paragon wystawiony będzie ręcznie przez administratora.

1. Przejdź do Sprzedaż Zamówienia .

2. Zmień status zamówienia na W trakcie realizacji . 

3. Po zmianie statusu wejdź w szczegóły zamówienia i wybierz zakładkę Faktury i kliknij przycisk Wystaw e-paragon .

4. Potwierdź chęć wystawienia e-paragonu.

5. Po poprawnym wystawieniu paragonu zostanie wyświetlona informacja.

6. Wróć do zakładki Faktury . W tym miejscu analogicznie jak w poprzednim przykładzie znajdziesz e-paragon z możliwością pobrania.

---

Gdzie w panelu AtomStore można znaleźć paragony?

1. Paragony w panelu administracyjnym można znaleźć po przejściu do Sprzedaż Faktury .

2. W przypadku paragonów analogicznie jak dla faktur istnieje możliwość podglądu takich danych jak:

• Numer paragonu;
• ID zamówienia, do którego paragon został wystawiony;
• Typ faktury (w tym przypadku jest to e-paragon);
• Data wystawienia;
• Data sprzedaży;
• Sposób płatności;
• Termin płatności;
• Wartość brutto.

3. Z prawej strony znajdziesz dodatkowo kilka opcji pozwalających na zarządzanie e-paragonem. Są to opcje takie jak:

• Dodaj płatność – w tym miejscu można sfiskalizować paragon;
• Pobierz – opcja pobierania paragonu na dysk;
• Wyślij – opcja wysyłki paragonu do klienta; 
• Szczegóły – podgląd paragonu;
• Usuń – usunięcie paragonu.

4. W przypadku, gdy fiskalizacja paragonu się nie powiodła – przy paragonie wyświetlona zostanie ikonka z wykrzyknikiem:

Po najechaniu na ikonkę wyświetli się informacja z wyjaśnieniem błędu. Opcjonalnie można kliknąć ikonę lupy, po której wyświetlone zostanie okno podglądu szczegółów paragonu.