Censimento assistito Enti Creditori (EC)

[pintorig]

Censimento assistito EC (Enti Creditori)

Tipo: feature · Area: configurazione · Size: M
Fase: backlog post-migrazione V2

Contesto

Oggi la registrazione di un EC (Ente Creditore = Dominio lato GovPay) richiede l'inserimento manuale di tutti i dati anagrafici e tecnici. Le API pagoPA (self-care / backoffice) espongono i dati canonici degli EC censiti sul nodo. Serve un flusso assistito che precompila il form del cruscotto con i dati recuperati da pagoPA.

Riutilizzo del batch di sincronizzazione esistente: attualmente il batch pagoPA recupera solo gli IBAN abilitati per dominio. Va esteso per recuperare anche l'anagrafica EC.

Scope

A. Estensione batch pagoPA

• Estendere il batch schedulato che oggi sincronizza gli IBAN da pagoPA per recuperare anche l'anagrafica EC.
• Persistenza in una tabella cache locale (es. pagopa_enti_creditori_cache) con timestamp data_ultimo_aggiornamento.
• Campi da recuperare per ciascun EC:
  • companyName (denominazione)
  • stationId (identificativo stazione associata)
  • auxDigit (cifra ausiliaria numero avviso)
  • segregationCode (codice segregazione)
  • cbill (codice CBILL)

B. API console

• GET /pagopa/enti-creditori/{taxCode} → ritorna i dati dell'EC dalla cache (404 se non presente in pagoPA).
• GET /pagopa/enti-creditori?search=... → lookup paginato (per typeahead nel form del cruscotto).

C. Integrazione UI cruscotto

• Sul form di creazione/modifica Dominio: inserendo il codFiscale, l'UI chiama GET /pagopa/enti-creditori/{taxCode} e precompila i 5 campi. L'operatore può sovrascrivere.
• Indicatore "dati precompilati da pagoPA" + timestamp ultimo refresh.

Fuori scope

• Auto-registrazione senza intervento operatore (deve restare un'azione confermata).
• Sincronizzazione bidirezionale (GovPay → pagoPA) — solo lettura.

Acceptance criteria

• Batch pagoPA aggiornato per recuperare anche l'anagrafica EC (oltre agli IBAN).
• Tabella cache locale con i 5 campi + timestamp.
• 2 endpoint API (GET /pagopa/enti-creditori/{taxCode} + lookup).
• UI cruscotto: precompilazione form dominio con indicatore.
• Test batch + API + gestione EC non presente in pagoPA.

Dipendenze

• Batch IBAN pagoPA esistente (da estendere).
• CRUD Domini (già presente).