Name | Description | Type | Additional information |
---|---|---|---|
WS_Key |
(Mandatory) Webservice Key provided by 2ship support |
string |
None. |
CarrierId |
(Optional) if pressent will get all services for that carrier |
integer |
None. |
Sender |
(Optional) Sender Contact - if not present then will get the default user sender |
WS_Repository.Models.Requests.Hold.Contact |
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.Hold.Contact |
None. |
Recipient |
(Mandatory) Recipient Contact |
WS_Repository.Models.Requests.Hold.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.Hold.Contact |
None. |
UseShipmentLevelInfo |
(Optional) Use the shipment level info instead of Packages |
boolean |
None. |
ShipmentLevelInfo |
(Conditionally required (UseShipmentLevelInfo = true)) Shipment Level Info of the shipment |
WS_Repository.Models.Requests.Hold.ShipmentLevelInfo |
None. |
Packages |
(Mandatory) Array of Package - Optional if CalculatePackagesByContents = true |
Collection of WS_Repository.Models.Requests.Hold.Package |
None. |
Skids |
(Optional) Array of skids - Skids alternative of the Packages |
Collection of WS_Repository.Models.Requests.Hold.Package |
None. |
PackagesAreSkids |
(Optional) If is set to true it specify that all the items in Packages will be treated as Skids - is taking in consideration only when no Skids are sent |
boolean |
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. |
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. |
ShipmentInstructions |
(Optional) Shipment Instructions, used for 4x8 doctab label |
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. |
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. |
PickupDate |
(Optional) The Ship Date (default is today) |
date |
None. |
Billing |
(Optional) used to rate/ship with other account |
WS_Repository.Models.Requests.Hold.BillingOptions |
None. |
ServiceCode |
(Optional) can be present just if there is a Carrier Id |
string |
None. |
InternationalOptions |
(Optional) Internation Options of the order(if the order is intranational) |
WS_Repository.Models.Requests.Hold.InternationalOptions |
None. |
Contents |
(Optional) Contents of the shipment packages |
WS_Repository.Models.Requests.Hold.Contents |
None. |
ShipOptions |
(Optional) Used to filter services that include some options |
Collection of WS_Repository.Models.Requests.Hold.ShipmentOption |
None. |
LocationId |
(Optional) If not set will use the LocationName or 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. |
CallbackURL |
(Optional) use to call your webservice back when a status of an order is changing when order is shipped i call this url with the following parameters TrackingNumber={Carrier Shipment Tr #}&OrderNumber={Your Order #}&CurrentStatus=Shipped&LabelUrl={Url of the label}&TotalCost={cost of the shipment}&CarrierId={Carrier id}&CarrierName={Carrier Name}&ServiceCode={Service Code}&ServiceName={Service Name}&TrackingNumbers={all packages tracking numbers separeted by ,}&Currency={cost currency}&LabelFormat={label format: Format_4x6, Format_85x11, Format_PackingSlip_85x11} when shipment is deleted after the ship i call this url with the following parameters TrackingNumber={Carrier Shipment Tr #}&OrderNumber={Your Order #}&CurrentStatus=Deleted |
string |
None. |
ServiceGroup |
(Optional) Service Group Id - used to filter services which are in this Group |
integer |
None. |
ServiceGroupName |
(Optional) Service Group Name - used to filter services which are in this Group |
string |
None. |
MycarrierDetails |
(Optional) when the carrier is My Carrier(999) here you can populate your carrier info |
WS_Repository.Models.Requests.Hold.MyCarrierDetails |
None. |
OrderInfo |
(Optional) Order Info - will appear on Packing Slip Document when that type of label is setup on user |
WS_Repository.Models.Requests.Hold.OrderInfo |
None. |
DepartmentDescription |
(Optional) Department Description |
string |
None. |
DepartmentCode |
(Optional) Department Code |
string |
None. |
CustomerMarkups |
(Optional) Provide your own values for Customer Pricing calculation |
Collection of WS_Repository.Models.Requests.Hold.CustomerMarkup |
None. |
ConsolidationUnit |
(Optional) Used to consolidate the shipment |
WS_Repository.Models.Common.ConsolidationUnit |
None. |
RateCurrencySelect |
(Optional) Used to return rates in your selected currency using the 2Ship exchange rate from openexchangerates.org |
string |
None. |
ApplyRate |
(Optional) Will rate your order and attach the cheapest/fastest (based on ApplyRateType type) rate, this meaning to find cheapest/fastest service for a carrier if you put the CarrierId‎ or find cheapest/fastest across all carriers if you do not put the CarrierId or find the rate for Carrier and Service if you put the CarrierId and a ServiceCode |
boolean |
None. |
ApplyDutiesAndTaxes |
(Optional) Will get an estimate cost of duties and taxes for international shipments |
boolean |
None. |
ApplyRateOptions |
(Optional) Used when Applyrate is set to get the cheapest/fastest service by filtering services that include the options specified in this field |
WS_Repository.Models.Requests.Hold.RateOptions |
None. |
ApplyRateType |
(Optional) Based on this type it apply the cheapest or the fastest service |
WS_Repository.Models.Requests.Hold.ApplyRateType |
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. |
BOLNumber |
(Optional) BOL Number (Used by ltl carriers to apear on Bill Of Lading) |
string |
None. |
SpecialInstructions |
(Optional) Special Instruction (Used by ltl carriers to apear on Bill Of Lading) |
string |
None. |
ProjectId |
(Optional) Use to group a bunch of shipments |
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. |
ReturnShipment |
(Optional) Settings for printing the return label simultaneously with the outbound shipment (this field is ignored when IsReturn flag is set on) |
WS_Repository.Models.Requests.Hold.PrintReturnLabel |
None. |
RequestPickup |
(Optional) Flag to specify a pickup request should be sheduled |
boolean |
None. |
EmailLabels |
(Optional) Flag to specify the labels should be emailed |
boolean |
None. |
EmailsList |
(Optional) the list of emails where to send the labels |
Collection of string |
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. |
eAlerts |
(Optional) eAlert - send email alerts to the specified email list for the spcified events |
WS_Repository.Models.Requests.Hold.eAlerts |
None. |
FilterByDeliveryDate |
(Optional) Flag to filter the ratings by MaxDeliveryDate |
boolean |
None. |
MaxDeliveryDate |
(Optional) Max delivery date of the shipment |
date |
None. |
RunAggregationAfterHold |
(Optional) Run Aggregation After importing |
boolean |
None. |
RunAggregationRateAfterHold |
(Optional) Run Aggregation Rate After importing |
boolean |
None. |
ExcludeOrderFromAggregation |
(Optional) Specify that the order cannot aggregate with other orders |
boolean |
None. |
PackagesCanMergeInASinglePackageOnAggregation |
(Optional) Specify that the order packages will be merged in a single package when aggregate with other orders |
boolean |
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. |
LabelPrintPreferences |
(Optional) label printing preferences (Default is PDF and Format 8.5x11 in) |
WS_Repository.Models.Requests.Hold.LabelPrintPreferencesType |
None. |
ShipByDate |
(Optional) the date by which the order must be shipped |
date |
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.Hold.CalculatePackagesByContentsOptions |
None. |
InternalHandling |
(Optional) Specify that this order will print an extra label with the InternalHandlingText on it |
WS_Repository.Models.Requests.Hold.InternalHandling |
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.Hold.Webhook |
None. |
OrderProcessingSync |
(Optional) if this is set then when ApplyRate = true and/or CalculatePackagesByContents = true you will get the Response after these are done |
boolean |
None. |
CustomCharacterOverlayOnLabel |
(Optional) Custom Character Overlay On Label (Max 1 character) |
string |
None. |
ExternalOrderIdentifier |
Optional information that is sent back on webhooks, and can be used to store internal ids so that webhook replies are aliased to these internal ids in the caller systems. |
string |
None. |
PreAssignTrackingNumber |
(Optional) Tracking Number pre-assign - Used by some carriers that accept this feautere |
string |
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. |
OnHoldStatus |
(Optional) Status of the Order in OnHold |
WS_Repository.Models.Requests.Hold.OnHoldStatus |
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. |
NeedApproval |
(Optional) If this flag is true than the order need to be approved before ship |
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. |
DeliveryToPOBox |
(Optional) filter out carriers that do not deliver to po box - only apply if your customer has this setting tuned on in client settings |
boolean |
None. |
CheckInventory |
(Optional) Specify to check the inventory and split the order if the contents are located to multiple warehouses. Only works for if your client has the inventory feature enabled. |
boolean |
None. |