Przejdź do głównej zawartości
P2Lab Mirakl

Order documents

Operatorzy Mirakl trzymają dla każdego zamówienia zestaw dokumentów — faktury dla klienta, korekty, listy przewozowe, faktury celne i tym podobne. P2Lab Mirakl odzwierciedla ten zestaw w Shopware na stronie szczegółów zamówienia i działa w obie strony: możesz pobrać dokument, który przysłał operator, a także wysłać własny. Plugin potrafi też automatycznie wysyłać dokumenty wygenerowane przez Shopware (na przykład fakturę PDF).

Gdzie to znaleźć

Dział zatytułowany „Gdzie to znaleźć”

Otwórz dowolne zamówienie Shopware, które zostało zaimportowane z Mirakl. Plugin dodaje zakładkę Mirakl do standardowej strony szczegółów zamówienia; wewnątrz tej zakładki znajdują się trzy pod-zakładki: Overview, Messages i Documents.

Pod-zakładka Documents pokazuje kartę zatytułowaną Documents z dwoma przyciskami na pasku narzędzi:

  • Sync — pobiera teraz aktualną listę dokumentów dla tego zamówienia od operatora.
  • Upload document — otwiera okno Upload document to Mirakl.

Co pokazuje lista

Dział zatytułowany „Co pokazuje lista”

Tabela dokumentów ma następujące kolumny:

  • File name — nazwa pliku.
  • Type — typ dokumentu. Rozpoznawane typy to między innymi Customer invoice, Customer credit note, Shipping slip, Customs invoice i Other. Każdy operator może używać dodatkowych kodów.
  • Direction — Inbound (od operatora do Shopware) albo Outbound (z Shopware do operatora).
  • Source — Auto (Shopware) (wysłany automatycznie, gdy Shopware wygenerował dokument), Manual (Shopware) (wgrałeś go przez okno Upload document) albo Mirakl sync (pobrany od operatora).
  • Status — etap w cyklu życia: Pending, Uploading, Uploaded, Synced, Downloaded, Error.
  • Size — rozmiar.
  • Created — data utworzenia.

Każdy wiersz ma akcje:

  • Download — zapisuje plik lokalnie.
  • Retry upload — pokazuje się tylko przy wierszach wychodzących, które się nie powiodły.
  • Show error details — otwiera okno z treścią odpowiedzi operatora.
  • Delete — usuwa wpis po stronie Shopware.

Wysyłanie dokumentu

Dział zatytułowany „Wysyłanie dokumentu”
  1. W pasku narzędzi kliknij Upload document.
  2. W polu Document type wybierz jeden z typów dozwolonych przez operatora.
  3. W polu Files wskaż plik lub pliki do wysłania.
  4. Kliknij Upload.

Plik zostaje zapisany jako wiersz wychodzący ze statusem Pending i wysłany do operatora w tle. Po sukcesie status zmienia się na Uploaded lub Synced.

Auto-upload z Shopware

Dział zatytułowany „Auto-upload z Shopware”

Plugin potrafi automatycznie dołączać do odpowiedniego zamówienia Mirakl pliki PDF wygenerowane w Shopware. Gdy wygenerujesz dokument Shopware (fakturę PDF, list przewozowy itp.) dla zamówienia pochodzącego z Mirakl:

  1. Plugin sprawdza mapowanie Document Auto-Upload dla danego połączenia — to tabela, która mówi „Shopware Faktura odpowiada Mirakl Customer invoice” i podobnie dla innych typów.
  2. Jeśli pasujący wpis istnieje i przełącznik auto-uploadu dla połączenia jest włączony, wygenerowany PDF trafia na listę Documents z Source = Auto (Shopware).
  3. Następnie jest wysyłany do Mirakl w tle, tak samo jak ręczny upload.

Mapowanie konfigurujesz w kreatorze konfiguracji połączenia (krok 11) albo w dowolnej chwili później przez menu kontekstowe wiersza w Mirakl → Settings → Connections → Document Auto-Upload.

Auto-upload eliminuje konieczność ręcznego klikania dla najczęstszych dokumentów (zwłaszcza faktury klienta) i zapobiega eskalacjom u operatora z powodu brakujących faktur przy dużej liczbie zamówień.

Document requests (żądania dokumentów)

Dział zatytułowany „Document requests (żądania dokumentów)”

Operatorzy mogą też wystawiać document requests — formalne prośby typu „wyślij mi deklarację celną do tego zamówienia do dnia X”. Są pobierane oddzielnie i pokazywane na własnej stronie:

  • Otwórz Mirakl Dashboard → Quick Start → Document Requests. Strona nosi tytuł Document requests (DR11).
  • Każde żądanie ma State (Staging, To process, Issued, Canceled), Type (Invoice albo Credit note), datę wymagalności i akcję Fulfill (upload PDF/cXML), która otwiera okno Fulfill document request.

Synchronizacja w tle

Dział zatytułowany „Synchronizacja w tle”

Plugin odpytuje operatora o nowe dokumenty zgodnie z harmonogramem. Domyślny interwał to 30 minut, a dokumenty dla zamówień zamkniętych są nadal synchronizowane przez 30 dni — w tym oknie zamknięte zamówienia mogą jeszcze otrzymać finalną fakturę lub korektę.

Document requests są odpytywane osobno, domyślnie raz dziennie (zgodnie z zaleceniem operatora).

Aby od razu odświeżyć pojedyncze zamówienie, użyj przycisku Sync na karcie Documents.

Pierwszy import

Dział zatytułowany „Pierwszy import”

Gdy po raz pierwszy włączasz import zamówień dla danego połączenia, plugin uzupełnia też pełną historię dokumentów dla każdego zamówienia w oknie pierwszego importu. Jeśli proces zostanie przerwany, podejmuje pracę od miejsca, w którym przerwał, a nie od początku.

Konfiguracja

Dział zatytułowany „Konfiguracja”

Otwórz Mirakl → Settings, zakładka Sync, karta Document Sync (Mirakl → Shopware):

  • Enable Order Document Sync (OR72) — domyślnie wyłączone.
  • Order Document Sync Interval — jak często pobierać nowe dokumenty. Wartości od 5 minut do 24 godzin. Domyślnie 30 minut.
  • Sync documents for closed orders (days) — przez ile dni po zamknięciu zamówienia nadal sprawdzać dla niego dokumenty. Wartości 1 / 3 / 5 / 7 / 14 / 30 dni. Domyślnie 30.
  • Enable Document Requests Sync (DR11) — domyślnie wyłączone.
  • Document Requests Sync Interval — wartości od 1 godziny do 24 godzin. Domyślnie 24 godziny.

Wskazówki

Dział zatytułowany „Wskazówki”

Powiązane tematy

Dział zatytułowany „Powiązane tematy”