#16 [M1] Endpoint Persone Non Fisiche (PNF) — ricerca catasto per partita IVA

[Anonymous]

Originally created by: zornade

Contesto

Parte della Roadmap v0.2 [#15] — Milestone 1.

Obiettivo

Esporre via API la ricerca catastale per soggetti Persone Non Fisiche (società, enti, partite IVA) sul portale SISTER.

API proposta

POST /visura/pnf
Content-Type: application/json

{
  "partita_iva": "12345678901",
  "provincia": "RM"
}

Output (sincrono con request_id, da combinare con il polling esistente):

• lista immobili intestati alla persona giuridica
• per ciascuno: foglio, particella, subalterno, comune, classamento, partita

Lavoro richiesto

• [ ] Verificare il flusso PNF sul portale SISTER da account CONSULTAZIONI - PROFILO B.
• [ ] Catturare HTML con PageLogger per identificare i selettori del form di ricerca PNF.
• [ ] Aggiungere run_visura_pnf() in utils.py seguendo lo stile delle funzioni esistenti.
• [ ] Modello Pydantic VisuraPNFRequest + VisuraPNFResult.
• [ ] Endpoint POST /visura/pnf in main.py, instradato dalla VisuraService esistente.
• [ ] Test di smoke con almeno 2 P.IVA reali (società piccola + società con molti immobili).
• [ ] Documentare nel README la sezione "Visura PNF (Fase 3)".

Note tecniche

• Il portale SISTER per PNF presenta probabilmente un form distinto da quello PF: validare con HTML log.
• La validazione P.IVA va fatta a livello Pydantic (11 cifre + algoritmo di controllo).
• Considerare casi di partite IVA cessate (Soppressa).

Casi edge da gestire

• P.IVA non trovata → lista vuota + error valorizzato.
• Soggetto cessato → flag esplicito.
• Soggetto con > 100 immobili → paginazione lato portale, verificare comportamento.