Integre seu produto à Tem Empresas

Nossa API permite embarcar o logon e o onboarding do beneficiário dentro do seu aplicativo e gerenciar dependentes com validação automática das regras de elegibilidade do contrato. A especificação abaixo é a fonte oficial: tudo o que já está disponível e também o que está no roteiro, com o contrato já publicado.

openapi.json openapi.yaml Baixar spec

Produção

https://temempresas.com

Homologação

https://tem-empresas.lovable.app

Comece a integrar agora

Cadastre sua aplicação e receba na hora uma credencial de homologação (tem_test_…) para testar sem tocar em dados reais. Quando estiver pronto, peça a credencial de produção (tem_live_…) — nosso time de tecnologia libera depois de conferir suas permissões.

Endpoints

Método	Caminho	Descrição	Situação
GET	/api/public/arquivo/{token}	Baixar arquivo por link temporário	Disponível
POST	/api/public/cron/faturamento-automatico	Abrir e fechar competências de faturamento	Disponível
POST	/api/public/cron/faturas-vencimento	Avisos de vencimento e inadimplência	Disponível
POST	/api/public/cron/renovacoes	Renovação de contratos a vencer	Disponível
POST	/api/public/cron/tem-integra-envios	Processar a fila de envio de vidas (TEM Integra)	Disponível
POST	/api/public/cron/tem-saude-envios	Processar a fila de envio de vidas (canal legado)	Disponível
POST	/api/public/cron/vigencia-contratos	Virada de vigência e liberação de vidas	Disponível
POST	/api/public/onboarding/sessao	Abrir o primeiro acesso do beneficiário dentro do app da loja	Disponível
GET	/api/public/onboarding/sessao/{id}	Consultar a situação da sessão de onboarding	Disponível
GET	/api/public/parceiro/beneficiario/status	Consultar pendências de onboarding	Planejado
POST	/api/public/parceiro/embed/launch	Gerar link das telas embarcadas	Planejado
POST	/api/public/parceiro/oauth/token	Emitir token de integração	Planejado
POST	/api/public/parceiro/vidas/dependente	Incluir dependente	Planejado
POST	/api/public/parceiro/vidas/dependente/exclusao	Excluir dependente	Planejado

Como autenticar

Cada parceiro recebe um client_id e um client_secret por ambiente. Troque-os por um token Bearer de 10 minutos e envie o token em todas as chamadas. O token carrega escopos: cada endpoint exige o escopo indicado na sua descrição. O segredo nunca deve trafegar no aplicativo do usuário final — mantenha a troca no seu servidor.

curl -X POST https://temempresas.com/api/public/parceiro/oauth/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials" \
  -d "client_id=$CLIENT_ID" \
  -d "client_secret=$CLIENT_SECRET" \
  -d "scope=embed:launch vida:dependente:incluir"

Com o token em mãos:

curl -X POST https://temempresas.com/api/public/parceiro/vidas/dependente \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "cpf_titular": "84752390990",
    "cpf": "39218477014",
    "nome": "Ana Beatriz Souza",
    "data_nascimento": "2010-04-22",
    "parentesco": "filho"
  }'

Catálogo de erros

Toda falha volta como { "sucesso": false, "codigo", "mensagem" }. Trate pelo código, que é estável; a mensagem é amigável e pode ser exibida ao usuário final.

HTTP	Código	Mensagem ao usuário	Quando acontece
401	AUTH_CREDENCIAL_INVALIDA	Credenciais do parceiro inválidas ou aplicação desativada.	client_id/client_secret errados, revogados ou app inativo.
401	AUTH_TOKEN_EXPIRADO	Sua sessão de integração expirou. Solicite um novo token.	Token de acesso vencido (validade de 10 minutos).
403	AUTH_ESCOPO_INSUFICIENTE	Esta aplicação não tem permissão para executar esta operação.	O token não contém o escopo exigido pelo endpoint.
401	LAUNCH_TOKEN_INVALIDO	Link de acesso inválido ou já utilizado. Abra novamente pelo aplicativo.	Token de lançamento expirado (5 min), já consumido ou assinado por outro parceiro.
404	TITULAR_NAO_ENCONTRADO	Não encontramos um titular ativo com este CPF.	CPF do titular não existe ou não pertence a nenhum contrato do parceiro.
422	TITULAR_INATIVO	O titular está inativo e não pode incluir dependentes.	Vida do titular com status diferente de ativa.
422	CONTRATO_SEM_VIGENCIA	O contrato da empresa não está em vigência.	Contrato ainda não iniciou ou já terminou.
409	DEP_CPF_JA_ATIVO	Este CPF já está ativo neste contrato.	Tentativa de incluir alguém que já é beneficiário do mesmo contrato.
422	DEP_BLOQUEIO_REINCLUSAO	Este dependente saiu recentemente e só pode voltar após o prazo de carência.	Regra anti-carrossel do contrato (bloqueio de reinclusão).
422	DEP_PERMANENCIA_MINIMA	O dependente precisa cumprir a permanência mínima antes desta alteração.	Exclusão antes da permanência mínima configurada no contrato.
422	DEP_IDADE_LIMITE	Dependente acima da idade limite. Filhos maiores só entram com comprovação de universitário.	Idade acima de 21 anos (ou 24 com comprovação), conforme o contrato.
422	DEP_PARENTESCO_NAO_ELEGIVEL	Este grau de parentesco não é elegível no contrato da empresa.	Parentesco fora da lista permitida pelo contrato/produto.
422	PRODUTO_SEM_DEPENDENTE	O produto contratado não prevê inclusão de dependentes.	Produto sem cobertura de dependentes.
400	DADOS_INVALIDOS	Alguns campos estão incompletos ou inválidos.	Falha na validação do corpo da requisição (detalhes em `campos`).
429	LIMITE_EXCEDIDO	Muitas requisições em sequência. Tente novamente em instantes.	Limite por client_id ou por CPF (proteção anti-enumeração).
500	ERRO_INTERNO	Não conseguimos concluir a operação agora. Tente novamente.	Falha inesperada — registrada na auditoria com identificador de correlação.

Documentação interativa

Carregando…

Roadmap

Rede credenciada

Planejado

Consulta de prestadores por especialidade e proximidade.

Carteirinha digital

Planejado

Dados da carteirinha do beneficiário para exibição no app do parceiro.

Agendamento

Planejado

Solicitação de teleconsulta e de atendimento presencial.

Webhook de eventos de vida

Planejado

Notificação de inclusão, alteração e exclusão de vidas para o parceiro.

Serviços que consumimos

Para transparência da arquitetura: estas são integrações em que a Tem Empresas é a cliente. Não são endpoints nossos.

Fornecedor	Finalidade	Autenticação	Situação
TEM Integra	Envio de vidas (adesão, alteração e exclusão) para a operação da TEM Saúde.	OAuth2 client credentials (token de 300s)	Ativa
Itaú — cobrança	Emissão e baixa de boletos das faturas das empresas.	mTLS + OAuth2	Ativa
Microsoft Graph	Envio de e-mails transacionais (faturas, relatórios, convites).	OAuth2 client credentials	Ativa
Twilio	SMS de recuperação de senha e códigos de verificação.	Basic (Account SID + token)	Ativa
Mapbox	Geocodificação e rotas para a rede credenciada mais próxima.	Token público	Ativa
IBGE — localidades	Base de estados e municípios usada nos cadastros.	Pública	Ativa

Fale com o time de integração

Para receber credenciais de homologação, cadastrar os deep links do seu aplicativo ou propor um novo endpoint, escreva para integracoes@temempresas.com.