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 e Componente NFS-e

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 e Componente NFS-e

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

Na NFS-e Nacional, a identificação do tomador estrangeiro segue o leiaute específico do produto. No JSON do PlugNotas, informe codigoEstrangeiro quando houver NIF ou naoNif quando ele não existir. No TX2 do Componente NFS-e Nacional, mantenha CpfCnpjTomador vazio e utilize NifTomador quando houver NIF ou CodigoNifTomador para indicar o motivo de sua ausência. Preencha também o endereço e as informações de comércio exterior aplicáveis à 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 ou no Componente NFS-e, mantenha os campos do tomador vazios somente quando a documentação do padrão permitir.

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.