Diagnóstico federal

O relatório diagnostico_federal aponta ocorrências de inconsistência de PIS e COFINS no período, com a contagem por ocorrência. As ocorrências de revisão manual ficam fora da API: para elas, fale com a equipe da RMF.

Escopos relatorios:criar, relatorios:ler

1. Envie os arquivos

O tipo usa a EFD ICMS/IPI e a EFD Contribuições da mesma empresa e do mesmo período. Envie os dois como em Enviar o SPED e espere os dois ficarem lido.

2. Peça o relatório

POST /v1/relatorios com Idempotency-Key. Pela empresa e período:

{ "tipo": "diagnostico_federal", "cnpj": "11222333000181", "periodo": { "inicio": "2026-09", "fim": "2026-09" } }

Ou pelo arquivo: { "tipo": "diagnostico_federal", "arquivo_id": "arq_..." }. Arquivo que ainda não está lido responde 409 arquivo_nao_processado.

3. Leia o resumo

200 OK de GET /v1/relatorios/{id} (recorte, valores ilustrativos)

{
  "tipo": "diagnostico_federal",
  "estado": "concluido",
  "resumo": {
    "tipo": "diagnostico_federal",
    "total_ocorrencias": 2,
    "ocorrencias": [
      { "codigo": "oc_001", "titulo": "CST x alíquota divergentes", "quantidade": 14, "valor_envolvido": "53210.00" },
      { "codigo": "oc_008", "titulo": "Alerta de recebimento de arquivos sem movimento", "quantidade": 1, "valor_envolvido": null }
    ]
  }
}

O resumo traz o resultado por ocorrência: quantas vezes aconteceu e o valor envolvido, sem o caminho do cálculo. Relatório sem nada a apontar termina em concluido_sem_dados. A planilha de resultado só vem se o plano da conta a incluir.