Campos de Autenticação para Empresas que Emitem Nota Fiscal de Serviço

Para algumas prefeituras, pode ser necessário informar campos extras de autenticação para que a emissão seja possível. Abaixo segue uma descrição desses campos e como eles devem ser preenchidos.

Requisitos

• Ter uma empresa cadastrada (acesse Cadastrar uma empresa)
• Prefeituras que exijam algum tipo de informação além do certificado para autenticação no webservice de emissão de nota (acesse lista de prefeituras para averiguar se sua prefeitura não é atendida por certificado digital)

Tipos de Autenticação para Emissão de Nota Fiscal

Normalmente, quando uma empresa emite uma nota fiscal, a autenticação é feita por meio de um certificado digital válido. Para atender esse cenário, por padrão, é definida na NFE.io essa opção de autenticação, descrita em Upload do Certificado Digital.

Contudo, algumas prefeituras exigem informações adicionais além do certificado digital para a emissão de notas via Webservice. Isso pode incluir:

• Uma senha
• Uma combinação de usuário e senha
• Uma chave de autorização

Para atender cenários onde esse tipo de autenticação é necessária, a NFE.io disponibiliza alguns campos para que a emissão consiga ser feita. Eles são as seguintes opções:

• "Usuário de acesso ao Webservice"
• "Senha de acesso ao Webservice"
• "Identificação de autorização fiscal"

Pela definição do nome, a descrição desses campos é autoexplicativa na forma como devem ser preenchidos. Contudo, para algumas particularidades de prefeituras, esses campos podem possuir outros significados.

Por fim, como ressaltado nos Requisitos no início do documento, essa opção só estará disponível para preenchimento quando a sua prefeitura requer esse tipo de dado. Caso a autenticação seja feita por meio de certificado, não é preciso se preocupar com esse tipo de informação.

No link já disponibilizado, é possível visualizar todas as prefeituras que estão integradas com a NFE.io e os tipos de autenticação necessários para cada prefeitura. Para aquelas em que esse tipo de informação é necessária, verifique todas aquelas prefeituras cuja coluna Column1.webService.authenticationMethod está preenchida com a informação UserAndPassword.

Como Preencher os Campos de Autenticação

Nos casos em que a prefeitura exija os campos extras de autenticação, na plataforma da NFE.io essas opções estarão disponíveis para preenchimento na opção de Dados Fiscais, como mostrado abaixo:

Essas opções estarão disponíveis após serem preenchidas as opções descritas como Dados básicos da empresa no cadastro de uma nova empresa para emissão.

No caso do uso da API, abaixo segue o trecho de JSON de como esses campos estão disponíveis:

{ 
  "fiscalStatus": "Active",
  "loginName": "string", // Usuário de acesso ao Webservice
  "loginPassword": "string", // Senha de acesso ao Webservice
  "authIssueValue": "string", // Identificação de autorização fiscal
  "certificate": { ... }
}```

No json comples eles estão disponíveis da seguinte forma:

```json
{
  "companies": {
    "id": "string",
    "name": "string",
    "tradeName": "string",
    "federalTaxNumber": 0,
    "email": "string",
    "address": {
      "country": "string",
      "postalCode": "string",
      "street": "string",
      "number": "string",
      "additionalInformation": "string",
      "district": "string",
      "city": {
        "code": "string",
        "name": "string"
      },
      "state": "string"
    },
    "openningDate": "2024-10-28T16:31:41.583Z",
    "taxRegime": "Isento",
    "specialTaxRegime": "Automatico",
    "legalNature": "EmpresaPublica",
    "economicActivities": [
      {
        "type": "Main",
        "code": 0
      }
    ],
    "companyRegistryNumber": 0,
    "regionalTaxNumber": 0,
    "municipalTaxNumber": "string",
    "rpsSerialNumber": "string",
    "rpsNumber": 0,
    "issRate": 0,
    "environment": "Development",
    "fiscalStatus": "CityNotSupported",
    "federalTaxDetermination": "NotInformed",
    "municipalTaxDetermination": "NotInformed",
    "loginName": "string",
    "loginPassword": "string",
    "authIssueValue": "string",
    "certificate": {
      "thumbprint": "string",
      "modifiedOn": "2024-10-28T16:31:41.583Z",
      "expiresOn": "2024-10-28T16:31:41.583Z",
      "status": "Overdue"
    },
    "createdOn": "2024-10-28T16:31:41.583Z",
    "modifiedOn": "2024-10-28T16:31:41.583Z"
  }
}

Caso tenha alguma dúvida, entre em contato consco em suporte@nfe.io.