Stwórz własną integrację kurierską
Sello NX umożliwia tworzenie własnych integracji kurierskich w postaci plugina instalowanego na bazie danych użytkownika. Sello NX dostarcza wielu mechanizmów upraszczających tworzenie integracji, a praca z nimi w programie jest identyczna jak z integracjami wbudowanymi. Pluginy umożliwiają m.in. tworzenie i pobieranie etykiet kurierskich czy zamawianie podjazdu kuriera.
Stwórz własną integrację kurierską
Sello NX umożliwia tworzenie własnych integracji kurierskich w postaci plugina instalowanego na bazie danych użytkownika. Sello NX dostarcza wielu mechanizmów upraszczających tworzenie integracji, a praca z nimi w programie jest identyczna jak z integracjami wbudowanymi. Pluginy umożliwiają m.in. tworzenie i pobieranie etykiet kurierskich czy zamawianie podjazdu kuriera.
Funkcje Sello NX, które może obsługiwać integracja
Paczki do zamówień wysyłkowych
- Tworzenie przesyłek Generowanie przesyłek w systemie kuriera
na podstawie danych z zamówień wysyłkowych Sello NX. - Drukowanie etykiet Pobieranie etykiet na paczki z systemu kuriera i ich wydruk
dla przesyłek wygenerowanych przez Sello NX. - Drukowanie protokołu wysyłki Pobieranie protokołu nadania z systemu kuriera
i jego wydruk dla przesyłek wygenerowanych przez Sello NX. - Zamawianie kuriera Wybór terminu i zamawianie przyjazdu kuriera
po odbiór paczek utworzonych przez Sello NX. - Statusy przesyłek Pobieranie statusów przesyłek z serwisu kuriera
dla przesyłek wygenerowanych przez Sello NX.
Co daje własna integracja?
Sello NX jest aplikacją z rodziny nexo i daje pełny dostęp do API o nazwie Sfera, za pomocą której można samodzielnie wykonać dowolne wręcz rozszerzenie. W tym również rozszerzenia integrujące Sello NX lub też Subiekta nexo z systemami kurierskimi.
Sello NX wychodzi jednak dalej, umożliwiając tworzenie pluginów integracji kurierskich, które instaluje się na bazie użytkownika. W odróżnieniu od całkowicie własnych rozszerzeń sferycznych, pluginy integracji oferują wiele korzyści dla zewnętrznych autorów integracji i programistów:
- Minimalny wymagany nakład pracy, prócz konfiguracji plugina, wystarczy zapewnić translację danych pomiędzy serwisem kurierskim a dedykowanym modelem danych Sello NX
- Brak konieczności zarządzania synchronizacjami, wątkami, obsługą błędów
- Brak konieczności znajomości modelu danych nexo
- Brak konieczności znajomości API Sfera
- Brak konieczności tworzenia interfejsu użytkownika, dostarcza go Sello NX
- Wbudowane logowanie komunikacji, pozwalające analizować problemy występujące np. u klienta
- Obsługa błędów komunikacji w standardowy dla Sello NX sposób
Jak stworzyć własną integrację?
Do stworzenia integracji dla Sello NX konieczna jest podstawowa znajomość języka C# oraz umiejętność analizy dokumentacji API serwisu kurierskiego. Integracje tworzone są za pomocą środowiska Visual Studio. Dodatkowo wraz z każdą wersją nexo, a więc i Sello NX, publikowana jest nowa wersja nexo SDK, które zawiera m.in. model danych wymagany do zbudowania plugina integracji oraz rozszerzenie dla Visual Studio, które ułatwia sam proces opracowywania integracji.
W nexo SDK oraz w serwisie GitHub jest dostępny uproszczony, działający testowy plugin integracji z InPost - idealny jako:
- punkt startowy,
- wzór architektury plugina,
- gotowa baza do tworzenia integracji dla innych przewoźników.
Projekt zawiera komentarze i dobre praktyki, które pomogą zrozumieć zastosowane mechanizmy.
Dodatkowo dostępny jest także tutorial, który opisuje krok po kroku implementację tego plugina, wraz z wytłumaczeniem działania poszczególnych mechanizmów. Jeśli nie tworzyłeś nigdy pluginów dla systemu nexo, to będzie dobre miejsce na start.
Instalacja
Instalacja samego plugina na bazie danych klienta polega na uruchomieniu pliku instalacyjnego, który generowany jest przez wspomniane wyżej rozszerzenie do Visual Studio na etapie budowania kodu plugina. Można również instalować go jako pakiet rozszerzający za pomocą programu serwisowego do systemu InsERT nexo.
Po instalacji na bazie, będzie on automatycznie rozdystrybuowany do każdego Sello NX podłączonego do tej bazy w sieci lokalnej.
Pytania i odpowiedzi
Czy pluginy stworzone samodzielnie będą widoczne do pobrania na stronie sello.pl?
Obecnie nie mamy takiego gotowego mechanizmu. Rozszerzenia dla nexo (w tym pluginy integracji dla Sello NX) są dystrybuowane niezależnie od nas przez ich twórców. Sytuacja jest rozwojowa i możliwe, że pojawi się taka możliwość.
Czy InsERT pobiera opłaty za możliwość stworzenia i uruchamiania własnej integracji?
Nie. Tworzenie i instalowanie pluginów kurierskich nie podlega żadnej dodatkowej opłacie. Należy jednak pamiętać, że paczki tworzone są w kontekście zamówień wysyłkowych, które to podlegają rozliczaniu w ramach InsPunktów.
Czy za pomocą własnej integracji mogę nadawać paczki dla zamówień z różnych serwisów?
Tak. Po zainstalowaniu własnego plugina będzie on w programie dostępny i widoczny tak jak każda inna integracja kurierska tworzona przez InsERT S.A. Dostawy obsługiwane przez plugin będzie można używać w zamówieniach wysyłkowych pochodzących z różnych serwisów, z Subiektów oraz dodanych ręcznie do Sello NX.
Czy możliwe jest odinstalowanie plugina?
Korzystając z programu serwisowego do systemu Insert nexo, można z bazy usuwać różne pakiety i rozszerzenia własne, w tym pluginy Sello NX. Na tę chwilę nie ma jednak dedykowanego mechanizmu do usuwania integracji i zachowanie programu posiadającego dane plugina a nie posiadającego samego plugina może być nieprzewidziane w skutkach. Zalecamy, aby dezaktywować nieużywane integracje w module konta integracji.