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?
• Jakie RO są pobierane z Optimy?
• Jakie dane muszą być uzupełnione na RO?
• Jak ograniczyć import do wybranych RO?
• Co sprawdzić, jeśli RO nie importuje się do xSale?

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.

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')
)

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.