Sign in

v1

latestOpenAPI 3.1.02026-07-26160119.8 KB
Public API

Busca um equipamento por ID

get/api/v1/assets/{id}

Path parameters

idstring required

Response

idstring required

Identificador do equipamento na plataforma Salvy (UUID)

enrollmentIdstring required

Número de patrimônio do equipamento

categorystring

Categoria do equipamento

brandstring

Marca do equipamento

modelstring

Modelo do equipamento

vendorNamestring

Nome do fornecedor do equipamento

serialNumberstring

Número de série do equipamento

deviceIdstring

ID do dispositivo coletado pelo aplicativo mobile da Salvy

acquisitionDatestring date-time

Data de aquisição do equipamento

acquisitionType'bought' | 'rented' | 'other'

Tipo de aquisição do equipamento

priceCentsnumber

Preço de aquisição do equipamento em centavos

nfeNumberstring

Número da nota fiscal de aquisição do equipamento

contractIdstring

Identificador do contrato relacionado ao equipamento

warrantyExpirationDatestring date-time

Data de expiração da garantia do equipamento

status'available' | 'in-use' | 'allocated' | 'maintenance' | 'broken' | 'lost' | 'stolen' | 'sold' | 'donated' | 'discarded' | 'archived' required

Situação do equipamento

allocatedLocationstring

Local de alocação do equipamento

employeeIdstring

Id do colaborador ao qual o equipamento está associado

employeeAttachedAtstring date-time

Data de vinculação do colaborador ao equipamento. Removido automaticamente se o colaborador for desvinculado.

createdAtstring date-time required

Data de criação do equipamento

source'manual' | 'sheets-import' | 'nfe-import' | 'desktop-client' | 'mobile-app' required

Fonte de criação do equipamento

Example response

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "enrollmentId": "SLY-12345",
  "category": "notebook",
  "brand": "Dell",
  "model": "XPS 13",
  "vendorName": "Tech Supplier Inc.",
  "serialNumber": "SN1234567890",
  "deviceId": "8A1D30F4-8C87-44CD-A663-2229DE6F64BD",
  "acquisitionDate": "2025-12-10T03:00:00.000Z",
  "acquisitionType": "bought",
  "priceCents": 250000,
  "nfeNumber": "000123456789",
  "contractId": "CT-2024-0001",
  "warrantyExpirationDate": "2025-12-24T03:00:00.000Z",
  "status": "in-use",
  "allocatedLocation": "Sala do RH",
  "employeeId": "123e4567-e89b-12d3-a456-426614174000",
  "employeeAttachedAt": "2025-01-01T00:00:00.000Z",
  "createdAt": "2025-01-01T00:00:00.000Z",
  "source": "desktop-client",
  "customFields": [
    {
      "label": "teste",
      "type": "text",
      "value": "teste"
    }
  ]
}