Supported Schema Versions

All ERP inbound messages are version-controlled via schema versions. A schema version defines the minimum set of parameters required to successfully import a record (work order, process order, material, or material lot) into Plant Applications. The schema version itself is a mandatory parameter in an inbound message.
Note: The schema version of an inbound message is different from the schema of a B2MML standard.
This topic provides a list of schema versions supported for importing:
  • Work orders
  • Process orders
  • Materials
  • Material lots
  • Outside Processing (OSP)
It also contains a list of the associated records that you can import with each schema version.
Note: For each schema version, the records that you can import in the previous schema versions are supported as well.

Work Orders

You can import work orders using the following schema versions:
  • Schema Version 6: You can provide the following values:
    • Upper and lower tolerances of a BOM item and their precision
    • Scrap factor (the percentage of the product that is predicted to be scrapped)
    • Precision of the quantity of the product
    • The default storage unit of a BOM item
    In addition, you can specify whether an operation can be skipped, by including allowManualSkip in the behaviours array for the operation. If you do so, the operator can choose to skip the operation while executing the work order. If, however, you set the skipifSuccessorStarted parameter to true, the operation will be automatically skipped when the next operation is ready.
  • Schema version 5: You can override the following route components in a work order:
    • BOM items of a route
    • BOM items of individual operations in a route
    • Values of BOM item properties
    • Values of route-level and operation-level properties
    In addition, specifying the route revision is not required. By default, the latest revision is considered.
  • Schema version 4: You can import work orders for serialized as well as non-serialized products with or without route definition.
  • Schema version 3: You can import work orders for serialized products with or without route definition.
Tip: Refer to the following sample work order import documents (WOIDs) for each schema version:

Materials

You can import materials using the following schema versions:
  • Schema version 3: You can import materials for serialized as well as non-serialized products.
  • Schema version 2: You can import materials for serialized products.
Tip: Refer to the following sample material master import documents (MMIDs) for each schema version:

Material Lots and Outside Processing (OSP)

You can import material lots and OSP using the following schema versions:
  • Schema version 4: You can update the status, quantity, and properties of a material lot.
  • Schema version 3: You can import material lots and OSP details - providing the status is not mandatory.
  • Schema version 2: You can import material lots and OSP details - providing the status is mandatory.
Tip: Refer to the following sample material lot import documents (MLIDs) for each schema version:Refer to the following sample MLIDs containing OSP:

Process Orders

You can import process orders using the following schema versions:
  • Schema version 2: You can provide values of the process order properties. If the process order is not yet started, it is deleted and a new one is created with the properties and values that you provide in the process order import document (POID).

    In addition, providing the production line is not mandatory, and you can include production lines with multiple execution paths. When a production line has multiple execution paths, the process order becomes an unbound process order. You can associate a production line with an execution path using Plant Applications Administrator or Plant Applications Web Client; or you can leave it as is.

  • Schema version 1: You can import process orders containing information about the planned quantity, material, production line, and planned start and end dates.
Note: Refer to the following sample process order import documents (POIDs):