NFS-e | Como resolver a Exception: Valor inválido para o campo CpfCnpjTomador

A Exception abaixo ocorre quando o produto não consegue gerar a identificação do tomador no formato esperado:

Erro ao montar notas - Exception: Valor inválido para o campo CpfCnpjTomador

Antes de corrigir o arquivo, identifique se a emissão possui tomador nacional, tomador estrangeiro ou se deve ser realizada sem identificação do tomador. Cada cenário exige um preenchimento diferente.

Tomador nacional

Informe um CPF com 11 dígitos ou um CNPJ com 14 dígitos, somente números. O campo não deve ser enviado como null, vazio ou com máscara.

PlugNotas

{
  "tomador": {
    "cpfCnpj": "<CPF_COM_11_DIGITOS>",
    "razaoSocial": "Tomador Teste"
  }
}

Manager SaaS

CpfCnpjTomador=<CPF_COM_11_DIGITOS>
RazaoSocialTomador=Tomador Teste

Tomador estrangeiro

Não basta retirar o CPF ou CNPJ. Nos padrões municipais que utilizam a identificação genérica de exterior, também devem ser enviados os demais campos que caracterizam o tomador estrangeiro.

PlugNotas - exemplo para padrão municipal

{
  "tomador": {
    "cpfCnpj": "99999999999",
    "codigoEstrangeiro": "NIF_DO_TOMADOR",
    "razaoSocial": "Tomador Exterior",
    "endereco": {
      "codigoCidade": "9999999",
      "codigoPais": "2496",
      "descricaoPais": "ESTADOS UNIDOS",
      "estado": "EX",
      "cep": "99999999",
      "logradouro": "Endereco no exterior",
      "numero": "SN",
      "bairro": "Exterior"
    }
  }
}

Manager SaaS

CpfCnpjTomador=99999999999
DocTomadorEstrangeiro=NIF_DO_TOMADOR
RazaoSocialTomador=Tomador Exterior
CodigoCidadeTomador=9999999
UfTomador=EX
CepTomador=99999999
PaisTomador=2496

Na NFS-e Nacional, informe codigoEstrangeiro quando houver NIF ou naoNif quando ele não existir, além do endereço e das informações de comércio exterior exigidas para a operação.

Consulte também: Tomador estrangeiro na NFS-e/NFS-e Nacional.

Nota sem identificação do tomador

Não utilize 99999999999 apenas para contornar a Exception. Esse preenchimento pode fazer o envio ser tratado como tomador estrangeiro.

Quando o município e o padrão aceitarem emissão sem tomador, no PlugNotas remova o nó tomador por completo, em vez de enviá-lo com cpfCnpj: null e os demais campos vazios. No Manager SaaS, mantenha os campos do tomador vazios somente quando a documentação do padrão permitir.

Se o erro continuar

Confirme o município e o padrão utilizados. Alguns padrões exigem a identificação do tomador ou possuem regras próprias para tomador estrangeiro e tomador não identificado. Encaminhe ao suporte o JSON ou TX2 utilizado e a mensagem completa do retorno para validação.

Importante: os valores apresentados são exemplos e devem ser adaptados à operação. A obrigatoriedade e o formato de alguns campos podem variar conforme o município e o padrão de NFS-e.