Loading
Seguro
InsPolicyService:calculateTaxesAndFees

InsPolicyService:calculateTaxesAndFees

Utilice este servicio para calcular y ahorrar impuestos y comisiones en un activo de destino (póliza).

Clase: InsPolicyService

Método: calculateTaxesAndFees

La información de impuestos y comisiones se guarda en el objeto de activo (póliza) y en los campos AssetCoverage__c, AssetInsuredItem__c y AssetPartyRelationship__c.

Este servicio también guarda impuestos desglosados como se describe en el paso 3 a continuación.

Nota
Nota

Este servicio admite Salesforce Financial Services Cloud.

Funcionamiento

  1. El servicio toma el assetId, el effectiveDate (o EffectiveDate_c en la política de destino, o la fecha de hoy si el valor es nulo).

  2. Basándose en los elementos de impuestos y comisiones asociados con la póliza, las coberturas y/o los elementos asegurados, realiza el cálculo sencillo especificado o llama al procedimiento de cálculo o Procedimiento de integración requerido para calcular los impuestos y las comisiones.

    Nota
    Nota

    Este servicio también puede llamar a sistemas externos para calcular impuestos y comisiones. Especifique estos sistemas cuando configure impuestos y comisiones.

  3. Si saveChanges está establecido (o predeterminado) en true, guarda los impuestos y las comisiones calculados de una de las tres formas siguientes.

    • Si un AssetItem calculó impuestos y comisiones, el servicio guarda un registro de AssetPricingAdjustment__c que representa esos impuestos/comisiones.

      El registro de AssetPricingAdjustment__c contiene el importe calculado (Amount__c), el AssetItem asociado (AssetCoverageId__c/AssetInsuredItemId__c/AssetPartyRelationshipId__c) y el Asset (AssetId__c), el tipo (impuestos o comisiones; AdjustmentType__c) y los impuestos/comisiones asociados (PriceListEntryId__c).

      AssetPricingAdjustment__c tiene un AssetItem asociado, de modo que el campo ApplicableItemType__c también se establecerá. Esta configuración indica qué tipo de artículo es aplicable: Cobertura, Elemento asegurado o Relación de parte.

      Si se especifica la opción de transactionId, el AssetTransactionId__c campo se establece en el valor de transactionId.

    • Si un AssetItem o sus secundarios calcularon impuestos, la suma de los impuestos calculados sobre sí mismo y sus secundarios se almacenará en el campo TaxAmount__c.

    • Si un AssetItem o sus secundarios calcularon comisiones, la suma de las comisiones calculadas para sí mismo y sus secundarios se almacenará en el campo FeeAmount__c.

    Nota
    Nota

    Si saveItemizedTaxesAndFees está establecido como false, los registros de AssetPricingAdjustment__c no se guardan. Los importes de TotalTaxAmount__c y TotalFeeAmount__c en el activo (póliza) se establecen en 0. Todos los demás valores aún se guardan.

  4. En el nivel Activo, la suma de todos los importes de impuestos y comisiones se almacenan en los campos TotalTaxAmount__c y TotalFeeAmount__c, respectivamente.

  5. Si el activo de destino (póliza) no es la versión original de la póliza, los importes de impuestos y comisiones se prorratearán en función de la EffectiveDate__c y ExpirationDate__c del activo. Los importes de impuestos y comisiones prorrateados para un AssetItem se almacenan en los campos ProratedTaxAmount__c y ProratedFeeAmount__c. Los importes de impuestos y comisiones prorrateados para el activo se almacenan en los campos TotalTaxForTerm__c y TotalFeeForTerm__c.

  6. Si se proporciona una opción de transactionId, el cambio en los importes de impuestos y comisiones prorrateados totales (la suma de los importes de impuestos y comisiones prorrateados en la versión de activo de destino y todas las versiones anteriores del activo) entre la versión de activo actual y las versiones de activo anteriores se almacenan en los campos TaxAmount__c y FeeAmount__c de la transacción de destino, respectivamente.

Opciones remotas

Opción

Descripción

assetId

Obligatorio

Id. del activo (póliza) para el que este servicio calculará impuestos y comisiones.

transactionId

Opcional

La transacción especificada se actualizará con importes de impuestos y comisiones calculados.

jurisdictionIds

Opcional

Calcula los impuestos y las tarifas asociados únicamente con las jurisdicciones proporcionadas.

effectiveDate

Opcional

Calcule los impuestos y las comisiones que están vigentes solo en la fecha especificada.

Si no se proporciona, el valor toma como valor predeterminado el EffectiveDate__c de la política de destino. Si EffectiveDate__c es nulo, el valor toma como valor predeterminado la fecha de hoy.

saveChanges

Opcional

true o false

Toma como valor predeterminado true.

Si true, persisten los impuestos y comisiones calculados en la póliza (activo).

Si es false, no mantenga los impuestos y comisiones calculados en la póliza (activo).

JSON de entrada

Este servicio no toma un JSON de entrada.

JSON de salida

El servicio devuelve los impuestos y comisiones desglosados en la jerarquía de productos/productos secundarios. A continuación se ofrece un ejemplo:

{
  "productId": 1,
  "productName": "Product",
  "ProductCode": "P",
  "taxesAndFees": [{
    "Id": 1,
    "Amount__c": 10,
    "PriceListEntryId__c": 11,
    "AdjustmentType__c": "Tax"
  }, {
    "Id": 2,
    "Amount__c": 15,
    "PriceListEntryId__c": 12,
    "AdjustmentType__c": "Fee"
  }],
  "taxAmount": 25
  "feeAmount": 30
  "childProducts": [{
    "productId": 2,
    "productName": "Insured Item",
    "ProductCode": "II",
    "instanceKey": "My Insured Item",
    "taxesAndFees": [{
      "Id": 3,
      "Amount__c": 15,
      "PriceListEntryId__c": 16,
      "AdjustmentType__c": "Tax"
    }],
    "taxAmount": 15
  }, {
    "productId": 3,
    "productName": "Coverage",
    "ProductCode": "C",
    "taxesAndFees": [{
      "Id": 4,
      "Amount__c": 15,
      "PriceListEntryId__c": 21
      "AdjustmentType__c": "Fee"
    }],
    "feeAmount": 15
  }]
}
 
Cargando
Salesforce Help | Article