CreateLabelForShipment
Creates a label for a shipment
Input
| Name | Type | Required | Accepts Output Streams | Description |
| DownloadLocation | String | False | False | The location on the disk where to download the label. |
| CarrierCode | String | True | False | The code for the carrier that is to be used for the label. |
| ServiceCode | String | True | False | The code for the shipping service that is to be used for the label. |
| PackageCode | String | True | False | Identifies the packing type that should be used for this label. |
| Confirmation | String | False | False | The type of delivery confirmation that is to be used once the shipment is created. Possible values: none, delivery, signature, adult_signature, and direct_signature. direct_signature is available for FedEx only. |
| ShipDate | String | True | False | The date the order should be shipped. |
| WeightValue | Integer | True | False | Weight_value of the order. |
| WeightUnits | String | True | False | Weight_units of the order. |
| WeightWeightUnits | Integer | False | False | Weight_WeightUnits of the order. |
| DimensionsLength | String | False | False | Length of package. |
| DimensionsWidth | String | False | False | Width of package. |
| DimensionsHeight | String | False | False | Height of package |
| DimensionsUnits | String | False | False | Units of measurement. Allowed units are: 'inches', or 'centimeters' |
| ShipFromName | String | True | False | Name of person. |
| ShipFromCompany | String | True | False | Name of company. |
| ShipFromStreet1 | String | True | False | First line of address. |
| ShipFromStreet2 | String | False | False | Second line of address. |
| ShipFromStreet3 | String | False | False | Third line of address. |
| ShipFromCity | String | True | False | City. |
| ShipFromState | String | True | False | State. |
| ShipFromPostalCode | String | True | False | Postal Code. |
| ShipFromCountry | String | True | False | Country Code. The two-character ISO country code is required. |
| ShipFromPhone | String | False | False | Telephone number. |
| ShipFromResidential | Boolean | True | False | Residential. |
| ShipFromAddressVerified | String | False | False | Identifies whether the address has been verified by ShipStation (read only). Possible values: Address not yet validated, Address validated successfully, Address validation warning, Address validation failed. |
| ShipToName | String | True | False | Name of person. |
| ShipToCompany | String | True | False | Name of company. |
| ShipToStreet1 | String | True | False | First line of address. |
| ShipToStreet2 | String | False | False | Second line of address. |
| ShipToStreet3 | String | False | False | Third line of address. |
| ShipToCity | String | True | False | City. |
| ShipToState | String | True | False | State. |
| ShipToPostalCode | String | True | False | Postal Code. |
| ShipToCountry | String | True | False | Country Code. The two-character ISO country code is required. |
| ShipToPhone | String | False | False | Telephone number. |
| ShipToResidential | Boolean | True | False | Residential. |
| ShipToAddressVerified | String | False | False | Identifies whether the address has been verified by ShipStation (read only). Possible values: Address not yet validated, Address validated successfully, Address validation warning, Address validation failed. |
| InsuranceOptionsProvider | String | False | False | Preferred Insurance provider. Available options: shipsurance, carrier, or provider. The provider option is used to indicate that a shipment was insured by a third party other than ShipSurance or the carrier. The insurance is handled outside of ShipStation, and will not affect the cost of processing the label. |
| InsuranceOptionsInsureShipment | String | False | False | Indicates whether shipment should be insured. |
| InsuranceOptionsProvider | String | False | False | Value to insure. |
| InternationalOptionsContents | String | False | False | Contents of international shipment. Available options are: merchandise, documents, gift, returned_goods, or sample |
| InternationalOptionsCustomsItemsCustomsItemId | String | False | False | If this field is included when submitting an order through Order/CreateOrder, then it will look for the corresponding customs line and update any values.(Multiple values can be given as input with comma separator like: '121221,21211,12121'). |
| InternationalOptionsCustomsItemsDescription | String | False | False | A short description of the CustomsItem(Multiple Description for the corresponding CustomsItemId can be given as input with comma separator like: 'desc1,desc2,desc3'). |
| InternationalOptionsCustomsItemsQuantity | String | False | False | The quantity for this line item(Multiple Quantity for the corresponding CustomsItemId can be given as input with comma separator like: '5,1,4'). |
| InternationalOptionsCustomsItemsValue | String | False | False | The value (in USD) of the line item(Multiple Value for the corresponding CustomsItemId can be given as input with comma separator like: '10,50,100'). |
| InternationalOptionsCustomsItemsHarmonizedTariffCode | String | False | False | The Harmonized Commodity Code for this line item(Multiple HarmonizedTariffCode for the corresponding CustomsItemId can be given as input with comma separator like: '12312,12312,12312'). |
| InternationalOptionsCustomsItemsCountryOfOrigin | String | False | False | The 2-character ISO country code where the item originated(Multiple CountryOfOrigin for the corresponding CustomsItemId can be given as input with comma separator like: 'US,US,US'). |
| InternationalOptionsNonDelivery | String | False | False | Non-Delivery option for international shipment. Available options are: return_to_sender or treat_as_abandoned. Please note: If the shipment is created through the Orders/CreateLabelForOrder endpoint and the nonDelivery field is not specified then value defaults based on the International Setting in the UI. If the call is being made to the Shipments/CreateLabel endpoint and the nonDelivery field is not specified then the value will default to return_to_sender. |
| AdvancedOptionsWarehouseId | Integer | False | False | Specifies the warehouse where to the order is to ship from. If the order was fulfilled using a fill provider, no warehouse is attached to these orders and will result in a null value being returned. *Please see note below |
| AdvancedOptionsNonMachinable | Boolean | False | False | Specifies whether the order is non-machinable. |
| AdvancedOptionsSaturdayDelivery | Boolean | False | False | Specifies whether the order is to be delivered on a Saturday. |
| AdvancedOptionsContainsAlcohol | Boolean | False | False | Specifies whether the order contains alcohol. |
| AdvancedOptionsStoreId | Integer | False | False | ID of store that is associated with the order. If not specified in the CreateOrder call either to create or update an order, ShipStation will default to the first manual store on the account. Can only be specified during order creation. |
| AdvancedOptionsCustomField1 | String | False | False | Field that allows for custom data to be associated with an order. *Please see note below |
| AdvancedOptionsCustomField2 | String | False | False | Field that allows for custom data to be associated with an order. *Please see note below |
| AdvancedOptionsCustomField3 | String | False | False | Field that allows for custom data to be associated with an order. *Please see note below |
| AdvancedOptionsSource | String | False | False | Identifies the original source/marketplace of the order. *Please see note below |
| AdvancedOptionsMergedOrSplit | Boolean | False | False | Read-Only: Returns whether or not an order has been merged or split with another order. Read Only |
| AdvancedOptionsMergedIds | Integer | False | False | Read-Only: Array of orderIds. Each orderId identifies an order that was merged with the associated order. Read Only |
| AdvancedOptionsParentId | Integer | False | False | Read-Only: If an order has been split, it will return the Parent ID of the order with which it has been split. If the order has not been split, this field will return null. Read Only |
| AdvancedOptionsBillToParty | String | False | False | Identifies which party to bill. Possible values: my_account, my_other_account (see note below), recipient, third_party. billTo values can only be used when creating/updating orders.. |
| AdvancedOptionsBillToAccount | String | False | False | Account number of billToParty. billTo values can only be used when creating/updating orders.. |
| AdvancedOptionsBillToPostalCode | String | False | False | Postal Code of billToParty. billTo values can only be used when creating/updating orders. |
| AdvancedOptionsBillToCountryCode | String | False | False | Country Code of billToParty. billTo values can only be used when creating/updating orders. |
| AdvancedOptionsBillToMyOtherAccount | String | False | False | When using my_other_account billToParty value, the shippingProviderId value associated with the desired account. Make a List Carriers call to obtain shippingProviderId values. |
| TestLabel | Boolean | False | False | Specifies Whether A Test Label Should Be Created.
The default value is false. |
| Encoding | String | False | False | The FileData input encoding type.
The allowed values are NONE, BASE64. The default value is BASE64. |
| FileStream | String | False | True | An instance of an output stream where file data is written to. Only used if DownloadLocation is not provided. |
Result Set Columns
| Name | Type | Description |
| Status | String | The status of the operation. |
| FileData | String | If the DownloadLocation and FileStream are not provided, this contains the content of the file. |