Some insurance policies have premium that is calculated retrospectively; that is, only after the policy term or a portion of the term is completed will the actual premium be knowable. These are often called pay as you go policies because the billing is based on actual experience during the policy term.
The Premium Reporting feature is used to handle these types of policies. Unlike standard policies, billing is based on premium reports as they are filed, and not by premiums attributed to perils. There is one invoice per premium report, generated at the time the report is issued, rather than a schedule of invoices known up front.
See the Premium Reporting API topic for technical details about the API, and the Premium Reporting Configuration Guide for information about how to configure the feature.
Premium Reports are created in draft state. While in draft state they can be updated as many times as desired. Then, when the report data is ready, the report can be issued, at which time the pricing will be calculated, and documents and invoices will be generated. Issued reports can no longer be updated.
Reports in draft state may be manually discarded. After they are issued they are no longer allowed to be discarded.
Reports are submitted to cover sequential segments of time. The first report has a start time equal to the start time of the policy, and an endTimestamp that can be specified to any time after the start time and before the policy expires. The subsequent report will start at the time the previous report ends, and again can end at any time before policy expiration.
Each report has a startTimestamp and an endTimestamp. The startTimestamp is always set automatically by the system.
The timespan of a premium report may not cross renewal boundaries. A report with an endTimestamp equal to the end of the term should be issued, followed by a report that will pick up at the beginning of the following term.
Also, the policy may not be endorsed as of any time that is already covered by an issued premium report.
The invoice for a premium report will be due at midnight on the day the report is issued, unless that is overridden with the invoiceDueTimestamp.
No automated proration or scaling will ever be done for calculating premium report premium, fees, taxes, and commissions. The actual monetary amounts supplied will be those amounts presented on the report’s invoice.