Trazer o histórico contábil para o Books

Este recurso está em acesso antecipado: ele foi desenvolvido e testado, mas ainda não está ativado para todas as organizações ou ainda não foi testado com o provedor externo. Fale com a gente no WhatsApp se quiser experimentar.

O proprietário pode abrir Books → Migração histórica (/books/migration) com acesso completo ao fechamento do Books. Importe primeiro clientes e fornecedores. Use a moeda base e a filial principal; este importador não aceita outras moedas ou filiais.

1. Baixe o modelo CSV. Forneça uma linha contábil por linha, agrupada por ID externo estável. Escolha journal, opening, invoice ou bill. Reutilize o mesmo identificador do sistema de origem em exportações futuras.
2. Informe chaves de contas ou id:ACCOUNT_ID, datas e valores de débito/crédito. Para faturas e contas, inclua ID da parte existente, total original, imposto, valor pago e vencimento. Use o ID da URL Kluvan do contato, não o nome.
3. Envie CSV, TSV ou XLSX: no máximo 250 KB, 500 linhas e 100 lançamentos por lote. Selecione a planilha e mapeie os cabeçalhos.
4. Visualize cada lançamento. Débitos e créditos devem ser iguais. Compare saldos de origem e totais dos documentos. Confirme explicitamente o conteúdo revisado e execute o lote.
5. Leia o comprovante de conciliação e abra os documentos criados. Retome um lote interrompido na página salva; não altere IDs de origem para tentar novamente.

Faturas e contas mantêm datas originais e criam documentos canônicos pagos, parcialmente pagos ou em aberto. A linha a receber/pagar equivale ao total menos o pago. Não importe também esse saldo por saldos iniciais das listas ou lançamento genérico de abertura: isso o contaria duas vezes. Lançamentos genéricos de diário/abertura não podem conter contas a receber/pagar.

Uma data de lançamento opcional permite usar um período de corte posterior aberto preservando a data original do documento. Permanecem as restrições de períodos fechados e lançamentos futuros. Linhas históricas de IVA ficam no razão, mas não entram em novas declarações. Revise separadamente o balancete de origem; um lote equilibrado não prova uma migração completa.

Identidades repetidas com conteúdo inalterado permitem retomada segura; conteúdo modificado é recusado. Comprovantes preservam referências de origem. Não há desfazer do lote inteiro: corrija registros pelo procedimento contábil permitido habitual. Este fluxo não usa créditos de IA.