Integracje

⌘K
  2. Strona główna
  4. Integracje
  6. ERP – Integracja z Comarc...
  8. Futuriti WebService — Com...
  10. Import rezerwacji odbiorcy do xSale

Import rezerwacji odbiorcy do xSale

Import rezerwacji odbiorcy pozwala pobierać dokumenty RO z Comarch ERP Optima do xSale jako zamówienia. Dzięki temu zamówienia utworzone w Optimie mogą trafić na listę zamówień w xSale i być dalej obsługiwane przez procesy automatyczne.

Mechanizm działa przez WebService Optimy. xSale pobiera dokumenty RO, przepisuje dane kontrahenta, odbiorcy, formę płatności, sposób dostawy, pozycje dokumentu i atrybuty dokumentu.

W tym artykule znajdziesz

Jak włączyć import RO do xSale?

  1. W xSale przejdź do Konfiguracja → Ogólne → Integracje.
  2. Edytuj integrację z Comarch ERP Optima.
  3. Ustaw status, na który mają trafiać importowane zamówienia, np. Nowe.
  4. Kliknij Zapisz i przejdź do instalatora.
  5. W drugim kroku instalatora, w sekcji Zamówienia, zaznacz Czy synchronizować zamówienia?.
  6. W polu Synchronizuj zamówienia od daty ustaw datę, od której xSale ma rozpocząć pobieranie RO.
  7. Przejdź przez kolejne kroki instalatora i na końcu kliknij Zapisz.

Data w polu Synchronizuj zamówienia od daty powinna być zapisana w formacie daty i godziny, np. 01.01.2026 00:00:01. W standardowym działaniu klient WebService pobiera zamówienia z ostatnich 14 dni, dlatego ustawienie bardzo odległej daty nie jest sposobem na pobranie starszych RO.

Konfiguracja synchronizacji zamówień z Comarch ERP Optima do xSale

Jakie RO są pobierane z Optimy?

Standardowo xSale pobiera z Optimy dokumenty typu RO, czyli rezerwacje odbiorcy, które spełniają warunki importu:

  • dokument ma typ RO w Comarch ERP Optima,
  • data dokumentu mieści się w zakresie pobierania ustawionym w integracji,
  • dokument nie ma uzupełnionego atrybutu PLIK XML, który oznacza dokument pochodzący z wcześniejszego eksportu/importu xSale,
  • dokument spełnia dodatkowy warunek SQL, jeśli taki warunek został wpisany w konfiguracji WebService.

Sam status bufora RO nie jest w standardowym zapytaniu jedynym warunkiem pobrania. Jeżeli chcesz pobierać tylko wybrane RO, użyj dodatkowego warunku SQL w WebService.

Jakie dane muszą być uzupełnione na RO?

Aby RO mogło zostać poprawnie przeniesione do xSale, dokument powinien mieć uzupełnione dane potrzebne do utworzenia zamówienia:

Brak ulicy a kontrahent „Nieokreślony”

Brak ulicy na zamówieniu nie blokuje importu RO z Comarch ERP Optima do xSale. Zamówienie może zostać pobrane bez uzupełnionej ulicy, jeżeli pozostałe dane pozwalają na jego obsługę.

Nie należy jednak pobierać RO wystawionych na kontrahenta „Nieokreślonego”, który nie ma żadnych danych adresowych: ulicy, miasta ani kodu pocztowego. Takie zamówienia nie będą prawidłowo obsłużone i mogą powodować problemy z przetwarzaniem kolejnych zamówień.

  • dane nabywcy i odbiorcy, w tym nazwa oraz dane adresowe,
  • forma płatności z dokumentu,
  • pozycje dokumentu powiązane z towarami w Optimie,
  • kod towaru na pozycjach dokumentu, ponieważ pozycje bez kodu towaru są pomijane przy budowaniu zamówienia dla xSale,
  • ilość, jednostka, cena i stawka VAT na pozycjach.

WebService pobiera również atrybuty dokumentu. Jeżeli w procesie używany jest punkt odbioru, np. dla Paczkomatu InPost, wartość powinna być uzupełniona na RO jako odpowiedni atrybut dokumentu zgodny z konfiguracją integracji.

Jak ograniczyć import do wybranych RO?

Import RO można ograniczyć w konfiguracji WebService, w zakładce Eksport zamówień, w polu Dodatkowy warunek SQL. Warunek jest dopisywany do zapytania pobierającego RO z Optimy.

Przykład: jeżeli chcesz, aby xSale nie pobierał RO z atrybutem Sync xSale ustawionym na NIE, możesz użyć warunku:

AND Trn_TrnId IN
(SELECT Trn_TrnId
FROM CDN.TraNag WITH(NOLOCK)
LEFT JOIN CDN.DokAtrybuty xmlAtr WITH(NOLOCK) ON TrN_TrNID = xmlAtr.DAt_TrNId AND xmlAtr.DAt_Kod = 'PLIK XML'
LEFT JOIN CDN.DokAtrybuty syncxSaleAtr WITH(NOLOCK) ON TrN_TrNID = syncxSaleAtr.DAt_TrNId AND syncxSaleAtr.DAt_Kod = 'Sync xSale'
WHERE
TrN_TypDokumentu = 308
AND (xmlAtr.DAt_WartoscTxt IS NULL)
AND (syncxSaleAtr.DAt_TrNId IS NULL OR syncxSaleAtr.DAt_WartoscTxt = 'TAK')
)
Dodatkowy warunek SQL w konfiguracji WebService dla importu RO do xSale

Po dodaniu albo zmianie warunku SQL zapisz konfigurację i zrestartuj WebService.

W powyższym przykładzie działanie jest następujące:

  • RO z atrybutem Sync xSale i wartością NIE nie zostanie pobrane do xSale,
  • RO bez tego atrybutu albo z wartością TAK może zostać pobrane, jeśli spełnia pozostałe warunki importu.

Co sprawdzić, jeśli RO nie importuje się do xSale?

  • Czy w integracji włączono opcję Czy synchronizować zamówienia?.
  • Czy data RO mieści się w zakresie pobierania ustawionym w integracji.
  • Czy RO nie ma uzupełnionego atrybutu PLIK XML.
  • Czy dodatkowy warunek SQL w WebService nie wyklucza tego dokumentu.
  • Czy RO ma uzupełnione dane odbiorcy i pozycje z kodami towarów.
  • Czy po zmianach w konfiguracji zapisano ustawienia i zrestartowano WebService.

Czego brakuje w tym artykule?