Loading
Seguro
InsCensusService:addPlanSelections

InsCensusService:addPlanSelections

Utilice este servicio para insertar planes preinscritos para cada miembro especificado en la entrada.

Importante
Importante Desde Winter '23 en adelante, tenemos el servicio InsCensusServiceStd:addPlanSelections activado para funcionar con el modelo de datos estándar de Salesforce para Financial Services Cloud y Health Cloud. Los clientes existentes pueden seguir utilizando este servicio, pero no se proporcionarán más mejoras en el paquete Seguro gestionado.

Clase: InsCensusService

Método: addPlanSelections

Funcionamiento

  • El nodo ContractLineId__c contiene los Id. de ContractLineItem__c en los que el miembro está inscrito previamente.

  • Para cada uno de los Id. de ContractLineItem__c, el servicio evalúa si el plan es válido para el miembro del siguiente modo:

    • El contractId es válido para el censusId;

    • El Id. de ContractLineItem__c es válido para el contractId;

    • El tipo de producto del ContractLineItem__c para el miembro principal no es igual a los tipos de producto enumerados en la OptOutTypes__c del miembro principal;

    • El tipo de producto del ContractLineItem__c para un dependiente no es igual a los tipos de producto enumerados en la OptOutTypes__c del dependiente, y el tipo de producto del ContractLineItem__c no es igual a los tipos de producto enumerados en la OptOutTypes__c del miembro principal del dependiente.

  • Se devuelven los Id. de las entradas de GroupCensusMemberPlan__c creadas correctamente.

  • El servicio también elimina miembros recién creados (isNewMember está establecido como true en el objeto JSON) que no tienen entradas en GroupCensusMemberPlan__c y cuando onlySaveMembersWithValidProducts está establecido como true.

Opciones remotas

Opción

Descripción

censusId

Obligatorio.

Id. de censo con los miembros cuyos planes deben insertarse.

Valida que contractId pertenezca a la cuenta/censo.

contractId

Obligatorio.

Id. del contrato actual de la cuenta.

Valida que los planes para cada miembro forman parte del contrato.

census

Obligatorio.

Objeto JSON con dos nodos:

  • encabezados: El nombre de API de la partida de contrato Id. (ContractLineId__c).

  • members: Lista de miembros con planes para insertar o actualizar. Debe incluir los dos nodos siguientes:

    • Id: Id. de miembro del censo (GroupCensusMember__c.Id).

    • ContractLineId__c: La lista de los planes (ContractLineItem__c.Id) en los que el miembro está preinscrito. Las partidas de contrato están delimitadas por punto y coma(;).

onlySaveMembersWithValidProducts

Opcional.

Si es verdadero, los nuevos miembros sin entradas en GroupCensusMemberPlan__c se eliminan. El valor predeterminado es falso.

JSON de entrada

Este es el formato del JSON de entrada:

{  
   "censusId":"ID",
   "contractId":"ID",
   "onlySaveMembersWithValidProducts":true,
   "census":{  
      "headers":[  
         {  
            "name":"vlocity_ins__ContractLineId__c"
         },
      ],
      "members":[  
         {  
            "Id":"Census Member ID",
            "isNewMember":true,
            "vlocity_ins__ContractLineId__c": "ContractLineItem__c.Id;ContractLineItem__c.Id"
            
         },
         {  
            "Id":"Census Member ID",
            "isNewMember":true,
            "vlocity_ins__ContractLineId__c": "ContractLineItem__c.Id;ContractLineItem__c.Id"
         }
      ]
   },
}

Este es un ejemplo del JSON de entrada:

{  
   "censusId":"a4D4P000000hbjSUAQ",
   "contractId":"8004P000000zF2dQAE",
   "census":{  
      "members":[  
         {  
            "vlocity_ins__ContractLineId__c": "a4D4P000000hbjSUAQ;a4D4P000000hbjSUAQ",
            "Id":"a4C4P000000d7POUAY"
         }
      ],
      "headers":[  
         {  
            "name":"vlocity_ins__ContractLineId__c"
         }
      ]
   }
}

JSON de salida

El servicio devuelve la lista de Id. de GroupCensusMemberPlan__c insertados correctamente. También proporciona la lista de errores encontrados. Estos errores se agrupan por miembro.

Este es el formato del JSON de salida:

{  
   "memberPlanIds":[  
      "GroupCensusMemberPlan__c.Id"
   ],
   "errors":[  
      {  
         "error":"error"
      }
   ]
}

El servicio devuelve un JSON de salida, con el formato de la siguiente muestra:

{  
   "memberPlanIds":[  
      "a4B4P000006jKsMUAU",
      "a4B4P000006jKsNUAU",
      "a4B4P000006jKsOUAU",
      "a4B4P000006jKsPUAU"
   ],
   "errors":[  
      {  
         "numPlansError":2,
         "error":"ContractLineItem__c value is not valid:8004P000000zJKjQAM; Medical",
         "numPlans":2,
         "Id":"a4C4P000000ed6dUAA",
         "isNewMember":true,
         "vlocity_ins__ContractLineId__c":"8004P000000zJKjQAM;Medical"
      }
   ]
}
 
Cargando
Salesforce Help | Article