Step 3 — Register customer equipment

POST /gateway/equipment
Content-Type: application/json
Authorization: Bearer {token}

{
  "description": "Lenovo T14 laptop for customer Silva",
  "typeKeyId": "PORT",
  "brandKeyId": "LEN",
  "modelKeyId": "T14",
  "serialNumber": "SN-998877",
  "entityKeyId": "C0001",
  "warrantyEnd": "2027-06-30T00:00:00Z"
}

Required: description (≤50), typeKeyId, brandKeyId, modelKeyId (must exist in the catalogues).

Useful optional fields: serialNumber, imei, entityKeyId (owner customer), invoiceNumber (purchase invoice), acquisitionDate, warrantyEnd, obs.

To get a free number before creating with a user-defined id: GET /gateway/equipment/next-id. The returned id is not reserved — in concurrent integrations, handle 409 Conflict with retry.

Open the service order.

Next​

Next