Subiekt nexo i sklep: diagnoza synchronizacji

Najpierw nazwij problem tak, aby druga osoba mogła go odtworzyć. Zapis o błędnym stanie jest za ogólny. Potrzebne są: indeks w Subiekcie, produkt lub wariant w sklepie, wybrany magazyn, oczekiwana wartość i wartość widoczna. Dodaj moment odczytu ze strefą czasową, ponieważ pomiędzy dwoma zrzutami mogło dojść do kolejnej sprzedaży.

Zbierz wersję Subiekta nexo, platformy sklepowej, konektora i środowiska, w którym działa jego proces. Ustal, czy błąd zaczął się po aktualizacji, zmianie uprawnień, dodaniu magazynu albo modyfikacji cennika. Korelacja czasowa jest wskazówką do sprawdzenia. Nie dowodzi jeszcze, że aktualizacja spowodowała awarię.

Opis Subiekta nexo PRO na stronie InsERT wskazuje Sferę i SDK jako możliwości wersji PRO. Wymagania licencyjne sprawdzaj jednak dla konkretnego konektora i sposobu połączenia. Nie kupuj dodatku tylko dlatego, że inna integracja potrzebowała takiej konfiguracji. Dostawca powinien wskazać zgodność wersji i potrzebny zakres uprawnień.

Oddziel pojedynczą rozbieżność od zatrzymania całego procesu. Jeżeli część operacji przechodzi, sprawdź ich wspólne cechy: magazyn, typ produktu, walutę, metodę płatności. Jeżeli nie przechodzi nic, obejrzyj ostatnie powodzenie i pierwszy błąd. Szerszy wybór architektury omawia porównanie integracji Subiekta i enova365 ze sklepem; tutaj celem jest odnalezienie miejsca konkretnej rozbieżności.

Wybierz reprezentatywny przypadek i ułóż jego historię. Potrzebujesz identyfikatora źródłowego, powiązanego identyfikatora docelowego oraz identyfikatora zadania integracji, jeśli konektor go zapisuje. Nazwa produktu nie wystarcza: może się zmienić, zawierać dopisek marketingowy lub występować w kilku kartotekach.

Porównaj moment zmiany w źródle, pobrania przez integrator, próby zapisu i potwierdzenia wyniku. Rozróżnij brak zadania, zadanie czekające, odrzucenie i zakończenie pozornie poprawne. Zielony status połączenia nie dowodzi, że konkretna pozycja została przetworzona. Również zakończony zapis może zawierać niewłaściwą wartość, jeśli mapowanie było błędne.

To wzór arkusza diagnostycznego, a nie statystyka wdrożeń KC. Zachowaj potrzebny wycinek logu, usuń dane osobowe i poświadczenia przed przekazaniem zgłoszenia. Nie wysyłaj pełnej bazy kontrahentów do osoby, która potrzebuje tylko identyfikatora operacji i kodu błędu.

Ustal osobno źródło ceny regularnej, promocyjnej, podatku, nazwy i opisu. ERP może zarządzać zapasem, a sklep promocją oraz treścią. Nie oznacza to, że wszystkie pola muszą płynąć w jednym kierunku. Potrzebna jest jednoznaczna odpowiedzialność za każde z nich i reguła rozstrzygania zmian.

Jeżeli promocja znika po synchronizacji, porównaj cenę w źródłowym cenniku z wartością wysłaną przez konektor. Sprawdź, czy pole promocji ma własne mapowanie, daty i warunek nadpisania. Ręczna poprawka w sklepie może zniknąć przy kolejnym cyklu, dlatego nie traktuj jej jako naprawy procesu. Najpierw uzgodnij, gdzie promocja ma być utrzymywana.

Przy rozbieżnej sumie zamówienia porównaj walutę, brutto lub netto, stawki podatkowe, ilości, rabaty pozycji i rabat całego koszyka. Sprawdź kolejność zaokrągleń w obu systemach. Nie zmieniaj kwoty dokumentu wyłącznie po to, aby zniknął komunikat: ustal z księgowością właściwy sposób odwzorowania transakcji i dopiero potem popraw mapowanie.

Koszt dostawy również wymaga uzgodnionego modelu. Może być odwzorowany jako odpowiednia pozycja lub inaczej, zależnie od dokumentu i integracji. Nie istnieje jedna techniczna reguła nakazująca każdemu połączeniu utworzenie identycznego towaru o nazwie dostawa. W próbie odbiorowej porównuj zarówno pozycje, jak i sumy, aby nie przeoczyć różnicy ukrytej w agregacie.

Dwie różne liczby zapasu nie zawsze oznaczają awarię. Widok ERP może pokazywać stan fizyczny, a sklep dostępność do sprzedaży według innej definicji. Sprawdź dokładną nazwę i znaczenie pola pobieranego przez konektor. Sam opis synchronizacja stanów jest niewystarczający do uzgodnienia wyniku.

InsERT rozróżnia rezerwację dostaw oraz rezerwację stanu. Dlatego nie stosuj bez sprawdzenia formuły stan minus wszystkie rezerwacje. Dokumentacja wyjaśnia mechanizmy, ale przy konkretnej wersji potrzebny jest odczyt pola wykorzystywanego przez integrację i kontrolowany scenariusz rezerwacji.

Dla wielu magazynów zapisz, które lokalizacje zasilają kanał internetowy. Towar w magazynie reklamacji, w transporcie albo przeznaczony dla innego kanału nie powinien przypadkiem zwiększać dostępności. Sprawdź też jednostkę miary i sposób prezentacji ułamkowych ilości, jeśli występują w asortymencie. Więcej o modelu zapasu zawiera zarządzanie magazynem WooCommerce.

Opóźnienie synchronizacji oceniaj razem z równoległą sprzedażą. Bufor bezpieczeństwa może być decyzją operacyjną dla wybranych pozycji, ale jedna sztuka nie jest uniwersalną wartością. Ustal go na podstawie rotacji, częstotliwości aktualizacji i akceptowanego ryzyka. Po zmianie sprawdź, czy dostępny produkt nie został niepotrzebnie ukryty i czy bufor nie jest odjęty drugi raz przez inne narzędzie.

Produkt nadrzędny w sklepie i jego warianty nie muszą odpowiadać jednej kartotece ERP. Przy rozmiarze oraz kolorze sprawdź powiązanie każdej sprzedawanej kombinacji. Zmiana SKU, ponowny import lub ręczne utworzenie produktu może zerwać wcześniejszą relację. Nie dopasowuj kartotek ponownie po podobieństwie nazw, gdy istnieje trwały identyfikator.

EAN może pomagać, ale przed użyciem jako klucza sprawdź jego kompletność i unikalność w rzeczywistych danych. Brak kodu albo ten sam kod w kilku kartotekach wymaga reguły wyjątku. Zapisz, co konektor robi z niejednoznaczną pozycją: pomija ją, zgłasza błąd czy tworzy nową. Ciche tworzenie kolejnych kartotek utrudni późniejsze uzgodnienie.

Komplet zmontowany i magazynowany jako własny produkt różni się od wirtualnego zestawu sprzedawanego ze składników. Pierwszy może mieć własny zapas. W drugim dostępność zależy od komponentów i liczby sztuk potrzebnych do zestawu. Nie narzucaj jednego modelu obu sytuacjom. Powiązania produktu omawia też poradnik pakietów i zestawów WooCommerce.

W odizolowanej próbie sprawdź wariant dostępny, niedostępny i niepowiązany oraz zestaw z brakującym składnikiem. Oceń zachowanie po zmianie mapowania, nie tylko pierwszy import. Wynik ma potwierdzać, że ten sam sprzedawany element trafia do właściwej kartoteki i że kolejna synchronizacja nie odtwarza starego błędu.

Rozpisz, które zdarzenie tworzy zamówienie w ERP, które potwierdza płatność i które inicjuje dokument. Pobranie nie ma tego samego przebiegu co przedpłata. Powstanie faktury nie oznacza nadania paczki, a numer śledzenia nie potwierdza jej fizycznego przekazania. Powiadomienia klienta powinny wynikać z odpowiedniego zdarzenia.

Dla każdego dokumentu wskaż system odpowiedzialny za jego wystawienie, numer oraz dalszy obieg. Nie oznacza to zakazu wielu prawidłowych serii numeracji w firmie. Chodzi o uniknięcie sytuacji, w której dwa procesy niezależnie wystawiają dokument dla tej samej operacji. Zasady wystawiania i korekt uzgodnij z księgowością przed zmianą wyzwalacza.

Status KSeF trzeba traktować odrębnie. Numer KSeF nie jest numerem faktury nadanym przez wystawcę, a PDF lub sam sukces połączenia HTTP nie dowodzą przyjęcia dokumentu. Ministerstwo Finansów opisuje zakres obowiązkowego KSeF; przy ustalaniu procesu sprawdź właściwy zakres oraz wyjątki. Architektury połączeń rozwija porównanie wtyczki KSeF i integracji API.

Próba powinna obejmować również anulowanie, zwrot i korektę. Testuj na danych syntetycznych w środowisku odłączonym od produkcyjnych dokumentów, poczty, płatności i KSeF. Sam napis test przy zamówieniu nie gwarantuje izolacji. Przed uruchomieniem sprawdź adresy usług oraz wyłącz wyzwalacze mogące rozpocząć rzeczywisty obieg.

Brak odpowiedzi nie oznacza braku zapisu. System docelowy mógł przyjąć zamówienie, zanim połączenie zostało przerwane. Automatyczne ponowienie utworzenia bez sprawdzenia powiązania może wtedy dodać drugi dokument. Odszukaj wynik po trwałym identyfikatorze i uzgodnij stan zadania przed jego powtórzeniem.

Zapytaj dostawcę, jak konektor rozpoznaje już wykonaną operację. Potrzebny jest mechanizm, który dla tego samego żądania nie tworzy kolejnego niezależnego wyniku, oraz historia prób umożliwiająca kontrolę. Sama deklaracja automatycznych ponowień nie odpowiada na pytanie, co się stanie po utracie potwierdzenia.

Jeśli nie działa wykonawca kolejki, sprawdź stan usługi lub harmonogramu, konto uruchomieniowe, uprawnienia oraz zapis konkretnego błędu. Nie udostępniaj pełnych uprawnień administracyjnych w ciemno. Działająca sesja operatora nie dowodzi, że proces pracujący w tle ma taki sam dostęp do danych i zasobów.

Nie resetuj całej kolejki i nie odtwarzaj całej bazy dla poprawy jednej operacji. Zabezpiecz stan, odizoluj przypadek i uzgodnij zakres ponowienia z opiekunem integracji. Po poprawce sprawdź identyfikatory, sumy i liczbę dokumentów. Jeżeli nie można ustalić, czy zapis powstał, wstrzymaj automatyczne powtórzenie do wyjaśnienia tego wyniku.

Odbiór integracji powinien obejmować wynik w obu systemach, a nie tylko uruchomiony proces. Porównaj próbkę produktów, wariantów i zamówień z różnych ścieżek. Zapisz kryteria zgodności dla ceny, magazynu, rezerwacji oraz statusu. Jeśli wartości celowo się różnią, wyjaśnij regułę i właściciela decyzji.

Monitoruj wiek najstarszego zadania, przyrost kolejki, odrzucenia i rozbieżności wykryte przy uzgodnieniu. Alarm dostosuj do częstotliwości synchronizacji i znaczenia procesu, bez przypadkowego progu dla każdego sklepu. Ustal, kto odbiera zgłoszenie i jak rozdziela problem konektora, ERP oraz platformy sklepowej.

Do zgłoszenia dołącz wersje systemów, identyfikator przypadku, czas ze strefą, oczekiwany wynik i zanonimizowany ślad błędu. Wskaż zmiany wykonane przed awarią oraz to, czego nie udało się jeszcze potwierdzić. Nie przesyłaj hasła ani pełnej bazy w treści wiadomości. Dostawca powinien dostać wystarczający materiał do diagnozy jednego przebiegu.

W ramach automatyzacji procesów i obsługi sklepów internetowych można ustalić zakres mapowania, kontroli kolejki i utrzymania po aktualizacjach. Przekaż informacje o systemach i rodzaju rozbieżności, aby określić następny krok. Opieka może obejmować małe pakiety godzinowe; odpowiedzialność i ewentualne SLA ustala się indywidualnie, odpowiednio do procesu.