Skip to main content

system.mes.inventory.ship

Ships inventory from the MES based on the provided parameters.

Syntax

system.mes.inventory.ship(**ship_request)

Parameters

ParameterTypeNullableDescription
typeStringTrueThe type of request defined by the LotRecordType Enum. It is internally set and must not be modified, as changes may break functionality.
quantityDoubleFalseThe quantity to ship from the location.
unitOfMeasureSymbolStringTrueThe symbol of the unit of measure for the quantity.
lotIdOrNameStringTrueThe ID or name of the inventory lot that will be shipped.
materialIdOrPathStringFalseThe ID or path of the material being shipped.
sourceLocationIdOrPathStringFalseThe ID or path of the location from which inventory will be shipped.
operationIdString (ULID)TrueThe ID of the operation shipping this inventory.
inventoryOperationIdString (ULID)TrueThe ID of the inventory operation related to this ship action.
productionOrderIdOrNameStringTrueThe ID or name of the production order associated with the ship.
materialReasonCodeIdString (ULID)TrueThe ID of the material reason code to add additional context.
startDateInstantFalseThe start date and time of the ship. Default value is Current Instant.
endDateInstantTrueThe end date and time of the ship.
ongoingBooleanFalseIndicates whether this request is ongoing. Default value is false.
inventoryNameStringTrueThe name of the inventory the shipped inventory goes to.
notesStringTrueNotes related to the ship request.
spare1StringTrueAdditional field for user-defined context.
spare2StringTrueAdditional field for user-defined context.
spare3StringTrueAdditional field for user-defined context.

Returns

Returns a JSON representation of an inventory lot record for a Ship Request.

Code Examples

# Generate the object structure for a new ship request object with no initial arguments
new_request = system.mes.inventory.newShipRequest()

# Set basic attributes for the new ship request
new_request['materialIdOrPath'] = 'Bottle/Milk'
new_request['sourceLocationIdOrPath'] = 'DairyCo'
new_request['quantity'] = 610
# (You can continue setting other properties as needed here)

# Ship the request
shipped_request = system.mes.inventory.ship(**new_request)

# Output the JSON representation of the shipped request
print(shipped_request)