Client section
Overview
The Client section provides a web interface for packet management and packet creation without direct API integration.
Common use cases include:
- Packet creation (manual/ import)
- Label printing
- Packet management
For configuration and usage instructions, see:
Packet import (CSV)
Packeta provides a CSV template as a semi-automated packet creation process for packet import.
Download the example CSV file for a complete reference implementation of the format.
File format
The CSV file must adhere to the following rules:
- The file encoding must be
UTF-8. This encoding is critical to validate and transmit electronic data across carriers globally. - Acceptable separators include the comma
,or semicolon;characters. - Acceptable decimal point separators are the dot
.and comma,. If the comma is used as the CSV separator, a comma inside quotes"must be used instead. - Any whitespace characters at the beginning or end of the value will be removed.
- The first two rows are reserved:
- Row 1 must contain the string
version 8in the first cell. Any additional content is ignored. - Row 2 is ignored.
- Row 1 must contain the string
- Packet data starts on row 3.
- Optionally, you can enclose the cell content within double quote
"characters. If you need to include a double quote as part of the value, such as inJohn "Billy" Doe, you should escape the quote by doubling it. Following this rule, the name in the previous example should appear asJohn ""Billy"" Doe.
Fields reference
"version 8"
,"Order number", "Name", "Surname", "Company", "Email", "Phone", "COD", "Currency", "Value", "Weight", "Pick-up point or carrier", "Sender indication", "Adult content", "Delayed delivery", "Street", "House number", "City", "ZIP", "Carrier pick-up point", "Size - width", "Size - height", "Size - depth", "Note", "Allow public tracking", "Allow tracking for users", "Romania CIF Number", "Affiliate ID", "Is subject to Romania logistics tax", "Country of origin of the packet"
,"20","John","Doe",,"john@doe.com","+420601234567","1200","CZK","1200.50","0.8",95,"my-eshop.com","0",,,,,,,,,,
,"201600002","John","Doe","ACME ltd.","john@doe.com","+420601234567","0","CZK","1500","1.2",3060,"my-eshop.com","0",,,,,,"AI0B5","100","100","100",
| Col. | Field name | Format | Required | Description |
|---|---|---|---|---|
| 1 | Reserved | The first column is reserved and needs to be empty. | ||
| 2 | Order number | 1-24 characters | Yes | Order number (from your eshop). If the value is shorter than 4 charactes, it will be padded by 0 characters from left, i.e. 0015. |
| 3 | Name | 1-32 characters (regex /^[\p{L}\p{N} ,.'\-&()]+$/ui) | Yes | Recipient's name. |
| 4 | Surname | 1-32 characters (regex /^[\p{L}\p{N} ,.'\-&()]+$/ui) | Yes | Recipient's surname. |
| 5 | Company | 1-32 characters | No | Recipient's company. |
| 6 | valid email | If no phone | Recipient's email. | |
| 7 | Phone | valid phone number | If no email | Recipient's phone number. The phone number is validated and needs to be in the valid destination country's format. |
| 8 | COD | decimal, non-negative | No | For CZK only whole values are allowed, for EUR max 2 decimal places are allowed, for HUF only multiples of 5 are allowed. |
| 9 | Currency | ISO 4217 code | No | If left blank, currency of the destination country is used. The currency applies to COD and Value fields. |
| 10 | Value | decimal > 0 | Yes | Same rules apply as with the field COD. The value should reflect real value of the packet, it is used for insurance purposes. |
| 11 | Weight | decimal > 0 | Yes | The weight of the packet in kilograms (kg). |
| 12 | Pick-up point or carrier | integer | Yes | Unique ID of the pick-up point or an home delivery service. |
| 13 | Sender indication | 1-64 characters | If you have more senders | A label of your sender (e-shop). In case you are sending packets as more than one sender, this field is required. The latest active record is taken. |
| 14 | Adult content | 0-1 | No | Indicates whether the packet is to be delivered only to a person older than 18 years of age. Identification will be required on pickup. |
| 15 | Delayed delivery | date d.m.Y | No | Delays the delivery so that the packet isn't delivered before this date. Accepted dates are from today to 14 days from today. |
| 16 | Street | 1-32 characters | On home delivery | |
| 17 | House number | 1-16 characters | On home delivery | |
| 18 | City | 1-32 characters | On home delivery | |
| 19 | ZIP | valid ZIP | On home delivery | Valid destination country's ZIP code. |
| 20 | Carrier pick-up point | String | If carrier requires it | Unique ID of the carrier pick-up point |
| 21 | Size - width | String | If carrier requires it | Packet width in mm |
| 22 | Size - height | String | If carrier requires it | Packet height in mm |
| 23 | Size - depth | String | If carrier requires it | Packet depth in mm |
| 24 | Note | 1-128 characters | No | Sender's note. It will be displayed on the label, if supported by courier. It will be shortened up to 32 characters, if limited by courier. |
| 25 | Allow public tracking | 0 or 1 | No | Allow public tracking of package. |
| 26 | Allow tracking for users | 16 characters (digits and letters) separated by commas | No | Api keys of users who are allowed to track this packet. Example: a1a2a3a4a5a6a7a8,1b2b3b4b5b6b7b8b |
| 27 | Romania CIF Number | String | No | Număr de identificare fiscală |
| 28 | Affiliate ID | 16 characters (digits and letters) | No | ID of the third-party sender or member of Packeta affiliate program. |
| 29 | Is subject to Romania logistics tax | Boolean | no | Subject to tax per law effective 1.1.2026, for packets ≤150 EUR under CC H7. Full article |
| 30 | Country of origin of the packet | String ISO 3166-1 alpha-2 | If is subject to Romania logistics tax set to true | The country of origin of the packet |