SPED

API de SPED para gerar e validar escrituração fiscal digital

Gere arquivos EFD ICMS/IPI e EFD PIS/COFINS via REST API. Validação automática, unificação de arquivos e relatórios detalhados para sua operação contábil.

Ver documentação
gerar-efd.sh
curl --request POST \
  --url "https://api.brasilnfe.com.br/services/Fiscal/ObterArquivoSped" \
  --header 'Content-Type: application/json' \
  --header 'Token: seu_token_aqui' \
  --data '{
  "TipoArquivo": 1,
  "CRT": 3,
  "IncluirNotasSaidas": true,
  "DtInicio": "2026-03-01",
  "DtFim": "2026-03-31",
  "EfdIcmsIpiInfo": {
    "CodFinalidade": 0,
    "IndicadorPerfil": 1
  }
}'

Escriturações suportadas pela API

A API Brasil NFe suporta as duas principais escriturações do SPED: EFD ICMS/IPI e EFD PIS/COFINS (Contribuições), com todos os blocos necessários para a geração completa do arquivo.

EFD ICMS/IPI

Escrituração Fiscal Digital para apuração do ICMS e do IPI. Obrigatória para contribuintes do ICMS e/ou IPI, substitui os antigos livros fiscais de entrada, saída, apuração e inventário.

  • Bloco 0 - Abertura
  • Bloco C - Documentos Fiscais I
  • Bloco D - Documentos Fiscais II
  • Bloco E - Apuração ICMS/IPI
  • Bloco G - CIAP
  • Bloco H - Inventário
  • Bloco K - Produção/Estoque
  • Bloco 1 - Complementares
  • Bloco 9 - Encerramento

EFD PIS/COFINS

Escrituração Fiscal Digital das Contribuições. Destinada à apuração do PIS/Pasep, da COFINS e da CPRB (Contribuição Previdenciária sobre a Receita Bruta).

  • Bloco 0 - Abertura
  • Bloco A - Serviços
  • Bloco C - Documentos Fiscais
  • Bloco D - Transporte
  • Bloco F - Demais Documentos
  • Bloco M - Apuração
  • Bloco 1 - Complementares
  • Bloco 9 - Encerramento

Sistema Público de Escrituração Digital

O SPED (Sistema Público de Escrituração Digital) é uma iniciativa do Governo Federal brasileiro que modernizou a forma como as empresas prestam informações fiscais e contábeis à Receita Federal, Secretarias de Fazenda estaduais e demais órgãos fiscalizadores. Instituído pelo Decreto 6.022/2007, o SPED substituiu a escrituração em papel por arquivos digitais padronizados, reduzindo custos e aumentando a confiabilidade das informações.

A EFD ICMS/IPI (Escrituração Fiscal Digital), também conhecida como SPED Fiscal, é a obrigação acessória que registra todas as operações de entrada e saída de mercadorias, apuração do ICMS e do IPI, controle de estoque (Bloco K) e o inventário físico. É obrigatória para todos os contribuintes de ICMS e/ou IPI.

Já a EFD PIS/COFINS, também chamada de SPED Contribuições, registra as receitas, custos, despesas e as apurações das contribuições sociais (PIS/Pasep e COFINS), além da CPRB. É obrigatória para empresas no regime de lucro real e lucro presumido.

Quem precisa gerar o SPED?

A escrituração fiscal digital é obrigatória para a maioria das empresas brasileiras que apuram ICMS, IPI, PIS ou COFINS. Os prazos e regras variam conforme o estado e o regime tributário. Veja os principais perfis que utilizam a API de SPED:

  • Escritórios contábeis que geram SPED para múltiplos clientes mensalmente
  • Empresas com contabilidade interna que precisam automatizar a geração do arquivo
  • Software houses fiscais que integram SPED em seus produtos (ERPs, contabilidade)
  • ERPs e sistemas de gestão que precisam exportar escrituração fiscal digital

Se você também precisa emitir notas fiscais de serviço, conheça nossa API de NFS-e — escritórios contábeis frequentemente precisam de ambos os serviços. Para a obrigação do SINTEGRA, também temos cobertura via API.

Gere arquivos SPED em 3 passos

Envie os dados da escrituração fiscal via API e receba o arquivo SPED validado e pronto para transmissão.

1

Envie os dados

Envie via POST os registros da escrituração com período, CNPJ, tipo (EFD ICMS/IPI ou PIS/COFINS) e os blocos de dados necessários.

2

API gera o arquivo

A API processa os registros, monta a estrutura completa do arquivo SPED no layout oficial e executa a validação automática.

3

Receba validado

Receba o arquivo TXT pronto para download, com relatório de validação detalhando erros e advertências encontrados.

Request POST
POST /services/Fiscal/ObterArquivoSped
Content-Type: application/json
Token: seu_token_aqui

{
  "TipoArquivo": 1,
  "CRT": 3,
  "AmbienteNotasSaidas": 1,
  "IncluirNotasSaidas": true,
  "DtInicio": "2026-03-01",
  "DtFim": "2026-03-31",
  "EfdIcmsIpiInfo": {
    "CodFinalidade": 0,
    "IndicadorPerfil": 1,
    "IndicadorAtividade": 0
  },
  "DFes": [{
    "Base64Xml": "PG5mZVByb2M...",
    "EmissaoPropia": true,
    "ModeloDocumento": 55,
    "Situacao": 0
  }]
}
Response 200 OK
{
  "Status": 1,
  "Codigo": "SPED-202603",
  "Registros": "1247 registros processados",
  "Url": "https://api.brasilnfe.com.br/files/sped/...",
  "Detalhamento": {
    "SaldoCredorTransportarIcmsIpi": 1250.00,
    "DFes": [{
      "Chave": "31260412345678000100550...",
      "CpfCnpj": "12345678000100",
      "DataMovimentacao": "2026-03-15"
    }]
  }
}
Geração EFD ICMS/IPI
Geração EFD PIS/COFINS
Validação automática
Unificação de arquivos EFD PIS/COFINS
Relatórios de validação
Download do arquivo TXT

Para empresas de serviços que também precisam emitir NFS-e, conheça a API de NFS-e. Veja também a API de SINTEGRA para obrigações correlatas.

Por que escolher Brasil NFe para SPED

Funcionalidades desenvolvidas para simplificar a geração e validação de escrituração fiscal digital via API.

Validação automática

Erros e advertências são identificados automaticamente antes do envio ao SPED. Você recebe um relatório completo com cada problema encontrado, evitando rejeições e retrabalho.

Unificação de arquivos

Combine múltiplos arquivos EFD PIS/COFINS de um mesmo período em um único arquivo consolidado. Ideal para empresas com múltiplas filiais ou fontes de dados.

Relatórios detalhados

Diagnóstico completo de cada escrituração gerada, com contagem de registros por bloco, totais de créditos e débitos, e histórico de validações.

EFD ICMS/IPI + PIS/COFINS

Ambas as escriturações fiscais digitais na mesma API, com a mesma integração, mesma autenticação e mesma estrutura de resposta. Menos código, mais produtividade.

Integração com NF-e/NFS-e

Os dados fiscais de notas emitidas via Brasil NFe podem alimentar diretamente a escrituração, reduzindo digitação manual e inconsistências nos registros.

Suporte contábil especializado

Equipe de suporte que entende blocos, registros e layouts do SPED. Atendimento técnico e contábil para dúvidas sobre a estrutura da escrituração fiscal digital.

Plano SPED

Geração e validação de EFD ICMS/IPI e PIS/COFINS com um único plano.

ou veja todos os planos

Perguntas sobre API SPED

A API suporta as duas principais escriturações fiscais digitais: a EFD ICMS/IPI (SPED Fiscal), para apuração do ICMS e do IPI, e a EFD PIS/COFINS (SPED Contribuições), para apuração das contribuições sociais PIS/Pasep, COFINS e CPRB. Ambas são geradas e validadas pela mesma API.
Sim. Toda geração de arquivo SPED passa por validação automática. A resposta da API inclui um relatório completo com erros e advertências encontrados, permitindo que você corrija os problemas antes de transmitir o arquivo ao fisco. Isso reduz drasticamente as chances de rejeição.
A unificação permite combinar múltiplos arquivos EFD PIS/COFINS de um mesmo período e CNPJ em um único arquivo consolidado. Isso é útil quando diferentes sistemas ou filiais geram arquivos separados e é necessário entregar um único arquivo ao fisco.
A API suporta todos os blocos do layout oficial da EFD ICMS/IPI: Bloco 0 (Abertura, Identificação e Referências), Bloco C (Documentos Fiscais I — Mercadorias), Bloco D (Documentos Fiscais II — Serviços), Bloco E (Apuração do ICMS e do IPI), Bloco G (CIAP — Controle de Crédito do Ativo Permanente), Bloco H (Inventário Físico), Bloco K (Controle da Produção e do Estoque), Bloco 1 (Informações Complementares) e Bloco 9 (Controle e Encerramento).
Sim. Cada CNPJ precisa de um serviço SPED contratado individualmente, mas a integração é exatamente a mesma. Você utiliza o mesmo token de API e os mesmos endpoints — basta informar o CNPJ correspondente em cada requisição. Ideal para escritórios contábeis que atendem diversos clientes.
A autenticação é feita via token de API no header Token: seu_token_aqui. Você obtém o token no Painel do Cliente após criar sua conta. O mesmo token funciona para todos os serviços contratados (SPED, NF-e, NFS-e, etc.).
A API realiza a validação do arquivo SPED e identifica erros e advertências, funcionando como uma camada de verificação antes da transmissão. No entanto, o envio oficial do arquivo ao SPED é feito pelo programa validador da Receita Federal (PVA) ou pelo portal e-CAC. A API gera o arquivo TXT já no formato correto para importação direta nesses programas.

Pronto para gerar SPED
sem complicação?

Crie sua conta e teste a geração de EFD ICMS/IPI e PIS/COFINS gratuitamente no ambiente de homologação.

Ver documentação