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

# ShipStation Create Shipment Label

> Create a shipping label in ShipStation at the end of an Arc flow.

export const siteNameShort = "Arc";

The Create Shipment Label action creates a shipping label in ShipStation. This action belongs at the end of a flow.

When creating a shipment label:

* Set the package specifications, "ship to" values, and customs information [with an XML Map connector](#xml-map-connector-package-ship-to-customs).
* Enter the "ship from" and test label values in the [connector configuration pane](#connector-configuration-ship-from).

## XML Map Connector: Package, Ship To, Customs

You must connect an [XML Map](../xml-map/xml-map) connector to the ShipStation connector to map the package specifications, "ship to" values, and customs information.

In the example below, the shipment information appears in the **Source** column, and the ShipStation shipping label parameters appear in the **Destination** column.

<img src="https://mintcdn.com/cdata-arc/j59334epfVQRoK96/public/images/shipstation_labelmapping.png?fit=max&auto=format&n=j59334epfVQRoK96&q=85&s=15ef34b896c5afaee37bc7beb06df775" alt="ShipStation Label Mapping" width="700" data-path="public/images/shipstation_labelmapping.png" />

### Shipment Label Values

The table below lists the values that you can map for shipment labels using the XML Map connector interface.

| Name                                                             | Data Type | Required? | Description                                                                                                                                                                                                                                                                                                           |
| ---------------------------------------------------------------- | --------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| CarrierCode                                                      | String    | Yes       | Shipping carrier code.                                                                                                                                                                                                                                                                                                |
| ServiceCode                                                      | String    | Yes       | Shipping service code.                                                                                                                                                                                                                                                                                                |
| PackageCode                                                      | String    | Yes       | Package type code.                                                                                                                                                                                                                                                                                                    |
| Confirmation                                                     | String    | No        | Type of delivery confirmation to use. Allowed values are **none**, **delivery**, **signature**, **adult\_signature**, or **direct\_signature**. **direct\_signature** is available for FedEx only.                                                                                                                    |
| ShipDate                                                         | String    | Yes       | Date the order should be shipped.                                                                                                                                                                                                                                                                                     |
| WeightValue                                                      | Integer   | Yes       | Weight value for the shipment.                                                                                                                                                                                                                                                                                        |
| WeightUnits                                                      | String    | Yes       | Unit for the weight value.                                                                                                                                                                                                                                                                                            |
| WeightWeightUnits                                                | Integer   | No        | Weight Weight Units for the shipment.                                                                                                                                                                                                                                                                                 |
| DimensionsLength                                                 | String    | No        | Package length.                                                                                                                                                                                                                                                                                                       |
| DimensionsWidth                                                  | String    | No        | Package width.                                                                                                                                                                                                                                                                                                        |
| DimensionsHeight                                                 | String    | No        | Package height.                                                                                                                                                                                                                                                                                                       |
| DimensionsUnits                                                  | String    | No        | Units of measurement for the dimensions. Allowed values are **inches** or **centimeters**.                                                                                                                                                                                                                            |
| ShipToName                                                       | String    | Yes       | Name of person.                                                                                                                                                                                                                                                                                                       |
| ShipToCompany                                                    | String    | Yes       | Name of company.                                                                                                                                                                                                                                                                                                      |
| ShipToStreet1                                                    | String    | Yes       | First line of address.                                                                                                                                                                                                                                                                                                |
| ShipToStreet2                                                    | String    | No        | Second line of address, if applicable.                                                                                                                                                                                                                                                                                |
| ShipToStreet3                                                    | String    | No        | Third line of address, if applicable.                                                                                                                                                                                                                                                                                 |
| ShipToCity                                                       | String    | Yes       | Name of city.                                                                                                                                                                                                                                                                                                         |
| ShipToState                                                      | String    | Yes       | Name of state.                                                                                                                                                                                                                                                                                                        |
| ShipToPostalCode                                                 | String    | Yes       | Postal code.                                                                                                                                                                                                                                                                                                          |
| ShipToCountry                                                    | String    | Yes       | Two-character ISO country code.                                                                                                                                                                                                                                                                                       |
| ShipToPhone                                                      | String    | No        | Telephone number for recipient.                                                                                                                                                                                                                                                                                       |
| ShipToResidential                                                | Boolean   | Yes       | Whether the ShipTo address is residential.                                                                                                                                                                                                                                                                            |
| ShipToAddressVerified                                            | String    | No        | Whether the address has been verified by ShipStation. Allowed values are **Address not yet validated**, **Address validated successfully**, **Address validation warning**, or **Address validation failed**.                                                                                                         |
| InsuranceOptions<br />InsureShipment                             | String    | No        | Whether the shipment should be insured.                                                                                                                                                                                                                                                                               |
| InsuranceOptions<br />Provider                                   | String    | No        | Preferred insurance provider. Allowed values are **shipsurance**, **carrier**, or **provider**. **provider** indicates that a shipment was insured by a third party other than ShipSurance or the carrier. Provider insurance is handled outside of ShipStation and does not affect the cost of processing the label. |
| InternationalOptions<br />Contents                               | String    | No        | Contents for international shipments. Allowed values are **merchandise**, **documents**, **gift**, **returned\_goods**, or **sample**.                                                                                                                                                                                |
| InternationalOptions<br />CustomsItems<br />CustomsItemId        | String    | No        | ItemId values for customs. If there are multiple values, separate them with commas (for example, **121221,21211,12121**).                                                                                                                                                                                             |
| InternationalOptions<br />CustomsItems<br />Description          | String    | No        | A short description of the items for customs. If you have multiple items, provide descriptions for each one by separating them with commas (for example, **desc1,desc2,desc3**).                                                                                                                                      |
| InternationalOptions<br />CustomsItems<br />Quantity             | String    | No        | Quantity of each item for customs. If you have multiple items, provide quantities for each one by separating them with commas (for example, **5,1,4**).                                                                                                                                                               |
| InternationalOptions<br />CustomsItems<br />Value                | String    | No        | Value (in USD) of each item for customs. If you have multiple items, provide values for each one by separating them with commas (for example, **10,50,100**).                                                                                                                                                         |
| InternationalOptions<br />CustomsItems<br />HarmonizedTariffCode | String    | No        | Harmonized Commodity Code of each item for customs. If you have multiple items, provide codes for each one by separating them with commas (for example, **10012,40021,30091**).                                                                                                                                       |
| InternationalOptions<br />CustomsItems<br />CountryOfOrigin      | String    | No        | Two-character ISO country code of each item for customs. If you have multiple items, provide codes for each one by separating them with commas (for example, **US,US,US**).                                                                                                                                           |
| InternationalOptions<br />NonDelivery                            | String    | No        | Non-delivery options for international shipments. Allowed values are **return\_to\_sender** or **treat\_as\_abandoned**.                                                                                                                                                                                              |
| AdvancedOptions<br />WarehouseId                                 | Integer   | No        | The Id of the warehouse that the order will ship from. If the order is fulfilled using a fill provider, there is no warehouse attached and this value is **null**.                                                                                                                                                    |
| AdvancedOptions<br />NonMachinable                               | Boolean   | No        | Whether the order is non-machinable.                                                                                                                                                                                                                                                                                  |
| AdvancedOptions<br />SaturdayDelivery                            | Boolean   | No        | Whether the order is to be delivered on a Saturday.                                                                                                                                                                                                                                                                   |
| AdvancedOptions<br />ContainsAlcohol                             | Boolean   | No        | Whether the order contains alcohol.                                                                                                                                                                                                                                                                                   |
| AdvancedOptions<br />StoreId                                     | Integer   | No        | Id of the store associated with the order. If this value is not specified, ShipStation defaults to the first manual store on the account.                                                                                                                                                                             |
| AdvancedOptions<br />CustomField1                                | String    | No        | Field that allows for custom data to be associated with an order.                                                                                                                                                                                                                                                     |
| AdvancedOptions<br />CustomField2                                | String    | No        | Field that allows for custom data to be associated with an order.                                                                                                                                                                                                                                                     |
| AdvancedOptions<br />CustomField3                                | String    | No        | Field that allows for custom data to be associated with an order.                                                                                                                                                                                                                                                     |
| AdvancedOptions<br />Source                                      | String    | No        | Original source or marketplace for the order.                                                                                                                                                                                                                                                                         |
| AdvancedOptions<br />MergedOrSplit                               | Boolean   | No        | Whether an order has been merged with or split from another order.                                                                                                                                                                                                                                                    |
| AdvancedOptions<br />MergedIds                                   | Integer   | No        | If the order was merged, this is an array of the orderIds that were merged.                                                                                                                                                                                                                                           |
| AdvancedOptions<br />ParentId                                    | Integer   | No        | If the order was split from a parent order, this is the orderId of the parent order.                                                                                                                                                                                                                                  |
| AdvancedOptions<br />BillToParty                                 | String    | No        | Party to bill for the shipment. Allowed values are **my\_account**, **my\_other\_account**, **recipient**, or **third\_party**.                                                                                                                                                                                       |
| AdvancedOptions<br />BillToAccount                               | String    | No        | Account number of the party to bill for the shipment.                                                                                                                                                                                                                                                                 |
| AdvancedOptions<br />BillToPostalCode                            | String    | No        | Postal code of the party to bill for the shipment.                                                                                                                                                                                                                                                                    |
| AdvancedOptions<br />BillToCountryCode                           | String    | No        | Two-character ISO country code of the party to bill for the shipment.                                                                                                                                                                                                                                                 |
| AdvancedOptions<br />BillToMyOtherAccount                        | String    | No        | If **AdvancedOptions<br />BillToParty** is set to **my\_other\_account**, this is the shippingProviderId value for the desired account. You can make a *List Carriers* call to obtain shippingProviderId values.                                                                                                      |

## Connector Configuration: Ship From

The configuration pane for the Create Shipment Label connector allows you to specify the **ship from** information and toggle between test labels and real labels. The table below outlines these values:

| Setting                        | Description                                                                                                                                                                                                   |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Ship From Name**             | Name of person.                                                                                                                                                                                               |
| **Ship From Company**          | Name of company.                                                                                                                                                                                              |
| **Ship From Street 1**         | First line of address.                                                                                                                                                                                        |
| **Ship From Street 2**         | Second line of address, if applicable.                                                                                                                                                                        |
| **Ship From Street 3**         | Third line of address, if applicable.                                                                                                                                                                         |
| **Ship From City**             | Name of city.                                                                                                                                                                                                 |
| **Ship From State**            | Name of state.                                                                                                                                                                                                |
| **Ship From Postal Code**      | Postal code.                                                                                                                                                                                                  |
| **Ship From Country**          | Two-character ISO country code.                                                                                                                                                                               |
| **Ship From Phone**            | Telephone number for shipper.                                                                                                                                                                                 |
| **Ship From Residential**      | Whether the Ship From address is residential.                                                                                                                                                                 |
| **Ship From Address Verified** | Whether the address has been verified by ShipStation. Allowed values are **Address not yet validated**, **Address validated successfully**, **Address validation warning**, or **Address validation failed**. |
| **Enable Test Mode**           | Whether the shipping label should be a test label. Disabled by default.                                                                                                                                       |
