Express courier. Direct.
Also overnight.
x25pronto Switzerland takes goods direct to the destination. Small loads go by car. Larger loads go by van or Van XL. Direct, express and overnight trips run Monday to Sunday when a slot is free. Free times are shown in the booking calendar. This keeps the plan clear.
Template: CSV import format for bulk recipient upload
Practical CSV template and clear rules for bulk uploading recipients to your x25pronto business account. Required fields, examples and encoding tips.
Quick answer
This page provides a clear CSV template for bulk uploading recipients into your x25pronto Business account. It lists required columns, example rows and essential notes on UTF‑8 encoding, field delimiters and address formatting for Switzerland, the EU and international destinations.
Why you need this template
The template helps you upload many recipients at once into your x25pronto Business account. It reduces import errors and ensures addresses are parsed correctly. Use it to speed up booking and reduce manual entry.
Required columns and data types
The following columns are required (order not mandatory, use exact headers): - recipient_id (String): Your internal unique ID per row. - company (String): Company name. Leave blank for private recipients. - contact_name (String): First and last name or contact person. - street (String): Street and house number in one field or separated. - postal_code (String): Postal code without extra characters, e.g. 8001. - city (String): City name, e.g. Zurich. - country_code (String): ISO‑3166 Alpha‑2, e.g. CH, DE, FR. - phone (String): Include country code with +, e.g. +41 44 000 00 00. - email (String): Valid email for notifications. Optional fields: - instructions (String): Delivery note, up to 250 chars. - package_height_cm, package_width_cm, package_length_cm (Numeric): Dimensions in cm if needed. - reference (String): Your shipment reference.
Example CSV (comma delimiter)
recipient_id,company,contact_name,street,postal_code,city,country_code,phone,email,instructions,package_length_cm,package_width_cm,package_height_cm,reference R001,Acme Ltd,Anna Müller,Bahnhofstrasse 10,8001,Zurich,CH,+41 44 123 45 67,anna.mueller@acme.ch,Please ring the bell,30,20,10,ORD123 R002,,Max Meier,Heinrichstrasse 5,4053,Basel,CH,+41 61 234 56 78,max@example.com,Leave with neighbour,25,15,5,ORD124 R003,Export GmbH,Laura Rossi,Hauptstr. 12,10115,Berlin,DE,+49 30 123456,laura@export.de,Deliver weekdays,40,30,20,EXT001
Formatting and encoding rules
Save the file as UTF‑8 without BOM. Use commas as delimiters, or semicolons if addresses contain many commas. Quote text fields that contain delimiters, e.g. "Main St, 12". Do not use thousand separators in numeric fields. Store postal codes as text to keep leading zeros (e.g. 01234).
Troubleshooting import errors
Common issues and fixes: - Invalid country_code: Check ISO‑3166 Alpha‑2 codes. - Missing required fields: Ensure recipient_id, contact_name, street, postal_code, city and country_code are present. - Encoding problems (�): Re‑save as UTF‑8 without BOM. - Phone numbers without +: Add the country code. During upload x25pronto validates the file and returns line numbers with errors. Correct the flagged rows and re‑upload.
Tips for very large lists
Split large lists into batches of 2,000–5,000 rows. This keeps uploads fast and errors easier to find. Run a small test import of 5–20 rows first. Use recipient_id to map back to your systems when you need to correct or match records.
Frequently asked questions
Which encoding should I use?
Save the CSV as UTF‑8 without BOM. That prevents issues with accents and special characters during import.
Can I use semicolon as delimiter?
Yes. If your addresses contain many commas, ; is a useful alternative. Select the matching delimiter option during upload.
How do I handle failed rows?
x25pronto lists the failed rows and error messages. Fix the rows in your source file and re‑upload the CSV.
Are package dimensions mandatory?
No. Dimensions are optional and only required if you want to include shipment details for planning.