O Que É Apto No Endereço

Endereço na NF-e e no CT-e: preenchendo o campo de apto corretamente

O campo de apto no endereço não é um campo independente na maioria dos sistemas de NF-e e CT-e. Ele está embutido dentro do campo de logradouro ou, em algumas software houses, em um campo separado chamado número complementos. A confusão começa aqui: muita gente acha que existe um campo específico para "apartamento" na estrutura do evento, mas a maioria dos layouts não prevê isso como tag separada. Na prática, o correto é inserir o número do apartamento no campo Nº do logradouro, seguido do complemento entre parênteses ou sem. O padrão da SEFAZ para NF-e 4.00 define a tag enderEmit (para emitente) e enderDest (para destinatário), cada uma contendo os subcampos Lgr, Nro, Compl, etc. Não há tag Apto. Se você está usando um campo dedicado a isso e ele não aparece na documentação oficial do layout, provavelmente está lidando com uma customização da sua software house, não com a norma técnica.

O que é apto no endereço e como funciona na realidade

Na minha experiência, o maior problema que vejo é quando o sistema do emitente exige um campo "Apto" separado e o sistema do destinatário não o reconhece. Já tive um caso em que umaNF-e foi rejeitada porque o campo de complemento do destinatário continha "(Apto 101)" e o sistema da SEFAZ de um estado específico fazia uma validação mais rigorosa contra o CNPJ consultado na base de dados do contribuinte. O endereço cadastral na receita não tinha "Apto 101", tinha apenas o número do imóvel. A rejeição foi C-795, endereço diferente do cadastrado. A solução que funcionou foi simples: remover o "Apto 101" do campo complemento e deixar apenas o número do imóvel no campo Nro, preenchido como "Edifício X, Apto 101". Assim, o número do logradouro permanecia compatível com o cadastro, enquanto a informação do apartamento estava disponível para quem precisa ler. Isso economiza tempo de retorno de dúvidas e evita consultas de homologação intermináveis. O que muita gente não sabe é que o campo de complemento não tem limite rígido de caracteres no layout, mas a SEFAZ pode truncar campos muito longos durante a validação. O recomendado é manter o complemento sob 60 caracteres. Acima disso, o processamento pode falhar silenciosamente em alguns ambientes de homologação, especialmente em CT-e quando o destinatário é transportador e o endereço é usado para calcular distância.

Outro ponto que gera confusão: em CT-e, o campo de destino usa a mesma estrutura de endereço que a NF-e, mas a validação é mais rigorosa porque o valor do frete pode depender da distância exata. Se você colocar "Apto 101" junto com o número na mesma string, alguns sistemas de cálculo de frete tratam isso como um CEP diferente do que está na base, gerando erro de geometria. Separe sempre. Número do imóvel no Nro, complemento à parte. Se o seu sistema oferece um campo dedicado chamado "Apto" fora do padrão, teste antes de enviar em produção. O layout oficial não prevê essa tag, então ela provavelmente é interpretada como parte do complemento ou é ignorada completamente. Em ambos os casos, o risco de inconsistência entre o que você envia e o que a SEFAZ recebe é alto.