ABCDEFGHIJKLMNOPQRSTUVWXYZ
1
HeaderFormatMandatoryMaximum lengthNotesExample
2
client_numberStringYes3Your client number, this number will be provided to you by our team019
3
service_nameStringYes16One of [delivery_sameday, delivery_nextday, collect, swap]delivery_nextday
4
order_idStringNo25The end-customer friendly order id12345
5
package_idStringYes25Your unique package identifier UNIQUE per client account.ITEM-600119525
6
transport_idStringYes45Barcode value
Should be UNIQUE globally (if you don't have the barcode value yet, please specify the value {client_number}-{package_id} instead)		BN7000Z
7
sender_nameStringYes40Name of package's senderRetailer Name
8
weightIntegerYes10Weight of the package in kilogramme (kg), using dot as a decimal separator4.2
9
lengthIntegerNo*10Length of the package in centimeter (cm), using dot as a decimal separator100
10
widthIntegerNo*10Width of the package in centimeter (cm), using dot as a decimal separator100
11
heightIntegerNo*10Height of the package in centimeter (cm), using dot as a decimal separator100
12
package_typeStringNo*10One of [ XXS, XS, S, MS, M, ML, L, XL, XXL, XXXL ]
*Required if one of [length, width, height] is missing.		M
13
delivery_dateStringNo*10A datetime (ISO 8601) indicating when you want the package to be delivered.
*Mandatory if you want to use several `service_name` or if you want this information to be displayed in end-customer notifications		2019-12-20
14
delivery_slot_startStringNo*11Chosen delivery time slot in ISO 8601 format, in local time. Note that our system ignores any UTC offset provided.
*Mandatory if you want to use several `service_name` or if you want this information to be displayed in end-customer notifications		19:00
15
delivery_slot_endStringNo*11Chosen delivery time slot in ISO 8601 format in local time. Note that our system ignores any UTC offset provided.
*Mandatory if you want to use several `service_name` or if you want this information to be displayed in end-customer notifications		20:00
16
recipient_lastnameStringYes50End-customer lastname
(if you do not have the ability to split the name into first name and last name please duplicate the information in both fields)		smart
17
recipient_firstnameStringYes50End-customer firstnameoliver
18
recipient_emailStringYes50Without the special Google character "+" in the address stringo.smart@stuart.com
19
recipient_mobile_phoneIntegerYes15Mobile phone number following E.164 recommendation+447447693141
20
recipient_addressStringYes50House / building number and street239 Elmhurst Street
21
recipient_address_floorStringNo50Floor number or apartment number3
22
recipient_address_digicodeString No50Main entrance access code123A
23
recipient_address_commentStringNo50Other additional detailsLeft door
24
recipient_postcodeStringYes8PostcodeSW4 6HH
25
recipient_cityStringYes40CityLondon
26
recipient_country_codeStringYes2One of [GB, FR, ES]GB
27
optionsStringNo100List of specific options applied to the package
Separator: |
Allowed value:
- C25: age restricted items		C25
28
29
30
Additional rules (all documented here also)
31
In addition to the above format, your file should follow some additional rules to be 100% compliant with our system. Your file should:
32
1) follows our naming convention below
33
2) uses ";" as fields separators
34
3) be UTF-8 encoded
35
4) uses CR/LF end of line
36
Naming convention
37
{client_number}_{date_of_the_day}_{file_number}_whateverextra.csv
38
Your file name should:
39
1) have a unique name (unique in your whole server)
40
2) not use any space
41
Examples: 017_2020-02-12_1.csv for the first file of the day uploaded by client 017 on the 12th of February 2020
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100