system.mes.inventory.receive

Receives inventory into the MES based on the provided parameters.

Syntax

system.mes.inventory.receive(**receive_request)

Parameters

Parameter	Type	Nullable	Description
type	String	True	The type of request defined by the LotRecordType Enum. It is internally set and must not be modified, as changes may break functionality.
quantity	Double	False	The quantity to receive from the location.
unitOfMeasureSymbol	String	True	The symbol of the unit of measure for the quantity.
lotIdOrName	String	True	The ID or name of the inventory lot from which the material is being received.
materialIdOrPath	String	False	The ID or path of the material being received.
destinationLocationIdOrPath	String	False	The ID or path of the location the received inventory goes to.
createIfNotExists	Boolean	False	Indicates whether the system should create the lot if it does not exist. Default value is false.
operationId	String (ULID)	True	The ID of the operation receiving this inventory.
inventoryOperationId	String (ULID)	True	The ID of the inventory operation related to this receive action.
productionOrderIdOrName	String	True	The ID or name of the production order associated with the receipt.
materialReasonCodeId	String (ULID)	True	The ID of the material reason code to add additional context.
startDate	Instant	False	The start date and time of the receipt. Default value is Current Instant.
endDate	Instant	True	The end date and time of the receipt.
ongoing	Boolean	False	Indicates whether this request is ongoing. Default value is false.
inventoryName	String	True	The name of the inventory.
notes	String	True	Notes related to the receive request.
spare1	String	True	Additional field for user-defined context.
spare2	String	True	Additional field for user-defined context.
spare3	String	True	Additional field for user-defined context.

Returns

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

Code Examples

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

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

# Receive the request
received_request = system.mes.inventory.receive(**new_request)

# Output the JSON representation of the received request
print(received_request)