Import ZS do xSale pozwala pobierać z Comarch ERP XL zamówienia sprzedaży utworzone bezpośrednio w XL. Dzięki temu zamówienia mogą być dalej obsługiwane w xSale, na przykład w procesach związanych z realizacją lub dalszą synchronizacją.
Mechanizm dotyczy dokumentów ZS z Comarch ERP XL. Jest to osobny kierunek synchronizacji niż standardowe wysyłanie zamówień z xSale do XL.
W tym artykule znajdziesz
- Kiedy używać importu ZS
- Jak włączyć import ZS
- Jakie ZS są pobierane
- Jakie dane trafiają do xSale
- Jak działa ochrona przed ponownym importem
- Co sprawdzić, gdy ZS nie importuje się do xSale
Kiedy używać importu ZS
Import ZS jest przeznaczony dla scenariuszy, w których część zamówień powstaje najpierw w Comarch ERP XL, a następnie ma zostać przeniesiona do xSale.
Nie jest to mechanizm do ponownego pobierania zamówień, które zostały wcześniej wysłane z xSale do XL. Takie dokumenty są standardowo pomijane, aby nie wróciły do xSale jako nowe zamówienia.
Jak włączyć import ZS
Import ZS włączysz w konfiguracji integracji ERP w xSale.
Ścieżka w UI: Edycja integracji ERP → Krok 2 → Czy synchronizować zamówienia?
Po zmianie ustawienia zapisz konfigurację integracji. Jeżeli proces nie był wcześniej uruchomiony dla danej integracji, skontaktuj się z helpdesk@xsale.ai, aby potwierdzić konfigurację po stronie WebService i harmonogramu synchronizacji.
Jakie ZS są pobierane
Do xSale pobierane są dokumenty typu ZS z Comarch ERP XL, które mają pozycje dokumentu. Dokument bez pozycji nie jest traktowany jako zamówienie gotowe do importu.
Zakres pobierania może być dodatkowo ograniczony konfiguracją integracji, na przykład datą początkową synchronizacji, limitem liczby dokumentów lub dodatkowym warunkiem ustawionym w WebService.
Jeżeli dokument ZS został wcześniej utworzony w XL na podstawie zamówienia z xSale, standardowo posiada znacznik w postaci atrybutu PLIK XML. Przy imporcie ZS do xSale takie dokumenty są pomijane, żeby uniknąć zapętlenia synchronizacji.
Jakie dane trafiają do xSale
Podczas importu xSale pobiera z dokumentu ZS najważniejsze dane potrzebne do utworzenia zamówienia po stronie xSale.
- Dane nagłówka dokumentu – numer dokumentu, numer obcy, data wystawienia, opis, seria dokumentu, forma płatności i sposób dostawy.
- Dane kontrahenta – kod, nazwa, NIP, prefiks NIP, adres, kraj, telefon, e-mail oraz informacja, czy kontrahent jest podmiotem gospodarczym.
- Dane odbiorcy – dane adresu dostawy, jeśli na dokumencie wskazano odbiorcę innego niż główny kontrahent.
- Pozycje dokumentu – kod towaru, EAN, identyfikator towaru, nazwa, ilość, jednostka, cena, waluta, opis pozycji oraz dane VAT.
- Atrybuty dokumentu – jeżeli są dostępne w konfiguracji pobierania, mogą zostać przekazane razem z zamówieniem.
Jeżeli dokument w XL jest liczony od cen netto, mechanizm importu przelicza ceny pozycji na wartości brutto na potrzeby zamówienia w xSale.
Jak działa ochrona przed ponownym importem
Standardowy import ZS pomija dokumenty oznaczone w XL atrybutem PLIK XML. Ten znacznik jest używany dla dokumentów, które pochodzą z xSale, dlatego nie powinny być ponownie pobierane jako nowe zamówienia.
Jeżeli zamówienie zostało utworzone ręcznie w XL i ma zostać pobrane do xSale, nie powinno być oznaczone tym atrybutem jako dokument pochodzący z xSale.
Co sprawdzić, gdy ZS nie importuje się do xSale
Jeżeli dokument ZS nie pojawia się w xSale, sprawdź kolejno:
- czy w konfiguracji integracji w xSale jest włączona opcja Czy synchronizować zamówienia?,
- czy dokument w Comarch ERP XL jest dokumentem ZS i ma pozycje,
- czy dokument nie ma atrybutu PLIK XML, jeśli ma zostać pobrany jako zamówienie utworzone w XL,
- czy data dokumentu mieści się w zakresie pobierania ustawionym dla integracji,
- czy nie ustawiono limitu lub dodatkowego warunku pobierania, który zawęża listę dokumentów,
- czy dane kontrahenta, odbiorcy i pozycji są kompletne, szczególnie NIP, adres, kod towaru, ilość, cena i stawka VAT.
Jeżeli po sprawdzeniu tych punktów dokument nadal nie importuje się do xSale, przekaż do helpdesk@xsale.ai numer dokumentu ZS z Comarch ERP XL oraz informację, z której integracji pochodzi problem.
