GuiasConsultar guias do Simples

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çãoSignificado
disponivelGerada e ainda dentro do prazo de pagamento.
pagaO pagamento foi identificado.
vencidaPassou 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.

Requisição
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
Resposta · 200 OK
{  "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_id
    Obrigatório. A empresa dona das guias.
  • competencia
    Mês de apuração no formato AAAA-MM. Sem ele, a lista traz as guias mais recentes primeiro.
  • situacao
    disponivel, 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.

Requisição
curl https://api.emissordenota.com/v1/guias/guia_9Wd3kRs6Ph/pdf \  -H "Authorization: Bearer $EDN_KEY" \  -o das-2026-10.pdf

Avisar 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

A lista vem vazia para empresas que não são optantes do Simples Nacional. O regime de cada empresa está no campo regime_tributario de GET /empresas/{id}.