Consultar guias do Simples
As guias do Simples Nacional geradas para as empresas da carteira ficam disponíveis pela API. Você lista as guias, baixa o PDF para pagamento e fica sabendo quando uma guia nova sai ou está perto de vencer.
Como as guias aparecem na API
Cada guia é o documento de arrecadação de uma competência, como o DAS de outubro. A API é somente leitura: as guias são geradas no painel do escritório e ficam disponíveis para o seu sistema consultar.
| Situação | Significado |
|---|---|
| disponivel | Gerada e ainda dentro do prazo de pagamento. |
| paga | O pagamento foi identificado. |
| vencida | Passou do vencimento sem pagamento identificado. |
Listar as guias de uma empresa
Filtre por empresa, competência e situação. A chave precisa do escopo guias:ler.
curl -G https://api.emissordenota.com/v1/guias \ -H "Authorization: Bearer $EDN_KEY" \ -d empresa_id=emp_8Kq2mXv41c \ -d competencia=2026-10 \ -d situacao=disponivel{ "dados": [ { "id": "guia_9Wd3kRs6Ph", "tipo": "das", "empresa_id": "emp_8Kq2mXv41c", "competencia": "2026-10", "valor": 1284.37, "vencimento": "2026-11-20", "situacao": "disponivel", "linha_digitavel": "85890000012 8 84370328263 2 20112026103 5 12345678901 4", "pdf_url": "https://api.emissordenota.com/v1/guias/guia_9Wd3kRs6Ph/pdf" } ], "proximo_cursor": null}ParâmetroDescrição
- empresa_idObrigatório. A empresa dona das guias.
- competenciaMês de apuração no formato AAAA-MM. Sem ele, a lista traz as guias mais recentes primeiro.
- situacaodisponivel, paga ou vencida.
Baixar o PDF para pagamento
O endpoint devolve o PDF direto no corpo da resposta. É o mesmo documento que o escritório envia ao cliente pelo painel.
curl https://api.emissordenota.com/v1/guias/guia_9Wd3kRs6Ph/pdf \ -H "Authorization: Bearer $EDN_KEY" \ -o das-2026-10.pdfAvisar o cliente na hora certa
Três eventos cobrem o ciclo da guia. Com eles o seu sistema avisa o cliente sem consultar a API todos os dias.
- guia.disponivel
- Quando é enviado
- A guia da competência foi gerada.
- Uso comum
- Enviar o PDF ao cliente.
- guia.vencendo
- Quando é enviado
- A guia está perto do vencimento e ainda não foi paga.
- Uso comum
- Mandar um lembrete de pagamento.
- guia.paga
- Quando é enviado
- O pagamento foi identificado.
- Uso comum
- Dar baixa na cobrança do seu sistema.
Empresas fora do Simples