Integracja Comarch ERP XL ze sklepem internetowym to jeden z najbardziej złożonych obszarów konfiguracyjnych, gdzie błędy synchronizacji mogą skutkować sprzedażą towaru bez pokrycia w magazynie lub nieprawidłowymi fakturami. Szybka diagnoza i naprawa błędów integracji jest krytyczna dla ciągłości sprzedaży online.
Typowe błędy synchronizacji zamówień
Najczęstsze błędy przy imporcie zamówień ze sklepu do XL: brak kartoteki kontrahenta (nowy klient, NIP nieweryfikowalny), brak kartoteki towaru dla kodu SKU z zamówienia, błędna stawka VAT dla zamówienia z zagranicznego sklepu (OSS), oraz błąd mapowania metody dostawy na towar-usługę w XL. Każdy z tych błędów blokuje import konkretnego zamówienia – system loguje błąd i oznacza zamówienie jako nieprzetworzone.
Synchronizacja stanów magazynowych nie działa
Jeśli stany w sklepie nie są aktualizowane po zmianach w XL, sprawdź: czy usługa synchronizująca (agent integracyjny) jest uruchomiona na serwerze, czy klucz API sklepu jest ważny i ma uprawnienia do zapisu stanów, oraz czy kody SKU w katalogu XL są identyczne z kodami produktów w sklepie. Różnica w kodach (np. wielka/mała litera) uniemożliwia mapowanie produktu – dla sklepu produkt jest „nieznany" i stan nie jest aktualizowany.
Duplikaty dokumentów po restarcie integracji
Po przerwie w działaniu agenta integracyjnego i jego ponownym uruchomieniu może dojść do ponownego przetworzenia zamówień, które były już zaimportowane. Ochroną jest mechanizm idempotentności – agent powinien sprawdzać, czy zamówienie (po zewnętrznym ID) jest już w XL przed jego utworzeniem. Jeśli mechanizm ten nie jest wdrożony, duplikaty należy ręcznie usunąć i wdrożyć idempotentność w logice agenta integracyjnego.
Błędy fakturowania zamówień
Jeśli integracja automatycznie wystawia faktury w XL po opłaceniu zamówienia, błędy fakturowania mogą dotyczyć: brakującego adresu NIP (zamówienie od firmy bez podanego NIP), przekroczenia limitu kredytowego kontrahenta (blokada sprzedaży w XL) lub braku cennika dla danej grupy klientów. Błędy fakturowania powinny generować alert i trafiać do kolejki ręcznego przetworzenia, aby żadne zamówienie nie zostało pominięte.
Testy integracji po aktualizacji systemu
Po każdej aktualizacji Comarch ERP XL należy przetestować integrację ze sklepem: złożyć zamówienie testowe, sprawdzić poprawność jego importu do XL, zweryfikować wystawioną fakturę i potwierdzić aktualizację stanu magazynowego po wystawieniu dokumentu rozchodu. Aktualizacje XL mogą zmienić strukturę API lub zachowanie metod, co może nieoczekiwanie zepsuć działającą integrację.
