Jak wystawić ofertę

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

{
"deliveryMethods": [
    {
        "id": "7203cb90-864c-4cda-bf08-dc883f0c78ad",   -- ogólny identyfikator danej metody dostawy
        "name": "Przesyłka kurierska",                  -- ogólna nazwa danej metody dostawy
        "paymentPolicy": "IN_ADVANCE"                   -- rodzaj płatności. Dostępne są dwie 
                                                        wartości IN_ADVANCE (opłata z góry) 
                                                        i CASH_ON_DELIVERY (opłata przy odbiorze)
    },
    {
        "id": "758fcd59-fbfa-4453-ae07-4800d72c2ca5",
        "name": "List polecony priorytetowy",
        "paymentPolicy": "IN_ADVANCE"
    },
    ...
    {
        "id": "845efe05-0c96-47c3-a8cb-aa4699c158ce",
        "name": "Przesyłka kurierska pobranie",
        "paymentPolicy": "CASH_ON_DELIVERY"
    }
    ]
} 

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": "845efe05-0c96-47c3-a8cb-aa4699c158ce"    -- wymagane, identyfikator 
                                                                danej metody dostawy
            },
            "maxQuantityPerPackage": 10,                        -- wymagane, liczba w paczce
            "firstItemRate": {                                  -- wymagane, cena przesyłki
                "amount": "12.58",
                "currency": "PLN"
            },
            "nextItemRate": {                                   -- wymagane, cena 
                                                                kolejnej sztuki
                "amount": "12.58",
                "currency": "PLN"
            },
            "shippingTime": {                                   -- czas dostawy, może być podany tylko dla
                                                                niektórych metod dostawy (np. "845efe05-0c96-47c3-a8cb-aa4699c158ce").
                                                                Jeśli nie został podany, zostanie użyty
                                                                domyślny czas wysyłki danej metody dostawy.
                "from": "PT72H",                                podaj wielokrotność 24H, 
                "to": "PT120H"                                  zgodnie z formatem ISO 8601
            }
        },
        {
            "deliveryMethod": {
                "id": "2488f7b7-5d1c-4d65-b85c-4cbcf253fd93"
            },
            "maxQuantityPerPackage": 1,
            "firstItemRate": {
                "amount": "7.99",
                "currency": "PLN"
            },
            "nextItemRate": {
                "amount": "0.00",
                "currency": "PLN"
            }
        }
    ]
}'

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

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

{
"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"
}
            ]
}

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

{
"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
}

• 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

• 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

• 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.
• Zadbaj o powiązanie oferty z produktem. Opcja ta jest dostępna w wybranych kategoriach, w których grupujemy oferty z tym samym produktem. Tylko w nich otrzymasz dane o produktach. Kategorie te oznaczyliśmy "offersWithProductPublicationEnabled": true.

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

{
 "categories":[
  {
   "id": "348",                                 -- identyfikator kategorii
   "name": "Akcesoria GSM",                     -- nazwa kategorii
   "parent": {                                  -- identyfikator kategorii nadrzędnej 
    "id": "4"                                   dla kategorii głównych parent, ma wartość null    
   },
   "leaf": false,                               -- informacja, czy dana kategoria jest
                                                kategorią najniższego rzędu, dostępne są 
   "options": {                                 -- cechy kategorii
    "advertisement": false,                     -- informacja, czy w danej kategorii
                                                lub jej podkategoriach można wystawić ofertę 
                                                ogłoszeniową.
    "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).
    "offersWithProductPublicationEnabled": true -- informacja, że w danej kategori możesz
    },                                          wiązać ofertę z produktem. Więcej na ten temat 
                                                znajdziesz w tym podarniku
   }  
 ]
}

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

{
    "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), string (możesz dodać 
                                            jedną lub wiele wartości)
        "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
        }
    },
    {
        "id": "216917",
        "name": "Załączone wyposażenie",
        "type": "string",
        "required": false,
        "unit": null,
        "options": {
            "variantsAllowed": false,
            "variantsEqual": false
        },
        "restrictions": {
            "minLength": 1,
            "maxLength": 40,
            "allowedNumberOfValues": 10     -- informacja o tym, ile wartości możesz
                                            podać w danym parametrze
        }
    }
    ]
}

• dla parametrów słownikowych (wybór jednego lub wielu wartości z wielu)
  

  {
      "id": "209878",
      "valuesIds": [
      "209878_2",
      "209878_1"
      ],
      "values": [],
      "rangeValue": null
  }

• dla parametrów zakresowych
  

  {
      "id": "212570",
      "valuesIds": [],
      "values": [],
      "rangeValue": {
          "from": "80",
          "to": "100"
       }
  }

• dla parametrów w których samodzielnie uzupełniasz ich wartość

  {
      "id": "216325",
      "valuesIds": [],
      "values": [
          "zielony",
          "żółty",
          "czerwony"
      ],
      "rangeValue": null
  }

• w postaci linku
  UWAGA! Pamiętaj aby podać adres domeny, nie podawaj adresu IP.
  
  Przykładowy request:

  curl -X POST \
    https://upload.allegro.pl/sale/images \
    -H 'Authorization: Bearer {token}' \
    -H 'accept: application/vnd.allegro.public.v1+json' \
    -H 'content-type: application/vnd.allegro.public.v1+json' \
    -d '{
         "url":"https://imgur.com/1aOIvg3E.jpg"       -- wymagane, link do obrazka
        }'     
  

• w postaci binarnej
  
  Przykładowy request:

  curl -X POST \
    'https://upload.allegro.pl/sale/images
    -H 'authorization: Bearer {token}' \
    -H 'accept: application/vnd.allegro.public.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
  

• 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ś
}

Litery: 'a','b','c','d','e','f','g','h','i','j','k','l','m','n','o','p','q','r','s','t','u','w','v','x','y','z',
'ä','ö','ü','ø','ò','ß','0','á','č','ě','í','ř','š','ů','ú','ý','ž','œ','æ','à','â','ç','é','è','ê','ë','î',
'ï','ô','û','ù','ü','ÿ','€','×','ą','ć','ę','ł','ń','ó','ś','ź','ż','µ','⌀',
 
Cyfry: '0','1','2','3','4','5','6','7','8','9',
 
Znaki specjalne:'!','@','[',']','#','$','%','^','&','*','{','}','(',')','.',',','/','\\','|','?',' ',';','~','²','³',
'`','\'','’','´','\"','”','"','„','“','″','<','>','_','\t',':','-','=','+','0','…','–','°','°'

• maksymalna wielkość całego opisu jaki możesz przesłać to 40000 bajtów
• 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.

Jak wygląda struktura opisu

Sekcje (sections)

{
    "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

{
      "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.

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

    <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>

{
    "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"
        }]
    }]
}

• offset - wskaż miejsce, od którego chcesz pobrać kolejną porcję danych (przyjmuje wartości z zakresu, jaki obejmuje typ danych integer). Domyślnie 0.
• limit - określ liczbę tagów, jaką mamy zwrócić w odpowiedzi (przyjmuje wartości z zakresu, jaki obejmuje typ danych integer). Domyślnie 1000.

curl -X GET \
  http://api.allegro.pl/sale/offer-tags?user.id={userId} \ 
  -H 'accept: application/vnd.allegro.public.v1+json' \
  -H 'authorization: Bearer {token}

{
    "tags": [
        {
            "id": "500fedd3-2140-4225-87d4-a22484222776",   -- identyfikator taga,
            "name": "Komiksy",                              -- nazwa taga,
            "hidden": false                                 -- informacja czy tag jest ukryty, przyjmuje
                                                               wartości false (tag jest widoczny) oraz
                                                               true (tag jest ukryty),
        },
        {
            "id": "d2d2d475-7049-493d-bb95-f4ea59983ecb",
            "name": "Filmy",
            "hidden": false
        },
        {
            "id": "4b876428-d827-492b-a30e-aee3f5be791a",
            "name": "Muzyka",
            "hidden": false
        }
    ]
}

curl -X POST \
  http://api.allegro.pl/sale/offers/{offerId}/tags \
  -H 'content-type: application/vnd.allegro.public.v1+json' 
  -H 'accept: application/vnd.allegro.public.v1+json' \
  -H 'authorization: Bearer {token}' \
  
  -d '{
    "tags": [
        {
            "id": "500fedd3-2140-4225-87d4-a22484222776"   -- wymagany, identyfikator taga,
        }
    ]
}'

{
 "tags":[]
}

Dodaj załączniki do oferty

curl -X POST \
  https://api.allegro.pl/sale/offer-attachments \
  -H 'accept: application/vnd.allegro.public.v1+json' \
  -H 'content-type: application/vnd.allegro.public.v1+json' \
  -H 'authorization: Bearer {token}' 
  -d '{
    "type": "SPECIAL_OFFER_RULES",                              -- wymagany, rodzaj załącznika,
                                                                   dostępne wartości MANUAL,
                                                                   SPECIAL_OFFER_RULES,
                                                                   COMPETITION_RULES,
                                                                   BOOK_EXCERPT, USER_MANUAL,
                                                                   INSTALLATION_INSTRUCTIONS,
                                                                   GAME_INSTRUCTIONS,
    "file": {
        "name": "abcde.pdf"                                     -- wymagany, nazwa pliku, który dodasz,
    }
}
'

Location: http://upload.allegro.pl/sale/offer-attachments/e9d1bf7c-804e-4faf-9e24-b2d3aa3eda05

{
    "id": "e9d1bf7c-804e-4faf-9e24-b2d3aa3eda05",                  -- identyfikator draftu załącznika,
    "type": "SPECIAL_OFFER_RULES",                                 -- rodzaj załącznika,
    "file": {
        "name": "abcde.pdf"                                        -- nazwa pliku, który dodasz,
    }
}

Prześlij plik *.pdf

curl -X PUT \
http://upload.allegro.pl/sale/offer-attachments/{attachmentId} \
  -H 'accept: application/vnd.allegro.public.v1+json' \
  -H 'content-type: application/pdf' \
  -H 'authorization: Bearer {token} 
 --data-binary "@abcde.pdf"                                        -- wymagany, zawartość pliku z 
                                                                      załącznikiem w postaci binarnej

{
    "id": "07ee5e36-afc7-41eb-af49-3df5354ef858",                  -- identyfikator draftu załącznika,
    "type": "SPECIAL_OFFER_RULES",                                 -- rodzaj załącznika,
    "file": {
        "name": "abcde.pdf",                                       -- nazwa pliku, który dodasz,
        "url": {adres_pliku}                                       -- adres, pod którym jest dostępny 
                                                                      załącznik.
    }
}

Podłącz załącznik do oferty

"attachments": [
            {
                "id": "07ee5e36-afc7-41eb-af49-3df5354ef858"
            }
        ]

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

curl -X POST \
  'https://api.allegro.pl/sale/offers'
  -H 'authorization: Bearer {token}' \
  -H 'accept: application/vnd.allegro.public.v1+json' \
  -H 'content-type: application/vnd.allegro.public.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}
   }
} 

{
    "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,
    "attachments": [],
    "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"
}

curl -X PUT \
  'https://api.allegro.pl/sale/offers/{offerId}
  -H 'authorization: Bearer {token}' \
  -H 'accept: application/vnd.allegro.public.v1+json' \
  -H 'content-type: application/vnd.allegro.public.v1+json' \
  -d '{
    "id": "7276261934",                         -- numer identyfikacyjny oferty
    "name": "Oferta testowa",                   -- wymagane, tytuł pobranej oferty
    "product": {
     "id": "634238b1-4385-4de7-9c00-dfa49fce16ab"   -- identyfikator produktu, więcej na ten temat
    },                                              znajdziesz w tym podarniku
    "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, sekcja Pasuje do 
                                                więcej dowiesz się z tego artykułu 
        "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); P30D (30 dni), czas 
                                                możesz podać też w godzinach - np.: P72H (3 dni). 
                                                Dla oferty typu AUCTION (licytacja) nie możesz 
                                                podać wartości null i dostępne są wartości:
                                                P3D (3 dni); P5D (5 dni); P7D (7 dni); P10D (10 dni);
                                                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 trzy
                                                wartości: ACTIVE (oferta aktywna w serwisie), 
                                                INACTIVE (oferta nieaktywna), ENDED (zakończona oferta)
        "startingAt": null,                     -- niewymagane, czas startu oferty, dotyczy
                                                ofert do publikacji w przyszłości
        "endingAt": null,                       -- niewymagane, data zakończenia oferty
        "endedBy": null                         -- niewymagane, powód zakończenia oferty. 
                                                Dostępne wartości: USER (przez użytkownika), 
                                                ADMIN (przez pracownika allegro), 
                                                EXPIRATION (zgodnie z planowaną datą lub oferta się 
                                                wyprzedała), ERROR (w wyniku wewnętrznego błędu)
    },
    "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 / sygnatura,
        "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.
    "attachments": [
            {
        "id": "07ee5e36-afc7-41eb-af49-3df5354ef858" -- niewymagany, identyfikator załącznika
            }
        ]
    "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
}'

{
    "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 / sygnatura,
        "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.
    "attachments": [],
    "contact": null,
    "validation": {
        "errors": [],
        "validatedAt": "2018-04-06T09:34:40.142Z"
    },
    "createdAt": "2018-04-06T09:29:47Z",
    "updatedAt": "2018-04-06T09:34:40.142Z"
}

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

• 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.

curl -X PUT \
  'https://api.allegro.pl/sale/offer-publication-commands/{commandId} 
  -H 'authorization: Bearer {token}' \
 -H 'accept: application/vnd.allegro.public.v1+json' \
  -H 'content-type: application/vnd.allegro.public.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)
        }
    ]
}

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

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

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

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

• 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

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

[
{
            "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"
        }
    ]

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