Telefone do destinatário na NF-e: formato de enderDest/fone

dest/enderDest/fone registra o telefone de contato do destinatário. O MOC prevê DDD mais número, com conteúdo de 6 a 14 dígitos no XML. O campo ocorre zero ou uma vez e é opcional; informar um telefone não comprova sua existência, titularidade ou disponibilidade para contato.

O caminho é /nfeProc/NFe/infNFe/dest/enderDest/fone, no namespace http://www.portalfiscal.inf.br/nfe. A tag é escrita como fone, com letras minúsculas.

Contato opcional do endereço do destinatário

O telefone pertence a enderDest, dentro de dest, e aparece ao final da sequência de endereço, depois dos campos de país quando presentes. Não é uma tag direta de dest, ao contrário de dest/email.

O dado deve vir do contato confirmado no cadastro ou indicado pelo destinatário. Se não existe telefone a registrar, a estrutura admite ausência da tag. A exigência de endereço em uma NF-e modelo 55 ou em uma NFC-e com entrega a domicílio não torna todos os contatos do grupo obrigatórios. <fone/> não equivale a ausência: quando a tag existe, precisa atender ao conteúdo previsto.

Não use um número inventado para completar o cadastro fiscal. Um telefone conhecido de motorista, recebedor de depósito ou responsável técnico também não deve ser copiado automaticamente para o contato do destinatário. A pessoa ou responsabilidade do contato precisa ser conferida. MOC 7.0, E16, p. 14.

Formato nacional e exterior

No XML, o conteúdo é uma sequência de algarismos. Parênteses, hífen, espaços, sinal de mais, nome do contato e indicação textual de ramal não fazem parte do formato [0-9]{6,14}. A máscara de apresentação deve ser separada da serialização.

Para um contato nacional, a orientação documentada é DDD e número. Nas operações com exterior, o MOC permite informar código do país, código da localidade e número do telefone. A sequência completa ainda precisa caber em 6 a 14 dígitos; não se reduz o telefone cortando posições para passar na validação.

O código de discagem de um país não é o código de cPais. Por exemplo, cPais=1058 representa Brasil na tabela fiscal, não uma sequência a acrescentar ao início de fone. O MOC não orienta adicionar 1058 ao telefone nacional. Confirme os componentes do telefone com a fonte de contato.

Um ramal deve ser distinguido do número externo. Não concatene o ramal indiscriminadamente para obter um telefone diferente; confirme como o contato completo e o canal de comunicação são tratados pela aplicação. O limite XML também não garante que um número de seis posições seja utilizável como contato nacional completo.

Exemplo parcial de serialização

O exemplo é parcial e sintético, exclusivamente de formato. O número é demonstrativo e não deve ser utilizado como contato real ou em uma nota para transmissão:

<fone xmlns="http://www.portalfiscal.inf.br/nfe">4130000000</fone>

Na hipótese do exemplo, a apresentação (41) 3000-0000 é representada pelos dez algarismos 4130000000. Os dois primeiros são o DDD assumido e os oito restantes o número demonstrativo. A forma atende ao tamanho do campo, mas não comprova que exista uma linha correspondente.

Em uma nota, essa tag deve estar dentro de dest/enderDest após os campos de endereço aplicáveis. O fragmento isolado não inclui os campos obrigatórios do grupo nem o restante do documento. Um segundo telefone concatenado ao primeiro não se transforma em um contato válido: pode ultrapassar o limite ou representar uma sequência sem significado.

Diagnóstico: tamanho, origem e titularidade

Se o validador aponta caracteres ou tamanho, compare o contato na origem com o XML enviado. Verifique máscara, espaços, +, texto de ramal e quantidade de dígitos. Confira também se o campo foi inserido no caminho certo e se a integração juntou DDD e número sem eliminar posições.

Se o número foi truncado, identifique onde isso ocorreu: importação, coluna de cadastro, limite do formulário ou serialização. Recupere o telefone confirmado da fonte, em vez de reconstruir dígitos ausentes. Uma conversão automática não deve alterar o contato verdadeiro para atender ao intervalo de tamanho.

Se o telefone tem formato válido mas pertence a outra pessoa, a causa é cadastral ou de seleção. Confronte o destinatário da nota, o cadastro ativo e o contato indicado. emit/enderEmit/fone, entrega/fone, retirada/fone e infRespTec/fone pertencem a outras responsabilidades; o mesmo nome de tag não autoriza transportar o valor.

Se o problema é não conseguir contato, o XSD não resolve a existência ou disponibilidade da linha. Confirme o número com o destinatário e os componentes nacionais ou internacionais apropriados. Preserve o dado real e corrija apenas a origem comprovada. Não edite XML assinado, substitua a identidade fiscal ou retransmita uma nota para testar um telefone.

Campos relacionados

enderDest no contexto do destinatário, email no contexto do destinatário, cPais no contexto do destinatário.