Serwisy zagraniczne Allegro
W ramach międzynarodowej ekspansji, sprzedający mogą wyświetlać swoje oferty także w zagranicznych domenach serwisu Allegro. Dzięki zmianom, które wprowadziliśmy, sprzedawcy dotrą do szerszego grona potencjalnych klientów niż dotychczas. Co istotne, ofertę wystawiają tylko raz, a sprzedaż mogą prowadzić na wielu rynkach - nie muszą wystawiać dodatkowych ofert.
W poniższym artykule znajdziesz zbiór informacji o tym, jak obsłużyć sprzedaż i procesy posprzedażowe w ramach rynków zagranicznych.
Serwis bazowy użytkownika oraz lista dostępnych serwisów
Serwis bazowy to serwis, który automatycznie przypisujemy do konta na podstawie domeny, na której zarejestrował się sprzedający. Jeśli sprzedający założył konto np. na allegro.pl, serwisem bazowym będzie allegro-pl, analogicznie, serwisem bazowym dla rejestrujących się na allegro.cz, będzie allegro-cz, itp.
Aktywne oferty sprzedającego będą zawsze widoczne w serwisie bazowym. Walidację oferty podczas jej aktywacji przeprowadzimy domyślnie również w ramach serwisu bazowego.
Identyfikator serwisu bazowego zwracamy w polu "baseMarketplace.id" w odpowiedzi dla GET /me:
Przykładowy response:
{
"id": "46968690",
"login": "Client:46968690",
...
"baseMarketplace": {
"id": "allegro-pl"
},
...
}Serwisy dodatkowe to pozostałe serwisy Allegro, na których sprzedawca może wyświetlić swoje oferty i tym samym sprzedawać produkty na zagranicznych rynkach. Przykładowo - jeśli serwisem bazowym sprzedającego jest allegro-pl, to serwisami dodatkowymi są allegro-cz oraz pozostałe.
Sprzedający wystawia ofertę tylko raz, w ramach serwisu bazowego, ale może decydować o tym, na których serwisach dodatkowych może być wyświetlana.
Za pomocą GET /marketplaces sprawdzisz ID serwisów, w których użytkownik może wyświetlić swoje oferty. Znajdziesz tu również inne dane, które dotyczą konkretnego serwisu, np. języki, w jakich oferta może być utworzona, a także wyświetlona kupującemu, dostępne waluty oraz kraje dostawy.
Przykładowy response:
{
"marketplaces": [ - lista dostępnych serwisów
{
"id": "allegro-pl", - ID dostępnego serwisu
"languages": {
“offerCreation” : [ - języki, w jakich oferta może być utworzona
{
"code": "pl-PL"
},
{
"code": "en-US"
}
],
"offerDisplay": [ - języki, w jakich oferta może być wyświetlona kupującemu
{
"code”: “uk-UA"
},
{
"code": "en-US"
},
{
"code": "cs-CZ"
}
]
}
"currencies": { - dostępne waluty
"base": {
"code": "PLN" - waluta bazowa dla danego serwisu
},
"additional": [ - pozostałe waluty dostępne tylko dla kupującego
{
"code": "EUR"
},
{
"code": "USD"
}
]
},
"shippingCountries": [ - dostępne kraje dostawy dla danego serwisu
{
"code": "PL"
},
{
"code": "CZ"
},
{
"code": "DE"
}
]
},
{
"id": "allegro-cz",
"languages": {
“offerCreation” : [
{
"code": "cs-CZ"
},
{
"code": "en-US"
}
],
“offerDisplay”: [
{
"code": "pl-PL"
},
{
“code”: "en-US"
},
{
“code”: "cs-CZ"
}
]
}
"currencies": {
"base": {
"code": "CZK"
},
"additional": [
{
"code": "EUR"
},
{
"code": "USD"
},
{
"code": "PLN"
}
]
},
"shippingCountries": [
{
"code": "CZ"
},
{
"code": "PL"
},
{
"code": "SK"
}
]
}
]
}Warunki, jakie musi spełnić oferta, abyśmy wyświetlili ją w serwisach dodatkowych
Serwis dodatkowy sprzedający wybierze tylko dla ofert, które:
- są wystawione przez zweryfikowane konto firmowe,
- są oferowane tylko jako Kup Teraz,
- nie są ofertą charytatywną,
- nie są ofertą B2B.
Oferty muszą przejść dodatkowy proces kwalifikacji, zanim wyświetlimy je w serwisie dodatkowym. Uruchomimy go:
- podczas aktywacji oferty,
- podczas edycji oferty,
- dla aktywnej już oferty, dla której dodasz chęć widoczności oferty w serwisie dodatkowym.
Sprawdzimy, czy oferta:
- ma co najmniej jedną metodę dostawy prawidłową dla serwisu dodatkowego,
- ma cenę w walucie serwisu dodatkowego,
- ma tłumaczenie na język powiązany z serwisem dodatkowym (ofertę przetłumaczymy automatycznie, jeśli będzie spełniać pozostałe warunki do wyświetlenia w serwisie dodatkowym),
- znajduje się w kategorii asortymentowej, dla której istnieje odpowiednia kategoria w serwisie dodatkowym.
Automatyczne przeliczanie cen
Jak obliczamy ceny
Ceny obliczamy na podstawie informacji o kursach publikowanych przez Europejski Bank Centralny.
Podane przez Ciebie ceny w walucie serwisu bazowego przeliczamy na walutę serwisu dodatkowego według wzoru:
cena w walucie serwisu bazowego x kurs walut = cena w walucie serwisu dodatkowego
Europejski Bank Centralny publikuje informacje o kursie walut raz dziennie. Dlatego gdy skorzystasz z przelicznika cen, zaktualizuje on ceny na podstawie informacji o kursie z poprzedniego dnia roboczego, np. Europejski Bank Centralny publikuje dane o 16:21 w piątek. Na Allegro nowy kurs obowiązuje od godziny 00:00:01 w poniedziałek, aż do wtorku 00:00:01.
Dodatkowe informacje:
- ceny w ofertach, które są widoczne w serwisach dodatkowych, przeliczymy automatycznie zawsze, gdy zmienisz cenę w serwisie bazowym,
- gdy w ofercie korzystasz z przelicznika cen, ale zdecydujesz się ustawić w niej własną cenę w serwisie dodatkowym – automatycznie wyłączymy przelicznik cen w tej ofercie,
- przelicznik wylicza cenę w serwisach dodatkowych na podstawie ceny w serwisie bazowym. Nie uwzględnia cen, które zostały obniżone w związku z udziałem w kampaniach i programach,
- gdy wznawiasz ofertę z włączonym przelicznikiem cen, zaktualizujemy w niej cenę w walucie serwisu dodatkowego zgodnie z aktualnym kursem.
Jak pobrać dostępne reguły przelicznika cen
Wykonasz to za pomocą GET /sale/price-automation/rules. Aktualnie zawsze zwrócimy listę jednoelementową, która zawiera regułę typu “EXCHANGE_RATE” - zgodnie z nią, ceny w ofertach serwisów dodatkowych przeliczymy zgodnie z aktualnym kursem wymiany. Zasób jest dodatkowo limitowany do 5 requestów na sekundę.
Przykładowy request:
curl -X GET \
'https://api.allegro.pl/sale/price-automation/rules' \
-H 'Accept: application/vnd.allegro.public.v1+json' \
-H 'Content-Type: application/vnd.allegro.public.v1+json' \
-H 'Authorization: Bearer {token}' \Przykładowy response:
{
"rules": [
{
"id": "641c73feaef0a8281a3d11f8", - ID reguły przelicznika cen
"type": "EXCHANGE_RATE", - typ reguły. Aktualnie zwrócimy wyłącznie
“EXCHANGE_RATE”, co oznacza przeliczenie
cen według kursu wymiany
"updatedAt": "2023-03-23T15:45:02Z" - data ostatniej zmiany w reguly. Możliwość
modyfikacji reguł udostępnimy w późniejszym
terminie
}
]
}Jak przypisać i usunąć reguły przelicznika cen w ofertach
Użyj w tym celu POST /sale/offer-price-automation-commands. Zasób jest dodatkowo limitowany do 250 tys. zmian w pojedynczej ofercie na godzinę lub 9 tys. na minutę.
Przykładowy request:
curl -X POST \
'https://api.allegro.pl/sale/offer-price-automation-commands' \
-H 'Accept: application/vnd.allegro.public.v1+json' \
-H 'Content-Type: application/vnd.allegro.public.v1+json' \
-H 'Authorization: Bearer {token}' \Przykładowy response:
{
"id": "123a08d7-ab9b-460d-b9cb-d6ed64b3a018", - niewymagane, ID komendy. Jeśli
nie przekażesz wartości w tym polu,
ID w odpowiedzi wygenerujemy
automatycznie
"modification": { - informacje o modyfikacji reguł
przeliczania cen. Przekaż
jedno z pól: set (przypisanie reguły)
albo “remove” (usunięcie)
"set": [
{
"marketplace": {
"id": "allegro-cz" - ID serwisu, do którego chcesz
przypisać regułę przelicznika cen
podaną w polu rule.id
},
"rule": {
"id": "641c73feaef0a8281a3d11f8" - ID reguły przelicznika cen.
Dostępne wartości pobierzesz za
pomocą GET
/sale/price-automation/rules
}
}
],
"remove": [
{
"marketplace": {
"id": "allegro-xx" - ID serwisu, w którym chcesz usunąć
biężącą regułę przelicznika cen
}
}
]
},
"offerCriteria": [
{
"offers": [ - wymagane, tablica obiektów z
numerami identyfikacyjnymi ofert -
maksymalnie 1000 ofert
{
"id": "123456789"
}
],
"type": "CONTAINS_OFFERS" - wymagane, obecnie dostępna jest
jedna wartość: CONTAINS_OFFERS
(oferty, w których zmienimy ustawienia
reguł)
}
]
}Przykładowy response:
{
"id": "0e09c6fe-dabd-42b7-8bbe-4daa1526df80", - ID komendy
"createdAt": "2019-08-24T14:15:22Z", - data utworzenia zadania
"completedAt": null, - data realizacji zadania (dla tej metody zawsze zwrócimy null)
"taskCount": {
"total": 0,
"success": 0,
"failed": 0
}
}Aby sprawdzić status wykonania zadania, skorzystaj z GET /sale/offer-price-automation-commands/{commandId}. W odpowiedzi otrzymasz zestawienie, w ilu ofertach operacja wykonała się poprawnie, a z iloma wystąpił problem.
Przykładowy request:
curl -X GET \
'https://api.allegro.pl/sale/offer-price-automation-commands/123a08d7-ab9b-460d-b9cb-d6ed64b3a018' \
-H 'Accept: application/vnd.allegro.public.v1+json' \
-H 'Content-Type: application/vnd.allegro.public.v1+json' \
-H 'Authorization: Bearer {token}' \Przykładowy response:
{
"id": "123a08d7-ab9b-460d-b9cb-d6ed64b3a018",
"createdAt": "2019-08-24T14:15:22Z",
"completedAt": "2019-08-24T14:15:22Z",
"taskCount": {
"total": 2,
"success": 2,
"failed": 0
}
}Jeśli chcesz pobrać szczegółowy raport, użyj w tym celu GET /sale/offer-price-automation-commands/{commandId}/tasks.
Przykładowy request:
curl -X GET \
'https://api.allegro.pl/sale/offer-price-automation-commands/123a08d7-ab9b-460d-b9cb-d6ed64b3a018/tasks' \
-H 'Accept: application/vnd.allegro.public.v1+json' \
-H 'Content-Type: application/vnd.allegro.public.v1+json' \
-H 'Authorization: Bearer {token}' \Przykładowy response:
{
"tasks": [
{
"offer": {
"id": "1234567"
},
"message": null,
"status": "SUCCESS",
"field": "repricing",
"errors": []
}
]
}Oba wyżej wymienione zasoby są dodatkowo limitowane do 270 tys. ofert w zleconych komendach na minutę.
Jak sprawdzić aktualnie przypisane reguły przelicznika cen w ofercie
Użyj w tym celu GET /sale/price-automation/offers/{offerId}/rules. Zasób jest dodatkowo limitowany do 5 requestów na sekundę.
Przykładowy request:
curl -X GET \
'https://api.allegro.pl/sale/price-automation/offers/123456789/rules' \
-H 'Accept: application/vnd.allegro.public.v1+json' \
-H 'Content-Type: application/vnd.allegro.public.v1+json' \
-H 'Authorization: Bearer {token}' \Przykładowy response:
{
"rules": [
{
"marketplace": {
"id": "allegro-pl" - ID serwisu, którego dotyczy dana reguła
},
"rule": {
"id": "641c73feaef0a8281a3d11f8", - ID reguły przelicznika cen
"type": "EXCHANGE_RATE" - typ reguły przelicznika cen
},
"updatedAt": "2023-03-23T15:45:02Z" - data, kiedy dana reguła była ostatnio
modyfikowana
}
],
"updatedAt": "2023-03-23T15:45:02Z" - data, kiedy ostatnio nastąpiła zmiana w
przypisaniu reguł w ofercie
}Wyświetlanie ofert w serwisach dodatkowych
Aby oferta mogła przejść proces kwalifikacji i być tym samym wyświetlona w serwisie dodatkowym, musisz zadeklarować chęć widoczności oferty w danym serwisie. W zasobach:
- /sale/product-offers,
- /sale/product-offers/{offerId},
w polach:
- publication.marketplaces.base - sprawdzisz serwis bazowy oferty. Wartość w polu nadajemy automatycznie w momencie stworzenia oferty i jest tylko do odczytu, nigdy się nie zmieni;
- publication.marketplaces.additional - zdefiniujesz serwisy dodatkowe, gdzie sprzedający może określić, czy jego oferta ma być w nich widoczna. Pole to nie jest obowiązkowe. Brak tego pola zinterpretujemy jako pustą tablicę, która będzie równoznaczna z brakiem chęci wyświetlania oferty w serwisach dodatkowych (oferta będzie widoczna tylko w jej serwisie bazowym).
Przykładowa struktura:
{
…
"publication": {
"marketplaces": {
"base": {
"id": "allegro-pl" - ID serwisu bazowego, wartość nadamy
automatycznie na podstawie danych z konta
sprzedającego
},
"additional": [ - zbiór ID serwisów dodatkowych, w których
mamy wyświetlić ofertę. Listę pobierzesz za
pomocą GET /marketplaces
{
"id": "allegro-cz"
}
]
}
},
…
}w sekcji additionalMarketplaces.{marketplaceId}:
sprzedający zadeklaruje cenę oferty dla wybranego serwisu dodatkowego w polu sellingMode.price. Cenę w tym polu sprzedający musi podać w walucie prawidłowej dla danego serwisu, co jest określone w konfiguracji dostępnej w zasobie GET /marketplaces. Jeśli nie chcesz definiować ceny manualnie, skorzystaj z naszego przelicznika cen.
zwracamy informację o statusie widoczności oferty w danym serwisie dodatkowym w polu publication.state. Pole jest tylko do odczytu i przyjmuje jedną z poniższych wartości:
- "APPROVED" - oferta jest widoczna w danym serwisie dodatkowym, jeżeli jest aktywna,
- "REFUSED" - oferta lub sprzedający nie spełniają warunków wymaganych do wyświetlenia oferty w danym serwisie dodatkowym,
- "IN_PROGRESS" - trwa proces kwalifikacji oferty do widoczności w danym serwisie dodatkowym,
- "NOT_REQUESTED" - sprzedający nie zaznaczył intencji widoczności w danym serwisie dodatkowym (w polu publication.marketplaces.additional),
- “PENDING” - sprzedający zaznaczył intencję widoczności w danym serwisie dodatkowym, jednak proces kwalifikacji oferty nie rozpoczął się np. ze względu na status oferty (tylko oferty aktywne podlegają procesowi kwalifikacji widoczności).
Informację o zmianie statusu widoczności w serwisie dodatkowym otrzymasz w ramach dziennika ofertowego, w odpowiedzi GET /sale/offer-events zwrócimy zdarzenie "OFFER_VISIBILITY_CHANGED". Dodatkowo, dla statusu “REFUSED” podamy konkretny powód odrzucenia.
Przykładowa struktura:
{
…
"additionalMarketplaces": {
"allegro-cz": { - serwis dodatkowy allegro-cz (czeska domena serwisu)
"publication": {
"state": "APPROVED" - status widoczności w serwisie dodatkowym, w tym
przypadku wartość wskazuje na to, że oferta jest wyświetlana
w serwisie dodatkowym
},
"sellingMode": {
"price": { - cena oferty w serwisie dodatkowym
"amount": "629",
"currency": "CZK"
}
}
},
"allegro-xy": { - teoretyczny przykład innego serwisu
dodatkowego
"publication": {
"state": "NOT_REQUESTED"
}
}
}
…
}Aby sprawdzić, które oferty wyświetlamy w danym serwisie, skorzystaj z GET /sale/offers i parametru publication.marketplace={marketplaceId}. Czyli, aby zobaczyć które oferty widoczne są na stronie allegro.cz, zbuduj następujący request - GET /sale/offers?publication.marketplace=allegro-cz.
Grupowe zarządzanie ofertami
W serwisach dodatkowych sprzedający może grupowo zmienić:
- PUT /sale/offer-modification-commands/{commandId} - chęć widoczności oferty
Przykładowy request:curl -X PUT \ 'https://api.allegro.pl/sale/offer-modification-commands/{commandId}' \ -H 'Accept: application/vnd.allegro.public.v1+json' \ -H 'Content-Type: application/vnd.allegro.public.v1+json' \ -H 'Authorization: Bearer {token}' \ -d '{ "modification": { "publication": { "marketplaces": { "additional": { "add": [ - dodaj możliwość widoczności oferty w serwisach dodatkowych { "id": "allegro-cz" - ID serwisu dodatkowego, który możesz pobrać za pomocą GET /marketplaces } ], "remove": [] - usuń możliwość widoczności oferty w serwisach dodatkowych } } } }, "offerCriteria": [ { "type": "CONTAINS_OFFERS", "offers": [ { "id": "1529278070" } ] } ] }' - PUT /sale/offer-price-change-commands/{commandId} - cenę
Przykładowy request:curl -X PUT \ 'https://api.allegro.pl/sale/offer-price-change-commands/{commandId}' \ -H 'Accept: application/vnd.allegro.public.v1+json' \ -H 'Content-Type: application/vnd.allegro.public.v1+json' \ -H 'Authorization: Bearer {token}' \ -d '{ "modification": { "type": "FIXED_PRICE", "marketplaceId": "allegro-cz", - ID serwisu allegro na którym chcesz zmienić cenę "price": { "amount": 70, "currency": "CZK" } }, "offerCriteria": [ { "type": "CONTAINS_OFFERS", "offers": [ { "id": "13529278070" } ] } ] }'
Więcej informacji o grupowym zarządzaniu ofertami znajdziesz w naszym poradniku.
Zarządzanie zamówieniami
Jak rozpoznać, w jakim serwisie zostało złożone zamówienie
Sprawdzisz to w obiekcie "marketplace", gdzie w polu "id" zwracamy identyfikator serwisu, w którym kupujący zakupił przedmiot.
Obiekt zwracamy w:
Za pomocą parametru wyszukiwania "marketplace.id" w zasobie /order/checkout-forms możesz filtrować zamówienia dla wskazanego serwisu.
Informację o preferencjach językowych kupującego zwracamy w polu “buyer.preferences.language”.
Więcej informacji o zarządzaniu zamówieniami znajdziesz w naszym poradniku.
Jak rozpoznać, z jakiego serwisu pochodzi zwrot od klienta
Sprawdzisz to w polu “marketplaceId” w odpowiedzi:
- GET /order/customer-returns,
- GET /order/customer-returns/{customerReturnId},
- POST /order/customer-returns/{customerReturnId}/rejection,
w którym zwracamy informację, jakiego serwisu dotyczy dany zwrot.
Więcej informacji o zwrotach klienckich znajdziesz w naszym poradniku.
Zarządzanie opcjami promowania
Jak zarządzać promowaniem pojedynczej oferty
Za pomocą GET /sale/offers/{offerId}/promo-options edytujesz opcje promowania pojedynczej oferty. W sekcji:
- “modifications” - ustawisz promowanie dla oferty w serwisie bazowym,
- “additionalMarketplaces” - przekażesz informacje o opcjach promowania dla serwisów dodatkowych.
Przykładowy request
curl -X POST \
'https://api.allegro.pl/sale/offers/9531382307/promo-options-modification \
-H 'Authorization: Bearer {token}' \
-H 'Accept: application/vnd.allegro.public.v1+json' \
-H 'Content-Type: application/vnd.allegro.public.v1+json'
{
"modifications": [], - tu zmienisz opcje promowania
w serwisie bazowym
"additionalMarketplaces": [ - tu zmienisz opcje promowania
w serwisach dodatkowych
{
"marketplaceId": "allegro-pl",
"modifications": [
{
"modificationType": "CHANGE",
"packageType": "BASE",
"packageId": "emphasized10d"
}
]
}
]
}Gdy skorzystasz z GET /sale/offers/{offerId}/promo-options, w odpowiedzi uzyskasz informacje o opcjach promowania oferty dla serwisu:
- bazowego - w polu “marketplaceId”,
- dodatkowego - w sekcji “additionalMarketplaces”, w polu “marketplaceId”.
Przykładowy response
{
"offerId": "9531382307",
"marketplaceId": "allegro-cz", - serwis bazowy oferty
"basePackage": null,
"extraPackages": [],
"pendingChanges": null,
"additionalMarketplaces": [ - serwisy dodatkowe oferty
{
"marketplaceId": "allegro-pl",
"basePackage": {
"id": "emphasized10d",
"validFrom": "2020-01-01T00:00:00Z",
"validTo": "2020-01-01T00:00:00Z",
"nextCycleDate": "2020-01-01T00:00:00Z"
},
"extraPackages": [],
"pendingChanges": null
}
]
}Jak grupowo zarządzać promowaniem ofert
Za pomocą PUT /sale/offers/promo-options-commands/{commandId} edytujesz opcje promowania wielu ofert. W sekcji:
- “modification”- dla wybranych ofert ustawisz opcje promowania w serwisie bazowym,
- “additionalMarketplaces” - dla wybranych ofert przekażesz informacje o opcjach promowania w serwisach dodatkowych.
Przykładowy request
curl -X PUT \
'https://api.allegro.pl/sale/offers/promo-options-commands/{commandId} \
-H 'Authorization: Bearer {token}' \
-H 'Accept: application/vnd.allegro.public.v1+json' \
-H 'Content-Type: application/vnd.allegro.public.v1+json'
{
"offerCriteria": [
{
"offers": [
{
"id": "9531382307"
},
{
"id": "9531382308"
}
],
"type": "CONTAINS_OFFERS"
}
],
"modification": {}, - ta sekcja dotyczy serwisu bazowego
"additionalMarketplaces": [ - ta sekcja dotyczy serwisów dodatkowych
{
"marketplaceId": "allegro-pl",
"modification": {
"basePackage": {
"id": "emphasized10d"
},
"extraPackages": [],
"modificationTime": "NOW"
}
}
]
}Jak sprawdzić aktualne opcje promowania przypisanych do ofert w serwisach dodatkowych
Za pomocą GET /sale/offers/promo-options pobierzesz aktualne opcje promowania przypisane do ofert sprzedającego.
Przykładowy response
{
"promoOptions": [
{
"offerId": "9531382307",
"marketplaceId": "allegro-cz",
"basePackage": null,
"extraPackages": [],
"pendingChanges": null,
"additionalMarketplaces": [
{
"marketplaceId": "allegro-pl",
"basePackage": {
"id": "promoPackage",
"validFrom": "2020-01-01T00:00:00Z",
"validTo": "2020-01-01T00:00:00Z",
"nextCycleDate": "2020-01-01T00:00:00Z"
},
"extraPackages": [],
"pendingChanges": null
}
]
}
],
"count": 1,
"totalCount": 1
}Więcej informacji o zarządzaniu opcjami promowania znajdziesz w naszym poradniku.
Sprawdzanie opłat
Historia operacji billingowych
W zasobie /billing/billing-entries, za pomocą parametru "marketplaceId”, sprawdzisz historię operacji billingowych dla wybranego serwisu, np. allegro-cz.
Jeżeli nie użyjesz parametru "marketplaceId", to domyślnie zwrócimy serwis bazowy, np. allegro-pl.
Więcej informacji o historii operacji billingowych znajdziesz w naszym poradniku.
Historia operacji płatniczych
W zasobie /payments/payment-operations, dzięki któremu pobierzesz historię operacji na saldzie zalogowanego sprzedającego, udostępniamy:
pole marketplaceId - identyfikator serwisu, na którym została przeprowadzona operacja płatnościowa. Jeśli operacja odbywa się w ramach konta Allegro, a nie konkretnego serwisu np. dla wypłaty środków z konta, to w takiej sytuacji zwrócimy wartość null, zwrócimy ją także dla części operacji sprzed 10 lutego 2023;
parametry, dzięki którym przefiltrujesz wyniki:
- marketplaceId - identyfikator serwisu, na którym została przeprowadzona operacja płatnościowa,
- currency - waluta, w której została przeprowadzona operacja,Więcej informacji o historii operacji płatniczych znajdziesz w naszym poradniku.
Kalkulator opłat
Za pomocą kalkulatora opłat sprzedający mogą sprawdzić, jakie opłaty pobieramy dla konkretnej oferty w serwisie bazowym.
Aby sprawdzić koszty wystawienia oferty w konkretnym serwisie bazowym, przekaż:
- pole “marketplaceId” wraz z identyfikatorem danego serwisu, np. “allegro-cz”,
- cenę w walucie odpowiadającej wybranemu rynkowi, np. "currency": "CZK".
Jeżeli w żądaniu nie przekażesz pola “marketplaceId”, domyślnie ustawimy wartość serwisu bazowego, np. “allegro-pl”.
Więcej informacji o kalkulatorze opłat znajdziesz w naszym poradniku.
Informacje dodatkowe
Ustawienia dostawy
Gdy edytujesz ustawienia dostawy za pomocą PUT /sale/delivery-settings, możesz przekazać dodatkową strukturę, aby określić serwis, którego mają dotyczyć ustawienia:
{
"marketplace": {
"id": "allegro-cz"
}Taką samą informację zwrócimy, gdy pobierzesz ustawienia dostawy.
Pole jest opcjonalne, jeśli go nie podasz, domyślnie przypiszemy do niego serwis bazowy. Jeśli podasz błędny identyfikator serwisu, zwrócimy błąd 422.
W ramach GET /sale/delivery-settings możesz wyfiltrować ustawienia dostawy dla wskazanego serwisu - skorzystaj w tym celu z parametru marketplace={marketplaceId}, np. GET /sale/delivery-settings?marketplace=allegro-cz.
Więcej o ustawieniach dostawy znajdziesz w naszym poradniku.
Metody dostawy
W odpowiedzi GET /sale/delivery-methods znajdziesz oznaczenie, które wskazuje, w jakich serwisach będzie widoczna dana metoda dostawy:
"marketplaces": [
"allegro-pl"
],Dostępny jest również filtr wyszukiwania po identyfikatorze serwisu - "marketplace", który pozwoli pobrać tylko te metody, które są dostępne w danym serwisie. Obecnie wszystkie metody dostawy, oprócz "Przesyłka elektroniczna (e-mail)", mają przypisany jeden identyfikator serwisu.
Więcej informacji o metodach i cennikach dostawy znajdziesz w naszym poradniku.
Kwalifikacja ofert i sprzedawcy w programie Allegro Smart!
W ramach zasobów, dzięki którym sprawdzisz kwalifikację ofert i sprzedawcy w programie Allegro Smart!:
- GET /sale/offers/{offerId}/smart,
- GET /sale/smart,możesz skorzystać z parametru filtrowania “marketplaceId”.
Dzięki niemu otrzymasz kwalifikację dla wybranego serwisu. Jeżeli nie użyjesz parametru, to domyślnie zwrócimy informacje dla serwisu bazowego.
Więcej informacji o kwalifikacji ofert i sprzedawcy w programie Allegro Smart! znajdziesz w naszym poradniku.
Ograniczenia w zasobach
Część zasobów i funkcjonalności udostępniamy wyłącznie w ramach serwisu allegro-pl:
FAQ
Jeśli wystawiam ofertę na wielu serwisach dodatkowych, to czy w każdym przypadku mogę uwzględnić jeden, ten sam produkt, czy będzie on inny dla każdego serwisu?
Identyfikator produktu zawsze będzie taki sam dla każdego z serwisów.
Czy mogę ustawić liczbę sztuk dostępnych przedmiotów osobno dla każdego z rynków? Np. 15 sztuk dla allegro.pl, a 5 sztuk dla allegro.cz?
Nie, liczba sztuk to część wspólna dla wszystkich serwisów, w których wyświetlamy ofertę.
Czy jest możliwa sytuacja, gdzie dla jednego z serwisów dodatkowych otrzymam inne parametry niż dla serwisu bazowego?
Nie, drzewo kategorii i parametry są wspólne dla wszystkich serwisów. Może jedynie wystąpić sytuacja, gdzie dana kategoria będzie wyłączona na jednym z serwisów, np. dozwolona prawnie jest sprzedaż produktu A w Polsce, ale w Czechach już nie.
Czy, gdy wystawiam ofertę np. na allegro.cz, mogę zamiast waluty w CZK określić ją w EUR?
Nie, dokładną informację, w jakiej walucie musisz określić cenę w danym serwisie, zwracamy w odpowiedzi GET /marketplaces, w polu “marketplaces[].currencies.base”.
Zmieniłem cenę w serwisie dodatkowym, jednak nie otrzymałem eventu “OFFER_PRICE_CHANGED" w dzienniku ofertowym GET /sale/offer-events. Czy to zamierzone działanie?
Tak, aktualnie zwracamy ten wpis tylko dla zmiany ceny oferty w serwisie bazowym.
Jakie przyczyny mogę otrzymać w dzienniku ofertowym GET /sale/offer-events w polu “refusalReasons”, jeśli oferta nie zakwalifikuje się do wyświetlenia w serwisie dodatkowym?
Jeśli oferta nie zakwalifikuje się do wyświetlenia w serwisie dodatkowym zwrócimy jeden lub więcej z poniższych wpisów:
- VQR001_CURRENCY_NOT_AVAILABLE - brak ceny w walucie serwisu dodatkowego,
- VQR002_LANGUAGE_NOT_AVAILABLE - brak tłumaczenia opisu oferty,
- VQR003_DELIVERY_TO_OPERATIONAL_COUNTRY_NOT_AVAILABLE - brak metody dostawy związanej z serwisem dodatkowym,
- VQR006_TRANSLATION_PENDING - tłumaczenie w trakcie,
- VQR007_CATEGORY_NOT_VISIBLE_IN_NAVIGATION_TREE - oferta wystawiona w niedostępnej kategorii w serwisie dodatkowym,
- VQR008_OFFER_HAS_NO_PRODUCT - brak połączenia z Katalogiem Produktów,
- VQR009_PRICE_IN_ADDITIONAL_MARKETPLACE_MISMATCH - zbyt duża różnica w cenie między serwisem bazowym a serwisem dodatkowym.
Czy w serwisach innych niż allegro.pl mogę utworzyć ofertę wielowariantową?
Nie, oferty wielowariantowe wspieramy wyłącznie dla allegro.pl.
Czy jeśli wystawiam ofertę na dwóch różnych serwisach, to muszę przekazać opis w dwóch językach?
Nie, wystarczy główny opis dla oferty w serwisie bazowym. Po naszej stronie automatycznie przetłumaczymy tytuł i opis dla serwisów dodatkowych.
Czy drzewo kategorii i parametrów mogę pobrać w innym języku niż polski?
Tak, korzystając z nagłówka ‘Accept-Language’ można pobrać drzewo kategori i parametry i w jednym z danych języków: pl-PL, en-US, cs-CZ i uk-UA.
Czy istnieją środowiska testowe dla serwisów innych niż allegro.pl?
Tak, na tę chwilę udostępniamy czeskiego Sandboxa - allegro.cz.allegrosandbox.pl.
Próbuję wystawić ofertę na rynek czeski, jednak w odpowiedzi otrzymuję “Platforms other than allegro.pl only support offers with a product linked”. Oferta wyświetla się prawidłowo na allegro.pl.
Jednym z warunków, aby oferta była widoczna w serwisie dodatkowym, jest to, aby była połączona z produktem - wtedy, po spełnieniu pozostałych wymagań, będzie widoczna w serwisie dodatkowym.