Jak wystawić ofertę w Allegro REST API

Skorzystaj z metod pomocniczych, dzięki którym pobierzesz ID elementów. Przekażesz je później, aby zbudować nową ofertę. Takich jak:

Najpierw metodą GET na zasobie /sale/delivery-methods pobierz identyfikatory i nazwy metod dostawy, które są dostępne w Allegro. Wykorzystasz je, gdy będziesz tworzyć nowy cennik dostawy.

Przykładowy request:

curl -X GET \
https://api.allegro.pl/sale/delivery-methods \
-H 'Authorization: Bearer {token}' \
-H 'accept: application/vnd.allegro.beta.v1+json'
        

Przykładowy response:

{"deliveryMethods": [{
"id": "7203cb90-864c-4cda-bf08-dc883f0c78ad",   -- ogólny identyfikator danej metody dostawy
"name": "Przesyłka kurierska"                   -- ogólna nazwa danej metody dostawy
},{
"id": "758fcd59-fbfa-4453-ae07-4800d72c2ca5",
"name": "List polecony priorytetowy"
},
.
.
.
{
"id": "1fa56f79-4b6a-4821-a6f2-ca9c16d5c925",
"name": "Inny sposób dostawy"
}]}

Teraz metodą POST na zasobie /sale/shipping-rates/ możesz utworzyć Cennik dostawy. Jego identyfikator użyjesz, gdy będziesz tworzyć ofertę.

Ważne! Na jednym koncie możesz mieć maksymalnie 250 cenników dostawy.

Przykładowy request:

curl -X POST \
  https://api.allegro.pl/sale/shipping-rates \
  -H 'Accept: application/vnd.allegro.public.v1+json' \
  -H 'Authorization: {token}' \
  -H 'content-type: application/vnd.allegro.public.v1+json' \
  -d '{
    "name": "Nowy cennik dostawy",                              -- wymagane, nazwa 
                                                                danego cennika dostaw
    "rates": [
        {
            "deliveryMethod": {
                "id": "2488f7b7-5d1c-4d65-b85c-4cbcf253fd93"    -- wymagane, identyfikator 
                                                                danej metody dostawy
            },
            "maxQuantityPerPackage": 1,                         -- wymagane, liczba w paczce
            "firstItemRate": {                                  -- wymagane, cena przesyłki
                "amount": "7.99",
                "currency": "PLN"
            },
            "nextItemRate": {                                   -- wymagane, cena 
                                                                kolejnej sztuki
                "amount": "0.00",
                "currency": "PLN"
            },
            "shippingTime": {                                   -- wymagane, czas dostawy, 
                "from": "PT72H",                                podaj wielokrotność 24H, 
                "to": "PT120H"                                  zgodnie z formatem ISO 8601
            }
        },
        {
            "deliveryMethod": {
                "id": "845efe05-0c96-47c3-a8cb-aa4699c158ce"
            },
            "maxQuantityPerPackage": 10,
            "firstItemRate": {
                "amount": "12.58",
                "currency": "PLN"
            },
            "nextItemRate": {
                "amount": "12.58",
                "currency": "PLN"
            },
            "shippingTime": null
        }
    ]
}'

Przykładowy response:

{
     "id": "73491425-dea3-420b-b2bb-680310d764e4",
    "name": "Nowy cennik dostawy",                              
    "rates": [
        {
            "deliveryMethod": {
                "id": "2488f7b7-5d1c-4d65-b85c-4cbcf253fd93"
            },
            "maxQuantityPerPackage": 1,
            "firstItemRate": {
                "amount": "7.99",
                "currency": "PLN"
            },
            "nextItemRate": {
                "amount": "0.00",
                "currency": "PLN"
            },
            "shippingTime": {
                "from": "PT72H",
                "to": "PT120H"
            }
        },
        {
            "deliveryMethod": {
                "id": "845efe05-0c96-47c3-a8cb-aa4699c158ce"
            },
            "maxQuantityPerPackage": 10,
            "firstItemRate": {
                "amount": "12.58",
                "currency": "PLN"
            },
            "nextItemRate": {
                "amount": "12.58",
                "currency": "PLN"
            },
            "shippingTime": null
        }
    ],
    "lastModified": "2018-04-03T13:46:54.722Z"
}

Jeśli sprzedawca utworzył już Cenniki dostawy - ich listę możesz pobrać metodą GET na zasobie /sale/shipping-rates?seller.id={Seller_ID}. Wykorzytaj identyfikator danego cennika dostaw, gdy wystawiasz ofertę.

Przykładowy request:

curl -X GET \
'https://api.allegro.pl/sale/shipping-rates?seller.id={Seller_ID}' \
-H 'Accept: application/vnd.allegro.beta.v1+json' \
-H 'Authorization: Bearer {token}' \
-H 'content-type: application/vnd.allegro.beta.v1+json'
        

Przykładowy response:

{
"shippingRates":[
{
"id": "fde5853c-01ce-4991-a4b3-994c1a4a408e",   -- identyfikator 
                                                danego cennika dostaw
"name": "Cennik dostawy dla elektroniki"         -- nazwa 
                                                danego cennika dostaw
},
{
"id": "64d7218b-cb3b-448a-9cdd-760a1eb76eb8",
"name": "Cennik dostawy dla małegro AGD"
},
{
"id": "41b8e54f-dddd-4e48-ab17-dd941ade2116",
"name": "Cennik dostawy dla promocji świątecznej"
}
            ]
}

Szczegóły danego cennika sprawdzisz metodą GET na zasobie /sale/shipping-rates/{shippingRatesId}.

Przykładowy request:

curl -X GET \
https://api.allegro.pl/sale/shipping-rates/fde5853c-01ce-4991-a4b3-994c1a4a408e\
-H 'Accept: application/vnd.allegro.beta.v1+json' \
-H 'Authorization: Bearer {token}' \
-H 'content-type: application/vnd.allegro.beta.v1+json'
        

Przykładowy response:

{
"id": "fde5853c-01ce-4991-a4b3-994c1a4a408e",                   -- identyfikator 
                                                                danego cennika dostaw
"name": "Cennik dostawy dla elektroniki",                        -- nazwa 
                                                                danego cennika dostaw
{
    "id": "ed1645ab-0895-4010-bd85-bb5d92ab0d83",
    "name": "Cennik dostawy test API 1",
    "rates": [
        {
            "deliveryMethod": {
                "id": "9081532b-5ad3-467d-80bc-9252982e9dd8"    -- identyfikator 
                                                                danej metody dostawy
            },
            "maxQuantityPerPackage": 1,                         -- liczba w paczce
            "firstItemRate": {                                  -- cena przesyłki
                "amount": "10.95",
                "currency": "PLN"
            },
            "nextItemRate": {                                   -- cena kolejnej sztuki
                "amount": "0.00",
                "currency": "PLN"
            },
            "shippingTime": {                                   -- czas dostawy, 
                "from": "PT72H",                                wielokrotność 24H, 
                "to": "PT120H"                                  zgodnie z formatem ISO 8601
            }                               

        },
        {
            "deliveryMethod": {
                "id": "574d1c9e-9903-4626-903f-f72441d520d5"
            },
            "maxQuantityPerPackage": 1,
            "firstItemRate": {
                "amount": "8.60",
                "currency": "PLN"
            },
            "nextItemRate": {
                "amount": "0.00",
                "currency": "PLN"
            },
            "shippingTime": null
        }
    ],
    "lastModified": "2018-08-08T08:24:56.086Z"                  -- data ostatniej 
                                                                modyfikacji danego cennika
}

W tym artykule opisaliśmy szczegółowo, jak zarządzać cennikami dostawy na koncie sprzedawcy i w jego ofertach.

Pobierzesz je przy pomocy metod:

• GET /after-sales-service-conditions/warranties?seller.id={Seller_ID} - informacje o gwarancjach
• GET /after-sales-service-conditions/implied-warranties?seller.id={Seller_ID} - warunki reklamacji
• GET /after-sales-service-conditions/return-policies?seller.id={Seller_ID} - polityka zwrotów

Pobierzesz go przy pomocy metody:

GET na zasobie /sale/offer-additional-services/groups?user.id={Seller_ID}

Pobierzesz je przy pomocy metod:

• GET na zasobie /sale/size-tables?user.id={Seller_ID} - pobierzesz wszystkie tabele z konta
• GET /sale/size-tables/{table_Id} - pobierzesz wybraną tabelę z konta

Pobierzesz go przy pomocy metody:

GET na zasobie /sale/offer-contacts?seller.id={Seller_ID}

Skorzystaj z poniższych zasobów, dzięki którym pobierzesz identyfikator wybranej kategorii i parametry, jakie powinieneś uzupełnić:

Chcesz wystawić ofertę - pobierzesz ją za pomocą metody: GET na zasobie /sale/categories?parent.id={categoryId}. Tym zasobem pobierzesz listę kategorii, które należą do podanej kategorii nadrzędnej (lub listę kategorii głównych). Pamiętaj, że ofertę wystawisz tylko w kategorii najniższego rzędu, która jest oznaczona "leaf": true.

WAŻNE! Jeśli wywołasz metodę GET na zasobie /sale/categories bez podania kategorii, wówczas otrzymasz identyfikatory głównych kategorii na Allegro. Takie identyfikatory możesz następnie użyć w wywołaniu zasobu, aby dotrzeć do interesującej kategorii najniższego rzędu (pamiętaj, że ofertę wystawisz tylko w kategorii najniższego rzędu, która jest oznaczona "leaf": true.).

Przykładowy request:

curl -X GET \
  'https://api.allegro.pl/sale/categories?parent.id={categoryId} 
  -H 'Accept: application/vnd.allegro.beta.v1+json’ \
  -H 'Authorization: Bearer {token}' \

Przykładowy response

{
    "categories":[
        {
            "id": "348",                             -- identyfikator kategorii
            "name": "Akcesoria GSM",                 -- nazwa kategorii
            "parent": {                              -- identyfikator kategorii nadrzędnej 
                                                     dla kategorii głównych parent, ma wartość null
                "id": "4"
            },
            "leaf": false,                           -- informacja, czy dana kategoria jest
                                                     kategorią najniższego rzędu, dostępne są 
                                                    dwie wartości: false (nie jest) i true (jest)
            "options": {                             -- cechy kategorii
                "advertisement": false,              -- informacja, czy w danej kategorii
                                                     lub jej podkategoriach można wystawić ofertę 
                                                     ogłoszeniową. Dostępne są dwie wartości: 
                                                     false (nie jest) i true (jest)
                "advertisementPriceOptional": false  -- informacja, czy w danej
                                                     kategorii ogłoszeniowej cena oferty jest 
                                                     opcjonalna. Dostępne są dwie wartości: 
                                                     true (cenę można pominąć), 
                                                     false (cena oferty musi być podana).
            }
        }
    ]
}

Pobierzesz przy pomocy metody: GET na zasobie /sale/categories/{categoryId}/parameters.

Tym zasobem pobierzesz listy parametrów, które są dostępne w kategorii, którą wskazałeś. Każdorazowo zwracamy listę parametrów, które możesz ustawić w kategorii jaką podałeś na wejściu.

Przykładowy request:

curl -X GET \
  'https://api.allegro.pl/sale/categories/{catId}/parameters
  -H 'Accept: application/vnd.allegro.beta.v1+json’ \
  -H 'Authorization: Bearer {token}' \

Przykładowy response

{
    "parameters": [                         -- lista dostępnych parametrów dla
                                               wskazanej kategorii
{
            "id": "11323",                  -- unikalny identyfikator danego parametru
        "name": "Stan",                     -- nazwa parametru
        “type": “dictionary”,               -- typ parametru, obecnie mamy dostępne wartości: 
                                            dictionary (słownik wyboru, może być jednokrotnego, 
                                            bądź wielokrotnego wyboru, w zależności od wartości 
                                            w polu multipleChoices), integer (liczba całkowita), 
                                            float (liczby zmiennoprzecinkowe).
        "required":true,                    -- informacja, czy dany parametr jest obowiązkowy, 
                                            dostępne są dwie wartości: true (tak) i false (nie)
 "unit": null,
            "dictionary": [
                {
                    "id": "11323_1",
                    "value": "Nowy"
                },
                {
                    "id": "11323_2",
                    "value": "Używany"
                }
            ],
        "restrictions": {                   
        "multipleChoices": false            -- parametr z możliwym wyborem jednej lub 
                                            wielu wartości, dostępne są dwie wartości: 
                                            true (tak) i false (nie)
        }
    },
        {
            "id": "211966",
            "name": "Zakres regulacji wysokości koszenia (cm)",
            "type": "float",
            "required": false,
            "unit": null,
            "restrictions": {
                "min": 0,
                "max": 1000,
                "range": true,              -- parametr zakresowy, należy podać 
                                            minimalną i maksymalną wartość.
                "precision": 2
            }
        },
    {
        "id": "17448",
        "name": "waga (z opakowaniem)",
        "type": "float",
        "required":false,
"restrictions": {
            "min": 5,
            "max": 10,
            "range": true,                  -- parametr zakresowy. Sekcje range 
                                            min i max oznaczają minalną i maksymalna 
                                            wartość danego parametru.
            "precision": 3                  -- określa z jaką dokładnością możemy podać 
                                            wartość danego parametru. W tym przypadku 
                                            możemy podać wartość z dokładnością do 
                                            3 miejsc po przecinku
        }
    },
    }]
}

Przy pomocy metody POST na zasobie /sale/images prześlesz zdjęcia na nasze serwery. W odpowiedzi otrzymasz linki do grafik, które dodałeś.
Ważne! Informacje odnośnie zasad dla zdjęć w galerii i opisie znajdziesz tutaj.

Przykładowy request:

curl -X POST \
  'https://upload.allegro.pl/sale/images
  -H 'authorization: Bearer {token}' \
  -H 'accept: application/vnd.allegro.beta.v1+json’ \
  -H 'content-type: "image/jpeg", "image/png", albo "image/gif”’ \
  -H ‘accept-language: pl-PL’, (albo en-EN) \
 --data-binary "@file_to_upload.png"                -- wymagane, zawartość pliku z
                                                    obrazkiem w postaci binarnej

Przykładowy response

• 401 - unauthorized
• 413 - za duży obrazek
• 415 - nieodpowiedni typ obrazka
• 201 - poprawnie dodany obrazek, response body:

{
    "expiresAt":"2018-04-06T16:38:04.930Z",         -- data, kiedy usuniemy grafikę z
                                                    serwera. Nie usuniemy jej, jeśli 
                                                    wykorzystasz grafikę w ofercie.
    "location":"https://1.allegroimg.com/original/110843/cd7d40b84968ab8d79ab8a2e47a1"  
                                                    -- link do zdjęcia, które przesłałeś
}

Szczegółowe informacje o zasadach dla ofert znajdziesz na stronie dla sprzedających.

Najważniejsze informacje:

• możesz korzystać tylko z określonych znaczników HTML:
  • h1 - tytuł
  • h2 - podtytuł
  • p - akapit
  • ul - wypunktowanie
  • ol - wylistowanie
  • li - element listy
  • b - pogrubienie.
• możesz wykorzystać tylko zdjęcia z galerii w ofercie, które przesyłasz w tablicy images.

Sugerujemy, by pierwszy opis przygotować przez formularz wystawiania. Skorzystaj z wszystkich rodzajów sekcji i opcji formatowania i pobierz ofertę metodą GET na zasobie /sale/offers/{offerId}. W ten sposób najłatwiej dowiesz się jak poprawnie przygotować opis.

Jak wygląda struktura opisu

Sekcje (sections)

Opis oferty składa się z przynajmniej jednej sekcji, które umieszczasz w tablicy sections. Opis może mieć max. 100 sekcji.

{
    "sections": [
        { section1 },
        { section2 },
         ...
        ]
}

Elementy opisu (item)

Sekcje grupują elementy opisu (item) w widok kolumnowy:

• jedna kolumna, która zajmuje całą szerokość ekranu

{
      "items" : [
     { item1 }
     ]
}

• dwie kolumny, z których każda zajmuje połowę ekranu

{
      "items" : [
     { item1 }
     { item2 }
     ]
}

• Nie możesz utworzyć sekcji z większą ilością kolumn.

Typy treści w opisie

Tekst

{
      "type": "TEXT",
      "content": "<p>opis tekstowy</p>"
}

Możesz tu użyć określonych znaczników HTML:

• h1 - tytuł
• h2 - podtytuł
• p - akapit
• ul - wypunktowanie
• ol - wylistowanie
• li - element listy
• b - pogrubienie.

Najważniejsze zasady:

1. Treści musisz umieścić w znacznikach HTML. W znacznikach HTML używaj tylko małych liter.
   Poprawnie

   {
             "type": "TEXT",
             "content": "<p>opis tekstowy</p>"
           }

   Niepoprawnie

   {
             "type": "TEXT",
             "content": "opis tekstowy"
           }

2. Nie możesz dodatkowo formatować tagów h1 i h2.
   Poprawnie

   {
             "type": "TEXT",
             "content": "<h1>Tytuł sekcji</h1>"
           }

   Niepoprawnie

   {
             "type": "TEXT",
             "content": "<h1><b>Tytuł sekcji<b></h1>"
           }

3. Możesz użyć pogrubienia <b> </b> w znacznikach:

   • <p> </p> - akapit
   • <ul> </ul> - lista wypunktowana
   • <ol> </ol> - lista numerowana

4. Możesz użyć znacznika akapitu <p> </p> w znacznikach:

   • <ul> </ul> - lista wypunktowana
   • <ol> </ol> - lista numerowana

Przykład, jak poprawnie łączyć znaczniki HTML:

    <h1>Lorem ipsum dolor sit amet, consectetur adipiscing elit</h1> 
    <p><b>Aliquam vitae nisi ac lectus gravida rhoncus</b>. Vivamus egestas, orci quis 
    fermentum sollicitudin, leo urna pellentesque quam, ut mattis risus nisl sed dolor.</p> 
    <ul> 
        <li><b>Nulla eu justo ut velit pellentesque porta.</b></li> 
        <li>Pellentesque eget arcu id ligula consequat fermentum at nec velit. Maecenas vitae nunc 
        non ante aliquet facilisis nec id leo.</li> 
        <li>Sed vitae metus vel lorem iaculis rhoncus.</li> <li>Nullam nec felis felis.</li> 
    </ul> 
    <ol> 
        <li><p><b>In eget vulputate purus</b></p></li> 
        <li><p>Integer a pharetra odio.</p></li> 
        <li><p>Vestibulum ut vestibulum diam.</p></li> 
        <li><p>Phasellus quis tempor ipsum, at tincidunt nibh.</p></li> 
        <li><p>Nulla sollicitudin, libero sit amet fermentum iaculis.</p></li> 
    </ol>

Zdjęcia

Możesz użyć tylko takich zdjęć, które wcześniej przesłałeś metodą POST na zasobie /sale/images.

{
    "type": "IMAGE",
    "url": "https://d.allegroimg.com/original/0313bd/338d11a74b059fea784beee0084d"
}

Przykładowa struktura opisu

{
    "sections": [{
        "items": [{
            "type": "TEXT",
            "content": "<p>tekstowy opis przedmiotu</p>"
        }]
    }, {
        "items": [{
            "type": "IMAGE",
            "url": "https://d.allegroimg.com/original/0313bd/338d11a74b059fea784beee0084d"
        }]
    }, {
        "items": [{
            "type": "TEXT",
            "content": "<p>tekstowy opis przedmiotu</p>"
        }, {
            "type": "IMAGE",
            "url": "https://f.allegroimg.com/original/037738/bc72c2f24784b50774d7d078c7ef"
        }]
    }, {
        "items": [{
            "type": "IMAGE",
            "url": "https://0.allegroimg.com/original/032ac4/9c10035846bb970cf208f6982fc0"
        }, {
            "type": "IMAGE",
            "url": "https://d.allegroimg.com/original/0313bd/338d11a74b059fea784beee0084d"
        }]
    }]
}

Zrobisz to za pomocą metody POST na zasobie /sale/offers. Musisz być uwierzytelnionym i zautoryzowanym użytkownikiem. Gdy utworzysz DRAFT oferty, możesz go później opublikować w serwisie. Możesz przesłać częściowe dane (przynajmniej tytuł i kategorię oferty) - taki DRAFT oferty uzupełnisz później o wszystkie wymagane pola metodą PUT na zasobie /sale/offers/{offerId}. Jeśli prześlesz niekompletne dane, to w polu “validation” wyświetlimy:

• co powinieneś uzupełnić
• błędy, jakie pojawiły się w twojej ofercie

Przykładowy request:

curl -X POST \
  'https://api.allegro.pl/sale/offers’
  -H 'authorization: Bearer {token}' \
  -H 'accept: application/vnd.allegro.beta.v1+json’ \
  -H 'content-type: application/vnd.allegro.beta.v1+json' \
  -d ‘{
    "name": "Oferta testowa",                       -- wymagane, tytuł oferty
    "category": {
        "id": "257150"                              -- wymagane, kategoria najniższego rzędu, 
                                                    w której znajduje się oferta. Aktualne 
                                                    numery kategorii pobierzesz za pomocą metody 
                                                    GET na zasobie /sale/categories?parent.id={categoryId}
   }
} 

Przykładowy response

{
    "id": "7276377308",
    "name": "Oferta testowa",
    "category": {
        "id": "257150"
    },
    "parameters": [],
    "ean": null,
    "description": null,
    "images": null,
    "sellingMode": null,
    "stock": null,
    "publication": {
        "duration": null,
        "status": "INACTIVE",
        "startingAt": null,
        "endingAt": null
    },
    "delivery": null,
    "payments": {
        "invoice": "NO_INVOICE"
    },
    "afterSalesServices": null,
    "additionalServices": null,
    "sizeTable": null,
    "promotion": null,
    "location": null,
    "external": null,
    "contact": null,
    "validation": {
        "errors": [
            {
                "code": "VALIDATION_ERROR",
                "message": "Location may not be empty.",
                "details": "",
                "path": "",
                "userMessage": "Location may not be empty."
            },
            {
                "code": "VALIDATION_ERROR",
                "message": "Payments may not be empty.",
                "details": "",
                "path": "",
                "userMessage": "Payments may not be empty."
            },
            {
                "code": "VALIDATION_ERROR",
                "message": "Please describe your offer",
                "details": "",
                "path": "",
                "userMessage": "Please describe your offer"
            }
        ],
        "validatedAt": "2018-04-06T09:29:47.544Z"
    },
    "createdAt": "2018-04-06T09:29:47Z",
    "updatedAt": "2018-04-06T09:29:47.544Z"
}

Metodą PUT na zasobie /sale/offers/{offerId} uzupełnij dane w drafcie oferty. Zmiany możesz wprowadzać w każdej ofercie, która trwa. Możesz uzupełnić przygotowane drafty, jak i opublikowane oferty - to właśnie komendy PUT używasz do edycji oferty. Abyś mógł taką ofertę później opublikować, prześlij kompletny zestaw informacji. Jeśli prześlesz niekompletne dane, to w polu validation wyświetlimy:

Uwaga! Jeżeli chcesz zaktualizować trwającą ofertę, pobierz jej dane metodą GET na zasobie /sale/offers/{offerId}. Następnie, gdy aktualizujesz ofertę, prześlij analogiczną strukturę jaką wcześniej otrzymałeś w odpowiedzi. Nawet jeśli aktualizujesz wartość tylko w jednym polu, to musisz przesłać pełną strukturę pól oferty.

Zasobem PUT /sale/offers/{offerId}. uzupełnij dane w drafcie oferty. Poniżej opisaliśmy pola, które możesz przesłać, jeśli chcesz opublikować ofertę w serwisie.

Przykładowy request:

curl -X PUT \
  'https://api.allegro.pl/sale/offers/{offerId}
  -H 'authorization: Bearer {token}' \
  -H 'accept: application/vnd.allegro.beta.v1+json’ \
  -H 'content-type: application/vnd.allegro.beta.v1+json' \
  -d ‘{
    "id": "7276261934",                         -- numer identyfikacyjny oferty
    "name": "Oferta testowa",                   -- wymagane, tytuł pobranej oferty
    "category": {
        "id": "257150"                          -- wymagane, kategoria najniższego rzędu, w której 
                                                znajduje się oferta. Aktualne numery kategorii 
                                                pobierzesz za pomocą metody 
                                                GET na zasobie /sale/categories?parent.id={catId}
    },
    "parameters": [                             -- wymagane, parametry oferty, aktualne parametry 
                                                dostępne w danej kategorii 
                                                sprawdzisz za pomocą metody 
                                                GET na zasobie /sale/categories/{categoryId}/parameters
        {
            "id": "11323",
            "valuesIds": [
                "11323_1"
            ],
            "values": [],
            "rangeValue": null
        },
        {
            "id": "128188",
            "valuesIds": [
                "128188_1"
            ],
            "values": [],
            "rangeValue": null
        },
        {
            "id": "127448",
            "valuesIds": [
                "127448_1"
            ],
            "values": [],
            "rangeValue": null
        },
        {
            "id": "4386",
            "valuesIds": [
                "4386_1"
            ],
            "values": [],
            "rangeValue": null
        },
        {
            "id": "219",
            "valuesIds": [
                "219_2",
                "219_256",
                "219_4"
            ],
            "values": [],
            "rangeValue": null
        }
    ],
    "ean": "6901443187416",                     -- niewymagane, numer Europejskiego
                                                Kodu Towarowego (EAN) dla danego przedmiotu,
                                                więcej na ten temat przeczytasz tutaj


    "description": {                            -- wymagane, opis oferty; więcej o tym jak
                                                skonstruować poprawnie opis 
                                                oferty znajdziesz tutaj
        "sections": [
            {
                "items": [
                    {
                        "type": "TEXT",
                        "content": "<p>Tekstowy opis przedmiotu</p>"
                    },
                    {
                        "type": "IMAGE",
                        "url": "https://e.allegroimg.com/original/01fd60/4ea8d18e4275b0878b7f0562067e"
                    }
                ]
            },
            {
                "items": [
                    {
                        "type": "TEXT",
                        "content": ""<p>Tekstowy opis przedmiotu</p>""
                    }
                ]
            }
        ]
    },
    "images": [                                 -- wymagane ścieżki obrazków, zdjęcia 
                                                prześlesz przy pomocy metody 
                                                POST na zasobie /sale/images.
                                                Pierwsze zdjęcie w tablicy jest jednocześnie 
                                                pierwszym zdjęciem w ofercie (miniaturką).
        {
            "url": "https://e.allegroimg.com/original/01fd60/4ea8d18e4275b0878b7f0562067e"
        },
        {
            "url": "https://e.allegroimg.com/original/018474/c62b54a74120a7983b09d0fa4a4e"
        },
        {
            "url": "https://8.allegroimg.com/original/013a51/4dd0904a4169ad8b0d25a8984b48"
        },
        {
            "url": "https://2.allegroimg.com/original/01b48e/6e777def4a71ba68952358bd2072"
        }
    ],
    "compatibilityList" : {                     -- niewymagane, pasuje do pojazdów, 
                                                sekcja jest dostępna, jeśli wystawiasz ofertę 
                                                w jednej z wybranych podkategorii 
                                                części samochodowych:
                                                - Układ chłodzenia silnika
                                                - Układ hamulcowy
                                                - Układ kierowniczy
                                                - Układ napędowy
                                                - Układ wydechowy
        "items" : [
                {"text" : "Skoda FABIA II (542) 1.2 TDI 75 KM / 55 KW 1199 ccm"},
                                                -- tablica wierszy z informacją tekstową, 
                                                do jakich aut pasuje dana część. 
                                                Maksymalna długość jednego wiersza to 200 znaków. 
                                                Maksymalnie możesz dodać 2000 wierszy.
                {"text" : "BMW 3 (E46) 330 d 204 KM / 150 kW 2993 ccm"},
                {"text" : "BMW 3 (E46) 330 i 231 KM / 170 kW 2979 ccm"},
                {"text" : "BMW 3 (E46) 330 xi 231 KM / 170 kW 2979 ccm"},
                    ]
    },
    "sellingMode": {                            -- wymagane, format sprzedaży, obecnie
                                                dostępne są trzy wartości: BUY_NOW (Kup Teraz); 
                                                AUCTION (licytacja); ADVERTISEMENT (ogłoszenie)
        "format": "BUY_NOW",
        "price": {
            "amount": "1499",                   -- wymagane, cena dla oferty w formacie
                                                BUY_NOW (Kup Teraz), ADVERTISEMENT (ogłoszenie)
            "currency": "PLN"
        },
        "startingPrice": null,                  -- cena początkowa licytacji, dostępna w
                                                formacie sprzedaży AUCTION (licytacja)
        "minimalPrice": null                    -- cena minimalna, dostępna w
                                                formacie sprzedaży AUCTION (licytacja)
    },
    "stock": {
        "available": 4,                         -- wymagane, liczba aktualnie dostępnych
                                                przedmiotów, WAŻNE! Nie uzupełniaj dla oferty 
                                                typu ADVERTISEMENT (ogłoszenie), natomiast 
                                                dla ogłoszenia typu AUCTION (licytacja) podaj wartość 1
        "unit": "UNIT"                          -- wymagane, obecnie dostępne są trzy
                                                wartości: UNIT (sztuki); SET (komplety); 
                                                PAIR (pary). WAŻNE! Nie uzupełniaj tego 
                                                pola dla oferty typu ADVERTISEMENT (ogłoszenie)
    },
    "publication": {
        "duration": null,                       -- wymagane, czas trwania oferty, dostępne
                                                wartości: null (do wyczerpania zapasów), 
                                                P3D (3 dni); P5D (5 dni); P7D (7 dni); 
                                                P10D (10 dni); P20D (20 dni); czas możesz 
                                                podać też w godzinach - np.: P72H (3 dni). 
                                                Dla oferty typu AUCTION (licytacja) nie możesz 
                                                podać wartości null. Natomiast dla ofert typu 
                                                ADVERTISMENT (ogłoszenia) dostępne są wartości: 
                                                null (na czas nieokreślony - 
                                                opłaty naliczane co 10 dni); P10D (10 dni); 
                                                P20D (20 dni); P30D (30 dni)
        "status": "INACTIVE",                   -- status oferty, dostępne są obecnie dwie
                                                wartości: ACTIVE (oferta aktywna w serwisie), 
                                                INACTIVE (oferta nieaktywna)
        "startingAt": null,                     -- niewymagane, czas startu oferty, dotyczy
                                                ofert do publikacji w przyszłości
        "endingAt": null                        -- niewymagane, data zakończenia oferty
    },
    "delivery": {
        "shippingRates": {
            "id": "4b9ad5b9-7ee9-409b-86f5-578672c13df8"    -- wymagane, numer identyfikacyjny
                                                cennika dostawy, pobierzesz go 
                                                za pomocą metody 
                                                GET na zasobie /sale/shipping-rates?seller.id={Seller_ID}. 
                                                Dla formatu sprzedaży typu  ADVERTISEMENT 
                                                (ogłoszenie) zostaw to 
                                                pole puste - prześlij "delivery": null
        },
        "handlingTime": "PT168H",               -- czas wysyłki, obecnie dostępne są
                                                wartości: PT0S (natychmiast), PT24H (24 godziny), 
                                                P2D (2 dni), P3D (3 dni), P4D (4 dni), P5D (5 dni), 
                                                P7D (7 dni), P10D (10 dni), P14D (14 dni), 
                                                P21D (21 dni), P30D (30 dni), P60D (60 dni).   
                                                Można również podać te wartości 
                                                w godzinach, np. PT72H (3 dni). 
                                                Niewymagane dla formatu sprzedaży 
                                                typu ADVERTISEMENT (ogłoszenie).
        "additionalInfo": "Dodatkowe informacje o dostawie" -- niewymagane, dodatkowe
                                                informacje o dostawie, możesz tutaj wpisać 
                                                informację w formie tekstowej, którą wyświetlimy 
                                                w ofercie w sekcji “Dostawa i płatność”.
        "shipmentDate":"2018-04-01T08:00:00Z"   -- wysyłka od - np.dla przedsprzedaży. 
                                                Uzupełnij datę w formacie zgodnym z ISO 8601.
    },
    "payments": {
        "invoice": "VAT"                        -- wymagane, informacja o fakturze;
                                                obecnie dostępne są 4 wartości: VAT (faktura VAT); 
                                                VAT_MARGIN (faktura VAT marża); 
                                                WITHOUT_VAT (faktura bez VAT); 
                                                NO_INVOICE (nie wystawiam faktury)
    },
    "afterSalesServices": {                     --warunki dla oferty, wymagane dla
                                                kont firma. Dla formatu sprzedażu
                                                ADVERTISEMENT (ogłoszenie) ta 
                                                opcja jest niedostępna, prześlij 
                                                "afterSalesServices": null.
        "impliedWarranty": {
            "id": "b0590fac-9858-4d01-8487-1c6a09c55a68"    -- wymagane dla kont firma,
                                            informacje o reklamacji; identyfikator 
                                            pobierzesz za pomocą metody 
                                        GET na zasobie /after-sales-service-conditions/implied-warranties
        },
        "returnPolicy": {
            "id": "c27c2ddd-f587-44db-b3c8-1f181964ea4d"    -- wymagane dla kont firma, polityka
                                                zwrotów; identyfikator pobierzesz za pomocą metody 
                                            GET na zasobie /after-sales-service-conditions/return-policies
        },
        "warranty": {
            "id": "f8694df6-f020-4a27-ac0a-f4f959969e14"    -- niewymagane, informacje o
                                                gwarancjach, identyfikator pobierzesz za pomocą metody 
                                                GET na zasobie /after-sales-service-conditions/warranties
        }
    },
    "additionalServices": null,                 -- usługi dodatkowe; identyfikatory swoich 
                                                grup usług dodatkowych pobierzesz za pomocą metody 
                                                GET /sale/offer-additional-services/groups. 
                                                Opcja niedostępna dla formatu sprzedaży 
                                                typu ADVERTISEMENT (ogłoszenie), prześlij 
                                                "additionalServices": null.
    "sizeTable": null,                          -- identyfikator tabeli rozmiarów,
                                                pobierzesz go przy pomocy metody 
                                                GET /sale/size-tables?user.id={Seller_ID}
    "promotion": {                              --  niewymagane, opcje promowania,
                                                przy każdej z opcji należy wybrać 
                                                jedną z wartości: false (opcja nieaktywna); 
                                                true (opcja aktywna)
        "emphasized": true,                     -- wyróżnienie
        "bold": false,                          -- pogrubienie
        "highlight": false,                     -- podświetlenie
        "departmentPage": false,                -- oferta promowana na stronie kategorii
        "emphasizedHighlightBoldPackage": false -- pakiet promowania: wyróżnienie,
                                                podświetlenie i pogrubienie oferty
    },
    "location": {                               -- wymagane, informacja o lokalizacji
        "countryCode": "PL",                    -- wymagane, kod kraju zgodny ze
                                                standardem ISO 3166-1 alpha-2
        "province": "WIELKOPOLSKIE",            -- wymagane dla countryCode “PL”, województwo,
                                                dostępne wartości: DOLNOSLASKIE; KUJAWSKO_POMORSKIE; 
                                                LUBELSKIE; LUBUSKIE; LODZKIE; MALOPOLSKIE; MAZOWIECKIE; 
                                                OPOLSKIE; PODKARPACKIE; PODLASKIE; POMORSKIE; SLASKIE; 
                                                SWIETOKRZYSKIE; WARMINSKO_MAZURSKIE; 
                                                WIELKOPOLSKIE; ZACHODNIOPOMORSKIE.
                                                Dla innych krajów nie należy podawać tej wartości.
        "city": "Poznań",                       -- wymagane, miejscowość
        "postCode": "60-166"                    -- wymagane dla adresów w Polsce, kod pocztowy
    },
    "external": {                               -- niewymagany, zewnętrzny ID,
        "id":"4131asdsad40011"                  który nadaje sprzedający, np. aby powiązać ofertę 
                },                              z produktem w swoim magazynie. Możesz wprowadzić 
                                                tutaj dowolny ciąg znaków - będzie on dostępny 
                                                również po wznowieniu oferty.
    "contact": null,                            -- niewymagane, identyfikator
                                                danych kontaktowych identyfikator danych kontaktowych 
                                                dla oferty w formacie ADVERTISEMENT (ogłoszenie),
                                                pobierzesz go za pomocą metody,
                                                GET /sale/offer-contacts
    "validation": {
        "errors": [],                           --  informacje o ewentualnych błędach, 
                                                poinformujemy cię o tym jeśli na przykład podasz 
                                                niepoprawny numer ID cennika.
        "validatedAt": "2018-04-06T08:29:37.461Z"       -- informacje, kiedy odbyła się
                                                        ostatnia walidacja oferty
    },
    "createdAt": "2018-04-06T08:26:32Z",        -- wymagane, data utworzenia oferty
    "updatedAt": "2018-04-06T08:29:38.664Z"     -- wymagane, data ostatniej aktualizacji oferty
}’

Przykładowy response

{
    "id": "7276377308",
    "name": "Oferta testowa",
    "category": {
        "id": "257150"
    },
    "parameters": [
        {
            "id": "11323",
            "valuesIds": [
                "11323_1"
            ],
            "values": [],
            "rangeValue": null
        },
        {
            "id": "128188",
            "valuesIds": [
                "128188_1"
            ],
            "values": [],
            "rangeValue": null
        },
        {
            "id": "127448",
            "valuesIds": [
                "127448_1"
            ],
            "values": [],
            "rangeValue": null
        },
        {
            "id": "4386",
            "valuesIds": [
                "4386_1"
            ],
            "values": [],
            "rangeValue": null
        },
        {
            "id": "219",
            "valuesIds": [
                "219_2",
                "219_256",
                "219_4"
            ],
            "values": [],
            "rangeValue": null
        }
    ],
    "ean": "6901443187416",
    "description": {
        "sections": [
            {
                "items": [
                    {
                        "type": "TEXT",
                        "content": "<p>Tekstowy opis przedmiotu</p>"
                    },
                    {
                        "type": "IMAGE",
                        "url": "https://e.allegroimg.com/original/01fd60/4ea8d18e4275b0878b7f0562067e"
                    }
                ]
            },
            {
                "items": [
                    {
                        "type": "TEXT",
                        "content": "<p>Tekstowy opis przedmiotu</p>"
                    }
                ]
            }
        ]
    },
    "images": [
        {
            "url": "https://e.allegroimg.com/original/01fd60/4ea8d18e4275b0878b7f0562067e"
        },
        {
            "url": "https://e.allegroimg.com/original/018474/c62b54a74120a7983b09d0fa4a4e"
        },
        {
            "url": "https://8.allegroimg.com/original/013a51/4dd0904a4169ad8b0d25a8984b48"
        },
        {
            "url": "https://2.allegroimg.com/original/01b48e/6e777def4a71ba68952358bd2072"
        }
    ],
    "sellingMode": {
        "format": "BUY_NOW",
        "price": {
            "amount": "1499",
            "currency": "PLN"
        },
        "startingPrice": null,
        "minimalPrice": null
    },
    "stock": {
        "available": 4,
        "unit": "UNIT"
    },
    "publication": {
        "duration": null,
        "status": "INACTIVE",
        "startingAt": null,
        "endingAt": null
    },
    "delivery": {
        "shippingRates": {
            "id": "4b9ad5b9-7ee9-409b-86f5-578672c13df8"
        },
        "handlingTime": "PT168H",
        "additionalInfo": ""
        "shipmentDate":"2018-04-01T08:00:00Z"   
    },
    "payments": {
        "invoice": "VAT"
    },
    "afterSalesServices": {
        "impliedWarranty": {
            "id": "b0590fac-9858-4d01-8487-1c6a09c55a68"
        },
        "returnPolicy": {
            "id": "c27c2ddd-f587-44db-b3c8-1f181964ea4d"
        },
        "warranty": {
            "id": "f8694df6-f020-4a27-ac0a-f4f959969e14"
        }
    },
    "additionalServices": null,
    "sizeTable": null,
    "promotion": {
        "emphasized": true,
        "bold": false,
        "highlight": false,
        "departmentPage": false,
        "emphasizedHighlightBoldPackage": false
    },
    "location": {
        "countryCode": "PL",
        "province": "WIELKOPOLSKIE",
        "city": "Poznań",
        "postCode": "60-166"
    },
    "external": {                               -- niewymagany, zewnętrzny ID,
        "id":"4131asdsad40011"                  który nadaje sprzedający, np. aby powiązać ofertę 
                },                              z produktem w swoim magazynie. Możesz wprowadzić 
                                                tutaj dowolny ciąg znaków - będzie on dostępny 
                                                również po wznowieniu oferty.
    "contact": null,
    "validation": {
        "errors": [],
        "validatedAt": "2018-04-06T09:34:40.142Z"
    },
    "createdAt": "2018-04-06T09:29:47Z",
    "updatedAt": "2018-04-06T09:34:40.142Z"
}

Jeśli już wystawiłeś ofertę i chcesz na jej podstawie wystawić podobną, to wystarczy, że pobierzesz ją przy pomocy metody GET na zasobie /sale/offers/{offerId}. Metodą GET na zasobie /sale/offers/{offerId} pobierzesz wszystkie pola wskazanej oferty. Musisz być uwierzytelniony i zautoryzowany jako sprzedawca, który wystawił tę ofertę. Całą pobraną strukturę z wyłączeniem:

• numeru identyfikacyjnego oferty
• informacji, kiedy odbyła się ostatnia walidacja oferty
• daty utworzenia oferty
• daty ostatniej aktualizacji oferty

prześlij metodą POST na zasób /sale/offers Dzięki temu stworzysz nowy draft oferty na podstawie danych z oferty, którą wcześniej pobrałeś. Gdy uzupełniasz draft, możesz wprowadzić zmiany w strukturze, którą pobrałeś zasobem GET /sale/offers/{offerId}.

Przykładowy request:

curl -X GET \
  'https://api.allegro.pl/sale/offers/{offerId} 
  -H 'authorization: Bearer {token}' \
  -H 'accept: application/vnd.allegro.beta.v1+json’ \

Przykładowy response

{
    "id": "7276261934",                         -- numer identyfikacyjny oferty
    "name": "Oferta testowa",                   -- tytuł pobranej oferty
    "category": {
        "id": "257150"                          -- kategoria najniższego rzędu, w której
                                                znajduje się oferta. Aktualne numery kategorii 
                                                pobierzesz za pomocą metody 
                                                GET na zasobie /sale/categories?parent.id={catId}
    },
    "parameters": [                             -- parametry oferty, aktualne parametry
                                                dostępne w danej kategorii sprawdzisz 
                                                za pomocą metody 
                                                GET na zasobie /sale/categories/{categoryId}/parameters
        {
            "id": "11323",
            "valuesIds": [
                "11323_1"
            ],
            "values": [],
            "rangeValue": null
        },
        {
            "id": "128188",
            "valuesIds": [
                "128188_1"
            ],
            "values": [],
            "rangeValue": null
        },
        {
            "id": "127448",
            "valuesIds": [
                "127448_1"
            ],
            "values": [],
            "rangeValue": null
        },
        {
            "id": "4386",
            "valuesIds": [
                "4386_1"
            ],
            "values": [],
            "rangeValue": null
        },
        {
            "id": "219",
            "valuesIds": [
                "219_2",
                "219_256",
                "219_4"
            ],
            "values": [],
            "rangeValue": null
        }
    ],
    "ean": "6901443187416",                     -- numer Europejskiego
                                                Kodu Towarowego (EAN) dla danego przedmiotu,
                                                więcej na ten temat przeczytasz tutaj


    "description": {                            -- opis oferty; więcej o tym jak skonstruować
                                                poprawnie opis oferty znajdziesz tutaj.
        "sections": [
            {
                "items": [
                    {
                        "type": "TEXT",
                        "content": "<p>Tekstowy opis przedmiotu</p>"
                    },
                    {
                        "type": "IMAGE",
                        "url": "https://e.allegroimg.com/original/01fd60/4ea8d18e4275b0878b7f0562067e"
                    }
                ]
            },
            {
                "items": [
                    {
                        "type": "TEXT",
                        "content": "<p>Tekstowy opis przedmiotu</p>"
                    }
                ]
            }
        ]
    },
    "images": [                             -- ścieżki obrazków, zdjęcia prześlesz przy
                                            pomocy metody 
                                            POST na zasobie /sale/images. 
                                            Pierwsze zdjęcie w tablicy jest jednocześnie 
                                            pierwszym zdjęciem w ofercie (miniaturką.
        {
            "url": "https://e.allegroimg.com/original/01fd60/4ea8d18e4275b0878b7f0562067e"
        },
        {
            "url": "https://e.allegroimg.com/original/018474/c62b54a74120a7983b09d0fa4a4e"
        },
        {
            "url": "https://8.allegroimg.com/original/013a51/4dd0904a4169ad8b0d25a8984b48"
        },
        {
            "url": "https://2.allegroimg.com/original/01b48e/6e777def4a71ba68952358bd2072"
        }
    ],
    "compatibilityList" : {                     -- niewymagane, pasuje do pojazdów, 
                                                sekcja jest dostępna, jeśli wystawiasz ofertę 
                                                w jednej z wybranych podkategorii 
                                                części samochodowych:
                                                - Układ chłodzenia silnika
                                                - Układ hamulcowy
                                                - Układ kierowniczy
                                                - Układ napędowy
                                                - Układ wydechowy
        "items" : [
                {"text" : "Skoda FABIA II (542) 1.2 TDI 75 KM / 55 KW 1199 ccm"},
                                                -- tablica wierszy z informacją tekstową, 
                                                do jakich aut pasuje dana część. 
                                                Maksymalna długość jednego wiersza to 200 znaków. 
                                                Maksymalnie możesz dodać 2000 wierszy.
                {"text" : "BMW 3 (E46) 330 d 204 KM / 150 kW 2993 ccm"},
                {"text" : "BMW 3 (E46) 330 i 231 KM / 170 kW 2979 ccm"},
                {"text" : "BMW 3 (E46) 330 xi 231 KM / 170 kW 2979 ccm"},
                    ]
    },
    "sellingMode": {                        -- format sprzedaży, obecnie dostępne są
                                            trzy wartości: BUY_NOW (Kup Teraz); 
                                            AUCTION (licytacja); ADVERTISEMENT (ogłoszenie)
        "format": "BUY_NOW",
        "price": {
            "amount": "1499",               -- cena dla oferty w formacie BUY_NOW
                                            (Kup Teraz), ADVERTISEMENT (ogłoszenie)
            "currency": "PLN"
        },
        "startingPrice": null,              -- cena początkowa licytacji, dostępna w
                                            formacie sprzedaży AUCTION (licytacja)
        "minimalPrice": null                -- cena minimalna, dostępna w
                                            formacie sprzedaży AUCTION (licytacja)
    },
    "stock": {
        "available": 4,                     -- liczba aktualnie dostępnych przedmiotów,
                                            WAŻNE! Nie uzupełniaj dla oferty typu 
                                            ADVERTISEMENT (ogłoszenie), natomiast 
                                            dla ogłoszenia typu 
                                            AUCTION (licytacja) podaj wartość 1.
        "unit": "UNIT"                      -- obecnie dostępne są trzy wartości: UNIT
                                            (sztuki); SET (komplety); PAIR (pary). 
                                            WAŻNE! Nie uzupełniaj dla oferty 
                                            typu ADVERTISEMENT (ogłoszenie)
    },
    "publication": {
        "duration": null,                   -- czas trwania oferty, dostępne wartości:
                                            null (do wyczerpania zapasów), P3D (3 dni); 
                                            P5D (5 dni); P7D (7 dni); P10D (10 dni); 
                                            P20D (20 dni); czas możesz 
                                            podać też w godzinach - np.: P72H (3 dni). 
                                            Dla oferty typu AUCTION (licytacja) 
                                            nie możesz podać wartości null. Natomiast 
                                            dla ofert typu ADVERTISMENT (ogłoszenia) 
                                            dostępne są wartości: null 
                                            (na czas nieokreślony - opłaty 
                                            naliczane co 10 dni); P10D (10 dni); 
                                            P20D (20 dni); P30D (30 dni)
        "status": "ACTIVE",                 -- status oferty, dostępne są obecnie dwie
                                            wartości: ACTIVE (oferta aktywna w serwisie), 
                                            INACTIVE (oferta nieaktywna)
        "startingAt": null,                 -- czas startu oferty, dotyczy ofert do
                                            publikacji w przyszłości
        "endingAt": null                    -- data zakończenia oferty
    },
    "delivery": {
        "shippingRates": {
            "id": "4b9ad5b9-7ee9-409b-86f5-578672c13df8"    -- numer identyfikacyjny cennika
                                            dostawy, pobierzesz go za pomocą metody 
                                            GET na zasobie /sale/shipping-rates?seller.Id={Seller_ID}. 
                                            Dla formaty sprzedaży typu  
                                            ADVERTISEMENT (ogłoszenie) zostaw 
                                            to pole puste - prześlij "delivery": null
        },
        "handlingTime": "PT168H",           -- czas wysyłki, obecnie dostępne są
                                            wartości: PT0S (natychmiast), PT24H (24 godziny), 
                                            P2D (2 dni), P3D (3 dni), P4D (4 dni), P5D (5 dni), 
                                            P7D (7 dni), P10D (10 dni), P14D (14 dni), 
                                            P21D (21 dni), P30D (30 dni), P60D (60 dni).   
                                            Można również podać te wartości 
                                            w godzinach, np. PT72H (3 dni). 
                                            Niewymagane dla formatu sprzedaży 
                                            typu ADVERTISEMENT (ogłoszenie).
        "additionalInfo": "Dodatkowe informacje o dostawie" -- dodatkowe informacje o dostawie,
                                                            możesz tutaj wpisać informację 
                                                            w formie tekstowej, którą wyświetlimy 
                                                            w ofercie w sekcji “Dostawa i płatność”.
        "shipmentDate":"2018-04-01T08:00:00Z"   -- wysyłka od - np.dla przedsprzedaży. 
                                                Uzupełnij datę w formacie zgodnym z ISO 8601.
    },
    "payments": {
        "invoice": "VAT"                    -- informacja o fakturze; obecnie
                                            dostępne są 4 wartości: VAT (faktura VAT); 
                                            VAT_MARGIN (faktura VAT marża); 
                                            WITHOUT_VAT (faktura bez VAT); 
                                            NO_INVOICE (nie wystawiam faktury)
    },
    "afterSalesServices": {                 --warunki dla oferty, wymagane dla
                                            kont firma. Dla formatu sprzedaży
                                            ADVERTISEMENT (ogłoszenie) ta opcja jest niedostępna,
                                            prześlij "afterSalesServices": null.
        "impliedWarranty": {
            "id": "b0590fac-9858-4d01-8487-1c6a09c55a68"    -- wymagane dla kont firma,
                                        informacje o reklamacji; identyfikator 
                                        pobierzesz za pomocą metody 
                                        GET na zasobie /after-sales-service-conditions/implied-warranties
        },
        "returnPolicy": {
            "id": "c27c2ddd-f587-44db-b3c8-1f181964ea4d"    -- wymagane dla kont firma, polityka
                                            zwrotów; identyfikator pobierzesz 
                                            za pomocą metody 
                                            GET na zasobie /after-sales-service-conditions/return-policies
        },
        "warranty": {
            "id": "f8694df6-f020-4a27-ac0a-f4f959969e14"    -- niewymagane, informacje o
                                            gwarancjach, identyfikator pobierzesz 
                                            za pomocą metody 
                                            GET na zasobie /after-sales-service-conditions/warranties
        }
    },
    "additionalServices": null,             -- usługi dodatkowe; identyfikatory swoich 
                                            grup usług dodatkowych pobierzesz za pomocą metody 
                                            GET /sale/offer-additional-services/groups. 
                                            Opcja niedostępna dla formatu sprzedaży 
                                            typu ADVERTISEMENT (ogłoszenie), 
                                            prześlij "additionalServices": null.
    "sizeTable": null,                      -- identyfikator tabeli rozmiarów,
                                            pobierzesz go przy pomocy metody 
                                            GET /sale/size-tables?user.id={Seller_ID}
    "promotion": {                          --  opcje promowania, przy każdej z opcji 
                                            należy wybrać jedną z wartości: 
                                            false (opcja nieaktywna); true (opcja aktywna)
        "emphasized": true,                 -- wyróżnienie
        "bold": false,                      -- pogrubienie
        "highlight": false,                 -- podświetlenie
        "departmentPage": false,            -- oferta promowana na stronie kategorii
        "emphasizedHighlightBoldPackage": false     -- pakiet promowania: wyróżnienie,
                                                    podświetlenie i pogrubienie oferty
    },
    "location": {                           -- informacja o lokalizacji
        "countryCode": "PL",                -- kod kraju zgodny ze standardem ISO 3166-1 alpha-2
        "province": "WIELKOPOLSKIE",        -- wymagane dla countryCode “PL”, województwo,
                                            dostępne wartości: DOLNOSLASKIE; KUJAWSKO_POMORSKIE; 
                                            LUBELSKIE; LUBUSKIE; LODZKIE; MALOPOLSKIE; MAZOWIECKIE; 
                                            OPOLSKIE; PODKARPACKIE; PODLASKIE; POMORSKIE; 
                                            SLASKIE; SWIETOKRZYSKIE; WARMINSKO_MAZURSKIE; 
                                            WIELKOPOLSKIE; ZACHODNIOPOMORSKIE.
                                            Dla innych krajów nie należy podawać wartości.
        "city": "Poznań",                   -- miejscowość
        "postCode": "60-166"                -- kod pocztowy
    },
    "external": null,                       -- zewnętrzny ID, który nadaje sprzedający, 
                                            np. aby powiązać ofertę z produktem w swoim magazynie. 
                                            Możesz wprowadzić tutaj dowolny ciąg znaków, 
                                            będzie on dostępny również po wznowieniu oferty.
    "contact": null,                        --  identyfikator danych kontaktowych 
                                            dla oferty w formacie ADVERTISEMENT (ogłoszenie), 
                                            pobierzesz go za pomocą metody 
                                            GET /sale/offer-contacts
    "validation": {
        "errors": [],                       --  informacje o ewentualnych błędach, 
                                            poinformujemy cię o tym jeśli na przykład podasz 
                                            niepoprawny numer ID cennika.
        "validatedAt": "2018-04-06T08:29:37.461Z"   -- informacje, kiedy odbyła się
                                                    ostatnia walidacja oferty
    },
    "createdAt": "2018-04-06T08:26:32Z",    -- data utworzenia oferty
    "updatedAt": "2018-04-06T08:29:38.664Z" -- data ostatniej aktualizacji oferty
}

Jeśli oferta jest już kompletna i poprawnie zwalidowana, to za pomocą metody PUT /sale/offer-publication-commands/{commandId} możesz ją opublikować w serwisie. Jest to metoda asynchroniczna.
W polu commandId podaj wartość w formacie UUID (universally unique identifier). Jest to globalnie unikatowy identyfikator, który składa się z 32 liczb szesnastkowych (np.: 21ae4ed1-eab7-34ea-b605-cf2e22b5eed3).

WAŻNE! Przy pomocy tej metody możesz również:

• zakończyć wybrane oferty - wystarczy, że w polu action podasz wartość END
• zaplanować wystawienie oferty w przyszłości - wystarczy, że w polu scheduleFor ustawisz datę planowanej publikacji oferty
• wznowić zakończone oferty - w statusie ENDED. Przekaż dla takich ofert wartość ‘ACTIVATE’ w polu action. Udostępnimy je ponownie w serwisie.

Przykładowy request:

curl -X PUT \
  'https://api.allegro.pl/sale/offer-publication-commands/{commandId} 
  -H 'authorization: Bearer {token}' \
 -H 'accept: application/vnd.allegro.beta.v1+json’ \
  -H 'content-type: application/vnd.allegro.beta.v1+json' \
  -d ‘{
    "publication": {
        "action": "ACTIVATE",               -- wymagane, dostępne są dwie wartości: 
                                            ACTIVATE (aktywowanie danych ofert) i 
                                            END (zakończenie danych ofert)
"scheduledFor":"2018-03-28T12:00:00.000Z"   -- niewymagane, wysyłasz jeśli chcesz 
                                            zaplanować wystawienie oferty w przyszłości 
    },
    "offerCriteria": [
        {
            "offers":[                      -- wymagane, tablica obiektów z
                                            numerami identyfikacyjnymi ofert
                {
                    "id": "7276377308"
                }
            ],
            "type": "CONTAINS_OFFERS"       -- wymagane, obecnie dostępna jest
                                            jedna wartość: 
                                            CONTAINS_OFFERS (oferty, w których zmienimy status)
        }
    ]
}

Przykładowy response

{
    "id": "3380d97f-0d32-4747-8a17-1da38f9499de",
    "taskCount": {
        "total": 0,
        "success": 0,
        "failed": 0
    }

Status zadania jakie zleciłeś w kroku 7 (wystawienia lub zakończenia oferty) sprawdzisz za pomocą metod:

• GET na zasobie /sale/offer-publication-commands/{commandId}
• GET /sale/offer-publication-commands/{commandId}/tasks

Za pomocą tego zasobu możesz pobrać informacje o statusie zadania publikacji ofert w serwisie. W odpowiedzi otrzymasz zestawienie, ile ofert wystawiło się poprawnie, a z iloma wystąpił jakiś problem.

Przykładowy request:

curl -X GET \
  'https://api.allegro.pl/sale/offer-publication-commands/{commandId}
  -H 'authorization: Bearer {token}' \
 -H 'accept: application/vnd.allegro.beta.v1+json’ \
  -H 'content-type: application/vnd.allegro.beta.v1+json' \

Przykładowy response

{
    "id": "3380d97f-0d32-4747-8a17-1da38f9499de",
    "taskCount": {
        "total": 1,
        "success": 1,
        "failed": 0
    }
}

Za pomocą tego zasobu możesz pobrać informacje o statusie publikacji ofert w serwisie. W odpowiedzi otrzymasz:

• identyfikatory ofert, które chciałeś opublikować w serwisie
• status modyfikacji oferty - czy zakończyła się sukcesem
• datę zlecenia modyfikacji oferty
• datę wykonania danego zadania - wystawienia lub zakończenia oferty

Przykładowy request:

curl -X GET \
  'https://api.allegro.pl/sale/offer-publication-commands/{commandId}/tasks
  -H 'authorization: Bearer {token}' \
 -H 'accept: application/vnd.allegro.beta.v1+json’ \
  -H 'content-type: application/vnd.allegro.beta.v1+json' \

Przykładowy response

[
{
            "offer": {
                "id": "7168735300"
            },
            "message": "",                      -- opis dlaczego nie udało się  opublikować 
                                                oferty w serwisie
            "status": "SUCCESS",                -- status publikacji oferty w serwisie,
                                                dostępne są trzy wartości: SUCCESS (publikacja 
                                                zakończyła się pomyślnie); FAIL 
                                                (wystąpiły błędy przy publikacji i oferta nie 
                                                jest aktywna w serwisie); NEW (trwa publikacja 
                                                oferty w serwisie, akcja nie została jeszcze zakończona)
            "scheduledAt": "2018-03-01T11:02:50.005+01:00",
            "finishedAt": "2018-03-01T11:02:51.691+01:00",
            "field": "publication"
        }
    ]

1/ Jak wystawić licytację z opcją Kup Teraz?

Jeśli chcesz wystawić taką ofertę wystarczy, że prześlesz w polu "format" wartość AUCTION i uzupełnisz pola:

• startingPrice - cena początkowa
• minimalPrice - cena minimalna. To pole nie jest wymagane.

2/ Dlaczego wprowadziliśmy funkcję draftów?

Dzięki draftom możesz przygotować zalążek oferty, na którym możesz pracować w innym terminie - np. gdy chcesz wypracować ostateczny kształt opisu. Możesz również od razu przygotować kompletny draft i opublikować ofertę w serwisie.

3/ Dlaczego wprowadziliśmy osobny zasób dla zdjęć?

W ramach oferty możesz udostępnić zdjęcia w bardzo dużej rozdzielczości. Wiąże się to z olbrzymią wagą takiego pliku. To, że wprowadziliśmy osobny zasób dedykowany zdjęciom pozwoli zmniejszyć rozmiar requestu. Wpłynie to na krótszy czas wystawienia oferty.

4/ Dlaczego wprowadziliśmy osobny zasób dla cenników dostaw?

Dzięki temu, że ceny wysyłki są niezależne od oferty i dzięki osobnemu zasobowi do cenników dostawy, będziesz mógł szybciej przeprowadzić hurtową edycję cen dostawy. Wystarczy, że wprowadzisz zmianę w cenniku dostawy, a koszt przesyłki zmieni się we wszystkich ofertach, do których przypiąłeś dany cennik. Takie rozwiązanie pozwoli dynamicznie reagować na zmiany cen u przewoźników.

5/ Jak zaplanować wystawienie oferty w przyszłości?

Termin do wystawienia ofert w przyszłości możesz ustawić za pomocą komendy PUT na zasobie /sale/offer-publication-commands/{commandId}. Wystarczy, że w polu scheduledFor podasz planowany czas wystawienia oferty w przyszłości.