Billing instruction subtypes

The BillingInstruction entity is the root of several billing instruction subtypes. Multiple levels of subtypes exist, such as AccountGeneral, which is a subtype of AcctBillingInstruction, which is a subtype of the root entity. The following table summarizes the BillingInstruction subtypes. The arrow symbol () and indentation define lower subtype levels.

BillingCenter BillingInstruction subtype

Description and important properties

AcctBillingInstruction

Root for account-related billing instruction. The Account property of this instruction must be specified and reference the PublicId of the relevant account.

AccountGeneral

Specifies the effective date of the AcctBillingInstruction. If the AccountGeneral instruction is used, the BillingInstructionDate property must specify the effective date.

CltlBillingInstruction

Root for collateral-related billing instructions.

     CollateralBI

Specifies the collateral requirement that generated the associated charge.

Note: In the base configuration, PolicyCenter does not trigger code in BillingCenter that creates this billing instruction. Instead, PolicyCenter sends deposit requirements with the policy job. In other words, the DepositRequirement property within the main policy billing instruction contains the information.

     SegregatedCollReqBI

Specifies the segregated collateral requirement that owns this charge.

PlcyBillingInstruction

Root for policy-related billing instruction. Includes the following additional properties.

  • DepositRequirementnonnegativemoney that specifies the deposit requirement that exists after execution of the billing instruction.
  • OfferNumberString that contains the job number of the job that acts on the policy period to create this billing instruction.
  • An array of PaymentPlanModifier objects to apply to the existing payment plan.

BaseGeneral

Specifies the policy period and the effective date of the billing instruction. Both properties are required. The Policy property must specify the PublicId of the PolicyPeriod.

ExistingPlcyPeriodBI

Lets you associate the charges with an existing policy period and provide an effective date (ModificationDate in BillingCenter) for the charges.

     Audit

Used to make changes to an existing policy as part of an audit. Properties specify whether this is a final audit and whether the charge represents the total or incremental premium for the policy. BillingCenter does not support total premium in its default integration, but it can be customized to do so.

     Cancellation

Policy cancellation. Includes the following additional properties.

  • CancellationReasonString that describes the reason for the cancellation.
  • CancellationType – Values are defined in the CancellationType typelist, which has Flat, Prorata, and Shortrate in the base configuration.
  • HoldUnbilledPremiumCharges – Boolean field specifying whether all unbilled premium charges on the policy will be held at the end of the cancellation.

     General

A “catch-all” general-purpose billing instruction for an existing policy. Policy administration systems may use this subtype for billing instructions that do not fit any of the other subtypes.

     PolicyChange

Used to specify changes to an existing policy.

     PremiumReportBI

Used to send premium report information.

     Reinstatement

Used to reinstate a policy.

NewPlcyPeriodBI

All billing instructions for policy transactions that create a new policy period. This subtype has properties with a list of producer codes for the new period.

     Issuance

Attach a new PolicyPeriod and link it to an existing Account. Automatically creates the new Policy for that PolicyPeriod.

     NewRenewal

Lets you attach a new PolicyPeriod. It also has a link to an Account. The difference between this billing instruction and the Renewal billing instruction is that this one is for a policy that is a renewal for the insurer but new for BillingCenter. This instruction also creates a new Policy entity for the policy period.

     Renewal

Lets you attach a new PolicyPeriod and link it to an existing Account. It expects to have a prior policy period. It links the new period to the existing policy.

     Rewrite

Rewrite a policy. In the built-in integration, the Rewrite instruction duplicates the behavior of the Renewal billing instruction. Insurers who required specialized policy-period behavior can customize this instruction.

ReversalBillingInstruction

Reserved for Guidewire internal use.

At the time that PolicyCenter binds a job that can generate premium transactions, PolicyCenter sends a billing instruction to BillingCenter. Even if there are no charges, BillingCenter may need to know about a change to the policy period, such as knowing whether the period was canceled or reinstated. The following table summarizes what type of billing instruction PolicyCenter sends for different situations. A factor that determines what to send is whether PolicyCenter created a new policy and/or new period.

PolicyCenter Policy transaction

BillingCenter BillingInstruction subtype

Conditions and comments

submission

Issuance

Even if bind only (bind and bill, with delayed issuance), PolicyCenter generates charges for billing.

issuance

PolicyChange

PolicyCenter sends this billing instruction if the issuance creates at least one premium transaction or the following properties change: PeriodStart, PeriodEnd, or Producer Code of Record.

Although PolicyCenter calls this an Issuance, because the submission already establishes the period, then PolicyCenter simply sends adjusting charges for an existing period.

policy change

PolicyChange

PolicyCenter sends this billing instruction if there is at least one premium transaction or one of the following properties change: PeriodStart, PeriodEnd, or Producer Code of Record.

cancellation

Cancellation

All cancellations.

reinstatement

Reinstatement

All reinstatements.

renewal (regular)

Renewal

For regular renewals. Policy must already exist in BillingCenter.

Not used in a conversion on renewal scenario.

renewal (new renewal)

NewRenewal

For new renewals. This is the policy period in PolicyCenter. Typically you need to create the policy in BillingCenter and create a new period.

Used in a conversion on renewal scenario.

rewrite

Rewrite

A rewrite establishes a new period for the same policy.

final audit

Audit

All final audits.

premium report

PremiumReportBI

All premium reports.

See also

  • “Billing instructions” in BillingCenter Application Guide