O leiaute da NF-e ABI: código CIB, base de IBS e CBS e o que a sua integração precisa tratar

O anexo de leiaute já está na segunda versão e continua como minuta. Integrar contra documento que se move tem método próprio.

1. Em que pé está o leiaute

A primeira informação que muda o plano de quem integra não é um campo. É o estado do documento que descreve os campos.

O manual da NF-e ABI foi publicado pelo ENCAT no Portal Nacional da NF-e em 24 de novembro de 2025, na versão 1.00 e como minuta técnica. O Anexo I, que é onde moram o leiaute e as regras de validação, avançou para a versão 2.00, publicada em 7 de abril de 2026, e continua como minuta.

Ou seja: o documento passa a ser obrigatório em 1º de dezembro de 2026. E a especificação que o descreve já mudou de versão cheia uma vez, sem chegar a uma versão consolidada.

Isso não é motivo para esperar. É motivo para escolher o que construir primeiro. O panorama do documento, para quem decide e não integra, está em NF-e ABI, modelo 77: a venda de imóvel passa a ter nota fiscal.

2. Integrar contra minuta tem método

Quem já passou por documento fiscal novo conhece o padrão: a estrutura do documento estabiliza cedo, e os campos de detalhe se mexem até o fim.

A consequência prática é que dá para dividir o trabalho em duas pilhas. A primeira é o que não depende do campo exato: fluxo de emissão, autenticação, tratamento de retorno, guarda do XML, reprocessamento e a origem de cada dado. A segunda é o mapeamento campo a campo, que é o que a revisão da minuta mexe.

Começar pela segunda é o erro caro. Mapeamento feito sobre a versão 1.00 do anexo foi refeito quando a 2.00 saiu, e quem tinha construído fluxo não perdeu nada.

Vale ainda registrar no código a versão do anexo contra a qual cada mapeamento foi feito. Em documento que muda de versão, saber contra o que se integrou é o que permite medir o impacto da próxima revisão em minutos, em vez de reler tudo.

3. O código CIB, e por que ele é o campo mais difícil

O documento identifica o imóvel pelo código CIB, o Cadastro Imobiliário Brasileiro. E esse é o campo que costuma travar a integração, por uma razão que não é técnica.

Todos os outros dados da nota já existem no ambiente fiscal: emitente, destinatário, valor, tributo. O identificador do imóvel não. Ele mora na escritura, na matrícula, no contrato ou no sistema jurídico, e quase nunca no ERP que emite documento fiscal.

Isso transforma o problema. Não é buscar um campo de um cadastro que já se consulta. É criar um caminho novo entre dois sistemas que nunca conversaram, com donos diferentes e ritmos diferentes.

Há um teste simples que revela o tamanho do trabalho, e vale fazer hoje. Pegue três operações reais com imóvel dos últimos doze meses e tente localizar o identificador cadastral de cada um. O tempo que isso levar é o tempo que a emissão vai levar em dezembro, multiplicado pelo volume.

4. A base de IBS e CBS numa operação com imóvel

A segunda frente é o cálculo, e ela tem uma diferença de natureza em relação à nota de mercadoria.

Na venda de mercadoria, o valor da operação é o preço, e o preço está no pedido. Na alienação de imóvel, esse valor depende da forma da contrapartida. E a contrapartida varia: dinheiro, outro imóvel na permuta, dívida extinta na dação em pagamento, participação societária na realização de capital.

Cada uma dessas formas coloca uma pergunta diferente sobre como a base se compõe, e é nesse ponto que a minuta ainda se move. Fixar a regra de cálculo agora, a partir de uma versão que não é final, é construir para refazer.

O caminho que não desperdiça trabalho é deixar a regra de cálculo parametrizável desde o começo, e não embutida. Documento novo em regime novo muda de regra mais de uma vez, e quem parametrizou troca configuração onde os outros trocam código.

5. Onde a integração costuma quebrar

Quatro pontos concentram o problema quando o documento é novo, e nenhum deles aparece no leiaute.

1. Certificado e ambiente. A sociedade que vai emitir pode nunca ter emitido nada, e é comum a SPE e a patrimonial não terem certificado digital ativo.
2. Origem do dado cadastral do imóvel, que é o caminho novo entre o jurídico e o fiscal, e o item de maior prazo da lista.
3. Volume concentrado. Em incorporação, a emissão acompanha a entrega das unidades, então o volume vem em onda e não em fluxo.
4. Tratamento de retorno e reemissão. Documento novo tem tabela de rejeição nova, e o processo de correção precisa existir antes da primeira nota, e não depois da primeira rejeição.

6. O que isso custa se começar em novembro

A conta que decide a prioridade não é de horas de desenvolvimento. É de prazo de terceiro.

A premissa: dos quatro pontos acima, três dependem de alguém de fora do time de integração. Certificado depende da certificadora e do representante legal. O dado do imóvel depende do jurídico. O ambiente de emissão depende de habilitação.

Se cada um desses consome duas semanas, e eles não correm em paralelo porque dependem uns dos outros, são seis semanas só de espera. Começando em 1º de novembro, a conta termina depois da data de obrigatoriedade.

É por isso que a preparação de outubro não é sobre campo. É sobre disparar o que depende dos outros, enquanto o leiaute termina de assentar.

7. Perguntas frequentes

Posso começar a integrar com a minuta, ou espero a versão final?
Dá para começar, desde que pelo que não muda. Fluxo de emissão, autenticação, guarda, reprocessamento e origem dos dados não dependem do campo exato. O mapeamento campo a campo é a parte que a revisão de minuta mexe, e é a que vale deixar por último.

Onde encontro o código CIB dos imóveis da empresa?
Não no ERP fiscal, na maioria dos casos. O identificador cadastral do imóvel costuma estar na escritura, na matrícula ou no sistema jurídico. Mapear essa origem é o item de maior prazo da integração, e o que menos parece trabalho de TI.

A versão 2.00 do anexo invalida o que fiz com a 1.00?
Invalida o mapeamento de campo, não o fluxo. É exatamente a razão de separar as duas pilhas de trabalho. Quem registrou no código contra qual versão integrou mede o impacto da revisão rapidamente; quem não registrou relê tudo.

Preciso de um emissor separado ou uso o mesmo da NF-e de mercadoria?
É modelo de documento diferente, com leiaute e validações próprias, mas isso não implica ambiente separado. O que decide é se o seu emissor atual suporta o modelo 77. Vale confirmar com o fornecedor antes de planejar, porque a resposta muda o tamanho do projeto.

E se a minuta ainda estiver aberta em novembro?
A data de obrigatoriedade está em ato conjunto e não depende da consolidação do manual. O que protege é construir agora o que independe do campo, e deixar o mapeamento parametrizável, para absorver a versão final sem reescrever.

Migrate ao seu lado em documento que ainda se move

Integrar contra especificação em minuta é rotina de quem acompanha documento fiscal desde a origem, e é desconfortável para quem chega no fim. A diferença está em saber o que estabiliza cedo e o que muda até o último dia.

A Migrate emite e gerencia documento fiscal eletrônico há mais de 20 anos, em cinco países, e acompanha cada modelo novo desde a primeira minuta. Participa também do projeto piloto da apuração assistida do IBS.

Se a sua equipe vai integrar o modelo 77, vale conversar antes de fixar o mapeamento.

Referências

BRASIL. ENCAT. Manual de Orientação ao Contribuinte da NF-e ABI, modelo 77, versão 1.00, publicado no Portal Nacional da NF-e em 24 de novembro de 2025, na condição de minuta. https://www.nfe.fazenda.gov.br/portal/principal.aspx

BRASIL. ENCAT. Anexo I, Leiaute e Regra de Validação, NF-e ABI, versão 2.00, minuta publicada em 7 de abril de 2026. Portal Nacional da NF-e.

BRASIL. Receita Federal e Comitê Gestor do IBS. Ato Conjunto RFB/CGIBS nº 4, de 30 de julho de 2026, art. 1º, inciso XVIII. Portal do CGIBS. https://www.cgibs.gov.br/upload/arquivos/202607/31091735-20260730-16h30-ato-conjunto-rfb-cgibs-na-c2-ba-4-260731-090909.pdf

BRASIL. Lei Complementar nº 214, de 16 de janeiro de 2025. Planalto. https://www.planalto.gov.br/ccivil_03/leis/lcp/lcp214.htm