# E0223: tomador no exterior sem NIF na NFS-e

> Entenda o erro E0223 da NFS-e: tomador domiciliado no exterior precisa de NIF ou do motivo de não tê-lo. Veja como completar o cadastro.

- Artigo: https://maisgestao.com.br/base-de-conhecimento/erro-e0223-nfse-tomador-no-exterior-sem-nif
- Categoria: Erros de NFS-e
- Atualizado em: 2026-11-01
- Verificado em: 2026-10-31
- Alterações conferidas em: 2026-11-01
- Disponível em: Emissão de NFS-e pelo Padrão Nacional incluída nos planos Básico, Essencial, Profissional e Corporativo.
- Permissões: fiscal_rps.view, fiscal_rps.emit, clients.update
- Antes de usar: Certificado A1 do emitente, configuração fiscal e categoria habilitada para NFS-e. As permissões de configuração ou cadastro se aplicam quando a correção exigir alterar esses dados; peça ajuda a um administrador se faltar acesso. Confirme município, competência e enquadramento da operação com a contabilidade.
- Fonte: base de conhecimento do Mais Gestão, sistema de gestão financeira para empresas de serviço.

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

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 é:

```text
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 é:

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

## Como resolver no Mais Gestão

1. Em **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. Abra 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. Confira 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. Volte à 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.](https://maisgestao.com.br/base-de-conhecimento/images/2026-11-01-qa/cliente-exterior-nif-vinculo.png)

*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](https://maisgestao.com.br/funcionalidades/sistema-emissor-de-nota-fiscal-de-servico) 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](https://maisgestao.com.br/base-de-conhecimento/cadastrar-cliente).

## Códigos relacionados ao tomador no exterior

- [E0226](https://maisgestao.com.br/base-de-conhecimento/erros-nfse#e0226): motivo 0 para a falta do NIF não é aceito no Sistema Nacional.
- [E0242](https://maisgestao.com.br/base-de-conhecimento/erros-nfse#e0242): tomador com NIF exige o endereço no exterior.
- [E0246](https://maisgestao.com.br/base-de-conhecimento/erros-nfse#e0246): país inexistente ou igual a Brasil no endereço no exterior, conferido também antes do envio.
- [E0190 e E0207](https://maisgestao.com.br/base-de-conhecimento/erro-e0190-e0207-nfse-tomador-nao-encontrado-na-receita): 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](https://wa.me/553121802122)

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.

**Fonte oficial:** [Anexo I — Sistema Nacional NFS-e](https://www.gov.br/nfse/pt-br/biblioteca/documentacao-tecnica/documentacao-atual), versão 1.01, de 2026-02-09.

## Artigos relacionados

- [Nota fiscal com Erro na emissão: como ler o motivo](https://maisgestao.com.br/base-de-conhecimento/erro-na-emissao-nfse-como-ler-o-motivo)
- [E0190 e E0207: tomador não encontrado no cadastro federal](https://maisgestao.com.br/base-de-conhecimento/erro-e0190-e0207-nfse-tomador-nao-encontrado-na-receita)
- [Cadastrar um cliente](https://maisgestao.com.br/base-de-conhecimento/cadastrar-cliente)