Durante a emissão de notas fiscais, alguns erros podem ocorrer quando os dados do cliente (tomador) estão incompletos, inválidos ou são enviados fora do padrão esperado pela prefeitura.

Neste artigo, reunimos os erros mais comuns relacionados a CPF/CNPJ do tomador para ajudar você a identificar o problema e entender como corrigir.

💡 Em muitos casos, o problema está no cadastro do cliente ou nas informações enviadas pela integração da venda.

Antes de começar a análise

Antes de investigar o erro em si, recomendamos acessar o detalhamento da nota fiscal para visualizar a mensagem completa retornada pela prefeitura.

Você pode utilizar este artigo como apoio para localizar e interpretar os erros da emissão:

• Como identificar o motivo de erro nas notas fiscais

Além disso, se a venda não possuir CPF do cliente, veja também:

• Venda não possui CPF do cliente

Quais erros podem aparecer?

1. CPF/CNPJ não informado

Exemplos de erros:

E118-Nome/Razão Social e CPF/CNPJ do tomador do serviço não informado

E118-Nome/Razão Social e CPF/CNPJ do tomador do serviço não informado

E118-Nome/Razão Social e CPF/CNPJ do tomador do serviço não informado

The element 'toma' has invalid child element 'xNome'. Expected: 'CNPJ, CPF, NIF, cNaoNIF'

The element 'toma' has invalid child element 'xNome'. Expected: 'CNPJ, CPF, NIF, cNaoNIF'

The element 'toma' has invalid child element 'xNome'. Expected: 'CNPJ, CPF, NIF, cNaoNIF'

O que significa?

A prefeitura recebeu apenas o nome do cliente (xNome), mas o CPF ou CNPJ não foi enviado no XML da nota fiscal.

O que investigar

• O cliente possui CPF/CNPJ cadastrado?

• O documento está preenchido na plataforma de vendas?

• A integração enviou corretamente os dados do comprador?

• O documento foi removido ou alterado após a venda?

Como solucionar

• Preencha o CPF ou CNPJ no cadastro do cliente;

• Atualize os dados da venda;

• Reprocesse a emissão da nota fiscal.

2. CPF/CNPJ inválido

Exemplos de erros:

E155-CNPJ/CPF do tomador do serviço 

E155-CNPJ/CPF do tomador do serviço 

E155-CNPJ/CPF do tomador do serviço 

E0188-CNPJ do tomador informado na DPS é inválido

E0188-CNPJ do tomador informado na DPS é inválido

E0188-CNPJ do tomador informado na DPS é inválido

O que significa?

O documento foi enviado, mas não passou na validação da prefeitura.

Isso pode acontecer quando:

• o CPF/CNPJ possui quantidade incorreta de dígitos;

• existem letras ou caracteres especiais;

• o documento é inexistente;

• o número foi digitado incorretamente;

• o cliente é estrangeiro e foi enviado um identificador inválido.

Atenção para clientes estrangeiros

Quando o cliente é estrangeiro, em muitos municípios o documento não deve ser enviado como CPF/CNPJ.

Nesses casos, normalmente é necessário utilizar um identificador estrangeiro, como:

• NIF;

• documento internacional;

• ou código de não contribuinte estrangeiro, dependendo do padrão aceito pela prefeitura.

Se um cliente estrangeiro for enviado utilizando um CPF/CNPJ inválido ou preenchido de forma incorreta, a prefeitura poderá rejeitar a nota com erros de validação do tomador.

O que investigar

Confira se o documento:

• possui 11 dígitos (CPF) ou 14 dígitos (CNPJ), quando aplicável;

• contém apenas números;

• pertence realmente ao cliente;

• está válido na Receita Federal;

• ou, em caso de cliente estrangeiro, se o identificador internacional está sendo enviado corretamente.

Como solucionar

• Corrija o CPF/CNPJ no cadastro do cliente;

• Para clientes estrangeiros, valide qual identificador deve ser utilizado;

• Atualize os dados da venda;

• Solicite novo processamento da nota

Outros erros que podem aparecer junto

Em alguns cenários, o erro de CPF/CNPJ pode vir acompanhado de outras rejeições no XML da nota fiscal, como por exemplo:

The 'tpMoeda' element is invalid - The value 'BRL' is invalid

The 'tpMoeda' element is invalid - The value 'BRL' is invalid

The 'tpMoeda' element is invalid - The value 'BRL' is invalid

Boas práticas para evitar esses erros

Antes de emitir notas fiscais, recomendamos:

• manter CPF/CNPJ dos clientes sempre preenchidos;

• validar documentos recebidos pelas integrações;

• evitar caracteres especiais nos campos de documento;

• realizar uma emissão de teste após configurar uma nova integração.

💡 A ausência ou invalidação do CPF/CNPJ é uma das causas mais comuns de rejeição de notas fiscais.

Para validar sua configuração, você também pode utilizar este guia:

• Como emitir uma nota fiscal de teste na Zuppy

Ainda com dúvidas?

Se o erro persistir após as validações, entre em contato com o suporte da Zuppy enviando:

• ID da venda;

• mensagem completa do erro;

• CPF/CNPJ utilizado na venda;

• XML da nota fiscal (se disponível);

• e prints do cadastro do cliente na plataforma de vendas.