Complemento do local de entrega na NF-e: como usar entrega/xCpl

entrega/xCpl complementa o endereço do local de entrega, por exemplo para distinguir bloco, sala ou galpão dentro do mesmo endereço. O campo G05 é opcional, aparece zero ou uma vez e, quando presente, tem texto de 1 a 60 caracteres. Ele pertence ao local de entrega diferente do endereço do destinatário. MOC, Grupo G, página 16.

Um complemento opcional pode ser relevante para localizar o ponto certo

A opcionalidade é estrutural. Se o pedido documenta uma subdivisão que identifica o ponto de entrega, perder essa informação pode deixar o endereço ambíguo, mesmo quando o XML atende aos filhos obrigatórios. Confira o complemento no cadastro ou pedido do local efetivo e preserve os dados existentes que precisam de revisão.

Imagine dois galpões no mesmo número de rua. O endereço-base é igual, mas Galpao B identifica o local indicado no pedido. Esse complemento não muda o destinatário da nota e não deve ser trocado pelo complemento da sede do comprador.

dest/enderDest/xCpl complementa o endereço do destinatário, retirada/xCpl complementa o ponto de retirada e entrega/xCpl complementa o ponto de entrega. A coincidência do nome da tag não implica coincidência dos locais.

O que vai em cada parte do endereço

xLgr contém o logradouro; nro, o número ou identificação do endereço; xCpl, a informação adicional; xBairro, o bairro. Mover o número para o complemento não dispensa nro, que permanece obrigatório quando entrega existe. Tampouco cabe usar xCpl para despejar informações de município, telefone ou nome do recebedor, que possuem campos próprios.

Exemplo sintético com rua e unidades fictícias, parcial em relação a entrega e à NF-e; não está pronto para transmissão:

<xLgr>Rua de Exemplo</xLgr>
<nro>120</nro>
<xCpl>Galpao B, entrada 2</xCpl>
<xBairro>Vila de Exemplo</xBairro>

O endereço-base está em rua e número, o complemento distingue o galpão e sua entrada, e o bairro continua separado. Os elementos pertencem ao namespace http://www.portalfiscal.inf.br/nfe. O XPath é /nfeProc/NFe/infNFe/entrega/xCpl; na sequência, xCpl aparece entre nro e xBairro. Schema oficial de referência, TLocal.

Ausência, vazio e texto longo

Quando não há complemento aplicável, a estrutura permite omitir a tag. <xCpl/> é diferente: uma tag presente vazia não atende ao mínimo de um caractere. O tipo é TString, sem espaços nas extremidades e com máximo de 60 caracteres. Não use só espaços, nem um marcador fictício para satisfazer o mínimo. Schemas, TLocal/xCpl e TString.

Se o cadastro contém texto acima do limite, confira se ele mistura componentes do endereço ou instruções operacionais. Separe o que tem campo próprio e confirme uma representação do complemento que preserve a localização. Não corte automaticamente a parte final se ela contém a entrada, unidade ou bloco que distingue o ponto de entrega.

Uma observação genérica de logística não substitui a identificação do endereço. O contrato dessa tag é “Complemento”; o formato textual amplo não transforma o campo em canal universal de instruções de entrega.

Como conferir uma divergência

Compare pedido, cadastro de entrega e valor da prévia no XPath correto. Se o complemento existia na origem e desapareceu no XML, procure mapeamento que ignora opcionais, substituição pelo endereço da sede ou truncamento. Se o cadastro não tem complemento, confirme se a origem foi realmente omitida ou se o local não possui essa informação.

Em falha de schema, examine vazio, excesso de caracteres, espaços nas extremidades, ordem e namespace. Não atribua ao complemento rejeições de código de município ou de documento do recebedor: cada retorno exige conferir o campo pertinente.

Corrija somente a origem comprovada e gere uma prévia para verificar o endereço inteiro. Não apague um complemento verdadeiro por ser opcional, não invente subdivisão e não edite XML assinado ou autorizado. O campo não seleciona CFOP, incidência ou outro tratamento tributário.

O número de entrega e o logradouro de entrega detalham o endereço-base.