Event journal concerning changes in seller’s offers

GET /sale/offer-events resource is an event journal concerning changes in offers listed by authorized seller that occurred within the last 24 hours. You can receive the following types of events in the response:

  • offer was published (“type”: “OFFER_ACTIVATED”);

  • offer was changed (“type”: “OFFER_CHANGED”);

  • stock was changed in an offer - also returned after a purchase (“type”: “OFFER_STOCK_CHANGED”);

  • price was changed in an offer (“type”: “OFFER_PRICE_CHANGED”);

  • offer was ended (“type”: “OFFER_ENDED”);

  • offer was archived (“type”: “OFFER_ARCHIVED”);

  • bid was placed on the offer (“type”: “OFFER_BID_PLACED”);

  • bid for offer was canceled (“type”: “OFFER_BID_CANCELED”).


In request query you may use the following parameter to adjust the response to your needs:

  • from - the id of the last seen event - to receive all events after the given event id (e.g. from=MTEzMjQzODU3NA);

  • limit - the number of events which you want to receive in the response (default - 100, max. 1000);

  • type - the type of events which you want to receive in the response (np. type=OFFER_ENDED).

Sample request - which allows you to get 200 events concerning the stock change, which occurred after the event “id”: “MTU2Mzg2NTM5MTU2Mzg0Ng”

 
  curl -X GET \
  'https://api.allegro.pl/sale/offer-events?from=MTU2Mzg2NTM5MTU2Mzg0Ng&limit=200&type=OFFER_STOCK_CHANGED' \
  -H 'Accept: application/vnd.allegro.public.v1+json' \
  -H 'Authorization: Bearer {token}'
 

List of offers

To retrieve a list of all offers listed by a particular user, call GET /sale/offers. You must be logged to a seller account. By default the offers are sorted in descending order by offer ID.


To adjust the search list to your needs use parameters:

  • limit to define a number of offers on a list (values from 1 to 1,000),

  • offset to define a starting point for retrieving another batch of data (min. 0),

e.g. GET sale/offers?limit=100&offset=10

Filters

Use filters to search the list

  • offers with a particular status – call GET /sale/offers?publication.status={status} - may include one or more values e.g. GET sale/offers?publication.status=INACTIVE&publication.status=ACTIVE

    • INACTIVE - offer’s draft,

    • ACTIVE - listed offer,

    • ACTIVATING - scheduled offer or offer during listing process,

    • ENDED - ended offer.

  • search by offer ID - call GET /sale/offers?offer.id={offer.id}

  • search by one or more external.id - call GET /sale/offers?external.id={external_id}

  • search by title - call GET /sale/offers?name={name} - provide at least one title letter

  • search by shippingRates.id - call GET/sale/offers?delivery.shippingRates.id={id}

  • search by offers without shipping rates - call GET/sale/offers?delivery.shippingRates.id.empty

  • reserve price - call GET /sale/offers?sellingMode.price.amount.gte={price}

  • maximum price - call GET /sale/offers?sellingMode.price.amount.lte={price}

  • sale format - call GET /sale/offers?sellingMode.format={format} - may include one or more values separated by commas:

    • BUY_NOW

    • ADVERTISEMENT - classifieds,

    • AUCTION

Sorting

By default offers are sorted starting with the newest one (in descending order by ID). To display offers in a different order, call GET /sale/offers?sort={value}. Supported values:

  • sellingMode.price.amount - by price, ascending,

  • -sellingMode.price.amount - by price, descending,

  • stock.sold - by number of sold items, ascending,

  • -stock.sold - by number of sold items, descending,

  • stock.available - by number of available items, ascending,

  • -stock.available - by number of available items, descending.


Use limit (values from 1 to 1,000) and offset (min. 0, maximum number of offers -1) to retrieve suitable batches of offers


Sample calls for a list of offers:

  • Show my all active offers and sort them by the number of sold items in ascending order GET /sale/offers?publication.status=ACTIVE&sort=stock.sold,

  • Show my all Buy now offers with “suszarka” in title GET /sale/offers?sellingMode.format=BUY_NOW&name=suszarka,

  • Show my all offers whose price range is between PLN 50 and PLN 120 and sort them according to price in descending order: GET /sale/offers?sellingMode.price.amount.gte=50&sellingMode.price.amount.lte=120&sort=-sellingMode.price.amount,

  • Show all offers including drafts GET /sale/offers?publication.status=INACTIVE&publication.status=ACTIVATING&publication.status=ACTIVE&publication.status=ENDED,

  • Show a list of my offers

Sample request:

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

Click to view sample response:
 {
    "offers": [
        {
            "id": "7610768778",                 -- offer ID
            "name": "Suszarka do włosów A180 dyfuzor",    -- offer tittle
            "category": {
                "id": "67481"                   -- category of the lowest tier 
                                                that hosts the offer.
            },
            "primaryImage": {                   -- main offer photo (thumbnail)
                "url": "https://9.allegroimg.com/original/03d631/d744e5be46dfbfb687d2faee38b9"
            },
            "sellingMode": {
                "format": "BUY_NOW",            -- sale format; supported values: 
                                                “BUY_NOW”, “ADVERTISEMENT” (classifieds), 
                                                “AUCTION”
                "price": {
                    "amount": "133.0",          -- offer price in the case of BUY_NOW, 
                                                ADVERTISEMENT (classifieds) formats
                    "currency": "PLN"
                },
                "minimalPrice": null,           -- reserve price, available in AUCTION
                "startingPrice": null           -- starting price, available in AUCTION
            },
            "saleInfo": {
                "currentPrice": null,           -- purchase price in the case of auction
                "biddersCount": 0               -- number of bidders
            },
            "stats": {
                "watchersCount": 0,             -- number of watchers            
                "visitsCount": 0                -- number of visits
            },
            "stock": {
                "available": 8,                 -- number of bidders
                "sold": 0                       -- number of items sold in the offer
                                                from last 30 days
            },
            "publication": {
                "status": "ACTIVE",             -- offer status, supported values: 
                                                "INACTIVE" (draft), “ACTIVE” (listed), 
                                                “ACTIVATING” (scheduled or during listing),
                                                “ENDED”, INACTIVE (draft)
                "startingAt": null,                               -- scheduled listing date
                "startedAt":"2018-10-11T12:16:02Z",               -- listing date
                "endingAt": "2018-10-21T12:16:02Z",               -- scheduled offer end date
                "endedAt": null                                   -- actual offer end date
            },
            "afterSalesServices": {
                "warranty": {
                    "id": "2d15741b-93b1-4d24-989c-dc2d412d91ff"  -- warranty terms ID
                },
                "returnPolicy": {
                    "id": "cf5f8e7a-4488-4420-810d-259bd84b745f"  -- return policy ID
                },
                "impliedWarranty": {
                    "id": "de2ad368-2682-47ab-9868-d813d968846a"  -- complaints policy ID
                }
            },
            "additionalServices": {
                "id": "ab18d75d-5db2-4bee-aca5-32de952a7b44"      -- ID of additional services
            },
            "external": {
                "id": "external_id"                               -- signature
            }
        },
        {
            "id": "7569844187",
            "name": "fotel bujany",
            "category": {
                "id": "20285"
            },
            "primaryImage": {
                "url": "https://9.allegroimg.com/original/03d631/d744e5be46dfbfb687d2faee37b9"
            },
            "sellingMode": {
                "format": "AUCTION",
                "price": {
                    "amount": "220.0",
                    "currency": "PLN"
                },
                "minimalPrice": null,
                "startingPrice": {
                    "amount": "150.0",
                    "currency": "PLN"
                }
            },
            "saleInfo": {
                "currentPrice": {
                    "amount": "150.0",
                    "currency": "PLN"
                },
                "biddersCount": 0
            },
            "stats": {
                "watchersCount": 0,
                "visitsCount": 17
            },
            "stock": {
                "available": 1,
                "sold": 0
            },
            "publication": {
                "status": "ENDED",
                "startingAt": null,
                "startedAt": "2018-10-02T11:16:13Z",
                "endingAt": "2018-10-07T11:16:13Z",
                "endedAt": "2018-10-07T11:16:13Z"
            },
            "afterSalesServices": {
                "warranty": {
                    "id": "2d15741b-93b1-4d24-989c-dc2d412d91ff"
                },
                "returnPolicy": {
                    "id": "cf5f8e7a-4488-4420-810d-259bd84b745f"
                },
                "impliedWarranty": {
                    "id": "de2ad368-2682-47ab-9868-d813d968846a"
                }
            },
            "additionalServices": null,
            "external": null
        }
    ],
    "count": 2,                        -- number of offers in the response
    "totalCount": 2                    -- number of offers available for this query
  }

Editing single offer

To retrieve an offer you want to edit call GET sale/offers/{offerId}. Then call PUT /sale/offers/{offerId} to send the edited offer. You can edit both ongoing and ended offers. If you transfer incomplete data, the “validation” field will display:

  • missing information,

  • errors in your offer

Note! Even if you update only one field, you have to send the complete structure of offer fields including the offer id.

Editing many offers

NOTE! In a single call you can edit up to 1000 offers.

Price

PUT /sale/offer-price-change-commands/{commandId} - use this resource to edit price in selected offers. You must be logged to a seller account. The following editing modes are available:

changing price to a particular value

Sample request:

 
  curl -X PUT \
  https://api.allegro.pl/sale/offer-price-change-commands/{CommandId} \
  -H 'Authorization: Bearer {token}' \
  -H 'Accept: application/vnd.allegro.public.v1+json' \
  -H 'Content-Type: application/vnd.allegro.public.v1+json' \
  -d '{
    "modification":{
        "type":"FIXED_PRICE",     -- changing price, 
                                  three values are supported: FIXED_PRICE (to a given value), 
                                  "INCREASE_PRICE" (increasing the price by a particular value), 
                                  "DECREASE_PRICE" (decreasing the price by a particular value))
        "price":{
            "amount":"10.50",     -- price you want to set in offers
            "currency":"PLN"
           }
        },
    "offerCriteria":[
        {
          "type":"CONTAINS_OFFERS",
          "offers":[              -- a list of offers you want to edit
           {
             "id":"7660573029"
           },
           {
             "id":"7644576839"
           }
          ]
        }
     ]
  }'
 

changing price by a particular percentage

Sample request:

 
  curl -X PUT \
  https://api.allegro.pl/sale/offer-price-change-commands/{CommandId} \
  -H 'Authorization: Bearer {token}' \
  -H 'Accept: application/vnd.allegro.public.v1+json' \
  -H 'Content-Type: application/vnd.allegro.public.v1+json' \
  -d '{
    "modification":{
        "type":"INCREASE_PERCENTAGE",     -- supported values: INCREASE_PERCENTAGE” 
                                          (increasing the price by suitable % ), 
                                          “DECREASE_PERCENTAGE” (decreasing the price by suitable %)
        "percentage": 10				  -- percentage value you want to 
                                          increase or decrease the price by
        },
    "offerCriteria":[
        {
          "type":"CONTAINS_OFFERS",
          "offers":[              -- a list of offers you want to edit 
           {
             "id":"7660573029"
           },
           {
             "id":"7644576839"
           }
          ]
        }
     ]
  }'
 

Sample responses in the event of price editing::

 
  {
    "id": "aacfb40c-daca-4252-91ef-244d68d28123",
    "taskCount": {                      -- 0 is transferred until the processing starts;
                                        the number of offers to be processed are displayed
                                        after a moment
            "total": 0,
            "success": 0,
            "failed": 0
    }
  }
 


GET /sale/offer-price-change-commands/{commandId} use this resource to check the general status of ordered bulk price editing within one {commandId}. You will receive a summary with a number of successfully edited offers. You must be logged to a seller account.

Sample request:

 
  curl -X GET \
  https://api.allegro.pl/sale/offer-price-change-commands/{commandId} \
  -H 'Authorization: Bearer {token}' \
  -H 'Accept: application/vnd.allegro.public.v1+json' 
 

Sample response:

 
  {
    "id": "aacfb40c-daca-4252-91ef-244d68d28123",
    "taskCount": {
        "total": 2,                         -- number of offers you wanted to edit
        "success": 2,                       -- number of successfully edited offers 
        "failed": 0                         -- number of unsuccessfully edited offers
    }          
  }
 


GET /sale/offer-price-change-commands/{commandId}/tasks use this resource to check statuses of bulk price editing tasks within one {commandId}. You will receive a list of edited offers with the editing status and time. You must be logged to a seller account. Use the following parameters to retrieve suitable batches of data:

  • limit to define a number of offers on a list (supported values from 1 to 1000),

  • offset to define a starting point for retrieving another batch of data (by default 0).

Sample request:

 
  curl -X GET \
  https://api.allegro.pl/sale/offer-price-change-commands/aacfb40c-daca-4252-91ef-244d68d28123/tasks \
  -H 'Authorization: Bearer {token}' \
  -H 'Accept: application/vnd.allegro.public.v1+json'
 

Sample response:

 
  {
    "tasks": [
        {
            "offer": {
                "id": "7644576839"                           -- offer ID
            },
            "message": "",
            "status": "SUCCESS",                             -- status of performed action
            "scheduledAt": "2018-11-14T11:42:38.388+01:00",  -- editing start date
            "finishedAt": "2018-11-14T11:42:41.499+01:00",   -- editing end date
            "field": "price"                                 -- edited field
        },
        {
            "offer": {
                "id": "7660573029"
            },
            "message": "",
            "status": "SUCCESS",
            "scheduledAt": "2018-11-14T11:42:38.397+01:00",
            "finishedAt": "2018-11-14T11:42:41.498+01:00",
            "field": "price"
        }
    ]
  }
 

Quantity

PUT /sale/offer-quantity-change-commands/{commandId} - use this resource to order bulk quantity editing operation in selected offers. You must be logged to a seller account.

Sample request:

 
  curl -X PUT \
  https://api.allegro.pl/sale/offer-quantity-change-commands/{commandId} \
  -H 'Authorization: Bearer {token}' \
  -H 'Content-Type: application/vnd.allegro.public.v1+json' \
  -H 'Accept: application/vnd.allegro.public.v1+json' \
  -d '{
    "modification":{
        "changeType":"FIXED",           -- supported values: “FIXED” (quantity), 
                                        “GAIN” (add/remove items. To remove items, 
                                        provide the value with a minus sign)
        "value":30                      -- value to be changed to (FIXED) 
                                        or by which you want to change the quantity (GAIN)       
            },
    "offerCriteria":[
    {
        "type":"CONTAINS_OFFERS",
        "offers":[                      -- a list of offers you want to edit
        {
        "id":"7660573029"
        },
        {
        "id":"7644576839"
        }
        ]
    }
    ]
  }'
 

Sample response:

 
   {
    "id": "e476171a-18b1-44e5-81d1-d142b86ff13d",
    "taskCount": {                      -- 0 is transferred until the processing starts;
                                        the number of offers to be processed are displayed
                                        after a moment
            "total": 0,
            "success": 0,
            "failed": 0
    }
   }
 


GET /sale/offer-quantity-change-commands/{commandId} - use this resource to check the general status of ordered bulk quantity editing operation within one {commandId}. You must be logged to a seller account.

Sample request:

 
  curl -X GET \
  https://api.allegro.pl/sale/offer-quantity-change-commands/e476171a-18b1-44e5-81d1-d142b86ff13d \
  -H 'Authorization: Bearer {token}' \
  -H 'Accept: application/vnd.allegro.public.v1+json'
 

Sample response:

 
  {
    "id": "e476171a-18b1-44e5-81d1-d142b86ff13d",
    "taskCount": {
        "total": 2,                                  -- number of offers you wanted to edit
        "success": 2,                                -- number of successfully edited offers 
        "failed": 0                                  -- number of unsuccessfully edited offers
    }          
  }
 


GET /sale/offer-quantity-change-commands/{commandId}/tasks - use this resource to check statuses of bulk quantity editing operation within one {commandId}. You must be logged to a seller account. Use the following parameters to retrieve suitable batches of data:

  • limit to define a number of offers on a list (supported values from 1 to 1000),

  • offset to define a starting point for retrieving another batch of data (by default 0).

Sample request:

 
  curl -X GET \
  https://api.allegro.pl/sale/offer-quantity-change-commands/e476171a-18b1-44e5-81d1-d142b86ff13d/tasks \
  -H 'Authorization: Bearer {token}' \
  -H 'Accept: application/vnd.allegro.public.v1+json'
 

Sample response:

 
  {
    "tasks": [
        {
            "offer": {
                "id": "7644576839"                            -- offer ID
            },
            "message": "",
            "status": "SUCCESS",                              -- editing status
            "scheduledAt": "2018-11-14T12:54:54.624+01:00",   -- editing start date
            "finishedAt": "2018-11-14T12:54:57.103+01:00",    -- editing end date
            "field": "quantity"                               -- edited field
        },
        {
            "offer": {                    
                "id": "7660573029"
            },
            "message": "",
            "status": "SUCCESS",
            "scheduledAt": "2018-11-14T12:54:54.634+01:00",
            "finishedAt": "2018-11-14T12:54:58.499+01:00",
            "field": "quantity"
        }
    ]
  }


PUT /sale/offer-modification-commands/{commandId} - use this resource to edit many offers at once. You must be logged to a seller account.

Note! You can edit only one element per request.

Shipping price list

Sample request for editing shipping price list:

 
  curl -X PUT \
  https://api.allegro.pl/sale/offer-modification-commands/{commandId} \
  -H 'Authorization: Bearer {token}' \
  -H 'Accept: application/vnd.allegro.public.v1+json' \
  -H 'Content-Type: application/vnd.allegro.public.v1+json' \
  -d '{
    "modification": 
        {
            "delivery": {
                "shippingRates": {
                "id": "4b9ad5b9-7ee9-409b-86f5-578672c13df8" -- shipping price list ID; 
                                                            retrieve it by calling
                                                            GET /sale/shipping-rates?seller.id={Seller_ID}
                                                            Before you add shipping rate - complete "location" field
                                                            In the case of ADVERTISEMENT type of offers 
                                                            leave this field empty – transfer “delivery”: 
                                                            null
                }
            }
        },
      "offerCriteria":[
        {
            "type":"CONTAINS_OFFERS",
            "offers":[
                {
                  "id":"7531636067"
                },
                {
                  "id":"7512439587"
                }
            ]
        }
     ]
   }
 

Sample response

 {
    "id": "30354f98-6788-4db6-83c4-1e7e404dc137",       -- {commandId} - value you will provide in the 
                                                        query. Use it to check the status of introduced 
                                                        changes
    "taskCount": {                                      -- 0 is transferred until the processing starts;
                                                        the number of offers to be processed are displayed
                                                        after a moment
        "total": 0,                         
        "success": 0,
        "failed": 0
    }
 }
 


GET /sale/offer-modification-commands/{commandId} Use this resource to find out how many offers have been updated within provided {commandId}. You will receive a summary with a number of successfully edited offers. You must be logged to a seller account.

Sample request:

 
  curl -X GET \
  'https://api.allegro.pl/sale/offer-modification-commands/{commandId}' 
  -H 'Authorization: Bearer {token}' \
  -H 'Accept: application/vnd.allegro.public.v1+json'
 

Sample response:

 
  {
    "id": "6666c97f-0d32-4747-8a17-1da38f9499de",
    "taskCount": {
        "total": 2,                                  -- number of offers you wanted to edit
        "success": 2,                                -- number of edited offers 
        "failed": 0                                  -- number of offers where editing
    }          
  }
 


GET /sale/offer-modification-commands/{commandId}/tasks Use this resource to retrieve a detailed summary of changes introduced within a particular {commandId}. The summary also includes information whether the editing was successful as well as about edited fields. You must be logged to a seller account.

Sample request:

 
  curl -X GET \
  'https://api.allegro.pl/sale/offer-modification-commands/{commandId}/tasks' 
  -H 'Authorization: Bearer {token}' \
  -H 'Accept: application/vnd.allegro.public.v1+json'
 

Sample response:

 
  {
    "tasks": [
        {
            "offer": {
                "id": "7512439587"                          -- offer ID
            },
            "message": "",
            "status": "SUCCESS",
            "scheduledAt": "2018-08-28T10:09:51.002+02:00", -- change date
            "finishedAt": "2018-08-28T10:09:51.663+02:00",  -- change date
            "field": "shippingRates"                        -- editing field
        },
        {
            "offer": {
                "id": "7531636067"
            },
            "message": "",
            "status": "SUCCESS",
            "scheduledAt": "2018-08-28T10:09:51.005+02:00",
            "finishedAt": "2018-08-28T10:09:51.48+02:00",
            "field": "shippingRates"
        }
    ]
  }
 


Use the resource to add or change:

Promo options

 
  {
    "modification": {
    "promotion": {                              --  promo options, select one value 
                                                next to each option: false (inactive); 
                                                true (active)
      "bold": true,                             -- bold
      "departmentPage": true,                   -- promoting an offer on a category page
      "emphasized": true,                       -- featuring
      "emphasizedHighlightBoldPackage": true,   -- promo package: featuring,
                                                highlighting and bold
      "highlight": true                         -- highlighting
    }
  },
      "offerCriteria":[
      {
        "type":"CONTAINS_OFFERS",
        "offers":[
        {
        "id":"7531636067"
        },
        {
        "id":"7512439587"
        }
     ]
    }
  ]
 }
 

Size tables

 
  {
    "modification": {
    "sizeTable": {          
      "id": "de2689bc-3d47-11e8-811c-246e9677f638"      -- size table ID,retrieve it by calling  
                                                        GET /sale/size-tables?user.id={Seller_ID}
     }
    },
    "offerCriteria":[
      {
        "type":"CONTAINS_OFFERS",
        "offers":[
         {
           "id":"7531636067"
         },
         {
           "id":"7512439587"
         }
       ]
      }
    ]
  }
 

Information on invoice

 
  {
    "modification": {
    payments": {
      "invoice": "VAT_MARGIN "                  -- information on invoice;
                                                four values are supported: VAT (VAT invoice); 
                                                VAT_MARGIN (VAT invoice margin); 
                                                WITHOUT_VAT (invoice without VAT); 
                                                NO_INVOICE (I don’t issue invoices)        
     }
   },
    "offerCriteria":[
      {
        "type":"CONTAINS_OFFERS",
        "offers":[
         {
        "  id":"7531636067"
         },
         {
          "id":"7512439587"
         }
       ]
     }
    ]
 }
 

additional services

 
 {
    "modification": {
        "additionalServicesGroup": {                 -- defines a group of additional services 
                                                     you wish to assign to offers           
        "id": "240e22a8-9e57-4fc2-b386-8b5ac1aeaa34" -- ID of a group of additional services;       
                                                     retrieve it by calling:
                                                     GET /sale/offer-additional-services/groups
     }
   },
     "offerCriteria":[
      {
        "type":"CONTAINS_OFFERS",
        "offers":[
         {
          "id":"7531636067"
         },
         {
          "id":"7512439587"
         }
       ]
      }
    ]
}
 

Duration

Note!

  • In INACTIVE status you can freely change the duration of Buy Now offers and auctions.

  • In ACTIVE status:

    • You cannot change the duration for an auction;

    • For Buy Now offers you can only set option until all items are sold.

  • in ENDED status:

    • You cannot change the duration for an auction;

    • For Buy Now offers you can only set option until all items are sold. Remember to activate updated offer to be visible on the website..

You can set a value only for one of two parameters:

  • duration - offer duration time provided in ISO8601, e.g. “PT72H”;

  • durationUnlimited - unlimited duration time - until all items are sold out;

If you provide two parameters, API will return validation error.


Sample request - set specific duration time:

 
 {
    "modification": {
        "publication": {
            "duration": “PT720H”                       
        }
    },
    "offerCriteria": [
        {
        "offers": [
            {
                "id": "8360057987"
            }
        ],
                "type": "CONTAINS_OFFERS"
        }
    ]
 }
 

Przykładowy request - set option until all items are sold out:

 
 {
    "modification": {
        "publication": {
            "durationUnlimited": true                      
        }
    },
    "offerCriteria": [
        {
        "offers": [
            {
                "id": "8360057987"
            }
        ],
                "type": "CONTAINS_OFFERS"
        }
    ]
 }
 

Ending offers

Call PUT /sale/offer-publication-commands/{commandId} to end/suspend selected offers – just provide END in the action field.

Relisting offers

You can relist an ended BUY_NOW (Buy it Now) offer under the same ID number. Call PUT /sale/offer-publication-commands/{commandId}provide ACTIVATE in the action field and the ID of the offer you want to change the status of. If you want to schedule offer relisting provide the relisting date in the scheduleFor field. If you relist the offer within 30 days after its end the offer popularity will be proportional to the suspension time. In other words – if you relist an offer after 20 days the popularity will match the popularity of the offer’s 10 last days.

Note! If the ended offer has no items first you have to change the number of items before activating it. You can edit and relist offers without shipping price lists until the first half of 2019. After the said date the shipping price list will be required as in the case of new offers.

Sample request

 
  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",                       -- required, two values are supported:
                                                    ACTIVATE (offer activating) and
                                                    END (offer ending)
        "scheduledFor":"2018-03-28T12:00:00.000Z"   -- not required; send if you want
                                                    to schedule offer relisting
    },
    "offerCriteria": [
        {
            "offers":[                              -- required; array of objects with
                                                    offer IDs
                {
                    "id": "7276377308"
                }
            ],
            "type": "CONTAINS_OFFERS"               -- required, at present only one
                                                    value is supported: CONTAINS_OFFERS
                                                    (offers whose status is subject to change)
        }
    ]
 }'
 

Sample response

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

Additional information

Offer listing limit

You can list up to 100,000 offers from one account. The limit also concerns scheduled offers. If you exceed it and try to list a new one or relist an ended offer the following message will be displayed:

 
  {
    "errors": [
        {
            "code": "PublicationValidationException.MaxActiveOffers",
            "message": "Offer cannot be published - your account has exceeded
            the maximum number 100 000 of active offers",
            "details": null,
            "path": null,
            "userMessage": "Offer cannot be listed – you have
            100,000 active offers"
        }
    ]
  }
 

Multi-variant

You can combine the same products in different variants to create a complete offer. Use suitable resources you have access to.

Calculator

You can calculate the cost of offer listing. Use the resources you have access to.

Size tables

Retrieve size table IDs and their content using resources you have access to.

Attachments and tags

Here you can find tags to manage tags and attachments..