One by Allegro API

Globe Pickup Points integrates with One by Allegro (formerly WEDO), a Czech carrier delivering to parcel boxes, Intime pickup points and home addresses through the OneDelivery 3.0 API. With this integration, you can:

Export orders to One by Allegro directly from Shopify
Print shipping labels within Shopify
Ship to a parcel box, a pickup point or the customer’s address
Collect cash on delivery

Enabling One by Allegro API integration

In your Shopify admin, open Globe Pickup Points and navigate to Shipping labels. Add a new carrier and select One by Allegro.
Enter your Token ID and API password. You can find both in the One by Allegro client zone under API settings. If you don’t have them, contact One by Allegro support (eshop-onecz@allegro.com).
Click Test connection to confirm the credentials are accepted before you save.
Fill in the sender address — Sender — company name, Sender — street, Sender — street number, Sender — city and Sender — postcode. The sender address is printed on every label and used for parcel pickup, and it is sent with every shipment (One by Allegro does not fall back to a default address stored on your account). The integration always submits Czechia as the sender country.
Fill in Default length in millimeters, Default width in millimeters and Default height in millimeters. These are mandatory — One by Allegro rejects shipments without package dimensions.
Optionally set a Default weight (kg) used when a product has no weight in Shopify.
Configure fulfillment and tagging options as needed.
Map your Shopify shipping methods to One by Allegro.

Exporting and printing labels

You can export orders to One by Allegro and print shipping labels directly from Shopify, either in bulk or individually. See Creating shipping labels for the full workflow.

Each exported order becomes one shipment with a single package. The returned package number is used as the tracking number, and the tracking link points to the One by Allegro tracking page. If automatic fulfillment is enabled, Shopify is fulfilled with the tracking number and the carrier name One by Allegro.

The API accepts only letters, digits, spaces, commas and periods in the parcel description and reference fields. Globe sanitizes these automatically — the description is Order <order name> and the order name is used as reference number 1, shortened to 20 characters.

Delivery methods

One by Allegro resolves the delivery method at export time from the Product type you select. The default is AUTO, which is what most merchants should keep.

Product type	Behaviour
AUTO	Uses the One by Allegro pickup point selected at checkout — a parcel box becomes BOX, a branch becomes PUDO. If the order has no One by Allegro point, the parcel is sent to the delivery address.
TO_DOOR	Delivery to the customer’s address. Any selected pickup point is ignored.
BOX	Delivery to a One Box parcel box. Requires a One by Allegro point on the order.
PUDO	Delivery to a staffed pickup point (Intime branch). Requires a One by Allegro point on the order.

If you choose BOX or PUDO explicitly and the order has no One by Allegro pickup point on it, the export is rejected for that order. Point codes come from the pickup point the customer selected in the Globe selector — see Adding pickup point carriers.

All shipments are exported with the Standard service. Czech and Slovak recipient phone numbers are automatically converted to international format (+420 / +421) so that carrier SMS notifications can be sent.

Package weight and dimensions

One by Allegro rejects shipments without package dimensions, so the defaults in the carrier settings are required, not optional.

Weight — taken from the Shopify order. If the order has no weight, the Default weight (kg) from the carrier settings is used. If neither is available, the export fails for that order.
Dimensions — always taken from the Default length / width / height in millimeters fields. If any of them is empty or zero, the export fails with a message telling you to fill them in.

Cash on delivery (COD)

One by Allegro supports COD. When an order uses a cash on delivery payment method, the COD amount is taken from the order and sent in the order’s currency together with the shipment. There is no separate bank account field in the carrier settings — payouts are handled through your One by Allegro contract.

Delivery status

Delivery status sync is not available. One by Allegro is not part of Globe’s delivery-status synchronization, so parcel statuses are not written back to Shopify. The tracking number and tracking link are still attached to the fulfillment, so customers can follow the parcel on the carrier’s tracking page.

Label printing

Labels are returned by One by Allegro as a single PDF covering the whole printed batch, in one of two formats:

Format	Description
PDF_A6	One label per page (default)
PDF_A4	One label per A4 page

The OneDelivery API has no support for printing from a chosen position on a sheet, so partially used label sheets cannot be reused with this carrier.

Returns and cancellation

Return labels are not supported through this integration.
Shipments cannot be cancelled. The OneDelivery API has no cancel or delete endpoint. Once an order has been exported, the shipment stays in your One by Allegro account — simply do not hand the parcel over, or resolve it in the One by Allegro portal.

Troubleshooting

Issue	Resolution
`Failed to authenticate with One by Allegro`	Check the Token ID and API password in the carrier settings and use Test connection. A 401 response means the credentials are invalid.
`Order requires a One by Allegro pickup point for BOX/PUDO delivery`	The product type is set to BOX or PUDO but the order has no One by Allegro pickup point. Use AUTO or TO_DOOR, or check that the customer selected a One by Allegro point at checkout.
`Order … has no weight`	Set the product weight in Shopify, enter the weight manually during export, or fill in Default weight (kg).
`default package dimensions are not set`	Fill in the default length, width and height (in millimeters) in the One by Allegro settings — the API requires them on every shipment.
Recipient does not receive carrier notifications	Only Czech and Slovak numbers get an automatic country prefix. For other countries, store the phone number in full international format on the order.
`One by Allegro did not return a PDF label`	The API responded with something other than a PDF. Retry the print; if it keeps failing, contact One by Allegro support with the shipment number.
Order exported by mistake	Shipments cannot be deleted through the API. Do not hand the parcel over and resolve the shipment in the One by Allegro portal.

Add One by Allegro pickup points to your Shopify store — pricing, demo & setup →