15 marca 2021
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:
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.
