09 listopada 2017
Grupowa edycja ofert
Udostępniliśmy nowe zasoby do grupowej edycji ofert. Obecnie zasób pozwala na grupowe przypisanie usług dodatkowych. Usługami dodatkowymi są np.: zapakowanie na prezent, wniesienie, montaż itp.
W przyszłości udostępnimy więcej możliwości w tym zasobie, o wszystkich zmianach dotyczących REST API Allegro informujemy tutaj.
Dla grupowej edycji ofert przygotowaliśmy nowe zasoby w Allegro REST API
- PUT /sale/offer-modification-commands/{commandId} - chcę wyedytować wiele ofert jednocześnie.
- GET /sale/offer-modification-commands/{commandId} - chcę się dowiedzieć przy ilu ofertach edycja zakończyła się sukcesem.
- GET /sale/offer-modification-commands/{commandId}/tasks - chcę otrzymać szczegółowy raport dla danej edycji ofert.
PUT /sale/offer-modification-commands/{commandId}
To zasób którym wyedytujesz wiele ofert na raz, m.in. przypiszesz grupę usług dodatkowych do wielu ofert jednocześnie. Musisz być zalogowany jako sprzedawca, który wystawił te oferty.
Przykładowy request:
curl -X PUT \
'https://api.allegro.pl/sale/offer-modification-commands/{commandId}'
-H 'authorization: Bearer {token}' \
-H 'content-type: application/vnd.allegro.public.v1+json' \
-H 'accept: application/vnd.allegro.public.v1+json’ \
{
"modification": {
"additionalServicesGroup": { -- wymagane, obecnie dostępna jest jedna
wartość additionalServicesGroup
(określa grupę usług dodatkowych
jaką chcesz przypisać do ofert)
"id": "240e22a8-9e57-4fc2-b386-8b5ac1aeaa34" -- wymagane, identyfikator
grupy usług dodatkowych, pobierzesz
go przy pomocy metody
[GET /sale/offer-additional-services/groups](https://developer.allegro.pl/documentation/#operation/get_sale_offer_additional_services_groups)
}
},
"offerCriteria": [
{
"type": "CONTAINS_OFFERS", -- wymagane, obecnie dostępna jest jedna
wartość CONTAINS_OFFERS (określa
oferty, które zostaną wyedytowane)
"offers": [
{
"id": "23434534535345" -- wymagane, identyfikator
edytowanej oferty
}
]
}
]
}
Przykładowy response:
{
"id": "30354f98-6788-4db6-83c4-1e7e404dc137", -- {commandId}
"taskCount": {
"total": 1, -- ogólna liczba ofert z zaplanowaną
zmianą
"success": 0, -- ogólna liczba ofert przy których
zmiany są wprowadzone
"failed": 0 -- ogólna liczba ofert przy których
zmiany nie są wprowadzone
}
GET /sale/offer-modification-commands/{commandId}
Przy pomocy tego zasobu dowiesz się ile ofert było objętych edycją w ramach jednego {commandId}. Otrzymasz również zestawienie, przy ilu ofertach edycja przebiegła pomyślnie, a przy ilu zakończyła się niepowodzeniem. Musisz być zalogowany jako sprzedawca, który wystawił te oferty.
Przykładowy request:
curl -X GET \
'https://api.allegro.pl/sale/offer-modification-commands/{commandId}'
-H 'authorization: Bearer {token}' \
-H 'accept: application/vnd.allegro.public.v1+json’ \
Przykładowy response:
{
"id": "30354f98-6788-4db6-83c4-1e7e404dc137",
"taskCount": {
"total": 1, -- ogólna liczba ofert z zaplanowaną
zmianą
"success": 0, -- ogólna liczba ofert przy których
zmiany zostały wprowadzone
"failed": 0 -- ogólna liczba ofert przy których
zmiany nie zostały wprowadzone
}
GET /sale/offer-modification-commands/{commandId}/tasks
Tym zasobem pobierzesz szczegółowe zestawienie zmian w wielu ofertach dla danego {commandId}. Musisz być zalogowany jako sprzedawca, który wystawił te oferty.
Przykładowy request:
curl -X GET \
'https://api.allegro.pl/sale/offer-modification-commands/{commandId}/tasks'
-H 'authorization: Bearer {token}' \
-H 'accept: application/vnd.allegro.public.v1+json’ \
Przykładowy response:
{
"tasks": [
{
"offer": {
"id": "6985984214" -- identyfikator oferty
},
"message": "",
"status": "SUCCESS", -- status zadania
"scheduledAt": "2017-11-07T14:13:30.032+01:00",
"finishedAt": "2017-11-07T14:13:31.334+01:00",
"field": "additionalServicesGroup" -- typ zmian, obecnie
dostępna jest jedna wartość
additionalServicesGroup
(przypisanie grupy usług
dodatkowych do ofert)
},
{
"offer": {
"id": "6986014228"
},
"message": "",
"status": "SUCCESS",
"scheduledAt": "2017-11-07T14:13:30.043+01:00",
"finishedAt": "2017-11-07T14:13:31.356+01:00",
"field": "additionalServicesGroup"
}
]
}
