Skip to main content

Allegro

Allegro is Poland's largest e-commerce platform, offering integrated shipping services through various carriers.

Overview

FeatureSupported
CountriesPoland (PL)
Multi-parcel shipmentsYes
Cash on Delivery (COD)Yes
InsuranceYes
Label formatsPDF, ZPL
TrackingYes

Configuration

Required Settings

SettingTypeDescription
accessTokenstringYour Allegro OAuth access token
refreshTokenstringYour Allegro OAuth refresh token
tokenExpiresAtdatetimeToken expiration timestamp
clientIdstringYour Allegro application client ID
clientSecretstringYour Allegro application client secret

Optional Settings

SettingTypeDefaultDescription
ibanAccountNumberstringnullIBAN account for COD payments
defaultLabelFormatstring"PDF"Label format: PDF or ZPL

Authentication

Allegro uses OAuth 2.0 authentication. The system automatically refreshes tokens when they expire.

FieldDescription
accessTokenShort-lived token for API requests
refreshTokenLong-lived token for obtaining new access tokens
tokenExpiresAtTimestamp when access token expires
Token Refresh

The system automatically refreshes the access token 5 minutes before expiration.

Cash on Delivery (COD)

FieldRequiredDescription
cash_on_delivery_amountYesThe amount to collect
cash_on_delivery_currencyYesCurrency (typically PLN)
ibanAccountNumberYesIBAN account for receiving COD payments

Label Formats

FormatDescription
PDFStandard PDF format for office printers
ZPLZebra Programming Language for thermal printers