---
title: "Referência: Guias"
description: "Referência do recurso Guias da API: objeto guia (DAS do Simples Nacional), listar por empresa e competência, consultar e baixar o PDF para pagamento."
url: https://docs.emissordenota.com/referencia/guias
language: pt-BR
---
# Guias

O DAS e as demais guias geradas para as empresas do Simples Nacional. O recurso é somente leitura: as guias são geradas no painel do escritório.

**Escopos**: guias:ler

**URL base**

```bash
# Produção
https://api.emissordenota.com/v1

# Sandbox
https://sandbox.api.emissordenota.com/v1
```

## Endpoints

- `GET /v1/guias`: Lista guias por empresa, competência e situação
- `GET /v1/guias/{id}`: Consulta uma guia
- `GET /v1/guias/{id}/pdf`: Baixa o PDF para pagamento

## O objeto guia

- `id` (string): Identificador da guia, com o prefixo guia_.
- `tipo` (string): das. Novos tipos podem surgir: ignore os que o seu sistema não conhece.
- `empresa_id` (string): A empresa dona da guia.
- `competencia` (string): Mês de apuração, no formato AAAA-MM.
- `valor` (number): Valor em reais, com ponto decimal.
- `vencimento` (string): Data no formato AAAA-MM-DD.
- `situacao` (string): disponivel, paga ou vencida.
- `linha_digitavel` (string): Para pagamento em qualquer banco.
- `pdf_url` (string): Link do PDF. Exige a chave de API.
- `paga_em` (string): Quando o pagamento foi identificado. Vem null enquanto a guia não é paga.

**O objeto guia**

```json
{
  "id": "guia_9Wd3kRs6Ph",
  "tipo": "das",
  "empresa_id": "emp_8Kq2mXv41c",
  "competencia": "2026-10",
  "valor": 1284.37,
  "vencimento": "2026-11-20",
  "situacao": "disponivel",
  "linha_digitavel": "858900000128 843703282632 …",
  "pdf_url": "…/v1/guias/guia_9Wd3kRs6Ph/pdf",
  "paga_em": null
}
```

## Listar guias

`GET /v1/guias`

Devolve as guias de uma empresa, da competência mais recente para a mais antiga.

**Parâmetros de consulta**

- `empresa_id` (string, obrigatório): A empresa dona das guias.
- `competencia` (string, opcional): Mês de apuração, no formato AAAA-MM.
- `situacao` (string, opcional): disponivel, paga ou vencida.
- `limite` (integer, opcional): Itens por página. O padrão e o máximo são 50.
- `cursor` (string, opcional): O proximo_cursor da página anterior.

**GET /v1/guias**

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

## Consultar uma guia

`GET /v1/guias/{id}`

Devolve o objeto guia. Use depois de receber um evento para conferir a situação atual.

## Baixar o PDF

`GET /v1/guias/{id}/pdf`

Devolve o arquivo no corpo da resposta, com Content-Type application/pdf.

**GET /v1/guias/{id}/pdf**

```bash
# API=https://api.emissordenota.com/v1
curl $API/guias/guia_9Wd3kRs6Ph/pdf \
  -H "Authorization: Bearer $EDN_KEY" \
  -o das-2026-10.pdf
```

## Erros

| Status | Código | Quando |
| --- | --- | --- |
| 403 | empresa_nao_autorizada | A chave não acessa essa empresa. |
| 404 | guia_nao_encontrada | O id não existe nesse ambiente. |
