20 sierpnia 2025
1 października 2025 dostosujemy Allegro API do rozporządzenia o systemie kaucyjnym
1 października 2025 roku w Polsce wejdzie w życie nowe rozporządzenie UE, które wprowadza ogólnopolski system kaucji za opakowania po napojach.
Nowe obowiązki obejmą wszystkich przedsiębiorców w Polsce, którzy sprzedają napoje w opakowaniach objętych kaucją. Będą to:
- jednorazowe butelki z tworzyw sztucznych do 3 litrów,
- puszki metalowe do 1 litra,
- szklane butelki wielorazowego użytku do 1,5 litra.
Co zmienimy w publicznym API?
- Od dzisiaj skorzystasz z nowego zasobu GET /deposit/types, za pomocą którego pobierzesz wszystkie dostępne kaucje.
Przykładowy request:
curl -X GET \
'https://api.allegro.pl/deposit/types’ \
-H 'Authorization: Bearer {token}' \
-H 'Accept: application/vnd.allegro.public.v1+json' \Przykładowy fragment odpowiedzi:
{
"deposits": [
{
"id": "5e8a9e73-7e55-4896-bd8a-9c430413e808", // identyfikator kaucji
"name": "Reusable glass bottles up to 1.5 liters", // nazwa kaucji
"marketplaceId": "allegro-pl", // serwis allegro, do którego przypisana jest kaucja
"price": {
"amount": "0.5", // wartość kaucji
"currency": "PLN" // waluta kaucji
}
}
]
}Od 1 października 2025 wprowadzimy następujące zmiany:
dla POST /sale/product-offers udostępnimy nowy obiekt "deposits", gdzie podczas tworzenia nowej oferty wskażesz:
- “id” - identyfikator kaucji, który pobierzesz za pomocą GET /deposit/types,
- “quantity” - liczbę sztuk, dla których zostanie pobrana kaucja.
Dane zwrócimy również w odpowiedzi, gdy skorzystasz z GET /sale/product-offers/{offerId}.
Przykładowy request i response:
{
"productSet": [
{
"product": {},
"quantity": {},
"responsiblePerson": {},
"responsibleProducer": {},
"safetyInformation": {},
"marketedBeforeGPSRObligation": true,
"deposits": [
{
"id": "5f4fbc9d-f7f2-46cc-8db9-ec52623f5627", // identyfikator kaucji, który pobierzesz za pomocą GET /deposit/types,
"quantity": 5 // liczba sztuk, dla których zostanie pobrana kaucja
},
{
"id": "cac2139b-98f8-45f6-87b0-6d7915e4a2b4",
"quantity": 12
}
]
}
]
}dla zasobów do zarządzania zamówieniami:
zwrócimy nowe pola “deposit.price.amount” i “deposit.price.currency”, w których zwrócimy wartość i walutę kaucji.
Przykładowy fragment odpowiedzi:
"lineItems"[
...
"deposit": { - kaucja
"price": {
"amount": "123.45", // wartość kaucji; jest ona pobierana za daną ofertę, jeśli jednak oferta składa się z wielu produktów z różnymi kaucjami, wartość w tym polu jest sumą tych kaucji
"currency": "PLN" // waluta kaucji
}
},
...
]- dla POST /payments/refunds udostępnimy nowy obiekt "deposits", gdzie zrealizujesz zwrot kaucji dla klienta za wskazany identyfikator grupy przedmiotów wchodzących w skład zamówienia.
Przykładowy request:
"lineItems": [{
"id": "09f0b4cc-7880-11e9-8f9e-2a86e4085a59",
"type": "QUANTITY",
"quantity": 5,
"value": null
}],
"deposits": [{
"lineItemId": "09f0b4cc-7880-11e9-8f9e-2a86e4085a59", // identyfikator grupy przedmiotów wchodzących w skład zamówienia, które pobierzesz za pomocą GET /order/checkout-forms, lub GET /order/checkout-forms/{id},
"totalValue": { // łączna suma kaucji
"amount": 20, // wartość kaucji
"currency": "PLN" // waluta kaucji
}}
]Dane dotyczące zwrotu zwrócimy również w odpowiedzi, gdy skorzystasz z GET /payments/refunds.
Więcej informacji na temat systemu kaucyjnego w Allegro, znajdziesz na stronie “Dla sprzedających”.
