Ritevo
Pobierz .md

eparagony.pl

Integracja z eparagony.pl przesyła do eParagony paragony wystawione w Ritevo. Podłączasz ją danymi dostępowymi do API z panelu eParagony i wskazujesz punkt sprzedaży.

Integracji eparagony.pl możesz dodać dowolnie wiele, także kilka dla tego samego konta - na przykład z innymi danymi albo innymi ustawieniami wystawiania dokumentów. Każda działa osobno.

Jakie dokumenty przesyła

  • Paragon - trafia do eParagony jako e-paragon.
  • Faktura VAT i Korekta faktury - nie są obsługiwane.

Skąd wziąć dane dostępowe

Dane dostępowe do API eParagony udostępnia po rejestracji w usłudze, razem z dokumentacją API. Przygotuj je przed dodaniem integracji:

  1. Załóż konto w eparagony.pl, jeśli jeszcze go nie masz.
  2. Przygotuj Client ID, Client Secret i sekret webhooka.
  3. Przygotuj ID punktu sprzedaży (posId), do którego mają trafiać paragony.
  4. Jeśli nie możesz znaleźć tych danych, napisz do pomocy eParagony: pomoc@eparagony.pl.

Podłączenie konta

Zacznij w Ritevo:

  1. Wejdź w Integracje w lewym panelu i kliknij Dodaj integrację w prawym górnym rogu.
  2. W sekcji Księgowość wybierz kafelek eParagony.
  3. W karcie Ustawienia podstawowe wpisz Nazwa konta - własną nazwę integracji - i ID punktu sprzedaży (posId).
  4. W karcie Dane dostępowe wklej Client ID, Client Secret i Sekret webhooka.
  5. W karcie Ustawienia integracji ustaw Fiskalizuj dokumenty i Drukuj paragon - opis niżej.
  6. Kliknij Utwórz integrację. Client ID i Client Secret sprawdzamy od razu w eParagony: jeśli są poprawne, integracja zostaje dodana i otworzą się jej ustawienia. Jeśli nie - zobaczysz błąd i nic nie zostanie zapisane.
Lista integracji w Ritevo z zaznaczonym przyciskiem Dodaj integrację w prawym górnym rogu
Lista integracji w Ritevo z zaznaczonym przyciskiem Dodaj integrację w prawym górnym rogu
Ekran Dodaj integrację z zaznaczonym kafelkiem eParagony w sekcji Księgowość
Ekran Dodaj integrację z zaznaczonym kafelkiem eParagony w sekcji Księgowość
Ekran dodawania integracji eParagony z kartami Ustawienia podstawowe, Dane dostępowe i Ustawienia integracji
Ekran dodawania integracji eParagony z kartami Ustawienia podstawowe, Dane dostępowe i Ustawienia integracji

Ustawienia integracji

Na stronie integracji znajdziesz poniższe pola. Zmiany nazwy i przełączników zapisujesz przyciskiem Zaktualizuj integrację:

  • Nazwa konta - Twoja własna nazwa integracji. Możesz ją zmienić w każdej chwili.
  • ID punktu sprzedaży (posId) - punkt podany przy dodawaniu. Nie da się go zmienić - inny punkt dodajesz jako nową integrację.
  • Fiskalizuj dokumenty - po włączeniu eParagony fiskalizuje paragon. Wymaga to działającej u Ciebie usługi drukowania dokumentów eParagony. Domyślnie włączone.
  • Drukuj paragon - po włączeniu eParagony drukuje paragon. Tylko dla stacjonarnego punktu sprzedaży. Domyślnie wyłączone.
  • Zaktualizuj dane logowania - podajesz nowe Client ID, Client Secret i sekret webhooka.

Przesyłanie dokumentów

Dokumenty wystawiasz w zamówieniu. Do eparagony.pl przesyłasz je na dwa sposoby:

  • Ręcznie - w szczegółach dokumentu, w karcie Zew. systemy księgowe, kliknij przycisk z nazwą konta eparagony.pl. Przycisk pojawia się tylko przy dokumentach, które ta integracja obsługuje.
  • Automatycznie - krokiem Prześlij fakturę do zew. systemu księgowego albo Prześlij paragon do zew. systemu księgowego w akcjach dla zamówień.

Przesyłanie dokumentów najlepiej zaplanować po kolei - najpierw wystawienie, potem przesłanie:

  • Faktura - pierwsza akcja kończy się krokiem Wygeneruj fakturę. Druga startuje wyzwalaczem Faktura(dodanie/usunięcie), ma warunek Posiada fakturę i krok Prześlij fakturę do zew. systemu księgowego.
  • Paragon - tak samo: pierwsza akcja kończy się krokiem Wygeneruj paragon, a druga startuje wyzwalaczem Paragon(dodanie/usunięcie), ma warunek Posiada paragon i krok Prześlij paragon do zew. systemu księgowego.
  • Korekty - do jednej faktury możesz wystawić wiele korekt. Każdą prześlij zaraz po wystawieniu, zanim wystawisz następną.

W tej samej karcie każde przesłanie ma swoją ikonę. Po najechaniu na nią widzisz konto, stan i datę:

  • W trakcie przesyłania - dokument jest wysłany, czekamy na potwierdzenie od eparagony.pl.
  • Przesłano pomyślnie - dokument jest w eparagony.pl. Kliknij ikonę, żeby go pobrać albo otworzyć.
  • Błąd podczas przesyłania - dokument nie trafił do eparagony.pl. Pod stanem widzisz powód błędu.

Jak paragon trafia do eParagony

  • Bez fiskalizacji - eParagony przyjmuje paragon od razu, więc ma on stan Przesłano pomyślnie zaraz po wysłaniu.
  • Z fiskalizacją - paragon ma stan W trakcie przesyłania, dopóki eParagony nie potwierdzi fiskalizacji. Potem zmienia się na Przesłano pomyślnie albo na Błąd podczas przesyłania z powodem od eParagony.
  • Numer - w eParagony paragon ma numer nadany w Ritevo.
  • Podgląd - kliknięcie ikony otwiera paragon na stronie eParagony.
  • Stawki VAT - eParagony przyjmuje od nas 23%, 8%, 5%, 0% i Zw., a także dawne 22%, 7% i 3%. Paragon z inną stawką nie zostanie przesłany - zobaczysz błąd Stawka podatku nie jest wspierana.

Wymaga ponownego połączenia

Ten stan pojawia się, gdy eParagony przestało akceptować Client ID i Client Secret - na przykład po ich zmianie w panelu eParagony. Do tego czasu paragony nie trafią do eParagony.

  1. W panelu eParagony skopiuj aktualne dane dostępowe.
  2. Na stronie integracji kliknij Zaktualizuj dane logowania, wklej Client ID, Client Secret i sekret webhooka i zatwierdź. Sprawdzamy je w eParagony tak samo jak przy dodawaniu - poprawne odświeżą połączenie.

Usunięcie integracji

Usuń integrację wyłącza integrację w Ritevo. Dokumenty przesłane wcześniej zostają w eparagony.pl. Przywróć integrację włącza ją z powrotem.

Czego integracja nie robi

  • Nie przesyła faktur ani korekt.
  • Nie zmienia ani nie anuluje paragonów, które już trafiły do eParagony.