SelSup Developers

Platforma SelSup · Przewodniki

Rozszerzenia i integracje na zamówienie

Wybór między zewnętrznym serwisem backend, wbudowanym interfejsem React a serwerem lub modułem dostaw.

5 sekcjePrzewodnik dla programistów
→

Większość integracji powinna rozpocząć się jako zewnętrzna backend używając publicznego API. Wbudowany interfejs użytkownika jest odpowiedni, gdy użytkujący muszą obsługiwać funkcję bezpośrednio w SelSup.

Projektanci aplikacji i partnerzy technologiczni

01

Wybierz typ integracji

  1. 1

    Usługa zewnętrzna backend

    Najlepsze rozwiązanie jest w przypadku ERP, sklepu internetowego, WMS, BI i podobnej synchronizacji. Token pozostaje na serwerze i dane przechodzą przez API i webhooki.

  2. 2

    Rozszerzenie reakcji

    Użyj go w interfejsie użytkownika, który musi działać w SelSup i ponownie wykorzystywać wzorce interakcji produktu.

  3. 3

    Moduł SelSup

    Wymagane do głębokiego rynku lub integracji dostaw uczestniczących w wspólnych procesach tła SelSup.

i
Zacznij od cienkiego pionowego kawałka

Wdrożyć jeden pełny przepływ pracy i jego obserwability pierwszy. Dodać importu w masie, UI i więcej typów zdarzeń po uzgodnieniu jest stabilny.

02

Architektura aplikacji zewnętrznych

Zachowaj token w menedżerze sekretów i zadzwoń do SelSup tylko z Twojego backend.

Oddzielić adapter SelSup, kolejkę pracy i model domeny. Zmiany umowy API pozostają wtedy odizolowane od reszty aplikacji.

W przypadku zmian wchodzących i wychodzącich użyj skrzynki do wysyłki.

Przepływ danych · Text
SelSup webhook → inbox → domain worker → ERP/WMS
ERP/WMS change → outbox → SelSup API → reconciliation

Powiązane punkty końcowe API

GET/api/product/findPrzykład odczytu słownikaGET/api/order/findPrzykład synchronizacji wkrótce

03

Wbudowane rozszerzenie React

Komponent działa w interfejsie SelSup. Domena zewnętrzna musi zezwalać na żądania z selsup.ru i prawidłowo obsługiwać ograniczenia przeglądarki.

Nigdy nie umieszczaj trwałego tokena API w pakietze. Przeprowadź prace przywilejowe przez backend i krótkotrwałego kontekstu użytkownika zdefiniowanego przez architekturę rozszerzenia.

Zgadza się z wzorami interakcji produktu i obejmuje dostępne stany pusty, ładowania i error.

!
CORS nie jest zezwoleniem

Pozwolone źródło kontroluje dostęp do przeglądarki, ale nie uwierzytelnia użytkownika.

Komponent demo · URL
https://github.com/SelSup/component

04

Moduł integracji serwerowej

Integracja rynku obejmuje zwykle tokeny, karty, ceny, zapasy, zamówienia i aktualizacje stanu tła.

Moduł ten zmienia główny backend SelSup i następuje w procesie przeglądu, testowania, lokalizacji i uwalniania.

Konwertuj zewnętrzne awary API na stabilne wartości ApplicationError oraz odwołane lub nieważne tokeny zewnętrzne na AccessException zgodnie z zasadami projektu backend.

i
Kompatybilność danych udostępnionych

Nie dodawaj do wspólnych podmiotów pól specyficznych dla rynku, zachowaj kontrakty surowe w DTO integracyjnych i wykorzystaj je w granicach.

05

Wypłaty i eksploatacja

  1. 1

    Utworz konto testowe

    Oddzielne tokeny testowe, magazyny, produkty i zamówienia z danych dotyczących produkcji klienta.

  2. 2

    Dodaj możliwość obserwacji

    Śledź opóźnienia kolejki, błędy kodem, liczby prób ponownych i niezgodności w pojedynku.

  3. 3

    Plan migracji umowy

    Wspierać stare pola podczas przejścia i wdrażać konsumentów przed wyłączeniem starego formatu.

  4. 4

    Odłączenie dokumentu

    Użytkownicy muszą wiedzieć, jak odwołać token, usunąć węzeł internetowy i zatrzymać synchronizację bez utraty danych.