⚠
Segurança: Não compartilhe sua secret_key publicamente. Armazene em variável de ambiente.
Nome
Status
Chave pública (PUBLIC KEY)
Criado em
Último uso
Permissões
Cada par de chaves autentica suas requisições. Inclua nos headers HTTP:
curl https://api.smartcare.com.br/v1/tuss?q=hemograma \
-H "x-public-key: pk_live_SUA_CHAVE_PUBLICA" \
-H "x-secret-key: sk_live_SUA_CHAVE_SECRETA"
copiar
Visão geral
Autenticação
Endpoints
Exemplos
O que é a SmartCare API?
A SmartCare API fornece acesso programático às principais bases de dados da saúde suplementar brasileira:
TUSS, CID-10, CBHPM e ROL ANS. Ideal para sistemas de faturamento médico, auditoria e integração TISS.
⚡
Alta performance
Respostas em <50ms com índices otimizados
🔐
Seguro por padrão
Tokens públicos e privados por assinatura
📡
RESTful
JSON, paginação, filtros e cross-reference
🔄
Sempre atualizado
Bases sincronizadas com fontes oficiais
Headers obrigatórios
x-public-key: pk_live_... ← identificador público
x-secret-key: sk_live_... ← segredo (mantenha em variável de ambiente)
copiar
⚠
Nunca exponha a secret_key no código frontend ou repositórios públicos.
Erros de autenticação
Status Mensagem Causa
401 Token inválido ou inativo Chaves incorretas ou token revogado
429 Rate limit atingido Excedeu req/min do plano
403 Base não incluída Plano não cobre esta base
GET
/v1/tuss
Busca na base TUSS — Terminologia Unificada da Saúde Suplementar
Params: q (texto), cod (código exato), grupo, page, page_size
copiar
GET
/v1/cid10
Busca na CID-10 — Classificação Internacional de Doenças
Params: q (texto), cod (ex: A00), page, page_size
GET
/v1/cbhpm
CBHPM — Classificação Brasileira Hierarquizada
GET
/v1/rolans
ROL ANS — Rol de Procedimentos
GET
/v1/validate/{codigo}
Cross-reference: verifica o código em TUSS, CBHPM e ROL ANS simultaneamente.
Buscar TUSS por descrição
curl "https://api.smartcare.com.br/v1/tuss?q=hemograma" \
-H "x-public-key: pk_live_abc123" \
-H "x-secret-key: sk_live_xyz789"
# Resposta
{
"base": "tuss",
"total": 14,
"page": 1,
"page_size": 20,
"items": [
{
"cod": "40303270",
"descricao": "HEMOGRAMA COMPLETO",
"grupo": "PATOLOGIA CLÍNICA",
"subgrupo": "HEMATOLOGIA"
}
]
}
copiar
Validar código em todas as bases
curl "https://api.smartcare.com.br/v1/validate/40303270" \
-H "x-public-key: pk_live_abc123" \
-H "x-secret-key: sk_live_xyz789"
# Resposta
{
"codigo": "40303270",
"tuss": { "found": true, "descricao": "HEMOGRAMA COMPLETO" },
"cbhpm": { "found": true, "descricao": "HEMOGRAMA COMPLETO" },
"rolans": { "found": false, "descricao": null }
}
Ative assinaturas manualmente após confirmação de pagamento
+ Ativar assinatura
Usuário Produto Status Início Expira
Todas as bases
TUSS
CID-10
CBHPM
ROL ANS
↻ Atualizar
Data/Hora Usuário Base Query Results Status
↻ Atualizar (CSVs locais)
↓ Download ANS + Importar
⚙ Recriar Índices + View
↻ Atualizar status
API DE TABELAS — POSTGRES_TABELAS
TABELAS LOCAIS — BANCO PRINCIPAL
TESTE DE INTEGRIDADE
Execute uma verificação completa de integridade em todas as tabelas do sistema.
▶ Executar Teste Completo
Tabela
Código Teste
Status
Resultado
Aguardando execução...
ESTATÍSTICAS TABELAS
📄 TUSS (Procedimentos)
...
ATUALIZAÇÃO AUTOMÁTICA
Total Protocolos
—
Regras cadastradas
Cobertura TUSS
—%
Procedimentos
Status
Ativo
Sistema operacional
Configurações
Parâmetros do sistema e integrações
Métodos de Pagamentos
Notas Fiscais
Geral
Integrações
Verificando conexão Stripe...
Integração futura para boletos e Pix nativo.
Em breve
🤝
Mercado Pago
Não configurado
Integração alternativa para LATAM.
Em breve
Configuração do Provedor (Stripe)
Selecione o ambiente e configure as chaves de API.
Ambiente Ativo
Desenvolvimento (Test Mode)
Produção (Live Mode)
💾 Salvar Configuração
Webhook URL:
...
Teste de Integração
Simule transações reais no ambiente selecionado. Isso criará uma sessão de checkout no Stripe.
💳 Testar Pagamento (Sucesso)
💳 Testar Pagamento (Falha)
Cartões de Teste Stripe
Use estes números para simular pagamentos no modo de teste.
SUCESSO (VISA)
4242 4242 4242 4242
copiar
Validade: Qualquer futura • CVC: Qualquer
FALHA (RECUSADO)
4000 0566 5566 5556
copiar
Emissão de Notas Fiscais (NFS-e)
Integração com gateways de emissão de Notas de Serviço (SaaS/Assinaturas).
Provedor
eNotas
Focus NFe
PlugNotas (TecnoSpeed)
ATIVO
Ambiente Ativo
Homologação (Testes)
Produção
💾 Salvar Configuração
Obrigatório para emissão de notas fiscais no PlugNotas. Envie o arquivo .pfx ou .p12.
📤 Enviar e Vincular Certificado
Teste de Emissão
Simule a emissão de uma NFS-e para validar a integração com o provedor.
🧾 Emitir Nota de Teste
Histórico de Notas Emitidas
Registro das últimas emissões realizadas.
Data
Provedor
Ambiente
Status
Valor
Ações
Nenhuma nota emitida.
🔄 Atualizar Lista
Informações da Empresa (Prestador)
Dados exibidos nas faturas e utilizados para emissão fiscal.
Webhooks Globais
Notificar eventos do sistema para URLs externas.
Nenhum webhook configurado.
Adicionar Webhook