Developer Portal

Integre o Que Simples
no seu ERP em minutos.

API REST oficial para parceiros: Omie, Conta Azul, Bling, Sage, Dominio e qualquer ERP contábil. Diagnóstico Simples Nacional, upload de DAS e consulta de status.

Quickstart

3 passos pra começar.

Passo 1

Solicite sua API key

Envie um e-mail para api@quesimples.com.br com nome da empresa, CNPJ e volume estimado de requests/dia.

Passo 2

Faça sua primeira request

Envie o header x-api-key: qs_live_... em chamadas para https://quesimples.com.br/api/v1/simples/*. Alternativa: Authorization: Bearer <key>.

Passo 3

Acompanhe e baixe o resultado

Consulte o status em GET /simples/diagnostico/{id} (ou em lote via GET /simples/carteira) e baixe o DOCX com ?download=true. Re-envios não duplicam: a ingestão é upsert por competência.

Auth simples e segura

API key estática (formato `qs_live_...`), aceita no header `x-api-key` ou como Bearer token. Armazenada apenas como hash SHA-256 — nunca em texto puro.

Rate limit por organização

Default 30 req/min. Headers `X-RateLimit-Limit`, `X-RateLimit-Remaining` e `X-RateLimit-Reset` nas responses; em 429, `Retry-After` indica a espera.

OpenAPI 3.1 oficial

Schema completo em /api/v1/simples/openapi.json. Compatível com Postman, Insomnia, codegen.

Referência completa

Endpoints, schemas e exemplos gerados a partir do OpenAPI 3.1.