Produtos

Gerencie o catalogo de produtos e servicos da sua empresa.

Listar Produtos

GET /external/v1/products

Retorna uma lista paginada de produtos.

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 nome ou codigo
type	string	Nao	Filtro: PRODUCT ou SERVICE
orderBy	string	Nao	Campo: name, code, unitPrice, createdAt (default: createdAt)
order	string	Nao	ASC ou DESC (default: DESC)

Exemplo de requisicao:

curl -X GET "https://api.tesselys.com.br/external/v1/products?page=1&limit=10&type=PRODUCT" \
  -H "Authorization: Bearer {accessToken}" \
  -H "x-company-token: {companyToken}"

Resposta (200):

{
  "data": [
    {
      "id": "clx7g8h9i0j1k2l3m4n5o6p7",
      "code": "PRD-001",
      "name": "Licenca Tesselys - Modulo Financeiro",
      "type": "PRODUCT",
      "unitPrice": 299.90,
      "description": "Licenca mensal do modulo financeiro do Tesselys.",
      "isActive": true,
      "createdAt": "2026-01-10T08:00:00.000Z",
      "updatedAt": "2026-03-15T12:00:00.000Z"
    },
    {
      "id": "clx8h9i0j1k2l3m4n5o6p7q8",
      "code": "SRV-010",
      "name": "Hora Tecnica - Consultoria",
      "type": "SERVICE",
      "unitPrice": 180.00,
      "description": "Hora tecnica de consultoria especializada.",
      "isActive": true,
      "createdAt": "2026-01-12T10:00:00.000Z",
      "updatedAt": "2026-01-12T10:00:00.000Z"
    }
  ],
  "meta": {
    "total": 56,
    "page": 1,
    "limit": 10,
    "totalPages": 6
  }
}

Buscar Produto por ID

GET /external/v1/products/:id

Exemplo de requisicao:

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

Resposta (200):

{
  "id": "clx7g8h9i0j1k2l3m4n5o6p7",
  "code": "PRD-001",
  "name": "Licenca Tesselys - Modulo Financeiro",
  "type": "PRODUCT",
  "unitPrice": 299.90,
  "costPrice": 120.00,
  "description": "Licenca mensal do modulo financeiro do Tesselys.",
  "unit": "UN",
  "isActive": true,
  "createdAt": "2026-01-10T08:00:00.000Z",
  "updatedAt": "2026-03-15T12:00:00.000Z"
}

Criar Produto

POST /external/v1/products

Body:

Campo	Tipo	Obrigatorio	Descricao
name	string	Sim	Nome do produto ou servico (max: 255)
code	string	Nao	Codigo interno (se nao informado, sera gerado automaticamente)
type	string	Sim	PRODUCT ou SERVICE
unitPrice	number	Sim	Preco unitario de venda (deve ser >= 0)
costPrice	number	Nao	Preco de custo
description	string	Nao	Descricao detalhada
unit	string	Nao	Unidade de medida (ex: UN, HR, KG, M)

Exemplo de requisicao:

curl -X POST "https://api.tesselys.com.br/external/v1/products" \
  -H "Authorization: Bearer {accessToken}" \
  -H "x-company-token: {companyToken}" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Suporte Tecnico Remoto - Pacote 10h",
    "code": "SRV-020",
    "type": "SERVICE",
    "unitPrice": 1500.00,
    "costPrice": 600.00,
    "description": "Pacote de 10 horas de suporte tecnico remoto com SLA de 4 horas.",
    "unit": "UN"
  }'

Resposta (201):

{
  "id": "clx9i0j1k2l3m4n5o6p7q8r9",
  "code": "SRV-020",
  "name": "Suporte Tecnico Remoto - Pacote 10h",
  "type": "SERVICE",
  "unitPrice": 1500.00,
  "costPrice": 600.00,
  "description": "Pacote de 10 horas de suporte tecnico remoto com SLA de 4 horas.",
  "unit": "UN",
  "isActive": true,
  "createdAt": "2026-03-25T11:00:00.000Z",
  "updatedAt": "2026-03-25T11:00:00.000Z"
}

Atualizar Produto

PUT /external/v1/products/:id

Atualiza os dados de um produto existente. Envie apenas os campos que deseja alterar.

Exemplo de requisicao:

curl -X PUT "https://api.tesselys.com.br/external/v1/products/clx9i0j1k2l3m4n5o6p7q8r9" \
  -H "Authorization: Bearer {accessToken}" \
  -H "x-company-token: {companyToken}" \
  -H "Content-Type: application/json" \
  -d '{
    "unitPrice": 1750.00,
    "description": "Pacote de 10 horas de suporte tecnico remoto com SLA de 2 horas (premium)."
  }'

Resposta (200):

{
  "id": "clx9i0j1k2l3m4n5o6p7q8r9",
  "code": "SRV-020",
  "name": "Suporte Tecnico Remoto - Pacote 10h",
  "type": "SERVICE",
  "unitPrice": 1750.00,
  "costPrice": 600.00,
  "description": "Pacote de 10 horas de suporte tecnico remoto com SLA de 2 horas (premium).",
  "unit": "UN",
  "isActive": true,
  "createdAt": "2026-03-25T11:00:00.000Z",
  "updatedAt": "2026-03-25T11:45:00.000Z"
}

Valores de Enum

type

Valor	Descricao
PRODUCT	Produto fisico ou digital
SERVICE	Servico