Skip to main content

system.mes.inventory.validateEditInventoryQuantityRequest

Validates the specified parameters for an edit inventory quantity request and returns any validation errors. This only checks if the quantity edit request can be processed based on the attributes given, without actually modifying the inventory quantity. Use this function to verify your parameters before executing the actual edit operation.

Syntax

system.mes.inventory.validateEditInventoryQuantityRequest(**edit_inventory_quantity_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.
newQuantityDoubleFalseThe new quantity to be assigned to the inventory.
unitOfMeasureSymbolStringTrueThe symbol of the unit of measure for the quantity.
lotIdOrNameStringTrueThe ID or name of the inventory lot whose quantity is being edited.
materialIdOrPathStringFalseThe ID or path of the material whose quantity is being edited.
sourceLocationIdOrPathStringFalseThe ID or path of the location from the inventory quantity is being edited.
operationIdString (ULID)TrueThe ID of the operation editing the quantity of this inventory.
inventoryOperationIdString (ULID)TrueThe ID of the inventory operation related to this edit inventory quantity action.
notesStringTrueNotes related to the edit inventory quantity request.
spare1StringTrueAdditional field for user-defined context.
spare2StringTrueAdditional field for user-defined context.
spare3StringTrueAdditional field for user-defined context.

Returns

Returns a JSON object where keys are field names and values are lists of validation violation messages.

Code Examples

# Generate the object structure for a new edit inventory quantity request object with no initial arguments
edit_inventory_quantity_request = system.mes.inventory.newEditInventoryQuantityRequest()

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

# Validate edit inventory quantity request parameters
validation_errors = system.mes.inventory.validateEditInventoryQuantityRequest(**edit_inventory_quantity_request)

if len(validation_errors) > 0:
print('Validation errors found:', validation_errors)
else:
print('Edit inventory quantity request parameters are valid.')