Offer Fields
Oferty Mirakl mają własny zestaw pól — oddzielnie od atrybutów produktów — pokrywający dane specyficzne dla sprzedawcy przypisane do każdego wystawienia (cena, czas realizacji, stan, pola własne operatora). Wtyczka pobiera tę listę od operatora i cachuje lokalnie, dzięki czemu można ją zmapować na pola Shopware przy synchronizacji ofert.
Ta strona to widok tylko do odczytu na ten lokalny cache. Pól nie definiujesz tu — robi to operator — ale możesz odświeżać listę i zobaczyć, które pola są powiązane z którymi połączeniami Mirakl.
Gdzie to znaleźć
Dział zatytułowany „Gdzie to znaleźć”Na Dashboard otwórz kartę Quick Start i kliknij kafelek Offer Fields. Otworzy to stronę Offer Fields.
Co widzisz
Dział zatytułowany „Co widzisz”Kolumny:
| Kolumna | Znaczenie |
|---|---|
| Code | Wewnętrzny kod operatora dla pola. |
| Label | Czytelna nazwa, którą operator publikuje. |
| Type | Jakiego typu wartość pole przechowuje. |
| Required | Czy operator oznacza pole jako wymagane. |
| Source | Standard (wbudowane pole oferty Mirakla) albo Custom (pole własne operatora). |
| Connections | Z którymi połączeniami Mirakl pole jest powiązane. |
Pasek boczny pokazuje:
- Filter by Connection — zawęź do pól konkretnego połączenia.
- Filter by Type — filtruj po typie danych.
- Filter by Source — pokaż tylko Standard albo tylko Custom pola.
- Filter by Code / Filter by Label — filtry tekstowe.
Odświeżanie od operatora
Dział zatytułowany „Odświeżanie od operatora”Pasek narzędzi ma akcję Refresh Fields. Kliknięcie otwiera dialog potwierdzenia: “This will fetch operator-specific custom offer fields from Mirakl and link all standard offer fields to the selected connection.”
Potwierdź, a wtyczka pobierze aktualne pola własne operatora oraz powiąże każde standardowe pole oferty z wybranym połączeniem. Okno postępu pokazuje Refreshing Offer Fields. Po zakończeniu komunikat sukcesu raportuje, ile nowych pól ofert zostało dodanych.
Uruchom to, gdy:
- Podłączasz nowego operatora Mirakl.
- Operator dodaje nowe pola własne.
Pola Standard vs Custom
Dział zatytułowany „Pola Standard vs Custom”- Pola Standard są takie same u każdego operatora Mirakl (np. cena, ilość, stan, czas realizacji). Są seedowane automatycznie przy instalacji wtyczki, a Refresh Fields łączy je z Twoimi połączeniami.
- Pola Custom są specyficzne dla operatora (np. “Dopłata za pakowanie” na jednym marketplace’cie, “Próg B2B” na innym). Tylko Refresh Fields może je sprowadzić — to dane specyficzne dla operatora.
Jak pola ofert są używane gdzie indziej
Dział zatytułowany „Jak pola ofert są używane gdzie indziej”Ta strona to tylko dane referencyjne. Lista jest konsumowana przez:
- Mapping → Offer Fields — gdzie łączysz każde pole oferty Mirakla z polem produktu, polem własnym albo wartością statyczną w Shopware.
- Offer sync — wartości wysyłane dla każdej oferty pochodzą z mapowań tych pól.
Wskazówki i pułapki
Dział zatytułowany „Wskazówki i pułapki”Powiązane
Dział zatytułowany „Powiązane”- Mapping → Offer Fields — mapuj te pola na źródła Shopware
- Product Attributes — lista referencyjna po stronie katalogu
- Offer sync — używa zmapowanych pól ofert przy budowaniu payloadów ofert