Referência técnica

API RecuperaSPED

Integre consulta, solicitação e download de SPED Federal diretamente no seu sistema via REST. Autenticação por chave de API, respostas em JSON.

Endpoints ativos

POST/api/sped/pesquisar

Pesquisa arquivos SPED disponíveis na Receita Federal para um dado certificado e critério.

POST/api/sped/solicitar

Solicita a extração dos arquivos identificados na pesquisa.

POST/api/sped/verificar

Verifica o status de um pedido de extração e lista os arquivos disponíveis para download.

POST/api/sped/baixar

Realiza o download de um arquivo SPED individual pelo ID do arquivo.

POST/api/sped/jobs

Cria um job assíncrono para processar múltiplas consultas em fila.

GET/api/sped/jobs/[jobId]

Consulta o status e resultado de um job assíncrono pelo ID.

Autenticação

Todos os endpoints requerem um header X-API-Key com sua chave de API. Gere ou visualize sua chave no painel em Chave API.

curl

curl -X POST https://recuperasped.com.br/api/sped/pesquisar \
  -H "Content-Type: application/json" \
  -H "X-API-Key: sua-chave-aqui" \
  -d '{
    "certBase64": "<pfx em base64>",
    "certPassword": "senha",
    "sistema": "SPED Fiscal - EFD ICMS IPI",
    "tipoArquivo": "1602",
    "tipoPesquisa": "porCNPJIEPeriodoContribuinte",
    "campos": {
      "cnpj": "12345678000199",
      "dataInicio": "01/01/2025",
      "dataFim": "31/12/2025"
    }
  }'

Os endpoints de extratos SEFAZ estaduais (RS, SC, PR, SP, SAT-SP) foram descontinuados neste projeto. Apenas o fluxo SPED Federal está ativo.