ecl-logo Documentation
ECL`

DropShipSamples

DropShipSamples[OrderedItems, OrderNumber]Transaction

generates a Transaction to track the user-initiated shipment of OrderedItems from a third party company to ECL.

DropShipSamples[Transaction]UpdatedTransaction

update Transaction to add shipping information (such as tracking number, shipper, date shipped, and expected delivery date) or amount information (such as mass, volume, concentration, and mass concentration).

Details

  • This function is intended to help you ship Products from Object[Company,Supplier]s or Models from Object[Company,Service]s.
  • All Model input must have the Provider option specified, and Provider must be an Object[Company,Service].
  • Product input is not required to have the Provider option specified. If it is specified, it must match the supplier of the product.
  • Input
    Output
    Organizational Information Options
    Sample Information Options
    Shipment Options
    Shipping Information Options

Examples

open allclose all

Example Setup

These expressions are used in the examples to follow:

Basic Examples  (6)

Generates transaction objects to track products that were ordered by the user from a supplier:

Generates transaction objects to track sample models and products that were ordered by the user from a supplier or service company:

Generates transaction objects to track sample models that were ordered by the user from a service company:

Generates transaction object when ordering from a product that consists of a kit:

The DateCreated and DateOrdered of a transaction created by DropShipSamples are the same:

Update shipping information for a transaction object:

Additional Examples  (5)

Amounts are pulled from products:

If a single order number is specified, uses that order number for all of the transactions:

If DateShipped is specified, the transaction Status is Shipped, DateShipped is populated, and DateOrdered remains blank; If DateShipped is not specified, the transaction Status is Ordered, DateOrdered is populated, and DateShipped remains blank:

If the specified service provider is not recorded for the specified model, update the model with the service provider:

Samples with the same provider, order number, and shipping information (if provided) are grouped into the same transaction:

Options  (61)

AsepticRebaggingContainerType  (1)

Describes the manner in which an aseptic product is packed and shipped by the manufacturer:

AsepticShippingContainerType  (1)

Describes the manner in which an aseptic product is packed and shipped by the manufacturer:

ContainerOut  (2)

Specify that all samples should be transferred into a specified container upon arrival:

Specify that some samples should be transferred into a specified container upon arrival:

Count  (6)

CountSource automatically resolves to ExperimentallyMeasure for tablet model input and to None for all other samples. Count initializes to 0 for all of these cases:

If Mass is given and SolidUnitWeight is known, Count is calculated to resolve automatics:

Specify that the count of the sent samples should be found on the documentation that arrives with the sample:

Specify that the count of the sent samples should be measured upon arrival:

Specify the count of the samples that will be sent:

Update the count of objects in an existing transaction:

DateShipped  (6)

Specify a date shipped for each object when generating a transaction:

Specify a date shipped for each object when updating shipping information:

Specify a date shipped for some but not all of the models when generating a transaction.:

Specify a date shipped when generating a transaction:

Specify a date shipped when updating shipping information:

When updating shipping information, Automatic DateShipped will leave the existing date shipped in place, Null will clear the existing date shipped and revert the transaction status to Pending, and a new date shipped will overwrite the old date shipped:

Destination  (1)

Specify the destination where the samples will be sent:

ExpectedDeliveryDate  (7)

Specify an expected delivery date for each object when generating a transaction:

Specify an expected delivery date for each object when updating shipping information:

Specify an expected delivery date for some but not all of the models when generating a transaction.:

Specify an expected delivery date for some but not all of the objects when updating shipping information:

Specify an expected delivery date when generating a transaction:

Specify an expected delivery date when updating shipping information:

When updating shipping information, Automatic ExpectedDeliveryDate will leave the existing date expected in place, None will clear the existing date expected, and a new date expected will overwrite the old date expected:

Mass  (7)

If Count is given and SolidUnitWeight is known, Mass is calculated to resolve automatics:

MassSource automatically resolves to ExperimentallyMeasure for solid model input and to None for all other samples. Mass initializes to 0 gram for all of these cases:

Specify different mass options for each input:

Specify that the mass of the sent samples should be found on the documentation that arrives with the sample:

Specify that the mass of the sent samples should be measured upon arrival:

Specify the mass of the samples that will be sent:

Update the mass of models in an existing transaction:

Name  (3)

If multiple transactions are generated, an index is added to the name:

Specify a name for the transaction:

Update the name of existing transactions:

Provider  (1)

Provider must be specified for models. If provider is specified for products, it must match the supplier of the product:

Quantity  (2)

If no quantities are specified, assumes one of each input:

Specify the quantity of the samples that will be sent:

ReceivingTolerance  (1)

Specify the allowable difference between received amount and expected amount for any ordered samples:

SealedContainer  (1)

Indicates that samples will arrive in a sealed container:

ShippedRack  (1)

Use the ShippedRack option to indicate that a rack will be shipped as part of the order. The compatibility of the rack will also be assessed:

Shipper  (7)

Specify a shipper for each object when generating a transaction:

Specify a shipper for each object when updating shipping information:

Specify a shipper for some but not all of the models when generating a transaction.:

Specify a shipper for some but not all of the objects when updating shipping information:

Specify a shipper when generating a transaction:

Specify a shipper when updating shipping information:

When updating shipping information, Automatic Shipper will leave the existing Shipper in place, None will clear the existing Shipper, and a new Shipper will overwrite the old Shipper:

Sterile  (1)

Specify that some samples are sterile:

TrackingNumber  (7)

Specify a tracking number for each model when generating a transaction:

Specify a tracking number for some but not all of the models when generating a transaction.:

Specify a tracking number when generating a transaction:

Specify a tracking number when updating shipping information:

Specify tracking numbers for each transaction when updating shipping information:

Specify tracking numbers for some but not all of the transactions when updating shipping information:

When updating shipping information, Automatic TrackingNumber will leave the existing tracking number in place, Null will clear the existing tracking number, and a new tracking number will overwrite the old tracking number:

Volume  (6)

Specify different volume options for each input:

Specify that the volume of the sent samples should be found on the documentation that arrives with the sample:

Specify that the volume of the sent samples should be measured upon arrival:

Specify the volume of the samples that will be sent:

Update the volume of models in an existing transaction:

VolumeSource automatically resolves to ExperimentallyMeasure for liquid model input and to None for all other samples. Volume initializes to 0 gram for all of these case:

Messages  (40)

CompanyRequiredForModelInputs  (2)

Provider is required for model (i.e., non-product) inputs:

Provider must be a Service company for model (i.e., non-product) inputs:

ContainerOutInconsistent  (1)

If different ContainerOut is specified for the same model, give a message and fail:

ContainerOutNotValidated  (1)

Give a warning if it cannot be determined whether the specified container out is large enough to hold the sample:

CountDiscrepancy  (2)

If a count if provided that disagrees with the known count of the product, throws an error::

If Count is specified for a kit product, throws an error:

CountNotRequired  (2)

Specifying a count for items will throw a warning and not populate any count-related fields for those models when updating a transaction:

Specifying a count for non-tablets will throw an error when generating a transaction:

IncompatibleProvidedRackModel  (1)

When the ShippedRack is not capable of supporting the container in which the product arrives (or if the ordered item is a container), an error is shown indicating incompatability:

InputLengthMismatch  (1)

If a listed option does not match the length of the transaction object inputs, give a message and return $Failed:

InvalidDates  (1)

If DateShipped is after ExpectedDeliveryDate, give a message and return $Failed:

MassCountDisagree  (1)

If Mass and Count are both given and disagree based on the SolidUnitWeight throw an error:

MassDiscrepancy  (2)

If a mass if provided that disagrees with the known mass of the product, throws an error::

If Mass is specified for a kit product, throws an error:

MassNotRequired  (2)

Specifying a mass for items will throw an error when generating a transaction:

Specifying a mass for items will throw a warning and not populate any mass-related fields for those models when updating a transaction:

MeasurementMayRequireTransfer  (2)

When generating a transaction, if mass or volume is specified as ExperimentallyMeasure, throw a warning that the samples may be transferred to a different container:

When updating a transaction, if mass or volume is specified as ExperimentallyMeasure, throw a warning that the samples may be transferred to a different container:

ModelsHaveConflictingCount  (2)

When generating a transaction, if the same model is specified with differing count options, give a message and return $Failed:

When updating a transaction, if the same model within a transaction is specified with differing count options, give a message and return $Failed:

ModelsHaveConflictingMass  (2)

When generating a transaction, if the same model is specified with differing mass options, give a message and return $Failed:

When updating a transaction, if the same model within a transaction is specified with differing mass options, give a message and return $Failed:

ModelsHaveConflictingVolume  (2)

When generating a transaction, if the same model is specified with differing amount options, give a message and return $Failed:

When updating a transaction, if the same model within a transaction is specified with differing amount options, give a message and return $Failed:

NewServiceProviderForModel  (1)

If the specified service provider is not recorded for the specified model, give a message that the model will be updated:

NoCompatibleRack  (1)

If there is no Model[Container, Rack] in the database that can hold the recieved container upright based on its Footprint and Dimensions, return an error:

OptionLengthMismatch  (1)

If any listed options don't match the length of the inputs, give a message and return $Failed:

OptionMustMatchModelsInTransactions  (1)

If a listed option does not match the length of the models in the transaction object inputs, give a message and return $Failed:

ProductSupplierConflict  (1)

If a provider is provided that disagrees with the known supplier of the product, throws an error::

SampleMayBeTransferred  (2)

When generating a transaction, if volume is specified for a liquid model but the model does not have density, give a warning that the samples may still be transferred depending on the container it arrives in:

When updating a transaction, if volume is specified for a liquid model but the model does not have density, give a warning that the samples may still be transferred depending on the container it arrives in:

ShippingOptionNotRequired  (2)

If ContainerOut is specified for a kit product, give a message and fail:

If ContainerOut is specified for an item, give a message and fail:

VolumeDiscrepancy  (2)

If a volume if provided that disagrees with the known volume of the product, throws an error::

If Volume is specified for a kit product, throws an error:

VolumeExceedsContainerOut  (1)

If ContainerOut is too small to hold the sample volume, give a message and fail:

VolumeNotRequired  (2)

Specifying a volume for items will throw an error when generating a transaction:

Specifying a volume for items will throw a warning and not populate any volume-related fields for those models when updating a transaction:

Name  (2)

If the name is already in use, throws an error and fails:

If the name is already in use, throws an error and fails:

Possible Issues  (3)

Works on single inputs:

InputLengthMismatch  (1)

If the inputs don't match in length, give a message and return $Failed:

Quantity  (1)

Update the quantity of objects in an existing transaction:

Last modified on Thu 25 Sep 2025 16:16:06