Czy Subiekt GT wspiera dodatki do API REST?

Subiekt GT wspiera dodatki do API REST za pomocą modułu Subiekt GT Sfera, umożliwiającego rozbudowę o zewnętrzne integracje.

Jaką rolę pełni Sfera w integracji z Subiektem GT

Subiekt GT nie udostępnia natywnego interfejsu REST w takim znaczeniu, w jakim robią to aplikacje projektowane od początku jako usługi internetowe. Rozszerzanie programu odbywa się między innymi za pomocą modułu Subiekt GT Sfera. Sfera jest interfejsem programistycznym przeznaczonym do automatyzacji pracy z danymi i funkcjami Subiekta GT. Pozwala aplikacji zewnętrznej wywoływać operacje dostępne w programie, odczytywać informacje oraz tworzyć lub modyfikować wybrane obiekty biznesowe zgodnie z możliwościami konkretnej wersji i konfiguracji systemu.

W praktyce Sfera jest przede wszystkim warstwą programistyczną związaną z aplikacją uruchomioną w środowisku Windows, a nie gotowym publicznym endpointem HTTP. Dlatego odpowiedź na pytanie o dodatki do API REST wymaga rozróżnienia dwóch elementów: samego mechanizmu dostępu do Subiekta GT oraz dodatku, który może udostępniać ten mechanizm przez REST. Sfera może stanowić podstawę takiego rozwiązania, ale nie oznacza automatycznie, że każda instalacja Subiekta GT ma od razu własne API REST.

REST jako warstwa pośrednia nad interfejsem programu

Dodatek integracyjny może działać jako warstwa pośrednia. Odbiera żądanie HTTP, interpretuje jego metodę, adres zasobu, parametry i dane w formacie takim jak JSON, a następnie przekazuje odpowiednią operację do obiektów udostępnianych przez Sferę. Odpowiedź z Subiekta GT jest z kolei przekształcana na odpowiedź HTTP zwracaną systemowi sklepowemu, platformie sprzedażowej, aplikacji magazynowej albo innemu programowi korzystającemu z integracji. W takim modelu REST nie jest osobnym silnikiem danych Subiekta, tylko publiczną warstwą komunikacyjną dodatku.

Zakres takiego API zależy od konkretnego rozszerzenia. Jeden dodatek może obsługiwać kartoteki kontrahentów, towarów i usług, a także dokumenty handlowe, natomiast inny może ograniczać się do synchronizacji stanów magazynowych lub cen. Istotne jest również to, czy dodatek potrafi tylko odczytywać dane, czy także tworzyć i aktualizować dokumenty. Sama obecność słowa „REST” w nazwie integracji nie potwierdza jeszcze pełnej obsługi wszystkich funkcji Subiekta GT. Przed wdrożeniem należy sprawdzić dokumentację dodatku, listę endpointów, sposób uwierzytelniania oraz mapowanie pól na obiekty programu.

Warunki techniczne i ograniczenia integracji

Integracja oparta na Sferze wymaga zgodności kilku elementów: wersji Subiekta GT, zainstalowanego modułu Sfera, używanego dodatku oraz środowiska, w którym pracuje aplikacja pośrednicząca. Należy także uwzględnić dostęp do bazy danych i prawidłową konfigurację stanowiska, ponieważ dodatek może korzystać z lokalnych komponentów programu, jego bibliotek oraz mechanizmów autoryzacji. Zmiana wersji Subiekta GT albo aktualizacja dodatku może wpłynąć na działanie integracji, szczególnie gdy rozszerzenie wykorzystuje określone właściwości i metody interfejsu programistycznego.

Ważnym obszarem testów jest obsługa błędów i spójność operacji. Żądanie REST może zostać przyjęte przez warstwę integracyjną, ale odrzucone przez Subiekta GT z powodu braku wymaganego pola, nieprawidłowego symbolu towaru, konfliktu numeracji dokumentu albo ograniczeń uprawnień. Dodatek powinien więc zwracać jednoznaczne kody i komunikaty błędów, rejestrować identyfikator operacji oraz rozróżniać błąd komunikacji od błędu biznesowego. Przy synchronizacji danych trzeba dodatkowo ustalić, który system jest źródłem prawdy, jak rozpoznawane są zmiany i co dzieje się po przerwaniu operacji w połowie.

Sprawdzenie dodatku przed uruchomieniem wymiany danych

Przed rozpoczęciem pracy należy ustalić, czy wymagany jest moduł Subiekt GT Sfera, czy dodatek korzysta z niego bezpośrednio, oraz jakie funkcje są faktycznie dostępne przez REST. Warto sprawdzić dokumentację producenta rozszerzenia, wymagania licencyjne, obsługiwane wersje Subiekta GT, formaty danych, limity zapytań i sposób zabezpieczenia dostępu. Test powinien obejmować zarówno odczyt danych, jak i operacje zapisu wykonywane na kopii lub kontrolowanym środowisku. Szczególnej uwagi wymagają daty, kwoty, stawki podatku, jednostki miary, identyfikatory towarów i statusy dokumentów, ponieważ błędne mapowanie może powodować rozbieżności mimo poprawnego technicznie połączenia.

Warszawskie Pogotowie Komputerowe zajmuje się profesjonalną naprawą laptopów, komputerów PC i ich podzespołów, dlatego przy problemach z uruchomieniem Subiekta GT można sprawdzić między innymi stan systemu Windows, sterowników, dysku, pamięci operacyjnej oraz konfiguracji stanowiska. W przypadku samej integracji REST konieczne jest jednak rozdzielenie usterki sprzętowej od problemu dodatku, uprawnień, wersji Sfery lub konfiguracji aplikacji pośredniczącej. Dopiero takie rozróżnienie pozwala ustalić, czy przyczyną jest komputer, instalacja Subiekta GT, moduł Sfera, czy kod odpowiedzialny za wymianę danych.