fone de avulsa: telefone do Fisco, DDD e formato XML

avulsa/fone registra o telefone ligado ao Fisco emitente da nota avulsa. Seu caminho é /nfeProc/NFe/infNFe/avulsa/fone. O campo D06 é opcional, com uma ocorrência no máximo. O MOC orienta DDD seguido do número; o XSD admite de 6 a 14 algarismos, sem máscara. Esse telefone não é o contato do remetente em emit/enderEmit/fone nem o do destinatário. MOC 7.0, D06 p. 13; schemas oficiais 010d v1.03, avulsa/fone.

De onde vem o contato?

Confira o dado administrativo fornecido pelo serviço fiscal que emitiu a nota. O grupo avulsa reúne órgão, agente, UF e repartição; o telefone pertence a esse contexto. Não o preencha com o número comercial da empresa, com o telefone do comprador ou com um contato encontrado sem vínculo com o órgão responsável. Na avulsa, o remetente continua identificado em emit. MOC, C02 p. 12 e D01–D07 p. 13.

A identificação do agente aparece em matr e xAgente; o nome do órgão, em xOrgao; a repartição, em repEmi. O telefone não substitui nenhum desses dados e não serve como prova da identidade do agente ou da autenticidade da nota. A conferência do documento exige sua consulta e os registros correspondentes, não apenas o reconhecimento de um contato.

Máscara na apresentação, algarismos no XML

Um contato fictício apresentado como (41) 3000-0000 fica representado como 4130000000, preservando DDD e número. Parênteses, hífen, espaços e sinal de mais não fazem parte do padrão [0-9]{6,14}. O limite técnico não é autorização para retirar algarismos de um contato real só para fazê-lo caber. Schemas oficiais, restrição de avulsa/fone.

O MOC descreve DDD e número para este campo. Uma orientação sobre código de país em telefone de outro grupo não deve ser transplantada automaticamente: confirme o caminho, o tipo e a origem do dado antes de utilizar uma regra de tratamento de telefone compartilhada pela integração.

O exemplo é parcial e sintético. O contato não é apresentado como telefone real de órgão público. Os demais campos de avulsa foram omitidos; não está pronto para transmissão.

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

No grupo completo, fone aparece depois de xAgente e antes de UF. Se não houver contato disponível nesse campo, a estrutura admite sua omissão. Uma tag vazia não é a mesma coisa que omitir o elemento, porque o padrão exige de 6 a 14 algarismos quando a tag existe. Schemas oficiais, sequência de avulsa.

Como investigar telefone inválido ou de outra parte

Localize avulsa/fone no XML original. Se o leitor da integração devolve um telefone de empresa ou cliente, confira se a extração selecionou o primeiro fone do documento em vez do XPath correto. Se o valor contém máscara, investigue a serialização. Se tem menos de seis ou mais de 14 algarismos, compare com o dado administrativo original antes de decidir como representá-lo.

Um telefone com formato aceito pode estar desatualizado ou ser de outra unidade; o XSD não verifica sua titularidade, disponibilidade ou atendimento. A conferência precisa combinar origem oficial do contato, órgão, repartição e documento examinado. Não invente número, não use uma sequência de zeros como substituto de informação desconhecida e não atribua ao telefone uma rejeição documentada para outro grupo.

Se a divergência está no XML fornecido pelo serviço fiscal, encaminhe a conferência dos dados administrativos a esse serviço com a identificação da nota. Se está no extrator ou mapeamento, corrija o caminho comprovadamente errado e compare a leitura resultante com o arquivo original. Preserve o XML assinado; não altere uma nota existente para atualizar um contato.

O campo não determina regime, tributação ou obrigação de arrecadação. Para conferir a pessoa responsável pela emissão, veja nome do agente do Fisco e repartição fiscal.