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
# Produçãohttps://api.emissordenota.com/v1# Sandboxhttps://sandbox.api.emissordenota.com/v1Endpoints
- 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
idstringIdentificador da guia, com o prefixo guia_.
tipostringdas. Novos tipos podem surgir: ignore os que o seu sistema não conhece.
empresa_idstringA empresa dona da guia.
competenciastringMês de apuração, no formato AAAA-MM.
valornumberValor em reais, com ponto decimal.
vencimentostringData no formato AAAA-MM-DD.
situacaostringdisponivel, paga ou vencida.
linha_digitavelstringPara pagamento em qualquer banco.
pdf_urlstringLink do PDF. Exige a chave de API.
paga_emstringQuando o pagamento foi identificado. Vem null enquanto a guia não é paga.
{ "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órioA empresa dona das guias.
competenciastringopcionalMês de apuração, no formato AAAA-MM.
situacaostringopcionaldisponivel, paga ou vencida.
limiteintegeropcionalItens por página. O padrão e o máximo são 50.
cursorstringopcionalO proximo_cursor da página anterior.
curl -G https://api.emissordenota.com/v1/guias \ -H "Authorization: Bearer $EDN_KEY" \ -d empresa_id=emp_8Kq2mXv41c \ -d competencia=2026-10 \ -d situacao=disponivelConsultar 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.
# API=https://api.emissordenota.com/v1curl $API/guias/guia_9Wd3kRs6Ph/pdf \ -H "Authorization: Bearer $EDN_KEY" \ -o das-2026-10.pdfErros
StatusCódigoQuando
- 403empresa_nao_autorizadaA chave não acessa essa empresa.
- 404guia_nao_encontradaO id não existe nesse ambiente.