Lot

Represents a delivered heat, cast, coil, or similar supplier lot of raw material, together with its mill certificate.

For example, a delivery of steel bars from a mill can be recorded as a Lot so that the material used in production can be traced back to its material grade and supplier. In the Excel template, lots are registered on the Incoming material sheet, where the code column is called Heat.

A Lot records the received quantity, may describe the delivered form and dimension, and can carry the values of the mill certificate.

The Lot object

{
  "code": "HEAT-24-1187",
  "material": "STEEL-S355",
  "supplier": "SUP-001",
  "receivedAt": "2026-08-28T09:15:00+02:00",
  "quantity": 1250,
  "unit": "kg",
  "form": "bar",
  "dimension": "65",
  "certificateDate": "2026-08-27T00:00:00+02:00",
  "certificate": {
    "carbon": 0.18,
    "tensile-strength": 510,
    "yield-strength": 355
  }
}

Fields

Delivered dimension

dimension is stored as free text so that source-system values such as "Ø65" can be preserved.

When the value is a plain number, Pulse also records it as the material thickness (material-thickness, in mm). Use a dot as the decimal separator.

"65"   → also recorded as material-thickness = 65
"Ø65"  → kept as dimension only

Mill certificate

certificate holds the values of the mill certificate, keyed by certificate code. Pulse provides these codes:

Code	Measures	Unit
carbon	Carbon content	%
manganese	Manganese content	%
silicon	Silicon content	%
sulphur	Sulphur content	%
phosphorus	Phosphorus content	%
chromium	Chromium content	%
nickel	Nickel content	%
molybdenum	Molybdenum content	%
tensile-strength	Tensile strength	MPa
yield-strength	Yield strength	MPa
elongation	Elongation	%
incoming-hardness	Hardness	HB

• Other codes are refused.
• A certificate is accepted only for a material that is tracked by lot (lotTracked is true). For other materials, a Lot with certificate values is refused.
• certificateDate is optional. If you leave it out, the certificate values are dated with receivedAt. A Lot without certificate values is read back with certificateDate set to null.
• The Excel sheet has columns for six of the codes: Carbon, Chromium, Nickel, Tensile strength, Yield strength, and Hardness (incoming-hardness). To submit the other codes, use the API.

When a Lot is consumed, Pulse carries its certificate values over to the operations that used it, in proportion to how much of the Lot each operation used.

Changing certificate values

Sending certificate again updates only the codes you include. Values for codes you leave out stay as they are, and leaving out certificate keeps all existing values. Certificate values cannot be removed one by one: to remove them, delete the Lot and create it again.

Traceability

A Lot distinguishes one delivered quantity of material from another. For materials tracked by lot, consumption records name the Lot that was used, preserving traceability from the mill through to the operations that used the material.

Rules

• A supplier cannot be deleted while Lots refer to it.

API resource

Resource	Base path
Lot	/manufacturing/metal-machining/v1/lots

API methods

Create a lot

POST /manufacturing/metal-machining/v1/lots/insert

Creates a new Lot and returns its Pulse identifier.

Request

POST /manufacturing/metal-machining/v1/lots/insert
Content-Type: application/json

{
  "code": "HEAT-24-1187",
  "material": "STEEL-S355",
  "supplier": "SUP-001",
  "receivedAt": "2026-08-28T09:15:00+02:00",
  "quantity": 1250,
  "unit": "kg",
  "form": "bar",
  "dimension": "65",
  "certificateDate": "2026-08-27T00:00:00+02:00",
  "certificate": {
    "carbon": 0.18,
    "tensile-strength": 510,
    "yield-strength": 355
  }
}

Parameters

Parameter	Type	Required	Description
code	string	yes	Unique business code of the Lot.
material	string	yes	Business code of the material grade.
supplier	string	yes	Business code of the supplier.
receivedAt	string	yes	Date and time when the Lot was received.
quantity	number	yes	Quantity of material received.
unit	string	yes	Unit in which the quantity is expressed.
form	string or null	no	Delivered material form.
dimension	string or null	no	Delivered material dimension.
certificateDate	string or null	no	Date the mill certificate was issued.
certificate	object or null	no	Mill certificate values keyed by certificate code.

Update a lot

PUT /manufacturing/metal-machining/v1/lots/update

Updates an existing Lot. The Lot must already exist.

An update replaces the Lot's fields. If you leave out form or dimension, it is removed. Certificate values are the exception: see Changing certificate values.

Request

PUT /manufacturing/metal-machining/v1/lots/update
Content-Type: application/json

{
  "code": "HEAT-24-1187",
  "material": "STEEL-S355",
  "supplier": "SUP-001",
  "receivedAt": "2026-08-28T09:15:00+02:00",
  "quantity": 1240,
  "unit": "kg",
  "form": "bar",
  "dimension": "65"
}

Parameters

The parameters are the same as for creating a lot. code identifies the Lot to update.

Patch a lot

PATCH /manufacturing/metal-machining/v1/lots/patch

Partially updates an existing Lot.

The Lot is identified by properties.code, which cannot be changed. Fields omitted from properties keep their current values. form and dimension can be cleared by sending them as null.

Request

PATCH /manufacturing/metal-machining/v1/lots/patch
Content-Type: application/json

{
  "properties": {
    "code": "HEAT-24-1187",
    "certificate": {
      "elongation": 22
    }
  }
}

Parameters

Parameter	Type	Required	Description
properties	object	yes	Fields included in the partial update.
properties.code	string	yes	Business code of the Lot to update.
properties.material	string	no	New material business code.
properties.supplier	string	no	New supplier business code.
properties.receivedAt	string	no	New received date and time.
properties.quantity	number	no	New received quantity.
properties.unit	string	no	New quantity unit.
properties.form	string or null	no	New material form, or null to clear it.
properties.dimension	string or null	no	New dimension, or null to clear it.
properties.certificateDate	string or null	no	New certificate date.
properties.certificate	object	no	Certificate values to add or update.

Retrieve a lot

GET /manufacturing/metal-machining/v1/lots/select

Returns the Lot identified by its business code. If no Lot has this code, the response is empty.

Request

GET /manufacturing/metal-machining/v1/lots/select?id=HEAT-24-1187

Parameters

Parameter	Type	Required	Description
id	string	yes	Business code of the Lot to retrieve.

Example response

{
  "code": "HEAT-24-1187",
  "material": "STEEL-S355",
  "supplier": "SUP-001",
  "receivedAt": "2026-08-28T09:15:00+02:00",
  "quantity": 1250,
  "unit": "kg",
  "form": "bar",
  "dimension": "65",
  "certificateDate": "2026-08-27T00:00:00+02:00",
  "certificate": {
    "carbon": 0.18,
    "tensile-strength": 510,
    "yield-strength": 355
  }
}

List lots

GET /manufacturing/metal-machining/v1/lots/query

Returns Lots matching the supplied filters.

Request

GET /manufacturing/metal-machining/v1/lots/query?materials=STEEL-S355&suppliers=SUP-001

Query parameters

Parameter	Type	Required	Description
codes	string or array of strings	no	Limits results to the specified Lot business codes. Upper and lower case are not distinguished.
materials	string or array of strings	no	Limits results to Lots of the specified materials.
suppliers	string or array of strings	no	Limits results to Lots delivered by the specified suppliers.

Multiple values can be supplied by repeating the query parameter:

GET /manufacturing/metal-machining/v1/lots/query?materials=STEEL-S355&materials=STEEL-C45

Delete a lot

DELETE /manufacturing/metal-machining/v1/lots/delete

Deletes the Lot identified by its business code. If no Lot has this code, nothing happens.

Deleting a Lot also removes its material and supplier links, its material thickness, and its certificate values.

Request

DELETE /manufacturing/metal-machining/v1/lots/delete?id=HEAT-24-1187

Parameters

Parameter	Type	Required	Description
id	string	yes	Business code of the Lot to delete.