Allegro REST API

gdzie?

Polska | polski | PLN
  • Informacje podstawowe
  • Główne procesy
  • Uwierzytelnianie i autoryzacja
  • Wzorzec Command
  • Glosariusz
  • Lista metod
  • Pierwsze kroki
  • Wystawianie oferty z produktem
  • Serwisy zagraniczne Allegro
  • Zarządzanie ofertami
  • Oferty wielowariantowe
  • Pasuje do
  • Zarządzanie zgłoszeniami ofert do kampanii
  • Rabaty i promocje
  • Zamówienia
  • Wysyłam z Allegro
  • One Fulfillment by Allegro
  • Dyskusje
  • Konto i dane użytkownika
  • Centrum wiadomości
  • Sprawdzanie opłat
  • Wystawianie ogłoszeń
  • Publiczne oferty
FAQ
  • Aktualności
  • Changelog
Dokumentacja
Regulamin
Kontakt
  • Moje aplikacje
  • Moje aplikacje (sandbox)
  • Newsletter
  1. Allegro REST API
  2. Zarządzanie zgłoszeniami ofert do kampanii
Obsługa zgłoszeń ofert do kampanii, programów specjalnych i oznaczeń Allegro
Jak zgłosić ofertę do kampanii, programów specjalnych i oznaczeń Allegro

Jak przypisać ofertę do kampanii

Jeżeli masz konto firmowe, możesz zgłaszać swoje oferty do różnych akcji promocyjnych, dzięki temu wyświetlimy w nich specjalne oznaczenia.

Aby wziąć udział w programie kampanii, musisz spełniać warunki i zaakceptować regulamin dostępny w zasobie badge-campaign. Korzystanie z zasobów API jest równoznaczne z akceptacją regulaminu.

Od 10 maja 2022 cena rynkowa (market price), jest wyliczana automatycznie. Oznacza to, że cena rynkowa zawarta w requeście POST /sale/badges nie jest brana pod uwagę, a w późniejszym terminie parametr ten zostanie usunięty.

Obsługa zgłoszeń ofert do kampanii, programów specjalnych i oznaczeń Allegro

Jeśli dodasz ofertę do kampanii:

  • “Hit” to zyskasz oznaczenie HIT na liście ofert oraz na widoku oferty.

  • “Strefa Okazji” to zyskasz oznaczenie “Okazja” na liście ofert oraz przekreśloną cenę.

  • “Prowizja 0.5%” to cena oferty zostanie zmieniona na tę, którą podałeś w zgłoszeniu. Dodatkowo otrzymasz bonusy, które wynikają z regulaminu konkretnej kampanii, np. niższą prowizję od sprzedaży danego produktu.

Więcej na temat kampanii dowiesz się w artykule Strefa okazji i Prowizja nawet 0,5%.

Pamiętaj, że wszystkie żądania musisz wykonywać jako zautoryzowany sprzedawca, który chce dodać oznaczenia do swoich ofert.

Jak zgłosić ofertę do kampanii, programów specjalnych i oznaczeń Allegro

badge

Lista dostępnych kampanii

Za pomocą GET /sale/badge-campaigns pobierzesz listę dostępnych kampanii, które możesz przypisać do ofert.

Przykładowy request:

  curl -X GET \
  'https://api.allegro.pl/sale/badge-campaigns' \
  -H 'Authorization: Bearer {token}' \
  -H 'Content-Type: application/vnd.allegro.public.v1+json'

Przykładowy response:

  {
   “badgeCampaigns”: [
   {
     “id”: “BARGAIN”,               – identyfikator kampanii
     “name”: “Strefa okazji”,       – nazwa kampanii
     “type”: “DISCOUNT”,            – typ kampanii, obecnie są dostępne trzy typy
                                    STANDARD - dodamy do oferty oznaczenie na
                                    liście ofert - np Hit, Nowość
                                    DISCOUNT - zmienimy cenę w ofercie,
                                    a na liście ofert oprócz aktualnej ceny oferty
                                    zaprezentujemy przekreśloną cenę rynkową,
                                    którą podałeś w zgłoszeniu
                                    SOURCING - zmienimy cenę w ofercie,
                                    nie dodamy oznaczenia widocznego na platformie,
                                    ale otrzymasz bonusy wynikające z regulaminu
                                    konkretnej kampanii, np. niższe prowizje
                                    od sprzedaży produktu.
     “eligibility”: {               – czy kampania jest dostępna dla zautoryzowanego
                                    użytkownika
       “eligible”: true,
       “refusalReasons”: []         – dlaczego użytkownik nie kwalifikuje się do
                                    udziału w danej kampanii
     },
     “application”: {               – okres przyjmowania zgłoszeń ofert do kampanii
                                    kanałem API. Może różnić się od okresu przyjmowania
                                    zgłoszeń z poziomu Mojego Allegro
       “type”: “ALWAYS”,            – czas trwania, dostępne jest 5 wartości
                                    ALWAYS (zawsze), SINCE (od danego dnia),
                                    UNTIL (do danego dnia), WITHIN (przedział czasowy),
                                    NEVER (nigdy)
       “from”: null,
       “to”: null
     },
     “publication”: {               – okres trwania oznaczenia
       “type”: “ALWAYS”,            – czas trwania dostępne jest 5 wartości
                                    ALWAYS (zawsze), SINCE (od danego dnia),
                                    UNTIL (do danego dnia), WITHIN (przedział czasowy),
                                    NEVER (nigdy)
       “from”: null,
       “to”: null
     },
     “visibility”: {                – okres, w którym kampania jest widoczna w narzędziach
                                    do zarządzania kampaniami na API (nie jest równy widoczności
                                    oznaczenia kampanii na portalu). Może różnić się od
                                    okresu widoczności w Moim Allegro. Zakres tych
                                    dat pozwala stwierdzić, jak długo informacje
                                    o kampanii będą dostępne na platformie
       “type”: “ALWAYS”,            – czas trwania dostępne jest 5 wartości
                                    ALWAYS (zawsze), SINCE (od danego dnia),
                                    UNTIL (do danego dnia), WITHIN (przedział czasowy),
                                    NEVER (nigdy)
       “from”: null,
       “to”: null
     },
     “regulationsLink”: “https://na.allegro.pl/regulamin-kampania-BARGAIN" – link do regulaminu kampanii
   },
   …
   ]
 }

Zgłoś ofertę do kampanii

Za pomocą POST /sale/badges zgłosisz ofertę do wybranej kampanii.

Zgłoszenia, które nie spełniają wymagań danej kampanii zostaną przez nas odrzucone.

Przykładowy request:

  curl -X POST \
  'https://api.allegro.pl/sale/badges' \
  -H 'Authorization: Bearer {token}' \
  -H 'Content-Type: application/vnd.allegro.public.v1+json' \
  -d '{
    “campaign”: {
        “id”: “BARGAIN”             – wymagane, identyfikator kampanii, jaką
                                    chcesz dodać do oferty - zgodnie z
                                    badgeCampaigns.id otrzymanym przez GET /sale/badge-campaigns
    },
    “offer”: {
        “id”: “6206378062”          – wymagane, identyfikator oferty, do jakiej
                                    chcesz dodać kampanię
    },
    “prices”: {                     – wymagane dla kampanii typu DISCOUNT
                                    i SOURCING, informacje o cenie, jaka
                                    ma być widoczna na ofercie i o cenie rynkowej
        “market”: {                 – cena rynkowa za oferowany przedmiot; 
                                    To pole jest ignorowane i 
                                    zostanie usunięte w przyszłości
            “amount”: “200.00”,
            “currency”: “PLN”
        },
        “bargain”: {                – wymagane dla kampanii typu DISCOUNT
                                    i SOURCING, cena promocyjna oferty
            “amount”: “180.00”,
            “currency”: “PLN”
        }
    },
    “purchaseConstraints”: {        – opcjonalne - ograniczenia zakupowe
                                    na czas udziału w kampanii
        “limit”: {
            “perUser”: {
                “maxItems”: 1       – ograniczenie liczby sztuk dostępnych
                                    dla pojedynczego użytkownika; tylko
                                    dla kampanii typu DISCOUNT i SOURCING
          }
        }
    }
 }'

Przykładowy response:

  {
   “id”: “8a457b8f-627d-43cf-8806-f06f8d13c306”,  – identyfikator zgłoszenia oferty do
                                                  kampanii
   “createdAt”: “2019-06-26T10:22:35.225Z”,       – data utworzenia zgłoszenia
   “updatedAt”: “2019-06-26T10:22:35.225Z”,       – data ostatniej zmiany w zgłoszeniu
   “campaign”: {
     “id”: “BARGAIN”                              – identyfikator kampanii
   },
   “offer”: {
     “id”: “6206378062”                           –  identyfikator oferty, którą chcesz dodać
                                                  do kampanii
   },
   “prices”: {                                    – informacje o cenie, jaka ma być widoczna
                                                  na ofercie i o cenie rynkowej
     “bargain”: {                                 – cena promocyjna oferty
       “amount”: “180.00”,
       “currency”: “PLN”
     },
     “market”: {                                  – cena rynkowa za oferowany przedmiot; w tym polu
                                                  zwrócimy wyliczoną przez nas najniższą cenę sprzedaży 
                                                  w ofercie z ostatnich 30 dni. Wyświetlimy ją jako przekreśloną 
                                                  na liście ofert
       “amount”: “200.00”,
       “currency”: “PLN”
     }
   },
   “purchaseConstraints”: {                       – opcjonalne - ograniczenia zakupowe
                                                  na czas udziału w kampanii
     “limit”: {
       “perUser”: {
         “maxItems”: “1”                          – ograniczenie liczby sztuk dostępnych
                                                  dla pojedynczego użytkownika
       }
     }
   },
   “process”: {
     “status”: “REQUESTED”,                       – status zgłoszenia, dostępne są 3 wartości:
                                                  REQUESTED (wniosek czeka na przetworzenie),
                                                  PROCESSED (wniosek został przetworzony - od tego
                                                  momentu możesz sprawdzić status przypisana
                                                  oznaczenia do oferty zasobem GET sale/badges),
                                                  DECLINED (wniosek został odrzucony)
     “rejectionReasons”: []                       – powód odrzucenia zgłoszenia
   }}

Pobierz dane zgłoszenie

Za pomocą GET /sale/badge-applications/{applicationId} pobierzesz konkretne zgłoszenie oferty do kampanii i sprawdzisz jego status.

Przykładowy request:

  curl -X GET \
  'https://api.allegro.pl/sale/badge-applications/8a457b8f-627d-43cf-8806-f06f8d13c306' \
  -H 'Authorization: Bearer {token}' \
  -H 'Content-Type: application/vnd.allegro.public.v1+json'

Przykładowy response:

  {
   “id”: “8a457b8f-627d-43cf-8806-f06f8d13c306”,  – identyfikator zgłoszenia oferty do
                                                  kampanii
   “createdAt”: “2019-06-26T10:22:35.225Z”,       – data utworzenia zgłoszenia
   “updatedAt”: “2019-06-26T10:22:35.225Z”,       – data ostatniej zmiany w zgłoszeniu
   “campaign”: {
     “id”: “BARGAIN”                              – identyfikator kampanii
   },
   “offer”: {
     “id”: “6206378062”                           –  identyfikator oferty, którą chcesz dodać
                                                  do kampanii
   },
   “prices”: {                                    – informacje o cenie, jaka ma być widoczna
                                                  na ofercie i o cenie rynkowej
     “bargain”: {                                 – cena promocyjna oferty
       “amount”: “180.00”,
       “currency”: “PLN”
     },
     “market”: {                                  – cena rynkowa za oferowany przedmiot,
                                                  wyświetlimy ją jako przekreśloną na liście ofert
       “amount”: “200.00”,
       “currency”: “USD”
     }
   “process”: {
     “status”: “DECLINED”,                        – status zgłoszenia, dostępne są 3 wartości:
                                                  REQUESTED (wniosek czeka na przetworzenie),
                                                  PROCESSED (wniosek został przetworzony - od tego
                                                  momentu możesz sprawdzić status przypisana
                                                  oznaczenia do oferty zasobem GET sale/badges),
                                                  DECLINED (wniosek został odrzucony)
     “rejectionReasons”: [                        – informacja na temat powodów odrzucenia     
                                                  zgłoszenia
       {
         “code”: “BB5”,                           – powód odrzucenia zgłoszenia
         “messages”: [
           {
             “text”: “Currency is not equal to ‘PLN’”
             “link”: null
           }
         ] 
       }
     ]
   }
  }

Pobierz swoje zgłoszenia

Za pomocą GET /sale/badge-applications pobierzesz wszystkie zgłoszenia ofert do kampanii.

Przy wywołaniu musisz podać jeden z parametrów:

  • campaign.id - identyfikator kampanii,
  • offer.id - identyfikator oferty.

Aby dostosować listę wyszukiwania do swoich potrzeb, możesz skorzystać z parametrów:

  • limit by określić liczbę zgłoszeń na liście (przyjmuje wartości od 1 do 1000, domyślnie 50),

  • offset by wskazać miejsce, od którego chcesz pobrać kolejną porcję danych (przyjmuje wartości od 0 do nieskończoności, domyślnie 0).

Przykładowy request:

  curl -X GET \
  'https://api.allegro.pl/sale/badge-applications?campaign.id=BARGAIN' \
  -H 'Authorization: Bearer {token}' \
  -H 'Content-Type: application/vnd.allegro.public.v1+json'

Przykładowy response:

 {
  “badgeApplications”: [                         – lista zgłoszeń ofert do danego typu kampanii 
  {
   “id”: “8a457b8f-627d-43cf-8806-f06f8d13c306”,
   “createdAt”: “2019-06-26T10:22:35.225Z”,
   “updatedAt”: “2019-06-26T10:22:35.225Z”,
   “campaign”: {
       “id”: “BARGAIN”
         },
   “offer”: {
       “id”: “6206378062”
         },
   “prices”: {
       “bargain”: {
         “amount”: “180.00”,
         “currency”: “PLN”
       },
       “market”: {
         “amount”: “200.00”,
         “currency”: “PLN”
       }
     },
   “process”: {
       “status”: “DECLINED”,
       “rejectionReasons”: [
          {
           “code”: “BA1”,
           “messages”: [
             {
              “text”: “Badge already exists”
             },
             {
              “text”: “check terms & conditions”,
              “link”: “http://allegro.pl/xyz"
             }
           ]
          }
        ]
      }
    }
  ]
}

Kampanie przypisane do ofert

Za pomocą GET /sale/badges sprawdzisz przypisane oznaczenia do swoich ofert.

Aby dostosować listę wyszukiwania do swoich potrzeb, możesz skorzystać z parametrów:

  • limit by określić liczbę zgłoszeń na liście (przyjmuje wartości od 1 do 1000, domyślnie 50),

  • offset by wskazać miejsce, od którego chcesz pobrać kolejną porcję danych (przyjmuje wartości od 0 do nieskończoności, domyślnie 0).

Tym zasobem możesz sprawdzić przypisane oznaczenia do danej oferty, wystarczy, że wywołasz GET /sale/badges?offer.id={offerId}.

Przykładowy request:

  curl -X GET \
  'https://api.allegro.pl/sale/badges' \
  -H 'Authorization: Bearer {token}' \
  -H 'Content-Type: application/vnd.allegro.public.v1+json'

Przykładowy response:

 {
   “badges”: [
     {
       “offer”: {
         “id”: “6206378062”
       },
       “campaign”: {
         “id”: “BARGAIN”,
         “name”: “Strefa okazji”
       },
       “publication”: {
         “type”: “ALWAYS”
       },
       “prices”: {                      – informacja cenowa dotycząca oferowanego przedmiotu,
                                        zwracana tylko dla kampanii wymagających podania
                                        ceny rynkowej na etapie zgłoszenia
         “market”: {
           “amount”: “19.99”,
           “currency”: “PLN”
         },
         "subsidy": {
           "targetPrice": {             - cena widoczna dla klienta na platformie
             "amount": "9.99",
             "currency": "PLN"
            }
         }
       },
       “process”: {
         “status”: “ACTIVE”,            – status oznaczenia, dostępne wartości:
                                        IN_VERIFICATION (wniosek jest w trakcie weryfikacji),
                                        WAITING_FOR_PUBLICATION (oznaczenie jest w trakcie
                                        publikacji w serwisie), ACTIVE (oznaczenie jest aktywne
                                        i widoczne w serwisie), FINISHED (minął czas trwania
                                        oferty w kampanii lub administrator zakończył udział
                                        oferty w kampanii), DECLINED (oznaczenie zostało
                                        odrzucone i nie pojawi się w serwisie
         “rejectionReasons”: []
       }
     }
   ]
 }

Zmiana ceny i zakończenie oznaczenia

Zmiana ceny oferty w kampanii

Za pomocą PATCH /sale/badges/offers/{offerId}/campaigns/{campaignId} zlecisz operację zmiany ceny oferty w kampanii.

Przykładowy request:

  curl -X PATCH \
  'https://api.allegro.pl/sale/badges/offers/12345678/campaigns/BARGAIN' \
  -H 'Authorization: Bearer {token}' \
  -H 'Content-Type: application/vnd.allegro.public.v1+json' \
  -d '{
      "prices": {
        "bargain": {
          "value": {
            "amount": "9.99",
            "currency": "PLN"
          }
        }
      }
    }'

Przykładowy response:

{
  "id": "154179f0-ed4c-4b84-9260-302d2dec3801"  - identyfikator operacji zmiany ceny oferty
                                                  w kampanii
}
Zakończenie oznaczenia oferty w kampanii

Za pomocą PATCH /sale/badges/offers/{offerId}/campaigns/{campaignId} zlecisz też operację zakończenia oznaczenia oferty w kampanii.

Przykładowy request:

curl -X PATCH \
    'https://api.allegro.pl/sale/badges/offers/12345678/campaigns/BARGAIN' \
    -H 'Authorization: Bearer {token}' \
    -H 'Content-Type: application/vnd.allegro.public.v1+json' \
    -d '{
        "process": {
          "status": "FINISHED"
        }
    }'

Przykładowy response:

{
  "id": "154179f0-ed4c-4b84-9260-302d2dec3801"  - identyfikator operacji zakończenia
                                                  oznaczenia oferty w kampanii
}
Sprawdzenie statusu operacji

Za pomocą GET /sale/badge-operations/{operationId} sprawdzisz status wykonania operacji zmiany ceny lub zakończenia oznaczenia.

Przykładowy request:

  curl -X GET \
  'https://api.allegro.pl/sale/badge-operations/154179f0-ed4c-4b84-9260-302d2dec3801' \
  -H 'Authorization: Bearer {token}' \
  -H 'Content-Type: application/vnd.allegro.public.v1+json'

Przykładowy response:

  {
    "id": "154179f0-ed4c-4b84-9260-302d2dec3801",
    "createdAt": "2019-05-16T12:49:17.347Z",
    "updatedAt": "2019-05-16T12:49:17.530Z",
    "campaign": {
      "id": "BARGAIN"
    },
    "offer": {
      "id": "12345678"
    },
    "process": {
      "status": "PROCESSED",
      "rejectionReasons": []
    }
  }

Jak testować kampanie

W środowisku testowym skonfigurowaliśmy kampanię ’SANDBOX_TEST_CAMPAIGN’, aby można było samodzielnie sprawdzić proces.

  • Zgłoszenie z obniżką większą bądź równą 40% oraz mniejszą bądź równą 60% w stosunku do ceny przekreślonej, zostanie automatycznie zaakceptowane.

  • Zgłoszenie z obniżką mniejszą niż 40% lub większą niż 60% w stosunku do ceny przekreślonej, zostanie automatycznie odrzucone.

Oznaczenia ofert, które zgłosisz do pozostałych kampanii w środowisku testowym pozostaną w stanie IN_VERIFICATION (wniosek jest w trakcie weryfikacji).

Błędy i powody odrzucenia

Poniżej zamieściliśmy listę powodów dlaczego dane zgłoszenie może zostać przez nas odrzucone.

Kod błędu
Polski
Angielski
BB1
Polski 
Konto nie spełnia kryteriów jakościowych.
Angielski 
Account does not meet the quality criteria.
BB2
Polski 
Konto nie jest Kontem Firma.
Angielski 
Account is not a Company account type.
BB3
Polski 
Brak pola campaign.id.
Angielski 
Empty campaign.id field.
BB4
Polski 
Brak pola offer.id.
Angielski 
Empty offer.id field.
BB5
Polski 
Waluta nie jest równa [PLN].
Angielski 
Currency is not equal to [PLN].
BB6
Polski 
Jedna z wartości liczbowych nie jest liczbą.
Angielski 
One of the numeric values is not a valid number.
BB7
Polski 
Jedna z wartości liczbowych jest liczbą mniejszą od 1.
Angielski 
One of the numeric values is less than 1.
BB8
Polski 
Zgłoszenie nie istnieje.
Angielski 
Application not found.
BB9
Polski 
Nieprawidłowa wartość parametru [limit].
Angielski 
Invalid [limit] parameter value.
BB10
Polski 
Nieprawidłowa wartość parametru [offset].
Angielski 
Invalid [offset] parameter value.
BB11
Polski 
Identyfikator oferty ma nieprawidłową wartość.
Angielski 
Offer id is not valid.
BB12
Polski 
Zgłoszenie już istnieje.
Angielski 
Application already exists.
BB13
Polski 
Zbyt dużo żądań dla tego konta.
Angielski 
Too many requests from this account.
BB14
Polski 
Operacja nie istnieje.
Angielski 
Operation not found.
BB15
Polski 
Pole process jest dozwolone jedynie dla operacji zakończenia oznaczenia. Pole prices jest dozwolone jedynie dla operacji zmiany ceny.
Angielski 
The process field is only allowed for the finish badge operation. The prices field is only allowed for the price change operation.
BB16
Polski 
Pole process jest wymagane jedynie dla operacji zakończenia oznaczenia. Pole prices jest wymagane jedynie dla operacji zmiany ceny.
Angielski 
The process field is required for the finish badge operation. The prices field is required for the price change operation.
BB17
Polski 
Wartość pola process.status musi być równa FINISHED.
Angielski 
The process.status field must be equal to FINISHED.
BA1
Polski 
Oznaczenie już istnieje.
Angielski 
Badge already exists.
BA2
Polski 
Cena zniżkowa lub sugerowana cena rynkowa nie są zdefiniowane.
Angielski 
Bargain price or suggested market price are not defined.
BA3
Polski 
Cena zniżkowa i cena rynkowa nie powinny być zdefiniowane.
Angielski 
Bargain price and suggested market price should not be defined.
BA4
Polski 
Oferta nie istnieje.
Angielski 
Offer not found.
BA5
Polski 
Aktualna cena oferty jest wyższa od sugerowanej ceny rynkowej.
Angielski 
Current offer price is higher than suggested market price.
BA6
Polski 
Oferta została zakończona.
Angielski 
Offer has ended.
BA7
Polski 
Konto nie istnieje.
Angielski 
Account not found.
BA8
Polski 
W trakcie przetwarzania konto przestało być Kontem Firma.
Angielski 
Account is no longer a Company account type.
BA9
Polski 
Konto nie jest właścicielem oferty.
Angielski 
This account is not the owner of the offer.
BA10
Polski 
Kampania nie istnieje.
Angielski 
Campaign not found.
BA11
Polski 
Kampania została zakończona.
Angielski 
Campaign has ended.
BA12
Polski 
Cena zniżkowa jest wyższa od aktualnej ceny oferty.
Angielski 
Bargain price is higher than current offer price.
BA13
Polski 
Cena zniżkowa jest równa sugerowanej cenie rynkowej.
Angielski 
Bargain price is the same as suggested market price.
BA14
Polski 
Cena zniżkowa jest taka sama lub wyższa od sugerowanej ceny rynkowej.
Angielski 
Bargain price is the same or higher than suggested market price.
BA15
Polski 
Oznaczenie zostało już zaakceptowane.
Angielski 
Badge has already been accepted.
BA16
Polski 
Zniżka musi wynosić co najmniej 1% w stosunku do sugerowanej ceny rynkowej.
Angielski 
Discount must be greater or equal to 1% to the suggested market price.
BA17
Polski 
Oferta ma za mało sztuk.
Angielski 
Offer has not enough items.
BA18
Polski 
Oferta jest mało atrakcyjna.
Angielski 
Offer is not attractive enough.
BA19
Polski 
Opis lub tytuł nie spełnia wymagań.
Angielski 
Offer’s title or description does not meet requirements.
BA20
Polski 
Miniaturka nie spełnia wymagań.
Angielski 
Offer’s thumbnail does not meet requirements.
BA21
Polski 
Produkt w tej lub niższej cenie jest na innym Twoim koncie.
Angielski 
Product with equal or lower price exists in your another account.
BA22
Polski 
Konto nie spełnia kryteriów - minimum 98% pozytywnych ocen z 3 ostatnich miesięcy.
Angielski 
Account does not meet the criteria - minimum 98% positive rates from last 3 months.
BA24
Polski 
Oferta posiada już inne oznaczenie obniżające cenę.
Angielski 
A discount badge for this offer already exists.
BA25
Polski 
Wymagany kontakt z zespołem Strefy okazji pod adresem [strefaokazji@allegro.pl].
Angielski 
Contact required with Strefa okazji team at [strefaokazji@allegro.pl].
BA26
Polski 
Oferta nie spełnia kryteriów danego oznaczenia.
Angielski 
Offer does not meet requirements for this badge.
BA27
Polski 
Brak odpowiedniej metody dostawy.
Angielski 
No suitable delivery method.
BA28
Polski 
Oferta nie spełnia kryteriów udziału w programie.
Angielski 
Offer does not meet requirements for this program.
BA29
Polski 
Proponowana cena zniżkowa oferty jest niepoprawna. Właściwa cena maksymalna znajduje się liście produktów dla tej kampanii.
Angielski 
The proposed bargain price is incorrect. The maximum price is on the list of products for this campaign.
BA30
Polski 
Oferta posiada niepoprawny kod EAN. Właściwy kod EAN znajdziesz na liście produktów dla tej kampanii.
Angielski 
The offer has an incorrect EAN code. You can find the correct EAN code on the list of products for this campaign.
BA31
Polski 
Oferta nie ma uzupełnionego kodu EAN. Właściwy kod EAN znajdziesz na liście produktów dla tej kampanii.
Angielski 
The offer does not have EAN code. You can find the correct EAN code on the list of products for this campaign.
BA32
Polski 
Oferta jest wystawiona w złej kategorii.
Angielski 
Offer was published in wrong category.
BA33
Polski 
Proponowana cena zniżkowa oferty jest niepoprawna. Właściwa cena maksymalna znajduje się liście produktów dla tej kampanii.
Angielski 
The proposed bargain price is incorrect. The maximum price is on the list of products for this campaign.
BA34
Polski 
Zgłoszenie nie zawiera informacji na temat ceny zniżkowej.
Angielski 
The application does not contain information about bargain price.
BA35
Polski 
Oferta tego produktu nie posiada wystarczającej liczby sztuk, która jest określona na liście produktów dla tej kampanii.
Angielski 
The offer of this product does not have required quantity of items which is specified on the list of product for this campaign.
BA36
Polski 
Sugerowana cena rynkowa nie może być zdefiniowana dla kampanii tego typu.
Angielski 
Suggested market price must not be defined in this campaign type.
BA37
Polski 
Nie możemy obliczyć średniej ceny sprzedaży dla tej oferty. Brak wystarczającej liczby zakupów w ofercie.
Angielski 
Average selling price cannot be calculated for this offer. There is insufficient number of purchases.
BA38
Polski 
W tej kampanii wymagamy odpowiedniej obniżki w stosunku do średniej ceny sprzedaży oferty. Podana cena zniżkowa w kampanii jest za wysoka.
Angielski 
Given bargain price is too high. Campaign requires corresponding price reduction from offer’s average selling price.
BA39
Polski 
W tej kampanii wymagamy odpowiedniej obniżki w stosunku do ceny oferty. Podana cena zniżkowa w kampanii jest za wysoka.
Angielski 
Given bargain price is too high. Campaign requires corresponding price reduction from offer’s base price.
BA40
Polski 
Wprowadzona sugerowana cena rynkowa jest zawyżona. Podana cena nie może być wyższa niż średnia cena sprzedaży oferty.
Angielski 
Given market price is too high. Campaign requires corresponding price reduction from offer’s average selling price.
BA41
Polski 
Wprowadzona sugerowana cena rynkowa jest zawyżona. Podana cena nie może być wyższa niż cena sprzedaży oferty.
Angielski 
Given market price is too high. Campaign requires corresponding price reduction from offer’s base price.
BA42
Polski 
Oferta nie ma oznaczenia [Smart!]. W kampanii mogą brać udział tylko oferty z tym oznaczeniem.
Angielski 
Offer does not meet requirements of [Smart!] program. Only offers meeting [Smart!] criteria can participate in this campaign.
BA43
Polski 
Wartość parametru [Stan] w ofercie jest inna niż [Nowy].
Angielski 
Offer’s parameter [Condition] is different than [New].
BA44
Polski 
Konto nie spełnia wymaganych kryteriów jakościowych.
Angielski 
Account does not meet the required quality criteria.
BA45
Polski 
Limit zgłoszeń dla tej oferty został przekroczony. Ponowne zgłoszenie do tej kampanii będzie możliwe za 24 godziny.
Angielski 
The limit of applications for this offer has been exceeded. You can re-apply to this campaign after 24 hours.
BA46
Polski 
Oferta jest wystawiona w kategorii, która nie spełnia kryteriów kampanii.
Angielski 
The offer is listed in a category that does not meet the criteria of the campaign.
BA47
Polski 
Oferta nie spełnia kryteriów kampanii. Została wystawiona więcej niż 6 miesięcy temu.
Angielski 
The offer does not meet the criteria of the campaign. It was listed more than 6 months ago.
BA48
Polski 
Oferta nie spełnia kryteriów kampanii. Oferta nie jest opublikowana.
Angielski 
The offer does not meet the criteria of the campaign. It has not been published.
BA49
Polski 
W tej kampanii wymagamy odpowiedniej obniżki w stosunku do sugerowanej ceny rynkowej oferty. Proponowana obniżka ceny jest za niska.
Angielski 
Given bargain discount is too low. Campaign requires corresponding price reduction from offer’s suggested market price.
BA50
Polski 
W tej kampanii wymagamy odpowiedniej obniżki w stosunku do sugerowanej ceny rynkowej oferty. Proponowana obniżka ceny jest zbyt wysoka.
Angielski 
Given bargain discount is too high. Campaign requires corresponding price reduction from offer’s suggested market price.
BA51
Polski 
Oferta jest zarchiwizowana.
Angielski 
Offer is archived.
BA52
Polski 
Oferta jest nieaktywna.
Angielski 
Offer is inactive.
BA53
Polski 
Liczba sprzedanych sztuk przedmiotów na ofercie przez ostatnie 30 dni jest niewystarczająca.
Angielski 
The number of offer items sold over the last 30 days is insufficient.
BA54
Polski 
Twój produkt znajduje się na liście produktów objętych akcją promocyjną innej aktywnej kampanii.
Angielski 
Your product is included in the promotional campaign list of another active campaign.
BA57
Polski 
Oferta przestała być atrakcyjna cenowo względem cen rynkowych i cen w serwisie Allegro.pl.
Angielski 
The offer price is not attractive enough compared to the market and Allegro Prices.
BA58
Polski 
Wymagane jest powiązanie oferty z produktem.
Angielski 
It is required to link the offer with a product.
BA59
Polski 
Oferta odrzucona na wniosek sprzedającego.
Angielski 
The offer rejected at the request of the seller.
BA60
Polski 
Operacja niedozwolona na oznaczeniu w kampanii standardowej.
Angielski 
Operation on standard badge not allowed.
BA61
Polski 
Status oznaczenia nie pozwala na edycję.
Angielski 
Operation not allowed because of badge status.
BA62
Polski 
Nie odnaleziono oznaczenia.
Angielski 
Badge not found.
BA63
Polski 
Nie można zmodyfikować ceny zniżkowej.
Angielski 
Bargain price is not editable.
BA64
Polski 
Dotychczasowa kampania została zakończona, zgłoś ofertę na nowych zasadach.
Angielski 
The current campaign has been ended, submit your offer on the new terms.
BA65
Polski 
Oferta jest dostępna w sprzedaży z niższą ceną lub nie spełnia warunku odpowiedniej obniżki.
Angielski 
The offer is available at a lower price or does not meet the condition of appropriate price reduction.
BA66
Polski 
Podana cena promocyjna spełnia wymagania.
Angielski 
Given promotional price meets campaign requirements.
BA67
Polski 
Oferta musi być skierowana wyłącznie do klientów biznesowych.
Angielski 
The offer must be directed to business customers only.
BA68
Polski 
Oferta jest skierowana wyłącznie do klientów biznesowych.
Angielski 
The offer is directed to business customers only.
BA69
Polski 
Niedozwolona operacja na etykiecie niestandardowego oznaczenia.
Angielski 
Operation on custom label badge not allowed
BA70
Polski 
Próba zmiany ceny oferty, która nie jest w odpowiednim formacie.
Angielski 
Trying to change price for offer that is NOT in BUY_NOW format.
BA71
Polski 
Cena oferty jest wyższa niż maksymalna cena dotowana.
Angielski 
Offer price is higher than max subsidy price.
BA72
Polski 
Cena oferty jest niższa bądź równa docelowej cenie dotowanej.
Angielski 
Offer price is lower or equal to subsidy target price.
BA73
Polski 
Kategoria nie istnieje.
Angielski 
Category not found.
BA74
Polski 
Osiągnięto datę końca. Oznaczenie zostało zakończone.
Angielski 
The end date has been reached. The badge has ended.
BA75
Polski 
Oznaczenie nie znajduje się w kampanii.
Angielski 
Badge is not in the campaign.
BA76
Polski 
Modyfikacja oznaczania dla tej kampanii jest niedozwolone.
Angielski 
Modifying badge from this campaign is not allowed.
BA77
Polski 
Oznaczenie jest już w stanie końcowym.
Angielski 
Badge is already in terminable state.
BA78
Polski 
Data początku oznaczenia jest później niż data zakończenia.
Angielski 
Badge start date is after its end date.
BA79
Polski 
Nie można zmodyfikować kampanii.
Angielski 
Campaign is not editable.
BA80
Polski 
Oferta nie jest zniżką.
Angielski 
Offer is not a bargain.
BA81
Polski 
Oferta nie jest aktywna.
Angielski 
Offer is inactive.
BA82
Polski 
Oferta nie jest wielosztuką.
Angielski 
Offer is not a multipack
BA83
Polski 
Oferta jest już w panelu administracyjnym.
Angielski 
Offer is already in admin.
BA84
Polski 
W niestandardowym oznaczeniu musi zostać zdefiniowana etykieta.
Angielski 
Custom label field must be defined in custom label badge type.
BA85
Polski 
Etykieta niestandardowego oznaczenia nie może zawierać ceny.
Angielski 
Custom label must not have prices defined.
BA86
Polski 
Żądane pochodzenie nie jest wspierane przez niestandardowe oznaczenie.
Angielski 
Requested origin is not supported in custom label badge.
BA87
Polski 
Limit zakupów na użytkownika w tej ofercie jest mniejszy niż 1.
Angielski 
The purchase limit per user is less than 1 in this offer.
BA88
Polski 
Niepoprawny stan oznaczenia.
Angielski 
Wrong badge status.
BB0
Polski 
Wystąpił błąd podczas przetwarzania zgłoszenia. Prosimy spróbować ponownie później.
Angielski 
Error occurred during application processing. Please try again later.

Allegro Ceny - jak zarządzać zgodami na uczestnictwo w programie

Jak pobrać aktualne zgody dla oferty

Użyj GET /sale/allegro-prices-offer-consents/{offerId}, gdzie jako offerID wskaż numer konkretnej oferty.

Przykładowy request:

 curl -X GET \
 'https://api.allegro.pl/sale/allegro-prices-offer-consents/993723618' \
 -H 'Accept: application/vnd.allegro.public.v1+json' \
 -H 'Content-Type: application/vnd.allegro.public.v1+json' 

Przykładowy response:

 {
  "status": "ALLOWED"            -- status zgody. Dostępne wartości: “ALLOWED” - zgoda na 
                                uczestnictwo w programie, “DENIED” - brak zgody.
 }
Jak zaktualizować zgodę dla oferty

Zrobisz to za pomocą PUT /sale/allegro-prices-offer-consents/{offerId}. Jako offerID wskaż konkretny numer oferty.

Przykładowy request:

 curl -X PUT \
 'https://api.allegro.pl/sale/allegro-prices-offer-consents/993723618'
 -H 'Accept: application/vnd.allegro.public.v1+json' \
 -H 'Content-Type: application/vnd.allegro.public.v1+json' \
 - d'{
      "status": "ALLOWED"        -- status zgody. Dostępne wartości: “ALLOWED” - zgoda na  
                               uczestnictwo w programie, “DENIED” - brak zgody.
 }'

Przykładowy response:

 {
  "status": "ALLOWED"
 }
Jak pobrać aktualne uprawnienia dla konta

Skorzystaj w tym celu z GET /sale/allegro-prices-account-eligibility. W odpowiedzi, oprócz informacji o aktualnej zgodzie (consent), w polu qualification.status sprawdzisz, czy konto kwalifikuje się do uczestnictwa w programie. Kryteria kwalifikacji znajdziesz na stronie dla sprzedających.

Przykładowy request:

 curl -X GET \
 'https://api.allegro.pl/sale/allegro-prices-account-eligibility' \
 -H 'Accept: application/vnd.allegro.public.v1+json' \
 -H 'Content-Type: application/vnd.allegro.public.v1+json' 

Przykładowy response:

 {
  "consent": "ALLOWED",            -- informacja o zgodzie na uczestnictwo w programie. 
                                Dostępne wartości: “ALLOWED” - zgoda na uczestnictwo 
                                w programie, “DENIED” - brak zgody.
  "qualification": {
    "status": "QUALIFIED"        -- informacja, czy konto kwalifikuje się do uczestnictwa 
                                w programie. Dostępne wartości: 
                                QUALIFIED albo DISQUALIFIED.
   }
 }
Jak zaktualizować zgodę dla konta

Zrobisz to za pomocą PUT /sale/allegro-prices-account-consent.

Przykładowy request:

 curl -X PUT \
 'https://api.allegro.pl/sale/allegro-prices-account-consent' \
 -H 'Accept: application/vnd.allegro.public.v1+json' \
 -H 'Content-Type: application/vnd.allegro.public.v1+json' \
 - d '{
      "status": "ALLOWED"     -- status zgody. Dostępne wartości “ALLOWED” - zgoda 
                            na uczestnictwo w programie, “DENIED” - brak zgody.
 }'

Przykładowy response:

 {
  "status": "ALLOWED"
 }

Lista zasobów

Pełną dokumentację zasobów w postaci pliku swagger.yaml znajdziesz tu.

Lista zasobów podstawowych opisanych w poradniku:

  • GET /sale/badge-campaigns - pobierz listę dostępnych kampanii
  • POST /sale/badges - zgłoś ofertę do danego oznaczenia
  • GET /sale/badge-applications/{applicationId} - pobierz szczegóły danego zgłoszenia

Lista zasobów wspierających opisanych w poradniku:

  • GET /sale/badges - pobierz kampanie i oznaczenia przypisane do ofert
  • GET /sale/badge-applications - pobierz listę swoich zgłoszeń
  • GET /sale/allegro-prices-offer-consents/{offerId} - pobierz aktualną informację o zgodzie na udział oferty w programie wsparcia Allegro Ceny
  • PUT /sale/allegro-prices-offer-consents/{offerId} - zaktualizuj zgodę na udział oferty w programie wsparcia Allegro Ceny
  • GET /sale/allegro-prices-account-eligibility - pobierz aktualne uprawnienia dla konta na uczestnictwo w programie Allegro Ceny
  • PUT /sale/allegro-prices-account-consent - zaktualizuj zgodę dla konta na uczestnictwo w programie Allegro Ceny

Zgłoś błąd lub zasugeruj zmianę

Czy ten artykuł był dla Ciebie przydatny?