Telefone do recebedor na NF-e: formato de entrega/fone

entrega/fone é o telefone do recebedor no local de entrega. O campo G13 é opcional, com ocorrência 0–1, e aceita de 6 a 14 algarismos. O MOC orienta usar DDD mais número do telefone; nas operações com exterior, permite código do país mais código da localidade e número. MOC, Grupo G, página 16.

O contato deve pertencer à entrega

Obtenha o número no pedido ou cadastro do recebedor associado ao endereço de entrega. Se a entrega é em um local diferente da sede do destinatário, o telefone geral da sede não deve ser copiado automaticamente. Confira quem atende naquele local e se o número inclui os códigos necessários.

dest/enderDest/fone pertence ao endereço do destinatário e retirada/fone ao ponto de retirada. O telefone de uma transportadora também tem finalidade própria. A tag entrega/fone não muda a identidade de dest e não substitui logradouro, número ou município: contato e localização são informações complementares.

Como transformar a máscara sem alterar o número

No XML só cabem algarismos. Espaços, parênteses, hífen, sinal +, rótulos e ramais escritos com letras não atendem ao padrão [0-9]{6,14} do campo. O limite é do conteúdo total, incluindo os códigos presentes. Trate o telefone como texto, não como valor numérico para cálculo. Schemas oficiais, TLocal/fone.

Exemplo sintético nacional, sem comprovar linha existente: se a origem documenta (41) 3333-4444, a representação sem máscara é 4133334444, com dez algarismos. Os dois iniciais são o DDD e os demais representam o telefone nesse exemplo.

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

O fragmento é parcial em relação a entrega e à NF-e, somente para localização, e não está pronto para transmissão. O XPath é /nfeProc/NFe/infNFe/entrega/fone. Na sequência do grupo, fone vem após xPais quando o país textual está presente e antes de email quando esse contato está presente.

Não acrescente um nono dígito, DDD ou código internacional por suposição. Retirar máscara de um número confirmado é diferente de mudar sua composição. Se faltou o DDD na origem, peça apenas esse código; um telefone conhecido sem o código de área não permite inferi-lo a partir de outro contato do cliente.

Número no exterior e diferença de cPais

Em cenário exterior documentado, o MOC permite reunir código do país, código da localidade e número do telefone. Exemplo apenas sintético de composição: país telefônico 1, localidade 212 e número 5550100 formam 12125550100, com onze algarismos. O sinal + usado na exibição não integra a tag. Esse exemplo não confirma que a linha exista ou pertença a um recebedor.

O código telefônico do país não é entrega/cPais: esse outro campo usa a tabela de países BACEN da NF-e. Não envie o código BACEN como prefixo de telefone, nem um DDI como código fiscal do país. A permissão para composição internacional não significa que todo contato nacional deva receber código de país indiscriminadamente.

Opcional não é telefone fictício

Se não houver contato confirmado aplicável, a estrutura permite omitir fone. Uma tag vazia não satisfaz os 6–14 dígitos, e uma sequência de zeros não representa um número conhecido apenas por atender ao tamanho. Também não concatene dois telefones para caber em uma tag: existe uma ocorrência e um limite para o conteúdo total.

O XSD não verifica se o número funciona, sua titularidade ou a capacidade de receber mensagens. Ter um número com onze dígitos não comprova contato útil nem aciona ligação, SMS ou mensagem automaticamente. O funcionamento de comunicação depende do serviço da aplicação, separado do registro no XML.

Como investigar telefone errado ou falha de schema

Compare o pedido, o cadastro selecionado e o valor bruto gerado em entrega/fone. Para falha estrutural, procure máscara remanescente, +, extensão com letras, conteúdo vazio, quantidade fora de 6–14, ordem ou namespace. Para contato errado, procure cópia do endereço da sede, número antigo ou transformação que acrescentou ou retirou códigos.

Corrija somente a origem comprovadamente equivocada e gere uma prévia pelo emissor. Confira a sequência integral do contato e sua ligação com o recebedor. Não edite XML assinado ou autorizado, não invente contato e não presuma uma rejeição fiscal específica apenas por haver erro no telefone. O campo não determina tratamento tributário da operação.

O e-mail do recebedor complementa o contato; o grupo entrega explica a condição de endereço diferente.