Ten wpis wyjaśnia, skąd biorą się statusy zamówień w xSale przy integracji z Comarch ERP XL. Status zamówienia może zmieniać się po eksporcie zamówienia do ERP oraz później, gdy xSale sprawdza stan dokumentu ZS w Comarch ERP XL.
W tym artykule znajdziesz
- jak działa zmiana statusu zamówienia,
- które statusy ustawiasz w konfiguracji integracji,
- jakie stany dokumentu są odczytywane z Comarch ERP XL,
- jak może wyglądać typowy przebieg statusów,
- dlaczego status nie zawsze zmienia się od razu.
Jak działa zmiana statusu
Przy integracji z Comarch ERP XL xSale obsługuje status zamówienia w dwóch etapach:
- Etap eksportu zamówienia do ERP – xSale ustawia status zgodnie z konfiguracją integracji, np. gdy zamówienie jest gotowe do eksportu, trwa eksport albo eksport zakończył się błędem.
- Etap sprawdzania statusu w ERP – xSale cyklicznie odpytuje Futuriti WebService XL o stan dokumentu ZS utworzonego w Comarch ERP XL.
Oznacza to, że status w xSale nie jest jedną stałą regułą zaszytą na sztywno. Część statusów wynika z konfiguracji integracji, a część z informacji zwracanej przez WebService XL na podstawie dokumentu w ERP.
Statusy konfigurowane w xSale
Statusy dla procesu eksportu zamówienia ustawisz w kreatorze integracji Comarch ERP XL w sekcji synchronizacji zamówień.
| Ustawienie w konfiguracji integracji | Co oznacza |
|---|---|
| Status zamówienia uruchamiający eksport do ERP | Status w xSale, z którego zamówienie ma zostać wysłane do Comarch ERP XL. |
| Status zamówienia w trakcie eksportu do ERP | Status ustawiany podczas obsługi eksportu zamówienia. |
| Status zamówienia, gdy eksport do ERP zakończył się błędem | Status ustawiany, gdy eksport zamówienia do ERP zakończy się błędem. |
| Status zamówienia po poprawnym eksporcie do ERP | Status ustawiany po poprawnym utworzeniu lub obsłużeniu zamówienia w ERP. |
W praktyce nazwy statusów mogą różnić się między wdrożeniami, ponieważ użytkownik wybiera je z listy statusów dostępnych w danej instancji xSale.
Więcej o ustawieniach kreatora znajdziesz we wpisie Kreator integracji Comarch ERP XL.
Statusy odczytywane z ERP XL
Po eksporcie zamówienia xSale odpytuje Futuriti WebService XL o status dokumentu ZS w Comarch ERP XL. WebService zwraca informację o stanie dokumentu, a xSale może na tej podstawie zmienić status zamówienia.
WebService XL rozpoznaje między innymi następujące stany dokumentu:
| Stan dokumentu zwracany przez WebService XL | Znaczenie użytkowe |
|---|---|
| zapytanie | Dokument jest na bardzo wczesnym etapie obsługi w ERP. |
| oferta | Dokument ma status oferty. |
| zamowienie | Dokument funkcjonuje jako zamówienie. |
| potwierdzone | ZS jest potwierdzone w ERP. |
| zaakceptowane | ZS jest zaakceptowane w ERP. |
| w_realizacji | ZS jest w realizacji. |
| zamowienie_skompletowane | Zamówienie jest oznaczone jako skompletowane. |
| zrealizowane | Dokument został zrealizowany. |
| odrzucone | Dokument został odrzucony. |
| anul_potwierdzone / maska_anulowane | Dokument jest anulowany albo oznaczony jako anulowany. |
Na podstawie tych informacji xSale zmienia status zamówienia zgodnie z działaniem integracji i konfiguracją statusów w danym środowisku.
Przykładowy przebieg
Typowy przebieg obsługi zamówienia może wyglądać następująco:
| Zdarzenie | Przykładowy efekt w xSale |
|---|---|
| Zamówienie spełnia warunek eksportu do ERP | xSale rozpoczyna proces eksportu zgodnie z mapowaniem statusów. |
| ZS zostaje utworzone w Comarch ERP XL | Zamówienie może otrzymać status po poprawnym eksporcie, np. Zaimportowano do ERP. |
| ZS jest potwierdzane lub akceptowane w ERP | xSale może ustawić status odpowiadający etapowi realizacji zamówienia. |
| ZS przechodzi w realizację lub zostaje skompletowane | Status w xSale może przejść na etap przygotowania albo realizacji, zależnie od konfiguracji. |
| Dokument zostaje zrealizowany | xSale może zakończyć śledzenie statusu i ustawić status końcowy, np. Zrealizowane. |
| Dokument zostaje odrzucony albo anulowany | xSale może ustawić status wskazujący wstrzymanie lub anulowanie zamówienia. |
Jeżeli w Twoim środowisku statusy mają inne nazwy, sprawdź mapowanie statusów w konfiguracji integracji Comarch ERP XL.
Dlaczego status nie zmienił się od razu
xSale sprawdza status dokumentu w ERP cyklicznie. Aktualizacja statusu nie zawsze następuje natychmiast po zmianie w Comarch ERP XL.
- Dla starszych zamówień zapytania o status mogą być wykonywane rzadziej ze względu na optymalizację wydajności.
- Jeżeli WebService XL nie znajdzie dokumentu, zwraca informację o braku danych lub o tym, że plik nie został jeszcze przetworzony.
- Jeżeli dokument został usunięty w ERP po wczytaniu, xSale może otrzymać informację, że plik był wczytany, ale dokumentu nie ma już w XL.
- Jeżeli eksport zakończył się błędem, status zależy od konfiguracji statusu błędnego eksportu w xSale.
Jeżeli status nie zmienia się przez dłuższy czas, sprawdź w pierwszej kolejności, czy zamówienie ma numer dokumentu ERP, czy Futuriti WebService XL działa poprawnie oraz czy w konfiguracji integracji ustawiono właściwe statusy procesu eksportu.
