Rejeição 1170: confira por que o ajuste de competência ficou fora do XML

Se a NF-e recebeu 1170, investigue a classificação do item e o arquivo transmitido antes de preencher novos dados. Pode existir um ajuste legítimo que não foi enviado, ou um enquadramento que precisa ser revisto pelo responsável fiscal. A mensagem, sozinha, não demonstra qual dessas causas ocorreu.

O que a regra documentada exige

A mensagem é “Rejeição: Grupo de Ajuste de Competência não informado [nItem: 999]”. Compare o item indicado no retorno com o nItem do XML. O marcador 999 da documentação não é um código fixo de produto.

Na NT 2025.002-RTC v1.52, página 65, a UB112-20 corresponde à NF-e modelo 55: se o CST possui ind_gAjusteCompet=1, que exige o ajuste de competência, e gAjusteCompet/UB112 não foi informado, ocorre a condição descrita para 1170. A linha orienta consultar a tabela de CST.

O indicador pertence ao CST do IBS/CBS, não ao CST do ICMS ou ao CSOSN. A regra vizinha de grupo indevido, 1169, possui outro predicado e inclui modelos 55/65; isso não amplia a 1170 para NFC-e.

Confirme a classificação sem inventar um ajuste

Peça à contabilidade o fundamento do ajuste, a competência e a memória dos valores. Confira o CST efetivamente enviado, a referência da tabela utilizada e seu indicador. Não conclua que o enquadramento está correto apenas porque o retorno identificou falta de um grupo.

A tabela oficial consultada em 15/10/2026 apresenta o indicador “Ajuste de Competência” no nível do CST. Na captura, 811 — Ajustes é o único CST listado com esse indicador ativo. O dado serve para conferir a tabela utilizada pelo emissor, sem recomendar uma mudança para 811. Confirme o enquadramento e a vigência aplicáveis à operação.

Se faltar fundamento, registre a lacuna e encaminhe-a ao responsável fiscal. Escolher outra classificação somente para evitar a regra, ou criar um ajuste fictício, modifica o dado fiscal sem solucionar a causa.

Localize o grupo certo no arquivo

O leiaute identifica IBSCBS como UB12, a sequência XML UB14k sob ele e gAjusteCompet/UB112 com pai UB14k. gIBSCBS/UB15 também aparece sob essa sequência; não coloque o ajuste dentro de gIBSCBS por semelhança de nomes.

Dentro do ajuste estão competApur/UB113, em AAAA-MM, vIBS/UB114 e vCBS/UB115. O leiaute orienta período atual ou retroativo. A competência concreta deve vir da apuração, nunca do vencimento financeiro por conveniência.

Uma anotação na tela, um valor no banco ou um bloco em outra estrutura não comprovam que o grupo exigido saiu no item correto. O XML daquela tentativa permite separar informação cadastrada de informação efetivamente serializada.

Reúna evidências antes de corrigir

Preserve XML enviado, resposta integral, chave, item, horário, versão do emissor e referência da tabela. Registre modelo, serviço, UF, autorizador e ambiente. Distinga homologação de produção e retorno da SEFAZ de validação interna anterior ao envio.

Compare a mesma tentativa: cadastro utilizado, dados da integração, memória fiscal e arquivo final. Uma tela modificada depois da rejeição pode não representar o conteúdo transmitido.

Verifique se o grupo foi omitido, associado a outro item, colocado no caminho errado ou perdido na conversão dos dados. São hipóteses de investigação; a falta precisa ser demonstrada no arquivo, sem atribuir a causa a uma rotina antes dessa comparação.

Corrija conforme o cenário comprovado

Há ajuste legítimo e a classificação foi confirmada. Complete os dados aprovados pelo responsável fiscal na origem da emissão. Confira competência e valores de cada tributo, depois rastreie sua passagem até o XML. Regenerar o documento deve produzir um novo arquivo coerente com a apuração, preservando a tentativa anterior.

A presença do grupo não encerra a análise. A UB112-30, código 1171, examina os valores quando gAjusteCompet é informado: o literal exige IBS ou CBS maior que zero. Não invente montante, copie total da nota ou acrescente centavo simbólico para tentar superar essa outra regra.

O enquadramento não representa a operação. O responsável fiscal deve indicar a correção fundamentada e seus efeitos. Não mantenha um CST inadequado preenchendo competência fictícia. Também não remova todos os tributos ou um grupo obrigatório para evitar a validação.

Os dados existem, mas a geração os omite. Peça ao suporte a comparação entre entrada e saída, incluindo item, caminho do grupo, versão e esquema utilizado. Corrija o mapeamento comprovadamente incorreto; se faltar recurso no emissor, documente a limitação. Não remende manualmente um XML já assinado.

Após cada correção, confira o arquivo regenerado. Reutilizar um XML anterior pode repetir a falta mesmo quando a tela já apresenta os dados.

Exemplo fictício de investigação

Numa simulação, uma distribuidora prepara uma NF-e modelo 55 com um ajuste previamente documentado. A contabilidade confirmou seu enquadramento e forneceu os dados de apuração. A importação guarda essas informações, mas o gerador aproveita apenas o cadastro do item e deixa de montar gAjusteCompet. O retorno hipotético aponta 1170.

O suporte compara os registros e identifica essa omissão. A geração é corrigida e o novo XML é conferido contra os dados originais, sem alterar classificação, competência ou valores comprovados. O exemplo é inteiramente fictício: não demonstra atendimento, direito fiscal, cálculo, emissão de teste ou autorização reais.

Versão, ambiente e calendário

A documentação foi conferida em 15/10/2026. A UB112-20 da v1.52, página 65, mantém a condição da v1.51, página 67. A linha não traz observação própria de implementação futura. As observações do bloco monofásico encerrado acima não pertencem à 1170.

O cronograma da v1.52, páginas 4 e 5, inclui UB112-20 na lista da v1.30, com até 24/11/2025 em teste e 02/02/2026 em produção. O aviso ENCAT de 05/10 anuncia 26/10 em homologação e 16/11 em produção para as atualizações enumeradas. Ele não comprova suspensão das regras herdadas nem ativação individual da 1170.

Registre UF, autorizador, ambiente e versão do emissor. Os documentos consultados não comprovam aplicação uniforme em todos os serviços. Se o retorno divergir do XML comprovadamente transmitido, confirme a versão e os avisos aplicáveis com o suporte responsável.

Confira o resultado e encaminhe as dúvidas

Examine o novo XML e a resposta completa. O desaparecimento de 1170 não comprova autorização: registre-a somente com resultado válido e protocolo correspondente à chave. Uma nova rejeição exige seu próprio diagnóstico.

Encaminhe dúvidas de enquadramento, competência e memória à contabilidade. Para omissão ou divergência na geração, envie ao suporte os arquivos, item, versões, tabela, ambiente, UF, autorizador e horário. Preserve o histórico para demonstrar o que mudou entre as tentativas.

Fontes

Documentação conferida em 15/10/2026.

• NT 2025.002-RTC v1.52, página 65: UB112-20 e valores do ajuste; páginas 18, 19 e 27: leiaute; páginas 4–5: cronograma. V1.51, página 67: comparação.

• Tabela oficial CST e classificação tributária: indicador Ajuste de Competência e vigência dos registros. Documentos e avisos SVRS: versões e comunicado ENCAT.

• Apoios específicos: Migrate e Sankhya; apoio sobre os campos do grupo: FlexDocs. Exemplos e menus pertencem aos respectivos fornecedores. A inclusão do ajuste e a classificação exigem fundamento fiscal, sem garantir autorização.