Pular para o conteúdo principal

Changelog

Registro de todas as alteracoes na API Externa Tesselys. Seguimos Semantic Versioning para controle de versoes.


v1.1.0 (2026-03)

Expansao da API para todos os modulos da plataforma.

Adicionado

  • CRM Estendido: leads, atividades, itens de negocio, pipelines, emails e telefones de pessoa

    • GET/POST/PUT /external/v1/leads — CRUD de leads
    • GET/POST/PUT /external/v1/activities — CRUD de atividades comerciais
    • GET/POST/PUT /external/v1/deal-items — CRUD de itens de negocio
    • GET /external/v1/deal-pipelines — consulta de pipelines
    • GET/POST/PUT /external/v1/person-emails — CRUD de emails
    • GET/POST/PUT /external/v1/person-phones — CRUD de telefones
  • Propostas & Contratos: propostas, contratos digitais e recorrentes

    • GET/POST/PUT /external/v1/quotes — CRUD de propostas
    • GET/POST/PUT /external/v1/quote-items — CRUD de itens de proposta
    • GET/POST/PUT /external/v1/signs — CRUD de contratos digitais
    • GET/POST/PUT /external/v1/contracts — CRUD de contratos recorrentes
    • GET/POST /external/v1/contract-items — leitura e criacao de itens
  • Projetos — Detalhamento: waves, epicos, tarefas e equipe

    • GET/POST/PUT /external/v1/project-waves — CRUD de waves (sprints)
    • GET/POST/PUT /external/v1/project-epics — CRUD de epicos
    • GET/POST /external/v1/project-tasks — leitura e criacao de tarefas
    • GET/POST /external/v1/project-team-members — gestao de equipe
  • Financeiro Estendido: categorias, contas, medicoes, NF-e, cobrancas, provisionamento

    • GET /external/v1/financial-categories — consulta de categorias
    • GET /external/v1/bank-accounts — consulta de contas bancarias
    • GET/POST /external/v1/measurements — leitura e criacao de medicoes
    • GET/POST /external/v1/invoices — leitura e criacao de notas fiscais
    • GET /external/v1/charges — consulta de cobrancas
    • GET/POST/PUT /external/v1/provisioning — CRUD de provisionamento
  • Compras: ordens de compra e itens

    • GET/POST/PUT /external/v1/purchase-orders — CRUD de ordens de compra
    • GET/POST /external/v1/purchase-order-items — leitura e criacao de itens
  • RH & Timesheet: perfis, apontamentos e periodos

    • GET/POST/PUT /external/v1/employee-profiles — CRUD de perfis
    • GET/POST /external/v1/timesheet-entries — leitura e criacao de apontamentos
    • GET/POST /external/v1/timesheet-periods — leitura e criacao de periodos
  • Help Desk & SLA: tickets, comentarios e politicas

    • GET/POST/PUT /external/v1/tickets — CRUD de tickets
    • GET/POST /external/v1/ticket-comments — leitura e criacao de comentarios
    • GET /external/v1/sla-policies — consulta de politicas de SLA
  • Contabilidade: contas, lancamentos, partidas e relatorios

    • GET /external/v1/accounting-accounts — consulta de contas contabeis
    • GET /external/v1/accounting-journal-entries — consulta de lancamentos
    • GET /external/v1/accounting-journal-entry-lines — consulta de partidas
    • GET /external/v1/accounting-reports/trial-balance — balancete de verificacao
    • GET /external/v1/accounting-reports/balance-sheet — balanco patrimonial
    • GET /external/v1/accounting-reports/general-ledger — razao contabil
    • GET /external/v1/accounting-reports/account-statement — extrato de conta
    • GET /external/v1/accounting-reports/dashboard-summary — dashboard contabil
  • Configuracoes & Lookup: dados de referencia

    • GET /external/v1/cost-centers — consulta de centros de custo
    • GET /external/v1/business-units — consulta de unidades de negocio
    • GET /external/v1/custom-fields — consulta de campos customizados

v1.0.0 (2026-03)

Lancamento inicial da API Externa Tesselys.

Recursos

  • Autenticacao: API Key + Secret com emissao de JWT tokens

    • POST /external/v1/auth — autenticacao
    • POST /external/v1/auth/refresh-token — renovacao de token
  • Pessoas (Persons): CRUD completo

    • GET /external/v1/persons — listar com paginacao e filtros
    • GET /external/v1/persons/:id — buscar por ID
    • POST /external/v1/persons — criar
    • PUT /external/v1/persons/:id — atualizar
  • Negocios (Deals): CRUD completo

    • GET /external/v1/deals — listar com paginacao e filtros
    • GET /external/v1/deals/:id — buscar por ID
    • POST /external/v1/deals — criar
    • PUT /external/v1/deals/:id — atualizar
  • Lancamentos Financeiros (Financial Entries): leitura e criacao

    • GET /external/v1/financial-entries — listar com paginacao e filtros
    • GET /external/v1/financial-entries/:id — buscar por ID
    • POST /external/v1/financial-entries — criar (avista e parcelado)
  • Produtos (Products): CRUD completo

    • GET /external/v1/products — listar com paginacao e filtros
    • GET /external/v1/products/:id — buscar por ID
    • POST /external/v1/products — criar
    • PUT /external/v1/products/:id — atualizar
  • Projetos (Projects): leitura e criacao

    • GET /external/v1/projects — listar com paginacao e filtros
    • GET /external/v1/projects/:id — buscar por ID
    • POST /external/v1/projects — criar

Webhooks

  • Configuracao de assinaturas via API e painel administrativo
  • Eventos disponiveis: person.*, deal.*, financial.*, product.*, project.*
  • Validacao de assinatura HMAC-SHA256
  • Politica de retry com ate 5 tentativas

Infraestrutura

  • Rate limit: 100 requisicoes por minuto por empresa
  • Formato padronizado de erros com friendlyMessage em portugues
  • Suporte a paginacao em todos os endpoints de listagem

Formato para Entradas Futuras

## vX.Y.Z (AAAA-MM)

### Adicionado
- Descricao do novo recurso ou endpoint

### Alterado
- Descricao da alteracao em recurso existente

### Corrigido
- Descricao do bug corrigido

### Depreciado
- Descricao do recurso marcado para remocao futura

### Removido
- Descricao do recurso removido

Notificacoes

Para ser notificado sobre novas versoes da API, acesse Configuracoes → Integracoes → API Externa no painel administrativo e ative as notificacoes de changelog.