Certificados
A validade do certificado digital A1 de cada empresa. O envio do arquivo é feito pelo painel: pela API você só consulta.
Escoposempresas:ler
# Produçãohttps://api.emissordenota.com/v1# Sandboxhttps://sandbox.api.emissordenota.com/v1Endpoints
- GET
/v1/certificadosLista os certificados e suas validades - GET
/v1/certificados/{empresa_id}Consulta o certificado de uma empresa
O objeto certificado
empresa_idstringA empresa dona do certificado.
situacaostringvalido, vencendo, vencido ou ausente.
titularstringRazão social gravada no certificado.
cnpjstringCNPJ gravado no certificado, só com dígitos.
valido_atestringData e hora em que o certificado expira, em ISO 8601.
dias_restantesintegerDias até o vencimento. Fica negativo depois que o certificado vence.
{ "empresa_id": "emp_8Kq2mXv41c", "situacao": "vencendo", "titular": "STUDIO AURORA DESIGN LTDA", "cnpj": "12345678000190", "valido_ate": "2026-12-04T23:59:59-03:00", "dias_restantes": 24}Listar certificados
GET/v1/certificados
Devolve um certificado por empresa liberada para a chave, do vencimento mais próximo para o mais distante.
Parâmetros de consulta
situacaostringopcionalvalido, vencendo, vencido ou ausente. Use vencendo para montar um alerta.
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/certificados \ -H "Authorization: Bearer $EDN_KEY" \ -d situacao=vencendo{ "dados": [ { "empresa_id": "emp_8Kq2mXv41c", "situacao": "vencendo", "valido_ate": "2026-12-04T23:59:59-03:00", "dias_restantes": 24 } ], "proximo_cursor": null}Consultar o certificado de uma empresa
GET/v1/certificados/{empresa_id}
Devolve o certificado em uso. Quando a empresa nunca enviou um certificado, a situação é ausente e os demais campos vêm null. Sem certificado válido a empresa não emite, e o evento certificado.vencendo avisa antes de isso acontecer.
Erros
StatusCódigoQuando
- 403empresa_nao_autorizadaA chave não acessa essa empresa.
- 404empresa_nao_encontradaO id não existe nesse ambiente.