Loading
Assicurazioni
InsQuoteService:updateQuotePlans

InsQuoteService:updateQuotePlans

Utilizzare questo servizio in un OmniScript per aggiungere, aggiornare o inserire con aggiornamento (aggiungere e aggiornare) coperture o attributi per uno o più piani Vantaggi di gruppo in un preventivo. Questo servizio è progettato per elaborare solo le coperture nei prodotti radice.

Nota
Nota

Questo servizio non è supportato per gli utenti guest.

Se un utente guest tenta di eseguire un OmniScript o una procedura di integrazione o una funzione dell'interfaccia utente che utilizza questo servizio, il servizio non verrà eseguito e l'utente guest visualizzerà un messaggio di errore.

Classe: InsQuoteService

Metodo: updateQuotePlans

Funzionamento

Ad esempio, se una copertura ha un attributo con il codice attributo cat1_copay_inn e la mappa dei dati di input contiene un codice attributo parziale copay, ci sarebbe una corrispondenza, poiché cat1_copay_inn contiene la stringa copay e gli attributi di questa copertura verrebbero aggiornati.

  1. Il servizio si prende il quoteId di trovare il preventivo di destinazione.

  2. Utilizza il inputKey per individuare i dati di input (coperture, attributi).

  3. Modifica le coperture o gli attributi in un preventivo, in base a operationScope (coperture o attributi) e operationType (inserimento, aggiornamenti, inserimenti con aggiornamento).

  • Se operationScope è coperture, le coperture degli input nei piani target vengono inserite, aggiornate o inserite con aggiornamento nel preventivo target, in base alle operationType.

  • Se operationScope è attributo, gli attributi di copertura nel preventivo di destinazione vengono aggiornati in base a quali coperture contengono attributi il cui codice contiene uno dei codici attributo parziali elencati nella mappa dei dati di input.

Nota
Nota

NOTA: Se vengono forniti planId, la copertura verrà aggiornata solo se appartiene a uno dei planId nell'elenco, anche se esiste una corrispondenza.

Nota
Nota

NOTA: Per inserire una nuova copertura del prodotto radice, è necessaria almeno una voce preventivo controllata sotto il prodotto radice.

Opzioni remote

Opzione

Descrizione

quoteId

Obbligatorio.

ID del preventivo di destinazione.

inputKey

Obbligatorio.

Chiave per la posizione in cui nella mappa degli input vengono specificati i dati di input (ad esempio le coperture).

operationScope

Obbligatorio.

Ambito degli elementi aggiornati sui piani. I valori possibili sono le coperture e gli attributi (ovvero, le coperture o gli attributi possono essere aggiornati).

operationType

Obbligatorio quando operationScope è coperture e ignorato quando operationScope è attributo.

Tipo di operazione eseguita: insert, update o upsert.

identifiers

Elenco di valori stringa di planId.

Obbligatorio quando operationScope è coperture, facoltativo quando operationScope è attributi.

Opzioni MAPPA

Di seguito sono riportati esempi di opzioni che mappano le variabili, utilizzate in una scheda, quando il operationScope è coperture:

{
  'quoteId': '0Q0000000000000000',
  'inputKey': 'inputJson',
  'operationScope': 'coverages',
  'operationType': 'insert',
  'identifiers': planId1, planId2'
}

Di seguito sono riportati esempi di opzioni che mappano le variabili, utilizzate in una scheda, quando il operationScope è attributo:


{
  'quoteId': '0Q0000000000000000',
  'inputKey': 'inputJson',
  'operationScope': 'attributes',
  'identifiers': '0QLf4000000SX3tGAG, 0QLf4000000SX3rGAG'
}

Input JSON

Se il operationScope è coperture, i dati di input devono contenere un oggetto JSONResult (o una mappa che può essere analizzata come oggetto JSONResult) che contiene le coperture da inserire o aggiornare (Coverage 1, Coverage 2, ecc.):


{
  'inputJson': {
    'records': [{
      'productName': 'Coverage 1',
      'attributeCategories': [...],
      ...
    }, {
      'productName': 'Coverage 2',
      'attributeCategories': [...],
      ...
    }]
  }
}

Se il operationScope è attributo, i dati di input devono contenere una mappa dei codici attributo parziali e dei relativi valori aggiornati, come mostrato nell'esempio seguente:

{
  'inputJson': {
    'copay': 20,
    'covered': '90%'
  }
}

Esempio di utilizzo

Si supponga di voler modificare il valore dell'attributo copay nella ChirOffiProf della categoria di attributi.

Assumendo una convenzione di denominazione standard di:

attributeCategory_attributeCode_inNetwork/outOfNetwork

Con i seguenti attributi di copay in rete e fuori rete:

  • ChirOffiProf_copay_inn

  • ChirOffiProf_copay_oon

Il servizio updateQuotePlans si configurerebbe con i seguenti input e opzioni:

Input

Mappa dei codici parziali e dei relativi valori (ad esempio, copay restituisce qualsiasi nome di attributo con copay nella stringa). Il codice parziale in questo caso sarebbe la parte attributeCode del modello:

{
    'copay': 20,
    'covered': 75
}

Opzioni

  • quoteId

  • planId (QuoteLineItem Id)

Il servizio cercherà tutte le coperture all'interno dei planId specificati che hanno un attributo che contiene il codice attributo parziale (in questo caso, copay) e aggiornerà tali attributi con il nuovo valore (in questo caso, 20).

Se non viene specificato planId, vengono aggiornate tutte le coperture con un attributo che contiene il parziale attributeCode passato.

 
Caricamento
Salesforce Help | Article