Webservice – podstawowa instalacja i konfiguracja

Webservice to łącznik pomiędzy xSale i Comarch ERP XL, który umożliwia synchronizację danych pomiędzy systemami.

W tym artykule znajdziesz

• czym jest WebService dla Comarch ERP XL
• jak przebiega instalacja WebService
• jak zaktualizować WebService
• jak działa flaga dotycząca KSeF
• o czym pamiętać podczas aktualizacji
• jak przetestować WebService po aktualizacji
• co zrobić przy błędzie not found in scheduler

Czym jest WebService

WebService dla Comarch ERP XL odpowiada za wymianę danych pomiędzy xSale i ERP. W praktyce jest to osobna usługa instalowana i konfigurowana po stronie środowiska ERP.

Instalacja WebService

1. Pobierz FuturitiWebserviceXLInstallerOne.
2. Rozpakuj paczkę i uruchom plik FuturitiWebserviceXLInstallerOne.exe.
3. Wskaż ścieżkę, w której jest zainstalowany Comarch ERP XL.
4. Kliknij Pobierz najnowszą wersję. Nie zaznaczaj opcji Pobieraj wersję preview, jeśli nie korzystasz świadomie z wersji testowej.
5. Aktualna wersja WebService zostanie pobrana do tego samego katalogu, z którego uruchamiasz instalator.
6. Po pobraniu otwórz Futuriti Instance Manager i przejdź dalej przez konfigurację instancji.
7. Jeśli korzystasz z materiału wideo, wykonuj kolejne kroki zgodnie z instrukcją.
8. W razie problemów skontaktuj się z helpdesk.

Aktualizacja WebService

Każda aktualizacja Comarch ERP XL wymaga aktualizacji Webservice do zgodnej wersji.

1. Uruchom Futuriti Instance Manager.
2. Jeżeli pojawi się informacja o dostępnej aktualizacji, wybierz opcję Tak.
3. Po zakończeniu aktualizacji Instance Managera kliknij przycisk Aktualizacja, aby zaktualizować WebService.
4. Po zakończonej aktualizacji sprawdź, czy wersja Instance Manager jest zgodna z wersją WebService.

Nowa flaga KSeF po autoaktualizacji

Po autoaktualizacji WebService dla Comarch ERP XL (od wersji 2025.1.) w konfiguracji Konfiguracja -> Wczytywanie dok. do ERP dostępna jest flaga Ustawiaj wysyłkę do KSeF na podstawie typu kontrahenta.  

Po włączeniu tej opcji ustawienie wysyłki dokumentu dla KSeF jest określone na podstawie typu kontrahenta. Dla nowych lub migrowanych ustawień opcja ta jest ustawiana domyślnie automatycznie. 

W Comarch ERP XL wysyłka faktur do Krajowy System e-Faktur (KSeF) zależy przede wszystkim od typu kontrahenta oraz jego statusu podatkowego (NIP).

Faktury są wysyłane do KSeF dla:

• Kontrahentów krajowych (Polska)
• Podmiotów posiadających NIP (B2B) (czyli: firmy, jednoosobowe działalności gospodarcze, instytucje zarejestrowane jako podatnicy VAT czynni lub zwolnieni)

Kluczowy warunek: kontrahent ma polski NIP i jest obsługiwany jako podmiot gospodarczy.

Faktury NIE są wysyłane do KSeF dla:

• Osób fizycznych (B2C, bez NIP)
• Kontrahentów zagranicznych (bez polskiego NIP)
• Podmiotów, które nie podlegają KSeF (np. niektóre szczególne przypadki eksportowe – zależnie od konfiguracji)

O czym pamiętać podczas aktualizacji

Aby WebService zapewniał poprawną wymianę danych, na wszystkich stanowiskach ERP powinna być ustawiona ta sama, zsynchronizowana data i godzina systemowa.

Aktualizując WebService, zaloguj się na użytkownika Windows z uprawnieniami administracyjnymi, który umożliwia instalowanie oprogramowania na serwerze. Zalecamy zalogowanie się na tego samego użytkownika, który jest wskazany w WebService. Użytkownika możesz sprawdzić w zakładce Harmonogram.

Proces aktualizacji może potrwać od kilku do kilkudziesięciu minut.

Test po aktualizacji

Po aktualizacji przetestuj WebService. W tym celu kliknij przycisk Testuj i przejdź przyciskiem Dalej przez kolejne kroki testu aż do końca.

Harmonogram i błąd not found in scheduler

Błąd podczas aktualizacji not found in scheduler oznacza, że WebService jest wyłączony i nie można go zaktualizować.

Aby rozwiązać ten problem:

1. Przejdź do zakładki Konfiguracja -> Harmonogram.
2. Wpisz hasło do użytkownika Windows.
3. Kliknij Utwórz nowy / aktualizuj.
4. Następnie kliknij Uruchom.
5. Gdy status zmieni się na Running, spróbuj ponownie zaktualizować WebService.