TL;DR — Resumo Rápido
Aspel COI: resolva erros ao criar e importar lançamentos contábeis. Desbalanceamentos, contas inexistentes, períodos fechados e importação de XML do SAT.
O Aspel COI frequentemente exibe erros ao tentar criar ou importar lançamentos contábeis (pólizas contables). Desde o clássico erro de desequilíbrio entre débitos e créditos até rejeições de importação por formato incorreto ou contas inexistentes no plano de contas, esses problemas travam o registro contábil e complicam o cumprimento com o SAT. Este guia cobre as causas mais comuns e suas soluções passo a passo.
O Erro
Os erros mais frequentes ao trabalhar com lançamentos no Aspel COI são:
- “Erro ao salvar o lançamento” — aparece quando os débitos não são iguais aos créditos.
- “A conta contábil não existe no catálogo” — o código de conta de uma linha não corresponde a nenhuma conta no plano do COI.
- “O período contábil está fechado” — a data do lançamento está em um período já encerrado.
- “Erro na importação do arquivo” — o arquivo CSV ou TXT não tem o formato esperado pelo COI.
- “Erro ao processar o XML” — ao importar lançamentos XML do SAE ou NOI, o arquivo tem estruturas incompatíveis.
- Lançamento salvo mas não aparece no balancete — o lançamento foi criado mas não aplicado ao período correto.
- Número de lançamento duplicado — o COI rejeita um lançamento porque já existe um com o mesmo tipo e número no período.
Causa do Problema
Desequilíbrio entre débitos e créditos
A causa mais comum é que a soma dos débitos não é igual à soma dos créditos. Isso ocorre por erros de digitação, arredondamento de decimais ou linhas incompletas ao copiar dados de outro sistema.
Conta inexistente no plano de contas
O COI valida cada código de conta contra o catálogo configurado. Se uma conta tiver um código ligeiramente diferente — um nível extra, um hífen faltante ou um espaço no final — o COI a rejeita. Isso é especialmente comum ao importar lançamentos de outro sistema com um plano de contas diferente.
Período contábil fechado
Quando um período mensal ou o exercício anual é encerrado, o COI bloqueia a criação e modificação de lançamentos com data naquele período. Para corrigir um erro em um período já fechado, é necessário reabri-lo temporariamente.
Formato de importação incorreto
O COI espera um arquivo com colunas em uma ordem específica. Arquivos exportados diretamente do Excel (.xlsx), com delimitadores incorretos ou com datas em formato diferente de DD/MM/AAAA falham no processo de importação.
Solução Passo a Passo
1. Corrigir o desequilíbrio do lançamento
- Abra o lançamento com erro no COI.
- Some manualmente os débitos e créditos (ou use os totais exibidos na tela).
- Identifique a linha com o valor incorreto e corrija-o.
- Se a diferença for de arredondamento, ajuste a última linha pela diferença em centavos.
- Salve o lançamento — o erro deve desaparecer.
2. Criar a conta faltante no plano de contas
- Anote o código exato da conta que o COI rejeita.
- Vá a Catálogos > Plano de Contas.
- Procure uma conta semelhante com código diferente.
- Se a conta não existir, crie-a com o código exato, nome, tipo e nível corretos.
- Salve o catálogo e tente salvar ou importar o lançamento novamente.
3. Reabrir um período fechado
- Vá a Configurações > Períodos Contábeis (ou Utilitários > Períodos conforme a versão do COI).
- Localize o período fechado.
- Mude o status para Aberto.
- Crie ou corrija o lançamento com a data correspondente.
- Feche o período novamente para manter a integridade contábil.
4. Preparar o arquivo de importação do Excel
A ordem correta de colunas para importar lançamentos no COI é:
| Coluna | Conteúdo | Exemplo |
|---|---|---|
| A | Tipo de lançamento (D/I/E) | D |
| B | Número do lançamento | 1 |
| C | Data | 31/03/2026 |
| D | Código de conta | 1100-001 |
| E | Descrição da linha | Vendas março |
| F | Débito | 10000.00 |
| G | Crédito | 0.00 |
Passos:
- Prepare o arquivo no Excel com as colunas na ordem acima.
- Arquivo > Salvar Como > CSV (delimitado por vírgulas).
- Abra o COI e vá a Utilitários > Importar > Lançamentos.
- Selecione o arquivo CSV e configure o delimitador como vírgula.
- Revise a visualização — verifique que os campos estão alinhados corretamente.
- Confirme a importação e revise o log de erros.
5. Importar lançamentos XML do SAE ou NOI
- No Aspel SAE ou NOI, exporte os lançamentos em formato XML (padrão SAT).
- No COI vá a Utilitários > Importar > Lançamentos XML.
- Selecione o arquivo .xml gerado.
- O COI exibirá um resumo dos lançamentos a importar — verifique os valores e datas.
- Se houver erros de conta, o COI listará os códigos rejeitados. Crie as contas faltantes e reimporte.
Solução Alternativa
Se a importação em massa falhar repetidamente, insira os lançamentos manualmente em pequenos lotes de 10 a 20 para identificar exatamente qual causa o erro. Uma vez identificado, corrija essa linha no arquivo e tente a importação completa novamente.
Para desequilíbrios difíceis de identificar em lançamentos com muitas linhas, exporte o lançamento para Excel a partir do COI, some as colunas de débito e crédito com a função SOMA e identifique a diferença exata antes de corrigi-la no sistema.
Prevenção
- Use o modelo oficial de importação: Baixe e use sempre o modelo de importação fornecido pela Aspel para evitar erros de ordem de colunas.
- Valide o plano de contas antes de importar: Execute uma listagem do plano de contas e cruze com as contas do arquivo de importação antes de processá-lo.
- Respeite os períodos contábeis: Evite registrar lançamentos em períodos já em processo de fechamento. Estabeleça uma política clara de corte mensal.
- Dois decimais consistentes: Use sempre dois casas decimais em todos os valores.
- Backup antes de importações em massa: Faça um backup do banco de dados do COI antes de qualquer importação massiva.
Problemas Relacionados
Lançamento salvo mas não aparece no balancete
Verifique que está consultando o balancete no período correto. No COI o balancete é filtrado por período — se o lançamento tem data em março mas você consulta fevereiro, não aparecerá. Confirme também que o status do lançamento é “Aplicado”.
Número de lançamento duplicado
O COI não permite dois lançamentos do mesmo tipo com o mesmo número no mesmo período. Verifique o intervalo de números antes de importar.
Erro ao modificar um lançamento já aplicado
Lançamentos aplicados no COI são somente leitura. Para modificá-los é necessário “desaplicá-los” primeiro, fazer as alterações e reaplicá-los. Em períodos fechados, reabra o período antes de desaplicar.
Resumo
- O erro mais comum ao criar lançamentos é o desequilíbrio entre débitos e créditos — sempre some ambas as colunas antes de salvar.
- Os códigos de conta devem existir no plano de contas do COI antes de criar ou importar lançamentos que os referenciem.
- Períodos fechados bloqueiam a criação — reabra-os temporariamente e feche novamente após a correção.
- Para importação do Excel, o arquivo deve ser CSV com colunas na ordem específica do COI e datas no formato DD/MM/AAAA.
- Lançamentos XML do SAE e NOI são importados em Utilitários > Importar > Lançamentos XML.
- Sempre faça backup antes de importações em massa.