Auditar e exportar dados fiscais
Guia prático para o contador: a v1.0.13 está focada em Gestão e Resiliência (relatórios, prova de integridade, IBS/CBS). Localização de arquivos, fechamento de mês e pacote para escritório. A parte fiscal (emissão SEFAZ) está em homologação.
Localização dos arquivos fiscais (Windows)
Na v1.0.13 (foco em Gestão e Resiliência) o CaraCore-PDV não emite XML de NFC-e/NF-e à SEFAZ — a integração fiscal está em homologação. O cupom gerado é “NOTA SEM VALOR FISCAL” (PDF sob demanda). Os dados auditáveis ficam no banco local (SQLite) e nos relatórios exportados em PDF.
A v1.0.13 está focada em Gestão e Resiliência: operação offline, relatórios de fechamento, prova de integridade, contingência e cálculos IBS/CBS para transparência. A parte fiscal (emissão NFC-e/NF-e junto à SEFAZ) está em homologação e não faz parte desta release. Os documentos gerados são para uso interno e conciliação, sem substituir obrigações fiscais eletrônicas.
- Instalação padrão (pasta da aplicação): os arquivos do banco ficam na pasta
datano mesmo diretório em que o PDV foi instalado. Exemplo:C:\CaracorePDV\data\. - Versão Desktop (Electron): o diretório de dados do usuário pode estar em
%USERPROFILE%\.caracore-pdvou na pasta de dados do aplicativo (varia conforme o instalador). O lojista ou o suporte pode confirmar o caminho na tela de backup/restauração do Centro de Segurança.
data| Arquivo | Finalidade |
|---|---|
caracore-pdv.db | Banco principal: vendas, pagamentos, clientes, produtos, lojas. Regime de caixa (vendas pelo momento do pagamento). |
caracore-pdv-audit.db | Log de auditoria de tentativas de pagamento (venda_id, valor, sucesso, motivo_falha, created_at). |
caracore-pdv-contingency.db | Modo contingência (opcional): vendas salvas localmente quando o banco central está indisponível. |
Quando houver módulo de emissão de NFC-e/NF-e, os XMLs poderão ser armazenados em subpasta configurável (ex.: data/nfce ou caminho definido na configuração fiscal). Consulte a documentação da versão em que o recurso for disponibilizado.
O sistema não substitui a emissão de documentos fiscais eletrônicos obrigatórios pela SEFAZ. O lojista deve manter os demais cumprimentos legais (SPED, EFD, regime tributário aplicável). Os relatórios do PDV servem para conciliação e auditoria interna.
Relatório de fechamento de mês
O contador pode obter o resumo consolidado do período (faturamento bruto, impostos retidos e, quando disponível, vendas por meio de pagamento) sem depender do suporte técnico.
Relatório com Total de vendas do período, Total de impostos calculados (CBS + IBS) e Valor líquido. Ideal para fechamento mensal e envio ao escritório.
- O lojista (ou contador com acesso) acessa o Dashboard no menu do PDV.
- Seleciona a loja e o período (data inicial e data final).
- Clica em “Exportar PDF para o contador”.
- O navegador baixa o arquivo
resumo-mensal-AAAA-MM-DD-AAAA-MM-DD.pdf.
URL direta (substitua lojaId, inicio e fim no formato yyyy-MM-dd): /dashboard/api/resumo-mensal/exportar-pdf?lojaId=1&inicio=2026-01-01&fim=2026-01-31
Relatório detalhado por meio de pagamento: Dinheiro, Débito, Crédito e Outros (PIX e demais). Útil para conciliação bancária e regime de caixa.
- Acesse o menu Relatórios (ou a tela de pesquisa de Lojas).
- Selecione a loja desejada e escolha “Vendas da loja”.
- Informe Data inicial e Data final do período.
- Gere o PDF. O relatório exibe totais por forma de pagamento (Dinheiro, Débito, Crédito, Outros) e total geral.
Disponível via Relatórios → Loja → Vendas por período (POST com dataInicial e dataFinal em dd/MM/yyyy).
- Faturamento bruto: soma dos totais das vendas no período (base de cálculo).
- Impostos retidos/calculados: CBS e IBS já calculados pelo sistema (Reforma 2026).
- Regime de caixa: as vendas são consideradas pela data do pagamento/finalização no PDV.
Conformidade Reforma Tributária 2026 (IBS/CBS)
Na v1.0.13 o sistema já trata a separação IBS (Imposto sobre Bens e Serviços) e CBS (Contribuição sobre Bens e Serviços), alinhado ao cronograma de transição da EC 132 (2026–2033), para facilitar a futura transição no escritório contábil.
- Fórmula “por fora” (não cumulativa): Valor do Imposto = Base × Alíquota / (100 − Alíquota).
- Alíquotas por ano (padrão): 2026 — CBS 0,9%, IBS 0,1%; 2027 — CBS 12%, IBS 12%; 2028–2033 — transição gradual até 15%.
- Configuração: o lojista ou administrador pode sobrescrever alíquotas por ano na configuração fiscal (ex.:
AliquotaReformaTributaria).
Cada venda gravada no banco armazena:
aliquotaCbsUtilizadaealiquotaIbsUtilizada— alíquotas efetivamente aplicadas.anoFiscal— ano utilizado para seleção das alíquotas.versaoTabelaAliquotas— indicação de tabela padrão ou contingência (ex.:CONTINGENCIA_2026).
Isso permite ao escritório auditar a base de cálculo e a origem dos tributos (SPED, EFD, livros fiscais).
Quando o NCM não é encontrado na tabela local ou na API da Receita, o sistema aplica alíquota única de contingência (26,5%) e registra o fato no log fiscal e no campo versaoTabelaAliquotas. O contador pode identificar essas operações para revisão ou retificação.
Exportação de logs e prova de integridade
O contador pode validar que as vendas registradas no SQLite não sofreram manipulação externa (prova de integridade), utilizando o comando nativo do SQLite e os arquivos de auditoria.
No Windows, abra o Prompt de comando ou PowerShell e navegue até a pasta onde está o arquivo caracore-pdv.db (ex.: data dentro da instalação do PDV). Execute:
sqlite3 caracore-pdv.db "PRAGMA integrity_check;"Resposta esperada: ok. Qualquer outra saída indica possível corrupção ou alteração indevida do arquivo.
Se sqlite3 não estiver instalado, baixe-o em sqlite.org ou use ferramentas gráficas (ex.: DB Browser for SQLite) que ofereçam “Integrity Check”.
O arquivo caracore-pdv-audit.db contém o log de tentativas de pagamento (venda_id, valor, sucesso, motivo_falha, created_at). Para exportar em formato texto (CSV) para planilha:
sqlite3 -header -csv caracore-pdv-audit.db "SELECT * FROM pagamento_audit_log ORDER BY created_at;" > auditoria_pagamentos.csvO contador pode cruzar venda_id com a tabela de vendas no banco principal para conciliação.
- O próprio PDV executa PRAGMA integrity_check ao iniciar; em falha, não sobe e pode exibir Erro 02 (Estado Parcial).
- Na versão Desktop (Electron), alterações em arquivos do aplicativo ou do banco podem ser detectadas (hash do app, cabeçalho do SQLite), bloqueando a abertura.
Área de download do contador
Quando o portal de suporte ou a área do contador estiver disponível para o seu cliente, o lojista poderá gerar ou baixar o Pacote Mensal (relatórios em PDF, eventualmente XMLs quando houver emissão de NFC-e/NF-e) diretamente pelo portal, sem precisar acessar o PDV.
- Relatórios: utilizar o “Exportar PDF para o contador” no Dashboard e o relatório “Vendas por período” no menu Relatórios, conforme descrito na seção Relatório de fechamento de mês.
- Backup do banco: o lojista pode fazer cópia da pasta
data(ou do arquivocaracore-pdv.db) e enviar ao escritório em canal seguro, para análise offline ou importação em ferramentas de auditoria. - Pacote mensal centralizado: quando a funcionalidade de “Pacote Mensal” no portal estiver implementada, as instruções de acesso serão publicadas nesta trilha e no portal. O contador poderá baixar o pacote mediante autenticação do lojista ou vínculo contratual.
Em caso de dúvida sobre disponibilidade da área do contador para o seu cliente, consulte o suporte Cara Core ou a página de Download / Degustação do site, onde constam os canais de contato.