Poste Italiane is the Italian postal service provider, offering domestic and international shipping services.
Overview
| Feature | Supported |
|---|
| Countries | Italy (IT), Europe, USA, Canada, UK |
| Multi-parcel shipments | Yes |
| Cash on Delivery (COD) | Yes |
| Insurance | Yes |
| Label formats | A4, 10x11, ZPL |
| Tracking | Yes |
Configuration
Required Settings
| Setting | Type | Description |
|---|
clientId | string | Your Poste Italiane client ID |
secretId | string | Your Poste Italiane secret ID |
costCenterCode | string | Your cost center code |
Optional Settings
| Setting | Type | Default | Description |
|---|
sandboxMode | boolean | true | Use sandbox environment for testing |
partnerId | string | null | Partner ID (if applicable) |
paperlessDefault | boolean | false | Use paperless shipping by default |
defaultPrintFormat | string | "A4" | Label format: A4, 1011, or ZPL |
defaultProduct | string | "APT000902" | Default product code |
defaultCurrency | string | "EUR" | Default currency |
defaultReceiverType | string | "retailDelivery" | Receiver type |
maxWeightKg | integer | 30 | Maximum weight in kg |
maxDimensionCm | integer | 150 | Maximum single dimension in cm |
maxDimensionSumCm | integer | 225 | Maximum sum of dimensions in cm |
apiTimeoutSeconds | integer | 60 | API timeout in seconds |
maxRetryAttempts | integer | 3 | Maximum retry attempts |
Product Codes
Domestic Products
| Code | Description |
|---|
APT000902 | PosteDelivery Business Standard |
APT000901 | PosteDelivery Business Express |
International Products
| Code | Description |
|---|
APT000904 | PosteDelivery Business International Standard |
APT000903 | PosteDelivery Business International Express |
APT001013 | PosteDelivery Business International Plus |
Receiver Types
| Type | Description |
|---|
retailDelivery | Retail Delivery (B2C) |
businessDelivery | Business Delivery (B2B) |
Content Codes (International)
| Code | Description |
|---|
91 | Documents |
11 | Goods for Sale |
21 | Gift |
31 | Commercial Sample |
41 | Returned Goods |
51 | Other |
Additional Services
| Code | Description |
|---|
APT000918 | Cash on Delivery |
APT000919 | Full Coverage Insurance |
APT000912 | Signature Required |
APT000930 | Saturday Delivery |
APT000945 | Evening Delivery |
APT000928 | Reverse Service |
| Format | Description |
|---|
A4 | A4 Format for standard printers |
1011 | 10x11 Format for label printers |
ZPL | ZPL Format for Zebra thermal printers |
Cash on Delivery (COD)
| Field | Required | Description |
|---|
cash_on_delivery_amount | Yes | The amount to collect |
cash_on_delivery_currency | Yes | Currency (typically EUR) |