Changelog

GET /sale/product-offers/{offerId}

10DEC
2021

Update

GET /sale/delivery-methods - new delivery methods

3DEC
2021

Update

Size tables - we removed the "image" and "orientation" fields:

GET /sale/size-tables/{tableId}

GET /sale/size-tables

29NOV
2021

Update

We have added "b2b.buyableOnlyByBusiness" field for:

We have added "offerRequirements.id" field for:

24NOV
2021

Update

GET /sale/products/{productId}

23NOV
2021

Update

We have added "features" array for:

GET /me

23NOV
2021

New

We have added resources to propose changes to product:

POST /sale/products/{productId}/change-proposals - propose changes in product

GET /sale/products/change-proposals/{id} - get the status of the product change proposal

15NOV
2021

Update

We have added "b2b.buyableOnlyByBusiness" field for:

GET /sale/offers

8NOV
2021

Update

We have introduced the automatic renewal of the classified ads and additional promo packages:

PUT /sale/offer-classifieds-packages/{offerId}

GET /sale/offer-classifieds-packages/{offerId}

4NOV
2021

Update

Shipping rates - specify the maximum weight of the package:

GET /sale/delivery-methods

POST /sale/shipping-rates

GET /sale/shipping-rates/{id}

3NOV
2021

Update

We have added new fields for:

GET /order/customer-returns

GET /order/customer-returns/{customerReturnId}

29OCT
2021

Update

We have implemented address validation, obligatory structure "options" and removed unavailable fields and values for the return policy:

POST /after-sales-service-conditions/return-policies

GET /after-sales-service-conditions/return-policies/{returnPolicyId}

PUT /after-sales-service-conditions/return-policies/{returnPolicyId}

28OCT
2021

Update

Campaigns in the public version

18OCT
2021

Delete

We removed POST /pricing/fee-preview

30SEP
2021

Update

We have enabled the product sets creation in the sale/product-offers resources

27SEP
2021

Update

POST /sale/offers - we have increased the limit of images in advertisements

1SEP
2021

New

We have added resources for size tables:

POST /sale/size-tables - create a size table

PUT /sale/size-tables/{tableId} - edit the size table

GET /sale/size-tables-templates - get a list of table templates

Update

We added a new template.id field:

GET /sale/size-tables/{tableId}

GET /sale/size-tables

24AUG
2021

New

We introduced new resources for managing Campaigns:

PATCH /sale/badges/offers/{offerId}/campaigns/{campaignId} - command change of the price or end of the offer designation in the campaign

GET /sale/badge-operations/{operationId} - check status of the price change or end of the offer designation in the campaign

19AUG
2021

Update

GET /order/checkout-forms/{id}/invoices - we removed "reason" field

18AUG
2021

Update

We have added new fields "messagesStatus" & "lastMessageCreationDate" for:

GET /sale/disputes

GET /sale/disputes/{disputeId}

18AUG
2021

Update

We have introduced resources for customer returns management:

2AUG
2021

New

GET /order/customer-returns - retrieve a list of customer returns

GET /order/customer-returns/{customerReturnId} - retrieve detailed information about customer return

POST /order/customer-returns/{customerReturnId}/rejection - reject customer return refund

26JUL
2021

Update

GET /payments/payment-operations - new group and types of operations

21JUL
2021

Update

GET /sale/matching-categories - we have changed the name of the field "matching_categories" to "matchingCategories"

20JUL
2021

Update

We have implemented address validation, added new fields and values for the return policy:

POST /after-sales-service-conditions/return-policies

GET /after-sales-service-conditions/return-policies/{returnPolicyId}

PUT /after-sales-service-conditions/return-policies/{returnPolicyId}

19JUL
2021

New

We have added resources for Message Center management:

GET /messaging/threads - retrieve the list of user threads,

GET /messaging/threads/{threadId} - retrieve a thread with provided identifier,

PUT /messaging/threads/{threadId}/read - mark a particular thread as read,

POST /messaging/messages - write a new message to recipient,

GET /messaging/threads/{threadId}/messages - retrieve a list of messages in thread with provided identifier,

POST /messaging/threads/{threadId}/messages - write a new message in existing thread,

GET /messaging/messages/{messageId} - retrieve a message with provided identifier,

DELETE /messaging/messages/{messageId} - delete message with provided identifier,

POST /messaging/message-attachments - add attachment declaration before uploading,

PUT /messaging/message-attachments/{attachmentId} - upload attachment using identifier that was declared,

GET /messaging/message-attachments/{attachmentId} - download attachment with provided identifier.

15JUL
2021

New

We have introduced beta.v3 version of the /sale/product-offers resources

13JUL
2021

New

We have introduced scope for Message Center

8JUL
2021

Update

We have changed the approach in adding photos to offer connected with a product in the:

PUT /sale/product-offers/{offerId}

7JUL
2021

Update

GET /sale/offer-events - new external.id field

1JUL
2021

Update

GET /order/events - new event type

29JUN
2021

Update

We added a new value for the "endedBy" field for:

GET /sale/products - we have added a new parameter "searchFeatures"

GET /sale/offer-events

14JUN
2021

Update

7JUN
2021

New

Allegro Prices - we have added resources for managing program participation consents:

GET /sale/allegro-prices-offer-consents/{offerId} - retrieve current offer consent information

PUT /sale/allegro-prices-offer-consents/{offerId} - update current offer consent information

GET /sale/allegro-prices-account-eligibility - retrieve current account eligibility information

PUT /sale/allegro-prices-account-consent - update account consent information

1JUN
2021

Update

GET /offers/listing - we have introduced restrictions

31MAY
2021

Update

GET /billing/billing-entries - new value in "tax.annotation" field in the billing operations history

27MAY
2021

Update

GET /order/checkout-forms/{id}/invoices - new list of invoice rejection reasons

24MAY
2021

Update

GET /billing/billing-entries - order number in the billing operations history

19MAY
2021

New

We adapted Allegro API to the VAT eCommerce package

GET /sale/tax-settings?category.id={categoryId} - get all VAT settings available in the given category

Update

We extended the "tax" object with new fields in:

GET /sale/product-offers/{offerId}

POST /sale/product-offers

PUT /order/checkout-forms/{id}/fulfillment - new statuses of order fulfillment

12MAY
2021

Update

11MAY
2021

New

We have introduced new endpoints for managing Allegro parcels

GET /order/carriers/ALLEGRO/points - retrieve list of Allegro pickup drop off points

GET /order/carriers/ALLEGRO/tracking - retrieve the history of Allegro parcels statuses

29APR
2021

Update

We released a new field “dueDate” in:

GET /order/checkout-forms

GET /order/checkout-forms/{id}

8APR
2021

Update

GET /sale/delivery-methods - new delivery methods from Germany and the Czech Republic

31MAR
2021

Update

Allegro Prices - we have added new objects and field types to handle orders:

GET /order/checkout-forms

GET /order/checkout-forms/{id}

29MAR
2021

Update

POST /sale/offers - we removed "ean" field

PUT /sale/offers/{offerId} - we removed "ean" field

POST /sale/product-proposals - we removed "eans" object

17MAR
2021

Update

PATCH /sale/product-offers/{offerId} - we have added support for a “product.id” field

2MAR
2021

Update

POST /sale/offer-attachments - new types of attachments in the offer

1MAR
2021

Update

PUT /parcel-management/parcel-create-commands/{commandId} - we have added the “type” field at the level of the "items" section and changed its requirement

22FEB
2021

Update

GET /parcel-management/delivery-services - we have added a new field “carrierId”

18FEB
2021

Update

Sale commission refunds - we have added information about the type of application

GET /order/refund-claims/{claimId}

GET /order/refund-claims

9FEB
2021

New

We have added new resources, thanks to which you can add and download an invoice to the order:

GET /order/checkout-forms/{id}/invoices - retrieve invoices assigned to the order

POST /order/checkout-forms/{id}/invoices - create invoice object

PUT /order/checkout-forms/{id}/invoices/{invoiceId}/file - upload a *.pdf file with invoice

26JAN
2021

Update

We have added new field "category.similar" in:

GET /sale/products/{productId}

GET /sale/badges - we have added a new object “prices.subsidy”

20JAN
2021

Update

14JAN
2021

Update

We have added support for “publication.startingAt” and “discounts” fields that you can provide in:

Categories and parameters - we have introduced an event journal in categories and resource with which you can check future changes in parameters

13JAN
2021

New

GET /sale/category-events - check changes in categorie

GET /sale/category-parameters-scheduled-changes - check planned changes in parameters

4JAN
2021

Update

GET /sale/offers/unfilled-parameters - we have introduced a new filter "parameterType"

20NOV
2020

New

We have added new resources for checking unfilled parameters in the offers and future requirements:

GET /sale/offers/unfilled-parameters - check offers unfilled parameters

GET /sale/categories/parameters/required-changes - check which parameters will be marked as required

17NOV
2020

New

New resources to promote offers

GET /sale/offer-promotion-packages - retrieve available promo options

POST /sale/offers/{offerId}/promo-options-modification - assign promo options to an offer

GET /sale/offers/{offerId}/promo-options - check promo options assigned to an offer

PUT /sale/offers/promo-options-commands/{commandId} - assign promo options to multiple offers

GET /sale/offers/promo-options-commands/{commandId} - retrieve result of the task of assigning promo options

GET /sale/offers/promo-options-commands/{commandId}/tasks - retrieve detailed report for the task of assigning promo options

13NOV
2020

Update

POST /order/checkout-forms/{id}/shipments - add a tracking number easier

12NOV
2020

Update

We have introduced beta.v2 version of:

PATCH /sale/product-offers

GET /sale/product-offers/{offerId}/operations/{operationId}

GET /sale/product-offers/{offerId}

2NOV
2020

Update

Large order discount for B2B transactions

23OCT
2020

Update

We have added support for "tax.percentage" and "publication.duration" fields that you can provide in:

19OCT
2020

Update

We added size table support in:

GET /sale/categories/{categoryId}/parameters - we have added new fields for handling dependent parameters

15OCT
2020

Update

9OCT
2020

New

PATCH /sale/product-offers/{offer-id} - new resource for offer edition

8OCT
2020

Update

We have added new section “discounts”:

POST /sale/products-offers - if you provide your own description in the request, we will not combine it with the description from our product database

2OCT
2020

Update

16SEP
2020

New

GET /sale/matching-categories - a new resource that allows you to retrieve the suggested categories for the given phrase

15SEP
2020

New

GET /sale/compatibility-list-suggestion - a new resource that allows you to retrieve the suggested compatibilityList section

10SEP
2020

New

Wholesale price list for B2B transactions

PUT /sale/loyalty/promotions/{promotionId} - change wholesale price list settings

Update

New feature in resources:

POST /sale/loyalty/promotions

GET /sale/loyalty/promotions

PUT /sale/offer-modification-commands/{commandId}

10SEP
2020

Update

GET /sale/offers - new filtering options

1SEP
2020

New

Send with Allegro - new tool for managing parcels:

GET /parcel-management/delivery-services - retrieve a list of delivery services

PUT /parcel-management/parcel-create-commands/{commandId} - create a new parcel

GET parcel-management/parcel-create-commands/{commandId} - check parcel creation status

GET /parcel-management/parcels/{parcelId} - retrieve parcel details

PUT /parcel-management/cancel-commands/{commandId} - cancel a parcel

GET /parcel-management/cancel-commands/{commandId} - check parcel cancellation status

GET /parcel-management/pickup-date-proposals - check pickup date proposals

PUT /parcel-management/parcel-pickup-request-commands/{commandId} - request parcel pickup by a courier

GET /parcel-management/parcel-pickup-request-commands/{commandId} - check parcel pickup request status

GET /parcel-management/parcels/label - create a label for parcel

GET /parcel-management/parcels/protocol - retrieve parcel protocol

28AUG
2020

Update

GET /sale/categories/{categoryId}/parameters - we have introduced new field - "customValuesEnabled"

27AUG
2020

Update

GET /offers/listing - search for offers by the seller login

6AUG
2020

Update

Add your own parameter via REST API

New features in resources:

GET /sale/categories

GET /sale/categories/categoryId

GET /order/checkout-forms - filter orders by multiple values

15JUL
2020

Update

14JUL
2020

Update

PUT /sale/offer-modification-commands/{commandId} - batch offer modification - change VAT rate

26JUN
2020

Update

POST /sale/product-offers - we have added support for the following fields: "name", "external.id" i "delivery.additionalInfo"

10JUN
2020

New

GET /charity/fundraisingCampaigns - we have enabled listing a charity offer

9JUN
2020

New

GET /billing/billing-types - a new resource for retrieving a list of billing types

4JUN
2020

Update

New fields “netPrice” and “tax” in: