dw.order
Class Shipment
Represents an order shipment.
Constants
SHIPMENT_NOTSHIPPED  :  Number = 0
Shipment shipping status representing 'Not shipped'.
Deprecated:
SHIPMENT_SHIPPED  :  Number = 2
Shipment shipping status representing 'Shipped'.
Deprecated:
SHIPPING_STATUS_NOTSHIPPED  :  Number = 0
Shipment shipping status representing 'Not shipped'.
SHIPPING_STATUS_SHIPPED  :  Number = 2
Shipment shipping status representing 'Shipped'.
Properties
adjustedMerchandizeTotalGrossPrice  :  Money  (Read Only)
The adjusted total gross price, including tax, in the purchase currency. The adjusted total gross price represents the sum of product prices and adjustments including tax, excluding services.
adjustedMerchandizeTotalNetPrice  :  Money  (Read Only)
The adjusted net price, excluding tax, in the purchase currency. The adjusted net price represents the the sum of product prices and adjustments, excluding services and tax.
adjustedMerchandizeTotalPrice  :  Money  (Read Only)
The product total price after all product discounts. If the line item container is based on net pricing the adjusted product total net price is returned. If the line item container is based on gross pricing the adjusted product total gross price is returned.
adjustedMerchandizeTotalTax  :  Money  (Read Only)
The total adjusted product tax in the purchase currency. The total adjusted product tax represents the tax on products and adjustments, excluding services.
adjustedShippingTotalGrossPrice  :  Money  (Read Only)
The adjusted sum of all shipping line items of the shipment, including shipping adjustuments and tax
adjustedShippingTotalNetPrice  :  Money  (Read Only)
The sum of all shipping line items of the shipment, including shipping adjustments, excluding tax.
adjustedShippingTotalPrice  :  Money  (Read Only)
The adjusted shipping total price. If the line item container is based on net pricing the adjusted shipping total net price is returned. If the line item container is based on gross pricing the adjusted shipping total gross price is returned.
adjustedShippingTotalTax  :  Money  (Read Only)
The tax of all shipping line items of the shipment , including shipping adjustments.
allLineItems  :  Collection  (Read Only)
All line items related to the shipment.

The returned collection may include line items of the following types:

Their common type is LineItem.

Each ProductLineItem in the collection may itself contain bundled or option product line items, as well as a product-level shipping line item.

default  :  boolean  (Read Only)
Return true if this shipment is the default shipment (shipment ID "me").
gift  :  boolean
Returns true if this line item represents a gift, false otherwise.
giftCertificateLineItems  :  Collection  (Read Only)
All gift certificate line items of the shipment.
giftMessage  :  String
The value set for gift message or null if no value set.
ID  :  String  (Read Only)
The ID of this shipment ("me" for the default shipment).
merchandizeTotalGrossPrice  :  Money  (Read Only)
The gross product subtotal in the purchase currency. The gross product subtotal represents the sum of product prices including tax, excluding services and adjustments.
merchandizeTotalNetPrice  :  Money  (Read Only)
The net product subtotal, excluding tax, in the purchase currency. The net product subtotal represents the sum of product prices, excluding services, adjustments, and tax.
merchandizeTotalPrice  :  Money  (Read Only)
The product total price. If the line item container is based on net pricing the product total net price is returned. If the line item container is based on gross pricing the product total gross price is returned.
merchandizeTotalPriceAdjustments  :  Collection  (Read Only)
A collection of price adjustments that have been applied to the totals, such as a promotion on the purchase value (i.e. $10 Off or 10% Off).
Deprecated:
Shipments cannot have product price adjustments, therefore this method will always return an empty collection
merchandizeTotalTax  :  Money  (Read Only)
The total product tax in the purchase currency. The total product tax represents the tax on products, excluding services and adjustments.
productLineItems  :  Collection  (Read Only)
A collection of all product line items related to this shipment.
proratedMerchandizeTotalPrice  :  Money  (Read Only)
The total product price of the shipment, including product-level adjustments and prorating all Buy-X-Get-Y and order-level adjustments, according to the scheme described in PriceAdjustment.getProratedPrices(). For net pricing the net price is returned. For gross pricing, the gross price is returned.
shipmentNo  :  String  (Read Only)
The shipment number for this shipment.

When an order is placed (OrderMgr.placeOrder(Order)) shipment number will be filled using a sequence. Before order was placed null will be returned.

shippingAddress  :  OrderAddress  (Read Only)
The shipping address or null if none is set.
shippingLineItems  :  Collection  (Read Only)
A collection of all shipping line items of the shipment, excluding any product-level shipping costs that are associated with ProductLineItems of the shipment.
shippingMethod  :  ShippingMethod
The shipping method or null if none is set.
shippingMethodID  :  String  (Read Only)
The shipping method ID or null if none is set.
shippingPriceAdjustments  :  Collection  (Read Only)
A collection of price adjustments that have been applied to the shipping costs of the shipment, for example by the promotions engine.
Note that this method returns all shipping price adjustments in this shipment, regardless of which shipping line item they belong to. Use ShippingLineItem.getShippingPriceAdjustments() to retrieve the shipping price adjustments associated with a specific shipping line item.
shippingStatus  :  EnumValue
The shipping status. Possible values are SHIPMENT_NOTSHIPPED or SHIPMENT_SHIPPED.
shippingTotalGrossPrice  :  Money  (Read Only)
The sum of all shipping line items of the shipment, including tax, excluding shipping adjustments.
shippingTotalNetPrice  :  Money  (Read Only)
The sum of all shipping line items of the shipment, excluding tax and adjustments.
shippingTotalPrice  :  Money  (Read Only)
The shipping total price. If the line item container is based on net pricing the shipping total net price is returned. If the line item container is based on gross pricing the shipping total gross price is returned.
shippingTotalTax  :  Money  (Read Only)
The tax of all shipping line items of the shipment before shipping adjustments have been applied.
standardShippingLineItem  :  ShippingLineItem  (Read Only)
Convenience method. Same as getShippingLineItem(ShippingLineItem.STANDARD_SHIPPING_ID)
totalGrossPrice  :  Money  (Read Only)
The total gross price of the shipment in the purchase currency. The total gross price is the sum of product prices, service prices, adjustments, and tax.
totalNetPrice  :  Money  (Read Only)
The total net price of the shipment in the purchase currency. The total net price is the sum of product prices, service prices, and adjustments, excluding tax.
totalTax  :  Money  (Read Only)
The total tax for the shipment in the purchase currency.
trackingNumber  :  String
The tracking number of this shipment.
Constructor Summary
This class does not have a constructor, so you cannot create it directly.
Method Summary
createShippingAddress() : OrderAddress
A shipment has initially no shipping address.
createShippingLineItem(id : String) : ShippingLineItem
Creates a new shipping line item for this shipment.
createShippingPriceAdjustment(promotionID : String) : PriceAdjustment
Creates a shipping price adjustment to be applied to the shipment.
getAdjustedMerchandizeTotalGrossPrice() : Money
Returns the adjusted total gross price, including tax, in the purchase currency.
getAdjustedMerchandizeTotalNetPrice() : Money
Returns the adjusted net price, excluding tax, in the purchase currency.
getAdjustedMerchandizeTotalPrice() : Money
Returns the product total price after all product discounts.
getAdjustedMerchandizeTotalPrice(applyOrderLevelAdjustments : boolean) : Money
Returns the total product price including product-level adjustments and, optionally, prorated order-level adjustments.
getAdjustedMerchandizeTotalTax() : Money
Returns the total adjusted product tax in the purchase currency.
getAdjustedShippingTotalGrossPrice() : Money
Returns the adjusted sum of all shipping line items of the shipment, including shipping adjustuments and tax
getAdjustedShippingTotalNetPrice() : Money
Returns the sum of all shipping line items of the shipment, including shipping adjustments, excluding tax.
getAdjustedShippingTotalPrice() : Money
Returns the adjusted shipping total price.
getAdjustedShippingTotalTax() : Money
Returns the tax of all shipping line items of the shipment , including shipping adjustments.
getAllLineItems() : Collection
Returns all line items related to the shipment.
getGiftCertificateLineItems() : Collection
Returns all gift certificate line items of the shipment.
getGiftMessage() : String
Returns the value set for gift message or null if no value set.
getID() : String
Returns the ID of this shipment ("me" for the default shipment).
getMerchandizeTotalGrossPrice() : Money
Returns the gross product subtotal in the purchase currency.
getMerchandizeTotalNetPrice() : Money
Returns the net product subtotal, excluding tax, in the purchase currency.
getMerchandizeTotalPrice() : Money
Returns the product total price.
getMerchandizeTotalPriceAdjustments() : Collection
Returns a collection of price adjustments that have been applied to the totals, such as a promotion on the purchase value (i.e.
getMerchandizeTotalTax() : Money
Returns the total product tax in the purchase currency.
getProductLineItems() : Collection
Returns a collection of all product line items related to this shipment.
getProratedMerchandizeTotalPrice() : Money
Returns the total product price of the shipment, including product-level adjustments and prorating all Buy-X-Get-Y and order-level adjustments, according to the scheme described in PriceAdjustment.getProratedPrices().
getShipmentNo() : String
Returns the shipment number for this shipment.
getShippingAddress() : OrderAddress
Returns the shipping address or null if none is set.
getShippingLineItem(id : String) : ShippingLineItem
Returns the shipping line item identified by the specified ID, or null if not found.
getShippingLineItems() : Collection
Returns a collection of all shipping line items of the shipment, excluding any product-level shipping costs that are associated with ProductLineItems of the shipment.
getShippingMethod() : ShippingMethod
Returns the shipping method or null if none is set.
getShippingMethodID() : String
Returns the shipping method ID or null if none is set.
getShippingPriceAdjustmentByPromotionID(promotionID : String) : PriceAdjustment
Returns the shipping price adjustment associated with the specified promotion ID.
getShippingPriceAdjustments() : Collection
Returns a collection of price adjustments that have been applied to the shipping costs of the shipment, for example by the promotions engine.
Note that this method returns all shipping price adjustments in this shipment, regardless of which shipping line item they belong to.
getShippingStatus() : EnumValue
Returns the shipping status.
getShippingTotalGrossPrice() : Money
Returns the sum of all shipping line items of the shipment, including tax, excluding shipping adjustments.
getShippingTotalNetPrice() : Money
Returns the sum of all shipping line items of the shipment, excluding tax and adjustments.
getShippingTotalPrice() : Money
Returns the shipping total price.
getShippingTotalTax() : Money
Returns the tax of all shipping line items of the shipment before shipping adjustments have been applied.
getTotalGrossPrice() : Money
Returns the total gross price of the shipment in the purchase currency.
getTotalNetPrice() : Money
Returns the total net price of the shipment in the purchase currency.
getTotalTax() : Money
Returns the total tax for the shipment in the purchase currency.
getTrackingNumber() : String
Returns the tracking number of this shipment.
isDefault() : boolean
Return true if this shipment is the default shipment (shipment ID "me").
isGift() : boolean
Returns true if this line item represents a gift, false otherwise.
removeShippingLineItem(shippingLineItem : ShippingLineItem) : void
Removes the specified shipping line item and any of its dependent shipping price adjustments.
removeShippingPriceAdjustment(priceAdjustment : PriceAdjustment) : void
Removes the specified shipping price adjustment from the shipment.
setGift(isGift : boolean) : void
Controls if this line item is a gift or not.
setGiftMessage(message : String) : void
Sets the value to set for the gift message.
setShippingMethod(method : ShippingMethod) : void
Set the specified shipping method for the specified shipment.
setShippingStatus(status : Number) : void
Sets the shipping status of the shipment.
setTrackingNumber(aValue : String) : void
Sets the tracking number of this shipment.
Methods inherited from class ExtensibleObject
Methods inherited from class PersistentObject
Method Detail
createShippingAddress
createShippingAddress() : OrderAddress
A shipment has initially no shipping address. This method creates a shipping address for the shipment and replaces an existing shipping address.
Returns:
The new shipping address of the shipment

createShippingLineItem
createShippingLineItem(id : String) : ShippingLineItem
Creates a new shipping line item for this shipment. If the specified ID is already assigned to any of the existing shipping line items of the shipment, the method throws an exception.
Parameters:
id - The id to use to locate the new shipping line item.
Returns:
The new shipping line item.

createShippingPriceAdjustment
createShippingPriceAdjustment(promotionID : String) : PriceAdjustment
Creates a shipping price adjustment to be applied to the shipment. The price adjustment implicitly belongs to the standard shipping line item if this line item exists, otherwise it belongs to the shipment itself.
The promotion ID is mandatory and must not be the ID of any actual promotion defined in Salesforce B2C Commerce.
If there already exists a shipping price adjustment line item referring to the specified promotion ID, an exception is thrown.
Deprecated:
Deprecated in favor of ShippingLineItem.createShippingPriceAdjustment(String), which explicitly relates the price adjustment to a shipping line item.
Parameters:
promotionID - Promotion ID
Returns:
The new price adjustment line item.

getAdjustedMerchandizeTotalGrossPrice
getAdjustedMerchandizeTotalGrossPrice() : Money
Returns the adjusted total gross price, including tax, in the purchase currency. The adjusted total gross price represents the sum of product prices and adjustments including tax, excluding services.
Returns:
the adjusted total gross price, including tax, in the purchase currency.

getAdjustedMerchandizeTotalNetPrice
getAdjustedMerchandizeTotalNetPrice() : Money
Returns the adjusted net price, excluding tax, in the purchase currency. The adjusted net price represents the the sum of product prices and adjustments, excluding services and tax.
Returns:
the adjusted net price, excluding tax, in the purchase currency.

getAdjustedMerchandizeTotalPrice
getAdjustedMerchandizeTotalPrice() : Money
Returns the product total price after all product discounts. If the line item container is based on net pricing the adjusted product total net price is returned. If the line item container is based on gross pricing the adjusted product total gross price is returned.
Returns:
either the adjusted product total net or gross price.

getAdjustedMerchandizeTotalPrice
getAdjustedMerchandizeTotalPrice(applyOrderLevelAdjustments : boolean) : Money
Returns the total product price including product-level adjustments and, optionally, prorated order-level adjustments. For net pricing the net price is returned. For gross pricing, the gross price is returned.
Parameters:
applyOrderLevelAdjustments - If true, prorated order-level adjustments will be applied to total price
Returns:
Adjusted net or gross product total price

getAdjustedMerchandizeTotalTax
getAdjustedMerchandizeTotalTax() : Money
Returns the total adjusted product tax in the purchase currency. The total adjusted product tax represents the tax on products and adjustments, excluding services.
Returns:
the total tax in purchase currency.

getAdjustedShippingTotalGrossPrice
getAdjustedShippingTotalGrossPrice() : Money
Returns the adjusted sum of all shipping line items of the shipment, including shipping adjustuments and tax
Returns:
the adjusted sum of all shipping line items of the shipment, including shipping adjustuments and tax

getAdjustedShippingTotalNetPrice
getAdjustedShippingTotalNetPrice() : Money
Returns the sum of all shipping line items of the shipment, including shipping adjustments, excluding tax.
Returns:
the sum of all shipping line items of the shipment, including shipping adjustments, excluding tax.

getAdjustedShippingTotalPrice
getAdjustedShippingTotalPrice() : Money
Returns the adjusted shipping total price. If the line item container is based on net pricing the adjusted shipping total net price is returned. If the line item container is based on gross pricing the adjusted shipping total gross price is returned.
Returns:
either the adjusted shipping total net or gross price

getAdjustedShippingTotalTax
getAdjustedShippingTotalTax() : Money
Returns the tax of all shipping line items of the shipment , including shipping adjustments.
Returns:
the tax of all shipping line items of the shipment , including shipping adjustments.

getAllLineItems
getAllLineItems() : Collection
Returns all line items related to the shipment.

The returned collection may include line items of the following types:

Their common type is LineItem.

Each ProductLineItem in the collection may itself contain bundled or option product line items, as well as a product-level shipping line item.

Returns:
all line items related to ths shipment.

getGiftCertificateLineItems
getGiftCertificateLineItems() : Collection
Returns all gift certificate line items of the shipment.
Returns:
A collection of all GiftCertificateLineItems of the shipment.

getGiftMessage
getGiftMessage() : String
Returns the value set for gift message or null if no value set.
Returns:
the value set for gift message or null if no value set.

getID
getID() : String
Returns the ID of this shipment ("me" for the default shipment).
Returns:
the ID of this shipment

getMerchandizeTotalGrossPrice
getMerchandizeTotalGrossPrice() : Money
Returns the gross product subtotal in the purchase currency. The gross product subtotal represents the sum of product prices including tax, excluding services and adjustments.
Returns:
the total gross price, including tax, in the purchase currency.

getMerchandizeTotalNetPrice
getMerchandizeTotalNetPrice() : Money
Returns the net product subtotal, excluding tax, in the purchase currency. The net product subtotal represents the sum of product prices, excluding services, adjustments, and tax.
Returns:
the net price, excluding tax, in the purchase currency.

getMerchandizeTotalPrice
getMerchandizeTotalPrice() : Money
Returns the product total price. If the line item container is based on net pricing the product total net price is returned. If the line item container is based on gross pricing the product total gross price is returned.
Returns:
either the product total net or gross price

getMerchandizeTotalPriceAdjustments
getMerchandizeTotalPriceAdjustments() : Collection
Returns a collection of price adjustments that have been applied to the totals, such as a promotion on the purchase value (i.e. $10 Off or 10% Off).
Deprecated:
Shipments cannot have product price adjustments, therefore this method will always return an empty collection
Returns:
a collection of price adjustments that have been applied to the totals, such as a promotion on the purchase value (i.e. $10 Off or 10% Off).

getMerchandizeTotalTax
getMerchandizeTotalTax() : Money
Returns the total product tax in the purchase currency. The total product tax represents the tax on products, excluding services and adjustments.
Returns:
the total tax in purchase currency.

getProductLineItems
getProductLineItems() : Collection
Returns a collection of all product line items related to this shipment.
Returns:
a collection of all product line items related to this shipment.

getProratedMerchandizeTotalPrice
getProratedMerchandizeTotalPrice() : Money
Returns the total product price of the shipment, including product-level adjustments and prorating all Buy-X-Get-Y and order-level adjustments, according to the scheme described in PriceAdjustment.getProratedPrices(). For net pricing the net price is returned. For gross pricing, the gross price is returned.
Returns:
Adjusted and prorated net or gross product total price

getShipmentNo
getShipmentNo() : String
Returns the shipment number for this shipment.

When an order is placed (OrderMgr.placeOrder(Order)) shipment number will be filled using a sequence. Before order was placed null will be returned.

Returns:
the shipment number for this shipment.

getShippingAddress
getShippingAddress() : OrderAddress
Returns the shipping address or null if none is set.
Returns:
the shipping address or null if none is set.

getShippingLineItem
getShippingLineItem(id : String) : ShippingLineItem
Returns the shipping line item identified by the specified ID, or null if not found.

To get the standard shipping line item for this shipment, use the identifier ShippingLineItem.STANDARD_SHIPPING_ID.

Parameters:
id - the identifier to use to locate the shipping line item.
Returns:
the shipping line item identified by the specified ID, or null if not found.

getShippingLineItems
getShippingLineItems() : Collection
Returns a collection of all shipping line items of the shipment, excluding any product-level shipping costs that are associated with ProductLineItems of the shipment.
Returns:
a collection of all shipping line items of the shipment, excluding any product-level shipping costs.

getShippingMethod
getShippingMethod() : ShippingMethod
Returns the shipping method or null if none is set.
Returns:
the shipping method or null if none is set.

getShippingMethodID
getShippingMethodID() : String
Returns the shipping method ID or null if none is set.
Returns:
the shipping method ID or null if none is set.

getShippingPriceAdjustmentByPromotionID
getShippingPriceAdjustmentByPromotionID(promotionID : String) : PriceAdjustment
Returns the shipping price adjustment associated with the specified promotion ID.
Deprecated:
This item is deprecated.
Parameters:
promotionID - the promotion ID
Returns:
The price adjustment associated with the given promotion ID

getShippingPriceAdjustments
getShippingPriceAdjustments() : Collection
Returns a collection of price adjustments that have been applied to the shipping costs of the shipment, for example by the promotions engine.
Note that this method returns all shipping price adjustments in this shipment, regardless of which shipping line item they belong to. Use ShippingLineItem.getShippingPriceAdjustments() to retrieve the shipping price adjustments associated with a specific shipping line item.
Returns:
a collection of price adjustments that have been applied to the shipping costs of the shipment.

getShippingStatus
getShippingStatus() : EnumValue
Returns the shipping status. Possible values are SHIPMENT_NOTSHIPPED or SHIPMENT_SHIPPED.
Returns:
the shipping status. Possible values are SHIPMENT_NOTSHIPPED or SHIPMENT_SHIPPED.

getShippingTotalGrossPrice
getShippingTotalGrossPrice() : Money
Returns the sum of all shipping line items of the shipment, including tax, excluding shipping adjustments.
Returns:
the sum of all shipping line items of the shipment, including tax, excluding shipping adjustments.

getShippingTotalNetPrice
getShippingTotalNetPrice() : Money
Returns the sum of all shipping line items of the shipment, excluding tax and adjustments.
Returns:
the sum of all shipping line items of the shipment, excluding tax and adjustments.

getShippingTotalPrice
getShippingTotalPrice() : Money
Returns the shipping total price. If the line item container is based on net pricing the shipping total net price is returned. If the line item container is based on gross pricing the shipping total gross price is returned.
Returns:
either the shipping total net or gross price

getShippingTotalTax
getShippingTotalTax() : Money
Returns the tax of all shipping line items of the shipment before shipping adjustments have been applied.
Returns:
the tax of all shipping line items of the shipment before shipping adjustments have been applied.

getStandardShippingLineItem
getStandardShippingLineItem() : ShippingLineItem
Convenience method. Same as getShippingLineItem(ShippingLineItem.STANDARD_SHIPPING_ID)
Returns:
The standard shipping line item, or null if it does not exist.

getTotalGrossPrice
getTotalGrossPrice() : Money
Returns the total gross price of the shipment in the purchase currency. The total gross price is the sum of product prices, service prices, adjustments, and tax.
Returns:
the grand total price gross of tax for the shipment, in purchase currency.

getTotalNetPrice
getTotalNetPrice() : Money
Returns the total net price of the shipment in the purchase currency. The total net price is the sum of product prices, service prices, and adjustments, excluding tax.
Returns:
the grand total price for the shipment net of tax, in purchase currency.

getTotalTax
getTotalTax() : Money
Returns the total tax for the shipment in the purchase currency.
Returns:
the total tax for the shipment, in purchase currency.

getTrackingNumber
getTrackingNumber() : String
Returns the tracking number of this shipment.
Returns:
the tracking number of this shipment.

isDefault
isDefault() : boolean
Return true if this shipment is the default shipment (shipment ID "me").
Returns:
true if this shipment is the default shipment

isGift
isGift() : boolean
Returns true if this line item represents a gift, false otherwise.
Returns:
true if this line item represents a gift, false otherwise.

removeShippingLineItem
removeShippingLineItem(shippingLineItem : ShippingLineItem) : void
Removes the specified shipping line item and any of its dependent shipping price adjustments.
Parameters:
shippingLineItem - The shipping line item to be removed.

removeShippingPriceAdjustment
removeShippingPriceAdjustment(priceAdjustment : PriceAdjustment) : void
Removes the specified shipping price adjustment from the shipment.
Deprecated:
Deprecated in favor of ShippingLineItem.removeShippingPriceAdjustment(PriceAdjustment) since shipping price adjustments belong to a specific shipping line item.
Parameters:
priceAdjustment - The price adjustment line item to remove

setGift
setGift(isGift : boolean) : void
Controls if this line item is a gift or not.
Parameters:
isGift - set to true if you want this line item to represent a gift.

setGiftMessage
setGiftMessage(message : String) : void
Sets the value to set for the gift message.
Parameters:
message - the value to set for the gift message.

setShippingMethod
setShippingMethod(method : ShippingMethod) : void
Set the specified shipping method for the specified shipment.
Parameters:
method - the shipping method to use.

setShippingStatus
setShippingStatus(status : Number) : void
Sets the shipping status of the shipment.
Possible values are SHIPPING_STATUS_NOTSHIPPED or SHIPPING_STATUS_SHIPPED.
Parameters:
status - Shipment shipping status

setTrackingNumber
setTrackingNumber(aValue : String) : void
Sets the tracking number of this shipment.
Parameters:
aValue - the tracking number of this shipment.