Prints a label for a parcel that is not an order in Omnicado, with a carrier installed on the account (customLabels: true in /labels/carriers: Packeta, GLS, PPL, DPD).
reference identifies the parcel. Sending the same reference again returns the label already printed (200) and never registers a second parcel with the carrier, so a timed-out request can be safely retried.
The parcel ships from the expedition address of a selling channel: Packeta uses the channel's Packeta sender label, GLS and PPL its primary expedition address, DPD the DSW set for the channel in the DPD installation. PPL picks the product the expedition would: Smart for a pickup point, Connect outside the Czech Republic, Business otherwise, each in its cash-on-delivery variant when cashOnDelivery is sent.
Body
Required
-
Your id of the parcel, unique within the account. Repeating it returns the label already printed instead of a new parcel.
Format should match the following pattern:
^[A-Za-z0-9._-]{1,64}$. -
A carrier with
customLabels: truein/labels/carriersValues are
dpd,dpdSk,gls,oneByAllegro,packeta,ppl,sps,toptrans, orwedo. -
Defaults to the account's label format
Values are
pdforzpl. -
The carrier's pickup point (Packeta point, PPL ParcelShop, DPD Pickup). Without it the parcel is delivered to the address. Not available for GLS.
-
Leave out when there is no cash on delivery
-
Parcel value. Required for Packeta unless
cashOnDeliveryis sent. -
Packeta carries one parcel per packet; send one request per parcel.
At least
1but not more than20elements.
Responses
-
Label printed
-
A label with this reference was printed before; it is returned again
-
validation_failed -
label_in_progress(another request with the same reference is still printing);label_cancelled(the reference belongs to a cancelled label, use a new one) -
carrier_not_supported,carrier_not_installed,carrier_not_configured,sender_not_found,missing_sender_address,label_format_not_supported,invalid_shipment(the carrier cannot ship the parcel as sent;errorsays what to change) -
carrier_error: the carrier refused the parcel;errorcarries its reason
curl \
--request POST 'api.services.omnicado.com/api/v2/labels/custom' \
--header "X-OMNICADO-TOKEN: $API_KEY" \
--header "Content-Type: application/json" \
--data '{
"reference": "ESHOP-2026-004211",
"carrier": "packeta",
"labelFormat": "pdf",
"sender": {
"sellingChannelId": 812
},
"recipient": {
"name": "Jana Nováková",
"companyName": "string",
"street": "Křižíkova 12",
"city": "Praha",
"zip": "18600",
"countryCode": "CZ",
"phone": "+420777123456",
"email": "jana@example.cz"
},
"pickupPointId": "string",
"cashOnDelivery": {
"amount": "1290.00",
"currency": "CZK",
"variableSymbol": "4211"
},
"declaredValue": {
"amount": "1290.00",
"currency": "CZK"
},
"parcels": [
{
"weightKg": 1.2
}
],
"note": "Ring twice"
}'
{
"reference": "ESHOP-2026-004211",
"carrier": "packeta",
"labelFormat": "pdf",
"sender": {
"sellingChannelId": 812
},
"recipient": {
"name": "Jana Nováková",
"companyName": "string",
"street": "Křižíkova 12",
"city": "Praha",
"zip": "18600",
"countryCode": "CZ",
"phone": "+420777123456",
"email": "jana@example.cz"
},
"pickupPointId": "string",
"cashOnDelivery": {
"amount": "1290.00",
"currency": "CZK",
"variableSymbol": "4211"
},
"declaredValue": {
"amount": "1290.00",
"currency": "CZK"
},
"parcels": [
{
"weightKg": 1.2
}
],
"note": "Ring twice"
}
{
"orderId": 1843311,
"reference": "ESHOP-2026-004211",
"carrier": "packeta",
"labelFormat": "pdf",
"trackingNumbers": [
"Z1234567890"
],
"trackingUrl": "https://tracking.packeta.com/cs/?id=Z1234567890",
"cancelled": false,
"label": {
"contentType": "application/pdf",
"content": "JVBERi0xLjQK..."
}
}
{
"orderId": 1843311,
"reference": "ESHOP-2026-004211",
"carrier": "packeta",
"labelFormat": "pdf",
"trackingNumbers": [
"Z1234567890"
],
"trackingUrl": "https://tracking.packeta.com/cs/?id=Z1234567890",
"cancelled": false,
"label": {
"contentType": "application/pdf",
"content": "JVBERi0xLjQK..."
}
}
{
"error": "Carrier ppl is not installed on this account",
"code": "carrier_not_installed"
}
{
"error": "Carrier ppl is not installed on this account",
"code": "carrier_not_installed"
}
{
"error": "Carrier ppl is not installed on this account",
"code": "carrier_not_installed"
}
{
"error": "Carrier ppl is not installed on this account",
"code": "carrier_not_installed"
}