Tomador estrangeiro na NFS-e/NFS-e Nacional

Na NFS-e, o envio padrão é feito com todos os dados do tomador sendo informados. Mas quando se tratar de um tomador estrangeiro, é possível compatibilizar o seu JSON de envio de nota para esta emissão. Neste post iremos lhe auxiliar a como montar seu json para emitir para uma NFS-e normal, bem como para a NFS-e Nacional.

Como compatibilizar o JSON de envio de NFS-e no Plugnotas?

Para enviar notas para tomador estrangeiro no Plugnotas, é necessário realizar apenas uma mudança estrutural no JSON no nó do tomador, substituindo o que hoje é um nó completo. Assim, é possível alterar apenas dois campos, pois o restante dos campos serão tratados por nós, na conversão do JSON para XML. 

No restante da estrutura da nota, nada vai ser alterado.

Abaixo, o exemplo de envio de tomador estrangeiro no nó "tomador", utilizando dados simbólicos:

"tomador": {
        "razaoSocial": "Tomador Estrangeiro teste",
        "cpfCnpj": "99999999999",
        "codigoEstrangeiro":"valor_codigo_nif"
        "endereco": {
            "tipoLogradouro": "Rua",
            "logradouro": "AL DOS QUINIMURAS",
            "numero": "187",
            "bairro": "EXTERIOR",
            "codigoCidade": "9999999",
            "descricaoCidade": "EXTERIOR",
            "codigoPais": "2496",
            "descricaoPais": "ESTADOS UNIDOS",
            "estado": "EX"
            "codigoCidade": "9999999",
            "codigoPais": "2496"
        }
    },

O exemplo acima está preenchido com todos os campos de endereço, entretanto a obrigatoriedade pode variar de acordo com cada cidade. Por exemplo, uma cidade pode pedir o logradouro, mesmo sendo exterior, enquanto outras, não há necessidade. Neste caso, a API ou a prefeitura retornará com os campos necessários. Os campos obrigatórios para a API entender que se trata de uma emissão para tomador estrangeiro são estes:

- tomador.endereco.codigoCidade = "9999999"

- tomador.endereco.codigoPais <> "1058"

- tomador.cpfCnpj = "99999999999"

Importante: Em algumas cidades, é solicitado códigos como NIF Tomador, que é um código de identificação estrangeira, que pode ser preenchido no campo codigoEstrangeiro

Como compatibilizar o JSON de envio da NFS-e Nacional no Plugnotas?

Para enviar uma NFS-e Nacional com tomador estrangeiro no Plugnotas, será necessário avaliar:

• Se existe NIF (número identificação fiscal), informar no json tomador.codigoEstrangeiro, dados do endereço e nó servico.infExterior;
• Se não existir NIF (número identificação fiscal), informar no json campo tomador.naoNif , junto com dados do endereço e nó servico.infExterior.

Abaixo, exemplos de como pode ser informado:

Se existir NIF (número de identificação fiscal), informar campos codigoEstrangeiro e infExterior :

"tomador": {
"razaoSocial" : "Teste Exterior",
"codigoEstrangeiro" : "9999",
"endereco": {
"codigoPais": "US",
"descricaoPais": "Estados Unidos",
"cep": "99999999",
"descricaoCidade": "Philadelphia",
"bairro" : "EXTERIOR",
"complemento" : "APTO",
"estado": "EX",
"codigoCidade": "9999999",
"logradouro" : "RUA",
"numero" : "0"
}
},
"servico": [
{
"infExterior": {
"modoPrestacao": 0,
"vinculoPrestacao": 0,
"tipoMoeda": "220",
"valorServicos": 1,
"tipoFomentoPrestador": "00",
"tipoFomentoTomador": "00",
"tipoMovimentacaoBens": 0,
"tipoMDIC": 0
}
}
]
......

Se não existir NIF (número de identificação fiscal), informar no json campo tomador.naoNif , junto com dados do endereço e nó servico.infExterior:

.....
"tomador": {
"razaoSocial" : "Teste Exterior",
"naoNif" : "1",
"endereco": {
"codigoPais": "US",
"descricaoPais": "Estados Unidos",
"cep": "99999999",
"descricaoCidade": "Philadelphia",
"bairro" : "EXTERIOR",
"complemento" : "APTO",
"estado": "EX",
"codigoCidade": "9999999",
"logradouro" : "RUA",
"numero" : "0"
}
},
"servico": [
{
"infExterior": {
"modoPrestacao": 0,
"vinculoPrestacao": 0,
"tipoMoeda": "220",
"valorServicos": 1,
"tipoFomentoPrestador": "00",
"tipoFomentoTomador": "00",
"tipoMovimentacaoBens": 0,
"tipoMDIC": 0
}
}
]
......

Os valores dos campos podem ser visualizados diretamente em nossa documentação oficial, clicando aqui.