Aktywne połączenia i integracje oprogramowania
Tworzenie kluczy połączenia w eConnect

Tworzenie kluczy połączenia (App Key i Secret), Szybkie Łączenie, konektor Email oraz cofnięcie połączenia.

Aby podłączyć oprogramowanie księgowe do eConnect, potrzebne są klucze połączenia. Składają się z App Key i Secret, za pomocą których oprogramowanie bezpiecznie komunikuje się z platformą eConnect. Tworzy się je w kilku krokach.

Czym są klucze połączenia?

Klucze połączenia składają się z dwóch elementów:

  • App Key (zwany też Consumer Key): kod identyfikacyjny połączenia
  • Secret (zwany też Consumer Secret): hasło zabezpieczające połączenie

Razem stanowią dane uwierzytelniające, dzięki którym oprogramowanie może wysyłać i odbierać faktury przez eConnect. Secret należy traktować jak hasło i nie udostępniać go publicznie.

Tworzenie kluczy
  1. Zalogować się na platform.econnect.eu.
  2. Przejść do Moje środowisko i wybrać organizację, dla której ma być skonfigurowane połączenie.
  3. Przejść do Połączenia lub Podłącz oprogramowanie (w zależności od wersji subskrypcji).
  4. Kliknąć Utwórz nowe połączenie.
  5. Wybrać pakiet oprogramowania z listy.
  6. Platforma generuje App Key i Secret. Skopiować je natychmiast: Secret jest wyświetlany tylko raz.

Wprowadzanie kluczy w oprogramowaniu

Po utworzeniu kluczy należy je wprowadzić w pakiecie oprogramowania. Dokładna lokalizacja różni się w zależności od pakietu, ale zazwyczaj wygląda to następująco:

  • Otworzyć ustawienia lub konfigurację pakietu oprogramowania.
  • Znaleźć sekcję e-fakturowania, eConnect lub Peppol.
  • Wkleić App Key i Secret w odpowiednie pola.
  • Zapisać ustawienia i przetestować połączenie.

W przypadku niektórych pakietów (np. przez Szybkie Łączenie) można wkleić klucze za pomocą CTRL+V jednocześnie w oknie łączenia.

Szybkie Łączenie

Za pomocą Szybkiego Łączenia klucze wprowadza się w przyspieszony sposób. Zamiast kopiować App Key i Secret osobno, otwiera się okno łączenia, w którym wkleja się oba klucze jednocześnie za pomocą CTRL+V.

  1. Utworzyć klucze połączenia (patrz wyżej).
  2. Kliknąć Szybkie Łączenie obok utworzonego połączenia.
  3. Otworzy się nowe okno. Nacisnąć CTRL+V: klucze zostaną automatycznie wczytane.
  4. Wybrać administrację, dla której mają być pobierane faktury.
  5. Wprowadzić adres e-mail powiązany z administracją w pakiecie oprogramowania (nie adres e-mail eConnect).
  6. Opcjonalnie ustawić datę rozpoczęcia.
  7. Wybrać, czy przetwarzać również faktury sprzedażowe.
  8. Potwierdzić i kliknąć Zastosuj.
Oprogramowanie obsługujące Szybkie Łączenie
OprogramowanieKierunekBaseconeOdbieranie (zakup + sprzedaż)Exact MultiversWysyłanie + OdbieranieWhiteVisionOdbieranie (zakup + sprzedaż)YukiOdbieranie (zakup + sprzedaż)RadarWysyłanie

Wskazówka: adres e-mail podawany przy Szybkim Łączeniu musi być adresem powiązanym z administracją w pakiecie oprogramowania. Nie należy używać adresu e-mail konta eConnect.

Konektor Email

Jedno z połączeń tworzonych za pomocą Szybkiego Łączenia nazywa się w platformie konektorem Email. Uwaga: mimo nazwy działa to za pomocą kluczy połączenia, a połączenie znajduje się w Połączeniach -- nie jest wysyłany żaden e-mail. Nie mylić tego z Email Receiver: to jest aplikacja, za pomocą której samodzielnie odbiera się faktury przez e-mail na platformie. Konektor Email robi coś odwrotnego: automatycznie przesyła dalej faktury odebrane przez eConnect na wybrany adres e-mail.

Konektory Email z transformacją

Oprocz standardowego konektora Email istnieją warianty, które przekształcają odebrany dokument do określonego formatu (zawsze SI 2.0, zawsze BIS v3, zawsze SI 1.2 lub zawsze SALES005 Faktura). Konfiguracja jest taka sama jak w standardowym konektorze Email; eConnect zapewnia dostarczenie w wybranym formacie.

Konektor Email: przesyłanie dalej odebranych faktur

Jako odbiorca możesz utworzyć konektor Email, aby faktury odebrane przez eConnect były automatycznie przesyłane dalej na wskazany adres e-mail. Domyślnie przesyłany jest tylko plik XML -- bez PDF czy innych załączników. To zachowanie określa parametr excludeAdditionalAttachments:

  • excludeAdditionalAttachments=true (domyślnie): dodatkowe załączniki, takie jak PDF, nie są przesyłane.
  • excludeAdditionalAttachments=false: PDF i ewentualne inne załączniki są także przesyłane.

W standardowym konektorze Email (auto-hooku Collabrr), ten parametr jest ustawiony na true. Jeśli chcesz również otrzymywać PDF, może to zmienić tylko Techsupport.

Uwaga po modyfikacji przez Techsupport: jeśli jako klient samodzielnie zmienisz później konektor Email, ta zmiana automatycznie nadpisze modyfikację Techsupportu. PDF zostanie tym samym ponownie ukryty i nie będzie już przesyłany. Nie zmieniaj konektora samodzielnie po poprawce.

Jeśli zamiast tego używasz mailhooka w PSB i samodzielnie konfigurujesz konektor, możesz ustawić ten parametr samodzielnie -- to odrębna, niezależna ścieżka self-service.

To przesyłanie dalej jest odpowiednią alternatywą dla odbiorcy, który (jeszcze) nie jest w Peppol, ale chce automatycznie odbierać dane faktury lub dokument PDF.

Łączenie wielu organizacji

Jeśli zarządza się wieloma organizacjami w swoim środowisku, należy utworzyć oddzielny zestaw kluczy połączenia dla każdej organizacji. App Key jest unikalny dla każdej kombinacji organizacja-połączenie.

Utracone klucze?

Jeśli Secret został utracony, nie można poprosić o nowy. Należy utworzyć nowy zestaw kluczy połączenia. Stare klucze stają się nieważne. Nie należy zapominać o aktualizacji nowych kluczy w oprogramowaniu.

Bezpieczeństwo

Klucze połączenia zapewniają bezpieczny dostęp do organizacji eConnect. Należy pamiętać o:

  • Udostępnianiu kluczy tylko osobie konfigurującej połączenie.
  • Przechowywaniu Secret w bezpiecznym miejscu (menedżer haseł).
  • W przypadku podejrzenia kompromitacji kluczy, natychmiastowym utworzeniu nowych.
Cofnięcie połączenia

Jeśli chce się przejść na inną metodę łączenia lub zaprzestać korzystania z pakietu oprogramowania, można cofnąć połączenie.

  1. Zalogować się na platform.econnect.eu.
  2. Przejść do Połączenia w danej organizacji.
  3. Kliknąć połączenie, które ma być cofnięte.
  4. Kliknąć Cofnij klucz.
  5. Połączenie jest teraz nieaktywne.

Po cofnięciu można całkowicie usunąć połączenie: wrócić do przeglądu, kliknąć trzy kropki obok cofniętego połączenia i wybrać Usuń połączenie.

Połączenie należy cofnąć również w pakiecie oprogramowania. W przeciwnym razie oprogramowanie będzie nadal próbowało komunikować się za pomocą starych kluczy.

Ponowne połączenie

Chcesz połączyć się ponownie? Utwórz nowy zestaw kluczy połączenia. Stare klucze nie działają po cofnięciu.

Uwaga: w przypadku przejścia na Autopilot, należy najpierw cofnąć stare połączenie. Dwa aktywne połączenia do tej samej administracji mogą powodować konflikty.

Co dzieje się z fakturami?

Cofnięcie nie wpływa na faktury już wysłane lub odebrane. Nowe faktury nie są już wymieniane przez stare połączenie.


Gotowy do podłączenia oprogramowania? Sprawdź, która metoda integracji pasuje do Twojego pakietu.

Utwórz klucze połączenia