Sign in

v1

latestOpenAPI 3.1.02026-07-26160119.8 KB
Public API

Atualiza um equipamento por ID

post/api/v1/assets/{id}

Path parameters

idstring required

Request body

enrollmentIdstring

Número de patrimônio do equipamento

categorystring nullable

Categoria do equipamento

brandstring nullable

Marca do equipamento

modelstring nullable

Modelo do equipamento

vendorNamestring nullable

Nome do fornecedor do equipamento

serialNumberstring nullable

Número de série do equipamento

acquisitionDatestring date-time nullable

Data de aquisição do equipamento

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

Tipo de aquisição do equipamento

priceCentsnumber nullable

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

nfeNumberstring nullable

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

contractIdstring nullable

Identificador do contrato relacionado ao equipamento

warrantyExpirationDatestring date-time nullable

Data de expiração da garantia do equipamento

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

Situação do equipamento

allocatedLocationstring nullable

Local de alocação do equipamento

employeeIdstring nullable

Id do colaborador ao qual o equipamento está associado

employeeAttachedAtstring date-time nullable

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

Example request

{
  "enrollmentId": "SLY-12345",
  "category": "notebook",
  "brand": "Dell",
  "model": "XPS 13",
  "vendorName": "Tech Supplier Inc.",
  "serialNumber": "SN1234567890",
  "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",
  "customFields": [
    {
      "label": "teste",
      "value": "teste"
    }
  ]
}

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"
    }
  ]
}