Passo 3 — Registar o equipamento do cliente
POST /gateway/equipment
Content-Type: application/json
Authorization: Bearer {token}
{
"description": "Portátil Lenovo T14 do cliente Silva",
"typeKeyId": "PORT",
"brandKeyId": "LEN",
"modelKeyId": "T14",
"serialNumber": "SN-998877",
"entityKeyId": "C0001",
"warrantyEnd": "2027-06-30T00:00:00Z"
}
Obrigatórios: description (≤50), typeKeyId, brandKeyId, modelKeyId (têm de existir nos catálogos).
Opcionais úteis: serialNumber, imei, entityKeyId (cliente dono), invoiceNumber (fatura de compra), acquisitionDate, warrantyEnd, obs.
Para obter um número livre antes de criar com id definido pelo utilizador: GET /gateway/equipment/next-id. O id devolvido não fica reservado — em integrações concorrentes, trate o 409 de conflito com retry.