Packeta labels
Packeta labels are labels generated directly by the Packeta system. They are primarily intended for packets delivered within the Packeta network, including:
- Packeta pick-up points (PUDOs)
- Z-BOXes
For packets delivered by external carriers, we recommend using carrier labels instead of Packeta labels. For more information, see Label Types.
Available output formats
PDF
Methods:
- Use
packetLabelPdf()to generate a label for a single packet. - Use
packetsLabelsPdf()to generate labels for multiple packets in single request.
Supported label formats:
A6 on A6- 105x148 mm (A6) label on a page of the same sizeA7 on A7- 105x74 mm (A7) label on a page of the same sizeA6 on A4- 105x148 mm (A6) label on a page of size 210x297 mm (A4)A7 on A4- 105x74 mm (A7) label on a page of size 210x297 mm (A4)105x35mm on A4- 105x35 mm label on a page of size 210x297 mm (A4)A8 on A8- 50x74 mm (A8) label on a page of the same size
Response format:
- Base64-encoded PDF file
- Decode the Base64 content before saving or printing
Label description

- Packeta Logo (1)
- Sender's details (2-8)
- Recipient's details (9-12)
- Barcode and packet number (13-15)
- Routing details (16-20)
- Dimensions and font
- Name of your e-shop (size: 9 pt, bold)
- the e-shop's name can be configured in your client section under the Senders category
- Number of your purchase order (size: 9 pt, bold, refer to Dimensions and font tab)
- Name of your account (size: 9 pt)
- accessible from the client section in the top-right corner
- to change it, reach out to your assigned sales manager
- E-shop logo - optional
- Consignment code - B2C Z-BOX consignment code
- Dimensions and weight of the packet (size: 7.5 pt)
- Extra services
- age verification (only if age verification is required, otherwise leave empty)
- signature (only if signature is required, otherwise leave empty)
- reserved for future purposes
- Z-BOX delivery does not support extra services
- Routing codes for packet returns (size: 10 pt, bold)
- sets of strings split by a vertical line
- these codes assist in accurate tracking of the packet when a return occurs
- our system creates these strings dynamically based on the billing address of the e-shop, you can obtain them using
senderGetReturnRouting()API method
- Name and Surname of the recipient (size: 16 pt, bold, refer to Dimensions and font tab)
- Name of the Pick-up Point (size: 12 pt)
- available through Packeta Pick-up Points feed using the
labelNameparameter from the target pick-up point
- available through Packeta Pick-up Points feed using the
- Address of the Pick-up Point (size: 8 pt)
- available through Packeta Pick-up Points feed by combining the
street,city, andzipparameters
- available through Packeta Pick-up Points feed by combining the
- Note on the label - optional (size: 8 pt)
- Barcode
- tracking code in the format of a barcode using the Code 128 symbology
- the structure for the tracking code should be
Z1234567890 - Enclose the barcode with a quiet zone, an empty space on both sides of the barcode. Make sure the barcode's last line isn't too close to the edge of the paper. The quiet zone should ideally be 10 times the width of the barcode's thinnest line (generally between 0.5 cm and 1 cm).
- for further specifics on quiet zones, refer to barcode-labels.com
- Formatted text version of the tracking code (size: letter “Z” and first 7 digits 12 pt, last 3 digits 14 pt, bold)
- to be displayed below the barcode, structured like this:
Z 123 4567 890 - the last three digits should be notably larger than the rest of the number
- to be displayed below the barcode, structured like this:
- QR code (size: 35 × 35 mm)
- encodes the packet’s tracking number (35 × 35 mm)
- the structure for the tracking code should be
Z1234567890
- Packet routing code (size: 20 pt, bold)
- routing code of the destination branch or external carrier is printed in white on black
- routing code available through Packeta Pick-up Points feed as the
labelRoutingof the destination branch
- Cash-On-Delivery (COD) (size: 20 pt, bold)
- necessary for packets requiring cash on delivery (otherwise leave empty)
- Delivery method type (size: 20 pt, bold)
- CD = pick-up point delivery
- HD = home delivery
- ZB = Z-BOX delivery
- Service type (size: 20 pt, bold)
- standard value is B2C, unless you use different services
- Label creation date (size: 7 pt)
- corresponds to the date and time when the label is created
The following dimensions apply to all types of Packeta’s labels:
- Labels are formatted in A6 size, with a landscape orientation
- Helvetica font is used for all text strings
- Points correspond to standard PostScript Points, with a density of 72 ppi
- Name and Surname:
- For a length of 34 characters or fewer, a font size of 16 pt
- For a length exceeding 34 characters, a font size of 13 pt
- Order Number:
- For a length of 27 characters or fewer, a font size of 9 pt
- For a length exceeding 28 characters, a 6.5 pt font size

ZPL
Method:
packetLabelZpl()when printing directly on Zebra-compatible or other ZPL-supported thermal printers.
Supported label formats:
A6A7
Supported label resolution (DPI):
203300
Response format:
- Escaped ZPL content
- Unescape the response before sending it to the printer
Example requests
Example packetLabelPdf() request/response
packetLabelPdf() request/response- REST
- SOAP
- PHP
- C#
- Node.js
<!--request-->
<packetLabelPdf>
<apiPassword>{{API_PASSWORD}}</apiPassword>
<packetId>1234567890</packetId>
<format>A6 on A6</format>
<offset>0</offset>
</packetLabelPdf>
<!--response-->
<response>
<status>ok</status>
<result>JVBERi0xLjcKJeLjz9MKNyAwIG9iago8P.....NDU1PiBdID4+CnN0YXJ0eHJlZgo4ODE1NwolJUVPRgo=</result>
</response>
<!--request-->
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soap="http://www.zasilkovna.cz/api/soap.wsdl2">
<soapenv:Header/>
<soapenv:Body>
<soap:packetLabelPdf>
<apiPassword>{{API_PASSWORD}}</apiPassword>
<packetId>1234567890</packetId>
<format>A6 on A6</format>
<offset>0</offset>
</soap:packetLabelPdf>
</soapenv:Body>
</soapenv:Envelope>
<!--response-->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.zasilkovna.cz/api/soap.wsdl">
<SOAP-ENV:Body>
<ns1:packetLabelPdfResponse>
<packetLabelPdfResult>JVBERi0xLjcKJeLjz9MKNyAwIG9iago8.....PCAvVHVmCjc4OTU5CiUlRU9GCg==</packetLabelPdfResult>
</ns1:packetLabelPdfResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
<?php
$apiPassword = 'apiPasswordx';
$packetId = '1234567890';
$format = 'A6 on A6';
$offset = 0;
try {
$client = new SoapClient("https://soap.api.packeta.com/api/soap.wsdl");
$result = $client->packetLabelPdf($apiPassword, $packetId, $format, $offset);
header('Content-Type: application/pdf');
echo $result;
} catch (SoapFault $e) {
echo $e->getMessage();
}
using System;
using System.ServiceModel;
using System.Threading.Tasks;
using PacketaService;
using System.IO;
namespace PacketaClientExample
{
class Program
{
static async Task Main(string[] args)
{
BasicHttpsBinding binding = new BasicHttpsBinding() { MaxReceivedMessageSize = int.MaxValue };
EndpointAddress endpointAddress = new EndpointAddress("https://www.zasilkovna.cz/api/soap");
string apiPassword = "apiPassword";
ulong packetId = 1234567890;
string format = "A6 on A6";
uint offset = 0;
PacketaClient client = new PacketaClient(binding, endpointAddress);
try
{
packetLabelPdfResponse response = await client.packetLabelPdfAsync(
new packetLabelPdfRequest(apiPassword, packetId, format, offset)
);
//Process response
await File.WriteAllBytesAsync("./label.pdf", response.packetLabelPdfResult);
}
catch (Exception e)
{
Console.WriteLine(e.Message);
}
}
}
}
import { Builder, Parser } from "xml2js"
import * as fs from "node:fs/promises"
const requestBody = {
packetLabelPdf: {
apiPassword: "apiPassword",
packetId: "1234567890",
format: "A6 on A6",
offset: 0
}
}
try {
const response = await fetch(
"https://www.zasilkovna.cz/api/rest",
{
method: "POST",
body: new Builder().buildObject(requestBody)
}
);
const responseBody = await new Parser({ explicitArray: false }).parseStringPromise(await response.text());
//process response
if(responseBody.response.status === "ok") {
await fs.writeFile("label.pdf", Buffer.from(responseBody.response.result, 'base64'));
}
}
catch (exception) {
console.log(exception);
}
Example packetsLabelsPdf() request/response
packetsLabelsPdf() request/response- REST
- SOAP
- PHP
- C#
- Node.js
<!--request-->
<packetsLabelsPdf>
<apiPassword>{{API_PASSWORD}}</apiPassword>
<packetIds>
<id>1234567890</id>
<id>1234567891</id>
</packetIds>
<format>A6 on A6</format>
<offset>0</offset>
</packetsLabelsPdf>
<!--response-->
<response>
<status>ok</status>
<result>JVBERi0xLjcKJeLjz9MKNyAwIG9iago8PCAv.....OT4gXSA+PgpzdGFydHhyZWYKODg1MjQKJSVFT0YK</result>
</response>
<!--request-->
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soap="http://www.zasilkovna.cz/api/soap.wsdl2" xmlns:soap1="http://www.zasilkovna.cz/api/soap.wsdl">
<soapenv:Header/>
<soapenv:Body>
<soap:packetsLabelsPdf>
<apiPassword>{{API_PASSWORD}}</apiPassword>
<packetIds>
<soap1:id>1234567890</soap1:id>
<soap1:id>1234567891</soap1:id>
</packetIds>
<format>A6 on A6</format>
<offset>0</offset>
</soap:packetsLabelsPdf>
</soapenv:Body>
</soapenv:Envelope>
<!--response-->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.zasilkovna.cz/api/soap.wsdl">
<SOAP-ENV:Body>
<ns1:packetLabelPdfResponse>
<packetLabelPdfResult>JVBERi0xLJeLjz9MKNyAwI.....G9iago8vjc4OTU5CiUlRU9GCg==</packetLabelPdfResult>
</ns1:packetLabelPdfResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
<?php
$apiPassword = "apiPassword";
$packetIds = [
"1234567890",
"1234567891",
"1234567892",
];
$format = 'A6 on A6';
$offset = 0;
try {
$client = new SoapClient('https://www.zasilkovna.cz/api/soap.wsdl');
$result = $client->packetsLabelsPdf($apiPassword, $packetIds, $format, $offset);
header('Content-Type: application/pdf');
echo $result;
} catch (SoapFault $e) {
echo $e->getMessage();
}
using System;
using System.ServiceModel;
using System.Threading.Tasks;
using PacketaService;
using System.IO;
namespace PacketaClientExample
{
class Program
{
static async Task Main(string[] args)
{
BasicHttpsBinding binding = new BasicHttpsBinding() { MaxReceivedMessageSize = int.MaxValue };
EndpointAddress endpointAddress = new EndpointAddress("https://www.zasilkovna.cz/api/soap");
string apiPassword = "apiPassword";
ulong[] packetIds = { 1234567890 };
string format = "A6 on A6";
uint offset = 0;
PacketaClient client = new PacketaClient(binding, endpointAddress);
try
{
packetsLabelsPdfResponse response = await client.packetsLabelsPdfAsync(
new packetsLabelsPdfRequest(apiPassword, packetIds, format, offset)
);
//Process response
await File.WriteAllBytesAsync("./label.pdf", response.packetsLabelsPdfResult);
}
catch (Exception e)
{
Console.WriteLine(e.Message);
}
}
}
}
import { Builder, Parser } from "xml2js"
import * as fs from "node:fs/promises"
const requestBody = {
packetsLabelsPdf: {
apiPassword: "apiPassword",
packetIds: {
id: [
"1234567890",
"1234567891"
]
},
format: "A6 on A6",
offset: 0
}
}
try {
const response = await fetch(
"https://www.zasilkovna.cz/api/rest",
{
method: "POST",
body: new Builder().buildObject(requestBody)
}
);
const responseBody = await new Parser({ explicitArray: false }).parseStringPromise(await response.text());
//process response
if (responseBody.response.status === "ok") {
await fs.writeFile("label.pdf", Buffer.from(responseBody.response.result, 'base64'));
}
}
catch (exception) {
console.log(exception);
}
Example packetLabelZpl() request/response
packetLabelZpl() request/response- REST
- SOAP
- PHP
- C#
- Node.js
<!--request-->
<packetLabelZpl>
<apiPassword>{{API_PASSWORD}}</apiPassword>
<packetId>4308024368</packetId>
<dpi>300</dpi>
</packetLabelZpl>
<!--response-->
<?xml version="1.0" encoding="utf-8"?>
<response>
<status>ok</status>
<result>^XA^CI28^CWN,TT0003M_.FNT^LH0,0^FO25,25^GB1187,1700,4^FS^FO25,25^GB363,700,2^FS^FO100,100^BY4^BCB,140,N,N,N,A^FDZ4308024368^FS^ANB,50^FB700,1,0,C^FT322,725^FDZ 123 4567 890\&^FS^FO388,25^GB230,700,2^FS^ANB,70^FB700,1,0,C^FT538,725^FDZasilkovna.cz\&^FS^FO618,25^GB593,1133,2^FS^ANB,40^FB983,1,0,L^FT750,1083^FDPříjemce\&^FS^ANB,50^FB983,1,0,L^FT830,1084^FDJohn Doe\&^FS^ANB,50^FB983,1,0,L^FT829,1084^FDJohn Doe\&^FS^ANB,50^FB983,1,0,L^FT828,1084^FDJohn Doe\&^FS^ANB,50^FB983,1,0,L^FT828,1083^FDJohn Doe\&^FS^ANB,50^FB983,1,0,L^FT828,1082^FDJohn Doe\&^FS^ANB,50^FB983,1,0,L^FT829,1082^FDJohn Doe\&^FS^ANB,50^FB983,1,0,L^FT830,1082^FDJohn Doe\&^FS^ANB,50^FB983,1,0,L^FT830,1083^FDJohn Doe\&^FS^FO841,591^GB73,491,73^FS^ANB,50^FB491,1,0,C^FR^FT903,1083^FDC25--0--8395\&^FS^ANB,50^FB983,4,0,L^FT1126,1083^FDDEPO Praha - Nehvizdy\&^FS^FO25,725^GB593,1000,2^FS^ANB,40^FB850,1,0,L^FT156,1650^FDOdesílatel\&^FS^ANB,50^FB850,1,0,L^FT236,1650^FDMyEshop.cz\&^FS^ANB,50^FB850,1,0,L^FT235,1651^FDMyEshop.cz\&^FS^ANB,50^FB850,1,0,L^FT235,1650^FDMyEshop.cz\&^FS^ANB,50^FB850,1,0,L^FT234,1650^FDMyEshop.cz\&^FS^ANB,50^FB850,1,0,L^FT235,1649^FDMyEshop.cz\&^FS^ANB,50^FB850,1,0,L^FT235,1649^FDMyEshop.cz\&^FS^ANB,50^FB850,1,0,L^FT236,1649^FDMyEshop.cz\&^FS^ANB,50^FB850,1,0,L^FT236,1650^FDMyEshop.cz\&^FS^ANB,50^FB850,1,0,L^FT310,1650^FD12345 - test order\&^FS^ANB,50^FB850,1,0,L^FT309,1651^FD12345 - test order\&^FS^ANB,50^FB850,1,0,L^FT309,1650^FD12345 - test order\&^FS^ANB,50^FB850,1,0,L^FT308,1650^FD12345 - test order\&^FS^ANB,50^FB850,1,0,L^FT309,1649^FD12345 - test order\&^FS^ANB,50^FB850,1,0,L^FT309,1649^FD12345 - test order\&^FS^ANB,50^FB850,1,0,L^FT310,1649^FD12345 - test order\&^FS^ANB,50^FB850,1,0,L^FT310,1650^FD12345 - test order\&^FS^ANB,50^FB850,1,0,L^FT383,1650^FD=C16-D99-7135=P\&^FS^ANB,50^FB850,1,0,L^FT457,1650^FD7.3.2022 10:00:07\&^FS^ANB,40^FB850,2,0,L^FT584,1650^FDNote:\&^FS^ANB,40^FB850,2,0,L^FT583,1651^FDNote:\&^FS^ANB,40^FB850,2,0,L^FT582,1650^FDNote:\&^FS^ANB,40^FB850,2,0,L^FT582,1650^FDNote:\&^FS^ANB,40^FB850,2,0,L^FT582,1649^FDNote:\&^FS^ANB,40^FB850,2,0,L^FT583,1649^FDNote:\&^FS^ANB,40^FB850,2,0,L^FT584,1649^FDNote:\&^FS^ANB,40^FB850,2,0,L^FT584,1650^FDNote:\&^FS^ANB,40^FB850,2,0,L^FT583,1650^FDNote: Label note\&^FS^FO618,1158^GB593,566,2^FS^XZ</result>
</response>
<!--request-->
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soap="http://www.zasilkovna.cz/api/soap.wsdl2">
<soapenv:Header/>
<soapenv:Body>
<soap:packetLabelZpl>
<apiPassword>{{API_PASSWORD}}</apiPassword>
<packetId>4308024368</packetId>
<dpi>300</dpi>
</soap:packetLabelZpl>
</soapenv:Body>
</soapenv:Envelope>
<!--response-->
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.zasilkovna.cz/api/soap.wsdl">
<SOAP-ENV:Body>
<ns1:packetLabelZplResponse>
<packetLabelZplResult><![CDATA[^XA^CI28^CWN,TT0003M_.FNT^LH0,0^FO25,25^GB1187,1700,4^FS^FO25,25^GB363,700,2^FS^FO100,100^BY4^BCB,140,N,N,N,A^FDZ4308024368^FS^ANB,50^FB700,1,0,C^FT322,725^FDZ 430 8024 368\&^FS^FO388,25^GB230,700,2^FS^ANB,70^FB700,1,0,C^FT538,725^FDZasilkovna.cz\&^FS^FO618,25^GB593,1133,2^FS^ANB,40^FB983,1,0,L^FT750,1083^FDPříjemce\&^FS^ANB,50^FB983,1,0,L^FT830,1084^FDJohn Doe\&^FS^ANB,50^FB983,1,0,L^FT829,1084^FDJohn Doe\&^FS^ANB,50^FB983,1,0,L^FT828,1084^FDJohn Doe\&^FS^ANB,50^FB983,1,0,L^FT828,1083^FDJohn Doe\&^FS^ANB,50^FB983,1,0,L^FT828,1082^FDJohn Doe\&^FS^ANB,50^FB983,1,0,L^FT829,1082^FDJohn Doe\&^FS^ANB,50^FB983,1,0,L^FT830,1082^FDJohn Doe\&^FS^ANB,50^FB983,1,0,L^FT830,1083^FDJohn Doe\&^FS^FO841,591^GB73,491,73^FS^ANB,50^FB491,1,0,C^FR^FT903,1083^FDC25--0--8395\&^FS^ANB,50^FB983,4,0,L^FT1126,1083^FDDEPO Praha - Nehvizdy\&^FS^FO25,725^GB593,1000,2^FS^ANB,40^FB850,1,0,L^FT156,1650^FDOdesílatel\&^FS^ANB,50^FB850,1,0,L^FT236,1650^FDMyEshop.cz\&^FS^ANB,50^FB850,1,0,L^FT235,1651^FDMyEshop.cz\&^FS^ANB,50^FB850,1,0,L^FT235,1650^FDMyEshop.cz\&^FS^ANB,50^FB850,1,0,L^FT234,1650^FDMyEshop.cz\&^FS^ANB,50^FB850,1,0,L^FT235,1649^FDMyEshop.cz\&^FS^ANB,50^FB850,1,0,L^FT235,1649^FDMyEshop.cz\&^FS^ANB,50^FB850,1,0,L^FT236,1649^FDMyEshop.cz\&^FS^ANB,50^FB850,1,0,L^FT236,1650^FDMyEshop.cz\&^FS^ANB,50^FB850,1,0,L^FT310,1650^FD12345 - test order\&^FS^ANB,50^FB850,1,0,L^FT309,1651^FD12345 - test order\&^FS^ANB,50^FB850,1,0,L^FT309,1650^FD12345 - test order\&^FS^ANB,50^FB850,1,0,L^FT308,1650^FD12345 - test order\&^FS^ANB,50^FB850,1,0,L^FT309,1649^FD12345 - test order\&^FS^ANB,50^FB850,1,0,L^FT309,1649^FD12345 - test order\&^FS^ANB,50^FB850,1,0,L^FT310,1649^FD12345 - test order\&^FS^ANB,50^FB850,1,0,L^FT310,1650^FD12345 - test order\&^FS^ANB,50^FB850,1,0,L^FT383,1650^FD=C16-D99-7135=P\&^FS^ANB,50^FB850,1,0,L^FT457,1650^FD7.3.2022 04:26:05\&^FS^ANB,40^FB850,2,0,L^FT584,1650^FDNote:\&^FS^ANB,40^FB850,2,0,L^FT583,1651^FDNote:\&^FS^ANB,40^FB850,2,0,L^FT582,1650^FDNote:\&^FS^ANB,40^FB850,2,0,L^FT582,1650^FDNote:\&^FS^ANB,40^FB850,2,0,L^FT582,1649^FDNote:\&^FS^ANB,40^FB850,2,0,L^FT583,1649^FDNote:\&^FS^ANB,40^FB850,2,0,L^FT584,1649^FDNote:\&^FS^ANB,40^FB850,2,0,L^FT584,1650^FDNote:\&^FS^ANB,40^FB850,2,0,L^FT583,1650^FDNote: Label note\&^FS^FO618,1158^GB593,566,2^FS^XZ]]></packetLabelZplResult>
</ns1:packetLabelZplResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
<?php
$apiPassword = "apiPassword";
$packetId = "1234567890";
$dpi = 203;
try {
$client = new SoapClient("https://www.zasilkovna.cz/api/soap.wsdl");
$result = $client->packetLabelZpl($apiPassword, $packetId, $dpi);
var_dump($result);
} catch (SoapFault $e) {
echo $e->getMessage();
}
using System;
using System.ServiceModel;
using System.Threading.Tasks;
using PacketaService;
using System.IO;
namespace PacketaClientExample
{
class Program
{
static async Task Main(string[] args)
{
BasicHttpsBinding binding = new BasicHttpsBinding() { MaxReceivedMessageSize = int.MaxValue };
EndpointAddress endpointAddress = new EndpointAddress("https://www.zasilkovna.cz/api/soap");
string apiPassword = "apiPassword";
ulong packetId = 1234567890;
uint dpi = 300;
PacketaClient client = new PacketaClient(binding, endpointAddress);
try
{
packetLabelZplResponse response = await client.packetLabelZplAsync(
new packetLabelZplRequest(apiPassword, packetId, dpi)
);
//Process response
await File.WriteAllTextAsync("./label.zpl", response.packetLabelZplResult);
}
catch (Exception e)
{
Console.WriteLine(e.Message);
}
}
}
}
import { Builder, Parser } from "xml2js"
import * as fs from "node:fs/promises"
const requestBody = {
packetLabelZpl: {
apiPassword: "apiPassword",
packetId: "1234567890",
dpi: 300
}
}
try {
const response = await fetch(
"https://www.zasilkovna.cz/api/rest",
{
method: "POST",
body: new Builder().buildObject(requestBody)
}
);
const responseBody = await new Parser({ explicitArray: false }).parseStringPromise(await response.text());
//process response
if (responseBody.response.status === "ok") {
await fs.writeFile("label.zpl", responseBody.response.result);
}
}
catch (exception) {
console.log(exception);
}
Packeta label format example
A7 Packeta label example:

A8 Packeta label example:
