Allegro REST API

gdzie?

Polska | polski | PLN
  • Pierwsze kroki
  • Informacje podstawowe
  • Główne procesy
  • Uwierzytelnianie i autoryzacja
  • Wzorzec Command
  • Glosariusz
  • Lista metod
  • Wystawianie oferty produktu
  • Serwisy zagraniczne Allegro
  • Zarządzanie ofertami
  • Oferty wielowariantowe
  • Pasuje do
  • Zarządzanie zgłoszeniami ofert do kampanii
  • Rabaty i promocje
  • Zamówienia
  • Wysyłam z Allegro
  • One Fulfillment by Allegro
  • Dyskusje
  • Konto i dane użytkownika
  • Centrum wiadomości
  • Sprawdzanie opłat
  • Wystawianie ogłoszeń
  • Publiczne oferty
FAQ
  • Aktualności
  • Changelog
Dokumentacja
Regulamin
Kontakt
  • Moje aplikacje
  • Moje aplikacje (sandbox)
  • Newsletter
  • API Status
  1. Allegro REST API
  2. Aktualności
  3. GET /sale/offer-additional-services/categories - nowy zasób do zarządzania usługami dodatkowymi

06 lutego 2023

GET /sale/offer-additional-services/categories - nowy zasób do zarządzania usługami dodatkowymi

Udostępniliśmy dziś nowy zasób GET /sale/offer-additional-services/categories, dzięki któremu pobierzesz dostępne usługi dodatkowe z podziałem na kategorie. W przyszłości endpoint zwróci także listę specjalistycznych usług dodatkowych dla ofert przesyłek ciężkich i ponadwymiarowych.

Przykładowy request:

curl -X GET \
'https://api.allegro.pl/sale/offer-additional-services/categories’ \
-H 'Authorization: Bearer {token}' \
-H 'Accept: application/vnd.allegro.public.v1+json' 

Przykładowy response:

{
    "categories": [
        {
            "name": "Usługi wykonywane przed wysyłką",   - kategoria usług dodatkowych
            "definitions": [
              {
                    "id": "GIFT_WRAP",                   - identyfikator usługi dodatkowej
                    "name": "Zapakuj na prezent",        - nazwa usługi dodatkowej
                    "description": {                     - opis usługi
                        "hint": "Opisz, jak zapakujesz towar na prezent, jakiego użyjesz 
                         papieru, wstążki, czy dodasz liścik, itd.",
                        "editable": true,
                        "default": null
                    },
                    "maxPrice": {                        - maksymalna cena usługi
                        "amount": "123.45",
                        "currency": "PLN"
                    },
                    "availableConstraints": [            - dostępne ograniczenia
                      {
                        "type": "COUNTRY_SAME_QUANTITY",
                        "availableDeliveryMethods": null
                      }
                    ]
              }
            ]
        },
        {
            "name": "Usługi wniesienia",
            "definitions": [
              {
                    "id": "CARRY_IN",
                    "name": "Wniesienie",
                    "description": {
                        "hint": "Opisz, na co powinien przygotować się kupujący i czy są 
                         jakieś ograniczenia, np. piętro, do którego dostarczasz przesyłkę.",
                        "editable": true,
                        "default": null
                    },
                    "maxPrice": {
                        "amount": "123.45",
                        "currency": "PLN"
                    },
                    "availableConstraints": [
                      {
                        "type": "COUNTRY_DELIVERY_SAME_QUANTITY",
                        "availableDeliveryMethods": [
                            "7203cb90-864c-4cda-bf08-dc883f0c78ad",
                            "259b5c7a-9056-4c74-80ec-9bb2978cf293"
                        ]
                      }
                    ]
              },
              {
                    "id": "CARRY_IN_AND_SETUP",
                    "name": "Wniesienie i ustawienie",
                    "description": {
                        "hint": "Opisz, na co powinien przygotować się kupujący i czy są jakieś ograniczenia, 
                         np. piętro, do którego dostarczasz przesyłkę.",
                        "editable": true,
                        "default": null
                    },
                    "maxPrice": {
                        "amount": "123.45",
                        "currency": "PLN"
                    },
                    "availableConstraints": [
                      {
                        "type": "COUNTRY_DELIVERY_SAME_QUANTITY",
                        "availableDeliveryMethods": [
                            "7203cb90-864c-4cda-bf08-dc883f0c78ad",
                            "259b5c7a-9056-4c74-80ec-9bb2978cf293"
                        ]
                      }
                    ]
              }
            ]
        },
        {
            "name": "Usługi montażu specjalistycznego",
            "definitions": [
              {
                    "id": "FRIDGE_CARRY_IN_AND_SETUP_DOORS_DIRECTION",
                    "name": "Wniesienie i montaż lodówki, zmiana kierunku drzwi",
                    "description": {
                        "hint": null,
                        "editable": false,
                        "default": "Wniesienie maksymalnie na 4 piętro schodami lub dowolne piętro windą. 
                         Demontaż i zabranie zużytego sprzętu  (takiego jak zakupiony np. lodówka za lodówkę). 
                         Montaż zakupionego sprzętu, ustawienie, wyrzucenie opakowań, sprzęt gotowy do użytku."
                    },
                    "maxPrice": {
                        "amount": "123.45",
                        "currency": "PLN"
                    },
                    "infoUrl": "https://allegro.pl/pomoc/dla-sprzedajacych/wystawianie-i-edycja-oferty/wniesienie-montaz-i-inne-uslugi-dodatkowe-w-ofertach-xG71gnKLDCG",
                    "availableConstraints": [
                      {
                        "type": "COUNTRY_DELIVERY_SAME_QUANTITY",
                        "availableDeliveryMethods": [
                            "7203cb90-864c-4cda-bf08-dc883f0c78ad",
                            "259b5c7a-9056-4c74-80ec-9bb2978cf293"
                        ]
                      }
                    ]
              }
            ]
        }
    ]
}

Jednocześnie, dotychczasowy zasób GET /sale/offer-additional-services/definitions zwracający tylko listę usług dodatkowych oznaczyliśmy jako Deprecated. W dniu 06.04.2023 całkowicie go usuniemy.

Więcej informacji o usługach dodatkowych znajdziesz w naszym poradniku.

Allegro

Serwisy Grupy Allegro

  • Allegro.cz
  • Allegro.sk
  • Allegro.hu
  • Mall.hr
  • Mimovrste.com
  • Onedelivery.cz
zamknij

Dostosuj ustawienia wyświetlania

ustawienia dotyczą tylko tej przeglądarki