---
title: "Guia: consultar guias do Simples (DAS)"
description: "Consulte as guias DAS do Simples Nacional pela API: situações, filtros por empresa e competência, PDF para pagamento e eventos de guia disponível, vencendo e paga."
url: https://docs.emissordenota.com/guias/guias-do-simples
language: pt-BR
---
# 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.

**Requisição**

```bash
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**

```json
{
  "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âmetro | Descriçã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**

```bash
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.

| Evento | Quando é enviado | Uso comum |
| --- | --- | --- |
| guia.disponivel | A guia da competência foi gerada. | Enviar o PDF ao cliente. |
| guia.vencendo | A guia está perto do vencimento e ainda não foi paga. | Mandar um lembrete de pagamento. |
| guia.paga | O pagamento foi identificado. | 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}.
