Referência da APICertificados

Certificados

A validade do certificado digital A1 de cada empresa. O envio do arquivo é feito pelo painel: pela API você só consulta.

Escoposempresas:ler

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

Endpoints

  • GET/v1/certificadosLista os certificados e suas validades
  • GET/v1/certificados/{empresa_id}Consulta o certificado de uma empresa

O objeto certificado

empresa_idstring
A empresa dona do certificado.
situacaostring
valido, vencendo, vencido ou ausente.
titularstring
Razão social gravada no certificado.
cnpjstring
CNPJ gravado no certificado, só com dígitos.
valido_atestring
Data e hora em que o certificado expira, em ISO 8601.
dias_restantesinteger
Dias até o vencimento. Fica negativo depois que o certificado vence.
O objeto certificado
{  "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

situacaostringopcional
valido, vencendo, vencido ou ausente. Use vencendo para montar um alerta.
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/certificados
curl -G https://api.emissordenota.com/v1/certificados \  -H "Authorization: Bearer $EDN_KEY" \  -d situacao=vencendo
Resposta · 200 OK
{  "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_autorizada
    A chave não acessa essa empresa.
  • 404empresa_nao_encontrada
    O id não existe nesse ambiente.