# Diagnóstico federal

> Pedir o relatório diagnostico_federal e ler o resumo por ocorrência.

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](/guias/enviar-sped) e espere os dois ficarem `lido`.

## 2. Peça o relatório

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

```json
{ "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`](/erros/arquivo_nao_processado).

## 3. Leia o resumo

```json title="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.