Import zamówień z marketplace

Zamówienia trafiają do systemu wyłącznie przez odpytywanie marketplace'u. Nie ma powiadomień od kanałów — nic nie przychodzi „samo" w momencie zakupu.

Krok po kroku

Sprawdzić, kiedy ten kanał ostatnio pobierał zamówienia

1. Menu Integracje → Integracje, zakładka Moje integracje, otwórz połączenie.
2. W nagłówku, wśród kafelków, jest Ostatnia synchr. z datą i godziną. To najszybszy odczyt.
3. Dokładniejszy podgląd: etap Zaawansowane, sekcja Daty synchronizacji (oznaczona znacznikiem Admin). Ma dwa wiersze: Ostatnie pobranie zamówień i Ostatnia synchronizacja ofert, każdy z datą.
4. Kreska zamiast daty w wierszu Ostatnie pobranie zamówień znaczy, że import nigdy nie ruszył dla tego połączenia. Na świeżym wdrożeniu to najczęstsza odpowiedź na „nic nie przychodzi".

Przeciągnąć okno importu wstecz

1. Ta sama sekcja Daty synchronizacji. Przy każdym wierszu są trzy przyciski: -1h, -1d i -7d.
2. Cofają one znacznik ostatniego pobrania, więc następny przebieg spojrzy dalej wstecz i wciągnie zamówienia, które wcześniej wypadły z okna.
3. To narzędzie administracyjne — dlatego sekcja ma znacznik Admin. Nie klikaj go, żeby „przyspieszyć" import; on nie uruchamia niczego od razu, tylko poszerza zakres następnego przebiegu.
4. Jeśli data sama nie rusza do przodu przez wiele przebiegów, cofanie jej nic nie da. Znacznik jest wtedy trzymany pod jednym zamówieniem, które w każdym przebiegu nie wchodzi (błąd importu). Najpierw znajdź i napraw to zamówienie w module Zgłoszenia, w razie potrzeby z pomocą wsparcia NOXTI, potem data ruszy sama. Dla Shopera szersze okno ma cenę: każde zamówienie w oknie to osobne zapytanie do sklepu o pozycje, więc bardzo szerokie okno może nie zmieścić się w limicie czasu przebiegu. System pomija już zamówienia, które ma w tym samym statusie i z tą samą kwotą, ale pierwszy przebieg po cofnięciu i tak jest ciężki.
5. Zapis poprosi o kod 2FA.

Ustawić zachowanie importu dla kanału

1. Na ekranie połączenia wejdź na etap Zamówienia. Podpowiedź etapu brzmi: „Jak zamówienia z integracji trafiają do WMS i jak ich statusy odwzorowują się na Twoje."
2. Ustawienia są pogrupowane w sekcje. Reguły importu siedzą w Importuj zamówienia z marketplace („Reguły pobierania zamówień, w tym obsługa zamówień nieopłaconych"), obsługa niezapłaconych w Nieopłacone zamówienia, a potwierdzanie, statusy, faktury i numery śledzenia w Ustawienia Marketplace.
3. Zestaw dostępnych pól różni się między kanałami — to dane, nie kod ekranu. Jeśli szukasz konkretnego parametru, użyj pola Szukaj ustawienia… nad listą etapów (Kanał sprzedaży — integracja, połączenie i ustawienie).
4. Zmiany zatwierdzasz przyciskiem Zapisz zmiany na pasku u dołu; zapis poprosi o kod 2FA.

Sprawdzić, co przyszło

1. Otwórz Konsola synchronizacji — gdzie zobaczyć, co się dzieje i przejdź na etap Zamówienia.
2. Tabela ma kolumny Numer w kanale, Numer w systemie, Status, Status u nich i Kiedy. Kolumna Status u nich to wartość surowa z marketplace'u, Status — twoja po przetłumaczeniu.
3. Osobna tabela mapowania statusów pokazuje pary W kanale → W systemie. Zamówienie ze statusem, którego nie ma w tej tabeli, wpada po cichu w wartość domyślną — patrz Statusy zamówień z marketplace — mapowanie w obie strony.

Gdy zamówienia nie przychodzą

Poprawna konfiguracja połączenia nie wystarczy — import musi być uruchamiany cyklicznie. Jeśli daty synchronizacji nie zmieniają się i nie pojawiają się nowe zamówienia, sprawdź zgłoszenia oraz skontaktuj się ze wsparciem NOXTI.

Co decyduje o imporcie

Automatyczne dodawanie produktów — z rozwagą

Włączone sprawia, że nieznany produkt z zamówienia zakłada nową kartotekę. Chroni przed zamówieniem zablokowanym z powodu brakującego indeksu, ale zaśmieca katalog przy niedopilnowanym mapowaniu. Włączaj świadomie i przeglądaj, co powstaje.

Status przy imporcie

Status marketplace'u tłumaczony jest na twój przez tabelę mapowań. Nieznany status ląduje po cichu w default — patrz Statusy zamówień z marketplace — mapowanie w obie strony. Po podłączeniu nowego kanału wróć do tej tabeli po kilku dniach.

Zamówienia wieloparczkowe

Przy wysyłce z kilku paczek część konektorów przekazuje na marketplace tylko jeden numer przesyłki — pozostałe przepadają, mimo że wysyłka jest odnotowana jako wykonana. Jeśli klienci z danego kanału zgłaszają brak numeru dla drugiej paczki, to jest wyjaśnienie.

Kaufland: anulowania i numery przesyłek

• Całe zamówienie anulowane na Kauflandzie jest przy najbliższym imporcie anulowane także w systemie (o ile status cancelled jest w tabeli mapowań przypisany do statusu anulowanego). Zamówienie jest „anulowane" dopiero, gdy anulowano każdą jego pozycję — gdy część już wyjechała, zostaje status tej wysłanej.
• Anulowana część zamówienia (np. 1 z 2 sztuk) zmniejsza ilość na pozycji i przycina kolejkę kompletacji. Jeśli kompletacja albo pakowanie tej pozycji już ruszyły, całe zamówienie wypada z kolejki (spakowane zostaje), a towar wraca na lokalizację zbiorczą; zamówienie wraca do kolejki z nowymi ilościami w następnym cyklu. Zwrot po doręczeniu kolejki nie rusza. Uwaga: automatyczny import domyślnie nie odświeża pozycji zamówienia (żeby nie przywracać pozycji usuniętych ręcznie). Wyjątek: gdy marketplace zmieni pozycje (produkt, ilość albo cenę) od ostatniego importu, najbliższy import sam pobiera pozycje i usuwa nadmiar — to samo robi ręczne odświeżenie z produktami albo sekcja products w ustawieniu orders_auto_refresh_sections.
• Zmiana pozycji po spakowaniu. Gdy marketplace zmieni pozycje zamówienia, które jest już spakowane, system nie zmienia pozycji. Zakłada zgłoszenie „Marketplace changed the order lines after packing" — porównaj zamówienie z marketplace i w razie potrzeby zatrzymaj wysyłkę. Zamówienia zaimportowane przed wprowadzeniem tej funkcji dostają tylko punkt odniesienia przy pierwszym imporcie po wdrożeniu — nic się im nie zmienia.
• Paczki u różnych przewoźników w jednym zamówieniu: Kaufland przyjmuje jednego przewoźnika na pozycję, więc system odmawia wysłania numerów z błędem (liczą się tylko paczki, których numer jeszcze nie poszedł). Numery trzeba wtedy podać w panelu Kauflanda.
• Gdy na Kauflandzie żadna pozycja nie czeka już na wysyłkę (wysłana, doręczona, anulowana), numer nie jest wysyłany i system go nie oznacza jako przekazany — ręczne wysłanie odpowiada „pominięto". Numer dodatkowej paczki do już wysłanego zamówienia trzeba podać w panelu Kauflanda.
• Anulowanie z systemu, gdy któraś pozycja na Kauflandzie nie ma identyfikatora, kończy się błędem: resztę trzeba anulować w panelu Kauflanda.

OTTO: sztuki, anulowania i kwota

OTTO prowadzi zamówienie po sztukach: każda sztuka to osobna pozycja ze swoim stanem realizacji.

• Anulowana sztuka (CANCELLED_BY_PARTNER albo CANCELLED_BY_MARKETPLACE) wchodzi do systemu z ilością 0 i jako anulowana. Nie liczy się do kwoty zamówienia i numer przesyłki jej nie obejmuje — OTTO odrzuciłoby całą wysyłkę. Przycinanie kolejki kompletacji działa tak jak na Kauflandzie: przy ręcznym odświeżeniu z produktami albo gdy połączenie ma w orders_auto_refresh_sections sekcję products. Pozycja z ilością 0 nie trafia do kolejki kompletacji i nie zmienia typu zamówienia (jedna żywa sztuka to nadal SINGLE).
• Całe zamówienie anulowane jest przy najbliższym imporcie anulowane także w systemie, jeśli statusy CANCELLED_BY_PARTNER i CANCELLED_BY_MARKETPLACE są w tabeli mapowań przypisane do statusu anulowanego. Bez tego wpisu wpadają po cichu w wartość domyślną. Takie zamówienie, którego jeszcze nie ma w systemie, nie jest zakładane.
• Kwota zamówienia to suma nieanulowanych sztuk plus wszystkie opłaty za dostawę. Wcześniej dostawa nie wchodziła do kwoty, więc suma pozycji nie zgadzała się z zapłatą i potwierdzenie zamówienia stawało.
• Zamówienie, w którym żadna sztuka nie ma czytelnej ceny, nie jest importowane jako zamówienie za zero — import się zatrzymuje na nim i ponawia w następnym cyklu; powód jest w logu workera.
• Ręczne odświeżenie zamówienia z OTTO szuka go po identyfikatorze zamówienia w OTTO (salesOrderId), nie po numerze widocznym dla klienta.
• Numer przesyłki idzie na OTTO jeden na zamówienie. Numer drugiej paczki trzeba podać w panelu OTTO.

Płatności

Część kanałów pozwala sprawdzić opłacenie zamówienia i przeprowadzić je automatycznie do kolejnego statusu. Reszta wymaga potwierdzenia ręcznego.

Potwierdzenie to nie zapłata

Potwierdzenie zamówienia na marketplace nie oznacza, że pieniądze wpłynęły. To dwa osobne zdarzenia i na części kanałów zachodzą w odwrotnej kolejności, niż podpowiada intuicja.

Na Empiku i Modivo klient jest obciążany dopiero po tym, jak sprzedawca zaakceptuje zamówienie. Czyli:

zamówienie wpada  →  my akceptujemy  →  ~45 sekund  →  marketplace obciąża klienta
                                                        ↑
                                             dopiero TU zamówienie jest opłacone

Dlatego świeżo zaakceptowane zamówienie z tych kanałów przez chwilę stoi w statusie dla nieopłaconych — i tak ma być. Wychodzi z niego samo, przy najbliższym imporcie po obciążeniu (cykl importu to zwykle kilka minut).

Jeśli zamówienie stoi tam dłużej niż kilkanaście minut, to znaczy, że marketplace nie pobrał pieniędzy. Najczęściej odrzucona karta. Takie zamówienie ma zostać w poczekalni — nie wypuszczaj go ręcznie „żeby poszło", bo towar wyjedzie za darmo. Wersja skrajna zdarzyła się naprawdę: dwa zamówienia Empika zostały skompletowane i spakowane, mimo że klient nigdy nie zapłacił.

Uwaga praktyczna: te same kanały wydają dane kupującego — telefon i adres — również dopiero przy obciążeniu. Zamówienie, za które nie zapłacono, nie ma z czego wydrukować naklejki i zatrzyma się na pakowaniu z błędem o brakującym telefonie albo kodzie pocztowym. To ten sam brak pieniędzy widziany z drugiej strony, nie osobna usterka.

Empik, dostawa kurierem. Zamówienie do punktu (salon Empik, paczkomat) ma nazwę punktu już przed akceptacją, więc wpada do systemu i dopiero wtedy je akceptujemy. Zamówienie kurierskie przed akceptacją nie ma ani punktu, ani adresu — nie ma z czego zbudować zamówienia. Dlatego przy włączonym auto_confirm system akceptuje je w Empiku od razu przy pobieraniu, zanim trafi do systemu. Empik obciąża klienta, wydaje adres, a zamówienie wpada przy następnym imporcie. Przy wyłączonym auto_confirm takie zamówienie trzeba zaakceptować ręcznie w panelu Empiku — dopóki tego nie zrobisz, nie pojawi się w systemie (i nie blokuje importu pozostałych). Zamówienie odrzucone w Empiku (ręcznie albo po terminie akceptacji), którego nie ma w systemie, jest pomijane — nie ma czego wysyłać. Odrzucone albo anulowane zamówienie, które już jest w systemie, nadal przychodzi i jest anulowane w systemie, jeśli status REFUSED/CANCELED jest w tabeli mapowań przypisany do statusu anulowanego — tak samo jak na Modivo. Gdy kompletacja lub pakowanie już ruszyły, system nie anuluje sam, tylko zakłada zgłoszenie. Wysyłka zamówienia, którego Empik nie przyjął albo anulował, kończy się błędem zamiast cichego „już wysłane”. Takiego zamówienia system nie oznaczy jako potwierdzone, nawet jeśli spróbuje je zaakceptować po fakcie — reguły uruchamiane potwierdzeniem (zamówienie kuriera, dokument do ERP) nie ruszą dla zamówienia, którego Empik nie przyjął.

Kanał ręczny

Kanał Ręczny niczego nie odpytuje. Służy do wprowadzania zamówień spoza integracji tak, by przeszły normalną drogą magazynową.