Promocyjne zestawy ofert

18 października 2017

Udostępniliśmy naszym sprzedającym promocyjne zestawy ofert. Dzięki temu sprzedawca może sprzedawać w obniżonej cenie zestaw kilku ofert.

Dla promocyjnych zestawów produktowych przygotowaliśmy nowe zasoby w REST API Allegro:

POST /sale/loyalty/promotions - chcę utworzyć nowy promocyjny zestaw.
GET /sale/loyalty/promotions?user.id={Seller_ID} - chcę pobrać listę promocji.
GET /sale/loyalty/promotions/{promotionId} - chcę pobrać informacje o danej promocji.
DELETE /sale/loyalty/promotions/{promotionId} - chcę usunąć daną promocję.

POST /sale/loyalty/promotions

To zasób, którym dodasz nowy promocyjny zestaw, jako zalogowany sprzedawca.

UWAGA!

Zestaw możesz utworzyć z co najmniej 2 ofert.
Zestaw możesz utworzyć z maksymalnie 9 ofert.
Do jednej oferty dodasz do 7 zestawów.

Przykładowy request:

curl -X POST
'https://api.allegro.pl/sale/loyalty/promotions'
-H 'Accept: application/vnd.allegro.public.v1+json' \
-H 'Content-Type: application/vnd.allegro.public.v1+json'  \
-H "Authorization: Bearer {token}" \
{
    "benefits": [{                                 -- wymagane, określa jakie benefity otrzyma kupujący
        "specification": {
            "type": "ORDER_FIXED_DISCOUNT",       -- wymagane, obecnie dostępna jest jedna wartość
                                                   ORDER_FIXED_DISCOUNT (określa kwotę, o jaką chcesz 
                                                   obniżyć wartość zestawu. Na tej podstawie 
                                                   wyliczymy jego cenę.)
            "value": {                             -- wymagane, podaj o ile chcesz obniżyć wartość 
                                                   zestawu. Na tej podstawie wyliczymy jego cenę.
                "amount": "10",                 
                "currency": "PLN"
            }
        }
    }],
    "offerCriteria": [{                            -- wymagane, tablica ofert w zestawie
        "type": "CONTAINS_OFFERS",                 -- wymagane, obecnie dostępna jest jedna wartość
                                                   CONTAINS_OFFERS (określa jakie oferty wchodzą
                                                   w skład zestawu)
        "offers": [{                               -- wymagane, oferty, które wchodzą w skład zestawu
            "id": "6966354299",                    -- wymagane, identyfikator oferty
            "quantity": 2,                         -- wymagane, iliczba sztuk danej oferty w zestawie
            "promotionEntryPoint": true            -- wymagane, określ, czy na stronie tej oferty mamy 
                                                   wyświetlać zestawy promocyjne.
        }, {
            "id": "6966344380",
            "quantity": 1,
            "promotionEntryPoint": false                
        }]
    }]
}

Przykładowy response:

{
    "id": "02fe997e-9973-419a-b8ea-a409222e27a5",   -- identyfikator utworzonego zestawu
                                                       promocyjnego. Użyj go w zasobach GET, 
                                                       PUT i DELETE - jako {promotionId} 
    "benefits": [{
        "specification": {
            "type": "ORDER_FIXED_DISCOUNT",
            "value": {
                "amount": "10", 
                "currency": "PLN"
            }
        }
    }],
    "offerCriteria": [{
        "type": "CONTAINS_OFFERS",
        "offers": [{
            "id": "6966354299",
            "quantity": 2,
            "promotionEntryPoint": true
        }, {
            "id": "6966344380",
            "quantity": 1,
            "promotionEntryPoint": false
        }]
    }]
}

GET /sale/loyalty/promotions?user.id={Seller_ID}

Używając tego zasobu, pobierzesz informacje o swoich promocjach. Jako {Seller_ID} użyj swojego identyfikatora użytkownika. Musisz być zalogowany jako użytkownik Allegro.

Przykładowy request:

curl -X GET
'https://api.allegro.pl/sale/loyalty/promotions?user.id={userId}'
-H 'Accept: application/vnd.allegro.public.v1+json' \
-H 'Content-Type: application/vnd.allegro.public.v1+json' \
-H 'Authorization: Bearer {token}'

Przykładowy response:

{
    "id": "02fe997e-9973-419a-b8ea-a409222e27a5",
    "benefits": [{
        "specification": {
            "type": "ORDER_FIXED_DISCOUNT",
            "value": {
                "amount": "10", 
                "currency": "PLN"
            }
        }
    }],
    "offerCriteria": [{
        "type": "CONTAINS_OFFERS",
        "offers": [{
            "id": "6966354299",
            "quantity": 2,
            "promotionEntryPoint": true
        }, {
            "id": "6966344380",
            "quantity": 1,
            "promotionEntryPoint": false
        }]
    }]
}

GET /sale/loyalty/promotions/{promotionId}

Pod tym zasobem znajdziesz informacje o konkretnej promocji. Musisz być zalogowany jako użytkownik Allegro.

Przykładowy request:

curl -X GET
'https://api.allegro.pl/sale/loyalty/promotions/{promotionId}'
-H 'Accept: application/vnd.allegro.public.v1+json' \
-H 'Content-Type: application/vnd.allegro.public.v1+json' \
-H 'Authorization: Bearer {token}' \

Przykładowy response:

{
    "id": "02fe997e-9973-419a-b8ea-a409222e27a5",
    "benefits": [{
        "specification": {
            "type": "ORDER_FIXED_DISCOUNT",
            "value": {
                "amount": "10", 
                "currency": "PLN"
            }
        }
    }],
    "offerCriteria": [{
        "type": "CONTAINS_OFFERS",
        "offers": [{
            "id": "6966354299",
            "quantity": 2,
            "promotionEntryPoint": true
        }, {
            "id": "6966344380",
            "quantity": 1,
            "promotionEntryPoint": false
        }]
    }]
}

DELETE /sale/loyalty/promotions/{promotionId}

Używając tego zasobu możesz usunąć daną promocję. Aby usunąć dane, musisz być uwierzytelniony jako sprzedawca.

Przykładowy request:

curl -X DELETE
'https://api.allegro.pl/sale/loyalty/promotions/{promotionId}'
-H 'Content-Type: application/vnd.allegro.public.v1+json' \
-H 'Authorization: Bearer {token}' \

Przykładowy response:

>
status 204 No Content

18 października 2017