Referência da APIGuias

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.

Escoposguias:ler

Linguagem dos exemplos
URL base
# Produçãohttps://api.emissordenota.com/v1# Sandboxhttps://sandbox.api.emissordenota.com/v1

Endpoints

  • GET/v1/guiasLista guias por empresa, competência e situação
  • GET/v1/guias/{id}Consulta uma guia
  • GET/v1/guias/{id}/pdfBaixa o PDF para pagamento

O objeto guia

idstring
Identificador da guia, com o prefixo guia_.
tipostring
das. Novos tipos podem surgir: ignore os que o seu sistema não conhece.
empresa_idstring
A empresa dona da guia.
competenciastring
Mês de apuração, no formato AAAA-MM.
valornumber
Valor em reais, com ponto decimal.
vencimentostring
Data no formato AAAA-MM-DD.
situacaostring
disponivel, paga ou vencida.
linha_digitavelstring
Para pagamento em qualquer banco.
pdf_urlstring
Link do PDF. Exige a chave de API.
paga_emstring
Quando o pagamento foi identificado. Vem null enquanto a guia não é paga.
O objeto guia
{  "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_idstringobrigatório
A empresa dona das guias.
competenciastringopcional
Mês de apuração, no formato AAAA-MM.
situacaostringopcional
disponivel, paga ou vencida.
limiteintegeropcional
Itens por página. O padrão e o máximo são 50.
cursorstringopcional
O proximo_cursor da página anterior.
GET /v1/guias
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
# API=https://api.emissordenota.com/v1curl $API/guias/guia_9Wd3kRs6Ph/pdf \  -H "Authorization: Bearer $EDN_KEY" \  -o das-2026-10.pdf

Erros

StatusCódigoQuando

  • 403empresa_nao_autorizada
    A chave não acessa essa empresa.
  • 404guia_nao_encontrada
    O id não existe nesse ambiente.