Projetos

Gerencie projetos vinculados a sua empresa.

Listar Projetos

GET /external/v1/projects

Retorna uma lista paginada de projetos.

Query Parameters:

Parametro	Tipo	Obrigatorio	Descricao
page	number	Nao	Pagina atual (default: 1)
limit	number	Nao	Itens por pagina (default: 20, max: 100)
search	string	Nao	Busca por titulo
responsibleId	string	Nao	Filtro por responsavel (companyUserId)
businessUnitId	string	Nao	Filtro por unidade de negocio
status	string	Nao	Filtro: PLANNING, IN_PROGRESS, ON_HOLD, COMPLETED, CANCELLED
orderBy	string	Nao	Campo: title, startDate, createdAt (default: createdAt)
order	string	Nao	ASC ou DESC (default: DESC)

Exemplo de requisicao:

curl -X GET "https://api.tesselys.com.br/external/v1/projects?status=IN_PROGRESS&limit=10" \
  -H "Authorization: Bearer {accessToken}" \
  -H "x-company-token: {companyToken}"

Resposta (200):

{
  "data": [
    {
      "id": "clxa0j1k2l3m4n5o6p7q8r9s0",
      "code": "PRP-1015",
      "title": "Implantacao Tesselys - Fase 2",
      "description": "Segunda fase da implantacao com modulos financeiro e estoque.",
      "responsibleId": "clxuser001",
      "responsibleName": "Carlos Silva",
      "businessUnitId": "clxbu001",
      "businessUnitName": "Tecnologia",
      "status": "IN_PROGRESS",
      "startDate": "2026-02-01T00:00:00.000Z",
      "expectedEndDate": "2026-06-30T00:00:00.000Z",
      "endDate": null,
      "progress": 35,
      "isActive": true,
      "createdAt": "2026-01-28T14:00:00.000Z",
      "updatedAt": "2026-03-20T09:30:00.000Z"
    }
  ],
  "meta": {
    "total": 12,
    "page": 1,
    "limit": 10,
    "totalPages": 2
  }
}

Buscar Projeto por ID

GET /external/v1/projects/:id

Exemplo de requisicao:

curl -X GET "https://api.tesselys.com.br/external/v1/projects/clxa0j1k2l3m4n5o6p7q8r9s0" \
  -H "Authorization: Bearer {accessToken}" \
  -H "x-company-token: {companyToken}"

Resposta (200):

{
  "id": "clxa0j1k2l3m4n5o6p7q8r9s0",
  "code": "PRP-1015",
  "title": "Implantacao Tesselys - Fase 2",
  "description": "Segunda fase da implantacao com modulos financeiro e estoque. Inclui migracoes de dados e treinamentos.",
  "responsibleId": "clxuser001",
  "responsibleName": "Carlos Silva",
  "businessUnitId": "clxbu001",
  "businessUnitName": "Tecnologia",
  "status": "IN_PROGRESS",
  "startDate": "2026-02-01T00:00:00.000Z",
  "expectedEndDate": "2026-06-30T00:00:00.000Z",
  "endDate": null,
  "progress": 35,
  "budget": 120000.00,
  "isActive": true,
  "createdAt": "2026-01-28T14:00:00.000Z",
  "updatedAt": "2026-03-20T09:30:00.000Z"
}

Criar Projeto

POST /external/v1/projects

Body:

Campo	Tipo	Obrigatorio	Descricao
title	string	Sim	Titulo do projeto (max: 255)
responsibleId	string	Sim	ID do responsavel (companyUserId)
businessUnitId	string	Nao	ID da unidade de negocio
description	string	Nao	Descricao detalhada
startDate	string	Nao	Data de inicio (ISO 8601: YYYY-MM-DD)
expectedEndDate	string	Nao	Data prevista de conclusao (ISO 8601: YYYY-MM-DD)
budget	number	Nao	Orcamento previsto

Exemplo de requisicao:

curl -X POST "https://api.tesselys.com.br/external/v1/projects" \
  -H "Authorization: Bearer {accessToken}" \
  -H "x-company-token: {companyToken}" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Migracao de Infraestrutura Cloud",
    "responsibleId": "clxuser002",
    "businessUnitId": "clxbu001",
    "description": "Migracao completa da infraestrutura on-premise para AWS. Inclui banco de dados, aplicacoes e armazenamento.",
    "startDate": "2026-04-01",
    "expectedEndDate": "2026-09-30",
    "budget": 250000.00
  }'

Resposta (201):

{
  "id": "clxb1k2l3m4n5o6p7q8r9s0t1",
  "code": "PRP-1016",
  "title": "Migracao de Infraestrutura Cloud",
  "description": "Migracao completa da infraestrutura on-premise para AWS. Inclui banco de dados, aplicacoes e armazenamento.",
  "responsibleId": "clxuser002",
  "responsibleName": "Ana Rodrigues",
  "businessUnitId": "clxbu001",
  "businessUnitName": "Tecnologia",
  "status": "PLANNING",
  "startDate": "2026-04-01T00:00:00.000Z",
  "expectedEndDate": "2026-09-30T00:00:00.000Z",
  "endDate": null,
  "progress": 0,
  "budget": 250000.00,
  "isActive": true,
  "createdAt": "2026-03-25T12:00:00.000Z",
  "updatedAt": "2026-03-25T12:00:00.000Z"
}

Nota

Projetos sao criados automaticamente com status PLANNING. O campo code e gerado automaticamente pelo sistema.

Valores de Enum

status (somente leitura)

Valor	Descricao
PLANNING	Em planejamento
IN_PROGRESS	Em andamento
ON_HOLD	Pausado
COMPLETED	Concluido
CANCELLED	Cancelado