Vai al contenuto

Changelog

Tutte le modifiche rilevanti a questo sito sono elencate qui, in ordine cronologico inverso. Formato ispirato a Keep a Changelog; versionamento SemVer.

Ogni release deve avere una voce qui con lo stesso numero di versione dichiarato in partner-docs/VERSION — il controllo è automatizzato da tools/check_release.py (vedi partner-docs/README.md).

[2.4.1] - 2026-10-07

Corretto

  • Home del sito, elenco «Guide disponibili»: aggiunti i prodotti PARC — Bolletta Protetta e PARC — Fotovoltaico, con i link a guida e specifica OpenAPI.

Fonte: segnalazione del team prodotto.

[2.4.0] - 2026-10-07

Aggiunto

  • Guide PARC — Bolletta Protetta e PARC — Fotovoltaico, `9: documentazione completa dell'API di monitoraggio dell'indice giornaliero (login, endpoint, parametri di richiesta, struttura della risposta con tipi e formati, errori con messaggi e stati HTTP, note tecniche, importazione in Postman).

Modificato

  • Specifiche OpenAPI dei due prodotti: precisazioni su adesione (maiuscole e spazi), codice_intermediario (confronto esatto, zeri iniziali) e sulle adesioni pluriennali (solo il primo periodo annuale).

Fonte: codice dei servizi sull'ambiente di test (bp-revo-parametric commit de591025: middleware dell'intermediario, handler di monitoraggio, formato degli errori) e chiamate reali sull'ambiente di test del 07/10/2026 (login con credenziali errate/incomplete, richieste con parametri anomali, token assente/non valido, adesioni pluriennali).

[2.3.2] - 2026-10-07

Corretto

  • Guide PARC — Bolletta Protetta e PARC — Fotovoltaico: in caso di messaggio di scarto non comprensibile o non conforme a quanto concordato, la segnalazione va fatta aprendo un ticket secondo le modalità concordate con la Compagnia (rimosso il riferimento a un indirizzo email).

Fonte: indicazione del team prodotto.

[2.3.1] - 2026-10-07

Corretto

  • Specifiche OpenAPI PARC — Bolletta Protetta e PARC — Fotovoltaico: descrizione del campo highlight della risposta di monitoraggio dell'indice (usato dall'interfaccia per evidenziare le fasce orarie dei prodotti con indice orario; per questi prodotti, con indice giornaliero, vale sempre 0).

Fonte: codice del servizio sull'ambiente di test (subscription.go, costruzione della risposta di monitoraggio) e indicazione del team prodotto sull'uso del campo da parte dell'interfaccia.

[2.3.0] - 2026-10-07

Aggiunto

  • Guida e specifica OpenAPI del prodotto PARC — Bolletta Protetta: scambio file CSV (adesioni, storni, esiti, certificati, indennizzi), regole di validazione, messaggi di scarto ed esempi, più l'API di monitoraggio dell'indice giornaliero di temperatura con il login.
  • Guida e specifica OpenAPI del prodotto PARC — Fotovoltaico: scambio file CSV (adesioni, storni, esiti, certificati, indennizzi), regole di validazione, messaggi di scarto ed esempi, più l'API di monitoraggio dell'indice giornaliero di irraggiamento con il login. La sezione sull'esito degli storni è da definire (TBD).

Fonte: codice dei servizi sull'ambiente di test (commit bp-revo-parametric de591025, om-reverse-proxy 972b2343, checklist di validazione dei prodotti) e chiamate reali sull'ambiente di test del 07/10/2026 (flussi CSV di emissione, errori, storno e indennizzi; login e API di monitoraggio); template dei tracciati dati forniti dal team prodotto.

[2.2.0] - 2026-10-06

Aggiunto

  • Guida e specifica OpenAPI dei prodotti R04x — Volo Protetto (R044 Volo Protetto, R042 Flight Delay, R043 Flight Cancellation): login, ricerca volo, emissione dell'adesione e annullamento, con regole di validazione, errori ed esempi di payload per aderente persona fisica, persona giuridica e ditta individuale.

Fonte: specifica Swagger R04x del 21/09, verificata con chiamate reali sull'ambiente di test (ricerca volo, emissione per i tre prodotti, annullamento).

[2.1.1] - 2026-10-06

Modificato

  • Guida A001 Travel: titolo ridotto a «A001 Travel»; §6 rinominato «Bene assicurato» con precisazione che tipoBene vale sempre viaggioAssicurato; descrizione di A001 nell'indice allineata.

Fonte: review del business; verifica su PROD (tutte le 6.217 adesioni A001 su OXC0003, OXC0005 e OXC0007 hanno tipo_bene = viaggioAssicurato) e prova UAT del 05/10 (gruppo di assicurati → unsupported tipoBene).

[2.1.0] - 2026-10-05

Corretto

  • Guida OS Sinistri — Partner Integration v2, verificata sull'ambiente di test con chiamate reali:
    • GET /claim/status risolve l'esito di apertura e chiusura senza seguito (SUCCESS) e della riapertura (anche FAILED con code 7500 e motivo in description);
    • restano non interrogabili su /claim/status solo PUT /claim/injured-party e POST /claim/documents, con le indicazioni per verificarne l'esito;
    • sinistroId restituito da /claim/status è l'identificativo interno (UUID) del sinistro; GET /claim/financials richiede il numero sinistro.
  • Descrizione OpenAPI del caricamento allegati allineata al comportamento reale.

  • Pagamento e annullamento pagamento verificati: esiti su /claim/status, obbligo di codice fiscale o partita IVA del beneficiario, annullamento ripetuto che risponde 201.

Modificato

  • Riserve: la guida segnala che sui sinistri A001 la garanzia non viene risolta (404), in attesa di correzione.
  • GET /claim/financials indicata come non ancora utilizzabile (richiede il numero sinistro REVO, non restituito dalle API); verrà integrata in un rilascio successivo. Per le altre operazioni usare numeroSinistroEsterno.

[2.0.0] - 2026-10-05

Corretto

  • Guida e specifica A001 riviste e verificate sull'ambiente di test con chiamate reali di emissione, recupero, storno e allegati:
    • percorsi degli endpoint: l'emissione è POST /collettive/adesioni/ e lo storno è POST /collettive/movimenti/{numeroPolizza}/create-by-adesione; i percorsi precedenti non esistono;
    • tipoBene è viaggioAssicurato (il valore precedente non era accettato in emissione);
    • risposta dello storno: 202 senza corpo, elaborazione asincrona, numeroAdesione come lista e frazionamento facoltativo; tipi di movimento con le condizioni di applicabilità;
    • autenticazione: header mancante → 403, token non valido → 401;
    • identificativo della garanzia Rischio Volo e valori degli altri campi di esempio.
  • Campi calcolati da REVO (keyPolizza, codiceProdotto, identificativo del bene, idGarOverx, nomeGaranzia, codAnagGar, ramoBilancio, id interni) indicati come facoltativi.

Aggiunto

  • Catalogo completo delle 16 garanzie del prodotto A001 con descrizione, aliquota di riferimento e variabili tecniche, e istruzioni per inserirle in un'adesione (garanzie attive sulla polizza, massimo 15 per adesione, pacchetti parziali).
  • Flusso asincrono dell'emissione e stati dell'adesione (EMESSA, INCASSATA, ERRORE_*, annulli) con tempi tipici.
  • Requisiti di contraente (codice fiscale coerente con nome e cognome, indirizzo con CAP), bene assicurato e premio per il completamento dell'emissione.
  • Dati volo (dataGridVoloAssicurato, numeroVoloAssTot, indennizzoVolo) e API di recupero dati volo.
  • Elenco allegati (GET /collettive/allegato/list/{idAdesione}), parametri dell'upload e dettaglio delle risposte.
  • Codici di errore e messaggi di validazione con i corpi delle risposte.

Fonte: verifica con chiamate reali sull'ambiente di test.

[1.8.0] - 2026-09-22

Aggiunto

  • Note nella guida OS Sinistri — Partner Integration v2 sulla verificabilità dell'esito delle operazioni asincrone.

[1.7.0] - 2026-09-22

Aggiunto

  • Nuovo prodotto OS Sinistri — Partner Integration v2: guida di integrazione completa (autenticazione, pattern comuni, 14 operazioni, linee guida operative) e specifica OpenAPI 3.1.0.
  • Nuova voce di primo livello nella navigazione e nuova riga nella tabella dei prodotti in home.

Verificato

  • Forma degli endpoint allegati (§6.12 e §6.13: parametri di query e parte multipart file), convenzione del codice garanzia, validazione della valuta sul pagamento e gestione dell'errore 500.

[1.6.0] - 2026-09-22

Aggiunto

  • Logo REVO nell'intestazione del sito, come favicon e nella home page.

[1.5.0] - 2026-09-22

Corretto

  • Schema della risposta di login (A001, §2): oltre ad access_token, la risposta include token_type, expires_in, refresh_token, refresh_expires_in, id_token, scope, session_state, not-before-policy.

[1.4.0] - 2026-09-22

Aggiunto

  • Documentata la risposta dell'endpoint di login (A001, §2).

Corretto

  • Chiarito che durata, retrodatazione, postdatazione e finestra di sottoscrizione sono vincoli commerciali applicati dal motore tariffario del partner e non rivalidati dall'API di adesione.

[1.3.0] - 2026-09-22

Corretto

  • A001: status HTTP di successo dell'emissione 200 OK (non 201 Created) e validazioni semantiche con risposta 400 (mai 422).
  • A001: numeroTelefono è di tipo string, non number.
  • A001: obbligatorietà dei campi di personaGiuridica e dittaIndividuale; dataNascita ricavata dal codice fiscale; partitaIva della ditta individuale facoltativa con vincolo di formato.
  • A001: l'identificativo del bene assicurato non ha vincoli di formato UUID.

Aggiunto

  • A001: corpo della risposta di emissione.
  • A001: risposta 409 Conflict per numeroAdesioneEsterno duplicato.
  • A001: verifica di coerenza tra impAnnuo, tassePerc e lordoAnnuo.

[1.2.0] - 2026-09-22

Corretto

  • Rimosso ogni riferimento a un partner specifico da guida, specifica OpenAPI, indice e navigazione: la documentazione riguarda il prodotto REVO A001, disponibile a qualunque partner autorizzato. Cartella e URL rinominati di conseguenza.

[1.1.1] - 2026-09-21

Modificato

  • A001: sezioni della guida riordinate per una lettura più lineare.
  • A001: aggiunto POST /sicurezza/login alla specifica OpenAPI e un riepilogo di tutti gli endpoint (§3).

Corretto

  • A001: indicati i campi id assegnati sempre da REVO (possono essere omessi). Aggiornato dalla 2.0.0.

[1.1.0] - 2026-09-21

Aggiunto

  • A001: schemi personaGiuridica e dittaIndividuale per il contraente, con nota di mutua esclusività con personaFisica.
  • A001: operazioni di recupero adesione, storno adesione e gestione allegati.

Chiarito

  • A001: la modifica polizza (endorsement) non è un'operazione disponibile.

[1.0.0] - 2026-08-06

Aggiunto

  • Prima pubblicazione della guida di integrazione A001 e della specifica OpenAPI 3.0.3 (garanzia Rischio Volo).