Jakie API udostępnia Subiekt GT do integracji?

Subiekt GT oferuje możliwości integracji z zewnętrznym oprogramowaniem i urządzeniami (drukarki fiskalne, kolektory danych, systemy CRM) przez dedykowane dodatki — szczegółowa lista wspieranych integracji zależy od aktualnej oferty producenta i firm trzecich tworzących takie rozszerzenia.

Czym jest API w Subiekcie GT i jakie możliwości daje

Subiekt GT nie udostępnia jednego, prostego interfejsu API rozumianego wyłącznie jako zestaw publicznych adresów internetowych do komunikacji z programem. Integracja z tym systemem opiera się przede wszystkim na mechanizmach przeznaczonych dla dodatków i aplikacji współpracujących z bazą danych oraz środowiskiem programu. W praktyce najczęściej wykorzystywana jest technologia Sfera dla Subiekta GT, która pozwala tworzyć rozszerzenia operujące na danych handlowych i magazynowych z użyciem obiektów udostępnianych przez producenta.

Za pomocą takiego interfejsu można automatyzować wybrane czynności wykonywane wcześniej ręcznie, na przykład odczytywanie kartotek towarów i kontrahentów, pobieranie dokumentów, tworzenie nowych zapisów, obsługę stanów magazynowych albo przekazywanie informacji do systemu sprzedażowego. Zakres dostępnych operacji zależy od zastosowanego dodatku, wersji programu, posiadanych licencji oraz sposobu zaprojektowania integracji. Nie każda funkcja widoczna w interfejsie użytkownika musi być dostępna w identyczny sposób dla zewnętrznej aplikacji.

Warto rozróżnić oficjalne mechanizmy rozszerzeń od nieautoryzowanego odczytu lub modyfikowania tabel bazy danych. Bezpośrednie operowanie na strukturze SQL może prowadzić do pominięcia reguł biznesowych programu, niespójności dokumentów, problemów z numeracją oraz trudności podczas aktualizacji. Bezpieczniejsze podejście polega na korzystaniu z udokumentowanych obiektów, metod i zdarzeń przewidzianych do współpracy z Subiektem GT.

Techniczny kontekst integracji z Subiektem GT

Integracja może przebiegać lokalnie, przez komponent działający na komputerze z zainstalowanym Subiektem GT, albo za pośrednictwem aplikacji pośredniczącej. W pierwszym wariancie program integracyjny korzysta z bibliotek i obiektów udostępnianych przez środowisko Sfera. W drugim dane są wymieniane między Subiektem GT a sklepem internetowym, aplikacją magazynową, systemem obiegu dokumentów lub innym narzędziem za pomocą warstwy synchronizacyjnej. Taki pośrednik może odpowiadać za kolejkę zadań, ponawianie nieudanych operacji, mapowanie pól i rejestrowanie historii wymiany danych.

Najczęściej spotykane są integracje dwukierunkowe. Z Subiekta GT mogą być pobierane między innymi nazwy produktów, symbole, ceny, stany, dane kontrahentów i informacje o dokumentach. W przeciwnym kierunku mogą trafiać zamówienia, nowe pozycje kartotekowe, dane odbiorców albo informacje potrzebne do przygotowania dokumentów sprzedaży. Każdy taki przepływ powinien mieć jasno określone źródło prawdy, ponieważ równoczesna edycja tych samych danych w kilku systemach sprzyja powstawaniu duplikatów i rozbieżności.

Nie należy utożsamiać Sfery z uniwersalnym API chmurowym. Jest to raczej programistyczny interfejs dostępu do funkcji Subiekta GT, zwykle wymagający odpowiedniej konfiguracji środowiska, zgodności wersji oraz prawidłowego dostępu do danych. Konkretna integracja może również wykorzystywać dodatkowe moduły producenta albo rozwiązania przygotowane przez niezależnego dostawcę. Przed rozpoczęciem prac trzeba więc sprawdzić, czy wymagane operacje są obsługiwane przez wybraną wersję i licencję.

Typowe problemy i błędy przy korzystaniu z interfejsu

Jednym z częstszych błędów jest założenie, że samo posiadanie Subiekta GT wystarcza do uruchomienia dowolnego połączenia z zewnętrznym systemem. W rzeczywistości znaczenie mają między innymi wersja programu, obecność właściwych komponentów, konfiguracja użytkowników, dostęp do bazy danych oraz zgodność bibliotek używanych przez aplikację integracyjną. Aktualizacja jednego elementu bez sprawdzenia pozostałych może spowodować błędy inicjalizacji, brak dostępu do obiektów albo nieprawidłowe przetwarzanie dokumentów.

Problematyczne bywa także mapowanie identyfikatorów. Ten sam produkt może mieć inny symbol w sklepie internetowym, inny kod w magazynie i odrębny identyfikator wewnętrzny w Subiekcie GT. Jeżeli mechanizm synchronizacji nie rozróżnia tych wartości, może dojść do tworzenia powielonych towarów, przypisywania zamówień do niewłaściwych pozycji lub błędnych zmian stanów. Należy również ustalić sposób obsługi usunięć, korekt, zwrotów, zmian cen, zaokrągleń i dokumentów wystawionych poza głównym obiegiem.

Ryzyko występuje również wtedy, gdy integracja nie kontroluje częściowo wykonanych operacji. Przykładowo dokument może zostać utworzony w Subiekcie GT, lecz potwierdzenie zapisu nie dotrze do systemu nadrzędnego. Ponowienie całej operacji bez identyfikatora transakcji może utworzyć drugi dokument. Dlatego przydatne są logi, znaczniki synchronizacji, mechanizm idempotencji, kopie bezpieczeństwa oraz testy na oddzielnym środowisku. Bezpośrednia ingerencja w bazę danych, omijanie walidacji i wyłączanie kontroli błędów powinny być traktowane jako rozwiązania wysokiego ryzyka.

W integracjach znaczenie ma też sposób przechowywania danych uwierzytelniających oraz zakres uprawnień użytkownika technicznego. Dostęp powinien być ograniczony do operacji wymaganych przez konkretny proces, a błędy komunikacji powinny być zapisywane bez ujawniania haseł i innych poufnych informacji. Przed wdrożeniem warto przygotować scenariusze testowe obejmujące zarówno poprawne zamówienia, jak i sytuacje nietypowe, takie jak brak towaru, anulowanie, powtórne wysłanie tego samego rekordu czy chwilowa niedostępność bazy.

Kiedy warto zgłosić integrację do serwisu - Jakie API udostępnia Subiekt GT do integracji

Wsparcie serwisowe może być potrzebne, gdy Subiekt GT działa poprawnie podczas zwykłej pracy, lecz zewnętrzna aplikacja nie może nawiązać połączenia, nie odczytuje danych albo zgłasza błędy przy zapisie dokumentów. W pierwszej kolejności należy ustalić, czy problem dotyczy samego programu, komponentu integracyjnego, konfiguracji bazy, uprawnień systemowych, sieci lokalnej czy błędnego mapowania danych. Takie rozdzielenie przyczyn ułatwia dobranie właściwej metody naprawy i ogranicza ryzyko przypadkowej modyfikacji danych handlowych.

Do serwisu warto zgłosić również sytuację, w której integracja zaczęła działać nieprawidłowo po aktualizacji programu, zmianie komputera, przeniesieniu bazy albo instalacji nowego dodatku. Przydatne jest przekazanie opisu objawu, momentu jego wystąpienia, nazwy używanego rozszerzenia, informacji o kierunku synchronizacji oraz przykładowego rekordu, na którym pojawia się błąd. Jeżeli problem dotyczy dokumentów lub kartotek, przed dalszymi próbami należy zabezpieczyć kopię danych i nie wykonywać wielokrotnych operacji na żywej bazie bez kontroli rezultatu.

W Warszawie taką diagnostykę sprzętu i środowiska pracy można powierzyć Warszawskiemu Pogotowiu Komputerowemu 24/7, zwłaszcza gdy kłopot z integracją łączy się z awarią komputera, systemu operacyjnego, dysku, sieci lokalnej lub urządzeń współpracujących z Subiektem GT. Przed rozpoczęciem naprawy można określić, czy źródłem trudności jest warstwa sprzętowa, konfiguracja stanowiska czy samo rozszerzenie integracyjne.