Fluxo geração do SPED no PlugStorage

Esta documentação tem o objetivo de apresentar o passo a passo para gerar uma apuração do SPED com base nos arquivos XML armazenados na plataforma PlugStorage.

O fluxograma a seguir representa a ordem das chamadas necessárias para a preparação e geração dos dados.

1. Armazenamento das Notas

• Certifique-se de que todas as notas fiscais emitidas e recebidas estejam armazenadas corretamente no PlugStorage.

2. Habilitar o SPED

• Ativar pela interface do PlugStorage.

• Ativar via rota.

• Inserir os dados obrigatórios do responsável e do contador para vinculação com a competência.

3. Iniciar Apuração

• Inicie o processo de apuração para abrir a competência desejada.

• O sistema realiza automaticamente o processamento inicial do SPED.

4. Consultar Apuração

• Utilize a rota para verificar o status da solicitação de abertura da apuração.

• Confira se existem pendências.

5. Consultar Notas Recebidas

• Consulte as notas recebidas no período informado.

6. Escriturar Notas Recebidas

• Inclua as informações:

  • Chave da nota fiscal

  • Data de entrada

  • Destinação da nota

  • Vínculo do produto (opcional)

• ✔ Certifique-se de que todas as notas estejam devidamente escrituradas.

7. Consulta de Pendências

Tipos de pendências e ações:

• Notas sem destinação → realizar escrituração da nota.

• Notas sem regras DePara cadastradas → inserir Regra DePara.

8. Regra DePara

• Inserir regras para os impostos:

  • ICMS

  • PIS/COFINS

  • IPI

• Após inserir ou alterar uma Regra DePara, o processo de apuração deve ser reprocessado.

9. Gerar Relatório de Impostos

Gere relatórios para conferência:

• SPED Fiscal → inclui ICMS e IPI.

• SPED Contribuições → inclui PIS e COFINS.

• Resumo por CFOP → apresenta totalizadores por CFOP.

10. Realizar Ajustes Complementares

• Inserir saldos.

• Realizar ajustes.

• Enviar Bloco K (dados de estoque).

• Enviar bloco H (dados do inventário)

11. Gerar SPED

• Feche o SPED da competência:

  • SPED Fiscal

  • SPED Contribuições

12. Consultar SPED

• Após a geração, consulte o arquivo SPED para verificar a conformidade.

• Em caso de pendências:

• Ajuste as inconsistências.

  • Reabra o SPED.

  • Realize as alterações necessárias.

13. Configurar webhook do SPED

• Caso deseje receber automaticamente o arquivo SPED após a geração, configure o webhook por empresa através da rota de configurações do cliente SPED.
• Com o webhook configurado, não será necessário realizar consultas periódicas para verificar a disponibilidade do arquivo.

14. Reabrir o SPED

Se houver necessidade de novos ajustes após o fechamento:

1. Reabra a competência.

2. Envie as alterações.

3. Gere novamente o SPED atualizado.

📌 Dica: disponibilizamos também uma collection do Postman com todas as rotas de integração para facilitar a execução desse fluxo.