Błędy synchronizacji między sklepem internetowym a Comarch ERP XT mogą powodować podwójne zamówienia, nieprawidłowe stany magazynowe lub brakujące faktury. Szybka diagnostyka i naprawa tych problemów jest krytyczna dla ciągłości sprzedaży.
Zamówienia ze sklepu nie pojawiają się w XT
Pierwszym krokiem jest sprawdzenie, czy klucz API skonfigurowany w wtyczce sklepowej nadal jest ważny i ma odpowiednie uprawnienia. Klucze API Comarch XT mogą być zresetowane po zmianie hasła Comarch ID lub po ręcznym unieważnieniu klucza w panelu. Należy wygenerować nowy klucz i zaktualizować go w wtyczce sklepowej.
Synchronizacja się zatrzymała – brak aktywności od X godzin
Jeśli integracja działała wcześniej, a nagle przestała, sprawdź: logi błędów w panelu wtyczki sklepowej (najczęściej HTTP 401 – brak autoryzacji lub HTTP 429 – przekroczony limit zapytań API), stan serwera Comarch (status.comarch.com), oraz czy subskrypcja Comarch ERP XT nie wygasła. Wygasła subskrypcja blokuje dostęp do API.
Duplikaty zamówień lub kontrahentów
Duplikaty powstają, gdy synchronizacja działa dwukrotnie dla tego samego zamówienia – np. po ponownym uruchomieniu po błędzie. Comarch ERP XT powinien wykrywać duplikaty po numerze zamówienia ze sklepu (external_id). Jeśli integracja nie przekazuje tego numeru, każda synchronizacja tworzy nowy dokument. Należy sprawdzić w konfiguracji wtyczki, czy pole zewnętrznego ID zamówienia jest mapowane.
Nieprawidłowe stany magazynowe w sklepie
Jeśli sklep pokazuje stan „0" dla produktów, które są w magazynie XT, przyczyną jest najczęściej błąd mapowania SKU (kodu produktu) między systemami. Kod produktu w sklepie musi być identyczny z kodem towaru w XT. Rozbieżność (np. wielka/mała litera, spacja) powoduje, że synchronizacja nie rozpoznaje produktu i nie aktualizuje stanu.
Faktury nie są wystawiane automatycznie
Automatyczne wystawianie faktur uruchamia się dopiero po spełnieniu warunków: zamówienie musi mieć status opłaconego (np. „Płatność potwierdzona"), a w konfiguracji integracji musi być zaznaczona opcja Automatycznie wystaw fakturę po opłaceniu. Jeśli zamówienia trafiają do XT jako nieopłacone (COD – za pobraniem), faktura jest wystawiana po ręcznym zatwierdzeniu płatności.
