Aktualności

GET /offers/listing - przypomnienie o zmianach od 1.06.2021

Przypominamy, że 1.06.2021 wprowadzimy zmiany dla zasobu GET /offers/listing:

• będzie dostępny tylko dla zweryfikowanych aplikacji,
• popularność - zamiast liczby sprzedanych przedmiotów będą dostępne tylko zakresy: 0, [1-5], [6-10], [11-20], [21-50], [51-100], [101>]
• sortowanie po popularności nie będzie możliwe,
• wyszukiwanie zostanie ograniczone do 10 stron (maksymalna wartość parametru offset to 600).

Ważne! Aby przejść proces weryfikacji skontaktuj się z nami przez formularz lub ze swoim opiekunem, jeśli jesteś w Programie Partnerskim dla Sprzedających.

Poprzednie informacje:

• GET /offers/listing - tylko dla zweryfikowanych aplikacji (1.03.2021)
• Zmieniliśmy regulamin REST API (15.03.2021)

Nowe statusy realizacji zamówienia

Aby ułatwić obsługę zamówień z odbiorem osobistym przesyłki w punkcie sprzedającego, dla zasobu:

• PUT /order/checkout-forms/{id}/fulfillment

dodaliśmy dziś dwie nowe wartości:

• READY_FOR_PICKUP - gotowa do odbioru,
• PICKED_UP - odebrana,

które możesz przekazać w polu: “status” w celu aktualizacji statusu realizacji zamówienia.

Jednocześnie dla zasobów:

• GET /order/checkout-forms,
• GET /order/checkout-forms/{id},

nowe wartości będziemy zwracać w polu: fulfillment.status.

Więcej informacji na temat zmiany statusu realizacji zamówienia, znajdziesz w naszym poradniku, natomiast pełną listę statusów - w naszej dokumentacji.

Jak oceniasz portal developerski Allegro?

Wypełnij ankietę na temat naszej strony Allegro API. Chcemy ulepszyć nasz devportal i jak najlepiej dostosować go do twoich potrzeb, a uzyskane odpowiedzi pozwolą nam obrać kierunek dalszego rozwoju naszej strony.

Ankieta nie zajmie ci więcej niż kilka minut. Aby ją wypełnić - kliknij tu.

Sieć punktów Allegro - udostępniliśmy nowe zasoby do obsługi przesyłek

Uruchomiliśmy dzisiaj sieć punktów Allegro. Kupujący dzięki nowej metodzie dostawy “Allegro Punkty” mogą zamówić przedmioty do jednego z naszych punktów odbioru. Metoda dostawy jest aktualnie dostępna tylko dla wybranych sprzedających, a od 25 maja będą mogli z niej korzystać także pozostali użytkownicy. Na początek udostępniliśmy około 600 punktów w Salonikach Kolportera. Do końca 2021 roku planujemy dodać kolejne punkty, w tym także nasze automaty paczkowe. Więcej informacji na ten temat znajdziesz na stronie dla sprzedających.

Sprzedający będą mogli wygenerować etykiety tylko przez narzędzie Wysyłam z Allegro, dlatego już dziś udostępniliśmy nowe endpointy, dzięki którym łatwiej obsłużysz zamówienia:

• GET /order/carriers/ALLEGRO/points - pobierz listę punktów Allegro, w których klienci mogą nadawać i odbierać przesyłki. W przyszłości będziemy zwracać także listę automatów paczkowych;
• GET /order/carriers/ALLEGRO/tracking - pobierz historię statusów dla przesyłek Allegro nadanych do naszej sieci.

Więcej informacji, jak korzystać z powyższych zasobów, znajdziesz w naszym poradniku.

Dodatkowo, w odpowiedzi dla:

• GET /sale/delivery-methods - dodaliśmy nową metodę dostawy “Allegro Punkty”,
• GET /parcel-management/delivery-service - dodaliśmy nową usługę dostawy “ALLEGRO”.

Dostosujemy Allegro API do Pakietu eCommerce VAT

1 lipca 2021 Unia Europejska wprowadza Pakiet eCommerce VAT. Dlatego za część transakcji między przedsiębiorcami a konsumentami (B2C) na platformach elektronicznych, sprzedający spoza Unii Europejskiej będą się rozliczać na nowych zasadach. Więcej na ten temat dowiesz się w informacjach dla sprzedających.

W związku z tym, od 19 maja wprowadzimy nowy zasób:

• GET /sale/tax-settings?category.id={categoryId} - pobierz wszystkie ustawienia VAT dostępne we wskazanej kategorii. Na podstawie otrzymanej listy możesz skonfigurować ustawienia podatku VAT dla ofert sprzedającego wystawionych w danej kategorii.

  Przykładowy request:

  curl -X GET 
  
  ‘https://api.allegro.pl/sale/tax-settings?category.id=316194’ 
  
  -H ‘Authorization: Bearer {token}’ 
  
  -H ‘accept: application/vnd.allegro.public.v1+json’
  

  Przykładowy response:

  {
    “settings”: [                                         – lista dostępnych ustawień we
                                                          wskazanej w żądaniu kategorii
      {
        “id”: “f40ae51c-70a2-4882-98a7-6272404f0ec5”,     – identyfikator niezmiennego
                                                          stawienia podatku VAT
        “rate”: {                                         – obiekt reprezentujący stawkę
                                                          podatku VAT przypisaną do tego
                                                          ustawienia
          “id”: “OUT_OF_SCOPE_OF_VAT”,                    – identyfikator stawki VAT, w
                                                          zależności od kategorii
                                                          dostępne wartości to:
                                                          23.00, 8.00, 5.00, EXEMPT,
                                                          OUT_OF_SCOPE_OF_VAT.
                                                          Możemy rozszerzyć słownik
                                                          dostępnych wartości.
          “name”: “Out of scope of VAT”                   – nazwa stawki VAT
        },
        “subject”: {                                      – obiekt reprezentujący
                                                          przedmiot opodatkowania
                                                          przypisany do tego ustawienia
          “id”: “GOODS”,                                  – identyfikator przedmiotu
                                                          opodatkowania
          “name”: “Goods”                                 – nazwa przedmiotu
                                                          opodatkowania
        },
        “exemption”: {                                    – obiekt reprezentujący
                                                          zwolnienie z opodatkowania
                                                          przypisane temu ustawieniu
          “id”: “MPV”,                                    – identyfikator zwolnienia
          “name”: “MPV (multi-purpose voucher)”           – nazwa zwolnienia
        }
      }
      …
    ]
  }
  

Ważne! W poszczególnych kategoriach dostępne ustawienia VAT mogą się różnić. Dlatego sprawdzaj, jakie stawki VAT są dla danej kategorii dostępne.

Równocześnie rozszerzymy obiekt tax o nowe pola na zasobach:

• /sale/offers,
• /sale/product-offers.

Nowe pola to:

• tax.id - identyfikator niezmiennego ustawienia podatku VAT,
• tax.rate - stawka podatkowa,
• tax.subject - przedmiot opodatkowania,
• tax.exemption - zwolnienie z opodatkowania.

Ważne! Aby wprowadzać ustawienia VAT wciąż możesz korzystać z pola tax.percentage, jednak w przyszłości całkowicie usuniemy to pole. Po wskazaniu stawki VAT w polu tax.percentage przypiszemy do oferty odpowiednie dla kategorii ustawienia VAT.

Aby wprowadzić lub zmienić ustawienia VAT w ofercie:

• przekaż odpowiednią kombinację wartości pól tax.rate, tax.subject oraz tax.exemption, na podstawie których znajdziemy identyfikator pasującego ustawienia. W przypadku braku dopasowania zwrócimy błąd walidacji z informacją, które pola powinny zostać uzupełnione lub komunikatem o całkowitym braku dopasowania.

  Przykładowy request:

  curl -X PUT
  ‘https://api.allegro.pl/sale/offers/9531382307’ 
  
  -H ‘Authorization: Bearer {token}’ 
  
  -H ‘Accept: application/vnd.allegro.public.v1+json’ 
  
  -H ‘Content-Type: application/vnd.allegro.public.v1+json’ 
  
  -d ’
  {
      “id”: “9531382307”,
      “name”: “Oferta testowa”,
      “category”: {
          “id”: “257150”
  },
  …
    “tax”: {
      “rate”: “23.00”,
      “subject”: “GOODS”,
      “exemption”: “MONEY_EQUIVALENT”
    }
  …
  }’
  

  Przykładowy response:

  {
      “id”: “9531382307”,
      “name”: “Oferta testowa”,
      “category”: {
          “id”: “257150”
  },
  …
    “tax”: {
      “id”: “f40ae51c-70a2-4882-98a7-6272404f0ec5”,
      “rate”: “23.00”,
      “subject”: “GOODS”,
      “exemption”: “MONEY_EQUIVALENT”,
      “percentage”: “23.00”
    }
  …
  }
  

• w polu tax.id przekaż identyfikator ustawienia VAT pozyskany dzięki GET /sale/tax-settings?category.id={categoryId}.

  Przykładowy request:

  curl -X PATCH 
  
  ‘https://api.allegro.pl/sale/product-offers/9531382307’ 
  
  -H ‘Authorization: Bearer {token}’ 
  
  -H ‘Accept: application/vnd.allegro.beta.v2+json’ 
  
  -H ‘Content-Type: application/vnd.allegro.beta.v2+json’ 
  
  -d ’
  {
    “tax”: {
      “id”: “f40ae51c-70a2-4882-98a7-6272404f0ec5”
    }
  }’
  

  Przykładowy response:

  {
      “id”: “9531382307”,
      “name”: “Przykładowy produkt”,
      “product”: {
          “id”: 5902719471797
      },
  …
    “tax”: {
      “id”: “f40ae51c-70a2-4882-98a7-6272404f0ec5”,
      “rate”: “23.00”,
      “subject”: “GOODS”,
      “exemption”: “MONEY_EQUIVALENT”,
      “percentage”: “23.00”
    }
  …
  }
  

Więcej informacji o pakiecie eCommerce VAT znajdziesz na stronie dla sprzedających.

Termin spłaty dla odroczonej płatności

W Odroczonej płatności dla Firm klient ma możliwość odroczenia spłaty zamówienia o 21, 45 lub 60 dni. Aby Sprzedający otrzymał płatność, musi on dostarczyć fakturę, która zawiera termin zapłaty (data zakupu + wybrany przez kupującego czas odroczenia).

Aby zautomatyzować ten proces, dla zasobów:

• GET /order/checkout-forms/{id},
• GET /order/checkout-forms

udostępniliśmy dziś nowe pole “dueDate” w obiekcie “invoice”. W polu tym zwracamy datę, która określa termin odroczenia płatności.

Ważne! Wartość pola “dueDate” zwrócimy tylko dla Odroczonych płatności dla Firm. Dla wszystkich pozostałych płatności pole przyjmie wartość null.

Przykładowy response:

…
{
  “invoice”: {
    “required”: true,
    “address”: {
      “street”: “Grunwaldzka 182”,
      “city”: “Poznań”,
      “zipCode”: “60-166”,
      “countryCode”: “PL”,
      “company”: {},
      “naturalPerson”: {}
    },
    “dueDate” : “2021-12-01”
  }
…
}

Więcej informacji o Odroczonej płatności dla Firm znajdziesz w Pomocy Allegro oraz w naszych aktualnościach.

Nowe metody dostawy z Niemiec i Czech

Udostępniliśmy dziś nowe metody dostawy. Identyfikatory nowych metod uzyskasz za pomocą: GET/sale/delivery-methods:

• Kurier DPD wysyłka z Niemiec - id: 0c608ab6-4eed-491b-9ec5-8c1458ebe7cc,
• Kurier DPD wysyłka z Czech - id: 046a3da7-354b-4630-858a-8c1458ebe7cc,
• Kurier UPS wysyłka z Niemiec - id: 0ed0d545-3e7a-4cd9-b0e8-8c1458ebe7cc,
• Kurier UPS wysyłka z Czech - id: 041b2a75-face-4827-8dca-8c1458ebe7cc.

Więcej informacji na temat metod dostawy znajdziesz w naszym poradniku.

Od 7 maja będziemy wymagać, aby 1% ofert w kolejnych kategoriach motoryzacyjnych był powiązany z Katalogiem produktów Allegro

W 2019 roku wprowadziliśmy Katalog produktów Allegro w wybranych kategoriach serwisu. W ramach Katalogu produktów Allegro chcemy zebrać i opisać wszystkie produkty, jakie są dostępne w ofertach wystawianych przez wszystkich sprzedawców. Katalogujemy pojedyncze produkty jako reprezentatywne, które odróżniają się od innych swoimi właściwościami, np. modelem, kodem producenta, numerem GTIN, czy innymi parametrami podstawowymi.

Od 18 stycznia wymagamy, aby 1% ofert w wybranych kategoriach motoryzacyjnych był powiązany z Katalogiem produktów Allegro. 7 maja do listy kategorii dodamy kolejne kategorie motoryzacyjne. Ich pełną listę znajdziesz tutaj.

Ważne! Jeżeli sprzedawca nie spełni tego wymagania, to będzie mógł wystawić nową, podobną lub wznowić zakończoną ofertę, tylko jeśli wskaże produkt dostępny w Katalogu lub doda nowy produkt na podstawie swojej oferty.

Więcej o tym, jak skatalogować ofertę, przeczytasz w naszym poradniku. Zapoznaj się także z zasobem /sale/product-offers, dzięki któremu za pomocą jednego żądania POST wystawisz aktywną ofertę powiązaną z produktem:

• który istnieje już w naszej bazie. Wystarczy, że w żądaniu przekażesz numer EAN (lub identyfikator produktu) oraz cenę i liczbę sztuk;
• którego nie ma w naszej bazie. W strukturze żądania za pomocą kompletu danych opiszesz sprzedawany produkt oraz przekażesz informacje o cenie i liczbie sztuk.

Aby sprawdzić, które z ofert nie są powiązane z produktem, skorzystaj z GET /sale/offers i parametru product.id.empty=true.

Allegro Ceny - oznaczenie nie zmienia ceny w ofercie

Allegro Ceny to program, który pomaga Sprzedającym zaoferować najlepsze ceny na rynku – bez ponoszenia żadnych dodatkowych kosztów.

Aktualnie, wraz z zakwalifikowaniem oferty do programu Allegro Ceny, tak jak w przypadku pozostałych kampanii, aktualizujemy również cenę w jej strukturze - zmiana ta jest widoczna w polu sellingMode.price.amount na zasobach:

• /sale/offers,
• /sale/product-offers.

Od 14 kwietnia 2021 zmienimy mechanizm dla kampanii w ramach programu Allegro Ceny. Jeżeli oferta zostanie zakwalifikowana do tego programu, nie zmienimy ceny w jej strukturze. Dlatego cena, którą zwrócimy w polu sellingMode.price.amount pozostanie bez zmiany.

W związku z tym, w odpowiedzi na GET /sale/offer-events nie zwrócimy także zdarzenia o zmianie ceny w ofercie w wyniku jej zakwalifikowania do programu.

Równocześnie, w odpowiedzi na GET /sale/badges nie będziemy już zwracać pola prices.subsidy.sellerPrice i całkowicie je usuniemy.

Aby sprawdzić, które oferty zostały zakwalifikowane do programu Allegro Ceny skorzystaj z GET /sale/badges.

Ważne! Każda zmiana ceny towaru w ofercie spowoduje wyłączenie programu Allegro Ceny dla tej oferty. Ponowne zakwalifikowanie oferty do programu będzie możliwe dopiero w następnej rundzie kwalifikacyjnej.

Oferty dotychczas zakwalifikowane do programu zostaną zmigrowane i będą funkcjonować w ramach nowego mechanizmu.

Więcej informacji o programie Allegro Ceny przeczytasz na stronie dla sprzedających. Dowiedz się również, jakie zmiany wprowadziliśmy, aby ułatwić obsługę zamówień, w których kupujący dokonał zakupu w ramach oferty zakwalifikowanej do programu Allegro Ceny.

POST /sale/offer-tags - zmniejszyliśmy do 100 limit tagów ofertowych

Zmniejszyliśmy dzisiaj limit tagów ofertowych, jakie możesz dodać do konta za pomocą: POST /sale/offer-tags. Dotychczasowy limit, który wynosił: 10000, zmieniliśmy na: 100.

Ważne! Nie usuniemy nadmiarowych tagów użytkownikom, którzy już wcześniej przekroczyli próg 100 tagów. Pamiętaj jednak, że Kupujący na stronie WWW zobaczą tylko 100 pierwszych tagów, które nie są ukryte.

Więcej informacji o tym jak dodać tagi do oferty znajdziesz w naszym poradniku.

Usunęliśmy pole “ean” oraz obiekt “eans”

Zgodnie z wcześniejszą zapowiedzią, dzisiaj usunęliśmy:

• pole “ean” w POST /sale/offers i PUT /sale/offers/{offerId},
• obiekt “eans” w POST /sale/product-proposals.

Skorzystaj z parametru globalny numer jednostki handlowej tzw. GTIN, aby uzupełnić EAN, ISBN i ISSN.

PATCH /sale/product-offers/{offerId} - dodaliśmy obsługę pola product.id

Za pomocą PATCH /sale/product-offers/{offerId} zmienisz dane w ofercie w prosty sposób.

Wystarczy, że w strukturze przekażesz dowolne pole oferty, nie musisz przekazywać całego jej modelu.

W ostatnim czasie zapowiedzieliśmy, że 1.04.2021 zwiększymy wymóg procentowy ofert połączonych z Katalogiem produktów Allegro.

Aby ułatwić proces powiązania oferty z produktem, dodaliśmy dziś obsługę pola product.id, w którym wskazujesz identyfikator danego produktu lub numer GTIN (EAN, ISBN, ISSN). W odpowiedzi automatycznie zaktualizujemy w ofercie:

• kategorię i parametry,
• opis,
• zdjęcia,
• sekcję “pasuje do”,
• specyfikację techniczną TecDoc

zgodnie z danymi zawartymi w produkcie.

Oznacza to, że jeżeli w żądaniu PATCH /sale/product-offers/{offerId} przekazujesz product.id, zgadzasz się na to, aby ofertę dostosować do produktu.

Ważne! Jeżeli chcesz zachować aktualny opis, zdjęcia i parametry produktowe, oprócz product.id powinieneś przekazać również takie pola jak: description, images i product.parameters. Możesz je pobrać z edytowanej przez Ciebie oferty, korzystając z zasobu: GET /sale/offers/{offerId}.

Aby przedstawić proces powiązania oferty z produktem metodą PATCH, udostępniliśmy w naszym poradniku szczegółową instrukcję.

Przykładowy request:

curl -X PATCH 

  ‘https://api.allegro.pl/sale/product-offers/7680042192 

  -H ‘Authorization: Bearer {token}’  

  -H ‘Accept: application/vnd.allegro.beta.v2+json’
  -H ‘Content-Type: application/vnd.allegro.beta.v2+json’ 

  -d ’{
  “product”: {
        “id”: “0475a562-fbbb-4260-b772-59a82aa96554”
        }
  }’

Pamiętaj, że nie możesz usunąć produktu z oferty. W przypadku, gdy w polu product.id przekażesz wartość null - zwrócimy błąd 422.

Przykładowy response:

 {
    “id”: “7680042192”,
    “name”: “Żarówka samochodowa LED”,
    “product”: {
        “id”: “0475a562-fbbb-4260-b772-59a82aa96554”,
        “publication”: {
            “status”: “NOT_LISTED”
        }
    },
    “afterSalesServices”: {
        “impliedWarranty”: {
            “id”: “f4f3541e-41c2-481f-938a-2a1b8c0ce65a”
        },
        “returnPolicy”: {
            “id”: “7068910b-29b9-449b-8ad0-99625a6312db”
        },
        “warranty”: null
    },
    “payments”: {
        “invoice”: “NO_INVOICE”
    },
    “sellingMode”: {
        “format”: “BUY_NOW”,
        “price”: {
            “amount”: 100,
            “currency”: “PLN”
        },
        “startingPrice”: null,
        “minimalPrice”: null
    },
    “stock”: {
        “available”: 3,
        “unit”: “UNIT”
    },
    “location”: {
        “countryCode”: “PL”,
        “province”: “WIELKOPOLSKIE”,
        “city”: “Poznań”,
        “postCode”: “60-166”
    },
    “delivery”: {
        “shippingRates”: {
            “id”: “7dd8049c-1753-4842-8870-e29a2efc3d62”
        },
        “handlingTime”: “PT48H”,
        “additionalInfo”: “”
    },
    “publication”: {
        “duration”: null,
        “status”: “ACTIVE”,
        “endedBy”: null,
        “endingAt”: null,
        “startingAt”: null,
        “republish”: false
    },…
    “description”: {…}
    “validation”: {
        “errors”: [],
        “warnings”: [],
        “validatedAt”: “2021-03-16T14:01:53.434Z”
    },
    “createdAt”: “2021-02-24T07:01:55Z”,
    “updatedAt”: “2021-03-16T14:01:53.793Z”,…
    “images”: [
        “https://a.allegroimg.com/original/119247/d50959f64c568b3cd1421c70f31e",
        “https://a.allegroimg.com/original/1112b4/d03b421247169a2835880cc39d88"
    ],
    “external”: null,
    “category”: {
        “id”: “257359”
    },
    “tax”: {
        “percentage”: null
    },
    “sizeTable”: null,
    “discounts”: {
        “wholesalePriceList”: null
    }
}

Jeśli chcesz sprawdzić, które z twoich ofert nie są powiązane z produktem, skorzystaj z GET /sale/offers?product.id.empty=true.

Więcej informacji o tym, jak zarządzać ofertą za pomocą metody PATCH, znajdziesz w poradniku.

Allegro Ceny - dodamy nowe obiekty i typy pól do obsługi zamówień

Allegro Ceny to program, który pomaga Sprzedającym zaoferować najlepsze ceny na rynku – bez ponoszenia żadnych dodatkowych kosztów.

W związku z tym programem 31 marca 2021 wprowadzimy zmiany w:

• GET /order/checkout-forms,
• GET /order/checkout-forms/{id},
• GET /billing/billing-entries,

dzięki którym prawidłowo rozpoznasz i obsłużysz zamówienie, w których kupujący dokonał zakupu w ofercie, która jest w programie Allegro Ceny.

Dla GET /order/checkout-forms oraz GET /order/checkout-forms/{id} wprowadzimy nowe obiekty:

• payment.reconciliation - suma płatności, którą Allegro pokrywa i przekaże wraz z płatnością klienta w ramach programu Allegro Ceny,
• lineItems[].reconciliation - gdzie w obiekcie value zwrócimy kwotę o którą została pomniejszona cena przedmiotu i której koszty wyrówna Allegro w ramach płatności kupującego lub wpisu bilingowego.

W obiekcie lineItems[].reconciliation zwrócimy także pole type, w którym pobierzesz jedną z dwóch możliwych wartości:

• “BILLING” - wyrównanie wartości obniżki w postaci zapisu bilingowego,
• “WALLET” - wyrównanie wartości obniżki w postaci środków dodanych do płatności od kupującego.

W przypadku takich zamówień zwrócimy także w polu discounts nowy typ zniżki: “ALLEGRO_PRICES”.

Przykładowy request:

curl -X GET 

  ‘https://api.allegro.pl/order/checkout-forms/4fceac60-71c6-11eb-bb0e-5f505b61d1dc’ 

  -H ‘Authorization: Bearer {token}’  

  -H ‘Accept: application/vnd.allegro.public.v1+json’

Przykładowy response:

 {
  …
    “payment”: {
        “id”: “677d4ba1-71c6-11eb-a259-c766517115fd”,
        “type”: “ONLINE”,
        “provider”: “PAYU”,
        “finishedAt”: “2021-03-15T12:18:33.434Z”,
        “paidAmount”: {
            “amount”: “80”,                 – suma płatności, którą zapłacił
                                            kupujący
            “currency”: “PLN”
        },
        “reconciliation”: {
            “amount”: “0”,                  – kwota, którą wyrównamy w płatności
                                            (dodamy do płatności kupującego).
                                            Wystąpi tylko w przypadku
                                            wyrównania typu “WALLET”

            “currency”: “PLN”
        }
    },
    “status”: “READY_FOR_PROCESSING”,

    …
    “lineItems”: [
        {
            “id”: “ffc36fa0-9584-11e8-8d53-07c966f77738”,
            “offer”: {
                “id”: “6205584023”,
                “name”: “Koło ratunkowe”,
                “external”: {
                “id”: “ext_2018_08_17”
              }
            },
            “quantity”: 1,
            “originalPrice”: {

                “amount”: “80.00”,
                “currency”: “PLN”
            },
            “price”: {
                “amount”: “80.00”,

                “currency”: “PLN”
            },
            “reconciliation”: {
                “value”: {

                “amount”: “20.00”,          – kwota, którą wyrównuje Allegro za
                                            pojedynczy przedmiot
                “currency”: “PLN”
                },
            “quantity”: 1,                  – liczba przedmiotów, do których
                                            przyznaliśmy wyrównanie
            “type”: “BILLING”               – typ wyrównania, przyjmuje jedną z wartości:
                                            BILLING (wyrównanie w ramach zapisu bilingowego);
                                            WALLET (wyrównanie w ramach wpłaty).
            },
            “selectedAdditionalServices”: [ ],
            “boughtAt”: “2021-03-15T12:18:33.434Z”
        }
    ],
    “surcharges”: [],
    “discounts”: [
                {
                “type”: “ALLEGRO_PRICES”    – typ obniżki ALLEGRO_PRICES oznacza,
                                            że w ramach zamówienia obniżyliśmy cenę
                                            przyznaliśmy wyrównanie
                }

    ],
    “summary”: {
        “totalToPay”: {
            “amount”: “80.00”,

            “currency”: “PLN”
        }
    },
 “updatedAt”: “2021-03-15T12:18:33.434Z”,
 “revision”: “dc0f896f”

}

Ważne! W przypadku prawidłowej płatności (w której nie wystąpiła nadpłata lub niedopłata) kwota w polu payment.paidAmount oraz summary.totalToPay powinna być identyczna - niezależnie od tego, czy zamówienie zostało objęte programem Allegro Ceny.

W GET /billing/billing-entries zwrócimy nowy typ operacji billingowej: “PS1”. Otrzymasz go, gdy kupujący dokona zakupu w ofercie będącej w programie Allegro Ceny, a w zamówieniu zwróciliśmy w polu lineItems[].reconciliation.type wartość: “BILLING”.

Więcej informacji o szczegółach programu Allegro Ceny przeczytasz na stronie dla sprzedających. Więcej informacji o zmianie znajdziesz w naszym poradniku.

Zmieniliśmy regulamin REST API

Zgodnie z wcześniejszą zapowiedzią zmieniliśmy dzisiaj regulamin REST API Allegro.

W związku z tym, wszystkim nowym aplikacjom, które jeszcze nie korzystają z REST API Allegro zasób
GET /offers/listing udostępnimy dopiero po pozytywnej weryfikacji. Pozostałe aplikacje mają czas na weryfikację do 1 czerwca 2021.

Ważne! Aby przejść proces weryfikacji skontaktuj się z nami przez formularz lub ze swoim opiekunem, jeśli jesteś w Programie Partnerskim dla Sprzedających.

Od 15 marca 2021 do zarejestrowania aplikacji konieczna jest pełna aktywacja konta i włączone dwustopniowe logowanie.

Przypominamy również, że od 1 czerwca 2021 zmienimy zakres danych, jakie zwracamy dla GET /offers/listing. Dla tej zmiany ustaliliśmy zakresy, jakie będą zwracane dla popularności.

1 kwietnia zwiększymy wymóg % ofert połączonych z Katalogiem produktów Allegro

W 2019 roku wprowadziliśmy Katalog produktów Allegro w wybranych kategoriach serwisu. W ramach Katalogu produktów Allegro chcemy zebrać i opisać wszystkie produkty, jakie są dostępne w ofertach wystawianych przez wszystkich sprzedawców. Katalogujemy pojedyncze produkty jako reprezentatywne, które odróżniają się od innych swoimi właściwościami, np. modelem, kodem producenta, numerem GTIN, czy innymi parametrami podstawowymi.

1 kwietnia 2021 zwiększymy wymóg ofert połączonych z Katalogiem produktów w poniższych kategoriach:

* W pozostałych kategoriach obowiązuje już 10%. Ze względu na specyfikę niektórych kategorii, nie we wszystkich możemy wprowadzić wymóg procenta ofert powiązanych z Katalogiem. Sprawdź szczegółową listę kategorii, w których wprowadzimy wymóg.

30 czerwca 2021 roku planujemy zwiększyć wymóg % ofert połączonych z Katalogiem produktów do 50% wybranych kategoriach, natomiast do końca 2021 roku chcemy skatalogować wszystkie oferty w kategoriach, w których jest to możliwe.

Ważne! Jeżeli sprzedawca nie spełni tego wymagania, to będzie mógł wystawić nową, podobną lub wznowić zakończoną ofertę, tylko jeśli wskaże produkt dostępny w Katalogu lub doda nowy produkt na podstawie swojej oferty.

Więcej o tym, jak skatalogować ofertę, przeczytasz w naszym poradniku. Zapoznaj się także z zasobem /sale/product-offers, dzięki któremu za pomocą jednego żądania POST wystawisz aktywną ofertę powiązaną z produktem:

• który istnieje już w naszej bazie. Wystarczy, że w żądaniu przekażesz numer EAN (lub identyfikator produktu) oraz cenę i liczbę sztuk;
• którego nie ma w naszej bazie. W strukturze żądania za pomocą kompletu danych opiszesz sprzedawany produkt oraz przekażesz informacje o cenie i liczbie sztuk.

Aby sprawdzić, które z ofert nie są powiązane z produktem, skorzystaj z GET /sale/offers i parametru product.id.empty=true.

Więcej informacji na temat tej zmiany znajdziesz na stronie dla sprzedających.

Nowe typy załączników w ofercie

Od teraz, gdy skorzystasz z POST /sale/offer-attachments, możesz dodać dwa nowe typy załączników:

• “ENERGY_LABEL” - etykietę energetyczną,
• “PRODUCT_INFORMATION_SHEET” - kartę produktu.

Więcej informacji na temat dodawania załączników do oferty znajdziesz w naszym poradniku.

GET /offers/listing - tylko dla zweryfikowanych aplikacji

Zgodnie ze zmianą, o której więcej możecie przeczytać na stronie dla sprzedających, ograniczamy dostęp do publicznych danych o sprzedaży innych użytkowników. W związku z tym, GET /offers/listing będziemy udostępniać tylko zweryfikowanym aplikacjom z uwzględnieniem poniższych informacji:

• dzisiaj tj. 1.03.2021 zapowiedzieliśmy zmiany w regulaminie REST API Allegro
• 15.03.2021 z chwilą wejścia w życie nowego regulaminu REST API Allegro - GET /offers/listing:
• nie będzie dostępny dla nowych aplikacji - aby przejść proces weryfikacji skontaktuj się z nami przez formularz lub ze swoim opiekunem jeśli jesteś w Programie Partnerskim dla Sprzedających,
• aplikacje zarejestrowane do dnia 15.03.2021 mają czas na weryfikację do 1.06.2021 - aby przejść proces weryfikacji skontaktuj się z nami przez formularz lub ze swoim opiekunem jeśli jesteś w Programie Partnerskim dla Sprzedających.
• od 1.06.2021 GET /offers/listing będzie dostępny tylko dla zweryfikowanych aplikacji. Dodatkowo wprowadzimy zmiany w zakresie danych, jakie zwracamy:
• popularność - zamiast liczby sprzedanych przedmiotów będą dostępne tylko zakresy - więcej informacji na ich temat podamy w oddzielnym komunikacie,
• sortowanie po popularności nie będzie możliwe,
• wyszukiwanie zostanie ograniczone do 10 stron (maksymalna wartość parametru offset to 600).

Od 15.03.2021 rejestracja aplikacji będzie możliwa tylko dla aktywnych kont z włączonym dwustopniowym logowaniem.

Aby ułatwić testowanie i rejestrację aplikacji na środowisku testowym:

• GET /offers/listing będzie dostępny bez weryfikacji dla wszystkich aplikacji,
• dwustopniowe logowanie nie będzie wymagane.

Wysyłam z Allegro - dodaliśmy pole “type” na poziomie sekcji “items” oraz zmieniliśmy jego wymagalność

Od dziś, gdy tworzysz przesyłki za pomocą PUT /parcel-management/parcel-create-commands/{commandId}, możesz także utworzyć tzw. wielopaczkę, np. składającą się ze zwykłej paczki i palety. W związku z tą zmianą dodaliśmy pole “type” także na poziomie sekcji “items”, dzięki czemu możesz określić rodzaj paczki dla każdej przesyłki z osobna. Zmieniliśmy również wymagalność pól:

• “type” jest wymagane tylko na jednym z poziomów (głównym lub w “items”),
• jeśli pola “type” są uzupełnione na dwóch poziomach, sprawdzimy czy wszystkie pola “type” na poziomie “items” mają taką samą wartość jak pole “type” na głównym poziomie. Jeśli nie, zwrócimy błąd.

Opcja jest dostępna tylko u wybranych przewoźników, poniżej znajdziesz maksymalną liczbę paczek dla każdego z nich:

• 10 - DHL (oprócz palet), DPD (oprócz kopert), GLS, INPOST_KURIER, UPS (umowa własna), FEDEX,
• 5 - DHL (paleta),
• 1 - pozostali przewoźnicy

Więcej informacji znajdziesz w naszym poradniku.

Ustawiamy trwale wartość null w polu “ean” i obiekcie “eans”

Zgodnie z wcześniejszą zapowiedzią, od dzisiaj trwale ustawiamy wartość null w:

• polu “ean” w POST /sale/offers i PUT /sale/offers/{offerId},
• obiekcie “eans” w POST /sale/product-proposals,

i nie możesz jej już zmienić.

Od 29 marca 2021 całkowicie usuniemy pole “ean” z modelu oferty oraz obiekt “eans” z modelu produktu.

Skorzystaj z parametru globalny numer jednostki handlowej tzw. GTIN, aby uzupełnić EAN, ISBN i ISSN.

Jak oceniasz API Allegro?

Wypełnij ankietę na temat naszego API oraz strony Allegro API. Uzyskane odpowiedzi pozwolą nam dowiedzieć się, jakie są twoje potrzeby i wskazać kierunek dalszego rozwoju.

Ankieta nie zajmie ci więcej niż kilka minut. Aby ją wypełnić - kliknij tu.

GET /parcel-management/delivery-services - nowe pole “carrierId”

Dzisiaj dla GET /parcel-management/delivery-services udostępniliśmy nowe pole “carrierId”, w którym zwracamy informację o identyfikatorze przewoźnika, który świadczy daną usługę dostawy. Wartości pola “carrierId” są zgodne z wartościami dostępnymi dla zasobu GET /order/carriers.

Przykładowy request:

curl -X GET 

  ‘https://api.allegro.pl/parcel-management/delivery-services’ 

  -H ‘Authorization: Bearer {token}’  

  -H ‘Accept: application/vnd.allegro.public.v1+json’

Przykładowy response:

{
    “deliveryServices”: [
         {
           “id”: 12345,
           “service”: “INPOST_KURIER”,
           “name”: “InPost”,
           “carrierId”: “INPOST”,                - identyfikator przewoźnika
           “additionalServices”: {
               “cashOnDelivery”: {
                   “available”: true,
                   “expressAvailable”: true
                },
               “options”: [
                   {
                       “name”: “guarantee1200”,
                       “description”: “Delivery up to 12:00.”
                   }
               ]
            },
           “owner”: “ALLEGRO”
         }
     ]
}

Więcej informacji o tym jak zarządzać przesyłkami przez Wysyłam z Allegro znajdziesz w naszym poradniku.

Rabaty transakcyjne (zwroty prowizji) - dodaliśmy informację o rodzaju wniosku

Od 10 lutego 2021 sprzedawca może w pewnych sytuacjach otrzymać rabat transakcyjny (zwrot prowizji od sprzedaży) w pełni automatycznie, bez konieczności składania wniosku. Na stronie dla sprzedających znajdziesz informacje, jakie warunki muszą w tym celu zostać spełnione.

W związku z tym udostępniliśmy dziś nowe pole “type” w odpowiedzi dla:

• GET /order/refund-claims/{claimId},
• GET /order/refund-claims.

Informujemy w nim o rodzaju wniosku o rabat transakcyjny:

• “MANUAL” - sprzedawca ręcznie złożył wniosek,
• “AUTOMATIC” - wniosek został złożony automatycznie.

Więcej informacji o obsłudze rabatów transakcyjnych w API znajdziesz w naszym poradniku.

Produktyzacja - usunęliśmy pole productEANRequired w zasobach do pobierania informacji o kategoriach

Zgodnie z wcześniejszą zapowiedzią usunęliśmy dziś pole options.productEANRequired w odpowiedzi dla:

• GET /sale/categories,
• GET /sale/categories/{categoryId}.

Zwracaliśmy w nim informację, czy w danej kategorii musisz przekazać parametr GTIN, gdy tworzysz propozycję nowego produktu.

Od teraz korzystaj z pola requiredForProduct dla parametru GTIN, który otrzymasz w odpowiedzi dla GET /sale/categories/{categoryId}/parameters. Parametr GTIN w zależności od kategorii to:

• EAN (ID 225693),
• ISBN (ID 245669),
• ISSN (ID 245673).

Autoryzacja - wydłużyliśmy ważność refresh tokenów do 60 sekund po pierwszym użyciu

Refresh tokeny były do tej pory jednorazowego użytku - w momencie wygenerowania nowej pary (access i refresh token) stare tokeny od razu traciły ważność. Wydłużyliśmy żywotność refresh tokenów do 60 sekund od momentu odświeżenia. Chcemy w ten sposób rozwiązać problem utraconych refresh tokenów na skutek przerwanego połączenia. W takiej sytuacji jedynym rozwiązaniem było ponowne przejście całego procesu autoryzacji użytkownika w celu wygenerowania tokena dostępu i refresh tokena. Obecnie nie jest to konieczne, możesz ponowić próbę odświeżenia tokena za pomocą tego samego refresh tokena.

Ignorujemy wartość, którą przesyłasz w polu “ean” i obiekcie “eans”

Zgodnie z wcześniejszą zapowiedzią, od dzisiaj ignorujemy i nie walidujemy już:

• pola “ean” w POST /sale/offers i PUT /sale/offers/{offerId},
• obiektu “eans” w POST /sale/product-proposals.

Jednocześnie przypominamy, że od 1 marca 2021 wartość w tych obiektach ustawimy trwale jako null - jej zmiana nie będzie możliwa.

29 marca 2021 całkowicie usuniemy pole “ean” z modelu oferty oraz obiekt “eans” z modelu produktu.

Skorzystaj z parametru globalny numer jednostki handlowej tzw. GTIN, aby uzupełnić EAN, ISBN i ISSN.

Dodaj fakturę do zamówienia

Już w lutym 2021, wraz ze startem Allegro Biznes, udostępnimy nowe zasoby, dzięki którym dodasz i pobierzesz fakturę do zamówienia:

• POST /order/checkout-forms/{id}/invoices - utwórz obiekt faktury.

  Przykładowy request:

  curl -X POST 
  
  ‘https://api.allegro.pl/order/checkout-forms/a8320af2-5f01-11eb-bbeb-112e13b418c5/invoices' 
  
  -H ‘Accept: application/vnd.allegro.public.v1+json’ 
  
  -H ‘Content-Type: application/vnd.allegro.public.v1+json’ \
  
  -H ‘Authorization: Bearer {token}’ 
  
  -d ‘{
    “file”: {
       “name”: “faktura.pdf”              - wymagane, nazwa pliku
    },
    “invoiceNumber”: “FV 01/2020”         - niewymagane, nr faktury
  }’

  Przykładowy response:

  {
    “id”: “56ae349d-8045-4bb3-adcc-7cf6fb420f61”     - identyfikator faktury
  }

• PUT /order/checkout-forms/{id}/invoices/{invoiceId}/file - prześlij plik *.pdf z fakturą. Jako “invoice.id” przekaż wartość id, którą otrzymałeś w odpowiedzi dla metody POST. Możesz dodać jedną fakturę w formacie *.pdf do każdego zamówienia. Rozmiar pliku nie może przekroczyć 2 MB.

  Przykładowy request:

  curl -X PUT 
  
  ‘https://api.allegro.pl/order/checkout-forms/a8320af2-5f01-11eb-bbeb-112e13b418c5/invoices/56ae349d-8045-4bb3-adcc-7cf6fb420f61/file' 
  
  -H ‘Accept: application/vnd.allegro.public.v1+json’ 
  
  -H ‘Content-Type: application/pdf’ 
  
  -H ‘Authorization: Bearer {token}’ 
  
  -d ‘data=@faktura.pdf’
  

• GET /order/checkout-forms/{id}/invoices - pobierz faktury przypisane do zamówienia.

  Przykładowy request:

  curl -X GET 
  
  ‘https://api.allegro.pl/order/checkout-forms/a8320af2-5f01-11eb-bbeb-112e13b418c5/invoices' 
  
  -H ‘Accept: application/vnd.allegro.public.v1+json’ 
  
  -H ‘Authorization: Bearer {token}’
  

  Przykładowy response:

  {
   “invoices”: [
      {
       “id”: “56ae349d-8045-4bb3-adcc-7cf6fb420f61”,        - identyfikator faktury
       “invoiceNumber”: “FV 01/2020”,                       - nr faktury
       “createdAt”: “2021-01-07T15:50:00.000Z”,             - data dodania faktury
       “file”: {
           “name”: “faktura.pdf”,                           - nazwa pliku
           “uploadedAt”: “2021-01-07T15:50:00.000Z”,        - data dodania pliku
           “securityVerification”: {
  
               “status”: “ACCEPTED”,                        - status weryfikacji antywirusowej pliku,
                                                            dostępne wartości: WAITING, ACCEPTED, REJECTED.
               “verifiedAt”: “2021-01-07T15:51:00.000Z”     - data weryfikacji
           }
       },
       “eptVerification”: {                                 - obiekt przyjmuje
                                                            wartość null dla metod płatności
                                                            innych niż płatność odroczona
           “status”: “ACCEPTED”,                            - status weryfikacji faktury dla
                                                            płatności odroczonej, dostępne
                                                            wartości: WAITING, ACCEPTED, REJECTED.
           “verifiedAt”: “2021-01-07T15:58:00.000Z”,        - data weryfikacji
           “reason”: null                                   - powód odrzucenia faktury, jeśli
                                                            status weryfikacji to REJECTED.
       }
      }
   ]
  }
  
  

Produktyzacja - w danych produktów dodaliśmy nowe kategorie, w których możesz wystawić ofertę połączoną z Katalogiem produktów.

Od dziś, w przypadku gdy produkt pasuje do wielu podobnych do siebie kategorii, możesz wystawić ofertę powiązaną z tym produktem w innej, zdefiniowanej przez nas podobnej kategorii.

W odpowiedzi na GET ​/sale​/products​/{productId} zwrócimy nową listę:

• category.similar

w której wskazujemy id kategorii podobnych. Skorzystaj z wybranego identyfikatora, aby wystawić ofertę sprzedaży produktu w jednej ze zwróconych kategorii.

Przykładowy request:

curl -X GET 

‘https://api.allegro.pl/sale/products/b2b61e23-b580-4471-b653-6ed25fd179f7’ 

-H ‘Authorization: Bearer {token}’ 

-H ‘accept: application/vnd.allegro.public.v1+json’

Przykładowy response:

{
    “id”: “b2b61e23-b580-4471-b653-6ed25fd179f7”,
    “name”: “BIO Pochodnia”,
    “category”: {
        “id”: “261573”,
        “similar”: [
            {
                “id”: “110914”
            },
            {
                “id”: “305121”
            }
        ]
    }
…
}

Ważne! Zbiory kategorii podobnych są definiowane przez nas - zwracamy je w odpowiedzi na GET ​/sale​/products​/{productId} - nie możesz tworzyć ich samodzielnie. Zbiór kategorii podobnych jest aktualnie ograniczony, jednak będziemy go systematycznie rozszerzać.

• Jak jednym requestem wystawić ofertę powiązaną z produktem,
• Jak powiązać ofertę z produktem.

Obsługa zamówień z odroczoną płatnością dla firm

Już w lutym 2021, wraz ze startem Allegro Biznes, udostępnimy nową metodę płatności dla transakcji pomiędzy firmami (B2B) - Odroczona płatność dla Firm. Sprzedający, który chce udostępnić odroczoną płatność w swoich ofertach, musi mieć konto firmowe oraz spełnić warunki opisane w Pomocy Allegro.

W związku z wprowadzeniem odroczonej płatności dla zamówienia w statusie “READY_FOR_PROCESSING” w:

• GET /order/checkout-forms/{id} w obiekcie payment:
  • udostępnimy nowy typ płatności - “type”: “EXTENDED_TERM”,
  • udostępnimy nowego operatora płatności - “provider”: “EPT”,
  • pola “finishedAt” oraz “paidAmount” przyjmą wartość null do momentu faktycznego przekazania środków przez dostawcę usługi (aby przelew został zrealizowany, sprzedający musi wystawić fakturę VAT oraz dodać numer przesyłki do zamówienia).

  Przykładowy widok obiektu payment dla zamówień z odroczoną płatnością przed otrzymaniem płatności:

  “payment”: {
      “id”: “b83c6ea0-3ed0-11eb-a57e-ebbabb38ee2a”,
      “type”: “EXTENDED_TERM”,
      “provider”: “EPT”,
      “finishedAt”: null,
      “paidAmount”: null
  }
  

  Gdy wpłata trafi na konto sprzedającego pola “finishedAt” oraz “paidAmount” uzupełnimy wartościami:

  “payment”: {
      “id”: “b83c6ea0-3ed0-11eb-a57e-ebbabb38ee2a”,
      “type”: “EXTENDED_TERM”,
      “provider”: “EPT”,
      “finishedAt”: “2021-01-18T13:18:04.546Z”,
      “paidAmount”: {
          “amount”: “1150.00”,
          “currency”: “PLN”
      }
  }
  

  Ważne! Jeżeli kupujący wybierze odroczoną płatność jako metodę płatności, to tym samym nie będzie mógł już jej anulować i ponownie wypełnić formularza pozakupowego.

• GET /order/events zwrócimy dla tego zamówienia drugie zdarzenie “READY_FOR_PROCESSING” w momencie przekazania środków przez dostawcę - pole “occurredAt” otrzyma jako wartość datę tej operacji (dzięki temu rozpoznasz, że nie jest to duplikat zdarzenia).

Więcej informacji o odroczonej płatności dla firm znajdziesz w Pomocy Allegro.

GET /sale/badges - nowy obiekt “prices.subsidy”

Dzisiaj dla GET /sale/badges udostępniliśmy nowy obiekt “prices.subsidy”, w którym zwracamy informacje o:

• sellerPrice - kwota oczekiwana przez partnera z tytułu sprzedaży produktu,
• targetPrice - cena widoczna dla klienta na platformie.

Różnicę między kwotą zapłaconą przez klienta (targetPrice), a kwotą oczekiwaną przez partnera (sellerPrice) pokryjemy w ramach programu Allegro Ceny, którego szczegóły znajdziesz na stronie dla sprzedających.

curl -X GET 

‘https://api.allegro.pl/sale/badges’ 

-H ‘Authorization: Bearer {token}’ 

-H ‘Content-Type: application/vnd.allegro.beta.v1+json’

{
 “badges”: [
   {
     “offer”: {
       “id”: “10026815226”
     },
     “campaign”: {
       “id”: “SUBSIDY”,
       “name”: “Allegro Cena”
     },
     “publication”: {
       “type”: “SINCE”,
       “from”: “2021-01-19T11:31:56.131Z”,
       “to”: null
     },
     “prices”: {
       “market”: null,
       “subsidy”: {
         “sellerPrice”: {              – kwota, która jest oczekiwana przez partnera z tytułu
                                       sprzedaży produktu. Różnicę między kwotą zapłaconą przez
                                       klienta (targetPrice), a kwotą oczekiwaną przez partnera
                                       (sellerPrice) pokryjemy w ramach programu Allegro Ceny.
           “amount”: “100.00”,
           “currency”: “PLN”
         },
         “targetPrice”: {              – cena widoczna dla klienta na platformie
           “amount”: “90.00”,
           “currency”: “PLN”
         }
       }
     },
     “process”: {
       “status”: “ACTIVE”,
       “rejectionReasons”: []
     }
   }
 ]
}
                      

Od 15 lutego będziemy wymagać 10% ofert połączonych z Katalogiem produktów Allegro w działach Zdrowie, Elektronika oraz Sport i turystyka

W 2019 roku wprowadziliśmy Katalog produktów Allegro w wybranych kategoriach serwisu. W ramach Katalogu produktów Allegro chcemy zebrać i opisać wszystkie produkty, jakie są dostępne w ofertach wystawianych przez wszystkich sprzedawców. Katalogujemy pojedyncze produkty jako reprezentatywne, które odróżniają się od innych swoimi właściwościami, np. modelem, kodem producenta, numerem GTIN, czy innymi parametrami podstawowymi.

15 lutego 2021 zwiększymy wymóg ofert połączonych z Katalogiem produktów z 1% do 10% w kategoriach:

• Zdrowie,
• Elektronika,
• Sport i Turystyka.

Planujemy do końca 2021 roku skatalogować wszystkie oferty tam, gdzie to możliwe. W tym celu od 1 września 2020 roku wprowadziliśmy wymóg % ofert połączonych z produktem w kolejnych działach. Już teraz wymagamy, aby 1% ofert był powiązany z Katalogiem produktów w kategoriach:

• Elektronika, Kultura i rozrywka oraz Uroda od 1 września 2020,
• Sport i turystyka, Dom i ogród, Zdrowie oraz Supermarket od 14 października 2020 roku.

Zapowiedzieliśmy również zmianę na 18 stycznia 2021, w ramach której:

• zwiększymy wymóg do 10% skatalogowanych ofert w Kulturze i rozrywce, Urodzie, Domu i ogrodzie oraz Supermarkecie,
• włączymy obowiązek 1% skatalogowanych ofert w kolejnych kategoriach działów Dziecko, Firma i usługi, Motoryzacja.

Chcemy umożliwić powiązanie ofert w jak największej liczbie kategorii Allegro, jednak specyfika sprzedawanych przedmiotów nie zawsze na to pozwala. Zapoznaj się z tym plikiem, aby sprawdzić, w jakich kategoriach działów Elektronika, Zdrowie oraz Sport i turystyka będziemy wymagać 10% ofert powiązanych z Katalogiem produktów Allegro.

Ważne! Jeżeli sprzedawca nie spełni tego wymagania, to będzie mógł wystawić nową, podobną lub wznowić zakończoną ofertę, jeśli wskaże produkt dostępny w Katalogu lub doda nowy produkt na podstawie swojej oferty.

Więcej o tym, jak skatalogować ofertę, przeczytasz w naszym poradniku. Zapoznaj się także z zasobem /sale/product-offers, dzięki któremu za pomocą jednego żądania POST wystawisz aktywną ofertę powiązaną z produktem:

• który istnieje już w naszej bazie. Wystarczy, że w żądaniu przekażesz numer EAN (lub identyfikator produktu) oraz cenę i liczbę sztuk;
• którego nie ma w naszej bazie. W strukturze żądania za pomocą kompletu danych opiszesz sprzedawany produkt oraz przekażesz informacje o cenie i liczbie sztuk.

Aby sprawdzić, które z ofert nie są powiązane z produktem, skorzystaj z GET /sale/offers i parametru product.id.empty=true.

Więcej informacji na temat tej zmiany znajdziesz na stronie dla sprzedających.

Zasoby /sale/product-offers - dodaliśmy obsługę nowych pól, które możesz przesłać w żądaniu: “publication.startingAt” i “discounts”

Dodaliśmy dziś obsługę dwóch atrybutów oferty, które możesz zadeklarować w strukturze żądania POST /sale/product-offers i PATCH /sale/product-offers/{offerId}:

• publication.startingAt - termin rozpoczęcia oferty, dzięki czemu zaplanujesz wystawienie oferty w przyszłości;
• discounts - informacje o zniżkach.

Więcej informacji o tym, jak przekazać pola w żądaniu, znajdziesz w naszym poradniku.

Nowa metoda dostawy - Kurier PickPack

Dzisiaj udostępniliśmy nową metodę dostawy dostępną obecnie na terenie Warszawy. Identyfikator nowej metody możesz uzyskać zasobem GET /sale/delivery-methods:

• Kurier PickPack - id: 41cc412c-ba9e-422d-9750-7918ea717539

Więcej informacji na ten temat znajdziesz tutaj.

Kategorie i parametry - dodaliśmy dziennik zmian w kategoriach oraz zasób, dzięki któremu sprawdzisz przyszłe zdarzenia na parametrach

Udostępniliśmy dziś dwa nowe zasoby, które pozwolą ci śledzić zmiany w kategoriach i parametrach na naszej platformie:

• GET /sale/category-events - sprawdź zmiany w kategoriach, które wydarzyły się w ostatnich 3 miesiącach. Domyślnie w odpowiedzi otrzymasz listę 100 najstarszych zdarzeń. Za pomocą parametru from i ID danego zdarzenia możesz pobrać kolejną porcję danych. Aktualnie zwracamy 4 rodzaje zdarzeń:
• CATEGORY_CREATED - utworzyliśmy nową kategorię;
• CATEGORY_RENAMED - zmieniliśmy nazwę kategorii;
• CATEGORY_MOVED - przenieśliśmy kategorię w inne miejsce w drzewie kategorii, zmieniliśmy tym samym wartość parent.id danej kategorii;
• CATEGORY_DELETED - usunęliśmy kategorię, nie jest już dostępna. W swoich żądaniach użyj category.id widoczne w polu redirectCategory.

Przykładowy request:

    curl -X GET
    ‘https://api.allegro.pl/sale/category-events’/
    -H ‘Authorization: Bearer {token}’ /
    -H ‘Accept: application/vnd.allegro.public.v1+json’
                      

Przykładowy response:

    {
    …
      {
        “id”: “MTEzMjQzODU3NA”,                     – ID zdarzenia
        “occurredAt”: “2021-01-12T15:26:43.891Z”,   – czas wystąpienia zdarzenia
        “type”: “CATEGORY_CREATED”,                 – typ zdarzenia
        “category”: {                               – dane kategorii, której dotyczy
                                                    zdarzenie
            “id”: “165”,                            – ID kategorii
            “name”: “Smartphones and Cell Phones”,  – nazwa kategorii
            “parent”: {
                “id”: “4”                           – ID kategorii nadrzędnej
                },
            “leaf”: false                           – czy dana kategoria jest kategorią
                                                    najniższego rzędu
                }
          }
    …
    }
                      

• GET /sale/category-parameters-scheduled-changes - sprawdź zmiany w parametrach, które zaplanowaliśmy na najbliższe 3 miesiące. Domyślnie w odpowiedzi otrzymasz listę 100 najwcześniej zaplanowanych zmian. Na tę chwilę zwracamy tylko jeden rodzaj zmiany - REQUIREMENT_CHANGE (dany parametr oznaczymy jako wymagany).
  

  Uwaga! W wyjątkowych sytuacjach możemy zdecydować, aby nie wdrażać wybranych zaplanowanych zmian - np. jeżeli zrezygnujemy z oznaczenia danego parametru jako obowiązkowy. W takiej sytuacji dane zdarzenie usuniemy z odpowiedzi.

  Możesz także wyfiltrować wyniki na podstawie daty, kiedy zaplanowaliśmy zmianę. Skorzystaj z poniższych filtrów, gdy chcesz sprawdzić, jakie zmiany zaplanowaliśmy w ostatnim czasie:

  • scheduledAt.gte - najwcześniejsza data, kiedy zaplanowaliśmy zmianę,
  • scheduledAt.lte - najpóźniejsza data, kiedy zaplanowaliśmy zmianę.

  np. żeby sprawdzić, jakie zmiany zaplanowaliśmy do dzisiaj, użyj żądania GET /sale/category-parameters-scheduled-changes?scheduledAt.lte=2021-01-13T23:59:59

  
  

  Jeżeli chcesz sprawdzić, które parametry oznaczymy jako obowiązkowe w najbliższym czasie, użyj filtrów:

  • scheduledFor.gte - najwcześniejsza data planowanego uobowiązkowienia,
  • scheduledFor.lte - najpóźniejsza data planowanego uobowiązkowienia, nie może być większa niż 3 miesiące od bieżącej daty.

  np. żeby sprawdzić, które parametry oznaczymy jako obowiązkowe do końca lutego 2021, musisz sformułować żądanie GET /sale/category-parameters-scheduled-changes?scheduledFor.lte=2021-02-28T23:59:59Z.

  
  Przykładowy request:

  
      curl -X GET
      ‘https://api.allegro.pl/sale/category-parameters-scheduled-changes’/
      -H ‘Authorization: Bearer {token}’ /
      -H ‘Accept: application/vnd.allegro.public.v1+json’
                        

  Przykładowy response:

  
      {
      …
       {
        “scheduledAt”: “2021-01-12T15:26:43.891Z”,    – data z przeszłości, kiedy
                                                      zaplanowaliśmy zmianę
        “scheduledFor”: “2021-02-14T15:26:43.891Z”,   – data z przyszłości, na kiedy
                                                      planujemy wdrożyć zmianę
        “type”: “REQUIREMENT_CHANGE”,                 – rodzaj zmiany
        “category”: {
            “id”: “165”                               – ID kategorii, w której znajduje się
                                                      parametr, którego dotyczy zmiana
            },
        “parameter”: {
            “id”: “11323”                             – ID parametru, którego dotyczy
                                                      zmiana
            }
        }
      …
      }
                        

Więcej informacji o nowych zasobach znajdziesz w naszym poradniku.

Produktyzacja - 15.02.2021 usuniemy pole productEANRequired w zasobach do pobierania informacji o kategoriach

15.02.2021 usuniemy pole options.productEANRequired w odpowiedzi dla:

• GET /sale/categories,
• GET /sale/categories/{categoryId}.

Zwracamy w nim informację, czy w danej kategorii musisz przekazać parametr GTIN, gdy tworzysz propozycję nowego produktu.

Od teraz korzystaj z pola requiredForProduct dla parametru GTIN, który otrzymasz w odpowiedzi dla GET /sale/categories/{categoryId}/parameters. Parametr GTIN w zależności od kategorii to:

• EAN (ID 225693),
• ISBN (ID 245669),
• ISSN (ID 245673).

Zwiększyliśmy limit dla zmiany ceny w aktywnej ofercie

Zwiększyliśmy dzisiaj limit dla jednorazowej zmiany ceny w ofercie.

Jeśli:

• cena w ofercie wynosi do 50 zł - sprzedawca może ją zwiększyć maksymalnie o 100 zł,
• cena w ofercie wynosi ponad 50 zł - sprzedawca może ją zwiększyć maksymalnie o kolejne 200%.

Ograniczenia dotyczą pojedynczej zmiany ceny Kup Teraz w aktywnych ofertach.

Usuwamy pole “ean” oraz obiekt ”eans”

Zgodnie z wcześniejszą zapowiedzią informujemy, że 29 marca 2021 usuniemy:

• pole “ean” - w modelu oferty,
• obiekt “eans” - w modelu produktu.

Proces usunięcia tych obiektów podzieliliśmy na 3 kroki.

1. 1 lutego 2021 wdrożymy zmianę, która spowoduje, że jeśli w swoim requeście prześlesz:
   • pole “ean” w POST /sale/offers i PUT /sale/offers/{offerId},
   • obiekt “eans” w POST /sale/product-proposals,

   zignorujemy je i nie będziemy go walidować.

   Gdy będziesz pobierać:

   • szczegóły oferty za pomocą GET /sale/offers/{offerId} - w polu “ean” zwrócimy wartość parametru GTIN (np. EAN/ISBN/ISSN), jeśli taki został podany w ofercie,
   • dane produktu za pomocą GET /sale/product/{productId} - w obiekcie “eans” zwrócimy wartość parametru GTIN (np. EAN/ISBN/ISSN), jeżeli taki został zdefiniowany w produkcie.
   
   
2. Od 1 marca 2021 wartość w:
• polu “ean” na GET /sale/offers/{offerId},
• obiekcie “eans” na GET /sale/product/{productId},

ustawimy trwale jako null - jej zmiana nie będzie możliwa.



3. 29 marca 2021 usuniemy pole “ean” z modelu oferty oraz obiekt “eans” z modelu produktu.

To spowoduje, że nie otrzymasz i nie prześlesz już:

• pola “ean” metodami GET/POST/PUT na zasobie /sale/offers,
• obiektu “eans” w na zasobach:
  • /sale/product-proposals,
  • /sale/product.

Przypominamy, że od 29.06.2020 udostępniliśmy parametr globalny numer jednostki handlowej tzw. GTIN. Wartość GTIN (czyli EAN, ISBN, ISSN) zmienisz tylko korzystając z parametru.

GET /sale/offers/unfilled-parameters - dodaliśmy nowy filtr

Za pomocą GET /sale/offers/unfilled-parameters sprawdzisz brakujące parametry w ofertach. Zgodnie z wcześniejszą zapowiedzią dodaliśmy dziś filtr parameterType, dzięki któremu sprecyzujesz, jaki typ parametrów chcesz otrzymasz w odpowiedzi:

• parameterType=REQUIRED - obecnie wymagane parametry,
• parameterType=REQUIREMENT_PLANNED - parametry, które w ciągu najbliższych 3 miesięcy oznaczymy jako wymagane.

Informację o nowym filtrze dodaliśmy także w naszym poradniku.

Wyłączamy mapowanie aktów zakupowych

Zgodnie z wcześniejszą zapowiedzią przypominamy, że od 12.01.2021 nie skorzystasz z mapowania numerów aktów zakupowych za pomocą GET /order/line-item-id-mappings.

Zasób może generować opóźnienia z uwagi na wzmożony ruch, dlatego zrezygnuj z niego możliwie najszybciej.

Scope w API Allegro na środowisku produkcyjnym

Zgodnie z wcześniejszą zapowiedzią przypominamy, że w dniu 11.01.2021 na środowisku produkcyjnym udostępnimy funkcjonalność tzw. scope’ów, czyli zakresów, które określają poziom uprawnień aplikacji do korzystania z API Allegro.

Aby ograniczyć dostęp aplikacji tylko do wybranych zasobów, podczas uzyskiwania autoryzacji musisz przekazać odpowiednie scope’y - każdy kolejny scope oddziel od siebie spacją (“%20”). Listę dostępnych scope’ów znajdziesz tu.

Od 11.01.2021 na środowisku produkcyjnym uzyskasz dostęp tylko do zasobów, których scope’y przekażesz w żądaniu. Jeśli na liście scope’ów w tokenie nie znajdzie się wymagany scope, to twoje zapytanie zostanie odrzucone z kodem błędu 403. Jeżeli nie podejmiesz żadnych kroków, to twoja aplikacja będzie za każdym razem autoryzować się z pełną listą scope’ów.

Dzięki wdrożeniu obsługi scope’ów zapewnisz wzrost bezpieczeństwa użytkowników, którzy korzystają z API Allegro oraz aplikacjom, które używają naszego API.

Więcej informacji o scope’ach znajdziesz w naszym poradniku.

Sandbox - 5 stycznia 2021 zaktualizujemy listę kategorii i parametrów oraz usuniemy wszystkie oferty

5 stycznia 2021 przeprowadzimy kolejną aktualizację listy kategorii i parametrów na Sandboxie. Dzięki temu zadbamy o spójność między środowiskiem testowym i produkcyjnym.

Ważne! W związku z aktualizacją usuniemy wszystkie oferty z Sandboxa.

Od 18 stycznia 2021 wprowadzamy nowe wymogi dotyczące % ofert powiązanych z produktem

W 2019 roku wprowadziliśmy Katalog produktów Allegro w wybranych kategoriach serwisu. W ramach Katalogu produktów Allegro chcemy zebrać i opisać wszystkie produkty, jakie są dostępne w ofertach wystawianych przez wszystkich sprzedawców. Katalogujemy pojedyncze produkty jako reprezentatywne, które odróżniają się od innych swoimi właściwościami, np. modelem, kodem producenta, numerem GTIN, czy innymi parametrami podstawowymi.

Planujemy do końca 2021 roku skatalogować wszystkie oferty tam, gdzie to możliwe. W tym celu od 1 września 2020 roku wprowadziliśmy wymóg % ofert połączonych z produktem w kolejnych działach. Już teraz wymagamy, aby 1% ofert był powiązany z produktami w kategoriach:

• Elektronika,
• Kultura i rozrywka,
• Uroda,
• Sport i turystyka,
• Dom i ogród,
• Zdrowie,
• Supermarket.

W części powyższych kategorii sprzedawca nie musi wiązać oferty z produktem - ich listę znajdziesz w tym pliku.

Od 18 stycznia 2021 roku:

• Będziemy wymagać 1% ofert połączonych z produktem w wybranych kategoriach działów:
  • Dziecko,
  • Firma i usługi,
  • Motoryzacja.
• Zwiększymy wymóg do 10% skatalogowanych ofert w kilku działach, gdzie wcześniej wymagaliśmy 1%, tj:
  • Kultura i rozrywka,
  • Supermarket,
  • Dom i ogród,
  • Uroda.

Chcemy umożliwić powiązanie ofert w jak największej liczbie kategorii Allegro, jednak specyfika sprzedawanych przedmiotów nie zawsze na to pozwala. Zapoznaj się z tym plikiem, aby sprawdzić, w jakich kategoriach działu Dziecko, Firma i usługi oraz Motoryzacja włączymy obowiązek 1% ofert połączonych z Katalogiem produktów Allegro.

Ważne! Jeżeli sprzedawca nie spełni tego wymagania, to będzie mógł wystawić nową, podobną lub wznowić zakończoną ofertę, jeśli wskaże produkt dostępny w Katalogu lub doda nowy produkt na podstawie swojej oferty.

Więcej o tym, jak powiązać ofertę z produktem, przeczytasz w naszym poradniku. Zapoznaj się także z zasobem /sale/product-offers, dzięki któremu za pomocą jednego żądania POST wystawisz aktywną ofertę powiązaną z produktem:

• który istnieje już w naszej bazie. Wystarczy, że w żądaniu przekażesz numer EAN (lub identyfikator produktu) oraz cenę i liczbę sztuk;
• którego nie ma w naszej bazie. W strukturze żądania za pomocą kompletu danych opiszesz sprzedawany produkt oraz przekażesz informacje o cenie i liczbie sztuk.

Aby sprawdzić, które z ofert nie są powiązane z produktem, skorzystaj z GET /sale/offers i parametru product.id.empty=true.

Więcej informacji na temat tej zmiany znajdziesz na stronie dla sprzedających.

Nowe metody dostawy

Dzisiaj udostępniliśmy dwie nowe metody dostawy związane z odbiorem zużytego akumulatora. Identyfikatory nowych metod możesz uzyskać zasobem GET /sale/delivery-methods:

• X-press Couriers (z odbiorem zużytego akumulatora) - id: 2a8cb7bf-a31b-45c3-b45e-7918ea717539
• X-press Couriers (z odbiorem zużytego akumulatora) pobranie - id: 3d7c74e7-4d1b-4800-95a2-7918ea717539

Więcej informacji na ten temat znajdziesz tutaj.

Usuwamy aktualny zasób do sprawdzania przyszłych uobowiązkowień parametrów i wkrótce zastąpimy go nowym

Usunęliśmy dzisiaj zasób /sale/categories/parameters/required-changes, dzięki któremu mogliście sprawdzić przyszłe uobowiązkowienia w parametrach. Zdecydowaliśmy się na taki krok, ponieważ chcemy, aby był spójny z istniejącymi dziennikami. W najbliższym czasie udostępnimy nowy zasób, o czym poinformujemy w osobnym komunikacie.

Przekazuj poprawnie nagłówek Authorization

12.01.2021 wprowadzimy dodatkową walidację nagłówka Authorization. Jeżeli w swoich żądaniach:

• nie wstawiasz spacji między “Bearer” a tokenem, np. Authorization: Bearer{token},
• po ‘Authorization’ przekazujesz więcej niż jedną wartość, np. Authorization: Bearer mF_9.B6f-4.1JqM, Basic YXNkZnNhdGZzYWzmOlZLdDVOMVhx,
• przesyłasz więcej niż jeden nagłówek Authorization,

w odpowiedzi zwrócimy kod 401 Unauthorized.

Upewnij się, że w swojej aplikacji prawidłowo przekazujesz ten nagłówek.

PATCH /sale/product-offers/{offer-id} - aktualizujemy tecdocSpecification i compatibilityList

Od dziś, gdy skorzystasz z PATCH /sale/product-offers/{offer-id}, automatycznie zaktualizujemy w ofercie pola tecdocSpecification i compatibilityList, zgodnie z danymi występującymi w powiązanym produkcie.

Zmianę wprowadzamy po to, aby dane prezentowane w ofercie były najbardziej aktualne, a samo aktualizowanie oferty było możliwe najprostsze.

Jest to także pierwszy krok do zapowiadanej przez nas automatycznej aktualizacji danych w ofercie powiązanej z produktem. Dążymy do tego, że gdy zaktualizujemy dane produktu w katalogu, nie będzie konieczne kopiowanie czy akceptowanie zmian w ofercie, jeśli nie przekażesz własnych wartości.

Więcej o PATCH /sale/product-offers/{offer-id} przeczytasz w naszym poradniku.

Zmieniamy maksymalną długość parametru GTIN

18 stycznia 2021 roku zmienimy maksymalną długość parametrów GTIN z dotychczasowych 18 na 14 znaków.

W zależności od kategorii, zmiana będzie dotyczyć parametrów:

• EAN (id parametru=225693),
• ISBN (id parametru=245669),
• ISSN (id parametru=245673).

Gdy skorzystasz z GET /sale/categories/{categoryId}/parameters i GET /sale/categories/{categoryId}/product-parameters, dla każdego z parametrów GTIN zwrócimy inną niż dotychczas informację w polu restrictions.maxLength:

      {
      …
                  “restrictions”: {
                      “minLength”: 8,
                      “maxLength”: 14,
      …
                  }
      …
      }
              

Dzięki tej zmianie uspójnimy maksymalną i rzeczywiście walidowaną przez nas długość parametru GTIN. Dopuszczalna długość GTIN to 8, 10, 12, 13 lub 14 znaków.

Zasoby /sale/product-offers - 12 grudnia 2020 wyłączymy wersję beta.v1

Zgodnie z wcześniejszą zapowiedzią przypominamy, że od 12 grudnia 2020 przestaniemy wspierać wersję beta.v1 zasobów:

• POST /sale/product-offers,
• PATCH /sale/product-offers/{offerId}.

Od 12 listopada 2020 możesz skorzystać z wersji beta.v2 tych zasobów. Wystarczy, że przekażesz w nagłówkach Content-Type oraz Accept wartość “application/vnd.allegro.beta.v2+json”.

W wersji beta.v2 wdrożyliśmy wzorzec asynchronicznego API - upewnij się, czy dobrze go obsługujesz. Więcej informacji o sposobie działania zasobów /sale/product-offers w nowej wersji znajdziesz w naszym poradniku:

• publikacja oferty w asynchronicznym API,
• edycja oferty w asynchronicznym API.

GET /order/line-item-id-mappings - wyłączamy mapowanie aktów zakupowych

Od 12.01.2021 nie skorzystasz z mapowania numerów aktów zakupowych za pomocą GET /order/line-item-id-mappings. Umożliwia on mapowanie dealId i lineItemId pomiędzy WebAPI oraz REST API Allegro.

Wyłączymy ten zasób ze względu na całkowite wygaszenie WebAPI Allegro. Ostatnie metody, które korzystały z dealId wyłączyliśmy 13 stycznia 2020 roku.

Zasób aktualnie może generować opóźnienia z uwagi na wzmożony ruch, dlatego zrezygnuj z niego możliwie najszybciej.

Uzupełnij w ofertach własną nazwę marki lub zasugeruj własne parametry

Wprowadziliśmy zmianę, dzięki której w trakcie wystawiania lub edycji oferty możesz zasugerować własne parametry wraz z wartościami we wszystkich kategoriach serwisu. Dodatkowo, możesz dodać własne wartości wybranych parametrów, które wyświetlimy na stronie oferty. Tę opcję udostępniamy dla wybranych parametrów, których listę znajdziesz tutaj.

Zadbaj o obsługę własnych parametrów i wartości w swojej aplikacji - będzie to mieć istotny wpływ na kształt filtrów w Allegro. Propozycje własnych parametrów zbierzemy i zweryfikujemy, a w wybranych przypadkach przeniesiemy je do standardowych parametrów, które są widoczne na filtrach. Sprzedającym często zależy też, aby ich marki były widoczne w filtrach wyszukiwania, dlatego najbardziej popularne własne wartości dodamy do listy dostępnych wartości w filtrze.

Własne parametry

Własne parametry, wraz z określoną wartością, dodasz, gdy wystawiasz lub edytujesz ofertę. Funkcjonalność udostępniliśmy we wszystkich kategoriach.

Przykładowa struktura, jak dodać własny parametr:

    {
      …
      “parameters”: […],
      “customParameters”: [
        {
          “name”: “Nazwa twojego własnego parametru”,
          “values”: [
            “Wartość własnego parametru”
          ]
        }
      ],
      “description”: {…},
     …
   }
                  

Własne wartości

Własne wartości wprowadzisz dla wybranych parametrów posiadających wartość niejednoznaczną. Wartości niejednoznaczne parametru to np. “inne”, “pozostałe”. Identyfikator takiej wartości zwracamy w polu ambiguousValueId w sekcji options w odpowiedzi dla GET /sale/categories/{categoryId}/parameters.

Na ten moment możesz wprowadzić własną wartość w wybranych parametrach. Informację o tym, czy dany parametr obsługuje tę funkcjonalność, sprawdzisz za pomocą GET /sale/categories/{categoryId}/parameters w polu customValuesEnabled w sekcji options.

Skorzystaj z tej opcji, gdy wystawiasz lub edytujesz ofertę i jako wartość parametru wybierasz np. “Inny”. Dzięki temu na ofercie (w nawiasie) widoczna będzie prawidłowa, wpisana przez Ciebie wartość parametru, która – jeśli zyska popularność – będzie mogła znaleźć się też na filtrach.

W przyszłości uzupełnienie wartości będzie obowiązkowe, jeśli wybierzesz wartość niejednoznaczną w ramach danego parametru. W przypadku, gdy tworzysz nowy produkt i wybierzesz wartość niejednoznaczną zawsze wymagamy wprowadzenia własnej wartości.

Przykładowa struktura, jak dodać własną wartość parametru:

        {
        …
          {
            “id”: “129033”,                                  – ID parametru
            “valuesIds”: [
              “129033_13”                                    – ID wartości niejednoznacznej
            ],
            “values”: [ “Nazwa brakującej marki” ],          – wartość, którą chcesz przekazać,
                                                             uzupełnij to pole.
            “rangeValue”: null
          }
        …
        }
                  

Więcej informacji o własnych parametrach i wartościach znajdziesz w naszym poradniku:

• jak dodać własny parametr,
• jak dodać własną wartość parametru,

oraz na stronie dla sprzedających.

Sprawdź nieuzupełnione wymagane parametry w ofertach oraz przyszłe uobowiązkowienia

W odpowiedzi na wasze sugestie dodaliśmy dzisiaj dwa nowe zasoby, które ułatwią sprzedającym zarządzanie ofertami:

• GET /sale/offers/unfilled-parameters - sprawdź brakujące parametry w ofertach. W odpowiedzi zwrócimy domyślnie listę stu ofert, w których nie są uzupełnione parametry obowiązkowe oraz te, które w ciągu najbliższych 3 miesięcy oznaczymy jako wymagane. Do końca roku planujemy dodać filtr, tak abyś mógł sprecyzować w żądaniu, które parametry chcesz otrzymać w odpowiedzi.
  Jeżeli chcesz otrzymać dane tylko dla wybranych ofert, użyj parametru offer.id, np. GET /sale/offers/unfilled-parameters?offer.id=123456789&offer.id=98765432
  
  Przykładowy request:

  
      curl -X GET 
  
      ‘https://api.allegro.pl/sale/offers/unfilled-parameters?offer.id=123456789 
  
      -H ‘Authorization: Bearer {token}’ 
  
      -H ‘Accept: application/vnd.allegro.public.v1+json’
                        

  Przykładowy response:

  
      {
        “offers”: [
               {
              “id”: “123456789”,      – ID oferty
              “parameters”: [         – informacje o nieuzupełnionych parametrach
                    {
                      “id”: “14228”   – ID parametru
                    }
              ],
              “category”: {
                    “id”: “257931”    – ID kategorii, w której występuje parametr
              }
               }
      ],
       “count”: 1,                    – liczba wyświetlanych wyników
       “totalCount”: 1                – łączna liczba wyników
      }
                        

• GET /sale/categories/parameters/required-changes - sprawdź, które parametry w serwisie oznaczymy jako obowiązkowe w ciągu najbliższych 3 miesięcy. Aby zawęzić wyniki do konkretnego przedziału czasowego, użyj parametrów:
  • scheduledFor.gte - najwcześniejsza data planowanego uobowiązkowienia,
  • scheduledFor.lte - najpóźniejsza data planowanego uobowiązkowienia, nie może być większa niż 3 miesiące od bieżącej daty,
  np. żeby sprawdzić, które parametry staną się obowiązkowe do końca grudnia, musisz sformułować żądanie GET /sale/categories/parameters/required-changes?scheduledFor.lte=2020-12-31T23:59:59Z.
  
  Przykładowy request:

  
      curl -X GET 
  
      ‘https://api.allegro.pl/sale/categories/parameters/required-changes 
  
      -H ‘Authorization: Bearer {token}’ 
  
      -H ‘Accept: application/vnd.allegro.public.v1+json’
                        

  Przykładowy response:

  
      {
       “changes”: [
          {
              “category”: {
  
                  “id”: “1521”                            – ID kategorii, w której włączymy
                                                          obowiązkowość parametru
                    },
              “parameter”: {
                  “id”: “219809”                          – ID parametru, który oznaczymy
                                                          jako obowiązkowy
                  },
              “scheduledAt”: “2021-02-19T23:00:00Z”       – data, kiedy parametr oznaczymy
                                                          jako obowiązkowy
               },
          …
           ]
      “count”: 10,                                        – liczba wyświetlanych wyników
      “totalCount”: 10                                    – łączna liczba wyników
      }
                        

Dzięki wprowadzonym zasobom sprzedawca będzie mógł szybciej zareagować na zmiany na naszej platformie, dzięki czemu uniknie problemów związanych np. ze zmianą liczby sztuk w ofertach, w których nie są uzupełnione obowiązkowe parametry.

Informacje o nowych zasobach dodaliśmy także w naszym poradniku.

Nowe zasoby do promowania ofert

Zgodnie z zapowiedzią na stronie dla sprzedających wprowadziliśmy dzisiaj zmiany w opcjach promowania ofert:

• dodaliśmy Wyróżnienie elastyczne (Flexible Emphasized), dzięki któremu sprzedawca wyróżni ofertę na tyle dni, ile chce, ponieważ opłatę za nie będziemy naliczać co jeden dzień;
• opcje Pogrubienie i Podświetlenie dostępne są tylko w Pakiecie Promo (Promo package). Jeśli sprzedawca promuje swoje oferty przy ich pomocy, pozostaną one aktywne i widoczne dla kupujących do końca cyklu rozliczeniowego, a następnie automatycznie wyłączone;
• sprzedawca zdecyduje, czy chce wyłączyć pakiet promowania od razu, czy dopiero po zakończeniu okresu rozliczeniowego;
• opcje promowania sprzedawca może wyłączyć także w zakończonych ofertach.

Dzięki temu sprzedawca może łatwiej zarządzać opcjami promowania ofert - szybciej zareaguje na zmiany w sprzedaży, a swoje oferty wypromuje tylko wtedy, gdy uzna to za opłacalne. Więcej informacji o zmianach w promowaniu ofert znajdziesz na naszej stronie dla sprzedających.

W związku ze zmianami udostępniliśmy nowe zasoby API do zarządzania promowaniem:

• GET /sale/offer-promotion-packages - pobierz dostępne pakiety promowania,
• POST /sale/offers/{offerId}/promo-options-modification - przypisz pakiety promowania do oferty,
• GET /sale/offers/{offerId}/promo-options - sprawdź pakiety promowania przypisane do oferty,
• PUT /sale/offers/promo-options-commands/{commandId} - przypisz pakiety promowania do wielu ofert,
• GET /sale/offers/promo-options-commands/{commandId} - pobierz wynik zadania przypisania pakietów promowania,
• GET /sale/offers/promo-options-commands/{commandId}/tasks - pobierz szczegółowy raport dla zadania przypisania pakietów promowania.

Poniżej znajdziesz nazwy pakietów promowania w API, które przygotowaliśmy dla nowych zasobów. Są to trzy pakiety wyróżnień oraz jedna opcja dodatkowa:

• Flexible Emphasized - Wyróżnienie Elastyczne, za które opłatę naliczamy codziennie;
• Emphasized - Wyróżnienie, za które opłatę naliczamy co dziesięć dni;
• Promo package - Pakiet Promo (Wyróżnienie + Podświetlenie + Pogrubienie), dla którego opłatę naliczamy codziennie;
• Department page promo - opcja dodatkowa, Promowanie na stronie działu, opłatę naliczamy co dziesięć dni.

Zmiany nie mają wpływu na model oferty. Nadal zmienisz opcję promowania za pomocą dotychczasowego API - tak jak do tej pory, zmianę wykonamy natychmiast.

Więcej informacji o tym, jak zarządzać promowaniem, znajdziesz w naszym poradniku.

Dodaj numer przesyłki w uproszczony sposób

Od dzisiaj łatwiej dodasz numer przesyłki do zamówienia. Już nie musisz podawać kolejnych lineItems.id wchodzących w skład zamówienia. Wystarczy, że skorzystasz z POST /order/checkout-forms/{id}/shipments i przekażesz w żądaniu wymagane wartości (carrierId oraz waybill), a my przypiszemy numer przesyłki do każdego lineItem.id z zamówienia.

Przykładowy request:

curl -X POST \

https://api.allegro.pl/order/checkout-forms/31896452-2de1-11e9-bced-352ab82ad9cd/shipments 

-H ‘Authorization: Bearer {token}’ 

-H ‘Content-Type: application/vnd.allegro.public.v1+json’ 

-H ‘Accept: application/vnd.allegro.public.v1+json’ 

-d ‘{
    “waybill”: “12345678910PL”,
    “carrierId”: “DHL”

}’

Przykładowy response:

{
    “waybill”: “12345678910PL”,
    “carrierId”: “DHL”,
    “lineItems”: [
            {
                “id”: “31896450-2de1-11e9-bced-352ab82ad9cd”
            },
            {
                “id”: “5b1f4a62-6969-11e8-b090-8b2d9f391430”
            }
    ],
    “createdAt”: “2020-10-27T11:46:48.264Z”,
    “id”: “REhMOjEyMzQ1Njc4OTEwUEw=”

}

Nowa wersja zasobów /sale/product-offers - asynchroniczne API

Od dziś możesz skorzystać z wersji beta.v2 zasobów:

• POST /sale/product-offers,
• PATCH /sale/product-offers/{offerId}.

W wersji beta.v2 wdrożyliśmy wzorzec asynchronicznego API ze względu na dłuższy czas wykonania niektórych operacji po stronie platformy Allegro, takich jak np. zmiany statusu publikacji oferty.

Ważne! Wersję beta.v1 wyłączymy 12 grudnia 2020 roku.

Aby skorzystać z wersji beta.v2 wystarczy, że przekażesz w nagłówkach Content-Type oraz Accept wartość “application/vnd.allegro.beta.v2+json”.

W wersji beta.v2 w odpowiedzi na prawidłowe żądanie na zasobie /sale/product-offers otrzymasz jeden z trzech statusów:

• 200 OK - zmiany wdrożymy od razu. Występuje tylko w przypadku metody PATCH,
• 201 Created - ofertę utworzymy od razu. Występuje tylko w przypadku metody POST,
• 202 Accepted - ze względu na dłuższy czas wykonania operacji zadanie przeprowadzimy asynchronicznie. Występuje w przypadku metody POST i PATCH.

Wraz ze statusem 202 Accepted zwrócimy w odpowiedzi nagłówek Location, w którym znajdziesz odnośnik do nowego zasobu w postaci: /sale/product-offers/{offerId}/operations/{operationId}. Odpytaj go metodą GET, aby sprawdzić status zadania. W odpowiedzi zwrócimy jeden z dwóch statusów:

• 202 Accepted - operacja nie została jeszcze zakończona. Powtórz poprzednie żądanie.
• 303 See Other - operacja została zakończona. W nagłówku Location przekażemy odnośnik do zasobu w postaci: /sale/product-offers/{offerId}. Skorzystaj z metody GET i przesłanego odnośnika w polu Location. W odpowiedzi zwrócimy aktualne dane oferty.

Więcej informacji o nowym sposobie działania zasobów /sale/product-offers znajdziesz w naszym poradniku:

• publikacja oferty w asynchronicznym API,
• edycja oferty w asynchronicznym API.

Rabat na duże zamówienie dla transakcji B2B

Od dziś dodasz rabat na duże zamówienie do swoich ofert. Dzięki niemu zaoferujesz kupującym rabat podczas transakcji B2B (firma - firma). Aby dodać rabat, skorzystaj z POST /sale/loyalty/promotions i określ progi wartościowe pojedynczego zamówienia oraz przypadający dla nich rabat procentowy. Rabatem zostaną objęte wszystkie twoje oferty.

Przykładowy request:

curl -X POST
‘https://api.allegro.pl/sale/loyalty/promotions' 

-H ‘Accept: application/vnd.allegro.public.v1+json’ 

-H ‘Content-Type: application/vnd.allegro.public.v1+json’  

-H ‘Authorization: Bearer {token}’ 

-d ‘{
    “benefits”: [
      {
        “specification”: {
            “type”: “LARGE_ORDER_DISCOUNT”,    – typ promocji (lista dostępnych wartości
                                               znajduje się w dokumentacji zasobu)
            “thresholds”: [                    – progi rabatowe
              {
                “orderValue”: {
                    “lowerBound”: {
                        “amount”: “1000.00”,   – wartość zamówienia
                        “currency”: “PLN”
                    }
                },
                “discount”: {
                    “percentage”: “5”          – wysokość rabatu (%)
                }
            },
            {
                “orderValue”: {
                    “lowerBound”: {
                        “amount”: “1500.00”,
                        “currency”: “PLN”
                    }
                },
                “discount”: {
                    “percentage”: “8”
                }
            }
            ]
        }
    }
    ],
    “offerCriteria”: [
      {
        “type”: “ALL_OFFERS”                   – rabatem zostaną objęte
      }                                        wszystkie oferty
    ]
}’

W odpowiedzi otrzymasz identyfikator utworzonego rabatu.

Przykładowy response:

{
    “id”: “ba01f101-c9ef-4e5d-a88f-efb721bdbb9a”,    – identyfikator rabatu
    “createdAt”: “2020-10-27T06:31:29.36Z”,          – data utworzenia
    “benefits”: [
      {
        “specification”: {
            “thresholds”: [
              {
                “orderValue”: {
                    “lowerBound”: {
                        “amount”: “1000.00”,
                        “currency”: “PLN”
                    }
                },
                “discount”: {
                    “percentage”: “5”

                }
            },
            {
                “orderValue”: {
                    “lowerBound”: {
                        “amount”: “1500.00”,
                        “currency”: “PLN”
                    }
                },
                “discount”: {
                    “percentage”: “8”
                }
            }
            ],
            “type”: “LARGE_ORDER_DISCOUNT”
        }
    }
    ],
    “offerCriteria”: [
      {
        “type”: “ALL_OFFERS”
      }

    ]
    “status”: “ACTIVE”
}

Więcej informacji o rabacie na duże zamówienie i zasobach do zarządzania nim znajdziesz w naszym poradniku.

Kupujący może zmienić adres dostawy w zamówieniu - aktualizacja

W nawiązaniu do wcześniejszej zapowiedzi, opcję edycji adresu dostawy w zamówieniu udostępnimy kupującym w styczniu 2021. Decyzję o zmianie terminu wdrożenia podjęliśmy z uwagi na wydłużenie czasu niezbędnego na implementację rozwiązania w integracjach.

POST /sale/product-offers oraz PATCH /sale/product-offers{offer-id} - dodaliśmy obsługę kolejnych pól (wysokość stawki podatku VAT i czas trwania oferty), które możesz wysłać w żądaniu

W odpowiedzi na wasze sugestie dodaliśmy w:

• POST /sale/product-offers,
• PATCH /sale/product-offers/{offerId}

obsługę dwóch kolejnych atrybutów oferty: wysokość stawki podatku VAT i czas trwania oferty. Atrybuty te ustawisz w ofercie, jeśli w strukturze żądania zadeklarujesz pola:

• tax.percentage - wysokość podatku VAT,
• publication.duration - czas trwania oferty.

Więcej informacji na temat nowych pól znajdziesz w naszym poradniku.

POST /sale/product-offers oraz PATCH /sale/product-offers/{offerId} - dodaliśmy obsługę tabel rozmiarów

W dniu dzisiejszym dodaliśmy sekcję sizeTable w strukturze żądania POST /sale/product-offers oraz PATCH /sale/product-offers/{offerId}. Dzięki niej dodasz do oferty zdefiniowaną tabelę rozmiarów. Tak jak w przypadku pozostałych pól w tych zasobach - możesz wskazać nazwę lub identyfikator tabeli rozmiarów.

Więcej informacji na temat nowej sekcji znajdziesz w naszym poradniku.

GET /sale/categories/{categoryId}/parameters - dodaliśmy nowe pola do obsługi parametrów zależnych

16.11.2020 planujemy wdrożyć kolejny etap obsługi parametrów zależnych - warunkową obowiązkowość i wyświetlanie. Więcej o parametrach zależnych przeczytacie w naszym wcześniejszym komunikacie. Dzięki parametrom zależnym uprościmy nawigację, a kupujący będą mogli porównywać między sobą oferty znajdujące się dotąd w różnych kategoriach. Dodatkowo sprzedawcy będą mogli dodawać do ofert kompletne i adekwatne informacje, które będą odpowiadały charakterowi sprzedawanego produktu. Dzięki temu kupujący skuteczniej znajdzie dobrze opisane oferty.

Warunkowa obowiązkowość oznacza, że wymagalność danego parametru uzależniona jest od wartości wybranej dla parametru warunkującego np. jeżeli sprzedawca wybierze w parametrze “Stan” wartość “Nowy”, wtedy powinien też wiedzieć, jaka jest wartość parametru “Kod producenta”, dlatego oznaczymy go jako obowiązkowy. Jeżeli wybierze wartość “Używany”, wtedy parametr “Kod producenta” będzie opcjonalny, na wypadek gdyby produkt miał np. wytartą metkę.

Warunkowa widoczność oznacza, że wyświetlenie danego parametru uzależnione jest od wartości wybranej dla parametru warunkującego np. jeżeli w kategorii “Mydła” (258383) sprzedawca wybierze w parametrze “Rodzaj” wartość “Kostka”, wyświetlimy wtedy parametr “Waga”, a “Pojemność” ukryjemy. Z kolei, gdyby wybrał wartość “Płyn” lub “Pasta”, wtedy nastąpi odwrotna sytuacja - ukryjemy parametr “Waga”, a pokażemy “Pojemność”.

W związku z tym, dla GET /sale/categories/{categoryId}/parameters dodaliśmy nowe pola:

• options.requiredDependsOnValueIds - w którym zwrócimy identyfikatory wartości parametru warunkującego, dla których ten parametr będzie wymagany, np. może się tutaj znaleźć identyfikator wartości “Nowy” dla parametru “Stan”,
• options.displayDependsOnValueIds - w którym zwrócimy zbiór identyfikatorów wartości parametru warunkującego, od których zależy, czy dany parametr będzie widoczny, np. jeżeli to pole dotyczy parametru “Pojemność” w kategorii “Mydła”, to zwrócimy tutaj identyfikatory wartości “Płyn i “Pasta” dla parametru “Rodzaj”.

Na stronie dla sprzedających znajdziesz listę pierwszych kategorii i parametrów, dla których wprowadzimy warunkową obowiązkowość i wyświetlanie.

Przykładowa struktura odpowiedzi:

{
  “parameters”: [
    {
      “id”: “202877”,
      “name”: “Liczba rdzeni procesora”,
      “type”: “integer”,
      “required”: false,
      “requiredForProduct”: false,
      “unit”: null,
      “options”: {
        “variantsAllowed”: true,
        “variantsEqual”: false,
        “ambiguousValueId”: null,
        “dependsOnParameterId”: “202870”,
        “requiredDependsOnValueIds”: [
          “202870_1”
        ],
        “displayDependsOnValueIds”: [
          “202870_1”,
          “202870_2”
        ],
        “describesProduct”: false
      },
      “restrictions”: {
        “min”: 0,
        “max”: 1000000,
        “range”: false
      }
    }
  ]
}
     

PATCH /sale/product-offers/{offer-id} - nowa metoda edycji oferty

W dniu dzisiejszym, obok wcześniej zaprezentowanego przez nas zasobu POST /sale/product-offers, udostępniliśmy nowy zasób PATCH /sale/product-offers/{offer-id}, dzięki któremu edytujesz swoją ofertę w prosty sposób - zmienisz dowolne pole oferty, a jednocześnie nie musisz przekazywać całego jej modelu.

Jeżeli skorzystasz z PATCH /sale/product-offers/{offer-id} i nie podasz wartości pola - w ofercie pozostawimy dotychczasową jego wartość i zmienimy tylko te, w których przekażesz wartość inną niż dotychczas. Z kolei, gdy przekażesz wartość null - usuniemy z oferty wartość pola, o ile pole nie jest wymagane.

Dzięki takiemu podejściu edytujesz niezależnie dowolne pole w ofercie, m.in:

• zdjęcia,
• parametry,
• lokalizację,
• cenę,
• opis oferty.

Przy edycji chcieliśmy zapewnić te same udogodnienia, które przy tworzeniu ofert daje POST /sale/product-offers, dlatego dzięki PATCH /sale/product-offers/{offer-id} m.in. możesz zmienić status oferty bez konieczności wywoływać osobnej komendy publikacji, czy też dodać do oferty zdjęcia bezpośrednio z zewnętrznych serwerów.

Więcej informacji na temat PATCH /sale/product-offers/{offer-id} znajdziesz w naszym poradniku.

Nowa sekcja “discounts” w ofercie

Dzisiaj w modelu oferty udostępniliśmy nową sekcję discounts, w której zwracamy informacje o zniżkach przypisanych do oferty. Obecnie, w sekcji znajdziesz identyfikator cennika hurtowego dodanego do oferty. W przypadku jego braku zwrócimy wartość null.

Model oferty po zmianie:

…
   “discounts”: {
       “wholesalePriceList”: {
           “id”: “5637592a-0a24-4771-b527-d89b2767d821”
       }
   },
…

Dzięki zmianie możesz w prosty sposób dodać cennik hurtowy podczas wystawiania lub edycji oferty.

Więcej informacji o cennikach hurtowych znajdziesz w naszym poradniku.

Scope w API Allegro

Dzisiaj na środowisku testowym (allegro.pl.allegrosandbox.pl) udostępniliśmy funkcjonalność tzw. scope’ów, czyli zakresów określających poziom uprawnień aplikacji do korzystania z API Allegro. Każdy scope ma przypisany zestaw uprawnień, który definiuje:

• zestaw zasobów, do których można uzyskać dostęp za pomocą scope’a,
• zestaw operacji, które można wykonać w scope’ie.

Dotychczas, każda z aplikacji zarejestrowanych na stronie Zarządzanie aplikacjami Allegro Sandbox prosiła o dostęp do wszystkich dostępnych w API Allegro scope’ów. Od dzisiaj możesz wystąpić tylko o te scope’y, które faktycznie są niezbędne do prawidłowego funkcjonowania aplikacji. Aby ograniczyć dostęp aplikacji tylko do wybranych zasobów, podczas uzyskiwania autoryzacji musisz przekazać odpowiednie scope’y - każdy kolejny scope oddziel od siebie spacją (“%20”). Listę dostępnych scope’ów znajdziesz tu.

https://allegro.pl.allegrosandbox.pl/auth/oauth/authorize?response_type=code&redirect_uri=http://www.example.com&client_id=438f71d3a26e4d829783a0a621873465&scope=allegro:api:sale:offers:write%20allegro:api:orders:read

Od dnia 11.01.2021 na środowisku produkcyjnym uzyskasz dostęp tylko do zasobów, których scope’y przekażesz w żądaniu. Jeśli na liście scope’ów w tokenie nie znajdzie się wymagany scope, to twoje zapytanie zostanie odrzucone z kodem błędu 403.

Dlatego już dzisiaj rozpocznij prace nad prawidłową obsługą scope przez twoje oprogramowanie. Jeżeli nie podejmiesz żadnych kroków, to twoja aplikacja będzie za każdym razem autoryzować się z pełną listą scope’ów - wyświetlimy je użytkownikowi na ekranie zgody (consent screen) podczas potwierdzania połączenia aplikacji z kontem użytkownika oraz na liście aplikacji w zakładce Powiązane aplikacje. Korzystaj wyłącznie z niezbędnych scope’ów - dzięki temu ograniczysz liczbę pytań od użytkowników oraz odrzuconych powiązań aplikacji. Dzięki wdrożeniu obsługi scope’ów zapewnisz wzrost bezpieczeństwa użytkowników, którzy korzystają z API Allegro oraz aplikacjom, które używają naszego API.

Więcej informacji o scope’ach znajdziesz w naszym poradniku.

POST /sale/products-offers - jeśli w żądaniu przekażesz własny opis, nie będziemy go łączyć z opisem z naszej bazy produktowej

Do tej pory, tworząc ofertę z produktu, łączyliśmy przekazany w żądaniu opis z opisem produktowym. W odpowiedzi na wasze sugestie, od teraz opis produktowy zaprezentujemy w ofercie, tylko gdy nie podasz własnego opisu w sekcji description.

Więcej informacji na temat POST /sale/product-offers znajdziesz w naszym poradniku.

Sandbox - przerwa techniczna

06.10.2020 o godzinie 07:00 rozpoczniemy przerwę techniczną na środowisku testowym, która potrwa ok. 1 godziny. Przepraszamy za niedogodności.

Sandbox - kupujący może zmienić adres dostawy w zamówieniu

W drugiej połowie października udostępnimy kupującym możliwość zmiany adresu dostawy w zamówieniu. Klient będzie mógł zmienić dane dla zamówienia w statusie READY FOR PROCESSING, jeśli np. wcześniej podał nieprawidłowe informacje. Podobnie jak w przypadku anulowania zamówienia, będą musiały zostać spełnione odpowiednie warunki:

• sprzedający musi posiadać konto Firma,
• status realizacji zamówienia (fulfillment.status) jest inny niż: “PROCESSING”, “READY_FOR_SHIPMENT”, “SENT”;
• sprzedawca nie dodał numeru przesyłki do zamówienia,
• zmiana adresu możliwa jest w ciągu 3 dni od daty zakupu.

Funkcjonalność udostępniliśmy już dzisiaj w naszym środowisku testowym. W związku z tym dla:

• GET /order/events - dodaliśmy nowy typ zdarzenia “BUYER_MODIFIED”, które otrzymasz, gdy kupujący zmieni adres;
• GET /order/checkout-forms i GET /order/checkout-forms/{id} - w sekcji delivery.address dodaliśmy nowe pole modifiedAt, w którym zwracamy:
  • datę, kiedy kupujący zmienił dane w zamówieniu;
  • wartość null dla zamówień bez modyfikacji przez kupującego.
  Pole dodaliśmy także w środowisku produkcyjnym, ale do momentu udostępnienia funkcjonalności kupującym będzie tam zawsze wartość null.

Aby zmienić adres dostawy jako kupujący, wejdź w szczegóły zakupu w zakładce Kupione i wybierz “Zmień” pod danymi odbiorcy.

Zmiany w powiadomieniach e-mail

Dzisiaj w Allegro udostępniliśmy nowe zgody, którymi możesz zarządzać w zakładce Zgody na powiadomienia. Dzięki temu zdecydujesz, które powiadomienia o twoich ofertach są ci potrzebne do pracy. Nowe zgody:

• gdy wystawisz ofertę lub ogłoszenie,
• gdy Twoja oferta lub ogłoszenie zostaną automatycznie wznowione,
• gdy Twoja oferta lub ogłoszenie zostaną zakończone,

są domyślnie wyłączone na koncie firmowym. Możesz to zmienić w zakładce Zgody na powiadomienia.

Szczegółowe informacje o zmianie znajdziesz w aktualnościach Allegro.

Sandbox - przerwa techniczna

24.09.2020 o godzinie 07:00 rozpoczniemy przerwę techniczną na środowisku testowym, która potrwa ok. 1 godziny. Przepraszamy za niedogodności.

Od 14 października będziemy wymagać 1% ofert powiązanych z produktami w kolejnych kategoriach

Od początku 2019 roku tworzymy rozwiązania, które pomagają powiązać przedmioty z ofert na Allegro z produktami w naszej bazie. Dzięki temu możesz wystawiać swoje oferty szybciej, a kupujący łatwiej odnajdują interesujące ich przedmioty. Planujemy, aby w 2021 roku wszystkie oferty w wybranych kategoriach były połączone z naszą bazą.

Już teraz wymagamy, aby 1% ofert był powiązany z produktami w:

• Elektronice,
• Kulturze i rozrywce,
• Urodzie.

Od 14 października zaczniemy wymagać 1% ofert powiązanych z produktami w kolejnych działach:

• Sport i turystyka,
• Dom i ogród,
• Zdrowie,
• Supermarket.

W części kategorii nie będziemy tego wymagać - ich listę znajdziesz w tym pliku.

Ważne! Jeżeli sprzedawca nie spełni tego wymagania, to w tych kategoriach (z wyłączeniem kategorii z pliku) nie będzie mógł wystawić nowej oferty, jeśli obecnych nie powiąże z produktem.

Więcej o tym, jak powiązać ofertę z produktem, przeczytasz w naszym poradniku. Zapoznaj się także z nowym zasobem POST /sale/product-offers, dzięki któremu za pomocą jednego żądania wystawisz aktywną ofertę powiązaną z produktem:

• który istnieje już w naszej bazie. Wystarczy, że w żądaniu przekażesz numer EAN (lub identyfikator produktu) oraz cenę i liczbę sztuk;
• którego nie ma w naszej bazie. W strukturze żądania za pomocą kompletu danych opiszesz sprzedawany produkt oraz przekażesz informacje o cenie i liczbie sztuk.

Udostępniliśmy nowy zasób, dzięki któremu sprawdzisz sugerowane kategorie dla podanej frazy

Udostępniliśmy dziś nowy zasób GET /sale/matching-categories, za pomocą którego po podaniu frazy pobierzesz sugerowaną listę kategorii, w których możesz wystawić swój przedmiot. Dzięki temu łatwiej i szybciej zidentyfikujesz odpowiednią kategorię.

W żądaniu przekaż parametr name i podaj w nim wyszukiwaną frazę, np. name=bmw x3. W odpowiedzi otrzymasz listę sugerowanych kategorii.

Przykładowy request:

curl -X GET 

    ‘https://api.allegro.pl/sale/matching-categories?name=bmw x3’ 

    -H ‘Authorization: Bearer {token}’ 

    -H ‘Accept: application/vnd.allegro.public.v1+json’

Przykładowy response:

{
“matching_categories”: [
    {
      “id”: “250885”,                   – identyfikator sugerowanej kategorii.
      “name”: “Wahacze”,                – nazwa sugerowanej kategorii.
      “parent”: {                       – kategoria nadrzędna w stosunku do
                                        sugerowanej kategorii:
                                        dzięki tej strukturze poznasz dokładną
                                        ścieżkę sugerowanej kategorii.
        “id”: “250882”,                 – identyfikator kategorii nadrzędnej.
        “name”: “Wahacze i elementy”,   – nazwa kategorii nadrzędnej.
        “parent”: {
          “id”: “8683”,
          “name”: “Układ zawieszenia”,
          “parent”: {
            “id”: “620”,
            “name”: “Części samochodowe”,
            “parent”: {
              “id”: “3”,
              “name”: “Motoryzacja”,
              “parent”: null
            }
          }
        }
      }
    },
    …
     {
      “id”: “255100”,
      “name”: “Lampy przeciwmgielne”,
      “parent”: {
        “id”: “255098”,
        “name”: “Lampy przednie i elementy”,
        “parent”: {
          “id”: “623”,
          “name”: “Oświetlenie”,
          “parent”: {
            “id”: “620”,
            “name”: “Części samochodowe”,
            “parent”: {
              “id”: “3”,
              “name”: “Motoryzacja”,
              “parent”: null
            }
          }
        }
      }
    }
  ]
}

Udostępniliśmy nowy zasób, dzięki któremu pobierzesz sugerowaną sekcję Pasuje do

Udostępniliśmy dziś nowy zasób GET /sale/compatibility-list-suggestions, za pomocą którego pobierzesz sugerowaną sekcję Pasuje do. Skorzystaj z tego zasobu, gdy nie posiadasz listy kompatybilności w ofercie. Dzięki uzupełnionej sekcji kupujący łatwiej odnajdzie interesujący go produkt. Sugestie tworzymy na podstawie list komptybilności ofert innych sprzedających. Listę możesz modyfikować według własnych potrzeb, np. usunąć lub dodać niektóre z pozycji.

Przekaż w żądaniu jeden z parametrów, na podstawie którego zwrócimy sugerowaną sekcję Pasuje do:

• offer.id - identyfikator oferty,
• product.id - identyfikator produktu - sprawdź, jak wyszukać produkt.

Przykładowy request:

curl -X GET 

    ‘https://api.allegro.pl/sale/compatibility-list-suggestions?offer.id=6505550901' 

    -H ‘Authorization: Bearer {token}’ 

    -H ‘Accept: application/vnd.allegro.public.v1+json’

Przykładowy response:

{
    “type”: “MANUAL”,
    “items”: [
        {
            “type”: “ID”,
            “id”: “73ff4bae-958d-4b75-a49c-d0c11fdd233c”,
            “text”: “Toyota AVENSIS (T22) 2.0 VVT-i (AZT220_) (1AZ-FSE) 1998ccm 150KM/110kW 2000⁄10-2003⁄02”,
            “additionalInfo”: []
        },
        {
            “type”: “ID”,
            “id”: “de7a2247-78fa-4a12-94f1-f43b5f33ac7e”,
            “text”: “Toyota AVENSIS (T22) 2.0 TD (CT220_) (2C-TE) 1975ccm 90KM/66kW 1997⁄09-2003⁄02”,
            “additionalInfo”: []
        }
    ]
}

Listę, którą otrzymasz, możesz następnie przekazać, gdy wystawiasz lub edytujesz ofertę.

Cenniki hurtowe dla transakcji B2B

Od dziś dodasz cenniki hurtowe do ofert. Dzięki nim zaoferujesz rabat podczas transakcji B2B (firma - firma). Aby utworzyć cennik hurtowy, skorzystaj z POST /sale/loyalty/promotions i określ progi ilościowe oraz przypadający dla nich rabat procentowy.

Przykładowy request:

curl -X POST
‘https://api.allegro.pl/sale/loyalty/promotions' 

-H ‘Accept: application/vnd.allegro.public.v1+json’ 

-H ‘Content-Type: application/vnd.allegro.public.v1+json’ 

-H ‘Authorization: Bearer {token}’ 

-d ‘{
 “benefits”: [
    {
      “specification”: {
          “type”: “WHOLESALE_PRICE_LIST”,        – typ promocji (lista dostępnych
                                                 wartości znajduje się w dokumentacji zasobu)
          “name”: “Cennik hurtowy nr 1”,         – nazwa cennika
          “thresholds”: [                        – progi rabatowe
              {
                “quantity”: {                    – minimalna liczba
                    “lowerBound”: 5              zakupionych przedmiotów
                },
                “discount”: {                    – wysokość rabatu (%)
                    “percentage”: “5”
                }
              },
              {
                “quantity”: {
                    “lowerBound”: 10
                },
                “discount”: {
                    “percentage”: “8”
                }
              }
            ]
          }
    }
  ],
  “offerCriteria”: [
    {
      “type”: “OFFERS_ASSIGNED_EXTERNALLY”        – oferty przypiszesz za pomocą
    }                                             PUT /sale/offer-modification-commands/{commandId}
  ]
}’

W odpowiedzi otrzymasz identyfikator utworzonego cennika.

Przykładowy response:

{
    “id”: “9de4be5d-9c60-48aa-8711-363625c9d793”,    – identyfikator cennika
    “createdAt”: “2020-08-13T06:08:06.011Z”,         – data utworzenia
    “benefits”: [
        {
            “specification”: {
                “name”: “Cennik hurtowy nr 1”,
                “thresholds”: [
                    {
                        “quantity”: {
                            “lowerBound”: 5
                        },
                        “discount”: {
                            “percentage”: “5”
                        }
                    },
                    {
                        “quantity”: {
                            “lowerBound”: 10
                        },
                        “discount”: {
                            “percentage”: “8”
                        }
                    }
                ],
                “type”: “WHOLESALE_PRICE_LIST”
            }
        }
    ],
    “offerCriteria”: [
        {
            “type”: “OFFERS_ASSIGNED_EXTERNALLY”
        }
    ],
    “status”: “ACTIVE”
}

Utworzony cennik hurtowy przypiszesz do wybranych ofert za pomocą zasobu do grupowych zmian w ofercie - PUT /sale/offer-modification-commands/{commandId}.

Przykładowy request:

curl -X PUT 

‘https://api.allegro.pl/sale/offer-modification-commands/daccd266-fa5e-4a6b-a10b-d24836c411e1' 

  -H ‘Authorization: Bearer {token}’ 

  -H ‘Accept: application/vnd.allegro.public.v1+json’ 

  -H ‘Content-Type: application/vnd.allegro.public.v1+json’ 

  -d ‘{
 “modification”: {
   “discounts”: {                                          – typ zmiany
     “wholesalePriceList”: {

       “id”: “9de4be5d-9c60-48aa-8711-363625c9d793”        – identyfikator cennika
     }
   }
 },
 “offerCriteria”: [
   {
     “offers”: [
       {
         “id”: “9292002929”                                – identyfikator oferty
       },
       {
         “id”: “9876543210”
       }
     ],
     “type”: “CONTAINS_OFFERS”
   }
 ]
}’

Ważne! Obecnie informacji o przypisanym cenniku hurtowym do oferty nie otrzymasz w odpowiedzi dla GET /sale/offers/{offerId}.

Więcej informacji o cennikach hurtowych i zasobach do zarządzania nimi znajdziesz w naszym poradniku.

GET /sale/offers - nowe opcje filtrowania

Dzisiaj dla GET /sale/offers udostępniliśmy nowe opcje filtrowania według:

• category.id - możesz znależć oferty, które przynależą do danej kategorii,
• product.id.empty - możesz wyszukać oferty, które nie posiadają przypisanego produktu (product.id),
• productizationRequired - możesz wyfiltrować oferty, które należą do kategorii, w których produktyzacja jest obowiązkowa.

Przykładowo, jeśli chcesz wyszukać oferty, które należą do kategorii 260660, nie posiadają przypisanego produktu, a muszą spełnić wymaganie powiązania z produktem, wystarczy, że wywołasz:

GET /sale/offers?category.id=260660&product.id.empty=true&productizationRequired=true

Usuwamy parametr user.id / seller.id z wywołań

Zgodnie z waszymi sugestiami od dzisiaj podczas wywoływania poniższych zasobów nie musicie już przekazywać parametru:

• user.id dla:
• GET /sale/offer-additional-services/groups,
• GET /sale/offer-additional-services/definitions,
• GET /sale/size-table,
• GET /sale/offer-tags,
• GET /sale/offer-variants,
• GET /sale/user-ratings,
• GET /sale/loyalty/promotions,
• seller.id dla:
• GET /sale/offer-contacts,
• GET /sale/shipping-rates,
• GET /after-sales-service-conditions/return-policies,
• GET /after-sales-service-conditions/implied-warranties,
• GET /after-sales-service-conditions/warranties.

Jeżeli w swoim wywołaniu nadal przekażesz parametr user.id lub seller.id, to zwrócimy również poprawną odpowiedź.

Wysyłam z Allegro - nowe narzędzie do zarządzania przesyłkami

Udostępniliśmy dziś nowe, bezpłatne narzędzie, które ułatwia zarządzanie przesyłkami - Wysyłam z Allegro. Sprzedawcy mogą utworzyć w nim i wydrukować etykiety oraz zamówić odbiór paczek przez przewoźników ze wskazanego adresu. Numery przesyłek automatycznie dodamy do odpowiednich zamówień. Więcej na temat tego narzędzia przeczytasz na stronie dla sprzedających.

Na potrzeby nowej funkcjonalności przygotowaliśmy poradnik, w którym znajdziesz więcej szczegółów o zasobach API.

Ważne! Zanim skorzystasz z API Wysyłam z Allegro, powiąż swoje konto na stronie:

• wysylam.allegro.pl (środowisko produkcyjne),
• wysylam.allegro.pl.allegrosandbox.pl (środowisko testowe).

Sprawdź, czy dla parametru z wartością niejednoznaczną możesz dodać własną wartość

Udostępniliśmy dziś nowe pole customValuesEnabled w sekcji options odpowiedzi dla GET /sale/categories/{categoryId}/parameters. Sprawdzisz w nim, czy dla parametru z wartością niejednoznaczną możesz przekazać własną wartość.

Wartości niejednoznaczne parametru to wartości typu: “inne”, “pozostałe”, etc. np. “inna” w parametrze “Marka”. Identyfikator takiej wartości zwracamy w polu ‘ambiguousValueId’ w sekcji options w odpowiedzi dla GET /sale/categories/{categoryId}/parameters.

W naszym poradniku znajdziesz wskazówki, jak dodać własną wartość dla parametru z wartością niejednoznaczną.

GET /offers/listing - wyszukaj oferty po loginie sprzedawcy

Zgodnie z waszymi sugestiami od dziś w GET /offers/listing możecie wyszukać oferty danego sprzedawcy po jego loginie. Dotychczas można było wyszukać oferty danego sprzedawcy tylko po jego identyfikatorze.

Przykładowy request:

  curl -X GET 

    ‘https://api.allegro.pl/offers/listing?seller.login=Allegro' 

    -H ‘Authorization: Bearer {token}’ 

    -H ‘Accept: application/vnd.allegro.public.v1+json’
  

Sandbox - przerwa techniczna

03.09.2020 o godzinie 19:00 rozpoczniemy przerwę techniczną na środowisku testowym, która potrwa ok. 1 godziny. Przepraszamy za niedogodności.

Usunęliśmy metody dostawy “Kurier wieczór” i “Kurier wieczór pobranie”

Zgodnie z wcześniejszą zapowiedzią usunęliśmy dziś metody dostawy:

• “Kurier wieczór”,
• “Kurier wieczór pobranie”.

Dynamic Client Registration

Udostępniliśmy nowy sposób autoryzacji - Dynamic Client Registration. Jest to rozszerzenie standardu OAuth2 umożliwiające tworzenie instancji twojej aplikacji w sposób zautomatyzowany. Jeżeli klient bezpośrednio instaluje kopię twojego oprogramowania (np. instancję platformy sklepowej we własnej infrastrukturze), to ten typ autoryzacji jest właśnie dla ciebie. Zapewnia on pełne bezpieczeństwo autoryzacji danych, a jednocześnie nie wymusza na każdym kliencie ręcznego generowania osobnych danych dostępowych (client ID oraz client secret).

Szczegółowe informacje o DCR znajdziesz w naszym poradniku.

POST /sale/offers - w odpowiedzi dodaliśmy nowe pole “warnings”

W odpowiedzi dla POST /sale/offers dodaliśmy nowe pole “warnings” w sekcji validation. Informujemy w nim, czy w opisie oferty znajdują się treści, które mogą naruszać zasady obowiązujące w Allegro. Frazy, które mogą spowodować, że wyświetlimy komunikat, to np.:

• EAN,
• warunki zwrotu,
• link do strony www,
• informacje dotyczące wysyłki,
• tabele rozmiarów.

Ważne! Nadal prawidłowo wystawisz ofertę, dla której zwrócimy informacje w polu warnings.

Wprowadziliśmy to pole, ponieważ zależy nam, aby sprzedawcy już na pierwszym etapie, gdy tworzą nową ofertę, mogli zwrócić uwagę na problematyczne treści. Komunikat pozwoli sprzedawcom uniknąć dalszych sankcji podejmowanych przez Allegro, jeśli wystawią nieregulaminową ofertę - wystarczy, że wykonają w niej stosowne zmiany.

Przykładowa struktura odpowiedzi:

{
   “validation”: {
       “errors”: [],
       “warnings”: [
           {
               “code”: “VALIDATION_WARNING”,
               “message”: “Wystawiany przedmiot znajduje się w wykazie produktów leczniczych, środków spożywczych specjalnego przeznaczenia żywieniowego oraz wyrobów medycznych zagrożonych brakiem dostępności na terytorium Rzeczypospolitej Polskiej. Jeżeli zdecydujesz się wysłać go za granicę masz obowiązek powiadomienia o tym fakcie Główny Inspektorat Farmaceutyczny. Musi to nastąpić przed zamiarem wywozu lub zbycia produktu poza terytorium Rzeczypospolitej Polskiej.”,
               “details”: “”,
               “path”: “”,
               “userMessage”: “Wystawiany przedmiot znajduje się w wykazie produktów leczniczych, środków spożywczych specjalnego przeznaczenia żywieniowego oraz wyrobów medycznych zagrożonych brakiem dostępności na terytorium Rzeczypospolitej Polskiej. Jeżeli zdecydujesz się wysłać go za granicę masz obowiązek powiadomienia o tym fakcie Główny Inspektorat Farmaceutyczny. Musi to nastąpić przed zamiarem wywozu lub zbycia produktu poza terytorium Rzeczypospolitej Polskiej.”
           }
       ],
       “validatedAt”: “2017-11-08T18:03:39.68Z”
       }
     }

Dodaj własny parametr przez REST API

Od dziś, gdy wystawiasz lub edytujesz ofertę, dodasz swój własny parametr. Dzięki temu opisy ofert będą bardziej precyzyjne, a kupujący łatwiej podejmie decyzję o zakupie. Propozycje własnych parametrów zbierzemy i zweryfikujemy, a w przyszłości przeniesiemy je do standardowych parametrów.

• przekażesz tylko w wybranych kategoriach. W odpowiedzi dla GET /sale/categories i GET /sale categories/{id} dodaliśmy nowe pole - customParametersEnabled, w którym sprawdzisz, czy umożliwiliśmy to w danej kategorii,
• dodasz w nowym polu customParameters w modelu oferty. Parametr będzie widoczny na stronie oferty,
• mają podobne ograniczenie, jak na formularzu wystawiania na stronie internetowej - maksymalnie dodasz 4 własne parametry, dla których przekażesz po jednej wartości,
• nie mogą być duplikatami - jeżeli parametr o takiej nazwie istnieje już w Allegro, to zwrócimy odpowiedni błąd. Możesz jednak dodać własne parametry o takiej samej nazwie dla różnych ofert.

{
…
“parameters”: […],
“customParameters”: [
    {
      “name”: “Nazwa twojego własnego parametru”,
      “values”: [
        “Wartość własnego parametru”
      ]
    }
  ],
“description”: {…},
…
}

{
…
“parameters”: […],
“customParameters”: [
    {
      “name”: “Nazwa twojego własnego parametru”,
      “values”: [
        “Wartość własnego parametru”
      ]
    }
  ],
“description”: {…},
…
}

Plan wygaszenia WebAPI

Wyłączymy WebAPI:

• 1.09.2020 na Sandboxie.
• 26.10.2020 na środowisku produkcyjnym.

Terminy zaktualizowaliśmy, ponieważ od października w WebAPI nie pozostaną już żadne metody, które uzasadniałyby jego dłuższe utrzymywanie.

26.10.2020 wyłączymy także metody do:

• zarządzania wypłatami - doRequestPayout.,
• pobierania informacji dot. ustawień Allegro Finanse - doGetMyPaymentsInfo.

Z powodu niskiego użycia, nie będziemy dodawać ich odpowiedników w REST API. Aktualne ustawienia danych do wypłat możesz sprawdzić w Moim Allegro. Jeśli chcesz otrzymywać codziennie wypłaty, wystarczy, że ustawisz automatyczny sposób wypłat.

Sandbox - przerwa techniczna

30.07.2020 o godzinie 9:00 rozpoczniemy przerwę techniczną na środowisku testowym, która potrwa ok. 2 godzin. Przepraszamy za niedogodności.

Weź udział w ankiecie o produktyzacji w Allegro

Wypełnij ankietę o produktyzacji w Allegro. Chcemy dowiedzieć się, na jakim etapie wdrożenia produktyzacji jesteś oraz które kwestie są dla Ciebie najbardziej problematyczne. Na końcu ankiety znajdziesz pytanie otwarte, w którym możesz podzielić się swoimi sugestiami na temat tej funkcjonalności.

Link do ankiety - kliknij tu.

18.08.2020 usuniemy metody dostawy “Kurier wieczór” i “Kurier wieczór pobranie”

18.08.2020 usuniemy metody dostawy:

• “Kurier wieczór”,
• “Kurier wieczór pobranie”.

Od 04.08.2020, gdy stworzysz lub zmienisz cennik dostawy, który zawiera jedną z tych metod, otrzymasz status 422 wraz z odpowiednią treścią błędu:

“errors”: [
        {
            “code”: “DEPRECATED_DELIVERY_METHOD”,
            “message”: “Kurier wieczór pobranie is deprecated.”,
            “details”: null,
            “path”: “rates[5].deliveryMethod.id”,
            “userMessage”: “Metoda dostawy \“Kurier wieczór pobranie\” nie jest już dostępna.”
        },
        {
            “code”: “DEPRECATED_DELIVERY_METHOD”,
            “message”: “Kurier wieczór is deprecated.”,
            “details”: null,
            “path”: “rates[10].deliveryMethod.id”,
            “userMessage”: “Metoda dostawy \“Kurier wieczór\” nie jest już dostępna.”
        }
    ]

GET /order/checkout-forms - filtruj zamówienia według wielu wartości

Od dziś możesz przekazać wiele wartości dla filtrów w GET /order/checkout-forms:

• status zamówienia - np. GET /order/checkout-forms?status=BOUGHT&status=FILLED_IN - zwróci wszystkie zamówienia w statusie BOUGHT i FILLED_IN,
• status realizacji - np. GET /order/checkout-forms?fulfillment.status=NEW&fulfillment.status=PROCESSING - zwróci wszystkie zamówienia, dla których status realizacji to PROCESSING lub NEW.

Więcej informacji o filtrach dla zamówień znajdziesz w naszym poradniku.

Grupowa edycja stawki podatku VAT w ofertach

Umożliwiliśmy grupową edycję stawki podatku VAT w ofertach. Aby ją zmienić skorzystaj z PUT /sale/offer-modification-commands/{commandId} i podczas grupowej zmiany podaj w polu:

• “invoice” - “VAT” jako typ faktury,
• “tax” - wartość stawki podatku VAT. Możesz wprowadzić tylko stawki podatku VAT określone polskim prawem (0%, 5%, 8%, 23%).

Przykładowy request:

curl -X PUT 

  ‘https://api.allegro.pl/sale/offer-modification-commands/{commandId}’ 

  -H ‘Authorization: Bearer {token}’ 

  -H ‘Accept: application/vnd.allegro.public.v1+json’ 

  -H ‘Content-Type: application/vnd.allegro.public.v1+json’ 

  -d ‘{
    “modification”: {
        “payments”: {
            “invoice”: “VAT”,
            “tax”: {
            “percentage”: “23.00”
               }
        },
   },
    “offerCriteria”:[
      {
        “type”:“CONTAINS_OFFERS”,
        “offers”:[
        {
        “id”:“7531636067”
        },
        {
        “id”:“7512439587”
        }
     ]
     }
     ]
  }’

Dzięki zmianie w przyszłości zaprezentujemy kupującym w ofertach stawkę VAT i cenę netto produktu.

Ważne! Pamiętaj, że transakcję z kupującym zawierasz na podstawie ceny brutto. Obecnie cenę netto zwracamy w celach informacyjnych.

20 lipca 2020 włączymy walidację parametrów zależnych

Parametry zależne na tę chwilę udostępniliśmy tylko w jednej kategorii - Klipsy (123428). Jeśli jako wartość parametru głównego (Materiał) wybierzesz:

• “Złoto”, “Złoto białe” lub “Złoto różowe” - będziesz mógł wypełnić parametr “Próba złota”,
• “Srebro”, “Srebro tybetańskie” lub “Srebro pozłacane” - będziesz mógł wypełnić parametr “Próba srebra”.

20 lipca 2020 włączymy walidację parametrów zależnych. Oznacza to, że udostępnimy:

• parametr “Próba złota”, tylko jeśli dla parametru “Materiał” wybierzesz wartość powiązaną ze złotem,
• parametr “Próba srebra”, tylko jeśli dla parametru “Materiał” wybierzesz wartość powiązaną ze srebrem,
• oba parametry, jeśli wybierzesz wartości powiązane zarówno ze złotem, jak i srebrem,
• żaden z tych parametrów, jeśli “Materiał” nie jest powiązany ani ze złotem, ani ze srebrem.

W przypadku, gdy wybierzesz błędny parametr zależny, zwrócimy stosowny błąd, przykładowo:

“Parametr zależny Próba złota nie może przyjąć wartości [999], gdy parametr Materiał ma wartości [Szkło, Stal].”

Więcej informacji o parametrach zależnych znajdziesz w naszym komunikacie.

Sandbox - przerwa techniczna

10.07.2020 o godzinie 9:00 rozpoczniemy przerwę techniczną na środowisku testowym, która potrwa ok. 2 godzin. Przepraszamy za niedogodności.

30.09.2020 wyłączymy metody WebAPI do pobierania publicznych danych o sprzedaży

30.09.2020 wyłączymy następujące metody WebAPI:

• doGetSiteJournal,
• doGetSiteJournalInfo,
• doShowItemInfoExt,
• doGetItemsInfo,
• doGetBidItem2.

Nie udostępnimy odpowiedników tych metod w REST API. Dotychczas dowolny podmiot, np. dowolny sprzedawca mógł pobierać i analizować dane o jakichkolwiek transakcjach zawieranych w serwisie przez każdego innego sprzedawcę. Przede wszystkim ze względu na wrażliwość tych informacji, zdecydowaliśmy się zmienić nasze podejście – od 1 października 2020 roku dane transakcyjne nie będą publicznie dostępne.

Ważne! Każdy sprzedawca na Allegro nadal będzie miał dostęp do danych o swojej sprzedaży - zarówno w narzędziach udostępnianych przez Allegro, jak i w zasobach API Allegro.

Informacje na temat ograniczenia dostępu do wrażliwych danych o transakcjach znajdziesz też na stronie dla sprzedających.

Parametr GTIN w ofertach oraz produktach

Zgodnie z wcześniejszą zapowiedzią dzisiaj udostępniliśmy parametr globalny numer jednostki handlowej tzw. GTIN. W większości kategorii oznaczyliśmy go jako parametr podstawowy, czyli taki, który identyfikuje produkt w ofercie. Jeżeli chcesz określić lub zmienić GTIN, w zależności od kategorii, skorzystaj z dostępnych parametrów:

• EAN (id parametru=225693),
• ISBN (id parametru=245669),
• ISSN (id parametru=245673).

Pamiętaj, że parametry dostępne w danej kategorii sprawdzisz za pomocą GET /sale/categories/{categoryId}/parameters.

GTIN w ofertach

W ofertach parametr GTIN jest nadrzędny wobec pola “ean”, którego wartości przenieśliśmy do nowego parametru. Wartość EAN, ISBN lub ISSN możesz uzupełnić jedynie w parametrze GTIN, aby to zrobić pobierz aktualny stan oferty poprzez GET /sale/offers/{offerId}, a następnie edytuj poprzez PUT /sale/offers/{offerId}. Jeśli spróbujesz zmienić wartość pola “ean” w ofercie, otrzymasz komunikat błędu: “Pole ean jest tylko do odczytu. Wartość z pola ean podaj w parametrze o id: {id}.”

Jeżeli dotychczas w integracji używasz pola “ean” by rozpoznać swoje oferty (jako sygnaturę), wykorzystaj w tym celu dedykowane dla sygnatury pole “external.id”.

GTIN w produktach

Parametr GTIN dla produktów funkcjonuje równolegle z dotychczasową tablicą “eans”. Aktualne wartości “eans” przenieśliśmy do nowego parametru. Zgłaszając propozycję produktu przez POST /sale/product-proposals możesz przekazać wartość EAN, ISBN lub ISSN tylko w parametrze GTIN.

Parametr GTIN zyskał flagę “isGTIN” w strukturze “options” parametrów produktu. Dzięki temu podczas dodawania oferty na podstawie produktu rozpoznasz, że jeśli parametr ma wiele wartości, to możesz przekazać tylko jedną z nich.

Przykładowy request:

curl -X GET 

        ‘https://api.allegro.pl/sale/products/0ca14fc3-7084-4fa2-83da-d04104e8b162’ 

        -H ‘Accept: application/vnd.allegro.public.v1+json’

Przykładowy response:

…
“parameters”: [
{
    “id”: “225693”,
    “name”: “EAN”,
    “valuesLabels”: [
        “0901362561720”
    ],
    “values”: [
        “0901362561720”
    ],
    “unit”: null,
    “options”: {
        “identifiesProduct”: true,
        “isGTIN”: true
    }
}
],
…

Ważne! W przyszłości pole “ean” w ofercie oraz tablicę “eans” w produkcie usuniemy. Wartość GTIN (czyli EAN, ISBN, ISSN) zmienisz tylko korzystając z parametru, dlatego już dzisiaj rozpocznij prace nad ich poprawną obsługą w swojej aplikacji.

POST /sale/product-offers - dodaliśmy obsługę nowych pól, które możesz wysłać w żądaniu

W odpowiedzi na wasze sugestie dodaliśmy trzy nowe pola, które możecie przekazać w strukturze żądania POST /sale/product-offers:

• name - tytuł oferty,
• external.id - sygnatura,
• delivery.additionalInfo - dodatkowe informacje o dostawie.

Więcej informacji na temat zasobu znajdziecie w naszym poradniku - jak jednym requestem wystawić ofertę powiązaną z produktem.

Od 01.08.2020 będziemy wymagać 1% ofert powiązanych z produktem w kategoriach Elektronika, Uroda, Kultura i Rozrywka

Od początku 2019 roku wprowadzamy elementy produktyzacji w serwisie. Grupujemy oferty z tym samym produktem, dzięki czemu klient szybciej znajdzie ofertę, która spełnia jego oczekiwania. Ofertę powiązaną z produktem wyświetlimy także w nowych miejscach - np. na stronach produktu.

Planujemy sproduktyzować cały serwis Allegro do połowy 2021 roku, dlatego od 01.08.2020 będziemy wymagać co najmniej 1% ofert powiązanych z produktem w kategoriach:

• Elektronika,
• Uroda,
• Kultura i Rozrywka.

Jeżeli sprzedawca nie spełni tego wymagania, to w tych kategoriach nie będzie mógł wystawić nowej oferty, jeśli obecnych nie powiąże z produktem.

Więcej o tym, jak powiązać ofertę z produktem, przeczytasz w naszym poradniku. W ostatnim czasie udostępniliśmy także nowy zasób POST /sale/product-offers, dzięki któremu za pomocą jednego żądania wystawisz aktywną ofertę powiązaną z produktem:

• który istnieje już w naszej bazie. Wystarczy, że w żądaniu przekażesz numer EAN (lub identyfikator produktu) oraz cenę i liczbę sztuk;
• którego nie ma w naszej bazie. W strukturze żądania za pomocą kompletu danych opiszesz sprzedawany produkt oraz przekażesz informacje o cenie i liczbie sztuk.

Na stronie dla sprzedających znajdziesz informację o innych korzyściach, które aktualnie sprzedawca uzyska dzięki produktyzacji. W wybranych kategoriach, gdy sprzedawca stworzy nowy produkt w procesie wystawiania lub edycji oferty - zwrócimy mu połowę bazowej prowizji od sprzedaży w ofercie powiązanej z produktem.

Sandbox - przerwa techniczna

17.06.2020 o godzinie 7:00 rozpoczniemy przerwę techniczną na środowisku testowym, która potrwa ok. 2 godzin. Przepraszamy za niedogodności.

Wprowadziliśmy parametry zależne w pierwszej kategorii - Klipsy

Parametry zależne to parametry:

• dla których zbiór dostępnych wartości jest uzależniony od wartości innego parametru. Przykładem może być Model, ponieważ dostępne wartości będą uzależnione od tego, jaką wartość wybierzesz dla parametru Marka, np. jeśli jako Markę wskażesz Nokia, dostępne wartości dla parametru Model zawęzimy do modeli Nokii,
• które będą dostępne w zależności od wyboru wartości innego parametru, np. jeżeli chcesz wystawić Bransoletkę i jako wartość parametru Materiał wybierzesz złoto, pojawi się parametr Próba złota.

Zgodnie z naszą wcześniejszą zapowiedzią wprowadziliśmy parametry zależne w kategorii Klipsy (123428). Jeśli jako wartość parametru głównego (Materiał) wybierzesz:

• “Złoto”, “Złoto białe” lub “Złoto różowe” - parametrem zależnym będzie “Próba złota”,
• “Srebro”, “Srebro tybetańskie” lub “Srebro pozłacane” - parametrem zależnym będzie “Próba srebra”.

Więcej informacji o parametrach zależnych znajdziesz w naszym newsie. O kolejnych dostępnych parametrach zależnych nie będziemy już informować na stronie Allegro API.

Wystaw ofertę charytatywną na Allegro

Od 15.06.2020 wystawisz oferty charytatywne na Allegro. Już dzisiaj wdrożyliśmy nowy zasób GET /charity/fundraising-campaigns, dzięki któremu wyszukasz organizacje charytatywne.

Natomiast w modelu oferty dodaliśmy nowe pole “fundraisingCampaign”. Aby wystawić ofertę charytatywną skorzystaj z POST /sale/offers i w polu “fundraisingCampaign” przekaż identyfikator wybranej organizacji charytatywnej.

Przykładowy request:

curl -X GET 

‘https://api.allegro.pl/charity/fundraising-campaigns?limit=10&phrase=Zbieramy’ 

-H ‘Accept: application/vnd.allegro.public.v1+json’

Przykładowy response:

{
    “campaigns”: [
        {
            “id”: “4ed5aebc-a916-4144-b9e9-45f9408a9fe7”,
            “name”: “Zbieramy na karmę dla zwierząt ze schroniska”,
            “organization”: {
                “name”: “Platforma Charytatywna”
            }
        }
    ]
} 

Lista typów opłat billingowych

Dzisiaj udostępniliśmy zasób GET /billing/billing-types, którym pobierzesz listę typów opłat billingowych. Możesz go wykorzystać do pełnej identyfikacji wartości zwracanych w polu “type.id” dla zasobu GET /billing/billing-entries.

Cena netto i stawka podatku VAT w ofercie

Dzisiaj w modelu oferty udostępniliśmy dwa nowe pola:

• “netPrice” - cena netto, którą obliczamy automatycznie na podstawie stawki podatku VAT. Nie możesz jej zdefiniować samodzielnie.
• “tax” - stawka podatku VAT, możesz ją zdefiniować samodzielnie, gdy w ofercie masz zaznaczoną opcję “faktura VAT”. Obecnie w polu wprowadzisz tylko stawki podatku VAT określone polskim prawem (0%, 5%, 8%, 23%).

Model oferty po zmianie:

…
“sellingMode”: {
    “format”: “BUY_NOW”,
    “price”: {
      “amount”: “2460”,
      “currency”: “PLN”
    },
    “netPrice”: {
        “amount”: “2000”,
        “currency”: “PLN”
      },
    “startingPrice”: null,
    “minimalPrice”: null
  },
 “tax”: {
    “percentage”: “23.00”
  },
…

Dzięki zmianie w przyszłości zaprezentujemy kupującym w ofertach stawkę VAT i cenę netto produktu.

Ważne! Pamiętaj, że transakcję z kupującym zawierasz na podstawie ceny brutto. Obecnie cenę netto zwracamy w celach informacyjnych.

GET /sale/categories/{categoryId}/parameters - dodajemy nowe pola i ułatwiamy wystawianie ofert powiązanych z produktem

Do tej pory, gdy za pomocą POST /sale/product-offers wystawiasz ofertę powiązaną z produktem i chcesz otrzymać dwa różne zbiory dla parametrów ofertowych i produktowych, musisz skorzystać z dwóch osobnych zasobów. Uprościliśmy ten proces - w odpowiedzi dla GET /sale/categories/{categoryId}/parameters dodaliśmy nowe pola:

• options.describesProduct - wartość:
  • true oznacza, że parametr jest produktowy,
  • false oznacza, że parametr jest ofertowy.
  Parametry ofertowe są związane z indywidualną ofertą, np. stan, data ważności, etc., a nie z cechą konkretnego produktu.
• requiredForProduct - wartość true oznacza, że musisz przekazać wartość dla tego parametru, gdy tworzysz propozycję nowego produktu.

Więcej informacji o tym, jak w łatwy sposób wystawić ofertę powiązaną z produktem, znajdziesz w naszym poradniku.

{
     “id”: “10563”,
     “name”: “Marka”,
     “type”: “dictionary”,
     “required”: true,
     “requiredForProduct”: true
     “unit”: null,
     “options”: {
          “variantsAllowed”: false,
          “variantsEqual”: true,
          “ambiguousValueId”: “10563_40”,
          “dependsOnParameterId”: null
          “describesProduct”: true
     },
…
}

Sandbox - 8 czerwca 2020 zaktualizujemy listę kategorii i parametrów oraz usuniemy wszystkie oferty

8 czerwca 2020 zaktualizujemy listę kategorii i parametrów na Sandboxie. Dzięki temu zadbamy o spójność między środowiskiem testowym i produkcyjnym.

Ważne! W związku z aktualizacją usuniemy wszystkie oferty z Sandboxa.

Podobne działania planujemy przeprowadzać raz na kwartał. Będziemy o nich informować z odpowiednim wyprzedzeniem.

Parametr GTIN w ofertach oraz produktach

Od 29.06.2020 udostępnimy parametr globalny numer jednostki handlowej tzw. GTIN. W większości kategorii oznaczymy go jako parametr podstawowy, czyli taki, który identyfikuje produkt w ofercie. Jeżeli chcesz określić lub zmienić GTIN, w zależności od kategorii, skorzystaj z dostępnych parametrów:

• EAN (id parametru=225693),
• ISBN (id parametru=245669),
• ISSN (id parametru=245673).

Pamiętaj, że parametry dostępne w danej kategorii sprawdzisz za pomocą GET /sale/categories/{categoryId}/parameters.

GTIN w ofertach

W ofertach parametr GTIN będzie nadrzędny wobec pola “ean”, którego wartości automatycznie przeniesiemy do nowego parametru. Wartość EAN, ISBN lub ISSN możesz uzupełnić jedynie w parametrze GTIN, aby to zrobić pobierz aktualny stan oferty poprzez GET /sale/offers/{offerId}, a następnie edytuj poprzez PUT /sale/offers/{offerId}. Jeśli spróbujesz zmienić wartość pola “ean” w ofercie, otrzymasz komunikat błędu: “Pole ean jest tylko do odczytu. Wartość z pola ean podaj w parametrze o id: {id}.”

Jeżeli dotychczas w integracji używasz pola “ean” by rozpoznać swoje oferty (jako sygnaturę), wykorzystaj w tym celu dedykowane dla sygnatury pole “external.id”.

GTIN w produktach

Nowy parametr GTIN dla produktów będzie funkcjonować równolegle z dotychczasową tablicą “eans”. Aktualne wartości “eans” przeniesiemy do nowego parametru. Zgłaszając propozycję produktu przez POST /sale/product-proposals możesz przekazać wartość EAN, ISBN lub ISSN tylko w parametrze GTIN.

Parametr GTIN zyska flagę “isGTIN” w strukturze “options” parametrów produktu. Dzięki temu podczas dodawania oferty na podstawie produktu rozpoznasz, że jeśli parametr ma wiele wartości, to możesz przekazać tylko jedną z nich.

Ważne! W przyszłości pole “ean” w ofercie oraz tablicę “eans” w produkcie usuniemy. Wartość GTIN (czyli EAN, ISBN, ISSN) zmienisz tylko korzystając z parametru, dlatego już dzisiaj rozpocznij prace nad ich poprawną obsługą w swojej aplikacji.

Tydzień przed wdrożeniem zmiany udostępnimy na Sandbox kategorię oraz produkt z nowym parametrem GTIN, co pozwoli Wam przetestować jego działanie. O szczegółach poinformujemy w komunikacie na naszym forum.

Zasoby do obsługi zamówień dostępne tylko w wersji public

Od 10.06.2020 zasoby przeznaczone do obsługi zamówień:

• GET /order/checkout-forms,
• GET /order/checkout-forms/{id},
• GET /order/events,
• GET /order/event-stats,
• GET /order/checkout-forms/{id}/shipments,
• POST /order/checkout-forms/{id}/shipments,
• GET /order/line-item-id-mappings

dostępne będą tylko w wersji public. Zmianę z wyprzedzeniem zapowiadaliśmy w komunikacie GitHub #2220.

Wykonaj niezbędną zmianę w swoim oprogramowaniu - aby przejść na nową wersję wystarczy, że w nagłówku ‘accept’ oraz ‘content-type’ wywołania zmienisz wartość:

‘application/vnd.allegro.beta.v1+json’ na ‘application/vnd.allegro.public.v1+json’.

POST /sale/product-offers - dodaliśmy nowe pole ‘status’

POST /sale/product-offers to nowy zasób, dzięki któremu za pomocą jednego żądania wystawisz aktywną ofertę powiązaną z produktem:

• który istnieje już w naszej bazie. Wystarczy, że w żądaniu przekażesz numer EAN (lub identyfikator produktu) oraz cenę i liczbę sztuk,
• którego nie ma w naszej bazie. W strukturze żądania za pomocą kompletu danych opiszesz sprzedawany produkt oraz przekażesz informacje o cenie i liczbie sztuk.

Więcej informacji o tym zasobie znajdziesz w naszym poradniku.

W strukturze odpowiedzi, w ramach danych produktowych, w sekcji publication dodaliśmy nowe pole status, w którym informujemy, czy na podstawie danych z żądania:

• utworzyliśmy nową propozycję produktu i powiązaliśmy z nią ofertę (PROPOSED),

  {
      “product”:{
          “id”: “0cb89863-9bd0-4f92-x364-16ec3908201x”,  – id zgłoszonego produktu
          “publication”: {
              “status”: “PROPOSED”
              },
            }
    …
  }

• zidentyfikowaliśmy produkt w naszej bazie i powiązaliśmy z nim ofertę (LISTED),

  {
      “product”:{
          “id”: “0cb89863-9xd0-4f92-x364-16ec3908201x”,  – id produktu z naszej bazy
              “publication”: {
                  “status”: “LISTED”
        },
      }
    …
  }

• nie utworzyliśmy nowej propozycji produktu i nie powiązaliśmy oferty z żadnym produktem z naszej bazy (NOT_LISTED), jednak wystawiliśmy samą ofertę. Taka sytuacja może nastąpić np. gdy próbujesz utworzyć ofertę i produkt w kategorii, w której nie możesz dodać propozycji nowego produktu,

  {
      “product”:{
          “id”: null
          “publication”: {
              “status”: “NOT_LISTED”
        },
        },
      }
    …
  }

GET /me - dodaliśmy email i NIP w odpowiedzi

W odpowiedzi na wasze sugestie, dodaliśmy dwa nowe pola w odpowiedzi dla GET /me:

• email,
• NIP (‘company.taxId’).

Za pomocą GET /me pobierzesz dane użytkownika, którego token przesyłasz w requeście.

curl -X GET
‘https://api.allegro.pl/me’
-H ‘Accept: application/vnd.allegro.public.v1+json’

{
    “id”: “12345678”,
    “login”: “example_login”,
    “firstName”: “Jan”,
    “lastName”: “Nowak”,
    “email”: “example_login@allegro.pl”,
    “company”: {
        “name”: “Allegro.pl”,
        “taxId”: “525-267-47-98”
    }
}

Produktyzacja - dodaj własną wartość dla parametru z wartością niejednoznaczną, gdy tworzysz nowy produkt

O wartościach niejednoznacznych i o tym, jak możesz dodać własną wartość w wybranych kategoriach, informowaliśmy we wcześniejszym komunikacie. Od dzisiaj możesz zdefiniować własną wartość, również gdy tworzysz nowy produkt za pomocą POST /sale/product-proposals.

Identyfikator wartości niejednoznacznej parametru sprawdzisz za pomocą GET /sale/categories/{categoryId}/parameters w polu ambiguousValueId. Więcej informacji na temat tego pola znajdziesz w naszym komunikacie. Na stronie dla sprzedających znajdziesz aktualną listę parametrów, do których możesz dodać własną wartość.

Podczas, gdy dodajesz produkt, przekaż poniższą strukturę w sekcji parameters, aby dodać własną wartość. Jeżeli w polu valuesIds przekażesz identyfikator wartości niejednoznacznej ambiguousValueId, to uzupełnienie własnej wartości w polu values będzie obowiązkowe.

 {
        “id”: “129033”,                               – id parametru
        “valuesIds”: [
         “129033_13”                                  – id wartości niejednoznacznej
        ],
        “values”: [ “Nazwa brakującej marki” ],       – wartość, którą chcesz przekazać,
                                                      uzupełnij to pole.
        “rangeValue”: null
  }

POST /sale/product-offers - wystaw w prosty sposób ofertę powiązaną z produktem

Aktualnie, jeśli chcesz wystawić ofertę i powiązać ją z produktem, musisz przejść złożony proces, który wymaga wykonania wielu zapytań do różnych zasobów. Dążymy do tego, aby ten proces usprawnić - chcemy ograniczyć liczbę operacji potrzebnych do wystawienia oferty powiązanej z produktem.

W związku z tym udostępniliśmy nowy, dodatkowy zasób POST /sale/product-offers w wersji beta, dzięki któremu za pomocą jednego żądania wystawisz aktywną ofertę powiązaną z produktem:

• który istnieje już w naszej bazie. Wystarczy, że w żądaniu przekażesz numer EAN (lub identyfikator produktu) oraz cenę i liczbę sztuk,
• którego nie ma w naszej bazie. W strukturze żądania za pomocą kompletu danych opiszesz sprzedawany produkt oraz przekażesz informacje o cenie i liczbie sztuk.

Pozostałe dane wymagane do poprawnego wystawienia oferty uzupełnimy wartościami domyślnymi.

Więcej informacji na temat nowego zasobu znajdziesz w naszym poradniku.

W przyszłości, gdy skorzystasz z tego zasobu, w twoich ofertach zaprezentujemy najbardziej aktualne dane z naszego katalogu produktów. Gdy zaktualizujemy dane produktu w katalogu, nie będzie konieczne kopiowanie czy akceptowanie zmian w ofercie, jeśli nie przekażesz własnych wartości. Pozwoli to nam także automatycznie uzupełnić parametry, których aktualnie wymagamy przy edycji oferty.

Zamówienia - nowe pole “revision”

Udostępniliśmy dziś nowe pole “revision” dla zasobów:

• GET /order/events,
• GET /order/checkout-forms,
• GET /order/checkout-forms/{id}.

Zwracamy w nim informację o wersji zamówienia. Dzięki niemu będziesz pewien, że zmieniasz status realizacji zamówienia (“fulfillment.status”) w zamówieniu, którego dokładnie ta sama kopia znajduje się w Allegro. Wartość pola “revision” zmienia się w momencie, kiedy kupujący wykona zmianę, która ma wpływ na dane zamówienia (np. zmiana statusu zamówienia, płatności, danych adresowych, danych do faktury, itp.).