# Send with Allegro

Send with Allegro in Ritevo: linking the Allegro account, parcel and drop-off point settings, creating shipments and labels for Allegro orders.

The Send with Allegro integration (Wysyłam z Allegro) creates shipments for Allegro orders through the Send with Allegro service. It has no login of its own - it uses the Allegro account you already connected in Ritevo.

> **Required integration:** You need an Allegro account connected in Ritevo as an [Allegro integration](https://ritevo.com/en/docs/integrations/allegro).

You can add as many Send with Allegro integrations as you like, including several for the same account - for example with a different label format, parcel or sender address. Each works on its own.

Uniqueness is not checked, on purpose: every create call makes a new integration, also for the same `externalId`, so one account can have several integrations with different details or settings.

`externalId` is not used. The integration points to the Allegro account with `marketplaceAccountId`. There is no credentials endpoint - an auth error belongs to the Allegro integration under `/integrations/marketplaces`, and saving this integration's settings always sets `authError=false` and `active=true`.

## Which shipments it creates

- **Allegro orders only** - from the Allegro account you pick in the integration. For other orders you will not see the button, and an action ends with the **The order is not compatible with the selected integration or shipping method** error.
- **Carrier** - the one the buyer chose on Allegro. You do not pick it in Ritevo.
- **Pickup point** - when the buyer chose a parcel locker or a point, the shipment goes there.
- **Cash on delivery** - when the order is cash on delivery and the chosen Allegro delivery supports it.

## Connecting the account

Start in Ritevo:

1. Go to **Integrations** in the left panel and click **Add integration** in the top right corner.
2. In the **Shipments** section pick the **Wysyłam z Allegro** tile.
3. In the **Allegro marketplace account** field pick the account whose orders you want to ship, and in the **Account name** field enter your own name for the integration.
4. Fill in the other settings described below and click **Create integration**. The new integration's settings open.

![The integrations list in Ritevo with the Add integration button in the top right corner framed](https://ritevo.com/docs/integrations/en-integrations-list.webp)

![The Add integration screen with the Wysyłam z Allegro tile framed in the Shipments section](https://ritevo.com/docs/integrations/send-with-allegro/en-catalogue.webp)

![The Send with Allegro add screen with the Allegro marketplace account, Account name, Page size and Label format fields](https://ritevo.com/docs/integrations/send-with-allegro/en-add.webp)

## Integration settings

On the integration page you will find the fields below. You save changes with **Update integration**:

- **Allegro marketplace account** - the Allegro account whose orders you ship.
- **Account name** - your own name for the integration.
- **Page size** - A4 or A6. A4 by default.
- **Label format** - PDF or ZPL. PDF by default.
- **Pickup points** - the numbers of the points where you drop off parcels of each carrier: DPD, Poczta Polska, Allegro One, Allegro International and InPost. An empty field means a courier collects the parcel, a filled one that you drop it off at that point. The **UPS point number** is not used today.
- **Parcel details** - the type (**Parcel**, **Letter**, **Pallet** or **Other**), the dimensions in centimetres and the weight in kilograms. These go into every shipment.
- **Cash on delivery** - the **IBAN account number** and the **Account owner**. We send them only when the chosen Allegro delivery requires them.
- **Sender address on the label** - the sender details the carrier prints on the label.
- **Courier pickup address** - the address the courier collects parcels from. It can differ from the sender address on the label - for example in dropshipping: the label shows your shop, and the courier collects the parcel from the wholesaler.
- **Additional insurance** - the insurance amount of every shipment: **None**, **Order value with delivery**, **Order value without delivery** or **Fixed amount**. In **Currency source** you pick the order currency, the delivery country currency or a fixed currency.

Integration fields: `accountName`, `marketplaceAccountId` (the Allegro integration id from `GET /integrations/marketplaces`), `pageSize` = `A4` or `A6`, `labelFormat` = `PDF` or `ZPL`, point numbers `dpdPickupPointNumber`, `upsPickupPointNumber`, `pocztaPolskaPickupPointNumber`, `allegroOnePickupPointNumber`, `allegroInternationalPickupPointNumber`, `inPostPickupPointNumber`, `packageDetails` with `packageType` (**Parcel** = `PACKAGE`, **Letter** = `DOX`, **Pallet** = `PALLET`, **Other** = `OTHER`) and `length`, `width`, `height` in cm and `weight` in kg, plus `cashOnDeliveryBankDetails` with `iban` and `ownerName`.

Fields shared by shipping integrations: `senderAddress` and `pickupAddress` (`companyName`, `firstName`, `lastName`, `street`, `city`, `zipCode`, `countryCode`, `phoneNumber`, `email`) and `additionalInsurance`. In it `insuranceType`: **None** = `NONE`, **Order value with delivery** = `ORDER_AMOUNT_WITH_DELIVERY`, **Order value without delivery** = `ORDER_AMOUNT_WITHOUT_DELIVERY`, **Fixed amount** = `FIXED_AMOUNT` (amount in `fixedAmount`), and `currencySource`: **Order currency** = `ORDER_CURRENCY`, **Delivery country currency** = `DELIVERY_COUNTRY_CURRENCY`, **Fixed currency** = `FIXED` (currency in `fixedCurrency`, required with `FIXED`).

![Send with Allegro integration details: basic settings with the Allegro account and the sender address on the label](https://ritevo.com/docs/integrations/send-with-allegro/en-details.webp)

![The Pickup points card with DPD, UPS, Poczta Polska, Allegro One, Allegro International and InPost point numbers](https://ritevo.com/docs/integrations/send-with-allegro/en-pickup-points.webp)

![The Parcel details and Cash on delivery cards with parcel type, dimensions, weight, IBAN and account owner](https://ritevo.com/docs/integrations/send-with-allegro/en-package.webp)

![The Sender address on the label card with company, first and last name, address, country, phone and email fields](https://ritevo.com/docs/integrations/shipping/en-sender.webp)

![The Courier pickup address card with company, first and last name, address, country, phone and email fields](https://ritevo.com/docs/integrations/shipping/en-pickup-address.webp)

![The Additional insurance card with the Insurance type and Currency source fields](https://ritevo.com/docs/integrations/shipping/en-insurance.webp)

> **Good to know:** The integration does not book a courier pickup. You book the pickup directly with the carrier or set up a regular pickup schedule with them.

> **Good to know:** When the order's payment method is **Cash on delivery**, the shipment gets cash on delivery automatically - in the order's amount and currency.

## Creating shipments

You create a shipment from the order in two ways:

- **By hand** - in the order details, in the **Shipments** card, click the button with the Send with Allegro integration name. You only see buttons for active integrations that match the order.
- **Automatically** - with the **Create shipment** step in [order actions](https://ritevo.com/en/docs/automations/order-actions).

The shipment details come from the order:

- **Recipient** - the order's delivery address and the buyer's phone and email.
- **Pickup point** - the point the buyer chose, if the order has one.
- **Cash on delivery** - the amount to pay from the order, when the payment method is **Cash on delivery**.
- **Parcel** - one shipment is always one parcel.

In the same card every shipment has a tracking number, a state and a creation date. The states:

- **Being created** (API: "Being created" = `PENDING`; value in `shipments[].status`) - the carrier is still creating the shipment. We check it every few seconds. If the carrier does not confirm the shipment within 24 hours, it ends with an error.
- **Created successfully** (API: "Created successfully" = `SUCCESS`; value in `shipments[].status`) - the shipment is with the carrier and has a tracking number.
- **Creation failed** (API: "Creation failed" = `ERROR`; value in `shipments[].status`) - the carrier did not accept the shipment. The reason is shown next to the state, and for a carrier error also the carrier's message.

You download the label of a created shipment with the **Download** button in the **Shipments** card. You print it in two ways - the [Ritevo Printer](https://ritevo.com/en/docs/integrations/ritevo-printer) app must run on the computer with the printer:

- **By hand** - in the **Shipments** card click **Print** and pick the printer.
- **Automatically** - with the **Print shipment label** step in [order actions](https://ritevo.com/en/docs/automations/order-actions). The step prints the label of the latest shipment in the **Created successfully** state - it skips shipments being created and failed ones.

Plan label printing step by step, as two actions:

- **First action** - ends with the **Create shipment** step.
- **Second action** - starts on the **Shipment created** trigger, has the **Shipment status is** condition with **Created successfully** and a single **Print shipment label** step. This way every new shipment prints its label right away - also when the order has several parcels.

> **Good to know:** The **Print shipment label** step always prints just one label - that of the newest successful shipment. If you first create all shipments and only then turn on printing, only the last one is printed, and you print the others by hand with **Print**. If a new shipment fails, the step prints the label of the previous successful one.

> **Good to know:** Every button click and every run of the **Create shipment** step creates a new shipment with the carrier. A shipment cannot be cancelled in Ritevo - you cancel it in the carrier's panel.

### How a shipment reaches Allegro

- **Confirmation** - Allegro creates the shipment in the background, so at first it is **Being created**.
- **Tracking number** - the shipment number assigned by Allegro.
- **Cash on delivery without an account number** - when the delivery needs an account number for cash on delivery and you did not enter it in the integration, the shipment fails.
- **Delivery without cash on delivery** - a cash on delivery order with a delivery that does not support it also fails.

You create a shipment with `POST /orders/{orderId}/create-shipments/{shipmentIntegrationId}` - the response is 202, and the result shows up later in the order's `shipments[]` (`status`, `trackingNumber`, `errorType`, `errorMessage`). You download the label with `GET /orders/{orderId}/shipments/{shipmentId}/label` and request printing with `POST /orders/{orderId}/print-shipment-label/{shipmentId}/{printerIntegrationId}`.

Order actions: the **Create shipment** step is `CREATE_SHIPMENT` and **Print shipment label** is `PRINT_SHIPMENT_LABEL` - both in `actionSteps[].action.type`, with `uuidValue` = the shipping integration id (`GET /integrations/shippings`) or the printer id (`GET /integrations/printers`). The **Shipment created** trigger is `triggerType` = `CREATE_SHIPMENT`. Conditions: **Has shipment** / **Has no shipment** = `HAS_SHIPMENT` / `HAS_SHIPMENT_NOT` (`booleanValues` = `[true]`), **Shipment status is** / **Shipment status is not** = `SHIPMENT_STATUS_IS` / `SHIPMENT_STATUS_IS_NOT` (`enumValues`: `PENDING`, `SUCCESS`, `ERROR`), **Shipment belongs to integration** / **Shipment does not belong to integration** = `SHIPMENT_SHIPPING_INTEGRATION_IS` / `SHIPMENT_SHIPPING_INTEGRATION_IS_NOT` (`uuidValues` = shipping integration ids). The print step in an action takes the newest shipment with `status` = `SUCCESS` (by `createdAt`); manual printing via `POST /orders/{orderId}/print-shipment-label/...` also accepts only a `SUCCESS` shipment and returns `SHIPMENT_NOT_FOUND` otherwise. `SHIPMENT_STATUS_IS` is met when any shipment of the order has the given status, not only the latest. Full description: [Order actions](https://ritevo.com/en/docs/automations/order-actions).

## Reconnection required

Send with Allegro has no login of its own, so it never needs reconnecting itself. When the Allegro account stops working, reconnect it on the [Allegro integration](https://ritevo.com/en/docs/integrations/allegro#reconnect) page - shipments start working again with no change in this integration.

## Deleting the integration

**Delete integration** turns the integration off in Ritevo. Shipments created earlier stay in the orders and with the carrier. **Restore integration** turns it back on.

## What the integration does not do

- It does not book a courier pickup.
- It does not cancel shipments.
- It does not track a shipment after it is created - you check the delivery state with the carrier.
- It does not send the tracking number to the sales channel.
- It does not create shipments with several parcels.
- It does not create shipments for orders from outside the chosen Allegro account.

## The integration through the API

This integration's endpoints are under `/integrations/shippings/send-with-allegro`, and the ones shared by the whole type (list, get one, delete, restore) under `/integrations/shippings`. The current paths, fields, types and response codes are always in Swagger: https://api.ritevo.com/api/v1/api-docs.


---

All help in one file: https://ritevo.com/llms-full.txt. Help map with links to every page: https://ritevo.com/llms.txt.