Como adicionar ou substituir o Certificado Digital (A1)?

A importância de se ter um Certificado Digital cadastrado se deve a garantia de integridade, autenticidade e validade jurídica dos documentos fiscais, ajudando a evitar fraudes e garantindo conformidade com a legislação tributária.

Portanto, se for sua primeira vez cadastrando, ou se deseja substituir o certificado, confira como realizá-los na API.

---

Adicionar ou substituir Certificado A1

1. Para começar, faça uma requisição tipo POST ao endpoint de adicionar ou substituir Certificado A1;

   [URL_BASE]/api/empresas/{empresa}/certificado

2. Preencha a seguinte informação (path parameters):

   • {empresa}*: CNPJ da empresa.

3. Preencha os seguintes parâmetros de consulta (query parameters):

   • {senha}*: senha do certificado;
   • {tipoCertificado}*: PKCS12, OUTRO.

4. Encaminhe seu certificado A1 no corpo da requisição (request body).

5. No cabeçalho Content-Type, informe o tipo de conteúdo a ser enviado: multipart/form-data.

6. Informe o x-auth-token no cabeçalho (header parameters) da requisição.

Exemplo de requisição

O exemplo abaixo traz um modelo de requisição preenchido para adicionar ou substituir Certificado A1.

Observação

A requisição contém dados fictícios, somente para demonstração.

curl -L -X POST 'https://rest-teste.oobj.com.br/api/empresas/07385111000102/certificado?senha=oobjrest&tipoCertificado=PKCS12' \
-H 'Content-Type: multipart/form-data' \
-H 'Accept: */*' \
-H 'x-auth-token: eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiI3Yjc2OTg1ZGQ2MTNhOWVlYTFiN2RmZTNiZjRhMTRiZiIsImF1ZCI6IndlYiIsImV4cCI6MTYyOTI5MDcwNiwiaWF0IjoxNjI5Mjg4OTA2fQ.-Dj91d6fBZYcZpy1-zKzohAWd5dgW2CAS5BBfwGilemUYcOVDm8CnrDJHbwsFyixI5ohphy-65fqeobXkimtCg' \
--data-raw ''

Exemplo de retorno

{
    "mensagem": "O certificado esales-2023.pfx foi configurado para a filial 07385111000102.",
    "tempoMedioMs": 0,
    "timestamp": 1682535827054
}

Pronto! Você acaba de adicionar ou substituir seu Certificado A1.