> ## Documentation Index
> Fetch the complete documentation index at: https://apidocs.returnhelper.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Label Service Limitations

> Carrier-specific field requirements, validations, and constraints for return label generation

Each shipping carrier enforces specific field requirements and size/weight limits when generating a return label. The tables below are derived from the validation rules in the label service source code.

<Note>
  Fields marked **Required** must be provided. Optional fields are validated only when a value is supplied. All string lengths are maximum character counts unless a range is shown.
</Note>

## United Kingdom

### Royal Mail

**Service type code:** `rm`

| Field                | Required | Limit                                  |
| -------------------- | -------- | -------------------------------------- |
| shipFrom.country     | Yes      | Must be `gbr`                          |
| shipFrom.contactName | Yes      | 1–50 chars                             |
| shipFrom.phone       | No       | 5–30 chars                             |
| shipFrom.fax         | No       | Max 50 chars                           |
| shipFrom.email       | No       | Max 255 chars                          |
| shipFrom.street1     | Yes      | 1–40 chars                             |
| shipFrom.street2     | No       | Max 40 chars                           |
| shipFrom.street3     | No       | Max 50 chars                           |
| shipFrom.city        | Yes      | 1–30 chars, no leading/trailing spaces |
| shipFrom.postalCode  | Yes      | Must match Royal Mail postcode format  |
| shipTo.country       | Yes      | Must be `gbr`                          |
| shipTo.contactName   | Yes      | 1–24 chars                             |
| shipTo.phone         | No       | 5–30 chars                             |
| shipTo.fax           | No       | Max 50 chars                           |
| shipTo.email         | No       | Max 255 chars                          |
| shipTo.street1       | Yes      | 1–40 chars                             |
| shipTo.street2       | Yes      | Max 40 chars                           |
| shipTo.street3       | No       | Max 50 chars                           |
| shipTo.city          | Yes      | 1–30 chars, no leading/trailing spaces |
| shipTo.postalCode    | Yes      | Must match Royal Mail postcode format  |

***

### Royal Mail (MR / BIR)

**Service type code:** `RETURN_RM_BIR`

Same validation rules as Royal Mail (`rm`) above.

***

### Royal Mail Postmen BIR

**Service type code:** `RETURN_POSTMEN_RM_BIR`

| Field                | Required | Limit                                                       |
| -------------------- | -------- | ----------------------------------------------------------- |
| shipFrom.country     | Yes      | Must be `gbr`                                               |
| shipFrom.contactName | Yes      | Max 35 chars                                                |
| shipFrom.companyName | No       | Max 255 chars                                               |
| shipFrom.street1     | Yes      | Max 60 chars                                                |
| shipFrom.street2     | No       | Max 60 chars; combined street1+street2 max 60 chars         |
| shipFrom.street3     | No       | Max 60 chars; combined street1+street2+street3 max 75 chars |
| shipFrom.city        | Yes      | Max 35 chars                                                |
| shipFrom.state       | No       | Max 35 chars                                                |
| shipFrom.postalCode  | Yes      | Must match Royal Mail postcode format                       |
| shipFrom.email       | No       | Max 255 chars, valid email format                           |
| shipFrom.phone       | No       | Max 255 chars                                               |
| shipFrom.fax         | No       | Max 255 chars                                               |
| shipTo.country       | Yes      | Must be `gbr`                                               |
| shipTo.contactName   | Yes      | Max 35 chars                                                |
| shipTo.companyName   | No       | Max 255 chars                                               |
| shipTo.street1       | Yes      | Max 100 chars                                               |
| shipTo.street2       | No       | Max 100 chars                                               |
| shipTo.street3       | No       | Max 100 chars; combined total max 100 chars                 |
| shipTo.city          | Yes      | Max 35 chars                                                |
| shipTo.state         | No       | Max 35 chars                                                |
| shipTo.postalCode    | Yes      | Must match Royal Mail postcode format                       |
| shipTo.email         | No       | Max 255 chars, valid email format                           |
| shipTo.phone         | No       | Max 255 chars                                               |
| shipTo.fax           | No       | Max 255 chars                                               |

**Parcel constraints:**

| Constraint             | Limit                           |
| ---------------------- | ------------------------------- |
| Box type               | Must be `custom`                |
| Weight per parcel      | Must be > 0                     |
| Width                  | Max 46 cm                       |
| Height                 | Max 46 cm                       |
| Depth (length)         | Max 90 cm                       |
| Width + height + depth | Max 104 cm (when depth > 61 cm) |

**Item constraints:**

| Constraint        | Limit                 |
| ----------------- | --------------------- |
| Total item weight | Must be > 0           |
| description       | Required, 1–255 chars |
| quantity          | Must be > 0           |
| price.amount      | Max 9,999,999.99      |
| orderNumber       | Required, 1–50 chars  |

***

### DPD

**Service type codes:** `pdpd`, `RETURN_GBR_DPD_BIR`

| Field                | Required | Limit                                                       |
| -------------------- | -------- | ----------------------------------------------------------- |
| shipFrom.country     | Yes      | Must be `gbr`                                               |
| shipFrom.contactName | Yes      | 1–35 chars                                                  |
| shipFrom.companyName | No       | Max 35 chars                                                |
| shipFrom.street1     | Yes      | 1–70 chars                                                  |
| shipFrom.street2     | No       | Max 69 chars                                                |
| shipFrom.street3     | No       | Max 68 chars; combined street1+street2+street3 max 70 chars |
| shipFrom.city        | Yes      | 1–30 chars, no leading/trailing spaces                      |
| shipFrom.state       | No       | Max 30 chars                                                |
| shipFrom.postalCode  | Yes      | 1–8 chars                                                   |
| shipFrom.phone       | Yes      | Max 15 chars                                                |
| shipFrom.fax         | No       | Max 50 chars                                                |
| shipFrom.email       | No       | Max 255 chars                                               |
| shipTo.country       | Yes      | Must be `gbr`                                               |
| shipTo.contactName   | Yes      | 1–35 chars                                                  |
| shipTo.companyName   | No       | Max 35 chars                                                |
| shipTo.street1       | Yes      | 1–70 chars                                                  |
| shipTo.street2       | No       | Max 69 chars                                                |
| shipTo.street3       | No       | Max 68 chars; combined street1+street2+street3 max 70 chars |
| shipTo.city          | Yes      | 1–30 chars, no leading/trailing spaces                      |
| shipTo.state         | No       | Max 30 chars                                                |
| shipTo.postalCode    | Yes      | 1–8 chars                                                   |
| shipTo.phone         | Yes      | Max 15 chars                                                |
| shipTo.fax           | No       | Max 50 chars                                                |
| shipTo.email         | No       | Max 100 chars                                               |

**Parcel constraints:**

| Constraint        | Limit                |
| ----------------- | -------------------- |
| Box type          | Must be `custom`     |
| Each dimension    | Must be > 0          |
| Two-side combined | Cannot exceed 120 cm |

**Item constraints:**

| Constraint        | Limit                 |
| ----------------- | --------------------- |
| description       | Required, 1–255 chars |
| quantity          | Must be > 0           |
| price.amount      | Must be > 0           |
| Total item price  | Must be > 0           |
| Total item weight | Must be > 0           |
| orderNumber       | Required, 1–50 chars  |

***

### DHL

**Service type code:** `sdhl`

| Field                | Required | Limit                                   |
| -------------------- | -------- | --------------------------------------- |
| shipFrom.country     | Yes      | —                                       |
| shipFrom.companyName | Yes      | Max 64 chars                            |
| shipFrom.contactName | Yes      | Max 35 chars                            |
| shipFrom.street1     | Yes      | 1–35 chars                              |
| shipFrom.street2     | Yes      | Max 5 chars                             |
| shipFrom.city        | Yes      | Max 35 chars                            |
| shipFrom.postalCode  | Yes      | Must match DHL postcode format          |
| shipFrom.phone       | No       | Must match DHL phone format if provided |
| shipTo.country       | Yes      | —                                       |
| shipTo.companyName   | Yes      | Max 64 chars                            |
| shipTo.contactName   | Yes      | Max 35 chars                            |
| shipTo.street1       | Yes      | 1–35 chars                              |
| shipTo.street2       | Yes      | Max 5 chars                             |
| shipTo.city          | Yes      | Max 35 chars                            |
| shipTo.postalCode    | Yes      | Must match DHL postcode format          |
| shipTo.phone         | No       | Must match DHL phone format if provided |
| orderNumber          | No       | Max 30 chars                            |

***

## Germany

### DHL eCommerce DEU

**Service type code:** `RETURN_DHL_ECOMMERCE_DEU`

| Field                                   | Required | Limit                                     |
| --------------------------------------- | -------- | ----------------------------------------- |
| shipFromName (contactName + clientCode) | Yes      | Max 49 chars, no `\|` character           |
| shipFrom.companyName                    | No       | Max 100 chars, no `\|` character          |
| shipFrom.street1                        | Yes      | Max 49 chars, no `\|` character           |
| shipFrom.street2                        | Yes      | Max 49 chars, no `\|` character           |
| shipFrom.street3                        | No       | Max 150 chars, no `\|` character          |
| shipFrom.city                           | No       | Max 30 chars, no `\|` character           |
| shipFrom.state                          | No       | Max 100 chars, no `\|` character          |
| shipFrom.country                        | Yes      | Valid country code                        |
| shipFrom.postalCode                     | Yes      | 1–10 chars                                |
| shipFrom.phone                          | No       | Digits and `- ( ) # +` only, max 20 chars |
| shipFrom.email                          | No       | Max 50 chars, no `\|` character           |
| shipTo.companyName                      | Yes      | Max 49 chars, no `\|` character           |
| shipTo.street1                          | Yes      | Max 49 chars, no `\|` character           |
| shipTo.street2                          | No       | Max 49 chars, no `\|` character           |
| shipTo.street3                          | No       | Max 150 chars, no `\|` character          |
| shipTo.city                             | No       | Max 30 chars, no `\|` character           |
| shipTo.state                            | No       | Max 50 chars, no `\|` character           |
| shipTo.country                          | Yes      | Valid country code                        |
| shipTo.postalCode                       | Yes      | 1–10 chars                                |
| shipTo.phone                            | No       | Digits and `- ( ) # +` only, max 20 chars |
| shipTo.email                            | No       | Max 50 chars, no `\|` character           |

**Parcel constraints:**

| Constraint     | Limit                                     |
| -------------- | ----------------------------------------- |
| Max length     | 120 cm                                    |
| Max width      | 60 cm                                     |
| Max height     | 60 cm                                     |
| Each dimension | Must be > 0                               |
| description    | Required, max 50 chars, no `\|` character |

**Item constraints:**

| Constraint   | Limit                                     |
| ------------ | ----------------------------------------- |
| description  | Required, max 50 chars, no `\|` character |
| quantity     | Must be > 0                               |
| price.amount | Must be > 0.01                            |

***

### DHL eCommerce International DEU

**Service type code:** `RETURN_DHL_ECOMMERCE_INTL_DEU`

Same validation rules as DHL eCommerce DEU above, with the following difference:

| Field                                   | Difference                            |
| --------------------------------------- | ------------------------------------- |
| shipFromName (contactName + clientCode) | Max **26** chars (vs 49 for domestic) |

***

## France

### Colissimo

**Service type code:** `ucss`

| Field                | Required | Limit                                                 |
| -------------------- | -------- | ----------------------------------------------------- |
| shipFrom.country     | Yes      | Max 3 chars                                           |
| shipFrom.contactName | Yes      | Max 20 chars, French/English letters and numbers only |
| shipFrom.phone       | Yes      | Max 15 chars                                          |
| shipFrom.email       | No       | Max 80 chars, valid email format                      |
| shipFrom.street1     | Yes      | Max 22 chars                                          |
| shipFrom.street2     | No       | Max 22 chars                                          |
| shipFrom.street3     | No       | Max 22 chars                                          |
| shipFrom.city        | Yes      | Max 35 chars                                          |
| shipFrom.postalCode  | Yes      | Max 5 chars                                           |
| shipTo.companyName   | Yes      | Max 32 chars                                          |
| shipTo.contactName   | Yes      | Max 32 chars                                          |
| shipTo.phone         | Yes      | Max 15 chars                                          |
| shipTo.email         | Yes      | Max 80 chars, valid email format                      |
| shipTo.street1       | Yes      | Max 35 chars                                          |
| shipTo.street2       | No       | Max 35 chars                                          |
| shipTo.street3       | No       | Max 35 chars                                          |
| shipTo.country       | Yes      | Max 3 chars                                           |
| shipTo.city          | Yes      | Max 35 chars                                          |
| shipTo.postalCode    | Yes      | Max 5 chars                                           |
| shipmentDate         | Yes      | —                                                     |

***

### FREU-Colissimo

**Service type code:** `RETURN_PATRICE_EUR`

| Field                | Required | Limit                            |
| -------------------- | -------- | -------------------------------- |
| shipFrom.country     | Yes      | Valid country code               |
| shipFrom.contactName | Yes      | Max 35 chars                     |
| shipFrom.phone       | Yes      | Max 20 chars                     |
| shipFrom.email       | No       | Max 80 chars, valid email format |
| shipFrom.street1     | Yes      | Max 35 chars                     |
| shipFrom.street2     | No       | Max 35 chars                     |
| shipFrom.street3     | No       | Max 35 chars                     |
| shipFrom.city        | Yes      | Max 30 chars                     |
| shipFrom.postalCode  | Yes      | Max 10 chars                     |
| shipTo.companyName   | Yes      | Max 35 chars                     |
| shipTo.contactName   | Yes      | Max 35 chars                     |
| shipTo.phone         | Yes      | Max 20 chars                     |
| shipTo.email         | Yes      | Max 80 chars, valid email format |
| shipTo.street1       | Yes      | Max 35 chars                     |
| shipTo.street2       | No       | Max 35 chars                     |
| shipTo.street3       | No       | Max 35 chars                     |
| shipTo.country       | Yes      | Valid country code               |
| shipTo.city          | Yes      | Max 25 chars                     |
| shipTo.postalCode    | Yes      | Max 5 chars                      |
| shipmentDate         | Yes      | —                                |

***

### FREU-DHL

**Service type code:** `RETURN_PATRICE_DHL_EUR`

| Field                | Required | Limit                                                       |
| -------------------- | -------- | ----------------------------------------------------------- |
| shipFrom.contactName | Yes      | Max 50 chars                                                |
| shipFrom.companyName | Yes      | Max 50 chars                                                |
| shipFrom.country     | Yes      | Valid country code                                          |
| shipFrom.street1     | Yes      | Max 70 chars                                                |
| shipFrom.street2     | No       | Max 70 chars                                                |
| shipFrom.street3     | No       | Max 70 chars; combined street1+street2+street3 max 90 chars |
| shipFrom.city        | Yes      | Max 40 chars                                                |
| shipFrom.postalCode  | Yes      | Max 10 chars                                                |
| shipFrom.phone       | No       | Max 20 chars                                                |
| shipFrom.email       | No       | Max 70 chars, valid email format                            |
| shipTo.contactName   | Yes      | Max 49 chars                                                |
| shipTo.companyName   | Yes      | Max 50 chars                                                |
| shipTo.country       | Yes      | Valid country code                                          |
| shipTo.street1       | Yes      | Max 45 chars                                                |
| shipTo.street2       | No       | Max 35 chars                                                |
| shipTo.street3       | No       | Max 35 chars                                                |
| shipTo.city          | Yes      | Max 45 chars                                                |
| shipTo.postalCode    | Yes      | Max 10 chars                                                |
| shipTo.phone         | Yes      | Max 20 chars                                                |
| shipTo.email         | No       | Max 70 chars, valid email format                            |
| shipmentDate         | Yes      | —                                                           |

***

### Chronopost (France)

**Service type code:** `RETURN_ATOMICSELLER_CHRONOPOST_FRA`

| Field                | Required | Limit                                                       |
| -------------------- | -------- | ----------------------------------------------------------- |
| shipFrom.contactName | Yes      | Max 40 chars                                                |
| shipFrom.companyName | Yes      | Max 40 chars                                                |
| shipFrom.street1     | Yes      | Max 35 chars; combined street1+street2+street3 max 35 chars |
| shipFrom.country     | Yes      | Valid country code                                          |
| shipFrom.city        | Yes      | Max 33 chars                                                |
| shipFrom.postalCode  | Yes      | Max 5 chars                                                 |
| shipFrom.phone       | Yes      | Max 17 chars                                                |
| shipFrom.email       | No       | Max 80 chars, valid email format                            |
| shipTo.contactName   | Yes      | Max 34 chars                                                |
| shipTo.companyName   | Yes      | Max 47 chars                                                |
| shipTo.street1       | Yes      | Max 38 chars                                                |
| shipTo.street2       | No       | Max 38 chars                                                |
| shipTo.street3       | No       | Max 38 chars                                                |
| shipTo.country       | Yes      | Valid country code                                          |
| shipTo.city          | Yes      | Max 49 chars                                                |
| shipTo.postalCode    | Yes      | Max 5 chars                                                 |
| shipTo.phone         | Yes      | Max 17 chars                                                |
| shipTo.email         | No       | Max 80 chars, valid email format                            |

**Parcel constraints:**

| Constraint          | Limit       |
| ------------------- | ----------- |
| Total parcel weight | Must be > 0 |
| Weight per parcel   | Must be > 0 |
| Each dimension      | Must be > 0 |

**Item constraints:**

| Constraint   | Limit       |
| ------------ | ----------- |
| price.amount | Must be > 0 |

***

## Spain

### Correos

**Service type code:** `ucepaq`

| Field                | Required | Limit                              |
| -------------------- | -------- | ---------------------------------- |
| shipFrom.country     | Yes      | Must be `esp`                      |
| shipFrom.contactName | Yes      | 1–50 chars                         |
| shipFrom.companyName | No       | 1–50 chars                         |
| shipFrom.phone       | Yes      | Must match Correos phone format    |
| shipFrom.fax         | No       | 1–50 chars                         |
| shipFrom.email       | No       | 1–255 chars                        |
| shipFrom.street1     | Yes      | 1–35 chars                         |
| shipFrom.street2     | No       | 1–35 chars                         |
| shipFrom.street3     | No       | 1–35 chars                         |
| shipFrom.city        | No       | 1–50 chars                         |
| shipFrom.state       | No       | 1–50 chars                         |
| shipFrom.postalCode  | Yes      | Must match Correos postcode format |
| shipTo.country       | Yes      | Must be `esp`                      |
| shipTo.contactName   | Yes      | 1–100 chars                        |
| shipTo.companyName   | No       | 1–50 chars                         |
| shipTo.phone         | Yes      | Must match Correos phone format    |
| shipTo.fax           | No       | 1–50 chars                         |
| shipTo.email         | No       | 1–255 chars                        |
| shipTo.street1       | Yes      | 1–35 chars                         |
| shipTo.street2       | No       | 1–35 chars                         |
| shipTo.street3       | No       | 1–35 chars                         |
| shipTo.city          | No       | 1–50 chars                         |
| shipTo.state         | No       | 1–50 chars                         |
| shipTo.postalCode    | Yes      | Must match Correos postcode format |

**Parcel constraints:**

| Constraint     | Limit            |
| -------------- | ---------------- |
| Box type       | Must be `custom` |
| Weight         | Must be > 0      |
| Each dimension | Must be > 0      |

**Item constraints:**

| Constraint     | Limit                 |
| -------------- | --------------------- |
| description    | Required, 1–255 chars |
| quantity       | Must be > 0           |
| price.currency | Must be `USD`         |
| price.amount   | Must be > 0           |
| orderNumber    | Required, 1–50 chars  |

***

## United States — New Jersey (NJ) Warehouse

### UPS Ground-NJ

**Service type code:** `ups_nj`

| Field                | Required | Limit                                                       |
| -------------------- | -------- | ----------------------------------------------------------- |
| shipFrom.country     | Yes      | Must be `usa`                                               |
| shipFrom.contactName | Yes      | 1–30 chars                                                  |
| shipFrom.companyName | No       | Max 30 chars                                                |
| shipFrom.street1     | Yes      | 1–30 chars                                                  |
| shipFrom.street2     | No       | Max 30 chars                                                |
| shipFrom.street3     | No       | Max 30 chars; combined street1+street2+street3 max 30 chars |
| shipFrom.city        | Yes      | 1–30 chars                                                  |
| shipFrom.state       | Yes      | Exactly 2 chars                                             |
| shipFrom.postalCode  | Yes      | Must match UPS US postcode format                           |
| shipFrom.phone       | Yes      | Must match UPS phone format                                 |
| shipFrom.fax         | No       | Max 50 chars                                                |
| shipFrom.email       | No       | Max 255 chars                                               |
| shipTo.country       | Yes      | Must be `usa`                                               |
| shipTo.contactName   | Yes      | 1–35 chars                                                  |
| shipTo.companyName   | No       | Max 35 chars                                                |
| shipTo.street1       | Yes      | 1–90 chars                                                  |
| shipTo.street2       | No       | Max 90 chars                                                |
| shipTo.street3       | No       | Max 90 chars; combined street1+street2+street3 max 90 chars |
| shipTo.city          | Yes      | 1–30 chars                                                  |
| shipTo.state         | Yes      | Exactly 2 chars                                             |
| shipTo.postalCode    | Yes      | Must match UPS US postcode format                           |
| shipTo.phone         | Yes      | Must match UPS phone format                                 |
| shipTo.fax           | No       | Max 50 chars                                                |
| shipTo.email         | No       | Max 255 chars                                               |

**Parcel constraints:**

| Constraint           | Limit                               |
| -------------------- | ----------------------------------- |
| Each dimension       | Must be > 0                         |
| Max single dimension | 270 cm                              |
| Length + girth       | Max 415 cm                          |
| Total weight         | Must be > 0, max 440,000 g (440 kg) |

**Item constraints:**

| Constraint   | Limit                 |
| ------------ | --------------------- |
| description  | Required, 1–255 chars |
| quantity     | Must be > 0           |
| price.amount | Must be > 0           |
| orderNumber  | Required, 1–50 chars  |

***

### USPS-NJ

**Service type code:** `usps`

| Field                | Required | Limit                         |
| -------------------- | -------- | ----------------------------- |
| shipFrom.contactName | Yes      | 1–32 chars                    |
| shipFrom.street1     | Yes      | 1–32 chars                    |
| shipFrom.street2     | No       | Max 32 chars                  |
| shipFrom.city        | Yes      | 1–20 chars                    |
| shipFrom.state       | Yes      | Exactly 2 chars               |
| shipFrom.postalCode  | Yes      | Must match USPS ZIP format    |
| shipFrom.email       | Yes      | Valid email format            |
| shipTo.street1       | No       | Max 48 chars                  |
| shipTo.street2       | No       | Max 48 chars                  |
| shipTo.city          | No       | Max 48 chars                  |
| shipTo.state         | No       | Exactly 2 chars (if provided) |
| shipTo.postalCode    | Yes      | Exactly 5 digits              |
| shipTo.email         | Yes      | Valid email format            |

**Item constraints:**

| Constraint  | Limit       |
| ----------- | ----------- |
| item.weight | Must be > 0 |

***

### USPS-BROKER-NJ

**Service type code:** `RETURN_USPS_BROKER_NJ`

Same validation rules as USPS-NJ (`usps`) above.

***

### USPS Broker Priority Mail-NJ

**Service type code:** `RETURN_USPS_BROKER_PM_NJ`

Same address and parcel validation rules as [Stamps/Endicia (NJ/WA services)](#stampsendicia-njwa-services) below. Length + girth max 274 cm.

***

### USPS Broker Ground Advantage-NJ

**Service type code:** `RETURN_USPS_BROKER_GA_NJ`

Same address and parcel validation rules as [Stamps/Endicia (NJ/WA services)](#stampsendicia-njwa-services) below. Length + girth max 330 cm.

***

### USPS Priority Mail-NJ

**Service type code:** `RETURN_USPS_NJ`

| Field                | Required | Limit                                  |
| -------------------- | -------- | -------------------------------------- |
| shipFrom.contactName | Yes      | Max 43 chars, must be at least 2 words |
| shipFrom.street1     | Yes      | Max 50 chars                           |
| shipFrom.street2     | No       | Max 50 chars                           |
| shipFrom.city        | Yes      | Max 28 chars                           |
| shipFrom.state       | Yes      | Exactly 2 chars                        |
| shipFrom.postalCode  | Yes      | Must match USPS ZIP format             |
| shipTo.companyName   | Yes      | Max 38 chars, must be at least 2 words |
| shipTo.street1       | Yes      | Max 38 chars                           |
| shipTo.street2       | No       | Max 38 chars                           |
| shipTo.city          | Yes      | Max 28 chars                           |
| shipTo.state         | Yes      | Exactly 2 chars                        |
| shipTo.postalCode    | Yes      | Must match USPS ZIP format             |

**Parcel constraints:**

| Constraint     | Limit       |
| -------------- | ----------- |
| Each dimension | Must be > 0 |
| Weight         | Must be > 0 |
| Length + girth | Max 274 cm  |

***

### USPS Ground Advantage-NJ

**Service type code:** `RETURN_ENDICIA_USPS_GROUND_ADVANTAGE_NJ`

Same address validation rules as USPS Priority Mail-NJ above, with different parcel constraints:

**Parcel constraints:**

| Constraint     | Limit       |
| -------------- | ----------- |
| Each dimension | Must be > 0 |
| Weight         | Must be > 0 |
| Length + girth | Max 330 cm  |

***

### FedEx Ground-NJ

**Service type code:** `fedex_ground`

| Field                | Required | Limit                                                                 |
| -------------------- | -------- | --------------------------------------------------------------------- |
| shipFrom.country     | Yes      | Must be `usa`                                                         |
| shipFrom.contactName | Yes      | Max 30 chars                                                          |
| shipFrom.companyName | No       | Max 30 chars                                                          |
| shipFrom.street1     | Yes      | Max 30 chars                                                          |
| shipFrom.street2     | No       | Max 30 chars; combined street1+street2 max 30 chars (when no street3) |
| shipFrom.street3     | No       | Max 29 chars; combined street1+street2+street3 max 29 chars           |
| shipFrom.state       | Yes      | Exactly 2 chars                                                       |
| shipFrom.postalCode  | Yes      | Must match FedEx US postcode format                                   |
| shipFrom.phone       | Yes      | Must match FedEx phone format                                         |
| shipFrom.fax         | No       | Max 16 chars                                                          |
| shipFrom.email       | No       | Valid email format                                                    |
| shipTo.country       | Yes      | Must be `usa`                                                         |
| shipTo.contactName   | Yes      | Max 35 chars                                                          |
| shipTo.companyName   | No       | Max 35 chars                                                          |
| shipTo.street1       | Yes      | Max 30 chars                                                          |
| shipTo.street2       | No       | Max 34 chars; combined street1+street2 max 34 chars (when no street3) |
| shipTo.street3       | No       | Max 33 chars; combined street1+street2+street3 max 33 chars           |
| shipTo.state         | Yes      | Exactly 2 chars                                                       |
| shipTo.postalCode    | Yes      | Must match FedEx US postcode format                                   |
| shipTo.phone         | Yes      | Max 30 chars, must match FedEx phone format                           |
| shipTo.fax           | No       | Max 16 chars                                                          |
| shipTo.email         | No       | Valid email format                                                    |

**Parcel constraints:**

| Constraint                | Limit            |
| ------------------------- | ---------------- |
| Box type                  | Must be `custom` |
| Each dimension            | Must be > 0      |
| Max length (longest side) | 274 cm           |
| Length + girth            | Max 419 cm       |
| Max weight                | 68,000 g (68 kg) |

**Item constraints:**

| Constraint        | Limit                 |
| ----------------- | --------------------- |
| description       | Required, 1–255 chars |
| quantity          | Must be > 0           |
| price.amount      | Must be > 0           |
| Total item weight | Must be > 0           |
| orderNumber       | Required, 1–50 chars  |

***

### DHL Parcel Ground-NJ

**Service type code:** `RETURN_DHL_PARCEL_GROUND_NJ`

| Field                | Required | Limit                                     |
| -------------------- | -------- | ----------------------------------------- |
| shipFrom.contactName | Yes      | 1–50 chars                                |
| shipFrom.companyName | Yes      | 1–30 chars                                |
| shipFrom.street1     | Yes      | 1–50 chars                                |
| shipFrom.street2     | No       | Max 50 chars                              |
| shipFrom.street3     | No       | Max 50 chars                              |
| shipFrom.city        | Yes      | Max 40 chars                              |
| shipFrom.state       | Yes      | Exactly 2 chars                           |
| shipFrom.postalCode  | Yes      | Must match format `XXXXX` or `XXXXX-XXXX` |
| shipFrom.email       | No       | Max 50 chars                              |
| shipFrom.phone       | No       | Max 26 chars                              |
| shipTo.contactName   | Yes      | 1–38 chars                                |
| shipTo.companyName   | Yes      | 1–30 chars                                |
| shipTo.street1       | Yes      | 1–40 chars                                |
| shipTo.street2       | No       | Max 40 chars                              |
| shipTo.street3       | No       | Max 50 chars                              |
| shipTo.city          | Yes      | Max 26 chars                              |
| shipTo.state         | Yes      | Exactly 2 chars                           |
| shipTo.postalCode    | Yes      | Must match format `XXXXX` or `XXXXX-XXXX` |
| shipTo.email         | No       | Max 50 chars                              |
| shipTo.phone         | No       | Max 26 chars                              |

***

### Stamps/Endicia (NJ/WA services)

Applies to: `RETURN_USPS_NJ`, `RETURN_ENDICIA_USPS_GROUND_ADVANTAGE_NJ`, `RETURN_USPS_BROKER_PM_NJ`, `RETURN_USPS_BROKER_GA_NJ`, `RETURN_USPS_BROKER_PM_WA`, `RETURN_USPS_BROKER_GA_WA`

These services pass through the Stamps/Endicia validator:

| Field                | Required | Limit                            |
| -------------------- | -------- | -------------------------------- |
| shipFrom.companyName | No       | Max 50 chars                     |
| shipFrom.contactName | Yes      | Max 100 chars                    |
| shipFrom.street1     | Yes      | Max 50 chars                     |
| shipFrom.street2     | No       | Max 50 chars                     |
| shipFrom.street3     | No       | Max 100 chars                    |
| shipFrom.city        | Yes      | Max 50 chars                     |
| shipFrom.state       | Yes      | Max 50 chars                     |
| shipFrom.postalCode  | Yes      | Max 14 chars                     |
| shipFrom.country     | Yes      | Must be `usa`                    |
| shipFrom.phone       | Yes      | Max 30 chars                     |
| shipFrom.email       | Yes      | Max 50 chars, valid email format |
| shipTo.companyName   | No       | Max 50 chars                     |
| shipTo.contactName   | Yes      | Max 100 chars                    |
| shipTo.street1       | Yes      | Max 50 chars                     |
| shipTo.street2       | No       | Max 50 chars                     |
| shipTo.street3       | No       | Max 100 chars                    |
| shipTo.city          | Yes      | Max 50 chars                     |
| shipTo.state         | Yes      | Max 50 chars                     |
| shipTo.postalCode    | Yes      | Max 14 chars                     |
| shipTo.country       | Yes      | Must be `usa`                    |
| shipTo.phone         | Yes      | Max 30 chars                     |
| shipTo.email         | Yes      | Max 50 chars, valid email format |
| orderNumber          | No       | Max 50 chars                     |

**Parcel constraints:**

| Constraint                        | Limit                              |
| --------------------------------- | ---------------------------------- |
| Each dimension                    | Must be > 0                        |
| Weight per parcel                 | Must be > 0                        |
| Total weight                      | Max 31,751 g (\~31.75 kg / 70 lbs) |
| Length + girth (Ground Advantage) | Max 330 cm                         |
| Length + girth (Priority Mail)    | Max 274 cm                         |

***

## United States — Washington (WA) Warehouse

### UPS Ground-WA

**Service type code:** `ups_wa`

Same validation rules as [UPS Ground-NJ](#ups-ground-nj) above.

***

### USPS Priority Mail-WA

**Service type code:** `endicia`

Same validation rules as [USPS Priority Mail-NJ](#usps-priority-mail-nj) and [Stamps/Endicia (NJ services)](#stampsendicia-nj-services) above. Length + girth max 274 cm.

***

### USPS Parcel Select-WA

**Service type code:** `endicia_parcel_select`

Same address validation rules as USPS Priority Mail-WA above. Length + girth max 330 cm (Ground Advantage limits apply).

***

### USPS Ground Advantage-WA

**Service type code:** `RETURN_ENDICIA_USPS_GROUND_ADVANTAGE_WA`

Same address validation rules as USPS Priority Mail-WA above. Length + girth max 330 cm.

***

### DHL Parcel Ground-WA

**Service type code:** `RETURN_DHL_PARCEL_GROUND_WA`

Same validation rules as [DHL Parcel Ground-NJ](#dhl-parcel-ground-nj) above.

***

### FedEx Ground-WA

**Service type code:** `RETURN_FEDEX_GROUND_WA`

Same validation rules as [FedEx Ground-NJ](#fedex-ground-nj) above.

***

### USPS Broker Priority Mail-WA

**Service type code:** `RETURN_USPS_BROKER_PM_WA`

Same address and parcel validation rules as [Stamps/Endicia (NJ/WA services)](#stampsendicia-njwa-services) above. Length + girth max 274 cm.

***

### USPS Broker Ground Advantage-WA

**Service type code:** `RETURN_USPS_BROKER_GA_WA`

Same address and parcel validation rules as [Stamps/Endicia (NJ/WA services)](#stampsendicia-njwa-services) above. Length + girth max 330 cm.

***

## Australia

### AU Post

**Service type code:** `ubi_au`

| Field                | Required | Limit        |
| -------------------- | -------- | ------------ |
| shipFrom.contactName | Yes      | Max 35 chars |
| shipFrom.email       | No       | Max 50 chars |
| shipFrom.phone       | No       | Max 20 chars |
| shipFrom.street1     | Yes      | Max 40 chars |
| shipFrom.street2     | No       | Max 60 chars |
| shipFrom.street3     | No       | Max 80 chars |
| shipFrom.city        | Yes      | Max 80 chars |
| shipFrom.state       | Yes      | Max 80 chars |
| shipFrom.postalCode  | Yes      | Max 16 chars |
| shipTo.companyName   | Yes      | Max 50 chars |

**Parcel constraints:**

| Constraint     | Limit                             |
| -------------- | --------------------------------- |
| Total weight   | Must be > 0, max 22,000 g (22 kg) |
| Each dimension | Must be > 0, max 105 cm           |
| Volume         | Must be > 0, max 250,000 cm³      |

**Custom field constraints:**

| Field       | Required | Limit        |
| ----------- | -------- | ------------ |
| DESCRIPTION | Yes      | Max 50 chars |

***

### Sendle AU Domestic

**Service type code:** `sendle_au_domestic`

| Field                | Required | Limit                                                   |
| -------------------- | -------- | ------------------------------------------------------- |
| shipFrom.contactName | Yes      | Max 20 chars (single word) or max 40 chars (with space) |
| shipFrom.companyName | No       | Max 20 chars (single word) or max 40 chars (with space) |
| shipFrom.phone       | No       | Max 14 chars                                            |
| shipFrom.street1     | Yes      | Max 45 chars                                            |
| shipFrom.street2     | No       | Max 45 chars                                            |
| shipFrom.city        | Yes      | Max 30 chars                                            |
| shipFrom.state       | Yes      | Max 3 chars                                             |
| shipFrom.postalCode  | Yes      | Must match Sendle postcode format                       |
| shipFrom.country     | No       | Max 50 chars                                            |
| shipTo.contactName   | Yes      | Max 38 chars                                            |
| shipTo.companyName   | No       | Max 34 chars                                            |
| shipTo.email         | No       | Valid email format                                      |
| shipTo.phone         | No       | Max 14 chars, numeric                                   |
| shipTo.street1       | Yes      | Max 66 chars                                            |
| shipTo.street2       | No       | Max 66 chars                                            |
| shipTo.city          | Yes      | Max 30 chars                                            |
| shipTo.state         | Yes      | Max 3 chars                                             |
| shipTo.postalCode    | Yes      | Must match Sendle postcode format                       |

**Parcel constraints:**

| Constraint     | Limit                             |
| -------------- | --------------------------------- |
| Each dimension | Must be > 0                       |
| Volume         | Max 100,000 cm³                   |
| Total weight   | Must be > 0, max 25,000 g (25 kg) |

**Custom field constraints:**

| Field            | Required | Limit         |
| ---------------- | -------- | ------------- |
| SHIPMENT\_NUMBER | Yes      | Max 38 chars  |
| DESCRIPTION      | Yes      | Max 255 chars |

**Other constraints:**

| Constraint  | Limit         |
| ----------- | ------------- |
| orderNumber | Max 110 chars |

***

## Canada

### Canada Post

**Service type code:** `ubi_ca`

| Field                | Required | Limit        |
| -------------------- | -------- | ------------ |
| shipFrom.contactName | Yes      | Max 50 chars |
| shipFrom.email       | Yes      | Max 50 chars |
| shipFrom.phone       | Yes      | Max 20 chars |
| shipFrom.street1     | Yes      | Max 45 chars |
| shipFrom.street2     | No       | Max 41 chars |
| shipFrom.street3     | No       | Max 80 chars |
| shipFrom.city        | Yes      | Max 50 chars |
| shipFrom.state       | Yes      | Max 80 chars |
| shipFrom.postalCode  | Yes      | Max 16 chars |
| shipTo.companyName   | Yes      | Max 42 chars |

**Parcel constraints:**

| Constraint     | Limit                             |
| -------------- | --------------------------------- |
| Total weight   | Must be > 0, max 30,000 g (30 kg) |
| Each dimension | Must be > 0, max 200 cm           |

**Custom field constraints:**

| Field       | Required | Limit                                                                                             |
| ----------- | -------- | ------------------------------------------------------------------------------------------------- |
| DESCRIPTION | Yes      | 1–50 chars, must start with a letter, only letters, numbers, `#`, `/`, `-`, `_`, `(`, `)` allowed |

***

## Hong Kong / Asia

### SF Express

**Service type code:** `sf_hk`

| Field                | Required | Limit                                                            |
| -------------------- | -------- | ---------------------------------------------------------------- |
| shipFrom.companyName | No       | Max 45 chars                                                     |
| shipFrom.contactName | No       | Max 30 chars                                                     |
| shipFrom.phone       | No       | Must match SF Express phone format if provided                   |
| shipFrom.street1     | Yes      | Max 40 chars (if no street2); combined with street2 max 40 chars |
| shipFrom.city        | No       | Max 100 chars                                                    |
| shipFrom.postalCode  | No       | Max 25 chars                                                     |
| shipFrom.email       | No       | Max 200 chars                                                    |
| shipTo.companyName   | No       | Max 30 chars                                                     |
| shipTo.contactName   | No       | Max 8 chars                                                      |
| shipTo.phone         | No       | Must match SF Express phone format if provided                   |
| shipTo.street1       | Yes      | Max 40 chars (if no street2); combined with street2 max 40 chars |
| shipTo.city          | No       | Max 100 chars                                                    |
| shipTo.postalCode    | No       | Max 25 chars                                                     |
| shipTo.email         | No       | Max 200 chars                                                    |

**Item constraints:**

| Constraint     | Limit                   |
| -------------- | ----------------------- |
| description    | Required, max 128 chars |
| price.amount   | Precision 17, scale 3   |
| price.currency | Max 5 chars             |
| orderNumber    | Required, max 30 chars  |

***

## Taiwan

### Yamato

**Service type code:** `RETURN_YAMATO_TWN`

| Field                                       | Required | Limit                                                               |
| ------------------------------------------- | -------- | ------------------------------------------------------------------- |
| shipFrom.contactName                        | Yes      | Max 30 chars, Chinese/English/digits/common special characters only |
| shipFrom.phone                              | Yes      | Must start with `09` and be exactly 10 digits                       |
| shipFrom.city                               | Yes      | —                                                                   |
| shipFrom.city + street1 + street2 + street3 | —        | Combined max 120 chars                                              |
| shipTo.companyName                          | Yes      | Combined with clientCode max 30 chars                               |
| shipTo.phone                                | Yes      | Must start with `09` and be exactly 10 digits                       |
| shipTo.city                                 | Yes      | —                                                                   |
| shipTo.city + street1 + street2 + street3   | —        | Combined max 120 chars                                              |

**Parcel constraints:**

| Constraint               | Limit                             |
| ------------------------ | --------------------------------- |
| Total parcel weight      | Must be > 0, max 20,000 g (20 kg) |
| Weight per parcel        | Must be > 0, max 20,000 g (20 kg) |
| Total dimensions (L+W+H) | Max 150 cm                        |

**Item constraints:**

| Constraint  | Limit        |
| ----------- | ------------ |
| description | Max 20 chars |

**Custom field constraints:**

| Field       | Required | Limit         |
| ----------- | -------- | ------------- |
| DESCRIPTION | Yes      | Max 100 chars |

***

## Southeast Asia

### Qxpress (Singapore)

**Service type code:** `easyparcel_qxpress`

| Field                | Required | Limit                                              |
| -------------------- | -------- | -------------------------------------------------- |
| shipFrom.contactName | Yes      | —                                                  |
| shipFrom.street1     | Yes      | —                                                  |
| shipFrom.city        | Yes      | —                                                  |
| shipFrom.state       | Yes      | —                                                  |
| shipFrom.postalCode  | Yes      | Exactly 6 chars                                    |
| shipFrom.country     | Yes      | —                                                  |
| shipTo.contactName   | Yes      | Max 45 chars                                       |
| shipTo.companyName   | Yes      | Max 45 chars                                       |
| shipTo.phone         | Yes      | Max 16 chars                                       |
| shipTo.street1       | Yes      | Max 100 chars; combined with street2 max 100 chars |
| shipTo.city          | Yes      | —                                                  |
| shipTo.state         | Yes      | —                                                  |
| shipTo.postalCode    | Yes      | Exactly 6 chars                                    |
| shipTo.country       | Yes      | —                                                  |

**Parcel constraints:**

| Constraint                    | Limit                  |
| ----------------------------- | ---------------------- |
| Box type                      | Must be `custom`       |
| Weight per parcel             | Must be > 0            |
| Total weight                  | Must be > 0            |
| Each dimension                | Must be > 0, max 80 cm |
| Total of all three dimensions | Max 240 cm             |
| Volume                        | Max 150,000 cm³        |

**Item constraints:**

| Constraint   | Limit                  |
| ------------ | ---------------------- |
| description  | Required, max 35 chars |
| price.amount | Must be > 0            |

***

### J\&T Express (Malaysia)

**Service type code:** `easyparcel_jnt_express`

| Field                | Required | Limit                                               |
| -------------------- | -------- | --------------------------------------------------- |
| shipFrom.street1     | Yes      | Max 100 chars; combined with street2 max 100 chars  |
| shipFrom.city        | Yes      | Max 35 chars                                        |
| shipFrom.postalCode  | Yes      | Max 10 chars                                        |
| shipFrom.country     | Yes      | Max 35 chars                                        |
| shipFrom.contactName | No       | Max 35 chars                                        |
| shipFrom.phone       | Yes      | Max 16 chars, must match EasyParcel MY phone format |
| shipTo.contactName   | Yes      | Max 20 chars                                        |
| shipTo.companyName   | Yes      | Max 30 chars                                        |
| shipTo.phone         | Yes      | Max 16 chars, must match EasyParcel MY phone format |
| shipTo.street1       | Yes      | Max 100 chars; combined with street2 max 100 chars  |
| shipTo.city          | Yes      | Max 35 chars                                        |
| shipTo.postalCode    | Yes      | Max 10 chars                                        |
| shipTo.country       | Yes      | Max 35 chars                                        |

**Item constraints:**

| Constraint   | Limit                  |
| ------------ | ---------------------- |
| Total weight | Max 30,000 g (30 kg)   |
| description  | Required, max 35 chars |
| price.amount | Required               |

***

### DHL eCommerce (Malaysia)

**Service type code:** `RETURN_DHL_ECOMMERC_MYS`

| Field                | Required | Limit                                               |
| -------------------- | -------- | --------------------------------------------------- |
| shipFrom.street1     | Yes      | Max 100 chars; combined with street2 max 100 chars  |
| shipFrom.city        | Yes      | Max 35 chars                                        |
| shipFrom.postalCode  | Yes      | Max 10 chars                                        |
| shipFrom.country     | Yes      | Max 35 chars                                        |
| shipFrom.contactName | No       | Max 35 chars (used as pick-up name)                 |
| shipFrom.phone       | Yes      | Max 16 chars, must match EasyParcel MY phone format |
| shipTo.contactName   | Yes      | Max 20 chars                                        |
| shipTo.companyName   | Yes      | Max 30 chars                                        |
| shipTo.phone         | Yes      | Max 16 chars, must match EasyParcel MY phone format |
| shipTo.street1       | Yes      | Max 100 chars; combined with street2 max 100 chars  |
| shipTo.city          | Yes      | Max 35 chars                                        |
| shipTo.postalCode    | Yes      | Max 10 chars                                        |
| shipTo.country       | Yes      | Max 35 chars                                        |

**Item constraints:**

| Constraint   | Limit                  |
| ------------ | ---------------------- |
| Total weight | Max 30,000 g (30 kg)   |
| description  | Required, max 35 chars |
| price.amount | Required               |

***

### Singapore Post (EZY2SHIP)

**Service type code:** `RETURN_SGPPOST_EZY2SHIP`

| Field                | Required | Limit                                     |
| -------------------- | -------- | ----------------------------------------- |
| shipFrom.contactName | Yes      | Max 35 chars                              |
| shipFrom.companyName | Yes      | Max 35 chars                              |
| shipFrom.street1     | Yes      | Max 35 chars                              |
| shipFrom.street2     | No       | Max 35 chars                              |
| shipFrom.street3     | No       | Max 35 chars                              |
| shipFrom.city        | Yes      | Max 30 chars                              |
| shipFrom.state       | Yes      | Max 30 chars                              |
| shipFrom.postalCode  | Yes      | Must match Singapore Post postcode format |
| shipFrom.phone       | Yes      | Max 20 chars                              |
| shipFrom.fax         | No       | Max 255 chars                             |
| shipFrom.country     | Yes      | Max 3 chars                               |
| shipTo.contactName   | Yes      | Max 35 chars                              |
| shipTo.companyName   | Yes      | Max 35 chars                              |
| shipTo.street1       | Yes      | Max 35 chars                              |
| shipTo.street2       | No       | Max 35 chars                              |
| shipTo.street3       | No       | Max 35 chars                              |
| shipTo.city          | Yes      | Max 30 chars                              |
| shipTo.state         | Yes      | Max 30 chars                              |
| shipTo.postalCode    | Yes      | Must match Singapore Post postcode format |
| shipTo.email         | No       | Max 100 chars, valid email format         |
| shipTo.phone         | Yes      | Max 20 chars                              |
| shipTo.country       | Yes      | Max 3 chars                               |

**Parcel constraints:**

| Constraint          | Limit                               |
| ------------------- | ----------------------------------- |
| Box type            | Must be `custom`                    |
| Total parcel weight | Must be > 0, max 100,000 g (100 kg) |
| Weight per parcel   | Must be > 0, max 100,000 g (100 kg) |
| Width               | Must be > 0                         |
| Height              | Must be > 0                         |
| Length              | Must be > 0                         |

**Item constraints:**

| Constraint        | Limit                               |
| ----------------- | ----------------------------------- |
| Total item weight | Must be > 0, max 100,000 g (100 kg) |
| description       | Max 50 chars                        |
| quantity          | Must be > 0, max 999,999            |
| weight per item   | Must be > 0, max 100,000 g          |
| price.currency    | Required, 3 chars                   |
| price.amount      | Must be >= 0                        |
| orderNumber       | Required, 1–50 chars                |

***

## Spaceship

### Spaceship UPS

**Service type code:** `RETURN_SPACESHIP_UPS`

| Field                | Required | Limit                                               |
| -------------------- | -------- | --------------------------------------------------- |
| shipFrom.contactName | Yes      | Max 35 chars                                        |
| shipFrom.companyName | Yes      | Max 35 chars                                        |
| shipFrom.street1     | Yes      | Max 70 chars                                        |
| shipFrom.street2     | No       | Max 50 chars; combined street1+street2 max 96 chars |
| shipFrom.city        | Yes      | Max 30 chars                                        |
| shipFrom.state       | No       | Max 80 chars                                        |
| shipFrom.postalCode  | Yes      | Max 9 chars                                         |
| shipFrom.country     | Yes      | Max 3 chars                                         |
| shipFrom.phone       | Yes      | Max 20 chars                                        |
| shipFrom.email       | No       | Max 81 chars, valid email format                    |
| shipFrom.fax         | No       | Max 255 chars                                       |
| shipTo.contactName   | Yes      | Max 35 chars                                        |
| shipTo.companyName   | Yes      | Max 35 chars                                        |
| shipTo.street1       | Yes      | Max 70 chars                                        |
| shipTo.street2       | No       | Max 50 chars; combined street1+street2 max 96 chars |
| shipTo.city          | Yes      | Max 30 chars                                        |
| shipTo.state         | No       | Max 80 chars                                        |
| shipTo.postalCode    | Yes      | Max 9 chars                                         |
| shipTo.country       | Yes      | Max 3 chars                                         |
| shipTo.phone         | Yes      | Max 20 chars                                        |
| shipTo.email         | No       | Max 81 chars, valid email format                    |

**Parcel constraints:**

| Constraint                | Limit                           |
| ------------------------- | ------------------------------- |
| Box type                  | Must be `custom`                |
| Weight per parcel         | Must be > 0                     |
| Total weight              | Must be > 0                     |
| Each dimension            | Must be > 0, whole numbers only |
| Max length (longest side) | 274 cm                          |
| Total dimensions (L+W+H)  | Max 302 cm                      |
| Length + girth            | Max 400 cm                      |

**Item constraints:**

| Constraint        | Limit                        |
| ----------------- | ---------------------------- |
| description       | Required, max 35 chars       |
| quantity          | Must be > 0, max 999,999,999 |
| price.amount      | Must be >= 0                 |
| Total item weight | Must be > 0                  |

***

### Spaceship DHL

**Service type code:** `RETURN_SPACESHIP_DHL`

| Field                | Required | Limit                                               |
| -------------------- | -------- | --------------------------------------------------- |
| shipFrom.contactName | Yes      | Max 200 chars                                       |
| shipFrom.companyName | Yes      | Max 100 chars                                       |
| shipFrom.street1     | Yes      | Max 70 chars                                        |
| shipFrom.street2     | No       | Max 50 chars; combined street1+street2 max 96 chars |
| shipFrom.city        | Yes      | Max 30 chars                                        |
| shipFrom.state       | No       | Max 35 chars                                        |
| shipFrom.postalCode  | Yes      | Max 9 chars                                         |
| shipFrom.country     | Yes      | Max 3 chars                                         |
| shipFrom.phone       | Yes      | Max 20 chars                                        |
| shipFrom.email       | No       | Max 81 chars, valid email format                    |
| shipFrom.fax         | No       | Max 255 chars                                       |
| shipTo.contactName   | Yes      | Max 200 chars                                       |
| shipTo.companyName   | Yes      | Max 100 chars                                       |
| shipTo.street1       | Yes      | Max 70 chars                                        |
| shipTo.street2       | No       | Max 50 chars; combined street1+street2 max 96 chars |
| shipTo.city          | Yes      | Max 30 chars                                        |
| shipTo.state         | No       | Max 35 chars                                        |
| shipTo.postalCode    | Yes      | Max 9 chars                                         |
| shipTo.country       | Yes      | Max 3 chars                                         |
| shipTo.phone         | Yes      | Max 20 chars                                        |
| shipTo.email         | No       | Max 70 chars, valid email format                    |

**Parcel constraints:**

| Constraint                | Limit                           |
| ------------------------- | ------------------------------- |
| Box type                  | Must be `custom`                |
| Weight per parcel         | Must be > 0                     |
| Total weight              | Must be > 0                     |
| Each dimension            | Must be > 0, whole numbers only |
| Max length (longest side) | 303 cm                          |
| Total dimensions (L+W+H)  | Max 789 cm                      |

**Item constraints:**

| Constraint        | Limit                        |
| ----------------- | ---------------------------- |
| description       | Required, max 35 chars       |
| quantity          | Must be > 0, max 999,999,999 |
| price.amount      | Must be >= 0                 |
| Total item weight | Must be > 0                  |
| Total item price  | Must be >= 0                 |

***

### Spaceship FedEx

**Service type code:** `RETURN_SPACESHIP_FEDEX`

| Field                | Required | Limit                                               |
| -------------------- | -------- | --------------------------------------------------- |
| shipFrom.contactName | Yes      | Max 200 chars                                       |
| shipFrom.companyName | Yes      | Max 100 chars                                       |
| shipFrom.street1     | Yes      | Max 70 chars                                        |
| shipFrom.street2     | No       | Max 50 chars; combined street1+street2 max 96 chars |
| shipFrom.city        | Yes      | Max 100 chars                                       |
| shipFrom.state       | No       | Max 80 chars                                        |
| shipFrom.postalCode  | Yes      | Max 10 chars                                        |
| shipFrom.country     | Yes      | Max 3 chars                                         |
| shipFrom.phone       | Yes      | Max 20 chars                                        |
| shipFrom.email       | No       | Max 81 chars, valid email format                    |
| shipFrom.fax         | No       | Max 255 chars                                       |
| shipTo.contactName   | Yes      | Max 200 chars                                       |
| shipTo.companyName   | Yes      | Max 100 chars                                       |
| shipTo.street1       | Yes      | Max 70 chars                                        |
| shipTo.street2       | No       | Max 50 chars; combined street1+street2 max 96 chars |
| shipTo.city          | Yes      | Max 100 chars                                       |
| shipTo.state         | No       | Max 80 chars                                        |
| shipTo.postalCode    | Yes      | Max 10 chars                                        |
| shipTo.country       | Yes      | Max 3 chars                                         |
| shipTo.phone         | Yes      | Max 20 chars                                        |
| shipTo.email         | No       | Max 81 chars, valid email format                    |

**Parcel constraints:**

| Constraint                | Limit                           |
| ------------------------- | ------------------------------- |
| Box type                  | Must be `custom`                |
| Weight per parcel         | Must be > 0                     |
| Total weight              | Must be > 0                     |
| Each dimension            | Must be > 0, whole numbers only |
| Max length (longest side) | 274 cm                          |
| Total dimensions (L+W+H)  | Max 302 cm                      |

**Item constraints:**

| Constraint        | Limit                        |
| ----------------- | ---------------------------- |
| description       | Required, max 35 chars       |
| quantity          | Must be > 0, max 999,999,999 |
| price.amount      | Must be >= 0                 |
| Total item weight | Must be > 0                  |
| Total item price  | Must be >= 0                 |