Cadastre as credenciais de acesso na prefeitura e o certificado digital utilizado na comunicação e emissão de nota fiscal de serviço
Quais são os requisitos para a utilização desta API?
- Token: Ter um token de acesso válido é essencial. Caso ainda não tenha gerado um, temos um guia detalhado disponível no tópico Fluxos de Autorização e Autenticação.
- Certificado: possuir certificado digital A1 (e-CNPJ) diretamente relacionado ao CNPJ da conta Cora.
A maioria das prefeituras adota o certificado digital A1 como único requisito de autenticação para a emissão de notas fiscais de serviço. No entanto, existem variações nas exigências dependendo do município. Algumas prefeituras requerem adicionalmente o fornecimento de login e senha, que podem ser os mesmos utilizados para acessar o portal da prefeitura ou ser credenciais específicas para a integração via API.
É importante notar que as combinações de requisitos de autenticação variam: algumas prefeituras solicitam o certificado digital juntamente com uma senha, enquanto outras podem requerer o preenchimento dos três dados – certificado, login e senha – para permitir a emissão. As especificações de cada prefeitura devem ser consultadas para garantir a conformidade com os requisitos locais.
Parâmetros da requisição
A tabela a seguir lista os parâmetros de requisição no header necessários para o upload
Parâmetro | Tipo | Descrição |
|---|---|---|
file obrigatório | Arquivo .pem | Certificado digital A1 no formato .pem, utilizado para emissão de nota fiscal |
certificate_password\ obrigatório | String | Senha PIN ou código numérico que deve ser fornecido para acessar o certificado e realizar operações de emissão de NF |
login\ opcional | String | Campo utilizado para inserir o identificador do usuário para autenticação. Este login pode ser o mesmo utilizado no portal da prefeitura ou uma identificação específica fornecida para acesso à integração via API. Pode se tornar obrigatório, dependendo dos requisitos da prefeitura |
senha\ opcional | String | Campo para a senha associada a autenticação do usuário. A senha pode ser a mesma utilizada para acessar o portal da prefeitura ou pode ser uma senha específica para a integração via API.Pode se tornar obrigatória, dependendo dos requisitos da prefeitura |