Document Requests

Niektórzy operatorzy Mirakl wymagają, żeby sprzedawcy wgrywali oficjalną fakturę lub korektę dla każdego zamówienia, zamiast generować ją automatycznie z marketplace’u. Operator wysyła te jako document requests — jedno na zamówienie lub korektę — a wtyczka pobiera je od operatora i wymienia tutaj.

Ta strona pokazuje, które żądania są otwarte, w jakim stanie jest każde, oraz pozwala je zrealizować wgrywając plik PDF lub cXML bez wychodzenia z administracji Shopware.

Gdzie to znaleźć

Na Dashboard otwórz kartę Quick Start i kliknij kafelek Document Requests. Otworzy to stronę Document requests.

Co widzisz

Tytuł karty na stronie: Document requests (DR11). Kolumny:

Kolumna	Znaczenie
Request ID	Identyfikator żądania po stronie operatora.
Type	Invoice albo Credit note.
Entity type	Do czego żądanie się odnosi (typowo zamówienie).
State	Jeden z Staging, To process, Issued, Canceled.
Document number	Numer dokumentu, który Ty (lub operator) nadałeś.
Issue date	Kiedy dokument został wystawiony.
Due date	Kiedy operator oczekuje realizacji.
Last updated	Znacznik czasu ostatniej aktywności.
Connection	Do którego połączenia Mirakl należy żądanie.

Pasek boczny pokazuje:

Connection — filtruj po połączeniu Mirakl.
State — filtruj po stanie żądania.
Type — filtruj po Invoice / Credit note.
Refresh — pobiera najnowszą listę.

Synchronizacja żądań od operatora

Pasek narzędzi ma akcję Sync from Mirakl. Kliknięcie otwiera dialog Sync document requests — wybierz połączenie Mirakl, potwierdź, a wtyczka pobierze każde otwarte żądanie, które operator obecnie ma dla tego połączenia.

Document requests są też pobierane automatycznie przez zaplanowany task Document request sync (domyślnie wyłączony — włącz go w Mirakl → Settings → Sync Settings, jeśli chcesz periodyczne polling w tle).

Realizacja żądania

Wiersze w To process mają akcję Fulfill (upload PDF/cXML). Kliknięcie otwiera dialog Fulfill document request:

Document number — wymagane.
Issue date — wymagane.
Due date — opcjonalne.
Total (excl. tax) — opcjonalne.
Total tax — opcjonalne.
Files (PDF or cXML only) — sam załącznik dokumentu.

Potwierdź Fulfill, a plik trafi do operatora. Wiersz przechodzi do Issued, gdy Mirakl zaakceptuje upload.

Znaczenie stanów

Stan	Co oznacza
Staging	Operator przygotowuje żądanie — jeszcze niegotowe do działania.
To process	Gotowe do realizacji. Akcja Fulfill jest aktywna.
Issued	Zostało zrealizowane; operator ma plik.
Canceled	Operator anulował żądanie — akcja niewymagana.

Wskazówki i pułapki

Powiązane

Invoices — faktury, które wtyczka pobiera od operatora (inny przepływ)
Order documents — dokumenty przypięte do zamówienia (etykieta przewoźnika, list przewozowy itp.)
Order import — jak zamówienia w ogóle trafiają do Shopware
Settings — włącz Document request sync dla periodycznego pollingu w tle