20 listopada 2020
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.
