Inventário

Visão Geral

Cada imóvel pode ter um inventário de itens — móveis, eletrodomésticos, chaves, etc. Itens removidos usam soft delete (ativo: false), preservando o histórico para uso em vistorias já criadas.

O objeto Item

{
  "id": "inv001",
  "imovelId": "abc123",
  "nomeItem": "Sofá 3 lugares",
  "categoria": "Móvel",
  "quantidade": 1,
  "condicao": "Ótimo",
  "observacoes": "Sofá de couro marrom, sem defeitos.",
  "fotosUrls": ["https://..."],
  "codigoBarras": "",
  "codigoItem": "ABC1-MOV-001",
  "ativo": true,
  "userId": "uid_do_usuario",
  "criadoEm": "2025-01-10T10:00:00.000Z",
  "atualizadoEm": "2025-01-10T10:00:00.000Z"
}

`codigoItem`

Gerado automaticamente no formato {imovelId[0:4]}-{categoria[0:3]}-{seq}. Exemplo: ABC1-MOV-001. Não pode ser alterado após a criação.

Categorias válidas

Móvel, Eletrodoméstico, Eletrônico, Chave, Utensílio, Outro

Condições válidas

Ótimo, Bom, Regular, Ruim

Criar item

string

required

ID do imóvel. Deve pertencer ao usuário autenticado.

string

required

Nome descritivo do item.

string

required

Uma das categorias válidas.

number

default:"1"

Quantidade de unidades.

string

default:"Bom"

Uma das condições válidas.

string

EAN ou código de barras do produto. Opcional.

POST /inventario
Cookie: imob_session=<session_cookie>
Content-Type: application/json

{
  "imovelId": "abc123",
  "nomeItem": "Sofá 3 lugares",
  "categoria": "Móvel",
  "quantidade": 1,
  "condicao": "Ótimo"
}

Resposta 201

{
  "id": "inv001",
  "codigoItem": "ABC1-MOV-001",
  ...
}

Listar itens do imóvel

Retorna apenas itens com ativo: true, ordenados por categoria e depois por nomeItem.

GET /inventario/imovel/:imovelId
Cookie: imob_session=<session_cookie>

Buscar item por ID

GET /inventario/:id
Cookie: imob_session=<session_cookie>

Atualizar item

Os campos codigoItem, imovelId e userId são protegidos e ignorados mesmo que enviados no body.

PATCH /inventario/:id
Cookie: imob_session=<session_cookie>
Content-Type: application/json

{
  "condicao": "Regular",
  "observacoes": "Desgaste natural após uso."
}

Remover item (soft delete)

O item não é apagado do banco — apenas marcado com ativo: false e removidoEm. Isso preserva referências em vistorias históricas.

DELETE /inventario/:id
Cookie: imob_session=<session_cookie>

Resposta 200

{
  "message": "Item removido do inventário."
}

Gestão

Financeiro

Vistoria & Inventário

Plataforma

Visão Geral

O objeto Item

`codigoItem`

Categorias válidas

Condições válidas

Criar item

Listar itens do imóvel

Buscar item por ID

Atualizar item

Remover item (soft delete)

​Visão Geral

​O objeto Item

​codigoItem

​Categorias válidas

​Condições válidas

​Criar item

​Listar itens do imóvel

​Buscar item por ID

​Atualizar item

​Remover item (soft delete)

Visão Geral

O objeto Item

`codigoItem`

Categorias válidas

Condições válidas

Criar item

Listar itens do imóvel

Buscar item por ID

Atualizar item

Remover item (soft delete)