Como entregar o SPED, o SINTEGRA e os XML ao contador#

Esta página resolve a entrega fiscal do mês: gerar o SPED Fiscal, gerar o SPED Contribuições, gerar o SINTEGRA, exportar os XML das NFC-e e publicar o balanço contábil externo. Quem opera: o contador, com o responsável fiscal da loja.

Antes de começar — você precisa de:

permissão fiscal.sped_gerar para o Cockpit, o SPED Fiscal e o Exportar XML;
permissão fiscal.sintegra_consultar para o SINTEGRA;
permissão financeiro.contabilidade_snapshots para o balanço contábil externo;
a loja selecionada;
o PVA EFD ICMS/IPI oficial instalado na máquina que vai validar o arquivo.

Parte 1 — Cockpit do Contador#

O Cockpit é o painel de partida: ele diz o que trava o fechamento e quem resolve.

Passo a passo#

Abra Contador > Cockpit do Contador.
No chip Pendências, leia a lista "O que trava o fechamento — e quem resolve".
Trate cada frente: Perfil fiscal dos produtos (por NCM), Entradas de NF-e com pendência, NFC-e travadas (SEFAZ) e Despesas sem classificação contábil (balancete).
Abra o chip Conciliação caixa × fiscal e confira os últimos 7 dias: o vendido no caixa contra o autorizado na SEFAZ.
Quando Pendências estiver zerado, abra o chip Fechamento do mês e siga a lista de entregas: 1 · Zerar as pendências do mês, 2 · SPED Fiscal (ICMS/IPI), 3 · SPED Contribuições (PIS/COFINS) e 4 · XMLs das NFC-e (importação no sistema do contador).

Resultado esperado#

Com tudo em dia, o resumo diz: "Tudo em dia pro fechamento: sem produto pendente de fiscal, sem entrada com alerta, sem NFC-e travada e despesas classificadas. Pode gerar o SPED e exportar os XMLs (veja o chip Fechamento do mês)."
Se ainda houver pendência, o resumo conta quantas são e lembra que "parte a IA aplica com sua aprovação" — e que os XMLs podem ser exportados a qualquer momento.
Na conciliação, se caixa e fiscal batem, a mensagem confirma: 100% das vendas já têm NFC-e autorizada.

Se algo der errado#

Sintoma	Causa provável	O que fazer
"Sem vendas nos últimos 7 dias — nada a conciliar."	não houve venda no período	normal em loja parada
O resumo mostra valor vendido sem NFC-e autorizada	há nota travada	trate no Monitor NFC-e
"Entradas de NF-e com pendência" com itens	nota de entrada sem concluir	trate em Entrada de NF-e
"Despesas sem classificação contábil (balancete)"	conta a pagar sem classificação	classifique no plano de contas — ver Plano de contas e DRE
"Perfil fiscal dos produtos (por NCM)" com itens	produto sem tributação resolvida	trate em Trabalho e decisões fiscais

Parte 2 — SPED Fiscal e SPED Contribuições#

Passo a passo#

Abra Contador > SPED Fiscal.
Escolha a loja e o período em Início do período e Fim do período.
Escolha como as vendas NFC-e entram: Consolidada (C190) ou Detalhada (C170 por item).
Confira os cartões Itens fiscais, Registros, Pendências e Status.
Se Status estiver bloqueado, corrija as pendências na origem e gere de novo.
Com o arquivo pré-validado, clique em Exportar TXT.
Guarde o hash SHA-256 do arquivo exportado.
Importe o TXT no PVA EFD ICMS/IPI oficial e rode a validação completa.
Voltando à tela, clique em Registrar resultado do PVA, informe o período, o resultado e a observação.
Repita para o SPED Contribuições, na aba correspondente.
Consulte a aba Histórico PVA sempre que precisar provar o que foi validado.

Campos e o que significam#

Campo	O que é	Observação
Loja	loja do arquivo	muda CNPJ, UF e IE do registro de abertura
Início do período / Fim do período	janela de apuração	vêm preenchidos com o mês corrente
Vendas NFC-e	`Consolidada (C190)` ou `Detalhada (C170 por item)`	muda a granularidade da escrituração das vendas
Resultado no PVA oficial	`Sem erro impeditivo`, `Com erro impeditivo` ou `Ainda não validado`	obrigatório para registrar
Observação	texto livre	ex.: "validado sem erros impeditivos no PVA 3.x"
Exportar TXT	gera o arquivo para o PVA	só aparece quando a pré-validação libera

Abas#

Aba	O que traz
SPED Fiscal · ICMS/IPI	o arquivo do ICMS/IPI
SPED Contribuições · PIS/COFINS	o arquivo do PIS/COFINS
Histórico PVA	as validações registradas, com período, resultado e hash curto do TXT

Estados do arquivo SPED#

Estado	O que significa
`bloqueado_pre_validacao`	há pendência que impede gerar o TXT
`gerado_para_revisao`	arquivo gerado, aguardando revisão
`bloqueado`	apuração bloqueada
`aguardando_pva`	pendência que depende da validação no PVA
`pendente_usuario`	pendência que depende de você

Critério de pronto (o que conta como SPED validado)#

O SPED só pode ser marcado como validado quando existir, cumulativamente:

arquivo TXT exportado pelo sistema;
hash SHA-256 salvo;
manifesto conferido contra o TXT exportado;
importação no PVA oficial;
validação sem erro impeditivo;
manifesto com resultado, data/hora, observação do contador e evidência do PVA;
correção feita no sistema, caso o PVA aponte erro.

Cada resultado registrado fica no histórico validacao_pva_sped e pode ser consultado pela retaguarda. Esse histórico é a trilha que o assistente usa para explicar se o arquivo está pronto para assinatura/transmissão ou se precisa voltar para correção.

Resultado esperado#

O cartão Status mostra o arquivo liberado e o botão Exportar TXT aparece.
A aba Histórico PVA passa a listar a validação, com o hash curto do TXT: "N validação(ões) registrada(s) — histórico auditável do PVA (hash do TXT exportado)."
A tela não deixa registrar "sem erro impeditivo" enquanto o período estiver bloqueado.

Se algo der errado#

Sintoma	Causa provável	O que fazer
"SPED bloqueado: N pendência(s) antes do TXT. Corrija a origem na retaguarda e gere de novo."	pré-validação encontrou pendência	corrija na origem e gere de novo. O TXT não é gerado
"escolha o resultado da validação no PVA"	campo de resultado vazio	escolha o resultado
"a observação informa erro impeditivo. Corrija a origem, gere novo TXT e registre como validado só depois que o erro sumir"	observação contradiz o resultado escolhido	corrija a origem antes de registrar
"o SPED do período está bloqueado (tem pendências) — não dá pra registrar como validado sem erro. Corrija e exporte antes"	período bloqueado	corrija e exporte antes de registrar
"não consegui calcular o hash do TXT do período — exporte o TXT e tente de novo"	hash indisponível	exporte o TXT e repita
O script não encontra o PVA	PVA não instalado na máquina	instale o PVA EFD ICMS/IPI oficial e repita o roteiro
O PVA acusa erro impeditivo	problema no cadastro, na entrada ou na regra fiscal	corrija no sistema e gere um TXT novo: não edite o TXT

O roteiro local de validação#

O produto traz um roteiro por script para quem valida na máquina do contador: ele autentica na retaguarda, chama a pré-validação, exporta o TXT, calcula e confere o SHA-256, salva manifesto, detecta se o PVA está instalado e registra o resultado. Os nomes dos scripts e dos parâmetros estão nesse documento; não reproduza os valores de credencial de nenhum ambiente.

Parte 3 — SINTEGRA#

O SINTEGRA depende de um pacote regulatório homologado e ativado para a empresa e a UF. Sem isso, a tela não gera nada — e diz isso em vez de fingir.

Passo a passo#

Abra Contador > SINTEGRA.
Escolha a Loja e a Competência.
Clique em Pré-validar competência.
Leia o cartão Bloqueadas e o chip Pendências. Cada pendência mostra registro, campo, mensagem, quantidade de ocorrências e o botão Corrigir na origem.
Corrija na origem (cadastro, entrada de nota ou regra fiscal).
Volte, selecione a execução e clique em Gerar arquivo.
Quando o arquivo ficar pronto, use Baixar último TXT pronto.

Campos e o que significam#

Campo	O que é	Observação
Loja	estabelecimento do arquivo	o CNPJ e a UF aparecem no resumo da tela
Competência	mês de apuração	campo de mês, preenchido com o mês corrente
Pré-validar competência	dispara a análise	exige permissão de pré-validação
Gerar arquivo	gera o TXT da loja e competência	pede confirmação: "Gerar o arquivo desta loja e competência?"
Baixar último TXT pronto	baixa o arquivo	o nome do arquivo segue o padrão `sintegra_<UF>_<AAAAMM>.txt`
Corrigir na origem	leva ao ponto de correção	aparece em cada pendência

Estados da execução#

Estado	O que significa
Prontas	aptas a gerar ou baixar
Em andamento	processando — "pode sair desta tela"
Bloqueadas	há pendência; "corrija na origem"

Resultado esperado#

O cartão Prontas aumenta e o arquivo fica disponível para download.
Quando não há execução, a tela diz: "Nenhuma execução nesta loja. A pré-validação permanece bloqueada até existir pacote homologado e ativação explícita para a UF."

Se algo der errado#

Sintoma	Causa provável	O que fazer
"SINTEGRA não está habilitado para esta empresa e UF"	não há pacote homologado e ativado para a UF	acione o suporte: a ativação é explícita e por UF
Tela "SINTEGRA não habilitado" com "Nenhuma UF está ativada."	nenhum pacote ativo	idem
"seu perfil permite consultar, mas não pré-validar o SINTEGRA"	falta a permissão de pré-validação	peça a permissão
"seu perfil permite consultar, mas não gerar o SINTEGRA"	falta a permissão de geração	peça a permissão
"informe uma competência válida"	competência vazia ou inválida	informe o mês
"loja não autorizada"	a loja não está no seu escopo	troque a loja
"geração SINTEGRA indisponível"	geração indisponível no ambiente	acione o suporte
"Não foi possível carregar as pendências com segurança."	falha ao ler as pendências	recarregue; se persistir, acione o suporte

Parte 4 — Exportar XML (NFC-e)#

Esta tela monta o pacote de XML que o sistema do contador importa.

Passo a passo#

Abra Contador > Exportar XML (NFC-e).
Escolha Loja (ou deixe "Todas as lojas", se o seu perfil permitir).
Informe Data inicial e Data final.
Se precisar, restrinja por Caixa (PDV).
Escolha o Status dos documentos: Emitido e processado com sucesso, Emitido em contingência, Ambos (processados e em contingência) ou Inutilizados.
Decida as opções: Organizar por dia, Incluir documentos cancelados e, se o sistema do contador exigir, as três opções técnicas.
Clique em Extrair e baixar no modal Extrair e compactar XML de NFC-e.

Campos e o que significam#

Campo	O que é	Observação
Loja	loja do pacote	"Todas as lojas" quando o perfil permite
Data inicial / Data final	período dos documentos	—
Caixa (PDV)	restringe a um caixa	"Todos os caixas" é o padrão
Status	quais documentos entram	o padrão é `Emitido e processado com sucesso`
Organizar por dia	cria uma pasta para cada data dentro do arquivo ZIP	—
Incluir documentos cancelados	inclui também as NFC-e canceladas no período	—
Remover versão e codificação	ajuste técnico do XML	"Use somente quando o sistema do contador exigir."
Remover o envelope nfeProc	mantém apenas o conteúdo interno do XML	opção técnica
Remover o protocolo da SEFAZ	retira do XML os dados de autorização	"Atenção: retira do XML os dados de autorização."

Resultado esperado#

Um arquivo ZIP com os XML do período e do filtro escolhidos.
Com Organizar por dia ligado, uma pasta por data dentro do ZIP.

Parte 5 — Balanço contábil externo#

Esta tela publica o balanço que veio da contabilidade externa. Ela não calcula o balanço: ela o recebe, classifica e publica com rastreabilidade.

Passo a passo#

Abra Contador > Balanço contábil externo.
Confira os cartões Competências, Mais recente e Com ressalva.
Clique em Ver balanço na competência desejada.
Percorra a rastreabilidade: origem, versão do de-para, cobertura e o saldo por conta até a linha bruta do arquivo.

Resultado esperado#

A lista Balanços publicados mostra a competência, com as etiquetas de situação.
O resumo diz quantas competências foram publicadas e lembra que cada balanço é rastreável até a linha bruta do arquivo.
Sem publicação, a tela diz: "Nenhum balanço contábil externo publicado ainda. Assim que o contador entregar a ECD e ela for classificada e publicada, a competência aparece aqui — rastreável até o saldo bruto."

Como a competência chega aqui — esta tela lê competências já publicadas; ela não publica. A origem é a ECD entregue pelo contador, classificada e publicada na fonte contábil externa (decisão de arquitetura em docs/adr-005-fonte-contabil-externa.md). Combinar o formato de entrega com o escritório é acordo entre as partes, não configuração do ERPia.

Como conferir que deu certo#

O que conferir	Onde	O que caracteriza sucesso
O período está inteiro	seletor de período do arquivo gerado	o intervalo cobre o mês de apuração, sem dia faltando nas pontas
A versão do leiaute é a vigente	cabeçalho do arquivo gerado	o campo de versão do leiaute bate com o que o contador espera para o período
O arquivo abriu no validador	programa do contador	o validador não acusa erro de estrutura nem de registro ausente
O total bate com a origem	o próprio arquivo contra o relatório do período	os totais de documento e de valor conferem
O XML exportado é o que foi autorizado	pasta de destino	cada arquivo corresponde a uma nota Autorizada, com o mesmo protocolo
O contador recebeu o que precisa	conferência com o contador	ele confirma que o arquivo é o do período e a versão correta