Padrão NF-Eletrônica – Web Service

Este artigo descreve as particularidades do padrão de Web Service (WS) NF-Eletrônica – Web Service, destacando suas limitações, requisitos obrigatórios e aspectos específicos de integração com a plataforma Invoicy para emissão de NFS-e.

1 – Particularidades

A autenticação no padrão NF-Eletrônica – Web Service é realizada por meio de um processo de obtenção de token junto à prefeitura. Esses dados devem ser utilizados nas chamadas subsequentes para emissão de NFS-e e demais métodos.
Para acessar os dados do token, siga:

Acesse o portal do padrão NF-Eletrônica por meio do link https://www.nf-eletronica.com.br/info_contrib/index.asp

Preencha os campos de Município, Login, Senha e clique em Entrar

No menu lateral, no grupo Web Service, clique em Gerar Token

Os tokens de token_nick e token_pass serão exibidos

Esses dados devem ser inseridos no InvoiCy, na tela de Configurações para Emissão de NFS-e.
No campo “Usuário de autenticação” deve ser informado o “token_nick” e no campo “Senha de autenticação” deve ser informado o “token_pass” obtido no portal da NF-Eletrônica.

A ausência do token impede a comunicação com a API e, consequentemente, a emissão das notas.

Requisitos e Limitações do Padrão

2 – Retorno de Erro
O padrão em questão não retorna mensagens de erro claras ou descritivas sobre os problemas encontrados no XML enviado. Abaixo, seguem alguns exemplos de erros comuns e suas possíveis causas:
• -1:
Possível causa: O campo CNPJ do Tomador está ausente ou foi preenchido com um valor inválido.
Possível causa: O campo de item do serviço foi preenchido com um valor inválido.
• ‘spWS_Qual_Municipio’ expects parameter ‘@cMun’:
Possível causa: O código do município não foi informado ou está incorreto.
• Object reference not set to an instance of an object
Possível causa: Tag de grupo obrigatório não está sendo enviada com a estrutura incorreta.
Exemplo: enviar a tag de grupo do Tomador fechada • Token inválido
Possível causa: Tags de e/ou com valores inválidos

• O padrão não disponibiliza ambiente de homologação.

• O padrão exige autenticação com AccessToken obtido previamente via login com usuário e senha.

• O padrão não disponibiliza o método de Substituição de NFSe.

• Não será criado no XML o bloco com informações referentes ao intermediário

O layout do padrão não disponibiliza campos para informar valores de descontos, deve-se enviar o valor do serviço já descontado.

O padrão não permite o envio da mesma numeração com séries diferentes

O padrão trata como obrigatório o envio do bloco

A tag do Tomador deve conter um CNPJ válido.

A tag do Tomador, deve conter um código de município válido de acordo com a tabela do IBGE.

Exceto as tags e do grupo , as demais tags devem ser enviadas com algum valor ou fechadas.