fone da retirada na NF-e: DDD, número e formato internacional

retirada/fone registra o telefone do expedidor no local de retirada. É opcional e admite uma sequência de 6 a 14 dígitos. Para o contexto nacional, o MOC orienta código DDD mais número; nas operações com exterior, permite código do país, código da localidade e número. Máscaras, sinal de mais, parênteses e hífen não fazem parte da sequência numérica. MOC 7.0, F13, p. 16.

Telefone de quem e obtido de onde

O contato deve ser o do expedidor/local de saída física selecionado na operação. Um número da central do cliente ou do motorista pode servir a outro fluxo, mas não é automaticamente o telefone do expedidor. Confira a identidade e o endereço do local antes de reutilizar contatos.

O grupo retirada é destinado a endereço diferente do remetente, conforme o MOC. Ter um telefone cadastrado não exige criar um grupo que não corresponde à operação. O formato do telefone também não decide quem é expedidor ou responsável fiscal na movimentação.

Na NFC-e ou NF-e com DANFE Simplificado Tipo 2 (tpImp=6), F01-10/669 da NT 2026.002 v1.10a restringe a presença do grupo de retirada. A linha que inclui a regra tem teste 01/07/2026 e produção 03/08/2026. Ao investigar uma nota, confira modelo, ambiente e autorizador; um telefone bem formatado não elimina uma presença indevida do grupo.

O que incluir na sequência de dígitos

O tipo de TLocal/fone no pacote anterior 010c v1.30 usa padrão [0-9]{6,14}. É uma faixa estrutural, não uma promessa de que qualquer número com esse comprimento exista ou seja discável. Não aplique uma exigência fixa de telefone móvel a toda retirada: o MOC descreve telefone, sem tornar o campo exclusivamente celular.

O telefone da tabela é sintético, sem promessa de linha existente e sem convite para discagem. “Somente dígitos” não é uma licença para juntar ramal, prefixo de operadora ou qualquer código recebido pelo cadastro: esses componentes precisam ser distinguidos antes da serialização.

No contexto exterior, não copie cPais para formar o início do telefone. cPais pertence à tabela BACEN da NF-e; o código telefônico internacional pertence a outro domínio. O nome do país ou sua sigla ISO também não é um DDI.

Exemplo parcial de leitura do telefone

No arquivo processado, o caminho é /nfeProc/NFe/infNFe/retirada/fone. O telefone vem depois de xPais e antes de email, quando esses elementos opcionais estiverem presentes. Ele é filho direto de retirada, sem um grupo adicional de contato ou endereço.

Fragmento sintético e parcial, limitado ao telefone. Os campos obrigatórios foram omitidos; não é uma nota ou grupo completo para transmissão:

<retirada xmlns="http://www.portalfiscal.inf.br/nfe">
  <!-- Identificação e endereço foram omitidos. -->
  <fone>4130000000</fone>
</retirada>

O exemplo tem 10 dígitos, representando DDD 41 seguido do número fictício. Não demonstra autorização, vínculo com um expedidor ou funcionamento da linha. O namespace deve ser considerado em consultas XPath; buscar apenas fone pode recuperar o telefone de outro participante da nota.

Qual é a diferença para fone do destinatário e do responsável técnico

dest/enderDest/fone é parte do endereço do destinatário. entrega/fone pertence ao contato do local de entrega. infRespTec/fone é o contato do responsável técnico pelo sistema de emissão. retirada/fone é o contato do expedidor na origem física.

Mesmo quando alguns formatos numéricos coincidem, a origem e a responsabilidade desses dados não coincidem automaticamente. Uma rotina de integração deve saber qual participante está preenchendo. Compartilhar um componente de telefone não justifica compartilhar um único valor entre todos os caminhos.

Informar esse telefone também não inicia ligação, mensagem ou notificação. Não se pode concluir que um usuário recebeu SMS ou que um canal de atendimento está ativo apenas porque o XML contém a tag.

Como diagnosticar máscara, comprimento e número errado

Compare cadastro do local, contato selecionado e prévia XML. Parênteses, espaços, hífen ou sinal de mais enviados literalmente contrariam o padrão numérico. Uma sequência curta pode ter perdido DDD; uma longa pode conter ramal ou códigos concatenados. Essas são hipóteses a confirmar na origem, não motivos para cortar dígitos até caber.

Se a prévia tem telefone do cliente em vez do expedidor, investigue a seleção de participante e o mapeamento. Se a origem já contém um contato desatualizado, confirme o número com o expedidor antes de corrigir. Não complete telefone desconhecido com zeros nem afirme validade só porque o comprimento está no intervalo.

Para falha de schema, confira também ordem das tags, namespace e a presença de um campo opcional vazio. Não atribua uma rejeição exclusiva de telefone sem comprovação no retorno. A rejeição 669 é do grupo/modelo; trocar o número não muda essa condição.

Depois de corrigir a causa comprovada, confira a representação em nova prévia. Não edite XML assinado, não faça contato de teste com terceiros e não retransmita a nota por tentativa. Para os outros dados de contato, veja e-mail da retirada e nome do expedidor.