Konto i dane użytkownika
Dowiedz się, jak zarządzać kontem oraz danymi użytkownika przez API Allegro.
Informacje o użytkowniku
Za pomocą GET /me pobierzesz podstawowe informacje o użytkowniku, którego token przesyłasz w requeście.
Przykładowy request:
curl -X GET \
'https://api.allegro.pl/me' \
-H 'Accept: application/vnd.allegro.public.v1+json' \
-H 'Content-Type: application/vnd.allegro.public.v1+json'
Przykładowy response:
{
"id": "12345678", - ID użytkownika
"login": "test_account", - login użytkownika
"email": "test_account@allegro.pl", - adres email użytkownika
"baseMarketplace": {
"id": "allegro-pl" - serwis bazowy użytkownika
},
"company": {
"name": "Allegro.pl Sp. z o.o.", - nazwa firmy
"taxId": "123-123-12-12" - numer NIP
},
"features": [ - cechy konta sprzedawcy
"SUPER_SELLER" - konto ma status Super Sprzedawcy
"ONE_FULFILLMENT" - konto używa usługi One Fulfillment by Allegro
]
}
Ocena sprzedaży
Jak pobrać informacje o ocenie sprzedaży
Skorzystaj w tym celu z GET /sale/user-ratings. W odpowiedzi otrzymasz oceny sprzedaży użytkownika, którego token przesyłasz w requeście. W żądaniu możesz użyć parametrów:
- recommended - który przyjmuje wartość true lub false (oceny pozytywne lub negatywne). Jeżeli nie określisz tego parametru, domyślnie zwrócimy listę wszystkich ocen;
- lastChangedAt.gte - w którym określasz najwcześniejszą datę stworzenia oceny lub ostatniej edycji (jeżeli ocena była edytowana);
- lastChangedAt.lte - w którym określasz najpóźniejszą datę stworzenia oceny lub ostatniej edycji (jeżeli ocena była edytowana);
- limit - w którym podajesz liczbę ocen, które mamy zwrócić. Domyślnie zwracamy 20 najnowszych ocen, a maksymalna wartość to 100;
- offset - w którym określasz, od której oceny mamy zwrócić dane. Maksymalna wartość to 20000.
Przykładowy request:
curl -X GET \
'https://api.allegro.pl/sale/user-ratings' \
-H 'Accept: application/vnd.allegro.public.v1+json' \
-H 'Content-Type: application/vnd.allegro.public.v1+json'
Przykładowy response:
{
"ratings": [ - lista ocen
{
"id": "5f245afca39ce1004cb8fc37", - ID oceny
"createdAt": "2021-07-30T19:55:08.555Z", - data utworzenia oceny
"editedAt": "2021-08-02T14:52:08.555Z", - data ostatniej edycji oceny
"lastChangedAt": "2021-08-02T14:52:08.555Z", - data utworzenia oceny lub
data ostatniej edycji
(jeśli ocena była edytowana)
"recommended": true, - czy ocena jest pozytywna
"buyer": { - informacje o kupującym
"id": "33811291", - ID kupującego
"login": "test_login" - login kupującego
},
"comment": "Świetny kontakt, ekspresowa realizacja", - komentarz kupującego
"rates": { - oceny poszczególnych obszarów
"description": 5, - zgodność z opisem
"service": 5, - obsługa kupującego
"deliveryCost": 5 - koszty wysyłki
},
"order": { - informacje o zamówieniu
"id": "8b1664b2-c3bc-11ea-820a-db7a264e2a97", - ID zamówienia
"offers": [ - oferty, które wchodzą w skład
zamówienia
{
"id": "8481327606", - ID oferty
"title": "oferta testowa", - tytuł oferty
"snapshot": - ID zrzutu oferty w momencie
zakupu
"MjAyMC0wNy0xMVQyMToyMjozMS4yMjhaO2J1eWVyOzgxNDc5MTU2OTBhMjhmNmEzMGM5ZThjMDUzNmE2YT"
}
]
},
"removal": { - informacje o prośbach o
usunięcie oceny
"possibleTo": "2021-08-13T19:55:08.555Z" - data, do kiedy sprzedawca
może wysłać prośbę o usunięcie
oceny
},
"excludedFromAverageRates": false - czy dana ocena jest wyłączona
z ogólnej średniej ocen
"excludedFromAverageRatesReason": "Rating not unique" - powód, dlaczego dana
ocena jest wyłączona
z ogólnej średniej ocen
}
]
}
Aby pobrać informacje wyłącznie o wskazanej ocenie, skorzystaj z GET /sale/user-ratings/{ratingId}.
Jak dodać odpowiedź na ocenę
Skorzystaj w tym celu z PUT /sale/user-ratings/{ratingId}/answer. Jako ratingID przekaż ID konkretnej oceny sprzedaży - wartość pobierzesz za pomocą GET /sale/user-ratings.
Przykładowy request:
curl -X PUT \
'https://api.allegro.pl/sale/user-ratings/5f245afca39ce1004cb8fc37/answer' \
-H 'Accept: application/vnd.allegro.public.v1+json' \
-H 'Content-Type: application/vnd.allegro.public.v1+json' \
-H 'Accept-Language: pl-PL'
- d '{
"message": "W tym przypadku jest to wina po stronie producenta,
prosimy o kontakt telefoniczny." - odpowiedź na ocenę (maksymalnie 500 znaków)
}'
Przykładowy response:
{
"createdAt": "2021-08-02T08:46:35.790Z",
"message": "W tym przypadku jest to wina po stronie producenta, prosimy kontakt telefoniczny."
}
Jak wysłać prośbę o usunięcie oceny
Skorzystaj w tym celu z PUT /sale/user-ratings/{ratingId}/removal. Jako ratingID przekaż ID konkretnej oceny sprzedaży - zarówno tą wartość, jak i datę, do kiedy możesz wysłać prośbę o usunięcie oceny (pole possibleTo), otrzymasz w odpowiedzi dla GET /sale/user-ratings.
Przykładowy request:
curl -X PUT \
'https://api.allegro.pl/sale/user-ratings/5f245afca39ce1004cb8fc37/removal' \
-H 'Accept: application/vnd.allegro.public.v1+json' \
-H 'Content-Type: application/vnd.allegro.public.v1+json' \
-H 'Accept-Language: pl-PL'
- d '{
"request": {
"message": "Proszę o usunięcie oceny zgodnie z ustaleniami." - prośba o usunięcie oceny
(maksymalnie 500 znaków)
}
}'
Przykładowy response:
{
"request": {
"createdAt": "2021-07-31T19:55:08.555Z", - data, od której kupujący ma 14 dni
na usunięcie oceny.
"message": "Proszę o usunięcie oceny zgodnie z ustaleniami."
"source": "SELLER" - źródło, czyli kto wysłał prośbę
o usunięcie negatywnej oceny. Dostępna
wartość: SELLER (sprzedający).
}
"possibleTo": "2021-08-13T19:55:08.555Z" - data, do kiedy sprzedawca może wysłać
prośbę o usunięcie oceny
}
Jakość sprzedaży
Jakość sprzedaży to zbiorcza ocena działań sprzedającego na Allegro. Wyliczamy ją na podstawie danych z konta, które dotyczą między innymi kontaktu z klientem, szybkości wysyłki czy zadowolenia kupujących. Dane te przeliczamy na punkty i przyznajemy w poszczególnych miarach.
Jak pobrać informacje o jakości sprzedaży
Skorzystaj w tym celu z GET /sale/quality. W odpowiedzi otrzymasz jakość sprzedaży użytkownika, którego token przesyłasz w requeście.
Przykładowy request:
curl -X GET \
'https://api.allegro.pl/sale/quality' \
-H 'Accept: application/vnd.allegro.public.v1+json' \
-H 'Content-Type: application/vnd.allegro.public.v1+json'
Przykładowy response:
{
"quality": [
{
"resultFor": "2024-08-07", // wynik za dzień
"score": 140, // wynik
"grade": "GOOD", // poziom jakości
"maxScore": 500, // maksymalny możliwy wynik
"metrics": [ // metryki
{
"code": "BUYER_SATISFACTION",
"name": "Zadowolenie kupujących", // nazwa metryki
"score": 0, // wynik metryki
"maxScore": 50 // maksymalny wynik metryki
},
{
"code": "DISPATCH_IN_TIME",
"name": "Wysyłka w terminie",
"score": 0,
"maxScore": 40
},
{
"code": "FAST_DISPATCH",
"name": "Szybka wysyłka",
"score": 0,
"maxScore": 160
},
{
"code": "NO_RETURNS",
"name": "Brak zwrotów wpłat",
"score": 0,
"maxScore": 50
},
{
"code": "RECOMMENDATIONS_FROM_BUYERS",
"name": "Polecenia od kupujących",
"score": 30,
"maxScore": 60
},
{
"code": "NO_DISCUSSIONS",
"name": "Brak dyskusji",
"score": 40,
"maxScore": 70
},
{
"code": "NO_QUESTIONS",
"name": "Brak pytań",
"score": 70,
"maxScore": 70
},
{
"code": "TERMS_AND_CONDITIONS",
"name": "Regulamin i zasady",
"score": 0,
"maxScore": 0
},
{
"code": "UNRESOLVED_DISCUSSIONS",
"name": "Nierozwiązane Dyskusje",
"score": 0,
"maxScore": 0
}
]
}
...
]
}
Kwalifikacja w programie Allegro Smart!
Oznaczenie Allegro Smart! przy ofertach to dla klienta szansa na darmową dostawę. Możesz sprawdzić warunki, które musisz spełnić, aby Twoje oferty były wyróżnione ikoną Allegro Smart!.
Więcej informacji na temat warunków w programie Allegro Smart! znajdziesz w Pomocy Allegro.
Kwalifikacja oferty
Za pomocą GET /sale/offers/{offerId}/smart, jako zalogowany sprzedawca, sprawdzisz klasyfikację oferty w programie Allegro Smart!. Możesz także skorzystać z parametru filtrowania "marketplaceId", aby uzyskać kwalifikację dla wybranego serwisu. Domyślnie zwrócimy dane dla serwisu bazowego.
Przykładowy request:
curl -X GET \
'https://api.allegro.pl/sale/offers/{offerId}/smart' \
-H 'Authorization: Bearer {token}' \
-H 'Accept: application/vnd.allegro.public.v1+json'
{
"classification": { - kwalifikacja oferty
"fulfilled": true, - czy warunki zostały spełnione
"lastChanged": "2022-01-12T09:39:29.262353Z" - data ostatniej zmiany w kwalifikacji
},
"scheduledForReclassification": false, - czy oferta została zaplanowana do ponownej kwalifikacji
"smartDeliveryMethods": [
{
"id": "2488f7b7-5d1c-4d65-b85c-4cbcf253fd93" - metody dostawy w ramach programu Allegro Smart!
}
],
"conditions": [ - warunki dla oferty
{
"code": "deliveryMethodPrices", - określony warunek (opis warunku widoczny w polu
“description”)
"name": "Zgodność z cennikiem", - nazwa warunku
"fulfilled": true, - czy warunek został spełniony
"passedDeliveryMethods": [ - metody dostawy, które spełniają dany warunek
{
"id": "2488f7b7-5d1c-4d65-b85c-4cbcf253fd93"
}
],
"failedDeliveryMethods": [ - metody dostawy, które nie spełniają danego warunku
{
"id": "b20ef9e1-faa2-4f25-9032-adbea23e5cb9"
}
],
"description": "Wymagamy aby metody dostawy były zgodne z cennikiem." - opis warunku
},
{
"code": "excludedDeliveryMethods",
"name": "Wykluczone metody dostawy",
"fulfilled": true,
"passedDeliveryMethods": [
{
"id": "c3066682-97a3-42fe-9eb5-3beeccab840c"
}
],
"failedDeliveryMethods": [],
"description": "Sprzedawca może na własne życzenie usunąć oznaczenie Smart! z wybranych metod dostaw."
},
{
"code": "returnPaidBy",
"name": "Koszty zwrotu",
"fulfilled": true,
"passedDeliveryMethods": [
{
"id": "2488f7b7-5d1c-4d65-b85c-4cbcf253fd93"
}
],
"failedDeliveryMethods": [],
"description": "Oferta musi mieć politykę zwrotu. Zagraniczne metody dostawy są zaklasyfikowane tylko jeśli koszt zwrotu jest pokryty przez sprzedającego."
},
{
"code": "returnCountryCode",
"name": "Polityka zwrotu",
"fulfilled": true,
"passedDeliveryMethods": [
{
"id": "2488f7b7-5d1c-4d65-b85c-4cbcf253fd93"
}
],
"failedDeliveryMethods": [],
"description": "Oferta musi mieć politykę zwrotu. Dla zagranicznych metod dostawy spodziewamy się, by kraj zwrotu należał do jednego ze wspieranych (PL, CZ, DE)."
},
{
"code": "shippingCountry",
"name": "Kraj wysyłki",
"fulfilled": true,
"passedDeliveryMethods": [
{
"id": "2488f7b7-5d1c-4d65-b85c-4cbcf253fd93"
}
],
"failedDeliveryMethods": [],
"description": "Kraj wysyłki musi należeć do wspieranych przez daną metodę dostawy. Polskie metody muszą być wysyłane z Polski, czeskie z Czech. Dopuszczalne kraje wysyłki: CZ (Kurier UPS/DPD Czechy), DE (Kurier UPS/DPD Niemcy), PL (Wszystkie pozostałe metody)."
},
{
"code": "sellingMode",
"name": "Rodzaj oferty",
"fulfilled": true,
"passedDeliveryMethods": null,
"failedDeliveryMethods": null,
"description": "Oznaczenie Smart! nie przysługuje ogłoszeniom."
},
{
"code": "allowedCategory",
"name": "Niewspierane kategorie",
"fulfilled": true,
"passedDeliveryMethods": null,
"failedDeliveryMethods": null,
"description": "Oznaczenie Smart! nie przysługuje w kategoriach Fajerwerki, Mleka modyfikowane > początkowe i Telemedycyna."
},
{
"code": "sellerEligible",
"name": "Status konta sprzedawcy",
"fulfilled": true,
"passedDeliveryMethods": null,
"failedDeliveryMethods": null,
"description": "Konto sprzedawcy dopuszczone do programu Smart!"
},
{
"code": "prepaidMethod",
"name": "Metody płatności",
"fulfilled": true,
"passedDeliveryMethods": null,
"failedDeliveryMethods": null,
"description": "W Smart akceptujemy metody płatne przy odbiorze, ale oczekujemy by sprzedawca uwzględnił również przynajmniej jedną metodę płatną z góry."
},
{
"code": "requiredDeliveryMethods",
"name": "Metody dostawy",
"fulfilled": true,
"passedDeliveryMethods": [],
"failedDeliveryMethods": [],
"description": "Wymagamy aby oferta posiadała co najmniej jedną oznaczoną Smart! metodę kurierską spośród: Allegro Kurier DPD, Allegro Pocztex Kurier 48, Allegro Kurier UPS (do 10 kg)."
}
]
}
Kwalifikacja sprzedawcy
Za pomocą GET /sale/smart, jako zalogowany sprzedawca, sprawdzisz kwalifikację konta w programie Allegro Smart!. Możesz także skorzystać z parametru filtrowania "marketplaceId", aby uzyskać kwalifikację dla wybranego serwisu. Domyślnie zwrócimy dane dla serwisu bazowego.
Przykładowy request:
curl -X GET \
'https://api.allegro.pl/sale/smart' \
-H 'Authorization: Bearer {token}' \
-H 'Accept: application/vnd.allegro.public.v1+json'
{
"classification": { - kwalifikacja konta
"fulfilled": false, - czy warunek został spełniony
"lastChanged": "2022-01-12T09:40:29.262353Z" - data ostatniej zmiany w kwalifikacji
},
"conditions": [ - warunki dla konta
{
"code": "ratingPercentage", - określony warunek (opis warunku widoczny w polu
“description”)
"name": "Wskaźnik poleceń", - nazwa warunku
"value": 0.783, - obecna wartość na koncie
"threshold": 0.98, - minimalna wymagana wartość
"fulfilled": false, - czy warunek został spełniony
"required": false, - czy warunek jest wymagany
"description": "W przypadku braku oznaczenia Super Sprzedawca wymagamy, aby sprzedawca posiadał wskaźnik poleceń powyżej określonego progu." - opis warunku
},
{
"code": "ratesCount",
"name": "Liczba unikalnych ocen",
"value": 23,
"threshold": 5,
"fulfilled": true,
"required": false,
"description": "W przypadku braku oznaczenia Super Sprzedawca wymagamy, aby sprzedawca posiadał określoną liczbę unikalnych ocen \"Polecam\" w okresie ostatnich 12 miesięcy."
},
{
"code": "superSeller",
"name": "Super Sprzedawca",
"value": true,
"threshold": null,
"fulfilled": true,
"required": false,
"description": "Posiadanie oznaczenia Super Sprzedawca pozwala wziąć udział w programie Smart! przy zwolnieniu z kryteriów \"Wskaźnik poleceń\" oraz \"Liczba unikalnych ocen\"."
},
{
"code": "isPharmacy",
"name": "Apteka",
"value": true,
"threshold": null,
"fulfilled": false,
"required": false,
"description": "Smart! nie przysługuje aptekom."
},
{
"code": "inTrial",
"name": "Zacznij Sprzedaż z Allegro Smart!",
"value": false,
"threshold": null,
"fulfilled": false,
"required": false,
"description": "Nowi sprzedający uczestniczący w promocji \"Zacznij Sprzedaż z Allegro Smart!\" mogą być czasowo zwolnieni z niektórych kryteriów programu Smart!"
}
],
"excludedDeliveryMethods": []
}
Ustawienia i cenniki dostaw
W ustawieniach dostawy sprzedający może zadeklarować m.in. kwotę, od której kupujący może zrobić zakupy z darmową dostawą, czy sposób obliczania kosztów dostawy.
Jak pobrać ustawienia dostawy
Aby pobrać ustawienia dostawy sprzedającego, skorzystaj z GET /sale/delivery-settings.
Przykładowy request:
curl -X GET
https://api.allegro.pl/delivery-settings
-H 'Authorization: Bearer {token}'
-H 'Accept: application/vnd.allegro.public.v1+json'
Przykładowy response:
{
"marketplace": {
"id": "allegro-pl" - identyfikator serwisu allegro
},
"freeDelivery": {
"amount": "100.99", – minimalna całkowita kwota zamówienia wymagana do
zakwalifikowania się do bezpłatnej dostawy krajowej
"currency": "PLN"
},
"abroadFreeDelivery": {
"amount": "899.99", – minimalna całkowita kwota zamówienia wymagana do
zakwalifikowania się do bezpłatnej dostawy zagranicznej
"currency": "PLN"
},
"joinPolicy": {
"strategy": "MIN" – strategia używana do obliczania kosztów dostawy dla
przedmiotów z ofert o różnych kosztach dostawy.
Możliwe wartości: MIN, MAX lub SUM
},
"customCost": {
"allowed": false – czy klient może wprowadzić niestandardowy koszt wysyłki
},
"updatedAt": "2022-08-21T10:13:40.036Z"
}
Jak edytować ustawienia dostawy
Aby edytować ustawienia dostawy sprzedającego, skorzystaj z PUT /sale/delivery-settings.
Przykładowy request:
curl -X PUT \
'https://api.allegro.pl/delivery-settings' \
-H 'content-type: application/vnd.allegro.public.v1+json' \
-H 'Accept: application/vnd.allegro.public.v1+json' \
-H 'Authorization: Bearer {token}' \
-d '{
"marketplace": {
"id": "allegro-pl"
},
"freeDelivery": {
"amount": "49.99",
"currency": "PLN"
},
"abroadFreeDelivery": {
"amount": "899.99",
"currency": "PLN"
},
"joinPolicy": {
"strategy": "MAX"
},
"customCost": {
"allowed": false
}
} '
Przykładowy response:
{
"marketplace": {
"id": "allegro-pl"
},
"freeDelivery": {
"amount": "49.99",
"currency": "PLN"
},
"abroadFreeDelivery": {
"amount": "899.99",
"currency": "PLN"
},
"joinPolicy": {
"strategy": "MAX"
},
"customCost": {
"allowed": false
}
"updatedAt": "2022-08-21T10:25:40.036Z"
}
Jak dodać cennik dostaw
Za pomocą GET /sale/delivery-methods pobierz listę dostępnych metod dostawy. W odpowiedzi otrzymasz ich nazwy wraz z identyfikatorami.
Przykładowy request:
curl -X GET \
https://api.allegro.pl/sale/delivery-methods \
-H 'Authorization: Bearer {token}' \
-H 'accept: application/vnd.allegro.public.v1+json'
Przykładowy response:
{"deliveryMethods": [{
"id": "7203cb90-864c-4cda-bf08-dc883f0c78ad", - identyfikator danej metody dostawy
"name": "Przesyłka kurierska" - nazwa danej metody dostawy
"marketplaces": [ - serwis, na który przeznaczona jest dana metoda dostawy
"allegro-pl"
]
…
},{
"id": "758fcd59-fbfa-4453-ae07-4800d72c2ca5",
"name": "List polecony priorytetowy"
...
},
...
{
"id": "1fa56f79-4b6a-4821-a6f2-ca9c16d5c925",
"name": "Inny sposób dostawy"
...
}]}
Skorzystaj z POST /sale/shipping-rates, aby utworzyć nowy cennik dostawy.
Ważne! na jednym koncie możesz mieć maksymalnie 250 cenników dostawy.
Przykładowy request:
curl -X POST \
https://api.allegro.pl/sale/shipping-rates \
-H 'Accept: application/vnd.allegro.public.v1+json' \
-H 'Authorization: {token}' \
-H 'content-type: application/vnd.allegro.public.v1+json' \
-d '{
"name": "Nowy cennik dostawy", - wymagane, nazwa
danego cennika dostaw
"rates": [
{
"deliveryMethod": {
"id": "2488f7b7-5d1c-4d65-b85c-4cbcf253fd93" - wymagane, identyfikator
danej metody dostawy
},
"maxQuantityPerPackage": 1, - wymagane, liczba w paczce
"firstItemRate": { - wymagane, cena przesyłki
"amount": "7.99",
"currency": "PLN"
},
"nextItemRate": { - wymagane, cena
kolejnej sztuki
"amount": "0.00",
"currency": "PLN"
},
"shippingTime": { - wymagane, czas dostawy,
"from": "PT72H", podaj wielokrotność 24H,
"to": "PT120H" zgodnie z formatem ISO 8601
}
},
{
"deliveryMethod": {
"id": "845efe05-0c96-47c3-a8cb-aa4699c158ce"
},
"maxQuantityPerPackage": 10,
"firstItemRate": {
"amount": "12.58",
"currency": "PLN"
},
"nextItemRate": {
"amount": "12.58",
"currency": "PLN"
},
"shippingTime": null
}
]
}'
Przykładowy response:
{
"id": "73491425-dea3-420b-b2bb-680310d764e4",
"name": "Nowy cennik dostawy",
"rates": [
{
"deliveryMethod": {
"id": "2488f7b7-5d1c-4d65-b85c-4cbcf253fd93"
},
"maxQuantityPerPackage": 1,
"firstItemRate": {
"amount": "7.99",
"currency": "PLN"
},
"nextItemRate": {
"amount": "0.00",
"currency": "PLN"
},
"shippingTime": {
"from": "PT72H",
"to": "PT120H"
}
},
{
"deliveryMethod": {
"id": "845efe05-0c96-47c3-a8cb-aa4699c158ce"
},
"maxQuantityPerPackage": 10,
"firstItemRate": {
"amount": "12.58",
"currency": "PLN"
},
"nextItemRate": {
"amount": "12.58",
"currency": "PLN"
},
"shippingTime": null
}
],
"lastModified": "2018-04-03T13:46:54.722Z"
}
Pakiety eksportowych metod dostawy
Niektóre eksportowe metody dostawy współdzielą tę samą nazwę, rozróżnisz je na podstawie wartości w polu “marketplaces” - widnieje tam informacja, na jaki serwis przeznaczona jest dana metoda dostawy.
Część z eksportowych metod dostawy, np. Allegro Kurier DPD Czechy, występuje w tzw. pakietach. Oznacza to, że gdy dodajesz do cennika dostaw tę metodę, musisz zawrzeć zarówno wariant dla serwisu “allegro-pl” (gdzie ceny określasz w złotych polskich), “allegro-cz” (gdzie ceny określasz w koronach czeskich) oraz - w niektórych przypadkach - dodatkową metodę, która występuje w pakiecie. W ramach Allegro Kurier DPD Czechy tą metodą będzie Allegro Kurier DPD Słowacja.
Przykładowy pakiet metod dostaw:
- 14b73cc6-28d6-11eb-adc1-0242ac120002 - Allegro Kurier DPD Czechy
- 14bac5b7-4f11-4b53-9a03-0242ac120002 - Allegro Kurier DPD Czechy
- 29b73cc6-28d6-11eb-adc1-0242ac120002 - Allegro Kurier DPD Słowacja w którym dla metody "14b73cc6-28d6-11eb-adc1-0242ac120002" (Allegro Kurier DPD Czechy) cenę w cenniku dostaw określa się w złotych polskich, natomiast dla "14bac5b7-4f11-4b53-9a03-0242ac120002" (Allegro Kurier DPD Czechy) w koronach czeskich.
Inny analogiczny pakiet metod dostaw dla przewoźnika DHL:
- 1474665b-926c-4d75-bb48-707a3f1be43b - Allegro Kurier DHL Czechy
- 7b28f4fb-926c-4d75-bb48-707a3f1be43b - Allegro Kurier DHL Czechy
- 2974665b-926c-4d75-bb48-707a3f1be43b - Allegro Kurier DHL Słowacja
Również w przypadku wybranych metod dostawy za pobraniem, wymagamy, aby do cennika analogicznie została dodana podobna metoda, ale z płatnością z góry, np. dla 1856a050-2bcb-445b-a66d-0a3151c1da58 (Allegro Kurier WE|DO pobranie) musisz dodać również 0856a050-3310-44eb-8ad6-0a3151c1da58 (Allegro Kurier WE|DO).
Pakiety lokalnych metod dostawy
Metoda o nazwie "Allegro One (Punkt, Box, Kurier)" odnosi się do pakietu trzech metod:
- "Allegro One Punkt, One Kurier" (z dostawą jutro),
- "Allegro One Box, One Kurier" (z dostawą jutro),
- "Allegro One Kurier - dostawa jutro".
Metody z "dostawą dzisiaj" tworzą osobny pakiet dwóch metod:
- "Allegro One Box, One Kurier - dostawa dzisiaj",
- "Allegro One Kurier - dostawa dzisiaj".
Metody z "dostawą dzisiaj" wymagają wybrania metod z "dostawą jutro" (a więc w sumie pięciu metod nie licząc metod COD, które są opcjonalne).
Zależności pomiędzy pakietami pokazujemy także w postaci wcięć na formularzu edycji cennika:
Więcej informacji na ten temat znajdziesz w artykule dla sprzedających.
Jak pobrać cennik dostaw
Utworzone cenniki pobierzesz za pomocą GET /sale/shipping-rates. W żądaniu możesz użyć parametru:
- “marketplace” - który możliwia filtrowanie cenników dostawy według rynku, do którego się kwalifikują (na podstawie wybranych metod dostawy).
Przykładowy request:
curl -X GET \
'https://api.allegro.pl/sale/shipping-rates?seller.id={Seller_ID}' \
-H 'Accept: application/vnd.allegro.public.v1+json' \
-H 'Authorization: Bearer {token}' \
-H 'content-type: application/vnd.allegro.public.v1+json'
Przykładowy response:
{"shippingRates":[{
"id": "fde5853c-01ce-4991-a4b3-994c1a4a408e", - identyfikator danego cennika dostaw
"name": "Cennik dostawy dla elektroniki", - nazwa danego cennika dostaw
"marketplaces": [
"allegro-pl"
]
},{
"id": "64d7218b-cb3b-448a-9cdd-760a1eb76eb8",
"name": "Cennik dostawy dla małego AGD",
"marketplaces": [
"allegro-pl"
]
},{
"id": "41b8e54f-dddd-4e48-ab17-dd941ade2116",
"name": "Cennik z wysyłką do Czech"
"marketplaces": [
"allegro-pl",
"allegro-cz"
]
}]}
Na liście w “marketplaces” zwrócimy serwis np. allegro-cz, jeśli cennik dostawy zawiera metodę dostawy przeznaczoną na ten rynek. Listę metod dostawy sprawdzisz za pomocą GET /sale/delivery-methods. Natomiast w polu “marketplaces” zwrócimy przypisane do nich serwisy.
Jeśli chcesz pobrać szczegóły konkretnego cennika dostaw, skorzystaj z GET /sale/shipping-rates/{shippingRatesId}.
Przykładowy request:
curl -X GET \
https://api.allegro.pl/sale/shipping-rates/fde5853c-01ce-4991-a4b3-994c1a4a408e\
-H 'Accept: application/vnd.allegro.public.v1+json' \
-H 'Authorization: Bearer {token}' \
-H 'content-type: application/vnd.allegro.public.v1+json'
Przykładowy response:
{
"id": "ed1645ab-0895-4010-bd85-bb5d92ab0d83",
"name": "Cennik dostawy",
"rates": [
{
"deliveryMethod": {
"id": "9081532b-5ad3-467d-80bc-9252982e9dd8" - identyfikator
danej metody dostawy
},
"maxQuantityPerPackage": 1, - liczba w paczce
"firstItemRate": { - cena przesyłki
"amount": "10.95",
"currency": "PLN"
},
"nextItemRate": { - cena kolejnej sztuki
"amount": "0.00",
"currency": "PLN"
},
"shippingTime": { - czas dostawy,
"from": "PT72H", wielokrotność 24H,
"to": "PT120H" zgodnie z formatem ISO 8601
}
},
{
"deliveryMethod": {
"id": "574d1c9e-9903-4626-903f-f72441d520d5"
},
"maxQuantityPerPackage": 1,
"firstItemRate": {
"amount": "8.60",
"currency": "PLN"
},
"nextItemRate": {
"amount": "0.00",
"currency": "PLN"
},
"shippingTime": null
}
],
"lastModified": "2018-08-08T08:24:56.086Z" - data ostatniej
modyfikacji danego cennika
}
Jak edytować cennik dostaw
Aby edytować cennik dostaw, skorzystaj z PUT /sale/shipping-rates/{shippingRatesId}.
Przykładowy request:
curl -X PUT \
https://api.allegro.pl/sale/shipping-rates/8f4ce5fd-13a9-484e-92cd-2365c7e0e64e \
-H 'Accept: application/vnd.allegro.public.v1+json' \
-H 'Authorization: Bearer {token}' \
-H 'content-type: application/vnd.allegro.public.v1+json' \
-d '{
"id": "8f4ce5fd-13a9-484e-92cd-2365c7e0e64e", - wymagane, identyfikator
edytowanego cennika dostaw
"name": "Edytowany cennik dostawy", - wymagane, nazwa
edytowanego cennika dostaw
"rates": [
{
"deliveryMethod": {
"id": "2488f7b7-5d1c-4d65-b85c-4cbcf253fd93" - wymagane, identyfikator
danej metody dostawy
},
"maxQuantityPerPackage": 1, - wymagane, liczba w paczce
"firstItemRate": { - wymagane, cena przesyłki
"amount": "6.99",
"currency": "PLN"
},
"nextItemRate": { - wymagane, cena kolejnej sztuki
"amount": "0.00",
"currency": "PLN"
},
"shippingTime": null - czas dostawy,
podaj wielokrotność 24H,
zgodnie z formatem ISO 8601
},
{
"deliveryMethod": {
"id": "845efe05-0c96-47c3-a8cb-aa4699c158ce"
},
"maxQuantityPerPackage": 12,
"firstItemRate": {
"amount": "11.99",
"currency": "PLN"
},
"nextItemRate": {
"amount": "11.99",
"currency": "PLN"
},
"shippingTime": {
"from": "PT72H",
"to": "PT120H"
}
}
]
}'
Przykładowy response:
{
"id": "8f4ce5fd-13a9-484e-92cd-2365c7e0e64e",
"name": "Edytowany cennik dostawy",
"rates": [
{
"deliveryMethod": {
"id": "2488f7b7-5d1c-4d65-b85c-4cbcf253fd93"
},
"maxQuantityPerPackage": 1,
"firstItemRate": {
"amount": "6.99",
"currency": "PLN"
},
"nextItemRate": {
"amount": "0.00",
"currency": "PLN"
},
"shippingTime": null
},
{
"deliveryMethod": {
"id": "845efe05-0c96-47c3-a8cb-aa4699c158ce"
},
"maxQuantityPerPackage": 12,
"firstItemRate": {
"amount": "11.99",
"currency": "PLN"
},
"nextItemRate": {
"amount": "11.99",
"currency": "PLN"
},
"shippingTime": {
"from": "PT72H",
"to": "PT120H"
}
}
],
"lastModified": "2018-08-10T09:38:01.137+02:00"
}
Dane kontaktowe
Dane kontaktowe, które zdefiniujesz, wykorzystasz, gdy wystawisz ogłoszenie.
Pamiętaj!
- nie możesz mieć więcej niż 50 kontaktów,
- w jednym kontakcie możesz podać maksymalnie:
- 1 adres e-mail,
- 2 numery telefonu.
Jak utworzyć nowy kontakt
Zrobisz to za pomocą POST /sale/offer-contacts.
Przykładowy request:
curl -X POST \
'https://api.allegro.pl/sale/offer-contacts' \
-H 'Content-Type: application/vnd.allegro.public.v1+json' \
-H 'Accept: application/vnd.allegro.public.v1+json' \
-H 'Authorization: Bearer {token}' \
-d '{
"name": "Auta terenowe", - nazwa kontaktu; wymagane, maksymalna liczba znaków - 250
"emails": [ - adresy e-mail; możesz podać 1
{
"address": "test@test.pl"
}
],
"phones": [ - numery telefonów; możesz podać maksymalnie 2
{
"number": "555-555-666"
},
{
"number": "555555667"
}
]
}'
Przykładowy response:
{
"id": "0c046252-9559-4ecb-8ea3-879f60e46947", - identyfikator kontaktu
"name": "Auta terenowe", - nazwa kontaktu
"emails": [
{
"address": "test@test.pl"
}
],
"phones": [
{
"number": "555-555-666"
},
{
"number": "555555667"
}
]
}
Jak pobrać listę kontaktów
Zrobisz to za pomocą GET /sale/offer-contacts.
Przykładowy request:
curl -X GET \
'https://api.allegro.pl/sale/offer-contacts' \
-H 'Accept: application/vnd.allegro.public.v1+json' \
-H 'Authorization: Bearer {token}'
Przykładowy response:
{
"contacts": [
{
"id": "0c046252-9559-4ecb-8ea3-879f60e46947", - identyfikator kontaktu
"name": "Auta terenowe", - nazwa kontaktu
"emails": [
{
"address": "test@test.pl" - adres mailowy
}
],
"phones": [
{
"number": "+48 788 788 788" - numer telefonu
},
{
"number": "+48 75 575 57 55"
}
]
},
{
"id": "af1ccfd7-2753-4ed3-bdda-c78eb14442ab",
"name": "Auta osobowe",
"emails": [
{
"address": "test@test.pl"
}
],
"phones": [
{
"number": "+48 55 555 57 77"
}
]
},
{
"id": "27869b31-048e-43a0-bdc0-52b922f278a5",
"name": "Ciężarówki",
"emails": [
{
"address": "test@test.pl"
}
],
"phones": []
}
]
}
Jak pobrać szczegóły danego kontaktu
Zrobisz to za pomocą GET /sale/offer-contacts/{id}. Jako id przekaż identyfikator danego kontaktu - pobierzesz go za pomocą GET /sale/offer-contacts.
Przykładowy request:
curl -X GET \
'https://api.allegro.pl/sale/offer-contacts/0c046252-9559-4ecb-8ea3-879f60e46947' \
-H 'Accept: application/vnd.allegro.public.v1+json' \
-H 'Authorization: Bearer {token}'
Przykładowy response:
{
"id": "0c046252-9559-4ecb-8ea3-879f60e46947", - identyfikator kontaktu
"name": "Auta terenowe", - nazwa kontaktu
"emails": [
{
"address": "test@test.pl"
}
],
"phones": [
{
"number": "+48 55 555 57 77"
}
]
}
Jak zmienić dane kontaktu
Zrobisz to za pomocą PUT /sale/offer-contacts/{id}. Jako id przekaż identyfikator danego kontaktu - pobierzesz go za pomocą GET /sale/offer-contacts.
Przykładowy request:
curl -X PUT \
'https://api.allegro.pl/sale/offer-contacts/0c046252-9559-4ecb-8ea3-879f60e46947' \
-H 'Content-Type: application/vnd.allegro.public.v1+json' \
-H 'Accept: application/vnd.allegro.public.v1+json' \
-H 'Authorization: Bearer {token}' \
-d '{
"name": "Auta terenowe", - nazwa kontaktu; wymagane, maksymalna liczba znaków - 250
"emails": [ - adresy e-mail; możesz podać 1
{
"address": "test@test.pl"
}
],
"phones": [ - numery telefonów; możesz podać maksymalnie 2
{
"number": "555-555-666"
}
]
}'
Przykładowy response:
{
"id": "0c046252-9559-4ecb-8ea3-879f60e46947",
"name": "Auta terenowe",
"emails": [
{
"address": "test@test.pl"
}
],
"phones": [
{
"number": "555-555-666”
}
]
}
Adresy mailowe
Od 26 marca 2019 adres e-mail kupującego zwracamy jako ciąg znaków w domenie @allegromail.pl, np:
- 8awgqyk6a5@allegromail.pl - zakodowana wersja adresu mailowego,
- 8awgqyk6a5+cub31c122@allegromail.pl - zakodowana wersja adresu mailowego wraz z informacją o transakcji.
Zmianę wdrożyliśmy ze względów bezpieczeństwa i ochrony danych osobowych. Adresy mailowe maskujemy w całym Allegro. Maskowany adres e-mail składa się z zakodowanej pary sprzedawca-kupujący i informacji o transakcji. Więcej informacji na temat maskowania maili znajdziesz w Pomocy Allegro.
W związku z tą zmianą, użytkownik może wysłać do klienta e-mail tylko z takich adresów jakie przypisał do swojego konta.
Jak dodać adres e-mail
Użyj POST /account/additional-emails, aby dodać do swojego konta dodatkowy adres e-mail. Musisz być zalogowany jako właściciel danego konta.
Przykładowy request:
curl -X POST \
'https://api.allegro.pl/account/additional-emails' \
-H 'content-type: application/vnd.allegro.public.v1+json' \
-H 'Accept: application/vnd.allegro.public.v1+json' \
-H 'Authorization: Bearer {token}' \
-d '{
“email”: adresemail@gmail.com - wymagane, adres e-mail możesz podać 1.
Maksymalna długość maila to 64 znaki
przed adresem domeny.
}'
Przykładowy response:
{
"id": "5c40a8fa7fae6f7613c2b560",
“email”: “adresemail@gmail.com”,
“createdAt”: "2019-04-02T17:03:00Z"
}
Jak pobrać adresy e-mail
Użyj GET /account/additional-emails, aby pobrać adresy e-mail utworzone na Twoim koncie. Musisz być zalogowany jako właściciel danego konta.
Przykładowy request:
curl -X GET \
'https://api.allegro.pl/account/additional-emails' \
-H 'Accept: application/vnd.allegro.public.v1+json' \
-H 'Authorization: Bearer {token}'
Przykładowy response:
{
“additional-emails”: [
{
"id": "5c40a8fa7fae6f7613c2b560",
“email”: “adresemail@gmail.com”,
“createdAt”: "2019-04-02T17:03:00Z"
},
{
"id": "6c30a8ga9fsc6f8651c2b523",
“email”: “adresemail2@gmail.com”,
“createdAt”: "2019-04-03T13:12:33Z"
},
]
}
Jak pobrać szczegółowe informacje o adresie e-mail
Użyj GET /account/additional-emails/{emailId}, aby pobrać szczegółowe informacje o danym adresie e-mail. Musisz być zalogowany jako właściciel danego konta.
Przykładowy request:
curl -X GET \
'https://api.allegro.pl/account/additional-emails/5c40a8fa7fae6f7613c2b560' \
-H 'Accept: application/vnd.allegro.public.v1+json' \
-H 'Authorization: Bearer {token}'
Przykładowy response:
{
"id": "5c40a8fa7fae6f7613c2b560",
“email”: “adresemail@gmail.com”,
“createdAt”: "2019-04-02T17:03:00Z"
}
Jak usunąć adres e-mail
Użyj DELETE /account/additional-emails/{emailId}, aby usunąć podany adres e-mail. Musisz być zalogowany jako właściciel danego konta.
Przykładowy request:
curl -X DELETE \
'https://api.allegro.pl/account/additional-emails/5c40a8fa7fae6f7613c2b560' \
-H 'Accept: application/vnd.allegro.public.v1+json' \
-H 'Authorization: Bearer {token}'
Przykładowy response:
status 204 No Content
Dane teleadresowe producenta
Utwórz dane teleadresowe producenta
Za pomocą POST /sale/responsible-producers utworzysz dane teleadresowe producenta produktu.
Przykładowy request:
curl -X POST \
'https://api.allegro.pl/sale/responsible-producers \
-H 'Content-Type: application/vnd.allegro.public.v1+json' \
-H 'Accept: application/vnd.allegro.public.v1+json' \
-H 'Authorization: Bearer {token}' \
-d '{
"name": "Producent ABC", // własna nazwa
"producerData": { // dane producenta
"tradeName": "ABC Company", // nazwa producenta
"address": { // adres
"countryCode": "PL", // kod kraju
"street": "Wielka 1", // ulica
"postalCode": "61-774", // kod pocztowy
"city": "Poznań" // miasto
},
"contact": { // dane kontaktowe
"email": "producer@abc-company.com", // adres email
"phoneNumber": "600700800" // numer telefonu, pole opcjonalne
}
}
}'
Przykładowy response:
{
"id": "59a8b818-0a38-4540-92f4-3645923cb9c6", // identyfikator danych producenta
"name": "Producent ABC",
"producerData": {
"tradeName": "ABC Company",
"address": {
"countryCode": "PL",
"street": "Wielka 1",
"postalCode": "61-774",
"city": "Poznań"
},
"contact": {
"email": "producer@abc-company.com",
"phoneNumber": "600700800"
}
}
}
Pobierz listę danych producentów
Skorzystaj z GET /sale/responsible-producers, aby pobrać listę danych teleadresowych producentów. Lista jest domyślnie sortowana rosnąco w oparciu o wartość pola “name”.
Aby dostosować listę do swoich potrzeb, możesz skorzystać z parametrów:
- limit - maksymalna liczba danych producentów na liście. Domyślnie 1000, wartości w przedziale 1 - 1000;
- offset - by wskazać miejsce, od którego chcesz pobrać kolejną porcję danych. Domyślnie 0, wartości w przedziale 0 - 50000.
Przykładowy request:
curl -X GET \
'https://api.allegro.pl/sale/responsible-producers' \
-H 'Accept: application/vnd.allegro.public.v1+json' \
-H 'Authorization: Bearer {token}' \
Przykładowy response:
{
"responsibleProducers": [ // lista danych producentów
{
"id": "59a8b818-0a38-4540-92f4-3645923cb9c6", // identyfikator danych producenta
"name": "Producent ABC", // własna nazwa
"producerData": { // dane producenta
"tradeName": "ABC Company", // nazwa firmy
"address": { // adres
"countryCode": "PL", // kod kraju
"street": "Wielka 1", // ulica
"postalCode": "61-774", // kod pocztowy
"city": "Poznań" // miasto
},
"contact": { // dane kontaktowe
"email": "producer@abc-company.com", // adres email
"phoneNumber": "600700800" // numer telefonu
}
}
},
{
"id": "42b494f4-a18a-46c1-b474-f545c62d83c3",
"name": "Producent XYZ",
"producerData": {
"tradeName": "XYZ Company",
"address": {
"countryCode": "PL",
"street": "Twarda 1",
"postalCode": "00-114",
"city": "Warsaw"
},
"contact": {
"email": "producer@xyz-company.com",
"phoneNumber": "500600700"
}
}
}
],
"count": 2, // znaleziona liczba danych producentów
"totalCount": 2 // łączna liczba danych producentów
}
Pobierz dane teleadresowe wybranego producenta
Skorzystaj z GET /sale/responsible-producers/{id}, aby pobrać dane teleadresowe wybranego producenta. Przekaż identyfikator producenta (id) w ścieżce zasobu.
Przykładowy request:
curl -X GET \
'https://api.allegro.pl/sale/responsible-producers/59a8b818-0a38-4540-92f4-3645923cb9c6' \
-H 'Accept: application/vnd.allegro.public.v1+json' \
-H 'Authorization: Bearer {token}' \
Przykładowy response:
{
"id": "59a8b818-0a38-4540-92f4-3645923cb9c6", // identyfikator danych producenta
"name": "Producent ABC", // własna nazwa
"producerData": { // dane producenta
"tradeName": "ABC Company", // nazwa firmy
"address": { // adres
"countryCode": "PL", // kod kraju
"street": "Wielka 1", // ulica
"postalCode": "61-774", // kod pocztowy
"city": "Poznań" // miasto
},
"contact": { // dane kontaktowe
"email": "producer@abc-company.com", // adres email
"phoneNumber": "600700800" // numer telefonu
}
}
}
Edytuj dane teleadresowe producenta
Aby zmienić dane wcześniej utworzonego producenta, skorzystaj z PUT /sale/responsible-producers/{id}. Przekaż identyfikator producenta (id) jako parametr.
Przykładowy request:
curl -X PUT \
'https://api.allegro.pl/sale/responsible-producers/59a8b818-0a38-4540-92f4-3645923cb9c6' \
-H 'Content-Type: application/vnd.allegro.public.v1+json' \
-H 'Accept: application/vnd.allegro.public.v1+json' \
-H 'Authorization: Bearer {token}' \
-d '{
"id":"59a8b818-0a38-4540-92f4-3645923cb9c6", // identyfikator danych producenta
"name": "Producent ZZZ", // własna nazwa
"producerData": { // dane producenta
"tradeName": "ZZZ Company", // nazwa producenta
"address": { // adres
"countryCode": "PL", // kod kraju
"street": "Spokojna 1", // ulica
"postalCode": "61-680", // kod pocztowy
"city": "Poznań" // miasto
},
"contact": { // dane kontaktowe
"email": "producer@ZZZ-company.com", // adres email
"phoneNumber": "600700800" // numer telefonu, pole opcjonalne
}
}
}'
Przykładowy response:
{
"id": "59a8b818-0a38-4540-92f4-3645923cb9c6",
"name": "Producent ZZZ",
"producerData": {
"tradeName": "ZZZ Company",
"address": {
"countryCode": "PL",
"street": "Spokojna 1",
"postalCode": "61-680",
"city": "Poznań"
},
"contact": {
"email": "producer@zzz-company.com",
"phoneNumber": "600700800"
}
}
}
Osoba odpowiedzialna za zgodność produktu z przepisami unijnymi
Jak utworzyć nową osobę odpowiedzialną
Aby utworzyć nową osobę odpowiedzialną, skorzystaj z POST /sale/responsible-persons.
Przykładowy request:
curl -X POST \
'https://api.allegro.pl/sale/responsible-persons' \
-H 'Content-Type: application/vnd.allegro.public.v1+json' \
-H 'Accept: application/vnd.allegro.public.v1+json' \
-H 'Authorization: Bearer {token}' \
-d '{
"name": "Testowy podmiot", - nazwa wewnętrzna dla danego podmiotu
"personalData": { - informacje o danym podmiocie
"name": "Testowa nazwa", - nazwa
"address": { - adres
"countryCode": "PL", - kod kraju
"street": "Testowa 2", - ulica
"postalCode": "60-110", - kod pocztowy
"city": "Poznań" - miasto
},
"contact": { - dane kontaktowe
"email": "testowyi@testowymail.pl", - adres mailowy
"phoneNumber": "123123123" - numer telefonu
}
}
}'
Przykładowy response:
{
"id": "ceaf2608-c1a6-49ac-8187-00a05103040f",
"name": "Testowy podmiot",
"personalData": {
"name": "Testowa nazwa",
"address": {
"countryCode": "PL",
"street": "Testowa 2",
"postalCode": "60-110",
"city": "Poznań"
},
"contact": {
"email": "testowyi@testowymail.pl",
"phoneNumber": "123123123"
}
}
}
Jak pobrać osoby odpowiedzialne
Aby pobrać wcześniej utworzone osoby odpowiedzialne, skorzystaj z GET /sale/responsible-persons.
Jeżeli chcesz dostosować listę do swoich potrzeb, możesz skorzystać z parametrów:
- limit - maksymalna liczba osób odpowiedzielnych na liście. Domyślnie 1000, wartości w przedziale 1 - 1000;
- offset - by wskazać miejsce, od którego chcesz pobrać kolejną porcję danych. Domyślnie 0, wartości w przedziale 0 - 16000.
Przykładowy request:
curl -X GET \
'https://api.allegro.pl/sale/responsible-persons' \
-H 'Content-Type: application/vnd.allegro.public.v1+json' \
-H 'Accept: application/vnd.allegro.public.v1+json' \
-H 'Authorization: Bearer {token}' \
Przykładowy response:
{
"responsiblePersons": [
…
{
"id": "ceaf2608-c1a6-49ac-8187-00a05103040f",
"name": "Testowy podmiot",
"personalData": {
"name": "Testowa nazwa",
"address": {
"countryCode": "PL",
"street": "Testowa 2",
"postalCode": "60-110",
"city": "Poznań"
},
"contact": {
"email": "testowyi@testowymail.pl",
"phoneNumber": "123123123"
}
}
}
…
]
}
Jak zmienić dane osoby odpowiedzialnej
Aby zmienić dane wcześniej utworzonej osoby odpowiedzialnej, skorzystaj z PUT /sale/responsible-persons/{id}.
Przykładowy request:
curl -X PUT \
'https://api.allegro.pl/sale/responsible-persons/{id}' \
-H 'Content-Type: application/vnd.allegro.public.v1+json' \
-H 'Accept: application/vnd.allegro.public.v1+json' \
-H 'Authorization: Bearer {token}' \
-d '{
"id": "920c1af7-2133-4fef-9b2c-70b420be3b61",
"name": "Testowy podmiot",
"personalData": {
"name": "Testowa nazwa",
"address": {
"countryCode": "PL",
"street": "Testowa 22",
"postalCode": "60-110",
"city": "Poznań"
},
"contact": {
"email": "testowyi@testowymail.pl",
"phoneNumber": "123123123"
}
}
}'
Lista zasobów
Pełną dokumentację zasobów w postaci pliku swagger.yaml znajdziesz tu.
- GET /me - pobierz informacje o zalogowanym użytkowniku
- GET /sale/user-ratings - pobierz oceny sprzedaży zalogowanego użytkownika
- PUT /sale/user-ratings/{ratingId}/answer - dodaj odpowiedź na ocenę sprzedaży
- PUT /sale/user-ratings/{ratingId}/removal - wyślij prośbę o usunięcie oceny sprzedaży
- GET /sale/quality - pobierz informacje o jakości sprzedaży
- GET /sale/offers/{offerId}/smart - sprawdź klasyfikację oferty w programie Allegro Smart!
- GET /sale/smart - sprawdź klasyfikację sprzedawcy w programie Allegro Smart!
- GET /sale/delivery-settings - pobiesz ustawienia dostawy sprzedającego
- PUT /sale/delivery-settings - edytuj ustawienia dostawy sprzedającego
- POST /sale/offer-contacts - utwórz nowy kontakt
- GET /sale/offer-contacts - pobierz listę kontaktów
- GET /sale/offer-contacts/{id} - pobierz szczegóły kontaktu
- PUT /sale/offer-contacts/{id} - zmień dane kontaktu
- POST /account/additional-emails - dodaj nowy adres e-mail do swojego konta
- GET /account/additional-emails - pobierz adresy e-mail utworzone na moim koncie
- GET /account/additional-emails/{emailId} - pobierz szczegóły o danym adresie e-mail
- DELETE /account/additional-emails/{emailId} - usuń dany adres e-mail
- POST /sale/responsible-producers - utwórz dane teleadresowe producenta
- PUT /sale/responsible-producers/{id} - edytuj dane teleadresowe producenta
- GET /sale/responsible-producers - pobierz listę danych producentów
- POST /sale/responsible-persons - utwórz nową osobę odpowiedzialną
- PUT /sale/responsible-persons/{id} - edytuj daną osobę odpowiedzialną
- GET /sale/responsible-persons - pobierz listę utworzonych osób odpowiedzialnych