openapi: 3.1.0
info:
  title: REVO OverX Sinistri - Partner Integration API (v2)
  description: 'Superficie API per i partner esterni di OverX Sinistri.


    Il payload e'' orientato al dominio: il partner indica sinistro, danneggiato e garanzia per riferimento
    di business, e il back-end deduce dal contesto di polizza i parametri tecnici (titolo amministrativo,
    garanzia colpita, processo, riserva di apertura). Nessun identificativo interno REVO e'' richiesto
    in ingresso.


    Le operazioni di scrittura sono asincrone: rispondono 201 con requestId e correlationId, e l''esito
    si legge su GET /partnerIntegration/claim/status?requestId=. Unica eccezione l''invio email, che risponde
    200 con esito sincrono.


    Convenzione sui codici di garanzia: si indicano come coppia in due campi distinti, codiceGaranzia
    (senza punto) e codicePrestazione. Il codice puntato non e'' ammesso in ingresso.


    Ambiente di riferimento: UAT.'
  version: UAT 2026-09-21
servers:
- url: https://testoverx-sinistri-api.elbassicurazioni.it/api/v1/integration
  description: Generated server url
tags:
- name: Partner Integration - Danneggiato
  description: Inserimento e aggiornamento del danneggiato da partner esterni (v2). / Injured party upsert
    for external partners.
- name: Partner Integration
  description: Endpoint REST per l’apertura sinistro da partner esterni (Partner Integration v2). / REST
    endpoints for claim creation from external partners.
- name: Partner Integration - Pagamenti
  description: Pagamento e annullamento pagamento da partner esterni (v2). / Payment and payment cancellation
    for external partners.
- name: Partner Integration - Riapertura
  description: Riapertura del sinistro da partner esterni (v2). / Claim reopening for external partners.
- name: Partner Integration - Chiusura
  description: Chiusura senza seguito del sinistro da partner esterni (v2). / Claim closure without follow-up
    for external partners.
- name: Partner Integration - Documenti ed email
  description: Allegati del sinistro e invio email da partner esterni (v2). / Claim documents and e-mail
    sending for external partners.
- name: Partner Integration - Riserve
  description: Aggiornamento delle riserve da partner esterni (v2). / Reserve update for external partners.
paths:
  /partnerIntegration/claim/reserves:
    put:
      tags:
      - Partner Integration - Riserve
      summary: Aggiorna le riserve di un sinistro. / Update the reserves of a claim.
      description: 'Il sinistro, il danneggiato e la garanzia si indicano con riferimenti di business:
        nessun identificativo tecnico in ingresso. Gli attributi tecnici della garanzia (productCoverCode,
        chiaveRischio, keyCondizione) non sono input e li risolve il back-end sulla garanzia gia'' aperta.
        L''operazione e'' asincrona: risponde 201 con requestId e correlationId, l''esito si legge su
        GET /partnerIntegration/claim/status?requestId=. / Asynchronous; poll the claim status endpoint
        for the outcome.'
      operationId: updateRiserve
      parameters:
      - name: requestId
        in: header
        description: Identificativo univoco della richiesta lato chiamante (UUID). / Caller-side unique
          request identifier.
        required: true
        schema:
          type: string
          format: uuid
        example: 3fa85f64-5717-4562-b3fc-2c963f66afa6
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PartnerReserveRequestDTO'
        required: true
      responses:
        '201':
          description: Richiesta presa in carico. / Request accepted.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PartnerOperationResponseDTO'
        '400':
          description: Richiesta non interpretabile in fase di risoluzione. / Unresolvable request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExceptionObject'
        '422':
          description: 'Violazione del contratto: riferimento al sinistro assente o multiplo, importo
            non positivo, codiceGaranzia con il punto invece della coppia. / Contract violation.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExceptionObject'
        '404':
          description: Sinistro, danneggiato o garanzia inesistenti. / Claim, injured party or cover not
            found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExceptionObject'
        '409':
          description: 'Riferimento ambiguo: piu'' candidati, elencati nel messaggio. / Ambiguous reference.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExceptionObject'
        '500':
          description: 'Il core non ha confermato la presa in carico: l''aggiornamento NON e'' stato accettato
            e non esiste un requestId da interrogare. La richiesta va ripetuta. / The core did not acknowledge
            the request: nothing was accepted and there is no requestId to poll; retry.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExceptionObject'
      security:
      - bearerToken: []
  /partnerIntegration/claim/injured-party:
    put:
      tags:
      - Partner Integration - Danneggiato
      summary: Upsert danneggiato (v2)
      description: Inserisce o aggiorna il danneggiato sul sinistro. La scelta fra inserimento e aggiornamento
        si basa sulla chiave naturale (tipo danneggiato + codice fiscale o partita IVA), non su un id
        tecnico. / Upserts the injured party by natural key.
      operationId: upsertDanneggiato
      parameters:
      - name: requestId
        in: header
        description: An UUID to identify the client request is REQUIRED *
        required: true
        schema:
          type: string
          format: uuid
        example: 3fa85f64-5717-4562-b3fc-2c963f66afa6
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PartnerInjuredPartyRequestDTO'
        required: true
      responses:
        '201':
          description: Danneggiato inserito o aggiornato / Injured party inserted or updated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PartnerOperationResponseDTO'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExceptionObject'
        '404':
          description: Sinistro non trovato / Claim not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExceptionObject'
        '409':
          description: Chiave del danneggiato non discriminante / Ambiguous injured party key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExceptionObject'
        '500':
          description: Il core non ha confermato la presa in carico / The core did not acknowledge the
            request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExceptionObject'
      security:
      - bearerToken: []
  /partnerIntegration/claim:
    post:
      tags:
      - Partner Integration
      summary: Creazione sinistro da partner esterno (v2)
      description: Crea un nuovo sinistro a partire da un payload normalizzato e orientato al dominio
        (polizza, evento, danneggiato, comunicazioni). I parametri tecnici (garanzia colpita, processo,
        riserva di apertura, ecc.) vengono dedotti dal contesto di polizza e dalle regole di business.
        Il sinistro è trattato come Claims Made se è valorizzata almeno una tra evento.dataRichiestaRisarcimento
        ed evento.dataNotificaCircostanza. / Creates a new claim from a normalized payload (policy, event,
        damaged party, communications). Technical parameters are derived from the policy context.
      operationId: createClaim
      parameters:
      - name: requestId
        in: header
        description: Identificativo univoco della richiesta lato chiamante (UUID). / Unique client request
          identifier (UUID).
        required: true
        schema:
          type: string
          format: uuid
        example: 3fa85f64-5717-4562-b3fc-2c963f66afa6
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ClaimCreatePartnerDTO'
        required: true
      responses:
        '201':
          description: 'Sinistro creato correttamente. La risposta contiene un identificativo asincrono
            per tracciare l’elaborazione e la riserva di apertura applicata (importo + fonte: INPUT|PRODOTTO|LOB|PARACADUTE).
            / Claim created successfully (asynchronous response with tracking id and the applied opening
            reserve).'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ClaimPartnerResponseDTO'
        '400':
          description: Richiesta non leggibile o non coerente (errore di parsing JSON o dati non validi,
            es. formato data/enum non valido, riservaApertura <= 0, idPolizzaEsterna non coerente). /
            Malformed or inconsistent request (JSON parse error or invalid business data).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExceptionObject'
        '422':
          description: 'Errore di validazione del payload: blocchi obbligatori mancanti o combinazioni
            di campi non coerenti. I dettagli sono restituiti nel campo message. / Payload validation
            error (missing required blocks or invalid field combinations).'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExceptionObject'
        '404':
          description: 'Risorsa non trovata: polizza, titolo o garanzia non individuata in base ai riferimenti
            forniti. / Resource not found (policy, movement id or coverage not found).'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExceptionObject'
        '409':
          description: 'Conflitto: esiste già un sinistro coerente con i riferimenti esterni indicati
            (duplicato). / Conflict (duplicate claim based on external/broker references).'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExceptionObject'
        '500':
          description: Errore interno inatteso del servizio. / Unexpected internal server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExceptionObject'
      security:
      - bearerToken: []
  /partnerIntegration/claim/reopen:
    post:
      tags:
      - Partner Integration - Riapertura
      summary: Riapre un sinistro chiuso. / Reopen a closed claim.
      description: 'Il danneggiato si indica per chiave naturale se e'' gia'' sul sinistro, con la sua
        anagrafica se e'' nuovo; la garanzia per codice, e puo'' non essere mai stata aperta — viene cercata
        sul riepilogo garanzie della polizza. L''operazione e'' asincrona: risponde 201 con requestId
        e correlationId, l''esito si legge su GET /partnerIntegration/claim/status?requestId=. / Asynchronous;
        poll the claim status endpoint for the outcome.'
      operationId: reopenClaim
      parameters:
      - name: requestId
        in: header
        description: Identificativo univoco della richiesta lato chiamante (UUID). / Caller-side unique
          request identifier.
        required: true
        schema:
          type: string
          format: uuid
        example: 3fa85f64-5717-4562-b3fc-2c963f66afa6
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PartnerReopenRequestDTO'
        required: true
      responses:
        '201':
          description: Richiesta presa in carico. / Request accepted.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PartnerOperationResponseDTO'
        '400':
          description: Richiesta non interpretabile in fase di risoluzione, o garanzia indicata con codicePrestazione/chiaveGaranzia,
            che questa operazione non sa usare. / Unresolvable request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExceptionObject'
        '422':
          description: 'Violazione del contratto: riferimento al sinistro assente o multiplo, danneggiato
            ne'' riferito ne'' descritto, importo non positivo, codiceGaranzia con il punto. / Contract
            violation.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExceptionObject'
        '404':
          description: Sinistro inesistente; danneggiato inesistente e senza anagrafica; garanzia assente
            dal riepilogo di polizza. / Not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExceptionObject'
        '409':
          description: Riferimento ambiguo. / Ambiguous reference.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExceptionObject'
        '500':
          description: 'Il core non ha confermato la presa in carico: la riapertura NON e'' stata accettata
            e non esiste un requestId da interrogare. La richiesta va ripetuta. / The core did not acknowledge
            the request: nothing was accepted and there is no requestId to poll; retry.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExceptionObject'
      security:
      - bearerToken: []
  /partnerIntegration/claim/payment:
    post:
      tags:
      - Partner Integration - Pagamenti
      summary: Pagamento sinistro (v2)
      description: 'Registra un pagamento sul sinistro indicando sinistro, danneggiato e garanzie con
        i riferimenti di business, e chi esegue il pagamento. L''esito e'' asincrono: si legge per requestId.
        / Registers a payment using business references; outcome is asynchronous.'
      operationId: creaPagamento
      parameters:
      - name: requestId
        in: header
        description: An UUID to identify the client request is REQUIRED *
        required: true
        schema:
          type: string
          format: uuid
        example: 3fa85f64-5717-4562-b3fc-2c963f66afa6
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PartnerPaymentRequestDTO'
        required: true
      responses:
        '201':
          description: Pagamento accettato / Payment accepted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PartnerOperationResponseDTO'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExceptionObject'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExceptionObject'
        '409':
          description: Riferimento ambiguo / Ambiguous reference
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExceptionObject'
        '500':
          description: Il core non ha confermato la presa in carico / The core did not acknowledge the
            request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExceptionObject'
      security:
      - bearerToken: []
  /partnerIntegration/claim/payment/{requestIdPagamento}/cancel:
    post:
      tags:
      - Partner Integration - Pagamenti
      summary: Annullamento pagamento (v2)
      description: 'Annulla il pagamento creato con il requestId indicato nel path — la stessa chiave
        con cui il partner lo ha creato, non l''idTask di cContact. Un pagamento gia'' stornato risponde
        409, non 200. L''esito e'' asincrono: si legge per requestId. / Cancels the payment created with
        the requestId in the path; 409 when already reversed.'
      operationId: annullaPagamento
      parameters:
      - name: requestId
        in: header
        description: An UUID to identify the client request is REQUIRED *
        required: true
        schema:
          type: string
          format: uuid
        example: 3fa85f64-5717-4562-b3fc-2c963f66afa6
      - name: requestIdPagamento
        in: path
        description: requestId con cui il pagamento da annullare e' stato creato / requestId the payment
          was created with
        required: true
        schema:
          type: string
        example: 78c54a9d-1174-466c-9f03-8b15e7e19266
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PartnerPaymentCancelRequestDTO'
        required: true
      responses:
        '201':
          description: Annullamento accettato / Cancellation accepted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PartnerOperationResponseDTO'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExceptionObject'
        '404':
          description: Nessun pagamento creato con quel requestId / No payment created with that requestId
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExceptionObject'
        '409':
          description: Il pagamento e' gia' stornato o ha lo storno in corso / The payment is already
            reversed or its reversal is in progress
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExceptionObject'
        '500':
          description: Il core non ha confermato la presa in carico / The core did not acknowledge the
            request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExceptionObject'
      security:
      - bearerToken: []
  /partnerIntegration/claim/email:
    post:
      tags:
      - Partner Integration - Documenti ed email
      summary: Invia un'email per conto del sinistro. / Send an e-mail on behalf of the claim.
      description: 'ECCEZIONE AL PATTERN ASINCRONO DEL LAYER v2: questa e'' l''unica operazione con esito
        SINCRONO. Il core non espone un endpoint di invio email, quindi l''invio non attraversa la pipeline asincrona
        e non produce un requestId interrogabile su /partnerIntegration/claim/status: va direttamente
        a cContact e risponde 200 con l''esito. Il mittente e il ticket cContact li risolve il back-end
        dal sinistro (taskId e from non sono input); oggetto e corpo vengono troncati al limite che cContact
        accetta. / EXCEPTION to the v2 asynchronous pattern: the only synchronous operation, answering
        200 with the outcome, because the core exposes no e-mail send endpoint.'
      operationId: sendEmail
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PartnerEmailRequestDTO'
        required: true
      responses:
        '200':
          description: Esito dell'invio. / Send outcome.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PartnerEmailResponseDTO'
        '422':
          description: 'Violazione del contratto: riferimento al sinistro assente o multiplo, destinatari
            assenti o non validi, oggetto o corpo mancanti. / Contract violation.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExceptionObject'
        '404':
          description: Sinistro inesistente, o nessun mittente configurato sulla coda cContact. / Claim
            not found, or no sender configured.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExceptionObject'
        '409':
          description: Riferimento ambiguo. / Ambiguous reference.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExceptionObject'
      security:
      - bearerToken: []
  /partnerIntegration/claim/documents:
    get:
      tags:
      - Partner Integration - Documenti ed email
      summary: Elenca gli allegati del sinistro. / List the attachments of the claim.
      description: Restituisce i metadati degli allegati. L'allegatoId restituito qui e' il riferimento
        da usare per il download e per gli allegati delle email. / The returned allegatoId is the reference
        used for download and e-mail attachments.
      operationId: listDocuments
      parameters:
      - name: sinistro
        in: query
        required: true
        schema:
          $ref: '#/components/schemas/ClaimReferenceDTO'
      responses:
        '200':
          description: Elenco degli allegati. / Attachment list.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/PartnerAllegatoDTO'
        '422':
          description: Riferimento al sinistro assente o multiplo. / Invalid reference.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExceptionObject'
        '404':
          description: Sinistro inesistente. / Claim not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExceptionObject'
        '409':
          description: Riferimento ambiguo. / Ambiguous reference.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExceptionObject'
      security:
      - bearerToken: []
    post:
      tags:
      - Partner Integration - Documenti ed email
      summary: Carica un allegato sul sinistro. / Upload an attachment to the claim.
      description: 'Il sinistro si indica nei parametri di query con uno dei tre riferimenti di business;
        taskId ed entityId del v1 non sono input. L''operazione e'' asincrona: risponde 201 con requestId
        e correlationId, ma il requestId NON e'' interrogabile su /partnerIntegration/claim/status (resta PENDING):
        l''allegato e'' acquisito quando compare in GET /partnerIntegration/claim/documents. / Asynchronous;
        the requestId never resolves on the claim status endpoint, check the attachment list instead.'
      operationId: uploadDocument
      parameters:
      - name: requestId
        in: header
        description: Identificativo univoco della richiesta lato chiamante (UUID). / Caller-side unique
          request identifier.
        required: true
        schema:
          type: string
          format: uuid
      requestBody:
        content:
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/ClaimReferenceDTO'
      responses:
        '201':
          description: Allegato preso in carico. / Attachment accepted.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PartnerOperationResponseDTO'
        '400':
          description: Richiesta non interpretabile in fase di risoluzione. / Unresolvable request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExceptionObject'
        '422':
          description: 'Violazione del contratto: riferimento al sinistro assente o multiplo, file mancante.
            / Contract violation.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExceptionObject'
        '404':
          description: Sinistro inesistente. / Claim not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExceptionObject'
        '409':
          description: Riferimento ambiguo. / Ambiguous reference.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExceptionObject'
        '500':
          description: 'Il core non ha confermato l''acquisizione: l''allegato NON e'' stato acquisito
            e non esiste un requestId da interrogare. La richiesta va ripetuta. / The core did not acknowledge
            the upload; retry.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExceptionObject'
      security:
      - bearerToken: []
  /partnerIntegration/claim/closure:
    post:
      tags:
      - Partner Integration - Chiusura
      summary: Chiusura senza seguito (v2)
      description: Chiude senza seguito il sinistro indicato. Risponde 409 se sul sinistro ci sono pagamenti
        in corso. / Closes the claim without follow-up; 409 when payments are in progress.
      operationId: chiudiSenzaSeguito
      parameters:
      - name: requestId
        in: header
        description: An UUID to identify the client request is REQUIRED *
        required: true
        schema:
          type: string
          format: uuid
        example: 3fa85f64-5717-4562-b3fc-2c963f66afa6
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PartnerClosureRequestDTO'
        required: true
      responses:
        '201':
          description: Chiusura accettata / Closure accepted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PartnerOperationResponseDTO'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExceptionObject'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExceptionObject'
        '409':
          description: Il sinistro ha pagamenti in corso / The claim has payments in progress
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExceptionObject'
        '500':
          description: Il core non ha confermato la presa in carico / The core did not acknowledge the
            request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExceptionObject'
      security:
      - bearerToken: []
  /partnerIntegration/claim/status:
    get:
      tags:
      - Partner Integration
      summary: Esito asincrono dell'apertura sinistro da partner esterno (v2)
      description: Restituisce lo stato di elaborazione dell'apertura sinistro avviata in modo asincrono,
        a partire dall'identificativo di richiesta. Lo stato e' SUCCESS (aperto), FAILED (fallito con
        codice/descrizione) o PENDING (in lavorazione, anche per requestId non ancora noto). Il campo
        sinistroId e' valorizzato solo a esito SUCCESS. / Returns the processing status of an asynchronous
        claim creation, identified by the request id (SUCCESS | FAILED | PENDING).
      operationId: getClaimStatus
      parameters:
      - name: requestId
        in: query
        description: Identificativo univoco della richiesta di apertura (UUID). / Unique claim creation
          request identifier (UUID).
        required: true
        schema:
          type: string
          format: uuid
        example: 3fa85f64-5717-4562-b3fc-2c963f66afa6
      responses:
        '200':
          description: Esito recuperato correttamente. / Status retrieved successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ClaimStatusDTO'
        '500':
          description: Errore interno inatteso del servizio o del core sinistri. / Unexpected internal
            server error or downstream core error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExceptionObject'
      security:
      - bearerToken: []
  /partnerIntegration/claim/financials:
    get:
      tags:
      - Partner Integration
      summary: Dati economici del sinistro (v2) - non ancora utilizzabile
      description: 'NON ANCORA UTILIZZABILE dal partner: richiede il numero sinistro REVO, che le API non restituiscono; sara'' integrata in un rilascio successivo. Restituisce quanto REVO ha liquidato sul sinistro (pagamenti indennizzo e spese) e
        la riserva ancora residua, con la valuta di riferimento. Gli importi sono quelli calcolati dal
        core sinistri: nessuna rielaborazione lato integrazione. Un totale valorizzato a null significa
        "non disponibile", non "zero". / Returns the amount settled by REVO on the claim (indemnity and
        expense payments) and the outstanding reserve, with the reference currency. A null total means
        "not available", not "zero".'
      operationId: getClaimFinancials
      parameters:
      - name: sinistroId
        in: query
        description: Numero sinistro REVO. Accetta anche la forma con il suffisso del liquidatore. / REVO
          claim number, also accepted with the adjuster suffix.
        required: true
        schema:
          type: string
        example: ELB.25.001234.0
      responses:
        '200':
          description: Dati economici recuperati correttamente. / Financial data retrieved successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SinistroFinancialsDTO'
        '404':
          description: Sinistro non trovato a partire dal numero indicato. / Claim not found for the given
            claim number.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExceptionObject'
        '500':
          description: Errore interno inatteso del servizio o del core sinistri. / Unexpected internal
            server error or downstream core error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExceptionObject'
      security:
      - bearerToken: []
  /partnerIntegration/claim/documents/{allegatoId}:
    get:
      tags:
      - Partner Integration - Documenti ed email
      summary: Scarica un allegato del sinistro. / Download a claim attachment.
      description: L'allegatoId e' quello restituito da GET /partnerIntegration/claim/documents. / The
        allegatoId is the one returned by the documents list endpoint.
      operationId: downloadDocument
      parameters:
      - name: allegatoId
        in: path
        description: Identificativo dell'allegato restituito dall'elenco. / Attachment identifier returned
          by the list endpoint.
        required: true
        schema:
          type: string
          format: uuid
      responses:
        '200':
          description: Contenuto del file. / File content.
          content:
            application/octet-stream:
              schema:
                type: object
        '404':
          description: Allegato inesistente. / Attachment not found.
          content:
            application/octet-stream:
              schema:
                $ref: '#/components/schemas/ExceptionObject'
        '413':
          description: Allegato troppo grande. / Attachment too large.
          content:
            application/octet-stream:
              schema:
                $ref: '#/components/schemas/ExceptionObject'
      security:
      - bearerToken: []
  /partnerIntegration/claim/closure/reasons:
    get:
      tags:
      - Partner Integration - Chiusura
      summary: Motivi di chiusura senza seguito
      description: DDL dei motivi attivi, servita dal core. / Active closure reasons, served by the core.
      operationId: motiviSenzaSeguito
      responses:
        '200':
          description: Elenco dei motivi / Reason list
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/MotivoSenzaSeguitoDTO'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExceptionObject'
      security:
      - bearerToken: []
components:
  schemas:
    ClaimCreatePartnerDTO:
      type: object
      description: Payload di richiesta per l’apertura sinistro da partner esterno (v2). / Request payload
        for partner claim creation (v2).
      properties:
        numeroSinistroEsterno:
          type: string
          description: Riferimento sinistro nel sistema esterno/delegataria (facoltativo). / Claim reference
            in the external system (optional).
          example: EXT-2026-445566
        numeroSinistroBroker:
          type: string
          description: Riferimento sinistro nel sistema del broker (facoltativo). / Claim reference in
            the broker's system (optional).
          example: BROKER-CLM-2026-000123
        polizza:
          $ref: '#/components/schemas/PolizzaDTO'
          description: Blocco di riferimento polizza su cui aprire il sinistro. / Policy reference block.
        evento:
          $ref: '#/components/schemas/EventoDTO'
          description: Blocco dati evento del sinistro. / Claim event details block.
        danneggiato:
          $ref: '#/components/schemas/DanneggiatoDTO'
          description: Blocco dati soggetto danneggiato  (facoltativo). / Damaged party block (optional).
        comunicazioni:
          $ref: '#/components/schemas/ComunicazioniDTO'
          description: Blocco comunicazioni per conferme e notifiche (facoltativo). / Communications block
            for confirmations and notifications (optional).
      required:
      - evento
      - polizza
    ClaimPartnerResponseDTO:
      type: object
      description: Risposta asincrona di apertura sinistro arricchita con la riserva applicata. / Asynchronous
        claim-creation response enriched with the applied reserve.
      properties:
        requestId:
          type: string
          format: uuid
        correlationId:
          type: string
          format: uuid
        entityId:
          type: string
          format: uuid
        riservaApplicata:
          $ref: '#/components/schemas/RiservaApplicataDTO'
          description: Riserva di apertura applicata (importo EUR + fonte). / Applied opening reserve.
    ClaimReferenceDTO:
      type: object
      description: 'Riferimento al sinistro: esattamente uno fra numeroSinistro, numeroSinistroEsterno
        e numeroSinistroBroker. / Claim reference: exactly one of the three business references.'
      properties:
        numeroSinistro:
          type: string
          description: Numero sinistro pubblico REVO. / REVO public claim number.
          example: ELB.26.1234567.0
        numeroSinistroEsterno:
          type: string
          description: Numero sinistro del sistema del partner. / Partner's own claim number.
        numeroSinistroBroker:
          type: string
          description: Riferimento sinistro del broker. / Broker claim reference.
    ClaimStatusDTO:
      type: object
      properties:
        status:
          type: string
        code:
          type: string
        description:
          type: string
        sinistroId:
          type: string
    ComunicazioniDTO:
      type: object
      description: Blocco comunicazioni per l’apertura sinistro. / Communications block for claim creation.
      properties:
        emailConferma:
          type: array
          description: 'Indirizzi email che riceveranno la conferma di apertura sinistro (facoltativo).
            /

            Email addresses that will receive the claim opening confirmation (optional).

            '
          example:
          - sinistri@partner.it
          - ufficio.claims@broker.it
          items:
            type: string
    ContattiDTO:
      type: object
      description: Recapiti di contatto del danneggiato (tutti i campi sono facoltativi). / Contact details
        forthe damaged party (all fields are optional).
      properties:
        telefono:
          type: string
          description: Numero di telefono del danneggiato (facoltativo). / Phone number (optional).
          example: '+390212345678'
        email:
          type: string
          description: Indirizzo email del danneggiato (facoltativo). / Email address (optional).
          example: mario.rossi@example.com
        pec:
          type: string
          description: Indirizzo PEC del danneggiato (facoltativo). / Certified email address (PEC, optional).
          example: studioalfa@pec.example.it
    DanneggiatoDTO:
      type: object
      description: Dati del soggetto danneggiato. / Damaged party block.
      properties:
        tipoDanneggiato:
          type: string
          description: Tipo di danneggiato (CONTRAENTE, ASSICURATO, CONTROPARTE). Se CONTRAENTE, gli altri
            campi saranno recuperati dalla polizza. / Type of damaged party. If CONTRAENTE, other fields
            be resolved from the policy.
          enum:
          - CONTRAENTE
          - ASSICURATO
          - CONTROPARTE
          example: CONTRAENTE
        nome:
          type: string
          description: Nome del danneggiato (persona fisica). / First name (natural person).
          example: Mario
        cognome:
          type: string
          description: Cognome del danneggiato (persona fisica). / Last name (natural person).
          example: Rossi
        ragioneSociale:
          type: string
          description: Ragione sociale del danneggiato (persona giuridica). /Company name (legal entity).
          example: Beta S.p.A.
        codiceFiscale:
          type: string
          description: Codice fiscale del danneggiato, se disponibile. / Italian tax code, if available.
          example: RSSMRA80A01F205X
        partitaIva:
          type: string
          description: Partita IVA del danneggiato, se disponibile. / VAT number, if available.
          example: '12345678901'
        contatti:
          $ref: '#/components/schemas/ContattiDTO'
          description: Recapiti del danneggiato (telefono, email, PEC). / Contact details for the damaged
            party.
        indirizzo:
          $ref: '#/components/schemas/IndirizzoDTO'
          description: Indirizzo del danneggiato. / Postal address of the damaged party.
      required:
      - tipoDanneggiato
    DanneggiatoDTOCreate:
      type: object
      properties:
        tipoDanneggiato:
          type: string
          enum:
          - CONTRAENTE
          - ASSICURATO
          - CONTROPARTE
        descrizioneBene:
          type: string
        soggetto:
          $ref: '#/components/schemas/SoggettoDTOCreate'
        valutaDanneggiato:
          type: string
          maxLength: 3
          minLength: 3
    DanneggiatoReferenceDTO:
      type: object
      description: Riferimento al danneggiato per chiave naturale (tipo + codice fiscale o partita IVA).
        / Injured party reference by natural key.
      properties:
        tipoDanneggiato:
          type: string
          description: Tipo danneggiato. / Injured party type.
          enum:
          - CONTRAENTE
          - ASSICURATO
          - CONTROPARTE
        codiceFiscale:
          type: string
          description: Codice fiscale del danneggiato. / Injured party tax code.
        partitaIva:
          type: string
          description: Partita IVA del danneggiato. / Injured party VAT number.
    EventoDTO:
      type: object
      description: Dati relativi all’evento che ha generato il sinistro. / Claim event data.
      properties:
        dataEvento:
          type: string
          format: date
          description: Data dell’evento che ha generato il sinistro (formato yyyy-MM-dd). / Date of the
            claim event (yyyy-MM-dd).
          example: '2026-05-10'
        dataDenuncia:
          type: string
          format: date
          description: Data di denuncia del sinistro (formato yyyy-MM-dd). Se assente, il sistema utilizza
            la data di ricezione. / Date the claim was reported (yyyy-MM-dd). If missing, the system uses
            the reception date.
          example: '2026-05-11'
        dataRichiestaRisarcimento:
          type: string
          format: date
          description: Data richiesta risarcimento (Claims Made). Se valorizzata, anche da sola, il sinistro
            è considerato Claims Made. / Date of the compensation request (Claims Made). If set, the claim
            is treated as Claims Made.
          example: '2026-05-15'
        dataNotificaCircostanza:
          type: string
          format: date
          description: Data notifica circostanza (Claims Made). Se valorizzata, anche da sola, il sinistro
            è considerato Claims Made. Può coesistere con dataRichiestaRisarcimento. / Date of circumstance
            notification (Claims Made). If set, the claim is treated as Claims Made and may coexist with
            dataRichiestaRisarcimento.
          example: '2026-05-12'
        descrizione:
          type: string
          description: Descrizione completa dell’evento di sinistro. / Full description of the claim event.
          example: Durante lavori di ristrutturazione è stato causato un danno a terzi nell’area condominiale.
          minLength: 1
        luogoEvento:
          $ref: '#/components/schemas/LuogoEventoDTO'
          description: Luogo strutturato in cui si è verificato l’evento (facoltativo; l’eventuale obbligatorietà
            dipende da ramo/prodotto/processo). / Structured location of the event (optional; mandatory
            only for specific branches/products).
      required:
      - dataEvento
      - descrizione
    ExceptionObject:
      type: object
      properties:
        status:
          type: integer
          format: int32
        error:
          type: string
        message:
          type: string
    FinancialsDTO:
      type: object
      description: Totale economico del sinistro, distinto tra indennizzo e spese
      properties:
        indennizzo:
          type: number
          format: double
          description: Quota indennizzo
          example: 12500.0
        spese:
          type: number
          format: double
          description: Quota spese
          example: 350.0
        totale:
          type: number
          format: double
          description: Somma di indennizzo e spese
          example: 12850.0
        valuta:
          type: string
          description: Valuta in cui sono espressi gli importi
          example: EUR
    GaranziaReferenceDTO:
      type: object
      description: 'Riferimento alla garanzia per codici di prodotto: coppia codiceGaranzia + codicePrestazione,
        mai il codice puntato. / Cover reference by product codes: the (cover, benefit) pair in two separate
        fields, never the dotted code.'
      properties:
        codiceGaranzia:
          type: string
          description: Codice garanzia, SENZA la prestazione e senza punto. / Cover code, without the
            benefit part and without a dot.
          example: '00001'
        codicePrestazione:
          type: string
          description: Codice prestazione (sotto-garanzia). / Benefit (sub-cover) code.
          example: '1699'
        chiaveGaranzia:
          type: string
          description: 'Chiave di garanzia: disambigua due coperture con la stessa coppia. / Cover key:
            disambiguates two covers sharing the same (cover, benefit) pair.'
    IndirizzoDTO:
      type: object
      description: Indirizzo postale. / Postal address.
      properties:
        via:
          type: string
          description: Via / strada. / Street name.
          example: Via Roma
        numeroCivico:
          type: string
          description: Numero civico. / Street number.
          example: '10'
        comune:
          type: string
          description: Comune. / Municipality.
          example: Roma
        provincia:
          type: string
          description: Provincia (sigla). / Province code.
          example: RM
        nazione:
          type: string
          description: Stato/Nazione (codice). / Country code.
          example: IT
        cap:
          type: string
          description: CAP. / Postal code.
          example: '00100'
    LuogoEventoDTO:
      type: object
      description: Luogo strutturato in cui si è verificato l’evento di sinistro. / Structured location
        of the claim event.
      properties:
        indirizzo:
          type: string
          description: Indirizzo completo (via e numero civico). / Full street address.
          example: Via Roma 1
        comune:
          type: string
          description: Comune. / Municipality.
          example: Milano
        provincia:
          type: string
          description: Provincia (sigla). / Province code.
          example: MI
        nazione:
          type: string
          description: Stato/Nazione (codice). / Country code.
          example: IT
        cap:
          type: string
          description: CAP. / Postal code.
          example: '20100'
    MotivoSenzaSeguitoDTO:
      type: object
      description: Motivo di chiusura senza seguito. / Closure reason.
      properties:
        codice:
          type: string
          description: Codice del motivo. / Reason code.
        descrizioneIt:
          type: string
          description: Descrizione in italiano. / Italian description.
        descrizioneEs:
          type: string
          description: Descrizione in spagnolo. / Spanish description.
    PartnerAllegatoDTO:
      type: object
      description: Metadati di un allegato del sinistro. / Metadata of a claim attachment.
      properties:
        allegatoId:
          type: string
          format: uuid
          description: Identificativo dell'allegato, da usare per il download e negli invii email. / Attachment
            identifier, for download and e-mail sending.
        nome:
          type: string
          description: Nome del file. / File name.
        tipo:
          type: string
          description: Tipo di allegato. / Attachment type.
        dimensione:
          type: integer
          format: int64
          description: Dimensione in byte. / Size in bytes.
        data:
          type: string
          format: date-time
          description: Data di caricamento. / Upload date.
    PartnerBeneficiarioDTO:
      type: object
      description: Beneficiario del pagamento. / Payment payee.
      properties:
        tipoPagamento:
          type: string
          description: Tipo di pagamento. / Payment type.
          enum:
          - PAGAMENTO_INDENNIZZO
          - PAGAMENTO_SPESA
          - PAGAMENTO_AS
        metodoDiPagamento:
          type: string
          description: Metodo di pagamento. / Payment method.
          enum:
          - SEPA
          - BONIFICO_MANUALE
          - PAGAMENTO_ANTICIPATO_INTERMED
          - AD
          - AZ
          - BE
          example: SEPA
        iban:
          type: string
          description: IBAN del beneficiario. / Payee IBAN.
        bic:
          type: string
          description: BIC/SWIFT del beneficiario. / Payee BIC.
        nome:
          type: string
          description: Nome (persona fisica). / First name.
        cognome:
          type: string
          description: Cognome (persona fisica). / Last name.
        ragioneSociale:
          type: string
          description: Ragione sociale (persona giuridica). / Company name.
        codiceFiscale:
          type: string
          description: Codice fiscale. / Tax code.
        partitaIva:
          type: string
          description: Partita IVA. / VAT number.
        indirizzo:
          $ref: '#/components/schemas/PartnerIndirizzoDTO'
          description: Indirizzo del beneficiario. / Payee address.
        email:
          type: string
          description: Email del beneficiario. / Payee email.
        telefono:
          type: string
          description: Telefono del beneficiario. / Payee phone.
      required:
      - indirizzo
      - metodoDiPagamento
    PartnerClosureRequestDTO:
      type: object
      description: Chiusura senza seguito del sinistro. / Claim closure without follow-up.
      properties:
        sinistro:
          $ref: '#/components/schemas/ClaimReferenceDTO'
          description: Riferimento al sinistro. / Claim reference.
        codiceMotivoSenzaSeguito:
          type: string
          description: Codice del motivo di chiusura senza seguito. / Closure reason code.
          minLength: 1
        note:
          type: string
          description: Note libere; se assenti vale la descrizione del motivo. / Free notes; the reason
            description is used when absent.
      required:
      - codiceMotivoSenzaSeguito
      - sinistro
    PartnerDanneggiatoReopenDTO:
      type: object
      description: Danneggiato della riapertura e sue garanzie. / Injured party of the reopening and its
        covers.
      properties:
        danneggiato:
          $ref: '#/components/schemas/DanneggiatoReferenceDTO'
          description: Riferimento al danneggiato gia' presente sul sinistro. / Reference to an existing
            injured party.
        anagrafica:
          $ref: '#/components/schemas/DanneggiatoDTOCreate'
          description: Anagrafica completa, da valorizzare solo se il danneggiato non e' ancora sul sinistro.
            / Full personal data, only when the injured party is new to the claim.
        garanzie:
          type: array
          description: Garanzie da riaprire, almeno una. / Covers to reopen, at least one.
          items:
            $ref: '#/components/schemas/PartnerGaranziaRiservaDTO'
          minItems: 1
      required:
      - garanzie
    PartnerEmailRequestDTO:
      type: object
      description: Email da inviare per conto del sinistro. / E-mail to send on behalf of the claim.
      properties:
        sinistro:
          $ref: '#/components/schemas/ClaimReferenceDTO'
          description: Riferimento al sinistro. / Claim reference.
        to:
          type: array
          description: Destinatari. / Recipients.
          items:
            type: string
            format: email
          minItems: 1
        cc:
          type: array
          description: Destinatari in copia. / Carbon copy.
          items:
            type: string
            format: email
        ccn:
          type: array
          description: Destinatari in copia nascosta. / Blind carbon copy.
          items:
            type: string
            format: email
        oggetto:
          type: string
          description: Oggetto. Viene troncato al limite accettato da cContact. / Subject; truncated to
            the length cContact accepts.
          minLength: 1
        corpo:
          type: string
          description: Corpo del messaggio. Viene troncato al limite accettato da cContact. / Message
            body; truncated to the length cContact accepts.
          minLength: 1
        allegati:
          type: array
          description: allegatoId restituiti da GET /partnerIntegration/claim/documents. / Attachment
            ids previously returned by the documents endpoint.
          items:
            type: string
            format: uuid
      required:
      - corpo
      - oggetto
      - sinistro
      - to
    PartnerEmailResponseDTO:
      type: object
      description: Esito sincrono dell'invio email. / Synchronous outcome of the e-mail send.
      properties:
        esito:
          type: boolean
          description: true se cContact ha accettato l'invio. / true when cContact accepted the send.
        descrizione:
          type: string
          description: Descrizione dell'esito. / Outcome description.
    PartnerGaranziaImportoDTO:
      type: object
      description: Importo pagato su una garanzia. / Amount paid on a coverage.
      properties:
        garanzia:
          $ref: '#/components/schemas/GaranziaReferenceDTO'
          description: Riferimento alla garanzia. / Coverage reference.
        importo:
          type: number
          format: double
          description: Importo pagato sulla garanzia. / Amount paid on the coverage.
        riservaResidua:
          type: number
          format: double
          description: Riserva residua dichiarata dal partner. / Remaining reserve stated by the partner.
        calcoloResiduo:
          type: boolean
          description: Se il residuo va ricalcolato dal back-end (default true). / Whether the back-end
            recomputes the remainder (default true).
      required:
      - garanzia
      - importo
    PartnerGaranziaRiservaDTO:
      type: object
      description: Garanzia da riaprire e relativa riserva. / Cover to reopen and its reserve.
      properties:
        garanzia:
          $ref: '#/components/schemas/GaranziaReferenceDTO'
          description: 'Garanzia, indicata dal solo codiceGaranzia (forma di polizza, senza punto). Puo''
            non essere mai stata aperta sul sinistro: viene cercata sul riepilogo garanzie della polizza.
            ATTENZIONE: su questa operazione codicePrestazione e chiaveGaranzia NON sono ammessi e producono
            400 — la risoluzione della riapertura non discrimina su quei campi, e accettarli senza usarli
            farebbe credere di aver disambiguato. / Cover by its cover code only; codicePrestazione and
            chiaveGaranzia are rejected here, as the reopening lookup cannot use them.'
        importoRiserva:
          type: number
          description: Riserva da costituire alla riapertura. / Reserve to set on reopening.
          example: 3000.0
      required:
      - garanzia
      - importoRiserva
    PartnerIndirizzoDTO:
      type: object
      description: Indirizzo del beneficiario. / Payee address.
      properties:
        via:
          type: string
          description: Via o indirizzo. / Street.
        comune:
          type: string
          description: Comune. / Municipality.
        cap:
          type: string
          description: CAP. / Postal code.
        provincia:
          type: string
          description: Provincia. / Province.
        nazione:
          type: string
          description: Nazione ISO a due lettere. / Two-letter ISO country.
          example: IT
          maxLength: 2
          minLength: 2
        ncivico:
          type: string
      required:
      - nazione
    PartnerInjuredPartyRequestDTO:
      type: object
      description: Inserimento o aggiornamento del danneggiato sul sinistro. / Injured party upsert on
        the claim.
      properties:
        sinistro:
          $ref: '#/components/schemas/ClaimReferenceDTO'
          description: Riferimento al sinistro. / Claim reference.
        danneggiato:
          $ref: '#/components/schemas/DanneggiatoDTOCreate'
          description: Danneggiato da inserire o aggiornare. / Injured party to insert or update.
      required:
      - danneggiato
      - sinistro
    PartnerOperationResponseDTO:
      type: object
      description: Esito asincrono di un'operazione Partner Integration v2. L'esito finale si legge su
        GET /partnerIntegration/claim/status?requestId=. / Asynchronous acknowledgement of a Partner Integration
        v2 operation; the final outcome is polled on the claim status endpoint.
      properties:
        requestId:
          type: string
          format: uuid
          description: Identificativo della richiesta, valorizzato dal partner nell'header requestId.
            E' la chiave con cui si interroga lo stato. / Partner-supplied request identifier.
        correlationId:
          type: string
          format: uuid
          description: Identificativo di correlazione generato dal back-end. / Back-end correlation identifier.
        entityId:
          type: string
          format: uuid
          description: Identificativo dell'entita' creata o modificata dall'operazione. / Identifier of
            the entity created or updated by the operation.
    PartnerPaymentCancelRequestDTO:
      type: object
      description: Annullamento di un pagamento. / Payment cancellation.
      properties:
        motivazione:
          type: string
          description: Motivazione dell'annullamento. / Cancellation reason.
          minLength: 1
        dataAnnullamento:
          type: string
          format: date
          description: Data di annullamento. / Cancellation date.
          example: '2026-09-17'
        mmAaaaEstrattoConto:
          type: string
          description: Mese e anno dell'estratto conto, formato MM-AAAA. / Statement month and year, MM-YYYY.
          example: 09-2026
        chiaveRiconciliazioneAssistenza:
          type: string
          description: Chiave di riconciliazione dell'assistenza. Accettata per parita' con il v1, NON
            propagata al core. / Assistance reconciliation key. Accepted for v1 parity, NOT forwarded
            to the core.
      required:
      - motivazione
    PartnerPaymentRequestDTO:
      type: object
      description: Richiesta di pagamento da partner esterno (v2). / Payment request from an external
        partner (v2).
      properties:
        sinistro:
          $ref: '#/components/schemas/ClaimReferenceDTO'
          description: Riferimento al sinistro. / Claim reference.
        esecutorePagamento:
          type: string
          description: Chi esegue materialmente il pagamento; assente vale REVO. / Who actually executes
            the payment; absent means REVO.
          enum:
          - REVO
          - PARTNER
          example: REVO
        danneggiato:
          $ref: '#/components/schemas/DanneggiatoReferenceDTO'
          description: Riferimento al danneggiato; facoltativo se il sinistro ne ha uno solo. / Injured
            party reference; optional when the claim has only one.
        garanzie:
          type: array
          description: Importi per garanzia. / Amounts per coverage.
          items:
            $ref: '#/components/schemas/PartnerGaranziaImportoDTO'
          minItems: 1
        importoTotale:
          type: number
          format: double
          description: Importo totale del pagamento. / Total payment amount.
        valuta:
          type: string
          description: 'Valuta del pagamento: se valorizzata deve coincidere con quella del sinistro,
            altrimenti la richiesta e'' rifiutata. Non propagata al core, che usa la valuta del sinistro.
            / Payment currency: must match the claim''s when present; not forwarded to the core.'
          example: EUR
        dataPagamento:
          type: string
          format: date
          description: Data del pagamento. / Payment date.
          example: '2026-09-16'
        causale:
          type: string
          description: Causale del pagamento. Accettata per parita' con il v1, NON propagata al core.
            / Payment reason. Accepted for v1 parity, NOT forwarded to the core.
        beneficiario:
          $ref: '#/components/schemas/PartnerBeneficiarioDTO'
          description: Beneficiario del pagamento. / Payment payee.
        quietanza:
          $ref: '#/components/schemas/PartnerQuietanzaDTO'
          description: Quietanza. Accettata per parita' con il v1, NON propagata al core. / Receipt. Accepted
            for v1 parity, NOT forwarded to the core.
        recuperi:
          $ref: '#/components/schemas/PartnerRecuperiDTO'
          description: Recuperi dichiarati. Accettati per parita' con il v1, NON propagati al core. /
            Declared recoveries. Accepted for v1 parity, NOT forwarded to the core.
        mmAaaaEstrattoConto:
          type: string
          description: Mese e anno dell'estratto conto, formato MM-AAAA. / Statement month and year, MM-YYYY.
          example: 09-2026
        chiaveRiconciliazioneAssistenza:
          type: string
          description: Chiave di riconciliazione dell'assistenza. Accettata per parita' con il v1, NON
            propagata al core. / Assistance reconciliation key. Accepted for v1 parity, NOT forwarded
            to the core.
      required:
      - beneficiario
      - dataPagamento
      - garanzie
      - sinistro
    PartnerQuietanzaDTO:
      type: object
      description: Quietanza del pagamento. / Payment receipt.
      properties:
        necessaria:
          type: boolean
          description: Se la quietanza e' necessaria. / Whether a receipt is required.
        tipoQuietanza:
          type: string
          description: Tipo di quietanza. / Receipt type.
    PartnerRecuperiDTO:
      type: object
      description: Recuperi dichiarati sul pagamento. / Recoveries declared on the payment.
      properties:
        franchigia:
          type: number
          format: double
          description: Recupero franchigia. / Deductible recovery.
        rivalsa:
          type: number
          format: double
          description: Recupero rivalsa. / Subrogation recovery.
    PartnerReopenRequestDTO:
      type: object
      description: Riapertura di un sinistro chiuso. / Reopening of a closed claim.
      properties:
        sinistro:
          $ref: '#/components/schemas/ClaimReferenceDTO'
          description: Riferimento al sinistro da riaprire. / Reference to the claim to reopen.
        danneggiati:
          type: array
          description: Danneggiati coinvolti nella riapertura, almeno uno. / Injured parties involved,
            at least one.
          items:
            $ref: '#/components/schemas/PartnerDanneggiatoReopenDTO'
          minItems: 1
      required:
      - danneggiati
      - sinistro
    PartnerReserveRequestDTO:
      type: object
      description: Aggiornamento delle riserve di un sinistro. / Reserve update request for a claim.
      properties:
        sinistro:
          $ref: '#/components/schemas/ClaimReferenceDTO'
          description: Riferimento al sinistro. / Claim reference.
        aggiornamenti:
          type: array
          description: Aggiornamenti da applicare, almeno uno. / Reserve updates to apply, at least one.
          items:
            $ref: '#/components/schemas/PartnerRiservaUpdateDTO'
          minItems: 1
      required:
      - aggiornamenti
      - sinistro
    PartnerRiservaUpdateDTO:
      type: object
      description: Aggiornamento della riserva di una garanzia aperta. / Reserve update for one open cover.
      properties:
        danneggiato:
          $ref: '#/components/schemas/DanneggiatoReferenceDTO'
          description: Danneggiato su cui insiste la garanzia. Facoltativo se il sinistro ha un solo danneggiato.
            / Injured party the cover belongs to; optional on single-party claims.
        garanzia:
          $ref: '#/components/schemas/GaranziaReferenceDTO'
          description: Garanzia aperta da aggiornare, per codici di prodotto. / Open cover, by product
            codes.
        importoRiserva:
          type: number
          description: Nuovo importo della riserva, maggiore di zero. / New reserve amount, greater than
            zero.
          example: 12500.0
      required:
      - garanzia
      - importoRiserva
    PolizzaDTO:
      type: object
      description: Riferimenti alla polizza su cui aprire il sinistro. / Policy reference block.
      properties:
        numeroPolizza:
          type: string
          description: Numero polizza REVO (obbligatorio in alternativa a idPolizzaEsterna). / Internal
            REVO policy number (required as alternative to idPolizzaEsterna).
          example: OX00001
        idPolizzaEsterna:
          type: string
          description: Identificativo polizza esterno fornito dal chiamante (obbligatorio in alternativa
            a numeroPolizza). / External policy identifier provided by the caller (required as alternative
            to numeroPolizza).
          example: POL-DELEGATARIA-778899
        ramo:
          type: string
          description: Codice ramo di polizza (facoltativo, può diventare obbligatorio se la polizza presenta
            più rami garanzia). / Branch code (optional, may be required when multiple branches are present).
          example: '13'
        chiaveGaranzia:
          type: string
          description: Chiave garanzia (facoltativa). Se i campi di garanzia non sono valorizzati, il
            sistema seleziona la prima garanzia disponibile. / Guarantee key (optional).
          example: rcp
        codiceGaranzia:
          type: string
          description: Codice garanzia/copertura (facoltativo). Se i campi di garanzia non sono valorizzati,
            il sistema seleziona la prima garanzia disponibile. / Coverage code (optional).
          example: '13401'
        codicePrestazione:
          type: string
          description: Codice prestazione/servizio (facoltativo). Se i campi di garanzia non sono valorizzati,
            il sistema seleziona la prima garanzia disponibile. / Service/benefit code (optional).
          example: '1314'
        riservaApertura:
          type: number
          format: double
          description: Importo della riserva in apertura (facoltativo). Se valorizzato, prevale sul default
            profilato per l’utenza chiamante. / Opening reserve amount (optional, overrides caller profile
            default).
          example: 2600.0
    RiservaApplicataDTO:
      type: object
      description: Riserva di apertura applicata al sinistro. / Applied opening reserve.
      properties:
        importo:
          type: number
          description: Importo riserva applicato, in EUR. / Applied reserve amount, EUR.
          example: 2599.99
        fonte:
          type: string
          description: 'Fonte della riserva applicata: INPUT (fornita dal chiamante) | PRODOTTO | LOB
            | PARACADUTE (default tabellato). / Source of the applied reserve.'
          example: PARACADUTE
    SinistroFinancialsDTO:
      type: object
      description: 'Dati economici del sinistro: quanto liquidato e quanto ancora a riserva'
      properties:
        numeroSinistro:
          type: string
          description: Numero sinistro REVO a cui si riferiscono gli importi
          example: ELB.25.001234.0
        valuta:
          type: string
          description: Valuta in cui sono espressi gli importi
          example: EUR
        totalePagamenti:
          $ref: '#/components/schemas/FinancialsDTO'
          description: Totale liquidato sul sinistro (pagamenti indennizzo + spese)
        riservaResidua:
          $ref: '#/components/schemas/FinancialsDTO'
          description: Riserva ancora residua sul sinistro
    SoggettoDTOCreate:
      type: object
      properties:
        tipoSoggetto:
          type: string
        nome:
          type: string
        cognome:
          type: string
        denominazione:
          type: string
        telefono:
          type: string
        indirizzo:
          type: string
        email:
          type: string
        codiceFiscale:
          type: string
        partitaIva:
          type: string
        pec:
          type: string
        iban:
          type: string
        sesso:
          type: string
        nazione:
          type: string
        provincia:
          type: string
        comune:
          type: string
        cap:
          type: string
        via:
          type: string
        nCivico:
          type: string
  securitySchemes:
    bearerToken:
      type: http
      scheme: bearer
      bearerFormat: JWT
