NameDescriptionTypeAdditional information
WS_Key

(Mandatory) Webservice Key provided by 2ship support

string

None.

CarrierId

(Conditionally Required) Carrier ID to ship with - if not specified then it must be specified the ShipByServiceGroup and ShipByServiceGroupOptions fields

integer

None.

Sender

(Mandatory) Sender Contact

WS_Repository.Models.Requests.Ship.Contact

None.

ShipFromLockerOrLocation

(Optional) Specify ship from a locker / carrier location / carrier retail location

boolean

None.

ShipFromLocationLockerInfo

(Required if ShipFromLockerOrLocation = true)

WS_Repository.Models.Common.ShipFromLocationLockerInfo

None.

ShipToLockerOrLocation

(Optional) Specify ship to a locker / carrier location / carrier retail location

boolean

None.

ShipToLocationLockerInfo

(Required if ShipFromLockerOrLocation = true)

WS_Repository.Models.Common.ShipToLocationLockerInfo

None.

UseAlternateSenderOnLabel

(Optional) Use alternate sender on label

boolean

None.

AlternateSender

Required if UseAlternateSederOnLabe = true, Specify the alternate address that will be printed on label

WS_Repository.Models.Requests.Ship.Contact

None.

Recipient

(Mandatory) Recipient Contact

WS_Repository.Models.Requests.Ship.Contact

None.

CrossDockAddress

(Optional) Cross Dock Address - used for 2 leg shipments to determinate the middle address of the shipment. this address become 1'st leg recipient and 2'nd leg sender

WS_Repository.Models.Requests.Ship.Contact

None.

RecipientIsAutomatedParcelMachineLocation

(Optional) Specify that the Recipient is an Automated Parcel Machine Location

boolean

None.

AutomatedParcelMachineLocationId

(Mandatory if RecipientIsAutomatedParcelMachineLocation = true) Specify Automated Parcel Machine Location Id/Code

string

None.

UseDropOffToAPM

(Optional) Sender will Drop off the shipment to Automated Parcel Machine

boolean

None.

MaxDistanceToDropOff_APM

(Mandatory if UseDropOffTo_APM = true) the maximum distance of a Drop Off Automated Parcel Machine (valid values: 0.1 ... 100 km/miles), used for getting the nearest drop off APM locations

decimal number

None.

MaxDistanceToDropOff_APM_UM

(Optional) the default value is Kilometers

WS_Repository.Models.Requests.Ship.DistanceType

None.

APM_SystemId

(Mandatory if RecipientIsAutomatedParcelMachineLocation = true or UseDropOffToAPM = true) Specify the system id wich send the request (ex. 101, 102....)

string

None.

APM_SystemName

(Mandatory if RecipientIsAutomatedParcelMachineLocation = true or UseDropOffToAPM = true) Specify the system name wich send the request (ex. 2ship...)

string

None.

HasQRCodeLabelPrinting

(Optional) Drop Off Location has QR code label printing available

boolean

None.

Packages

(Mandatory) Array of Package

Collection of WS_Repository.Models.Requests.Ship.Package

None.

CalculatePackagesByContents

(Optional) if this flag is set true then Packages field will be overridden with generated packages based on a 2ship packing algorithm and with parameters set on PackageGeneratingByContents field

boolean

None.

CalculatePackagesByContentsOptions

(Optional) Packages generation parameters

WS_Repository.Models.Requests.Ship.CalculatePackagesByContentsOptions

None.

ShipmentReference

(Optional) Global Shipment reference, when is provided it is used to fill the package reference when there is no value. Also is save as Shipment Reference

string

None.

ShipmentReference2

(Optional) Global Shipment reference 2, when is provided it is used to fill the package reference 2 when there is no value. Also is save as Shipment Reference

string

None.

ShipmentPONumber

(Optional) Global Shipment PO number, when is provided it is used to fill the package PO Numbeer when there is no value. Also is save as Shipment PO Number

string

None.

ShipmentInstructions

(Optional) Shipment Instructions, used for 4x8 doctab label

string

None.

ShipmentProtection

(Optional) the Value of your Shipment (this can influence the cost of your shipment)

decimal number

None.

ShipmentProtectionCurrency

(Optional) the Currency of you Insurance Value(CAD, USD... etc)

string

None.

CarrierRoute

(Optional) Carrier Route, used for 4x8 doctab label

string

None.

CarrierSequence

(Optional) Carrier Sequence, used for 4x8 doctab label

string

None.

InternalRoutingCode

(Optional) Internal Routing Code, used for 4x8 doctab label

string

None.

PickupDate

(Optional) The Ship Date (default is today)

date

None.

Billing

(Optional) used to rate/ship with other account

WS_Repository.Models.Requests.Ship.BillingOptions

None.

ServiceCode

(Conditionally Required) Carrier Service Code - if not specified then it must be specified the ShipByServiceGroup and ShipByServiceGroupOptions fields

string

None.

InternationalOptions

(Optional) International Options of the shipment(mandatory if the shipment is international)

WS_Repository.Models.Requests.Ship.InternationalOptions

None.

Contents

(Optional) Contents of the shipment packages

WS_Repository.Models.Requests.Ship.Contents

None.

ShipOptions

(Optional) Options of the shipment - for a pecific carrier

Collection of WS_Repository.Models.Requests.Ship.ShipmentOption

None.

GlobalOptions

(Optional) Global Shipment Options - For all carriers

WS_Repository.Models.Common.GlobalOptions

None.

LocationId

(Optional) If not set will use the sender address to match the right Location to use.

integer

None.

LocationName

(Optional) If not set will use the LocationId or the sender address to match the right Location to use.

string

None.

LocationAddressMatchWholeSenderAddress

(Optional) Used when no LocationId and no LocationName are supplied. If is set to true then the location id is populated just if the sender address match the whole location address, if not you will get an Exception

boolean

None.

OrderNumber

(Optional) Your internal order number of the order

string

None.

LabelPrintPreferences

(Optional) label printing preferences (Default is PDF and Format 8.5x11 in)

WS_Repository.Models.Requests.Ship.LabelPrintPreferencesType

None.

MycarrierDetails

(Optional) when the carrier is My Carrier(999) here you can populate your carrier info

WS_Repository.Models.Requests.Ship.MyCarrierDetails

None.

OrderInfo

(Optional) Order Info (MANDATORY when LabelPrintPreferencesType.OutputFormat = Format_PackingSlip_85x11)

WS_Repository.Models.Requests.Ship.OrderInfo

None.

DepartmentDescription

(Optional) Department Description

string

None.

ShipByServiceGroup

(Optional) Specify that the shipping carrier/service will be retrieve by a service group specified on the ShipByServiceGroupOptions field

boolean

None.

ShipByServiceGroupOptions

(Conditionally required) Ship By ServiceG roup Options

WS_Repository.Models.Requests.Ship.ShipByServiceGroupOptions

None.

DepartmentCode

(Optional) Department Code

string

None.

CustomerMarkup

(Optional) Provide your own value for Customer Pricing calculation

WS_Repository.Models.Requests.Ship.CustomerMarkup

None.

ConsolidationUnit

(Optional) Used to consolidate the shipment

WS_Repository.Models.Common.ConsolidationUnit

None.

DaysToSearchInHistory

(Optional) How many days to search in history for an order. it apply just if you specify an OrderNumber (Default is 0 days)

integer

None.

PickupRequest

Schedule a Pickup Request with the shipment creation

WS_Repository.Models.Requests.Ship.PickupRequest

None.

RetrieveBase64StringDocuments

Use to get in the response also the documents in Base64String format

boolean

None.

BOLNumber

(Optional) BOL Number (Used by ltl carriers to apear on Bill Of Lading)

string

None.

RemoveExistingOnholdOrder

(Optional) Flag to specify to search and remove the existing onhold order - the search will be made if the OrderNumber field is provided

boolean

None.

SpecialInstructions

(Optional) Special Instruction (Used by ltl carriers to apear on Bill Of Lading)

string

None.

RateCurrencySelect

(Optional) Used to return rates in your selected currency using the 2Ship exchange rate from openexchangerates.org

string

None.

CartonDescription

(Optional) Used to populate the Contents area of a Carton Label. if this field is empty the Carton Label Contents will be populated with the shipment Contents.

string

None.

IsReturn

(Optional) the shipment will be treated as a return

boolean

None.

OriginalShipmentInfo

(Optional) Information about Original Shipment (Shipment Id or Tracking Number)

WS_Repository.Models.Requests.Ship.OriginalShipmentInfo

None.

IsInboundShipment

(Optional) the shipment will be treated as an inbound

boolean

None.

InboundShipmentLocationId

(Optional) if shipment is Inbound then add inbound location id. Note: can be null, inbound location id can be assigned in OPS

integer

None.

InboundShipmentLocationName

(Optional) if shipment is Inbound then add inbound location name. Note: can be null, inbound location name can be assigned in OPS

string

None.

GLCategory

(Optional) General Ledger Category

string

None.

GLSubCategory

(Optional) General Ledger sub Category

string

None.

EmailShippingDocuments

(Optional) Used to send the shipping documents by email;

WS_Repository.Models.Requests.Ship.EmailDocuments

None.

UseUserPreferencesForEAlerts

(Optional) Specify to use user preferences for eAlerts

boolean

None.

eAlerts

(Optional) eAlert - send email alerts to the specified email list for the spcified events

WS_Repository.Models.Requests.Ship.eAlerts

None.

ShipperLoadAndCount

(Optional) Shipper Load And Count - Mandatory if the carrier is FedEx - CarrierId = 2 and the services are one of the Freight services

string

None.

BookingConfirmationNumber

(Optional) Booking Confirmation Number - Mandatory if the carrier is FedEx - CarrierId = 2 and the services are one of the Freight services

string

None.

GetShipLabelByPiece

(Optional) If this flag is set, the ship API response will return individual files for each package label - the document type will be PieceLabel

boolean

None.

SourceOfOrder

(Optional) This field will store source of order for history, search, reports, etc. (Maximum length = 100 characters. Default value = "API".)

string

None.

Webhooks

(Optional) webhook options, to have 2Ship post full shipment data in json format whenever this shipment changes status

Collection of WS_Repository.Models.Requests.Ship.Webhook

None.

CustomCharacterOverlayOnLabel

(Optional) Custom Character Overlay On Label (Max 1 character)

string

None.

CheckAndDeleteFromOnHold

(Optional) Check if the order # you specify on the OrderNumber field if exists in onhold and delete it if this request is succeeded

boolean

None.

UseDefaultGlobalShipmentOptions

(Optional) It specify to load the default global options from 2Ship

boolean

None.

SkipOrderIsAlreadyShippedCheck

(Optional) if OrderNumber is present in your request and if you set this flag then it skip the checking if this order number is already shippend

boolean

None.

PreAssignTrackingNumber

(Optional) Tracking Number pre-assign - Used by some carriers that accept this feautere

string

None.

ApplyDutiesAndTaxes

(Optional) It specify to get estimated duties and taxes cost for international shipments

boolean

None.

ShipWithoutAPrinter

(Optional) Use this filter to find the Carrier services that allow you to ship without the need for a printed label

boolean

None.

CustomField1

(Optional) Used to make rules with it

string

None.

CustomField2

(Optional) Used to make rules with it

string

None.

CustomField3

(Optional) Used to make rules with it

string

None.

CustomField4

(Optional) Used to make rules with it

string

None.

CustomField5

(Optional) Used to make rules with it

string

None.