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:

  • 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?