Ten wpis opisuje, co sprawdzić, gdy zamówienie jest widoczne w xSale, ale nie zostało poprawnie przekazane do systemu ERP. Najczęściej zamówienie trafia wtedy na status Do obsługi ręcznej albo przez dłuższy czas pozostaje na statusie Przetwarzane.
W tym artykule znajdziesz
- od czego zacząć diagnostykę,
- co oznaczają statusy Nowe, Przetwarzane i Do obsługi ręcznej,
- jakie problemy z WebService mogą zatrzymać import,
- co sprawdzić po stronie licencji i operatora ERP,
- jakie dane zamówienia mogą zostać odrzucone przez ERP,
- co zrobić po usunięciu przyczyny problemu.
Od czego zacząć diagnostykę
Najpierw sprawdź log zadań zamówienia. To w nim najczęściej znajduje się komunikat wskazujący, dlaczego ERP nie przyjął zamówienia albo dlaczego xSale nie mógł połączyć się z WebService.
Instrukcję włączenia i sprawdzenia logu znajdziesz we wpisie Import zamówienia do systemu ERP.
Bez komunikatu z logu można wskazać tylko ogólne przyczyny. Jeżeli zgłaszasz problem do helpdesk, dołącz ID zamówienia w xSale, nazwę integracji, system ERP oraz treść błędu z logu.
Statusy związane z importem do ERP
- Nowe – zamówienie jest gotowe do przekazania do ERP.
- Przetwarzane – xSale wykonuje operację, np. próbuje przekazać zamówienie do ERP. Ten status może być chwilowy. Jeśli utrzymuje się długo, sprawdź log i połączenie z ERP.
- Zaimportowano do ERP – zamówienie zostało poprawnie utworzone w ERP.
- Do obsługi ręcznej – import nie powiódł się i zamówienie wymaga sprawdzenia.
Jeśli zamówienie pozostaje na statusie Nowe przez długi czas i nie zostało przetworzone przez automatyzację, również wymaga sprawdzenia konfiguracji statusów i procesów.
Problemy z WebService lub połączeniem z ERP
Do przekazywania zamówień do ERP xSale korzysta z integracji i łącznika WebService. Jeśli WebService nie działa poprawnie, zamówienie może zatrzymać się na statusie Przetwarzane albo przejść do Do obsługi ręcznej.
Najczęstsze przyczyny po stronie WebService i infrastruktury:
- WebService nie jest zgodny z aktualną wersją Comarch ERP Optima lub Comarch ERP XL po aktualizacji ERP.
- Serwer, na którym działa WebService, jest wyłączony albo usługa WebService nie została uruchomiona.
- Port używany przez WebService jest zablokowany na routerze, firewallu lub zaporze systemowej.
- Antywirus blokuje działanie WebService albo usunął go z wyjątków.
- WebService został uszkodzony, usunięty albo zainstalowany wielokrotnie bez odinstalowania starszych wersji.
- Usługa odpowiedzialna za uruchamianie WebService została usunięta z harmonogramu lub nie startuje po restarcie serwera.
Po aktualizacji ERP zaktualizuj również WebService do wersji zgodnej z ERP. Po przywróceniu poprawnego połączenia zamówienia zatrzymane na statusie Przetwarzane zwykle powinny zostać przetworzone automatycznie.
Licencje i operator ERP
Jeśli xSale może połączyć się z ERP, ale ERP nie pozwala utworzyć dokumentu, przyczyną może być brak wolnej licencji albo brak uprawnień operatora używanego przez integrację.
W Comarch mogą być wymagane między innymi licencje związane z modułami handlowymi lub kasowo-bankowymi. Jeśli ERP działa w trybie tylko do odczytu albo operator nie ma dostępu do zapisu, zamówienie nie zostanie poprawnie wczytane.
Przykładowy komunikat w logu może wskazywać, że aplikacja pracuje w trybie do odczytu albo zapis jest niemożliwy. W takiej sytuacji sprawdź dostępne licencje, zalogowanych użytkowników ERP oraz uprawnienia operatora skonfigurowanego dla WebService.
Dane zamówienia odrzucone przez ERP
Część błędów nie wynika z połączenia, tylko z danych, których ERP nie może przyjąć. Wtedy log zamówienia zwykle wskazuje konkretne pole lub obszar.
Najczęstsze przykłady:
- nieprawidłowy lub zbyt długi kod pocztowy, NIP, nazwa, adres albo inne pole kontrahenta,
- brak wymaganych danych adresowych, np. numeru domu,
- brak formy dostawy, formy płatności albo mapowania wymaganego przez ERP,
- brak towaru o kodzie z zamówienia, jeśli tworzenie brakujących towarów jest wyłączone,
- towar jest zablokowany, archiwalny albo objęty remanentem,
- problem z utworzeniem lub aktualizacją kontrahenta w ERP.
Przykład dla Comarch ERP Optima: ERP może odrzucić aktualizację kontrahenta, jeśli kontrahent jest udostępniany do e-Sklepu, a wymagane pola nie są uzupełnione. W logu może pojawić się komunikat o niewypełnionym polu, np. Nr domu. Rozwiązaniem jest poprawa danych kontrahenta albo zmiana konfiguracji w ERP tak, aby kartoteka nie wymagała danych niedostępnych na zamówieniu.
Co zrobić po usunięciu przyczyny
- Usuń przyczynę błędu: popraw dane, odblokuj licencję, uruchom WebService albo zaktualizuj łącznik.
- Sprawdź log zamówienia, czy nie pojawia się kolejny komunikat błędu.
- Jeśli problem dotyczył chwilowego połączenia lub aktualizacji WebService, poczekaj na ponowne przetworzenie zamówienia.
- Jeśli zamówienie wymaga ręcznego ponowienia, wykonaj ponowienie zgodnie z konfiguracją procesu w Twojej organizacji albo zgłoś zamówienie do helpdesk.
Dla problemów specyficznych dla konkretnego ERP korzystaj z dedykowanych wpisów, np. Popularne pytania i rozwiązania problemów – Comarch ERP XL lub Popularne pytania i rozwiązania problemów – Comarch ERP Optima.