Integracja XML z Marketplace 2026: Połączenie z Dostawcą, Automatyczny Feed Produktów i Synchronizacja Stanu-Cen

Krajobraz integracji XML w Turcji 2026 — przegląd

Cztery główne marketplace'y obsługiwane przez Zunapro mają wyraźnie różne wymagania techniczne dotyczące importu produktów. Tabela kart poniżej streszcza kluczowe parametry — warto mieć ją w zasięgu wzroku podczas konfiguracji pierwszego feedu.

1. Anatomia feedu XML — co dokładnie wchodzi do panelu

Podstawowa struktura standardowego feedu

Większość polskich dostawców e-commerce eksportuje swoje katalogi w formacie XML zgodnym z jednym z czterech wzorców: Google Shopping XML, WooCommerce export, Shoper / Shoplo / IdoSell schema lub własny, autorski format. Zunapro obsługuje wszystkie cztery rodziny przez konfigurowalne mapery — nie wymagamy od dostawcy zmiany schematu. Typowa struktura wygląda następująco:

<?xml version="1.0" encoding="UTF-8"?>
<produkty data_aktualizacji="2026-06-09T14:30:00+02:00">
  <produkt>
    <sku><![CDATA[PL-WAW-12480]]></sku>
    <ean>5901234123457</ean>
    <nazwa><![CDATA[Słuchawki bezprzewodowe Pro 2026]]></nazwa>
    <producent><![CDATA[AudioMax]]></producent>
    <kategoria_id>128</kategoria_id>
    <cena_netto>245.00</cena_netto>
    <cena_brutto>301.35</cena_brutto>
    <waluta>PLN</waluta>
    <vat>23</vat>
    <stan_magazynowy>124</stan_magazynowy>
    <waga_kg>0.42</waga_kg>
    <wymiary>22x18x9</wymiary>
    <zdjecia>
      <zdjecie>https://cdn.dostawca.pl/img/12480_1.jpg</zdjecie>
      <zdjecie>https://cdn.dostawca.pl/img/12480_2.jpg</zdjecie>
    </zdjecia>
    <opis><![CDATA[Profesjonalne słuchawki z aktywną redukcją szumów...]]></opis>
  </produkt>
</produkty>

Pola obowiązkowe vs opcjonalne

Z perspektywy publikacji na tureckich marketplace'ach pola dzielą się na trzy poziomy krytyczności:

• Obowiązkowe (brak = listing odrzucony): SKU dostawcy, EAN/GTIN-13, nazwa, producent/brand, cena, stan magazynowy, kategoria, co najmniej jedno zdjęcie w rozdzielczości min. 1280×1280 px.
• Krytyczne dla rankingu (brak = niska widoczność): opis produktu (min. 200 znaków), waga, wymiary, atrybuty wariantowe (rozmiar, kolor, pojemność), drugie i kolejne zdjęcia.
• Opcjonalne (poprawiają konwersję): video URL, instrukcje obsługi PDF, certyfikaty CE/RoHS, języki opisu (TR/EN/PL).

Kodowanie znaków — pułapka polsko-tureckiego mapowania

Najczęstszy błąd implementacyjny dotyczy kodowania znaków. Polskie diakrytyki (ą, ć, ę, ł, ń, ó, ś, ź, ż) i tureckie znaki (ı, İ, ğ, Ğ, ş, Ş, ç, Ç) wymagają UTF-8. Feed w ISO-8859-2 lub Windows-1250 przy imporcie do Trendyol generuje uszkodzone tytuły. Zunapro wymusza UTF-8 i odrzuca inne kodowania z alertem.

2. Połączenie z dostawcą — modele autentykacji

URL publiczny vs dostęp chroniony

Polscy dostawcy publikują feedy XML w trzech wariantach autentykacji: URL publiczny (najprostszy, dropshipping; bezpieczeństwo oparte na nieprzewidywalności tokenu w URL), HTTP Basic Auth (login + hasło, Zunapro przechowuje credentials w AES-256, nigdy w logach) oraz OAuth 2.0 / API key (najbezpieczniejszy — token z panelu B2B dostawcy, możliwy do cofnięcia bez wpływu na inne integracje).

Polling vs Webhook — strategia świeżości danych

Zunapro obsługuje dwa modele aktualizacji jednocześnie:

Throttling i grzeczność wobec dostawcy

Polscy dostawcy często ograniczają liczbę zapytań. Zunapro stosuje adaptive rate limiting: gdy feed odpowiada powyżej 8 sekund, polling jest wydłużany do 30 minut; po powrocie poniżej 3 sekund wraca do 15 minut. Chroni dostawcę i sprzedawcę przed banem IP.

3. Parsowanie XML i walidacja — pierwsza linia obrony

Pipeline parsowania w Zunapro

Każdy import XML przechodzi przez sześciostopniowy pipeline weryfikacyjny: Pobranie (HTTP GET z timeout 30s, retry 3× z exponential backoff), Detekcja kodowania (nagłówek XML + Content-Type, konwersja do UTF-8), Walidacja składni (XML well-formedness przez libxml2), Walidacja schematu (XSD lub reguły biznesowe), Detekcja dryfu (porównanie struktury z poprzednim importem) oraz Normalizacja (trimowanie, ujednolicenie znaków, deduplikacja po EAN).

Walidacja semantyczna — błędy, których nie złapie XSD

Najbardziej kosztowne błędy importu nie są strukturalne, lecz semantyczne. Zunapro implementuje zestaw reguł biznesowych:

• Cena = 0 lub ujemna — produkt wycofany; reguła zawiesza listing zamiast publikować absurdalną cenę
• Stan magazynowy > 9999 — magic number "nieskończoność"; Zunapro normalizuje do limitu (zwykle 99 lub 250)
• EAN zaczyna się od 0000 — placeholder; produkt oznaczony do ręcznej weryfikacji
• Brak zdjęcia lub URL 404 — listing wstrzymany; pozostałe SKU idą normalnie
• Tytuł krótszy niż 10 znaków — automatycznie wzbogacany o nazwę producenta i kategorię
• Atrybut wagi pusty — używana waga domyślna; Trendyol odrzuca produkty bez wagi

Co dzieje się przy błędzie krytycznym

Gdy feed XML jest uszkodzony (np. nie jest poprawnym XML, returns 500, lub schemat zmienił się radykalnie), Zunapro nie publikuje pustego katalogu. Zamiast tego ostatnia dobra wersja pozostaje aktywna na marketplace'ach, sprzedawca otrzymuje natychmiastowy alert (e-mail + SMS + Slack), a logi diagnostyczne są dostępne w panelu. Polityka "fail safe, never fail open" eliminuje ryzyko publikacji błędnych danych w wyniku pojedynczego problemu po stronie dostawcy.

4. Mapowanie pól — transformacja XML → API marketplace

Wymagania Trendyol API

Trendyol oczekuje danych w formacie JSON wysyłanych przez REST API endpoint /sapigw/suppliers/{supplierId}/v2/products. Każdy produkt musi zawierać:

• barcode — EAN-13 z feedu dostawcy (źródło prawdy do matchingu)
• title — tytuł, maksymalnie 100 znaków, bez znaków specjalnych
• productMainId — identyfikator grupy wariantów (kolor/rozmiar)
• brandId, categoryId — ID marki i kategorii Trendyol
• listPrice, salePrice — cena katalogowa i promocyjna w TRY
• vatRate — KDV: 1, 8, 18 lub 20 (od 2023 standardem jest 20%)
• quantity, dimensionalWeight — stan i waga wolumetryczna w kg
• images — tablica URLi (min. 1, max. 8, rozdzielczość ≥ 1280×1280)
• attributes — para attributeId/attributeValueId zgodnie ze słownikiem Trendyol

Wymagania Hepsiburada API

Hepsiburada używa HepsiSell API z dwustopniowym modelem importu. Najpierw productImport tworzy produkt i zwraca hbSku; potem listingImport wiąże merchantSku sprzedawcy z hbSku i ustawia cenę oraz stan. Kluczowe pola: merchantSku, hbSku, productName (do 200 znaków), brand, categoryId, attributes (tablica klucz-wartość), images (min. 5 dla najlepszego rankingu), price (TRY z KDV), availableStock.

Wymagania n11 OpenAPI

n11 akceptuje bezpośrednio XML zgodny z własnym schematem SOAP. Strukturalnie najprostszy z czterech marketplace'ów:

<product>
  <productSellerCode>PL-WAW-12480</productSellerCode>
  <title>Słuchawki bezprzewodowe Pro 2026 - AudioMax</title>
  <subtitle>ANC, Bluetooth 5.3, 40h baterii</subtitle>
  <description><![CDATA[...]]></description>
  <category><id>1001624</id></category>
  <price>1899.00</price>
  <currencyType>1</currencyType>
  <images>
    <image><url>https://cdn.dostawca.pl/img/12480_1.jpg</url><order>1</order></image>
  </images>
  <saleStartDate>09/06/2026</saleStartDate>
  <saleEndDate>31/12/2027</saleEndDate>
  <productionDate>01/01/2026</productionDate>
  <expirationDate>01/01/2030</expirationDate>
  <stockItems>
    <stockItem>
      <quantity>124</quantity>
      <sellerStockCode>PL-WAW-12480</sellerStockCode>
    </stockItem>
  </stockItems>
</product>

Wymagania Amazon SP-API

Amazon Turkey używa Selling Partner API z formatem XML feed dokumentu. Format wymaga zgodności ze schematem amzn-envelope.xsd i obejmuje pięć niezależnych typów: Product (z ASIN matching przez EAN/UPC), Inventory, Price (TRY), Relationships (warianty parent-child) oraz Image. Zunapro agreguje wszystkie pięć feedów Amazon w jeden cykl synchronizacji, eliminując ryzyko niespójności między ceną a stanem.

Centralizacja mapowania w Zunapro

Zamiast oddzielnych konfiguracji dla każdego marketplace'u, Zunapro stosuje jeden master mapping XML → kanoniczny model produktu, a następnie n adapterów (Trendyol, HB, n11, Amazon) tłumaczy model na format konkretnego API. Korzyść: zmiana w schemacie dostawcy wymaga aktualizacji jednej mapy zamiast czterech. Korzyść druga: dodanie piątego marketplace (np. PttAVM, Çiçeksepeti, Pazarama) nie wymaga przemapowywania źródła.

5. Synchronizacja cen — PLN→TRY z marżą i ochroną

Pobranie kursu PLN/TRY

Zunapro pobiera kursy walutowe z trzech źródeł i wybiera najnowsze:

• TCMB (Türkiye Cumhuriyet Merkez Bankası) — oficjalny kurs Banku Centralnego Turcji, publikowany codziennie o 15:30 czasu lokalnego (12:30 UTC)
• ECB (Europejski Bank Centralny) — kurs EUR/PLN i EUR/TRY, używany do crossowych obliczeń
• NBP (Narodowy Bank Polski) — tabela A kursów średnich, pobierana codziennie o 11:45 czasu polskiego

Standardowo do publikacji używany jest kurs TCMB jako autorytatywny dla rynku tureckiego. NBP służy do raportowania i KSeF.

Wzór ceny detalicznej

Typowa formuła publikacji ceny na tureckim marketplace'u wygląda następująco:

cena_PL_netto    = 245.00 PLN  (z feedu dostawcy)
kurs_TCMB        = 7.85 TRY/PLN  (TCMB 09.06.2026)
bufor_kursowy    = 3%  (ochrona przed wahaniami)
marża_netto      = 22%  (sprzedawca)
koszty_logistyki = 35.00 TRY  (per szt., dropshipping CEE)
prowizja_MP      = 12%  (Trendyol category fee)
KDV              = 20%  (turecki VAT)

cena_TRY_bez_KDV = 245 × 7.85 × 1.03 × 1.22 + 35
                 = 245 × 8.0855 × 1.22 + 35
                 = 2416.66 + 35
                 = 2451.66 TRY

cena_publikowana = cena_TRY_bez_KDV × 1.20 / (1 - 0.12)
                 = 2451.66 × 1.20 / 0.88
                 = 3342.71 TRY brutto

Zunapro wykonuje to obliczenie dla każdego SKU automatycznie, w momencie publikacji. Reguły są konfigurowalne per kategoria — np. elektronika może mieć inną marżę niż odzież.

Ochrona przed wahaniami kursu

Lira turecka miała w 2024-2026 okres wysokiej zmienności. Sprzedawca importujący z PLN traci marżę gdy PLN umacnia się wobec TRY. Zunapro implementuje trzy mechanizmy ochronne:

• Bufor kursowy — domyślnie 3%, konfigurowalny 0-15%, dodawany przy publikacji
• Auto-repricing przy zmianie kursu > 2% — gdy TCMB publikuje nowy kurs odbiegający o ponad 2% od ostatniego użytego, Zunapro automatycznie republikuje cały katalog
• Floor i ceiling — ceny nie mogą spaść poniżej kosztu zakupu lub przekroczyć skonfigurowanego maksimum (ochrona przed publikacją "wybuchowych" cen przy błędzie kursu)

Strategia konkurencyjna — repricer marketplace

Dla SKU obecnych u wielu sprzedawców na tym samym marketplace (typowe na Trendyol i Hepsiburada) Zunapro oferuje moduł repricer: cena jest dynamicznie dostosowywana do najlepszej oferty konkurencji, w granicach skonfigurowanego floor i ceiling. Repricer działa co 5 minut, niezależnie od głównego cyklu XML, więc reakcja na ruch cenowy konkurencji jest natychmiastowa.

6. Synchronizacja stanu magazynowego — anty-oversell

Dlaczego oversell to katastrofa na tureckich marketplace'ach

Trendyol, Hepsiburada i n11 mają zerową tolerancję dla anulacji zamówień z powodu braku stanu. Sprzedawca, który anuluje 3% zamówień w miesiącu, otrzymuje obniżenie oceny sprzedawcy; 5% to zawieszenie konta na 14 dni; 10% — permanentne wykluczenie. Ta polityka oznacza, że synchronizacja stanu jest zdecydowanie najważniejszą funkcją integracji XML.

Model master-local-targets

Zunapro stosuje trójpoziomowy model synchronizacji stanu:

1. Master — stan rzeczywisty u polskiego dostawcy, pobierany z feedu XML
2. Local — kopia stanu w bazie Zunapro, używana jako single source of truth do publikacji
3. Targets — stan opublikowany na marketplace'ach (Trendyol, HB, n11, Amazon)

Każda warstwa ma własną logikę aktualizacji. Master → Local odbywa się przez polling/webhook XML co 15 minut. Local → Targets odbywa się przez batch API call do każdego marketplace'u natychmiast po zmianie w Local. Średni czas propagacji master → targets: poniżej 90 sekund.

Stock guard — bufor bezpieczeństwa

Zunapro publikuje na marketplace nie surowy stan z feedu, lecz stan zmniejszony o konfigurowalny bufor: bufor stały (odejmij 2 sztuki), bufor procentowy (np. 90% rzeczywistego stanu), bufor kategorii (elektronika 5%, odzież 2%, FMCG 10%) oraz bufor cap (max 99 sztuk nawet jeśli dostawca raportuje 9999 — psychologia konsumenta + ograniczenie ryzyka błędu dostawcy).

Deduplikacja przy mükerrer listing

Gdy ten sam EAN-13 występuje u dwóch dostawców (lub w dwóch wariantach tego samego dostawcy), Zunapro stosuje regułę MIN-stok: publikuje wyłącznie jeden listing, ze stanem równym minimum dostępnych źródeł. Reguła wprowadzona w czerwcu 2026 po wewnętrznym audycie, który wykazał, że 7% reklamacji na Trendyol dotyczyło duplikatów. Alternatywne strategie konfigurowalne:

• SUM — suma stanów (ryzykowne, ale maksymalizuje widoczność)
• PRIORYTET — wybór dostawcy podstawowego, fallback do alternatywnego
• BEST_PRICE — wybór dostawcy z najniższą ceną

Event-driven push

Gdy zamówienie zostaje przyjęte na Trendyol, Hepsiburada natychmiast otrzymuje webhook o spadku stanu (i odwrotnie). Eliminuje to okno czasowe, w którym ten sam SKU mógłby zostać sprzedany dwukrotnie. Push odbywa się asynchronicznie, z gwarancją at-least-once delivery.

7. Spływ zamówień — od marketplace do dostawcy

Cykl życia zamówienia

Standardowe zamówienie w modelu PL→TR dropshipping przechodzi przez 7 stanów: Nowe (klient kupił na marketplace, Zunapro otrzymuje przez webhook lub polling co 5 min), Walidacja (dostępność, adres, płatność), Routing do dostawcy (przesłanie do polskiego dostawcy przez API lub e-mail z PDF), Pakowanie, Wysyłka (list przewozowy — Trendyol Express, Aras, Yurtiçi, MNG, DHL Polska), W tranzycie (śledzenie + aktualizacja klienta), Dostarczone (zamknięcie zamówienia, faktury KSeF + e-Arşiv, zwolnienie wypłaty).

Cross-border logistyka PL→TR

Dropshipping bezpośredni PL→TR wymaga przemyślanej strategii logistycznej. Trzy modele są praktykowane w 2026 roku:

• Direct PL→TR — paczka z Polski trafia bezpośrednio do klienta w Turcji. Czas dostawy 5-10 dni, koszt 25-45 TRY. Wymaga obsługi celnej (duty-free do 150 EUR per shipment).
• Cross-dock w Stambule — paczki konsolidowane w Polsce, wysyłane tirem do magazynu cross-dock, rozdzielane do tureckich kurierów. Czas dostawy 3-5 dni.
• Stock-up w Turcji — bufor stanu w tureckim magazynie (Trendyol Express, Hepsijet, Sertrans). Czas dostawy 1-2 dni.

Zunapro obsługuje wszystkie trzy modele jednocześnie — dla tego samego SKU różne warunki dostawy mogą obowiązywać na różnych marketplace'ach.

Automatyczna komunikacja z klientem

Tureccy konsumenci oczekują odpowiedzi sprzedawcy w ciągu 4 godzin. Zunapro generuje automatyczne komunikaty w języku tureckim na siedem zdarzeń: nowe zamówienie, w produkcji, wysłane (z trackingiem), w doręczeniu, dostarczone, opóźnienie, problem celny.

8. Zgodność prawno-fiskalna — KSeF (PL) + e-Arşiv (TR)

Trójstronny model fakturowania

Model PL→TR dropshipping generuje dwie odrębne transakcje fakturowe na każde zamówienie końcowego konsumenta:

• Faktura A (KSeF, PL) — polski dostawca wystawia fakturę B2B na tureckiego sprzedawcę-pośrednika. Format: FA(2) XML, przekazane do KSeF API Ministerstwa Finansów, identyfikator 10-znakowy.
• Faktura B (e-Arşiv, TR) — turecki sprzedawca-pośrednik wystawia fakturę B2C na konsumenta końcowego. Format: UBL-TR 2.1, przekazane do GİB przez integratora (Logo, Foriba, Mikrofin).

KSeF — system polski

Ministerstwo Finansów RP wymaga od lutego 2026 (dla podmiotów powyżej 200 mln PLN obrotu) i od kwietnia 2026 (dla wszystkich VATowców) wystawiania faktur B2B/B2G przez KSeF (Krajowy System e-Faktur). Specyfikacja:

• Format: FA(2) — XML zgodny z opublikowanym XSD
• Przesył: REST API KSeF (autoryzacja przez certyfikat kwalifikowany lub token sesyjny)
• Zwrot: 10-znakowy unikalny identyfikator KSeF zastępujący tradycyjny numer faktury
• Archiwizacja: 10 lat, w KSeF (sprzedawca nie musi przechowywać kopii lokalnie)

Zunapro w pełni implementuje cykl KSeF: generowanie XML, podpisanie, wysłanie, odbiór identyfikatora, przechowanie referencji obok zamówienia marketplace.

GİB e-Arşiv — system turecki

GİB (Gelir İdaresi Başkanlığı) — turecki organ skarbowy — wymaga e-fakturowania dla podmiotów powyżej 5 mln TRY rocznego obrotu (próg obniżany corocznie). System obejmuje:

• e-Fatura — B2B między podmiotami zarejestrowanymi w systemie
• e-Arşiv — B2C oraz B2B z podmiotami nie-zarejestrowanymi; standard marketplace'owy
• Format: UBL-TR 2.1 (Universal Business Language Turkey)
• Przesył: przez integratora (Logo Elektronik, Foriba, Mikrofin, EDM Bilişim, Veriban, e-Finans)
• Archiwizacja: 10 lat, obowiązek po stronie sprzedawcy + GİB

Synchronizacja podatkowa PL ↔ TR

Polski VAT (23% standard) i turecki KDV (20% od 2023) są naliczane odrębnie. W modelu trójstronnym:

• Faktura A (dostawca PL → pośrednik TR) — VAT 0% przy WDT (wewnątrzwspólnotowa dostawa towarów) lub stawka eksportowa, w zależności od interpretacji organu
• Faktura B (pośrednik TR → konsument TR) — KDV 20% pełna stawka

Zunapro generuje obie faktury automatycznie z poprawnymi stawkami podatkowymi, eliminując ryzyko podwójnego VAT lub błędnej kwalifikacji transakcji.

9. Monitoring i obserwowalność — pojedynczy panel kontrolny

Metryki dashboardu Zunapro

Panel Zunapro wyświetla w czasie rzeczywistym kluczowe metryki operacyjne:

• Skuteczność synchronizacji — procent successful XML imports w ostatnich 24h
• Średnie opóźnienie sync — czas od zmiany w master do propagacji na targets
• Aktywne SKU per marketplace — liczba listingów aktywnych vs zawieszonych
• Stan magazynowy łączny i wartość stocku — w TRY i PLN
• Anulowane zamówienia (24h, 7d, 30d) — z podziałem na powód
• Marża netto per kategoria — po prowizjach marketplace i kosztach logistyki
• Buybox win rate (Trendyol/HB) — procent listingów wygrywających Buybox
• Saldo KSeF/e-Arşiv — liczba faktur wysłanych vs nieudanych
• Kurs PLN/TRY na żywo — TCMB + NBP + ECB
• Health score dostawcy — kompozyt 5 metryk per polski dostawca

Alerty progowe

Standardowa konfiguracja alertów obejmuje: feed XML nieudany 3× z rzędu (e-mail + SMS w 30s), stan magazynowy poniżej 5 sztuk (możliwy automatyczny restocking u dostawcy alternatywnego), marża netto poniżej 5% (ostrzeżenie do operatora), anulacja powyżej 2% w 24h (critical alert), kurs PLN/TRY zmieni się o > 3% (prompt do repricingu), nieudana faktura KSeF/e-Arşiv (critical, blokada wypłaty do naprawy).

Logi audytowe

Każda zmiana stanu, ceny, listingu i statusu zamówienia jest logowana z timestampem, źródłem (XML/API/manual), operatorem i diff'em. Logi 12 miesięcy w wyszukiwarce pełnotekstowej. Eksport CSV/JSON dla audytów GİB lub KAS.

10. Strategia multi-supplier — wielu dostawców, jeden katalog

Dlaczego multi-supplier to standard 2026

Pojedynczy polski dostawca rzadko pokrywa cały katalog tureckiego sprzedawcy. Standard 2026 to 3-10 niezależnych dostawców XML obsługujących różne kategorie:

• Dostawca A — elektronika i AGD (4 000 SKU)
• Dostawca B — odzież i obuwie (8 500 SKU, sezonowy)
• Dostawca C — kosmetyki i drogeria (2 100 SKU)
• Dostawca D — dom i ogród (3 200 SKU)
• Dostawca E — sport i outdoor (1 800 SKU)

Razem: ~19 600 unikalnych SKU dostępnych do publikacji na czterech marketplace'ach. Zarządzanie ręczne takim wolumenem byłoby ekonomicznie niemożliwe.

Master catalog jako single source of truth

Zunapro konsoliduje wszystkich dostawców w jeden master catalog — kanoniczną reprezentację produktów niezależną od dostawcy źródłowego. Każdy SKU w master ma: unikalny master_id, tablicę supplier_skus (wszystkie SKU u dostawców), tablicę marketplace_ids (Trendyol/HB/n11/Amazon), politykę deduplikacji (MIN/SUM/PRIORYTET/BEST_PRICE), politykę cenową per kategoria oraz politykę widoczności (auto-suspend gdy wszyscy dostawcy out-of-stock).

Fallback i ciągłość oferty

Gdy dostawca podstawowy kończy SKU, Zunapro automatycznie przełącza listing na dostawcę alternatywnego (jeśli skonfigurowany). Klient marketplace nigdy nie widzi przerwy w ofercie. Polityka fallback jest konfigurowana per SKU lub per kategoria — np. elektronika ma fallback obligatoryjny, odzież sezonowa pozwala na okresowe out-of-stock.

Analityka per dostawca

Panel pokazuje rentowność per dostawca — który generuje największe obroty, który ma najwyższą marżę, który ma najniższy wskaźnik zwrotów. Dane te są podstawą decyzji o negocjacjach handlowych z dostawcami i eliminacji niewydajnych źródeł.

Implementacja krok po kroku — 2026

1. Wybór modelu integracji (drzewo decyzyjne)

• Jeden dostawca, jeden marketplace → plan Start
• Jeden dostawca, wiele marketplace'ów → plan Pro (4 mp)
• Wielu dostawców, wiele marketplace'ów → plan Plus z master catalog
• Dropshipping cross-border PL→TR → plan Plus + compliance pack

2. Rejestracja konta sprzedawcy w Zunapro

Zunapro nie wymaga umowy długoterminowej; pierwsze 30 dni jest bezpłatne. Konfiguracja obejmuje rejestrację przez e-mail służbowy, wprowadzenie NIP polskiego dostawcy (do KSeF) i VKN tureckiego pośrednika (do e-Arşiv), konfigurację waluty bazowej (PLN) i waluty publikacji (TRY), połączenie API marketplace'ów (klucze z paneli Trendyol/HB/n11/Amazon).

3. Pierwszy import XML

Proces: wklejenie URL feedu w panelu, kliknięcie "Wykryj schemat", mapowanie pól drag-and-drop, konfiguracja walidacji, testowy import, zatwierdzenie do produkcji z cronem 15-minutowym. Średni czas: 22 minuty.

4. Publikacja na marketplace

Po pierwszym imporcie: wybór SKU (filtry: kategoria, marka, cena, stan), konfiguracja polityki cenowej (kurs + marża + bufor), mapowanie kategorii dostawcy do Trendyol/HB/n11/Amazon, pierwsza publikacja batch (po 100), approval marketplace (Trendyol 24-72h, HB 24h, n11 12-24h, Amazon natychmiastowy po ASIN match). Średni czas do pierwszego "Live" listingu: 27 godzin.

5. Optymalizacja po pierwszym miesiącu

Po 30 dniach: analiza top 10% SKU (90% obrotu), bottom 20% bez sprzedaży, Trendyol Ads + HB Ads, renegocjacje cenowe z dostawcami.

Porównanie wymagań XML — Trendyol vs Hepsiburada vs n11 vs Amazon

Najważniejsze różnice techniczne między czterema marketplace'ami przedstawia tabela porównawcza poniżej. Trzymaj ją w zasięgu wzroku podczas projektowania mappingu.

Aspekt	Trendyol	Hepsiburada	n11	Amazon TR
Protokół	REST API (JSON)	REST API (JSON)	SOAP XML	SP-API (XML feed)
Identyfikator	barcode (EAN-13)	merchantSku + hbSku	productSellerCode	ASIN + SKU
Min. rozdzielczość zdjęć	1200×1800 px	1280×1280 px	500×500 px	1000×1000 px
Max. zdjęć na produkt	8	10	5	9
Długość tytułu	100 znaków	200 znaków	65 znaków	200 znaków
Czas approval	24-72h	24h	12-24h	Natychmiast (po ASIN match)
Prowizja standardowa	8-22%	7-19%	5-18%	8-15%
Wymagana waga	Tak (dimensional)	Tak	Opcjonalnie	Tak (przy FBA)
Webhook zamówień	Tak	Tak	Polling tylko	Tak (SQS)
Sync częstotliwość rekomendowana	15 min	15 min	30 min	15 min

Czytanie tabeli: Trendyol i Hepsiburada mają najnowocześniejsze API (REST + webhook), ale też najwyższe wymagania jakościowe (zdjęcia, waga). n11 jest najprostszy schematowo, ale brak webhooków zamówień wymusza polling. Amazon TR ma najszybsze approval (dzięki ASIN matchingowi), ale wymaga zarządzania pięcioma odrębnymi typami feedów (Product, Inventory, Price, Image, Relationships) — Zunapro agreguje je automatycznie.

FAQ — Integracja XML z Marketplace 2026