Enums

P2Lab Mirakl używa wartości tekstowych statusów w swoich encjach — połączeniach, ofertach, eksportach, logach synchronizacji itd. Ta strona wymienia każdą wartość, która może się pojawić, z krótkim wyjaśnieniem, co oznacza zwykłym językiem.

Wartości są wrażliwe na wielkość liter: niektóre są małymi literami, inne WIELKIMI (tam, gdzie wartość odpowiada dokładnie API marketplace’u). Etykiety w UI dla tych wartości pochodzą ze snippetów — na przykład status error jest pokazywany jako Error w panelu.

Stan synchronizacji oferty

Używany na wierszu mapowania oferty (widoczny na stronie Offer Mappings).

Wartość	Znaczenie
pending	Mapowanie istnieje, ale nie zostało jeszcze zakolejkowane do synchronizacji.
queued	Oczekuje w kolejce na następne uruchomienie synchronizacji.
processing	Bieżące uruchomienie synchronizacji właśnie pracuje nad tym wierszem.
retry	Poprzednia próba nie powiodła się przejściowo — uruchomienie spróbuje ponownie.
synced	Pomyślnie wysłane do marketplace’u; od tego czasu nie wykryto zmian.
error	Ostatnia próba nie powiodła się z powodu wymagającego Twojej uwagi. Wiersz zawiera treść komunikatu błędu.

Stan eksportu produktu

Używany na wierszu eksportu produktu (widoczny na liście Product Catalog, kolumna Export Status).

Wartość	Znaczenie
pending	Wybrany do eksportu, ale jeszcze nie zakolejkowany.
queued	Oczekuje w kolejce na następne uruchomienie eksportu.
uploaded	Plik CSV został wgrany do marketplace’u; oczekuje na przetworzenie po stronie marketplace’u.
processing	Marketplace właśnie przetwarza wiersz.
retry	Poprzednia próba nie powiodła się przejściowo — uruchomienie spróbuje ponownie.
exported	Marketplace zaakceptował wiersz i produkt jest w katalogu marketplace’u.
error	Marketplace odrzucił wiersz. Wiersz zawiera treść komunikatu błędu.

Stan połączenia

Używany na liście Connections (kolumna Status). Te same trzy wartości są pokazywane w widgecie Connection Status na Dashboardzie.

Wartość	Znaczenie
connected	Ostatni test powiódł się; zaplanowane synchronizacje uruchamiają się dla tego połączenia. Pokazane jako Connected.
disconnected	Połączenie nie zostało jeszcze zweryfikowane albo zostało wstrzymane; zaplanowane synchronizacje je pomijają. Pokazane jako Disconnected. Nowe połączenia startują w tym stanie.
error	Ostatni test lub synchronizacja nie powiodło się; zaplanowane synchronizacje pomijają to połączenie. Pokazane jako Error. Najedź na status albo otwórz Edit Connection, żeby zobaczyć komunikat od marketplace’u.

W cyklu życia połączenia nie ma stanu pending.

Postęp zadania

Używany na liście Tasks (Dashboard → Quick Start → Tasks) oraz w oknie postępu dla akcji uruchamianych z panelu.

Wartość	Czytelna nazwa	Znaczenie
pending	Waiting…	Właśnie utworzone, jeszcze nieprzejęte przez proces w tle.
in_queue	In queue…	Czeka w kolejce na proces w tle.
processing	Processing…	Proces w tle aktywnie wykonuje zadanie.
running	—	Alternatywna nazwa dla processing, używana przez niektóre przepływy.
completed	Completed!	Zakończone pomyślnie.
error	Error	Nieudane; zadanie zawiera ostatni komunikat.
cancelled	—	Anulowane przed zakończeniem.

Status logu synchronizacji

Używany na liście Sync Logs (kolumna Status).

Wartość	Etykieta UI	Znaczenie
started	Started	Długie uruchomienie jest w trakcie.
completed	Completed	Uruchomienie zakończyło się pomyślnie.
error	Error	Uruchomienie nie powiodło się; wiersz zawiera komunikat błędu marketplace’u.

Uruchomienie w stanie started przez wiele godzin zwykle oznacza, że proces w tle padł w trakcie — zobacz Troubleshooting.

Poziom logu synchronizacji

Używany na liście Sync Logs (kolumna Level). Kontroluje, które wiersze przechodzą przez ustawienie Sync log levels w Mirakl → Settings → Options.

Wartość	Etykieta UI	Znaczenie
debug	Debug	Bardzo szczegółowe śledzenie. Domyślnie wyłączone.
info	Info	Wiersze informacyjne (uruchomienie wystartowało, godne odnotowania zdarzenie).
success	Success	Uruchomienie zakończyło się pomyślnie.
warning	Warning	Coś godnego odnotowania, co nie zatrzymało uruchomienia.
error	Error	Próba nie powiodła się.

Typ synchronizacji

Używany na liście Sync Logs (kolumna Type). Każda wartość określa klasę uruchomienia. UI tłumaczy typowe wartości na czytelne nazwy przez snippety (na przykład offer_sync pokazywane jest jako Offer sync); rzadsze typy wyświetlają samą wartość.

Wartość	Co obejmuje
offer_sync	Wgrywanie partii ofert do marketplace’u. Pokazywane jako Offer sync.
offer_delete	Wycofywanie oferty z marketplace’u. Pokazywane jako Offer delete.
offer_delete_status_check	Odpytywanie marketplace’u o wynik żądania usunięcia oferty.
stock_sync	Wgrywanie partii aktualizacji stanów. Pokazywane jako Stock sync.
order_import	Pobieranie nowych i zaktualizowanych zamówień. Pokazywane jako Order import.
order_state_sync	Wysyłanie zmian statusu zamówienia z powrotem do marketplace’u (akceptacja, wysyłka, odrzucenie, zwrot). Pokazywane jako Order state sync.
product_export	Uruchomienie eksportu katalogu produktów, zagregowane per połączenie. Pokazywane jako Product export.
product_export_batch	Pojedyncza partia eksportu katalogu produktów. Pokazywane jako Product export batch.
product_import_status_check	Odpytywanie marketplace’u o wynik importu produktów. Pokazywane jako Product import status check.
product_import_item_error	Pobieranie raportu błędów per linia dla nieudanego importu produktów. Pokazywane jako Product import item error.
add_products / add_to_catalog	Dodawanie produktów do listy ofert lub katalogu z panelu.
auto_map_attributes	Tłowa akcja Auto Map na stronie Attribute Mappings.
catalog_export	Ręczny eksport CSV ze strony Catalog Export.
refresh_categories	Odświeżanie kategorii z marketplace’u.
refresh_product_attributes	Odświeżanie atrybutów produktów z marketplace’u.
refresh_offer_states	Odświeżanie statusów oferty z marketplace’u.
refresh_offer_fields	Odświeżanie pól oferty z marketplace’u.
refresh_reason_codes	Odświeżanie kodów powodów z marketplace’u.
initial_message_import	Wstępne pobranie historyczne wiadomości po włączeniu synchronizacji wiadomości.
order_document_sync	Pobieranie nowych dokumentów zamówień.
document_request_sync	Pobieranie nowych żądań dokumentów od marketplace’u.
initial_order_document_import	Wstępne pobranie historyczne dokumentów zamówień.
upload_order_document	Wysyłanie dokumentu do marketplace’u.
fulfill_document_request	Odpowiadanie na żądanie dokumentu od marketplace’u.
invoice_sync	Pobieranie nowych faktur z marketplace’u.
transaction_log_sync	Pobieranie nowych wpisów dziennika transakcji z marketplace’u.
initial_invoice_import	Wstępne pobranie historyczne faktur.
initial_transaction_log_import	Wstępne pobranie historyczne dziennika transakcji.
transaction_log_export	Masowy eksport dziennika transakcji uruchamiany z panelu.

Status importu zamówienia

Używany na wierszu śledzącym stan zamówienia Mirakl po stronie Shopware.

Wartość	Znaczenie
pending	Pobrane z marketplace’u, ale jeszcze nie utworzone w Shopware.
imported	Zamówienie Shopware zostało utworzone dla tego zamówienia Mirakl.
error	Utworzenie zamówienia Shopware nie powiodło się. Wiersz zawiera komunikat błędu.
deleted	Zamówienie Shopware zostało usunięte; powiązanie jest zachowane do celów audytu.

Status importu produktu

Używany na lokalnym wierszu importu produktu (widoczny na stronach detali Imports).

Wartość	Znaczenie
pending	Import został zakolejkowany, ale jeszcze nie wystartował po stronie marketplace’u.
running	Marketplace właśnie przetwarza import.
complete	Marketplace ukończył import. Mogą nadal istnieć błędy poszczególnych linii.
error	Marketplace odrzucił cały import.

Dokument zamówienia — kierunek

Używany na wierszach dokumentów zamówień. WIELKIE LITERY.

Wartość	Znaczenie
INBOUND	Dokument przyszedł z marketplace’u do Shopware.
OUTBOUND	Dokument został wysłany z Shopware do marketplace’u.

Dokument zamówienia — źródło

Używany na wierszach dokumentów zamówień. WIELKIE LITERY.

Wartość	Znaczenie
AUTO_SHOPWARE	Wygenerowany automatycznie przez Shopware (np. przez auto-upload dokumentów).
MANUAL_SHOPWARE	Utworzony lub wgrany ręcznie z panelu Shopware.
MANUAL	Wgrany ręcznie spoza Shopware.
MIRAKL_SYNC	Pobrany z marketplace’u przez synchronizację dokumentów.

Dokument zamówienia — status

Używany na wierszach dokumentów zamówień.

Wartość	Znaczenie
pending	Utworzony, ale jeszcze nie przetworzony.
uploading	Aktualnie wysyłany do marketplace’u.
uploaded	Pomyślnie wysłany do marketplace’u.
synced	Potwierdzony przez marketplace.
error	Przesłanie lub synchronizacja nie powiodły się. Wiersz zawiera komunikat błędu.
downloaded	(Dla dokumentów przychodzących) Pomyślnie pobrany z marketplace’u.

Żądanie dokumentu — stan

Używany na wierszach żądań dokumentów pobranych z marketplace’u. WIELKIE LITERY.

Wartość	Znaczenie
STAGING	Marketplace przygotowuje żądanie.
TO_PROCESS	Oczekuje, aż dostarczysz dokument.
ISSUED	Dokument został dostarczony.
CANCELED	Marketplace anulował żądanie.

Żądanie dokumentu — typ

Używany na wierszach żądań dokumentów. WIELKIE LITERY.

Wartość	Znaczenie
INVOICE	Marketplace prosi o fakturę.
CREDIT_NOTE	Marketplace prosi o korektę.

Faktura — typ

Używany na wierszach faktur. WIELKIE LITERY.

Wartość	Znaczenie
AUTO_INVOICE	Faktura wygenerowana automatycznie przez marketplace.
MANUAL_INVOICE	Faktura wprowadzona ręcznie po stronie marketplace’u.
MANUAL_CREDIT	Ręczna korekta.

Faktura — status płatności

Używany na wierszach faktur. WIELKIE LITERY.

Wartość	Znaczenie
PENDING	Jeszcze nieopłacona.
PAID	Oznaczona jako opłacona.
FAILED	Próba płatności nie powiodła się.

Usunięcie oferty

Używany w trakcie procesu wycofywania oferty na wierszu mapowania oferty.

Wartość	Znaczenie
deleting	Żądanie wycofania wysłane do marketplace’u; oczekuje na potwierdzenie.
delete_failed	Żądanie wycofania nie powiodło się. Wiersz zostaje, żeby można było ponowić.

Gdy marketplace potwierdzi usunięcie, wiersz mapowania jest usuwany w całości — nie ma wartości deleted.

Typ źródła atrybutu

Używany na wierszach mapowania atrybutów i mapowania pól oferty. Każda wartość uruchamia inny dialog wyboru źródła.

Wartość	Znaczenie
product_field	Standardowe pole produktu Shopware (nazwa, opis, EAN itd.).
custom_field	Pole własne Shopware.
property_group	Grupa właściwości Shopware (używana do osi wariantów itp.).
category	Inteligentna kategoria — używa mapowania kategorii Mirakl, jeśli jest dostępne, w przeciwnym razie wraca do nazwy kategorii Shopware.
mirakl_category	Ścisła kategoria Mirakl — tylko z mapowania kategorii Mirakl (z dziedziczeniem rodzica).
shopware_category	Surowa nazwa lub ścieżka kategorii Shopware, nigdy mapowanie.
product_image	Zdjęcie produktu.
tax	Stawka podatku produktu.
static	Statyczna wartość, którą wpisujesz.
ean_or_sku	EAN albo SKU, w zależności od tego, co dostępne.
ean_or_sku_type	Flaga wskazująca, która z dwóch wartości została użyta.
shop_sku	Numer produktu Shopware.
shop_sku_type	Flaga identyfikująca typ SKU.
ean	EAN produktu.
ean_type	Flaga identyfikująca typ EAN.
effective_stock	Efektywna wartość stanu magazynowego produktu.
mirakl_offer_state	Nadpisanie Offer State dla produktu per połączenie (albo wartość domyślna z połączenia).
delivery_time	Czas dostawy produktu.

Statusy importu po stronie marketplace’u

Zwracane przez marketplace przy sprawdzaniu statusu importu. To stany po stronie marketplace’u, oddzielne od lokalnych stanów synchronizacji powyżej. Wszystkie wartości są WIELKIMI LITERAMI, jak zwraca je marketplace.

Importy ofert

• WAITING, RUNNING, COMPLETE, FAILED

Importy produktów

• WAITING, RUNNING, COMPLETE, FAILED, TRANSFORMATION_FAILED

Importy stanów

• WAITING, RUNNING, COMPLETE, FAILED

Eksport dziennika transakcji — stan lokalny

Używany na wierszu śledzącym ręczne zadanie eksportu dziennika transakcji.

Wartość	Znaczenie
pending	Utworzone, ale zadanie po stronie marketplace’u jeszcze nie wystartowało.
running	Marketplace generuje plik.
completed	Plik został pobrany.
error	Zadanie nie powiodło się.

Eksport dziennika transakcji — stan marketplace’u

Marketplace zwraca jedną z tych wartości na endpoincie sprawdzania statusu. Są pogrupowane w „gotowe” i „nieudane”.

• Gotowe (pobierz plik): AVAILABLE, COMPLETED, SUCCESS.
• Nieudane (terminalne): FAILED, ERROR, CANCELLED.

Kody błędów synchronizacji

Stabilne kody dołączane do wierszy Sync Logs, gdy błąd ma dobrze znaną przyczynę. Panel pokazuje je jako przyjazny komunikat przez snippety; źródłowy komunikat techniczny pozostaje dostępny jako fallback. Format: <flow>.<reason>.

Eksport produktów (productExport.*):

• productNotVisible — Produkt nie jest widoczny w kanale sprzedaży połączenia (nieaktywny, brak widoczności albo usunięty).
• requiredAttributeEmpty — Produkt pominięty, ponieważ wymagany atrybut jest pusty.
• missingRequiredAttributes — Produktowi brakuje wymaganych atrybutów (lista podana).
• noAttributeMappings — Dla tego połączenia nie skonfigurowano żadnych mapowań atrybutów.
• noImportId — Marketplace nie zwrócił identyfikatora importu.
• miraklApiError — Ogólny błąd API marketplace’u.
• rateLimitExhausted — Przekroczono limit zapytań; wykorzystano wszystkie ponowienia.
• rateLimited — Limit zapytań; partia spróbuje ponownie po przerwie marketplace’u.
• unexpected — Nieoczekiwana awaria (niekategoryzowana).

Synchronizacja ofert (offerSync.*):

• productNotVisible — Produkt nie jest widoczny w kanale sprzedaży połączenia.
• missingRequiredAttributes — Produktowi brakuje wymaganych atrybutów (lista podana).
• missingOfferFields — Produktowi brakuje wymaganych pól oferty (lista podana).
• noCategoryMapping — Nie znaleziono mapowania kategorii Mirakl dla kategorii tego produktu.
• catalogPrerequisiteMissing — Produkt nie został jeszcze wyeksportowany do katalogu marketplace’u. Najpierw wyeksportuj go ze strony Products.
• requiredFieldEmpty — Oferta pominięta, ponieważ wymagane pole jest puste.
• miraklApiError — Ogólny błąd API marketplace’u.
• rateLimitExhausted — Przekroczono limit zapytań; wykorzystano wszystkie ponowienia.
• rateLimited — Limit zapytań; partia spróbuje ponownie po przerwie marketplace’u.

Powiązane tematy

• Settings — ustawiane interwały i włączniki
• Sync logs — gdzie większość tych wartości się pojawia
• Background tasks — cykl życia wpisów Tasks