Integracje
Integracja helpdesku z WMS, ERP i platformą sklepu: bezpieczny model danych
Jak projektować integrację helpdesku z systemami commerce: źródła prawdy, API, normalizacja, tryb read-only, błędy i bezpieczne akcje operacyjne.
Zespół produktowy Faboxi · 8 min czytania ·
Odpowiedź w skrócie
Helpdesk nie powinien przejmować prawdy o zamówieniu ani łączyć się bezpośrednio z bazą WMS lub sklepu. Bezpieczny model wykorzystuje wersjonowane API i konektory, mapuje fakty do wspólnego modelu, pokazuje stan źródła i zaczyna od dostępu read-only. Każda akcja zmieniająca zamówienie wymaga podglądu, uprawnienia, idempotencji, audytu i potwierdzenia systemu commerce.
Najpierw ustal właściciela każdego rodzaju danych
Helpdesk jest właścicielem rozmowy, statusu sprawy, przypisania, SLA i decyzji operatora. Platforma sklepu, ERP, WMS, system płatności lub fulfillment pozostaje właścicielem odpowiednich faktów commerce. Ten podział ogranicza duplikowanie danych i sprzeczne statusy.
Dlaczego konektor jest lepszy niż bezpośredni odczyt bazy
- API ma jawny, wersjonowany kontrakt.
- Uprawnienia można ograniczyć do konkretnego workspace i zakresu danych.
- Błędy oraz opóźnienia są widoczne i obsługiwalne.
- Dostawcę można wymienić bez zmiany całego workflow operatora.
- Sekrety integracji pozostają po stronie serwera i są izolowane dla klienta SaaS.
Normalizacja bez udawania, że wszystkie systemy mówią to samo
Wspólny model powinien zachować znaczenie faktów, ale nie wymyślać brakujących danych. Jeśli dostawca nie zwraca terminu doręczenia, pole pozostaje nieznane lub nieobsługiwane. Surowy status może pozostać w diagnostyce, lecz nie powinien samodzielnie sterować odpowiedzią dla klienta.
Bezpieczna ścieżka od podglądu do akcji
- Read-only: operator widzi kontekst bez możliwości zmiany zamówienia.
- Preview: system wylicza, czy akcja jest dozwolona i jaki będzie jej efekt.
- Confirm: uprawniona osoba zatwierdza dokładnie opisany skutek.
- Execute: konektor wysyła idempotentne żądanie.
- Audit: wynik i potwierdzenie dostawcy pozostają w historii sprawy.
Narzędzia decyzyjne
Macierz odpowiedzialności za dane
Zanim wybierzesz technologię integracji, przypisz właściciela każdego faktu. Kopia w helpdesku jest kontekstem roboczym, nie nowym źródłem prawdy.
| Fakt | Właściciel | Rola helpdesku |
|---|---|---|
| Rozmowa, przypisanie, SLA | Helpdesk | Utrzymuje historię i workflow. |
| Płatność i zamówienie | Platforma sklepu / ERP | Pokazuje znormalizowany, oznaczony czasem fakt. |
| Kompletacja i wysyłka | WMS / fulfillment | Udostępnia kontekst i stan źródła. |
| Refundacja lub anulowanie | Uprawniony system commerce | Przygotowuje podgląd i zapisuje potwierdzony wynik. |
Testy awarii, które integracja musi przejść
Integrację oceniaj także wtedy, gdy coś nie działa. Stan poprawny jest tylko jednym z przypadków produkcyjnych.
| Awaria | Bezpieczne zachowanie | Niedopuszczalne zachowanie |
|---|---|---|
| Timeout dostawcy | Oznacz dane jako niedostępne i zachowaj workflow rozmowy. | Pokazuj cache bez wieku jako aktualny. |
| Częściowa odpowiedź | Wskaż, które powierzchnie są pewne, a które nie. | Traktuj cały rekord jako kompletny. |
| Ponowienie akcji | Ten sam klucz idempotencji i odczyt wyniku. | Druga refundacja lub anulowanie. |
| Brak potwierdzenia | Status niepewny i ręczna weryfikacja. | Komunikat dla klienta, że akcję wykonano. |
Najczęstsze pytania
Czy Faboxi łączy się bezpośrednio z bazą WMS?
Nie. Dane commerce mają przepływać przez konektory i wersjonowane API, bez bezpośredniego dostępu Faboxi do baz WMS lub CMS.
Po co tryb read-only?
Pozwala zweryfikować jakość danych i workflow operatora bez ryzyka zmiany zamówień podczas pierwszego etapu wdrożenia.