Jak connector działa: pull, kolejka, heartbeat, aktualizacje
Connector pracuje w cyklu: odzywa się do Taxso, zabiera zadania i zaakceptowane dokumenty, zapisuje je w Optimie i odsyła wynik. Taxso nigdy nie łączy się do serwera biura. Ta strona tłumaczy, co znaczą Connector aktywny i Connector milczy, skąd biorą się alerty o Optimie offline, jak zaktualizować connector z panelu i co dają testy w Diagnostyka.
Pull: connector pyta, Taxso odpowiada
Każde żądanie niesie klucz connectora (Taxso trzyma tylko skrót) i identyfikator firmy; serwer biura nie potrzebuje publicznego adresu ani otwartego portu. Wszystko, co zlecasz w panelu, czeka na najbliższy cykl: przy kilku firmach pół minuty, przy dwustu bazach Optimy kilkadziesiąt minut.
Jeden cykl connectora
Krok 1
Heartbeat
Co około 30 sekund: wersja connectora i Optimy, długość kolejki, liczba udanych i nieudanych zapisów, ostatni błąd, tryb tylko do odczytu, start bieżącego cyklu.
Heartbeat, `Connector aktywny` i alerty
Dwa progi: krótki steruje plakietką, długi wysyła alert. Sygnałem jest każde uwierzytelnione żądanie, nie tylko heartbeat, więc connector zajęty długim cyklem nie „milknie”.
GdziePanel biuraUstawienia biuraPołączeniaKonfigurujConnector ERP
- Connector aktywny
- Sygnał w ciągu ostatnich 2 minut, obok
Ostatni heartbeat: …. Ten sam stan widać wUstawienia biura→Połączenia. - Connector milczy
- Ponad 2 minuty bez sygnału (około 4 przegapione heartbeaty). Diagnostyka i aktualizacja z panelu są wyłączone; dokumenty czekają w kolejce z notką
czeka na connector. - Optima offline od HH:MM
- Alert: cisza co najmniej 20 minut, sprawdzana co 5 minut, tylko 7-19 w dni robocze, jeden na incydent. Dzwonek i mail
Awaria connectora / Optimydo administratorów i księgowych. - Optima: częściowa awaria eksportu (N)
- Connector żyje, ale co najmniej 3 dokumenty biura mają
Błąd wysyłki. - Optima wróciła - connector znów online
- Zamyka incydent, wysyłane także poza godzinami pracy.
Alert offline wymienia, co sprawdzić: serwer z Optimą, usługę Morpheus, klucz connectora. Szybki rzut oka bez ustawień: ikona Odśwież: KSeF i Optima w Obiegu, wiersz Optima.
Aktualizacja z panelu
Karta Wersja connectora pokazuje W biurze: i Dostępna:. Przycisk Zaktualizuj do X i dialog Zaktualizować connector do X? → Tak, zaktualizuj. Przycisk jest nieaktywny, gdy zlecenie trwa albo connector milczy (Connector milczy - aktualizację zlecisz, gdy znów będzie aktywny.). Zlecenie jest ważne 24 godziny.
- Zlecono
Zlecono {czas}. Connector odbierze zlecenie, gdy skończy bieżącą pracę w Optimie. Cykl trwa od {czas}. Nic nie trzeba klikać ponownie.- Przyjęte
Connector przyjął zlecenie {czas} i zainstaluje wersję X. Robi to po skończeniu bieżącego cyklu pracy (trwa od …) - przy wielu firmach to bywa nawet godzina. Zapis do Optimy nie zostanie przerwany.- Za stary connector
Ten connector jest za stary, by zaktualizować się z panelu (wymaga 1.5.46). Zaktualizuj go raz ręcznie instalką powyżej.Jednorazowa instalacja na tym samym kluczu.- Z serwera
- Komenda
taxso update --apply. Taxso podaje ją w komunikatach o wymaganej wersji, np.Księgowanie zbiorcze do KPiR wymaga connectora 1.5.64 (jest X). Zaktualizuj go: taxso update --apply.
Nowe funkcje mają progi wersji; starszy connector dostaje Connector wymaga aktualizacji do wersji X.
Diagnostyka i tryb tylko do odczytu
Każdy przycisk w karcie Diagnostyka to zadanie odbierane w zwykłym cyklu. Po 3 minutach bez odpowiedzi panel pokazuje Connector nie odpowiedział w 3 minuty., ale zadanie nie przepada: wynik jest w kolejce w grupie Connector. Gdy connector milczy: Connector nie odpowiada - diagnostyka ruszy, gdy wróci.
| Przycisk | Co zwraca | Od wersji |
|---|---|---|
Stan | Wersja connectora, Wersja Optimy, Tryb tylko do odczytu, Operator Optimy, Klucz licencji Optimy, Konto Windows usługi, Architektura, Wysyłka do Optimy | 1.5.28 |
Dziennik | Ostatnie linie dziennika connectora, checkbox tylko błędy (domyślnie zaznaczony), pole Szukaj w dzienniku…. Pusto: Brak pasujących wpisów. | 1.5.28 |
Zaloguj ponownie do Optimy | Zamyka sesję connectora w Optimie i loguje od nowa, pobierając licencje modułów od nowa. | 1.5.28 |
Dlaczego tylko do odczytu? | Raport o licencjach: Połączenie z serwerem licencji (HASPConnection), Okres abonamentu (HASPKeySubscriptionPeriod), Karta operatora, Rejestr Windows. | 1.5.37 |
Zrzut API Optimy | Plik OPTIMA-COM-SURFACE.md z opisem interfejsu COM tej instalacji; przydatny przy zgłoszeniu nietypowego błędu. | 1.5.57 |
Tryb tylko do odczytu: connector czyta rejestr i deklaracje, ale nie tworzy wpisów; Stan pokazuje Tryb tylko do odczytu: włączony, a dokumenty czekają w kolejce. Kliknij Dlaczego tylko do odczytu?, usuń przyczynę w Optimie (licencja, abonament, karta operatora), potem Zaloguj ponownie do Optimy.
Limity w liczbach
- Zadania na cykl
- 3; zadanie w toku dłużej niż 15 minut wraca do puli.
- Żądania biura
- Co najmniej 600 na 5 minut, przy większym biurze 20 na firmę. Po przekroczeniu
Za dużo żądań - zwolnij i ponów.i minuta przerwy; connector wznawia sam. - Błędne uwierzytelnienia
- 20 na 5 minut z jednego adresu IP, potem 5 minut blokady.
- Samoodświeżenie rejestru
- Od 1.5.48 co 12 godzin w oknie 90 dni, dodatkowo po każdym zapisie.
Pytania z wdrożeń
Plakietka mówi „Connector milczy”, a na serwerze usługa działa.+
Typowe przyczyny: odwołany klucz (Brak lub zły X-Wise-Api-Token.), brak wyjścia do internetu z serwera, usługa zatrzymana po aktualizacji Windows. Sprawdź dziennik na serwerze.
Dlaczego alert o offline nie przyszedł w nocy?+
Watchdog alarmuje tylko 7-19 w dni robocze, żeby nie budzić zespołu restartami po godzinach. Powrót jest wysyłany zawsze, a dokumenty z nocy wejdą w pierwszym cyklu rano.
Czy connector ponawia nieudany zapis sam?+
Nie, jeśli Optima odrzuciła zapis (Błąd wysyłki): czeka na Ponów. Tak, jeśli to chwilowa blokada (Wstrzymane). Rozróżnienie: Kolejka i nieudane eksporty.