xCpl do emitente: complemento do endereço na NF-e e NFC-e

xCpl guarda o complemento do endereço do emitente: sala, bloco, apartamento ou outra informação que complete a localização do estabelecimento. O caminho é /nfeProc/NFe/infNFe/emit/enderEmit/xCpl. Ele fica junto do logradouro e do número, mas tem função própria. O MOC identifica esse campo como C08, opcional, com uma ocorrência no máximo e de 1 a 60 caracteres quando informado. MOC 7.0, Grupo C, p. 13.

O endereço tem complemento? Preserve o dado existente

O ponto de partida é o endereço do estabelecimento que aparece em emit. Se a ficha cadastral identifica uma sala ou um bloco, confira se esse detalhe foi levado para xCpl. Não use o complemento do destinatário, do endereço de entrega ou de outro estabelecimento do mesmo grupo empresarial. Na emissão avulsa pelo Fisco, emit contém os dados do remetente; os dados do órgão fiscal ficam em avulsa. MOC, C02 e C05–C08, pp. 12–13.

Omissão e texto vazio são situações diferentes. O XSD permite que a tag não exista. Se existir, a restrição de tamanho mínimo exige conteúdo. Portanto, <xCpl/> não equivale a simplesmente deixar de enviar xCpl. Também não preencha com espaços ou com um traço inventado para cumprir o tamanho. O dado complementar existente deve ser preservado; ausência real de complemento não exige um texto artificial. Schemas oficiais 010d v1.03, TEnderEmi/xCpl e TString.

Separe logradouro, número e complemento

Considere um endereço fictício registrado como “Rua Exemplo, 120, Sala 8”. A separação é:

Nesse exemplo, xCpl resolve a identificação da sala. Ele não supre a falta do logradouro nem do número, que têm elementos próprios e obrigatórios em enderEmit. MOC, C06–C08, pp. 12–13.

Este fragmento é parcial e sintético, com os demais campos de enderEmit omitidos. Não é um endereço completo nem um documento pronto para transmissão:

<enderEmit xmlns="http://www.portalfiscal.inf.br/nfe">
  <xLgr>Rua Exemplo</xLgr>
  <nro>120</nro>
  <xCpl>Sala 8</xCpl>
</enderEmit>

Para um segundo estabelecimento fictício sem complemento, a geração omite a linha de xCpl; não cria uma tag vazia. A posição, quando presente, é depois de nro e antes de xBairro, conforme a sequência do tipo TEnderEmi. Schemas oficiais, TEnderEmi.

Como conferir um problema de complemento

Comece pelo XML efetivamente gerado e pelo cadastro que o alimentou. Localize emit/enderEmit/xCpl e confira quatro pontos: o estabelecimento identificado, o conteúdo real do complemento, o limite de 60 caracteres e a posição na sequência XML. O tipo TString não aceita espaço no início ou no fim, texto composto apenas de espaços ou qualquer caractere arbitrário; seu conjunto de caracteres também é limitado. Não confunda a quantidade de caracteres com o tamanho em bytes do arquivo UTF-8. Schemas oficiais, TString e restrição de xCpl.

Se o cadastro contém “Sala 8” e o XML traz uma sala de outra empresa, investigue a seleção do estabelecimento e o mapeamento. Se o conteúdo termina com espaços, confira a serialização. Se o complemento ultrapassa o limite, revise a origem e a representação com quem mantém o cadastro; cortar automaticamente pode eliminar informação de localização. Verifique o resultado em um novo fragmento gerado pelo fluxo de preparação, sem editar o XML assinado de uma nota existente.

Aceitação estrutural não prova a veracidade do endereço nem a autorização fiscal da nota. xCpl também não define CFOP, regime ou incidência de imposto. Eventual efeito tributário do local depende da operação real e deve ser analisado com seus documentos, sem transformar a descrição da sala em uma escolha fiscal.

Para conferir a separação dos dados, veja também logradouro do emitente e endereço do emitente.