API Docs

Autenticação

A API para contadores usa API Key no header Authorization no formato Bearer. As chaves são armazenadas apenas como hash no servidor.

curl "https://simulamei.com.br/api/contadores/simulate?faturamentoAcumulado=54000&mesAtual=4&cnae=6201-5%2F01&folhaMensal=2500&tipoMei=geral" \
  -H "Authorization: Bearer smei_sua_chave_aqui"

Rate Limiting Planejado

Headers de resposta: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.

Endpoints

GET/contadores/simulate

Executa a simulação tributária completa. Retorna alerta de teto, Fator R, Anexo provável e comparativo de regimes.

Parâmetros da query string

curl "https://simulamei.com.br/api/contadores/simulate?faturamentoAcumulado=54000&mesAtual=4&cnae=6201-5%2F01&folhaMensal=2500&tipoMei=geral" \
  -H "Authorization: Bearer smei_sua_chave_aqui"

Resposta (200 OK):

{
  "entrada": { "faturamentoAcumulado": 54000, "mesAtual": 4, "cnae": "6201-5/01", ... },
  "alertaTeto": {
    "projecaoAnual": 162000,
    "tetoAnual": 81000,
    "percentualUtilizado": 98.77,
    "cenario": "dentro_limite"
  },
  "fatorR": {
    "fatorR": 0.375,
    "fatorRPercent": 37.5,
    "atingeMinimo": true,
    "anexoResultante": "III",
    "proLaboreMinimo": 1867.5,
    "economiaAnual": 7600
  },
  "anexoAtual": "III",
  "comparativo": {
    "simplesAnexoAtual": { "aliquotaEfetiva": 0.06, "dasAnual": 4800 },
    "presumido": { "total": 18240, "aliquotaEfetiva": 0.228 },
    "real": { "total": 11776, "aliquotaEfetiva": 0.1472 },
    "melhorRegime": "simplesAtual",
    "economiaVsMelhor": 0
  },
  "taxRuleVersion": "BR-MEI-SN-2026-04-28",
  "geradoEm": "2026-04-29T12:00:00.000Z"
}

GET/cnae

Busca CNAEs por texto. Útil para autocomplete.

GET https://simulamei.com.br/api/cnae?q=programas+computador&limit=5

// Resposta
{
  "results": [
    {
      "cnae": "6201-5/01",
      "descricao": "Desenvolvimento de programas de computador sob encomenda",
      "anexoPadrao": "V",
      "elegivelFatorR": true,
      "categoria": "ti_consultoria"
    }
  ],
  "total": 1
}

GET/cnae/:codigo

Retorna dados detalhados de um CNAE específico.

GET https://simulamei.com.br/api/cnae/6201-5%2F01

// Resposta
{
  "cnae": "6201-5/01",
  "descricao": "Desenvolvimento de programas de computador sob encomenda",
  "anexoPadrao": "V",
  "elegivelFatorR": true,
  "categoria": "ti_consultoria"
}

GET/teto

Retorna os limites vigentes do MEI.

GET https://simulamei.com.br/api/teto

// Resposta
{
  "taxRuleVersion": "BR-MEI-SN-2026-04-28",
  "limites": {
    "geral":        { "anual": 81000, "mensalProporcional": 6750 },
    "caminhoneiro": { "anual": 251600, "mensalProporcional": 20966.67 }
  },
  "fatorRMinimo": 0.28,
  "vigenciaDesde": "2026-01-01"
}

Erros

SDKs e exemplos

Exemplos de integração disponíveis no repositório:

# Node.js / TypeScript
npm install simulamei-sdk

import { SimulaMEI } from 'simulamei-sdk'
const client = new SimulaMEI({ apiKey: process.env.SIMULAMEI_API_KEY })
const resultado = await client.simular({ faturamentoAcumulado: 54000, mesAtual: 4, cnae: '6201-5/01', folhaMensal: 2500, tipoMei: 'geral' })

# Python (em breve)
# pip install simulamei