API.UniNFemd

Como cadastrar e enviar um certificado digital A1

Configure o certificado digital A1 do emitente para assinar documentos fiscais pela API DFe. Antes de emitir documentos fiscais, cadastre o certificado do emitente e envie o arquivo para a API. Este tutorial apresenta o fluxo de cadastro, upload, validação e renovação.

#certificado digital#certificado A1#upload de certificado#certificado PFX#certificado P12#API

Pré-requisitos

Você precisa ter:

Token de acesso à API;
CPF ou CNPJ do emitente;
Certificado digital A1 válido;
Senha do certificado;
Arquivo no formato PKCS#12: .pfx ou .p12.

Nunca compartilhe o arquivo do certificado, sua senha ou o token de acesso em exemplos, logs, e-mails ou chamados.

Etapa 1: cadastre o certificado

Primeiro, cadastre os dados do certificado para obter o identificador que será usado nas operações seguintes.

POST /api/v1/Certificate/Add

Informe os dados solicitados pela operação, incluindo a identificação do emitente, a senha e uma descrição para o certificado. A resposta retorna o id do cadastro.

Guarde o id. Ele será necessário para enviar, consultar, atualizar ou substituir o arquivo do certificado.

Etapa 2: envie o arquivo

Com o identificador retornado, envie o arquivo do certificado:

POST /api/v1/Certificate/Upload/{id}

A requisição deve usar multipart/form-data e conter:

O arquivo .pfx ou .p12;
A senha correspondente ao arquivo.

Substitua {id} pelo identificador retornado no cadastro.

Etapa 3: valide o cadastro

Após o upload, consulte o certificado pelo identificador:

GET /api/v1/Certificate/Get/{id}

Confirme que ele está associado ao mesmo CPF ou CNPJ que será usado nas operações fiscais. Após essa validação, o certificado estará disponível para assinar documentos.

Como renovar ou substituir o certificado

Quando o certificado vencer ou for renovado, envie o novo arquivo usando o mesmo identificador:

POST /api/v1/Certificate/Upload/{id}

Dessa forma, as demais integrações do emitente permanecem configuradas.

Erros comuns

Arquivo inválido: utilize um certificado A1 PKCS#12 com extensão .pfx ou .p12.
Senha incorreta: informe a mesma senha definida na emissão do certificado.
Certificado vencido: obtenha o certificado renovado e envie o novo arquivo.
Emitente diferente: confirme que o certificado foi associado ao mesmo CPF ou CNPJ usado na operação fiscal.

Uma resposta 401 com Invalid client or Invalid client credentials indica falha de autenticação da API, não do certificado digital.

Próximos passos

Com o certificado configurado, prossiga para o fluxo de autorização do documento fiscal desejado, como NF-e, NFC-e, CT-e ou MDF-e.