Mais Gestão
Ir para o artigo

Comece por aqui

    Carregando os artigos…

    Carregando os artigos…

    E0223: tomador no exterior sem NIF na NFS-e

    Atualizado em 5 min de leitura

    Texto pronto para a sua IA

    O navegador não permitiu a cópia automática. Copie o texto selecionado (Ctrl+C ou ⌘C) e cole na conversa com a IA. Se preferir, use “Ver em Markdown”.

    Ver em Markdown (abre em nova aba)Perguntar ao ChatGPT (abre em nova aba)Perguntar ao Claude (abre em nova aba)

    Verificado em · Alterações conferidas em

    Código E0223 do Sistema Nacional NFS-e (leiaute 1.01). Sistemas municipais no padrão ABRASF usam outra numeração.

    Nesta página

    O erro E0223 da NFS-e significa que o tomador tem endereço no exterior, mas a nota não informa o NIF (número de identificação fiscal no país dele) nem o motivo de não haver NIF. Para resolver, preencha o NIF ou o motivo no cadastro do cliente.

    Mensagem do erro E0223 na NFS-e

    O Mais Gestão confere o E0223 antes de enviar. Nesse caso, a mensagem é:

    Recusada antes do envio ao governo: o tomador e domiciliado no exterior e o cadastro nao tem NIF nem o motivo de nao have-lo (fiscal_rps_takers.nif / require_nif). O leiaute exige um dos dois no xs:choice de TCInfoPessoa, e o grupo endExt so e aceito com ele.

    Fonte: Mais Gestão, conferência antes do envio

    Se o governo devolver o código, o texto é:

    Rejeitada por regra do governo: DPS rejeitada pelo SEFIN: E0223: O NIF ou cNaoNIF do tomador deve ser informado quando o grupo de informações de endereço no exterior do tomador de serviços foi informado.

    Fonte: Anexo I v1.01 do Sistema Nacional NFS-e

    O E0223 trata só da falta de NIF. Endereço no exterior incompleto e país fora do padrão aparecem com códigos próprios do Mais Gestão, MG-NFSE-ENDERECO-EXTERIOR e MG-NFSE-PAIS-TOMADOR, explicados abaixo. Uma nota antiga recusada nesses dois casos pode mostrar E0223 até ser emitida de novo.

    Por que o E0223 acontece: endereço no exterior sem NIF

    • O cliente estrangeiro foi cadastrado sem NIF e sem o motivo da falta dele.
    • O NIF existe, mas não foi informado no cadastro.
    • Um cliente do Brasil foi marcado como domiciliado no exterior por engano.

    A regra vale quando a DPS tem o grupo de endereço no exterior (toma/end/endExt). Nesse caso, toma/NIF ou toma/cNaoNIF precisa ser informado.

    NIF ou motivo da ausência: como corrigir o E0223 em qualquer emissor

    1. 1Peça ao cliente o número de identificação fiscal do país dele.
    2. 2Sem NIF, informe o motivo: dispensado do NIF ou o país não exige NIF.
    3. 3Não use o motivo 0, não informado na nota de origem: o Sistema Nacional o recusa pelo E0226.
    4. 4Confirme se o cliente é mesmo do exterior. Cliente do Brasil vai com CPF ou CNPJ.

    Como resolver no Mais Gestão

    1. 1Em Financeiro > Contas a receber, localize a conta e abra Mais ações > Nota fiscal (em conta já recebida, use Visualizar). Clique em Ver erro completo para ler o código e a mensagem.
    2. 2Abra o cadastro do cliente. Com Domiciliado no exterior em Sim, preencha o NIF. Sem NIF, escolha o motivo em Se não houver NIF: Dispensado do NIF ou O país não exige NIF. Salve.
    3. 3Confira o endereço no exterior: País, Código postal (Zip code), Estado/Província ou Região, Cidade, Rua, Número e Bairro.
    4. 4Volte à nota e clique em Gerar nova nota. O NIF e o motivo do cadastro valem sobre o campo Requer NIF do formulário. Confira e clique em Gerar nota.
    Cadastro de cliente com Domiciliado no exterior em Sim e o NIF preenchido, além do vínculo com o cliente e do nome.Ampliar imagem (abre em nova aba)
    Cadastro de um cliente do exterior com o NIF preenchido, antes de Salvar. O campo Se não houver NIF só aparece com o NIF vazio.

    Se aparecer MG-NFSE-ENDERECO-EXTERIOR, MG-NFSE-PAIS-TOMADOR ou E0246

    • MG-NFSE-ENDERECO-EXTERIOR: falta um campo do endereço no exterior. A mensagem começa com o endereco no exterior do tomador esta incompleto no cadastro do cliente: falta e lista os campos pelo nome interno: country (País), cep (Código postal), i_city (Cidade), i_state (Estado/Província ou Região), address (Rua), number (Número) e neighborhood (Bairro). Complete-os no cadastro.
    • MG-NFSE-PAIS-TOMADOR: o país está gravado fora do código de duas letras. A mensagem começa com o pais do endereco do tomador esta gravado como. Escolha o país de novo na lista do campo País e salve.
    • E0246: o país do endereço no exterior é Brasil, ZZ ou não existe na tabela de países. O Mais Gestão confere antes do envio, com mensagens como O endereço do cliente do exterior está com o país Brasil. Corrija o país no cadastro do cliente. ou O país do endereço do cliente do exterior "XX" não existe na tabela de países. Corrija o país no cadastro do cliente. Escolha o país na lista do campo País; o cadastro recusa texto livre com Escolha um país da lista.

    Como evitar o E0223 no cadastro do cliente estrangeiro

    Com Domiciliado no exterior em Sim, o cadastro de clientes exige o NIF ou o motivo em Se não houver NIF. Antes de enviar, o emissor de NFS-e do Mais Gestão confere de novo o NIF, o endereço no exterior e o país, que precisa existir na tabela de países. O cadastro está em Cadastrar cliente.

    Códigos relacionados ao tomador no exterior

    • E0226: motivo 0 para a falta do NIF não é aceito no Sistema Nacional.
    • E0242: tomador com NIF exige o endereço no exterior.
    • E0246: país inexistente ou igual a Brasil no endereço no exterior, conferido também antes do envio.
    • E0190 e E0207: documento brasileiro do tomador não encontrado na Receita.

    Perguntas frequentes

    O que é NIF na NFS-e?

    É o número de identificação fiscal do tomador no país dele, usado no lugar do CNPJ ou do CPF.

    Se o erro continuar

    Envie estes dados ao suporte ou à contabilidade:

    • o código do erro, como E0160, quando houver;
    • a mensagem completa, que aparece em Ver erro completo;
    • a competência da nota;
    • o CNPJ do emitente;
    • a conta a receber da nota;
    • a data e o horário da tentativa.
    Falar com o suporte no WhatsApp (abre em nova aba)

    Se não souber se a nota foi emitida, fale com o suporte antes de gerar outra.

    Enquadramento, situação cadastral, município e competência são confirmados com a contabilidade.

    Se faltar acesso à tela de correção, peça ajuda a um administrador da empresa.

    Nunca envie senhas, o certificado digital nem a senha dele.

    Precisa de mais ajuda?

    Fale com o suporte pelo WhatsApp, em dias úteis, das 9h às 17h. Para integrações, consulte a documentação da API REST e do MCP.

    Continue por aqui

    Cookies: usamos os necessários para o site funcionar e, se você permitir, os de análise para melhorar a experiência. Política de cookies