About Importing Material Lots

This topic provides a list of parameters related to a material lot, and specifies whether you can update them using a material lot import document (MLID).
Important: The units of measure provided for each material lot in the message must match the units of measure for one of the units in the inventory line in Plant Applications. If it does not match or if multiple units have the same units of measure, an error occurs. In addition, for a material lot that does not represent a receiver, this unit must contain the same OrgCode that you will provide in the MLID.
  • lotIdentifier: Unique identifier for the material lot in Plant Applications. In the B2MML format, it is represented by the ID parameter under MaterialLot. A value is required. The following conditions apply when you provide a material lot ID:
    • You can create a material lot in Plant Applications by providing an ID in the MLID. The material lot ID must be unique for the production unit.
    • You cannot update a material lot ID using an MLID.
  • description: Identifies whether the material lot represents a receiver. The following conditions apply when you specify whether the material lot is a receiver:
    • An MLID can contain only one receiver. However, it is not mandatory for an MLID to contain a receiver.
    • To indicate that a material lot is a receiver, enter the value Receiver for the description element in the MLID.
    • To indicate that a material lot is not a receiver, leave the value blank, but including the description parameter is mandatory.
  • productName: Identifies the material (or product) that the material lot contains. In the B2MML format, it is represented by MaterialDefinitionID. A value is required. This is the product code of the actual product used in the production event in Plant Applications. The following conditions apply when you provide the material ID:
    • You can import a material lot only if the productName matches with product code of an actual product in Plant Applications (based on EVENT_NUM and the applied product).
    • You cannot update a material ID using an MLID.
    • A receiver material lot is created on the <No Product> virtual product in Plant Applications.
  • status: Identifies the status of the material lot. You can update the status only if:
    • The lotIdentifier and productName values match the corresponding values in Plant Applications.
    • The value for the status is valid (that is, Open, Accept, Scrap, RTV, DIT, or MRB/NCR) for a material lot that does not represent a receiver. If the material lot is a receiver, the status that you provide in the MLID is ignored, and a default value of Open will be assigned.
    • If the status is null or blank, the status is not updated.
    • The material is for a non-serialized product. You cannot update the status for a serialized product.
    If you do not provide a value, or provide an empty string, the status is not updated. Providing the status is mandatory if you want to create a material lot using an MLID, but it is optional if you want to update the material lot.
  • quantity: Identifies the planned quantity of a material lot. If a material lot represents a receiver, the quantity is not considered. You can update the quantity of a material lot only if:
    • The lotIdentifier and productName values match the corresponding values in Plant Applications.
    • The material is for a non-serialized product. You cannot update the quantity for a serialized product.
    • The quantity is greater than zero for a material lot that does not represent a receiver.

    The quantity of a material lot is updated as follows:

    Final dimension X = Material lot quantity

    Initial Dimension X = Material lot quantity + sum of the consumption for this material lot + sum of the waste for this material lot

  • propertyName and propertyValue: Identify the properties and their values of a material lot. You can create or update the properties of a material lot only if the lotIdentifier and productName values match the corresponding values in Plant Applications. These properties are validated with the ones in the MaterialLot Import property group.
    The following conditions apply when you provide material lot properties in an MLID:
    • Only if a property exists in the material lot import group in Plant Applications, can you add or update the property. Otherwise, the property is skipped. For more information, refer to:
    • If a property specified in an MLID does not exist for the material lot in Plant Applications, it is created.
    • If the MLID does not contain a property as defined for the material lot in Plant Applications, it is skipped when you import the MLID; you cannot remove a property using an MLID.
    • The material is for a non-serialized product. You cannot update the properties for a serialized product.
  • Both inventoryLineId and inventoryUnitId are property definitions in the material lot import propertyValues, and are added when Plant Applications is installed. These properties have default values that can be overridden by specifying a value in your import message.
  • unitOfMeasure: Identifies the unit of measure of the material lot.