API Allegro dla serwisów zagranicznych - marketplace, ceny i środowisko testowe w praktyce

Oliwia Papież

Oliwia Papież

Head of Operations

API Allegro obsługuje serwisy zagraniczne w modelu jednej oferty: ofertę tworzysz w serwisie bazowym, dla polskiej firmy jest to allegro-pl, a jej widoczność na allegro.cz, allegro.sk i allegro.hu wynika z metod dostawy do danego kraju. Stan publikacji, cenę w walucie rynku i powody odrzucenia dla każdego serwisu znajdziesz w sekcji additionalMarketplaces oferty, a identyfikatory serwisów zwraca zasób GET /marketplaces. Integrację sprawdzisz w środowisku testowym, które według dokumentacji ma też wersje dla serwisów zagranicznych.

Ten wpis jest dla firm, które zarządzają ofertami Allegro przez własną integrację, system ERP albo narzędzie budowane przez zespół IT. Sprzedaż za granicą nie wymaga nowej integracji, ale zmienia kilka założeń: cena przestaje być jedną liczbą, oferta ma kilka statusów publikacji, a zamówienia przychodzą w różnych walutach. Opisujemy, jak działa allegro api marketplace według dokumentacji developer.allegro.pl, które zasoby trzeba obsłużyć i jak zaplanować testy, żeby po starcie nie gasić pożarów na produkcji.

[#wazne] W skrócie: w API Allegro oferta ma serwis bazowy (allegro-pl) i serwisy dodatkowe, np. allegro-cz, allegro-sk i allegro-hu. Widoczność za granicą wynika z metod dostawy do kraju, status i powód odrzucenia odczytasz w additionalMarketplaces, a cenę w CZK, EUR lub HUF ustawisz sam albo zostawisz regule Przelicznik cen. Zamówienia i rozliczenia mają identyfikator rynku, a stan magazynowy jest wspólny. Testy zrobisz w sandboxie. W Vinson pomagamy firmom z własną integracją przygotować sprzedaż na Allegro za granicą.

Identyfikatory marketplace w API Allegro - serwis bazowy i serwisy dodatkowe

Marketplace w API Allegro to identyfikator serwisu, w którym oferta może być widoczna, np. allegro-pl albo allegro-cz. Serwis bazowy to ten, w którym zarejestrowano konto - API zwraca go w zasobie GET /me w polu baseMarketplace. Serwisy dodatkowe to pozostałe rynki, na których oferta może się wyświetlać. Według dokumentacji developer.allegro.pl ofertę tworzysz jeden raz, w serwisie bazowym, a o jej obecności na rynkach dodatkowych decydują ustawienia dostawy.

Pełną listę serwisów pobierzesz z GET /marketplaces. Dla każdego serwisu zasób zwraca m.in. języki tworzenia i wyświetlania ofert, waluty oraz kraje dostawy. Integracja nie powinna mieć tych wartości wpisanych na sztywno - Allegro rozwija rynki, a dokumentacja wymienia też serwisy biznesowe, np. allegro-business-cz, które mają własne zasady cenowe. Najważniejsze dane dla rynków konsumenckich (stan na czerwiec 2026 - sprawdź aktualną odpowiedź GET /marketplaces):

SerwisIdentyfikatorWaluta cenyJęzyk oferty
allegro.plallegro-plPLNpolski
allegro.czallegro-czCZKczeski
allegro.skallegro-skEURsłowacki
allegro.huallegro-huHUFwęgierski

Włączenie rynków zagranicznych nie zmienia sposobu tworzenia oferty, ale dokłada integracji kilka nowych obowiązków. Zanim udostępnisz pierwsze oferty za granicą, sprawdź, czy Twój system:

  • przechowuje cenę osobno dla każdego serwisu, a nie tylko jedną cenę w złotych,

  • zapisuje stan publikacji i kod odrzucenia dla każdego rynku dodatkowego,

  • rozróżnia zamówienia, zwroty i płatności według identyfikatora rynku i waluty,

  • nie nadpisuje ustawień dostawy, od których zależy widoczność za granicą,

  • wie, które funkcje działają tylko na allegro.pl, i nie próbuje ich ustawiać dla innych rynków.

Cykl życia oferty widocznej za granicą wygląda w API tak samo dla każdego rynku. Kolejne kroki pokazuje diagram:

[#chart:alz32a]

Jak oferta trafia na rynek dodatkowy przez API

Od zmian wprowadzonych w czerwcu 2024 roku o zgłoszeniu oferty do widoczności w serwisie dodatkowym decyduje metoda dostawy przypisana do kraju tego serwisu. Według komunikatu na developer.allegro.pl pole publication.marketplaces.additional przestało służyć do zgłaszania widoczności - dane przekazane w nim są ignorowane, a API zwraca w nim serwisy, w których oferta jest widoczna. Jeśli Twoja integracja powstała wcześniej i nadal ustawia to pole, warto ją uporządkować.

Metody dostawy dostępne na danym rynku pobierzesz z GET /sale/delivery-methods z filtrem marketplace, a ustawienia dostawy dla serwisu odczytasz i zmienisz przez GET i PUT /sale/delivery-settings z parametrem rynku. Gdy oferta dostanie metodę dostawy do Czech, Allegro zgłasza ją do kwalifikacji na allegro-cz i, jeśli nie podasz własnej ceny, ustawia ją w koronach automatycznie. Działa to też w drugą stronę: usunięcie metod do danego kraju wycofuje ofertę z tego serwisu. Jak przeprowadzić taką zmianę dla całego rynku, opisaliśmy we wpisie wyłączenie sprzedaży na Allegro do jednego kraju.

Stan publikacji w additionalMarketplaces

Dla każdego serwisu dodatkowego oferta ma w sekcji additionalMarketplaces pole publication.state, tylko do odczytu. Dokumentacja opisuje pięć wartości (stan na czerwiec 2026 - sprawdź aktualną dokumentację):

  • APPROVED - oferta jest widoczna w danym serwisie, dopóki jest aktywna.

  • REFUSED - oferta lub sprzedający nie spełnia wymagań serwisu, a API podaje powód.

  • IN_PROGRESS - trwa kwalifikacja oferty.

  • NOT_REQUESTED - sprzedający nie zgłosił chęci widoczności, bo oferta nie ma metody dostawy do kraju serwisu.

  • PENDING - chęć widoczności jest zgłoszona, ale kwalifikacja się nie zaczęła, np. bo oferta nie jest aktywna.

API Allegro obsługuje serwisy zagraniczne w modelu jednej oferty: ofertę tworzysz w serwisie bazowym, dla polskiej firmy jest to allegro-pl, a jej widoczność na allegro.cz, allegro.sk i allegro.hu wynika z metod dostawy do danego kraju. Stan publikacji, cenę w walucie rynku i powody odrzucenia dla każdego serwisu znajdziesz w sekcji additionalMarketplaces oferty, a identyfikatory serwisów zwraca zasób GET /marketplaces. Integrację sprawdzisz w środowisku testowym, które według dokumentacji ma też wersje dla serwisów zagranicznych.

Ten wpis jest dla firm, które zarządzają ofertami Allegro przez własną integrację, system ERP albo narzędzie budowane przez zespół IT. Sprzedaż za granicą nie wymaga nowej integracji, ale zmienia kilka założeń: cena przestaje być jedną liczbą, oferta ma kilka statusów publikacji, a zamówienia przychodzą w różnych walutach. Opisujemy, jak działa allegro api marketplace według dokumentacji developer.allegro.pl, które zasoby trzeba obsłużyć i jak zaplanować testy, żeby po starcie nie gasić pożarów na produkcji.

[#wazne] W skrócie: w API Allegro oferta ma serwis bazowy (allegro-pl) i serwisy dodatkowe, np. allegro-cz, allegro-sk i allegro-hu. Widoczność za granicą wynika z metod dostawy do kraju, status i powód odrzucenia odczytasz w additionalMarketplaces, a cenę w CZK, EUR lub HUF ustawisz sam albo zostawisz regule Przelicznik cen. Zamówienia i rozliczenia mają identyfikator rynku, a stan magazynowy jest wspólny. Testy zrobisz w sandboxie. W Vinson pomagamy firmom z własną integracją przygotować sprzedaż na Allegro za granicą.

Identyfikatory marketplace w API Allegro - serwis bazowy i serwisy dodatkowe

Marketplace w API Allegro to identyfikator serwisu, w którym oferta może być widoczna, np. allegro-pl albo allegro-cz. Serwis bazowy to ten, w którym zarejestrowano konto - API zwraca go w zasobie GET /me w polu baseMarketplace. Serwisy dodatkowe to pozostałe rynki, na których oferta może się wyświetlać. Według dokumentacji developer.allegro.pl ofertę tworzysz jeden raz, w serwisie bazowym, a o jej obecności na rynkach dodatkowych decydują ustawienia dostawy.

Pełną listę serwisów pobierzesz z GET /marketplaces. Dla każdego serwisu zasób zwraca m.in. języki tworzenia i wyświetlania ofert, waluty oraz kraje dostawy. Integracja nie powinna mieć tych wartości wpisanych na sztywno - Allegro rozwija rynki, a dokumentacja wymienia też serwisy biznesowe, np. allegro-business-cz, które mają własne zasady cenowe. Najważniejsze dane dla rynków konsumenckich (stan na czerwiec 2026 - sprawdź aktualną odpowiedź GET /marketplaces):

SerwisIdentyfikatorWaluta cenyJęzyk oferty
allegro.plallegro-plPLNpolski
allegro.czallegro-czCZKczeski
allegro.skallegro-skEURsłowacki
allegro.huallegro-huHUFwęgierski

Włączenie rynków zagranicznych nie zmienia sposobu tworzenia oferty, ale dokłada integracji kilka nowych obowiązków. Zanim udostępnisz pierwsze oferty za granicą, sprawdź, czy Twój system:

  • przechowuje cenę osobno dla każdego serwisu, a nie tylko jedną cenę w złotych,

  • zapisuje stan publikacji i kod odrzucenia dla każdego rynku dodatkowego,

  • rozróżnia zamówienia, zwroty i płatności według identyfikatora rynku i waluty,

  • nie nadpisuje ustawień dostawy, od których zależy widoczność za granicą,

  • wie, które funkcje działają tylko na allegro.pl, i nie próbuje ich ustawiać dla innych rynków.

Cykl życia oferty widocznej za granicą wygląda w API tak samo dla każdego rynku. Kolejne kroki pokazuje diagram:

[#chart:alz32a]

Jak oferta trafia na rynek dodatkowy przez API

Od zmian wprowadzonych w czerwcu 2024 roku o zgłoszeniu oferty do widoczności w serwisie dodatkowym decyduje metoda dostawy przypisana do kraju tego serwisu. Według komunikatu na developer.allegro.pl pole publication.marketplaces.additional przestało służyć do zgłaszania widoczności - dane przekazane w nim są ignorowane, a API zwraca w nim serwisy, w których oferta jest widoczna. Jeśli Twoja integracja powstała wcześniej i nadal ustawia to pole, warto ją uporządkować.

Metody dostawy dostępne na danym rynku pobierzesz z GET /sale/delivery-methods z filtrem marketplace, a ustawienia dostawy dla serwisu odczytasz i zmienisz przez GET i PUT /sale/delivery-settings z parametrem rynku. Gdy oferta dostanie metodę dostawy do Czech, Allegro zgłasza ją do kwalifikacji na allegro-cz i, jeśli nie podasz własnej ceny, ustawia ją w koronach automatycznie. Działa to też w drugą stronę: usunięcie metod do danego kraju wycofuje ofertę z tego serwisu. Jak przeprowadzić taką zmianę dla całego rynku, opisaliśmy we wpisie wyłączenie sprzedaży na Allegro do jednego kraju.

Stan publikacji w additionalMarketplaces

Dla każdego serwisu dodatkowego oferta ma w sekcji additionalMarketplaces pole publication.state, tylko do odczytu. Dokumentacja opisuje pięć wartości (stan na czerwiec 2026 - sprawdź aktualną dokumentację):

  • APPROVED - oferta jest widoczna w danym serwisie, dopóki jest aktywna.

  • REFUSED - oferta lub sprzedający nie spełnia wymagań serwisu, a API podaje powód.

  • IN_PROGRESS - trwa kwalifikacja oferty.

  • NOT_REQUESTED - sprzedający nie zgłosił chęci widoczności, bo oferta nie ma metody dostawy do kraju serwisu.

  • PENDING - chęć widoczności jest zgłoszona, ale kwalifikacja się nie zaczęła, np. bo oferta nie jest aktywna.

Bezpłatna konsultacja Allegro za granicą
Chcesz sprzedawać na Allegro.cz, Allegro.sk lub Allegro.hu?
  • Ocena potencjału Twojego asortymentu za granicą
  • Tłumaczenia ofert, logistyka i obsługa klienta
  • Plan startu krok po kroku
Oliwia PapieżKonsultację poprowadzi Oliwia Papież, Head of Operations

Powody odrzucenia oferty w API Allegro - kody VQR

Gdy kwalifikacja się nie powiedzie, oferta dostaje stan REFUSED i powód odrzucenia. Zmiany widoczności Allegro odnotowuje w dzienniku zdarzeń ofert GET /sale/offer-events jako zdarzenie OFFER_VISIBILITY_CHANGED, więc integracja nie musi co chwilę pobierać wszystkich ofert, żeby wychwycić nowe odrzucenia. Listę ofert widocznych w danym serwisie pobierzesz z GET /sale/offers z filtrem publication.marketplace. Najczęstsze kody i sposób reakcji:

[#chart:alz32b]

Część kodów naprawia się sama. Tłumaczenie w toku zwykle znika po kilku chwilach, a brak ceny w walucie rynku rozwiązuje reguła Przelicznik cen. Inne wymagają pracy na danych. Brak produktu, czyli kod VQR008_OFFER_HAS_NO_PRODUCT, przy dużym asortymencie bywa najczęstszą przyczyną odrzuceń - jak uporządkować ten obszar, opisaliśmy we wpisie powiązanie z katalogiem Allegro jako warunek sprzedaży za granicą. Dobrą praktyką jest zapisywanie kodu odrzucenia przy ofercie w swoim systemie i raport, który grupuje oferty według powodu.

Ceny w walutach w API Allegro - cena oferty i reguły cenowe

Cena w serwisie dodatkowym znajduje się w sekcji additionalMarketplaces danego serwisu, w polu sellingMode.price z kwotą i walutą. Waluta musi być walutą bazową serwisu z GET /marketplaces, czyli np. CZK dla allegro-cz. Jeśli nie przekażesz ceny, Allegro ustala ją automatycznie, gdy aktywna jest reguła Przelicznik cen. Według dokumentacji, gdy oferta korzysta z reguły cenowej, a Ty ustawisz w niej własną cenę, Allegro automatycznie wyłącza regułę w tej ofercie. To najważniejsza zasada dla integracji: każde wysłanie ceny w walucie rynku jest decyzją o rezygnacji z automatycznego przeliczania.

Warto też wiedzieć, kiedy reguła zmienia cenę. Według pomocy Allegro Przelicznik cen nie reaguje na każdą zmianę kursu - przelicza cenę m.in. po zmianie ceny w serwisie bazowym, wznowieniu oferty lub edycji przypisanej reguły, a wersja automatyczna dla sprzedawców z Abonamentem Allegro aktualizuje ceny po zmianie kursu EBC o co najmniej 1% (stan na czerwiec 2026 - sprawdź aktualne zasady). Dla integracji oznacza to, że cena w CZK odczytana rano może być inna wieczorem, jeśli w międzyczasie zmieniłeś cenę w złotych.

Do pracy na regułach służą zasoby price-automation. Reguły pobierzesz i utworzysz przez /sale/price-automation/rules, przypiszesz lub odepniesz dla wybranego rynku przez POST /sale/offer-price-automation-commands, a reguły przypisane do oferty sprawdzisz w GET /sale/price-automation/offers/{offerId}/rules. Dokumentacja opisuje m.in. typy EXCHANGE_RATE (Przelicznik cen), FOLLOW_BY_ALLEGRO_MIN_PRICE (Najniższa cena na Allegro) i FOLLOW_BY_TOP_OFFER_PRICE (Top oferta). Konto może mieć maksymalnie 20 reguł, a korekta procentowa w regule nie może przekroczyć 50% (stan na czerwiec 2026 - sprawdź aktualną dokumentację).

Dwie pułapki warto znać przed wdrożeniem. Po pierwsze, kod VQR009_PRICE_IN_ADDITIONAL_MARKETPLACE_MISMATCH oznacza zbyt dużą różnicę ceny między serwisami, więc cena za granicą nie może dowolnie odbiegać od polskiej. Po drugie, dokumentacja zaznacza, że zdarzenie OFFER_PRICE_CHANGED dotyczy zmian ceny w serwisie bazowym, a nie w serwisach dodatkowych. Jeśli chcesz kontrolować ceny w CZK, EUR i HUF, odczytuj je okresowo z ofert. Opłaty dla rynku zagranicznego policzysz w podglądzie opłat POST /pricing/offer-fee-preview, podając identyfikator rynku i cenę w jego walucie.

Tłumaczenia, zamówienia i rozliczenia z serwisów zagranicznych w API

Tytuł i opis oferty Allegro tłumaczy automatycznie dla serwisów dodatkowych, a opis główny jest potrzebny tylko w serwisie bazowym. Własne tłumaczenia obsłużysz zasobami /sale/offers/{offerId}/translations: listę tłumaczeń pobierzesz metodą GET, własne tłumaczenie dla języka dodasz lub zmienisz przez PATCH, a usuniesz przez DELETE. Drzewo kategorii i parametry pobierzesz w wybranym języku dzięki nagłówkowi Accept-Language, np. z wartością cs-CZ - listę obsługiwanych języków podaje dokumentacja.

Po stronie zamówień najważniejsze jest rozróżnienie rynku. Zasoby GET /order/checkout-forms i GET /order/events zwracają obiekt marketplace z identyfikatorem serwisu, w którym dokonano zakupu, a listę zamówień przefiltrujesz po marketplace.id. Kwoty zamówienia są w walucie serwisu, a preferowany język kupującego znajdziesz w buyer.preferences.language. Identyfikator rynku mają też zwroty w zasobach customer-returns, wpisy w GET /billing/billing-entries i operacje w GET /payments/payment-operations, gdzie możesz filtrować także po walucie. Bez tych pól księgowość i obsługa klienta nie odróżnią zamówienia z Pragi od zamówienia z Krakowa.

Dwie rzeczy zostają wspólne lub zarezerwowane dla allegro.pl. Liczba sztuk w ofercie jest wspólna dla wszystkich serwisów, w których oferta jest widoczna, a oferty wielowariantowe, tagi ofertowe oraz rabaty i promocje dokumentacja opisuje jako funkcje dostępne tylko w serwisie allegro-pl.

Opcje promowania i kampanie dla serwisów dodatkowych

Opcje promowania, np. wyróżnienie, działają także za granicą, ale w API ustawiasz je osobno. Zasoby opcji promowania mają oddzielną część dla serwisu bazowego i dla serwisów dodatkowych, w której wskazujesz identyfikator rynku. Integracja, która promuje ofertę na allegro.pl, nie promuje jej automatycznie na allegro.cz. Podobnie kampanie i oznaczenia Allegro są przypisane do konkretnego serwisu, więc udział oferty w akcji na allegro.pl nie oznacza udziału w akcji na rynku zagranicznym.

Monitorowanie integracji po starcie sprzedaży za granicą

Po uruchomieniu rynków zagranicznych warto codziennie sprawdzać kilka wskaźników w swoim systemie: liczbę ofert w każdym stanie publikacji dla każdego rynku, nowe kody odrzucenia z dziennika zdarzeń, oferty bez ceny w walucie rynku oraz zamówienia, które nie zostały przypisane do żadnego rynku. Nagły wzrost odrzuceń zwykle oznacza zmianę po Twojej stronie, np. w cenniku dostaw albo w kategoriach, a spadek liczby ofert APPROVED na wszystkich rynkach naraz - problem na poziomie konta, np. z jakością sprzedaży.

Środowisko testowe Allegro dla serwisów zagranicznych

Sandbox to oddzielne środowisko Allegro do testów integracji, z własnymi kontami, aplikacjami i danymi, które nie trafiają do prawdziwych kupujących. Aplikację testową rejestrujesz w konsoli apps.developer.allegro.pl.allegrosandbox.pl, a według poradnika o serwisach zagranicznych Allegro udostępnia środowiska testowe także dla tych serwisów, w schemacie allegro.xx.allegrosandbox.pl, gdzie xx oznacza domenę rynku. Dzięki temu możesz sprawdzić wystawienie oferty, zmianę metod dostawy, odczyt statusów i obsługę zamówień bez ryzyka dla konta produkcyjnego. Pamiętaj, że konta, aplikacje i tokeny z sandboxa nie działają na produkcji i odwrotnie, więc konfigurację integracji trzeba przygotować osobno dla obu środowisk.

Sandbox nie zastąpi jednak wszystkich testów. Dane testowe są ubogie, a czas kwalifikacji czy tłumaczenia może wyglądać inaczej niż w serwisie produkcyjnym. Kiedy wystarczy środowisko testowe, a kiedy potrzebny jest kontrolowany test na produkcji, pokazuje porównanie:

[#chart:alz32c]

Praktyczny plan wdrożenia, który pozwala przejść z testów na produkcję bez niespodzianek:

  1. Pobierz GET /marketplaces i GET /me, zapisz serwis bazowy, waluty i języki w konfiguracji integracji.

  2. W sandboxie dodaj metody dostawy do jednego kraju i sprawdź przejście statusów od PENDING do APPROVED lub REFUSED.

  3. Obsłuż zdarzenie OFFER_VISIBILITY_CHANGED i zapisuj kody odrzucenia przy ofertach.

  4. Zdecyduj, czy integracja wysyła ceny w walucie rynku, czy zostawia je regułom cenowym.

  5. Rozdziel zamówienia, zwroty i operacje płatnicze według identyfikatora rynku i waluty.

  6. Na produkcji udostępnij za granicą małą grupę ofert i porównaj wyniki z sandboxem, zanim obejmiesz cały asortyment.

[#uwaga] Opisujemy zasoby i pola według dokumentacji developer.allegro.pl. API Allegro jest regularnie zmieniane, a część zasobów dostaje nowe wersje lub limity. Przed wdrożeniem sprawdź aktualną dokumentację, dziennik zmian i komunikaty dla integratorów, zwłaszcza w obszarze reguł cenowych i dostaw.

Jak Vinson pomaga firmom z własną integracją sprzedawać na Allegro za granicą

Jesteśmy agencją e-commerce z Bochni, działającą od 2021 roku. Pracowaliśmy z ponad 500 firmami, mamy status Allegro Ads Partner+, Google Partner i Meta Business Partner, jesteśmy certyfikowanym partnerem Base, partnerem Empik Place i autoryzowanym partnerem Shoper, a klienci oceniają nas na 4,9/5 ze 171 opinii. W ramach usługi sprzedaż na Allegro.cz z Vinson pomagamy firmom z własnymi systemami przygotować ofertę, ceny i procesy pod rynki zagraniczne.

  • Opis wymagań biznesowych dla zespołu IT: ceny, statusy, zamówienia i rozliczenia według rynku.

  • Wybór produktów i kontrola odrzuceń na allegro.cz, allegro.sk i allegro.hu.

  • Konfiguracja cenników dostaw i reguł cenowych w CZK, EUR i HUF.

  • Kampanie Allegro Ads na rynkach zagranicznych po uruchomieniu sprzedaży.

Najczęściej zadawane pytania

Jakie identyfikatory mają serwisy zagraniczne w API Allegro?

Serwisy konsumenckie mają identyfikatory allegro-pl, allegro-cz, allegro-sk i allegro-hu. Aktualną listę z walutami, językami i krajami dostawy zwraca zasób GET /marketplaces, a serwis bazowy konta - GET /me.

Jak przez API udostępnić ofertę na allegro.cz?

Dodaj do oferty metodę dostawy do Czech, np. przez cennik dostaw. Allegro zgłosi ofertę do kwalifikacji na allegro-cz, a wynik zobaczysz w polu publication.state w sekcji additionalMarketplaces oferty.

Czy ustawienie ceny w CZK przez API wyłącza Przelicznik cen?

Tak. Według dokumentacji developer.allegro.pl, gdy w ofercie z regułą cenową ustawisz własną cenę, Allegro automatycznie wyłącza regułę w tej ofercie. Integracja powinna więc albo zarządzać ceną w walucie sama, albo zostawić ją regule.

Jak sprawdzić w API, dlaczego oferta nie jest widoczna na allegro.sk?

Odczytaj publication.state dla allegro-sk w sekcji additionalMarketplaces. Przy stanie REFUSED powód podaje zdarzenie OFFER_VISIBILITY_CHANGED w GET /sale/offer-events, np. kod braku produktu, tłumaczenia albo metody dostawy.

Czy sandbox Allegro obsługuje serwisy zagraniczne?

Tak. Według poradnika developer.allegro.pl Allegro udostępnia środowiska testowe dla serwisów zagranicznych w schemacie allegro.xx.allegrosandbox.pl. Sandbox nie odda jednak w pełni zachowania produkcji, dlatego start warto zakończyć testem na małej grupie ofert.

Masz własną integrację i chcesz sprzedawać w Czechach, na Słowacji i na Węgrzech? Zobacz, jak prowadzimy sprzedaż na Allegro.cz z Vinson. Jeśli planujesz obsługę własnych tłumaczeń przez API, przeczytaj też wpis tłumaczenia ofert na Allegro za granicą - automatyczne czy własne.

Powody odrzucenia oferty w API Allegro - kody VQR

Gdy kwalifikacja się nie powiedzie, oferta dostaje stan REFUSED i powód odrzucenia. Zmiany widoczności Allegro odnotowuje w dzienniku zdarzeń ofert GET /sale/offer-events jako zdarzenie OFFER_VISIBILITY_CHANGED, więc integracja nie musi co chwilę pobierać wszystkich ofert, żeby wychwycić nowe odrzucenia. Listę ofert widocznych w danym serwisie pobierzesz z GET /sale/offers z filtrem publication.marketplace. Najczęstsze kody i sposób reakcji:

[#chart:alz32b]

Część kodów naprawia się sama. Tłumaczenie w toku zwykle znika po kilku chwilach, a brak ceny w walucie rynku rozwiązuje reguła Przelicznik cen. Inne wymagają pracy na danych. Brak produktu, czyli kod VQR008_OFFER_HAS_NO_PRODUCT, przy dużym asortymencie bywa najczęstszą przyczyną odrzuceń - jak uporządkować ten obszar, opisaliśmy we wpisie powiązanie z katalogiem Allegro jako warunek sprzedaży za granicą. Dobrą praktyką jest zapisywanie kodu odrzucenia przy ofercie w swoim systemie i raport, który grupuje oferty według powodu.

Ceny w walutach w API Allegro - cena oferty i reguły cenowe

Cena w serwisie dodatkowym znajduje się w sekcji additionalMarketplaces danego serwisu, w polu sellingMode.price z kwotą i walutą. Waluta musi być walutą bazową serwisu z GET /marketplaces, czyli np. CZK dla allegro-cz. Jeśli nie przekażesz ceny, Allegro ustala ją automatycznie, gdy aktywna jest reguła Przelicznik cen. Według dokumentacji, gdy oferta korzysta z reguły cenowej, a Ty ustawisz w niej własną cenę, Allegro automatycznie wyłącza regułę w tej ofercie. To najważniejsza zasada dla integracji: każde wysłanie ceny w walucie rynku jest decyzją o rezygnacji z automatycznego przeliczania.

Warto też wiedzieć, kiedy reguła zmienia cenę. Według pomocy Allegro Przelicznik cen nie reaguje na każdą zmianę kursu - przelicza cenę m.in. po zmianie ceny w serwisie bazowym, wznowieniu oferty lub edycji przypisanej reguły, a wersja automatyczna dla sprzedawców z Abonamentem Allegro aktualizuje ceny po zmianie kursu EBC o co najmniej 1% (stan na czerwiec 2026 - sprawdź aktualne zasady). Dla integracji oznacza to, że cena w CZK odczytana rano może być inna wieczorem, jeśli w międzyczasie zmieniłeś cenę w złotych.

Do pracy na regułach służą zasoby price-automation. Reguły pobierzesz i utworzysz przez /sale/price-automation/rules, przypiszesz lub odepniesz dla wybranego rynku przez POST /sale/offer-price-automation-commands, a reguły przypisane do oferty sprawdzisz w GET /sale/price-automation/offers/{offerId}/rules. Dokumentacja opisuje m.in. typy EXCHANGE_RATE (Przelicznik cen), FOLLOW_BY_ALLEGRO_MIN_PRICE (Najniższa cena na Allegro) i FOLLOW_BY_TOP_OFFER_PRICE (Top oferta). Konto może mieć maksymalnie 20 reguł, a korekta procentowa w regule nie może przekroczyć 50% (stan na czerwiec 2026 - sprawdź aktualną dokumentację).

Dwie pułapki warto znać przed wdrożeniem. Po pierwsze, kod VQR009_PRICE_IN_ADDITIONAL_MARKETPLACE_MISMATCH oznacza zbyt dużą różnicę ceny między serwisami, więc cena za granicą nie może dowolnie odbiegać od polskiej. Po drugie, dokumentacja zaznacza, że zdarzenie OFFER_PRICE_CHANGED dotyczy zmian ceny w serwisie bazowym, a nie w serwisach dodatkowych. Jeśli chcesz kontrolować ceny w CZK, EUR i HUF, odczytuj je okresowo z ofert. Opłaty dla rynku zagranicznego policzysz w podglądzie opłat POST /pricing/offer-fee-preview, podając identyfikator rynku i cenę w jego walucie.

Tłumaczenia, zamówienia i rozliczenia z serwisów zagranicznych w API

Tytuł i opis oferty Allegro tłumaczy automatycznie dla serwisów dodatkowych, a opis główny jest potrzebny tylko w serwisie bazowym. Własne tłumaczenia obsłużysz zasobami /sale/offers/{offerId}/translations: listę tłumaczeń pobierzesz metodą GET, własne tłumaczenie dla języka dodasz lub zmienisz przez PATCH, a usuniesz przez DELETE. Drzewo kategorii i parametry pobierzesz w wybranym języku dzięki nagłówkowi Accept-Language, np. z wartością cs-CZ - listę obsługiwanych języków podaje dokumentacja.

Po stronie zamówień najważniejsze jest rozróżnienie rynku. Zasoby GET /order/checkout-forms i GET /order/events zwracają obiekt marketplace z identyfikatorem serwisu, w którym dokonano zakupu, a listę zamówień przefiltrujesz po marketplace.id. Kwoty zamówienia są w walucie serwisu, a preferowany język kupującego znajdziesz w buyer.preferences.language. Identyfikator rynku mają też zwroty w zasobach customer-returns, wpisy w GET /billing/billing-entries i operacje w GET /payments/payment-operations, gdzie możesz filtrować także po walucie. Bez tych pól księgowość i obsługa klienta nie odróżnią zamówienia z Pragi od zamówienia z Krakowa.

Dwie rzeczy zostają wspólne lub zarezerwowane dla allegro.pl. Liczba sztuk w ofercie jest wspólna dla wszystkich serwisów, w których oferta jest widoczna, a oferty wielowariantowe, tagi ofertowe oraz rabaty i promocje dokumentacja opisuje jako funkcje dostępne tylko w serwisie allegro-pl.

Opcje promowania i kampanie dla serwisów dodatkowych

Opcje promowania, np. wyróżnienie, działają także za granicą, ale w API ustawiasz je osobno. Zasoby opcji promowania mają oddzielną część dla serwisu bazowego i dla serwisów dodatkowych, w której wskazujesz identyfikator rynku. Integracja, która promuje ofertę na allegro.pl, nie promuje jej automatycznie na allegro.cz. Podobnie kampanie i oznaczenia Allegro są przypisane do konkretnego serwisu, więc udział oferty w akcji na allegro.pl nie oznacza udziału w akcji na rynku zagranicznym.

Monitorowanie integracji po starcie sprzedaży za granicą

Po uruchomieniu rynków zagranicznych warto codziennie sprawdzać kilka wskaźników w swoim systemie: liczbę ofert w każdym stanie publikacji dla każdego rynku, nowe kody odrzucenia z dziennika zdarzeń, oferty bez ceny w walucie rynku oraz zamówienia, które nie zostały przypisane do żadnego rynku. Nagły wzrost odrzuceń zwykle oznacza zmianę po Twojej stronie, np. w cenniku dostaw albo w kategoriach, a spadek liczby ofert APPROVED na wszystkich rynkach naraz - problem na poziomie konta, np. z jakością sprzedaży.

Środowisko testowe Allegro dla serwisów zagranicznych

Sandbox to oddzielne środowisko Allegro do testów integracji, z własnymi kontami, aplikacjami i danymi, które nie trafiają do prawdziwych kupujących. Aplikację testową rejestrujesz w konsoli apps.developer.allegro.pl.allegrosandbox.pl, a według poradnika o serwisach zagranicznych Allegro udostępnia środowiska testowe także dla tych serwisów, w schemacie allegro.xx.allegrosandbox.pl, gdzie xx oznacza domenę rynku. Dzięki temu możesz sprawdzić wystawienie oferty, zmianę metod dostawy, odczyt statusów i obsługę zamówień bez ryzyka dla konta produkcyjnego. Pamiętaj, że konta, aplikacje i tokeny z sandboxa nie działają na produkcji i odwrotnie, więc konfigurację integracji trzeba przygotować osobno dla obu środowisk.

Sandbox nie zastąpi jednak wszystkich testów. Dane testowe są ubogie, a czas kwalifikacji czy tłumaczenia może wyglądać inaczej niż w serwisie produkcyjnym. Kiedy wystarczy środowisko testowe, a kiedy potrzebny jest kontrolowany test na produkcji, pokazuje porównanie:

[#chart:alz32c]

Praktyczny plan wdrożenia, który pozwala przejść z testów na produkcję bez niespodzianek:

  1. Pobierz GET /marketplaces i GET /me, zapisz serwis bazowy, waluty i języki w konfiguracji integracji.

  2. W sandboxie dodaj metody dostawy do jednego kraju i sprawdź przejście statusów od PENDING do APPROVED lub REFUSED.

  3. Obsłuż zdarzenie OFFER_VISIBILITY_CHANGED i zapisuj kody odrzucenia przy ofertach.

  4. Zdecyduj, czy integracja wysyła ceny w walucie rynku, czy zostawia je regułom cenowym.

  5. Rozdziel zamówienia, zwroty i operacje płatnicze według identyfikatora rynku i waluty.

  6. Na produkcji udostępnij za granicą małą grupę ofert i porównaj wyniki z sandboxem, zanim obejmiesz cały asortyment.

[#uwaga] Opisujemy zasoby i pola według dokumentacji developer.allegro.pl. API Allegro jest regularnie zmieniane, a część zasobów dostaje nowe wersje lub limity. Przed wdrożeniem sprawdź aktualną dokumentację, dziennik zmian i komunikaty dla integratorów, zwłaszcza w obszarze reguł cenowych i dostaw.

Jak Vinson pomaga firmom z własną integracją sprzedawać na Allegro za granicą

Jesteśmy agencją e-commerce z Bochni, działającą od 2021 roku. Pracowaliśmy z ponad 500 firmami, mamy status Allegro Ads Partner+, Google Partner i Meta Business Partner, jesteśmy certyfikowanym partnerem Base, partnerem Empik Place i autoryzowanym partnerem Shoper, a klienci oceniają nas na 4,9/5 ze 171 opinii. W ramach usługi sprzedaż na Allegro.cz z Vinson pomagamy firmom z własnymi systemami przygotować ofertę, ceny i procesy pod rynki zagraniczne.

  • Opis wymagań biznesowych dla zespołu IT: ceny, statusy, zamówienia i rozliczenia według rynku.

  • Wybór produktów i kontrola odrzuceń na allegro.cz, allegro.sk i allegro.hu.

  • Konfiguracja cenników dostaw i reguł cenowych w CZK, EUR i HUF.

  • Kampanie Allegro Ads na rynkach zagranicznych po uruchomieniu sprzedaży.

Najczęściej zadawane pytania

Jakie identyfikatory mają serwisy zagraniczne w API Allegro?

Serwisy konsumenckie mają identyfikatory allegro-pl, allegro-cz, allegro-sk i allegro-hu. Aktualną listę z walutami, językami i krajami dostawy zwraca zasób GET /marketplaces, a serwis bazowy konta - GET /me.

Jak przez API udostępnić ofertę na allegro.cz?

Dodaj do oferty metodę dostawy do Czech, np. przez cennik dostaw. Allegro zgłosi ofertę do kwalifikacji na allegro-cz, a wynik zobaczysz w polu publication.state w sekcji additionalMarketplaces oferty.

Czy ustawienie ceny w CZK przez API wyłącza Przelicznik cen?

Tak. Według dokumentacji developer.allegro.pl, gdy w ofercie z regułą cenową ustawisz własną cenę, Allegro automatycznie wyłącza regułę w tej ofercie. Integracja powinna więc albo zarządzać ceną w walucie sama, albo zostawić ją regule.

Jak sprawdzić w API, dlaczego oferta nie jest widoczna na allegro.sk?

Odczytaj publication.state dla allegro-sk w sekcji additionalMarketplaces. Przy stanie REFUSED powód podaje zdarzenie OFFER_VISIBILITY_CHANGED w GET /sale/offer-events, np. kod braku produktu, tłumaczenia albo metody dostawy.

Czy sandbox Allegro obsługuje serwisy zagraniczne?

Tak. Według poradnika developer.allegro.pl Allegro udostępnia środowiska testowe dla serwisów zagranicznych w schemacie allegro.xx.allegrosandbox.pl. Sandbox nie odda jednak w pełni zachowania produkcji, dlatego start warto zakończyć testem na małej grupie ofert.

Masz własną integrację i chcesz sprzedawać w Czechach, na Słowacji i na Węgrzech? Zobacz, jak prowadzimy sprzedaż na Allegro.cz z Vinson. Jeśli planujesz obsługę własnych tłumaczeń przez API, przeczytaj też wpis tłumaczenia ofert na Allegro za granicą - automatyczne czy własne.

Czy ten artykuł był pomocny? Oceń go
Bądź pierwszą osobą, która oceni

Oliwia Papież

Head of Operations

Zarządza operacjami agencji i procesami obsługi kont. Pilnuje, by każdy projekt był dowożony na czas i według standardów.

Zarządza operacjami agencji i procesami obsługi kont. Pilnuje, by każdy projekt był dowożony na czas i według standardów.

★★★★★
Współpracowałeś z Vinson?
Twoja opinia pomoże innym sprzedawcom wybrać sprawdzoną agencję. Zajmie Ci to minutę.
Oceń nas na Trustpilot →
Potrzebujesz pomocy z tym tematem?

Sprzedaż na Allegro.cz

Oliwia i nasz zespół pomogą Ci wdrożyć to na Twoim koncie - bez zobowiązań.

  • Analiza Twojego konta i obecnych działań
  • Konkretny plan poprawek do wdrożenia
  • Bezpłatna konsultacja – bez zobowiązań
4,9/5 ze 171 opiniiWdrażamy sprzedaż na Allegro.cz, .sk i .hu
Oliwia Papież - Head of Operations
Oliwia PapieżHead of Operations

Przeczytaj także

Więcej porad z naszej bazy wiedzy - przesuń, aby zobaczyć kolejne artykuły.

1 / 1

Masz pytania? Chętnie porozmawiamy!

Masz pytania? Chętnie porozmawiamy!

Odpowiadamy w ciągu 24 godzin w dni robocze. Pierwsza rozmowa jest bezpłatna i do niczego nie zobowiązuje.

Masz pytania? Chętnie porozmawiamy!

Odpowiadamy w ciągu 24 godzin w dni robocze. Pierwsza rozmowa jest bezpłatna i do niczego nie zobowiązuje.

Bartłomiej Stokłosa, CEO Vinson Agency

Bartłomiej Stokłosa

CEO & Founder

"Jeżeli czegoś nie da się zrobić, potrzebny jest ktoś, kto o tym nie wie - przyjdzie i to zrobi."

Bartłomiej Stokłosa, CEO Vinson Agency

Bartłomiej Stokłosa

CEO & Founder

"Jeżeli czegoś nie da się zrobić, potrzebny jest ktoś, kto o tym nie wie - przyjdzie i to zrobi."

Zadzwoń

574 944 685

Adres

Kazimierza Wielkiego 7/7

32-700 Bochnia

Wybierz dogodny termin w kalendarzu - bez wymiany maili w tę i z powrotem.

Napisz do nas

Opisz krótko, czego potrzebujesz - oddzwonimy lub odpiszemy w ciągu 24 godzin w dni robocze.

Oliwia PapieżNa zapytanie odpowie Oliwia Papież, Head of Operations

Napisz do nas

Opisz krótko, czego potrzebujesz - oddzwonimy lub odpiszemy w ciągu 24 godzin w dni robocze.

Oliwia PapieżNa zapytanie odpowie Oliwia Papież, Head of Operations
4,9172 opinii klientów · Trustindex →