Certificados

Renovação

Renovar é a mesma chamada de upload -- não existe um endpoint separado para "trocar" o certificado.

💡

Ao enviar um novo certificado pra um contribuinte que já tem um ativo, o certificado anterior é automaticamente revogado (status vira REVOKED) antes do novo ser salvo como ACTIVE. Não é preciso remover o antigo antes -- basta chamar POST .../certificado-digital de novo com o arquivo novo.

✅

Renove com folga -- um certificado A1 costuma valer 1 ano, e emissões param assim que ele expira. Consulte valido_ate periodicamente (ver Consulta) pra avisar seu usuário antes do vencimento.

Desativar sem renovar

Se você só precisa desligar um certificado (ex.: suspeita de comprometimento), sem enviar um substituto agora, existe uma revogação explícita:

POST https://areacliente.centralfiscal.com.br/v1/contribuintes/{contribuinte_id}/certificado-digital/revogar

Sem corpo na requisição. Marca o certificado ativo como REVOKED -- a partir daí, qualquer emissão em nome desse contribuinte falha com *_CERTIFICADO_A1_AUSENTE até um novo upload ser feito.