Product Release Notes
2021-10-27: Version 2021.43
New Beta Feature: PostIssuance Plugin with Document Consolidation!
Allows consolidating multiple policy documents into one after policy transactions.
See the Beta Guide for details.
Bug Fixes
Fixed a bug where updates to field groups on endorsements in the
application
state with invalid locators would fail without error.Fixed a bug where the Event Stream Policy End Event would not fire for policies that had been cancelled and subsequently reinstated.
Fixed a bug where a policy entering grace could cause Event Stream queries to fail.
2021-10-21: Version 2021.42
Documentation Changes
Added a new Documents feature guide.
Added a new API Guide for Errors and Exceptions.
Reorganized topic categories.
Bug Fix
Fixed a bug in the data for endorsement document rendering, where removing a peril from an endorsement would cause the entire exposure to be marked as having been removed.
2021-10-13: Version 2021.41
New Feature: Auxiliary Data!
Associate structured and unstructured data with any Socotra entity, outside the bounds of formal policy transactions.
Accessible from the API, plugins, UI, and document renderers.
See the Auxiliary Data Feature Guide for more details.
Bug Fixes
Fixed a bug in the UI where conditional fields could cause errors making it impossible to save changes.
Fixed a bug in Configuration Studio where tables that contain quoted key values which contain commas would not be parsed properly.
Fixed a bug in the legacy UI where removing a newly added exposure from an endorsement could cause an error.
Fixed a bug where the All Policies report and On Risk report could fail with an error if the underlying policy structure has changed.
2021-10-06: Version 2021.40
New Beta Feature: Auxiliary Data!
Associate structured and unstructured data with any Socotra entity, outside the bounds of formal policy transactions.
Accessible from the API, plugins, UI, and document renderers.
Bug Fixes
Fixed a bug where an incorrect policyLocator or displayId could be sent from an external data call.
Fixed a bug in configuration studio where minimum and maximum value settings could not accept floating point values.
Fixed a bug where, in a claim without the
incidentTimestamp
set, adding a subclaim could fail without an error message.Fixed a bug where phantom fees were being sent to the proration plugin.
Fixed a bug in the front end where a blank page would be rendered when adding a new exposure to a policy, which required refreshing the browser.
Fixed a bug in the legacy front end where field groups amendments on endorsements could fail.
2021-09-29: Version 2031.39
New Feature: Overwriting Policyholder Data!
This feature allows expunging policyholder data for regulatory compliance or other reasons.
See the API Guide for details.
Enhancement: Endorsements at any time of day
Previous versions did not allow endorsements at any time of day other than midnight based on the tenant’s timezone setting. This restriction has now been removed and endorsements may be made effective at any time of day.
Policy effective and expiration timestamps continue to be unrestricted.
User interface support for “any time of day” effective dates is forthcoming.
Documentation Updates
Several entities have had obscure names changed. For example,
Policy2Response
is now PolicyResponse.This change does not affect the operation of the API, because JSON is untyped and therefore doesn’t expose type names. This change is intended to make the documentation and swagger data file clearer.
Bug Fix
Fixed a bug where adding a second cancellation to a policy could make retrieving the first cancellation fail.
2021-09-22: Version 2021.38
Payment Schedule Plugin
The payment schedule plugin is now used for cancellation transactions.
The installments created on cancellation must align with previous installments. See payment schedule validation for details. This requirement will be relaxed in a future release.
Documentation Improvements
API guides now have an endpoint index at the top of each page.
API properties are now sorted to make it easier to find relevant properties.
Other style improvements.
Bug Fixes
Fixed a bug where invalid combinations of trigger fields and lookup fields could be permitted in an endorsement.
Fixed a bug where reinstating a lapsed policy that had previous ended exposures would fail.
2021-09-15: Version 2021.37
New Beta Feature: Installment Fees!
Installment fees are scriptable fees that can be added to invoice installments.
Requires using the Payment Schedule Plugin.
See the Installment Fees Feature Guide for more details.
Bug Fixes
Fixed a bug where there could be missing locators in the peril prices in the EndorsementResponse.price object.
Fixed a bug where there was an excessive rounding error (up to 0.03%) applied to technical premium rates calculated by the Payment Schedule Plugin or the External Rater.
2021-09-08: Version 2021.36
New Feature: Cancellation Categories!
This feature allows end users to select from a list of categories for cancellation scenarios to make selecting the cancellation type less difficult and error prone. See the feature guide for details.
Bug Fixes
Fixed a bug where there was an excessive rounding error (up to 0.03%) applied to rates calculated by the Payment Schedule Plugin or the External Rater.
Fixed a bug where the
newLine
configuration property of a field was not creating a new line in the UI for viewing or editing the field.
2021-09-01: Version 2021.35
Bug Fix
Fixed a bug where the GET cancellations endpoint would sometimes not return a price summary in the CancellationResponse.
2021-08-25: Version 2021.34
New Beta Release: Policy Snapshots and Coverage Summaries!
This feature shows the state of the policy using different reference dates. See the feature guide for details.
New Beta Release: Cancellation Categories!
This feature allows end users to select from a list of categories for cancellation scenarios to make selecting the cancellation type less error prone. See the beta guide for details.
2021-08-18: Version 2021.33
New Beta Feature: Installment Fees!
Installment fees are scriptable fees that can be added to invoice installments.
Requires using the Payment Schedule Plugin.
See the Installment Fees Guide for more details.
Event Stream
Added a
cancellationName
property to the event for policy cancellations.
Bug Fixes
Fixed a bug where a static PDF document could be transmitted as
application/octet-stream
rather thanapplication/pdf
, which could cause the document not to be properly associated with a policy.Fixed a bug where negative premium amounts could cause errors in the Proration Plugin.
Fixed a bug where there could be inconsistency in which quote the system indicates as
selected
.Fixed a bug where, when rendering a document for an endorsement, the
data.endorsement.display_id
property could have the wrong value.
2021-08-11: Version 2021.32
Event Stream
Added a new Event Stream Feature Guide feature guide.
Added an optional
cancellationName
property to the EventStreamCancellationIssueData object.
Payment Schedule Plugin
Lifted a validation check in the payment schedule plugin such that invoice items created by the plugin may have dates that are not fully contained within the original
charge
object for the invoice item, though they must be contained within the policy bounds. The invoice item start and end timestamps are used for this validation.
Bug Fixes
Fixed a bug where the PremiumReportResponse object could have its payments object unpopulated when there are existing payments.
Fixed a bug in configuration studio where table names had a
.csv
extension improperly appended.Fixed a bug where, if the payment schedule plugin was enabled, accepted endorsement and renewal quote invoices were prematurely attached to the policy before issuance.
2021-08-04: Version 2021.31
Implementation Notice
Important
When implementing the payment schedule plugin the default proration calculation for endorsements and cancellation can yield unexpected results. All customers who are using the payment schedule plugin should also implement the proration plugin to prevent any issues.
Configuration Studio
Configuration Studio now supports viewing, creating, and editing plugin scripts!
Plugin enablement will be supported in a future release; for now please edit that section of
policy.json
outside of studio.
Bug Fixes
Fixed a bug in configuration studio that caused a validation error when adding and then removing a cancellation type or an endorsement type.
Fixed a bug where a valid policy end reminder could fail to fire when a disabled reminder was in the configuration.
Fixed a bug where proration of fees of varying duration could fail in the proration plugin.
Documentation Updates
Added details about validation requirements to the various plugins topics
Updated the detailed sample script for the proration plugin topic
2021-07-28: Version 2021.30
Bug Fixes
Fixed a bug where the first invoice after the renewal had the wrong issue timestamp
Fixed a regression where invoices with reversed payments could not cause the start of the grace period
Fixed a bug where a cancellation request could cause an invalid duration error with HTTP 500
Fixed a bug where some premium report event stream events were not being generated
2021-07-21: Version 2021.29
New Feature: Bundling Payment Schedule Changes with Endorsements and Renewals!
Atomic management of payment schedule changes and endorsements and renewals simplifies many scenarios. See the feature guide for details.
New Feature: Ad Hoc Fees!
This release supports the creation and management of fees.
Fee reversals are also now now supported.
Bug Fixes
Fixed a bug where an error could occur with event stream message for premium reports.
Fixed a bug where invoices that have had payments reversed would prevent grace processing even though they are unpaid.
Fixed a problem where the logging context for the proration plugin did not include policy locator data.
2021-07-07: Version 2021.27
Bug Fixes
Fixed a bug where new perils could be created on a renewal, even if the renewal request failed
Fixed a bug in the UI where the
newPaymentScheduleName
property was set on an endorsement or renewal, even when the user did not intend to make a payment schedule change.Fixed a bug where, on renewal, two invoices could be created on the renewal date.
2021-06-30: Version 2021.26
New Beta: Bundling Payment Schedule Changes with Endorsements and Renewals!
Payment schedule changes can be managed with endorsements and renewals for atomic transactions. See the feature guide for details.
Bug Fixes
Fixed a bug where hyperlinks in generated PDFs were not clickable.
Fixed a bug in the UI where a renewal could be quoted without specifying a renewal end date.
Fixed a bug in the UI where incorrect fees were displayed for a reduction endorsement.
2021-06-23: Version 2021.25
Updates
In document templates, commission data has been added to the renderer’s
data
object.In premium report documents and premium calculation templates, previous premium report data has been added to the
data
object.
Bug Fixes
Fixed a bug where not all perils were included for repricing in an endorsement when the reprice
all
parameter is set.Fixed a bug where trying to add a new exposure for a
draft
endorsement would fail.
2021-06-17: Version 2021.24
New Release: Rating Plugin!
The new Rating Plugin is now released for general availability!
The older Liquid-based rating feature is now deprecated.
Note: This release does not affect rating for Premium Reports. Those continue to use Liquid rating.
Bug Fixes
Fixed a bug where a policy could lapse even if all invoices were paid
Fixed a bug where there were intermittent connectivity issues when calling an external rater
Fixed a bug where policyholder field value validation was using an overly restrictive regular expression
2021-06-10: Version 2021.23
Beta Release: Rating Plugin!
The new Rating Plugin is now available for beta testing.
Update
Now most API errors will include an
apiErrorCode
for use in integration scenarios. See the error code list for details.
2021-06-03: Version 2021.22
New Feature: Proration Holdbacks!
Proration Holdbacks are a mechanism for applying cancellation short rates or withholding fees or commissions in cancellation scenarios.
New Capabilities: Product Versioning
Product versioning now allows the creation of policies with a specific version number. It also adds the ability to retrieve configuration zip files by version number, and to get a history of versions previously deployed. See the Product Versioning topic and Deployments API guide for details.
Updates
Plugins are now enabled by a simple enablement structure in
policy.json
, which also allows for configuring the path to the plugin file. See the Plugins topic for details.When a payment is reversed, if the invoice due date is in the past, it will have the due date reset to the end of the current day. This prevents the policy from becoming delinquent without the opportunity to reapply a payment.
Bug Fix
Fixed a bug where delinquent policies could exit the grace period prematurely.
2021-05-26: Version 2021.21
New User Interface!
Socotra has a new user interface! See the feature guide topic for more details.
Update
Payment reversal will cause the underlying invoice to have its due date reset to the end of the current day if it is currently in the past. This will prevent delinquency processing from immediately causing the policy to go into grace.
2021-05-19: Version 2021.20
New Feature!
The Product Versioning feature now supports Product Version Repair.
Released new configuration deployment endpoints to the Configuration API.
Bug Fix
Fixed a bug where relative paths in JavaScript
require()
calls in plugins were not handled properly.
2021-05-12: Version 2021.19
Beta Update!
The Product Versioning feature has been augmented with new endpoints useful for the Repair beta feature. These endpoints are in beta form.
Bug Fixes
Fixed a bug where exposures could pass validation for endorsements and renewals even if they had missing required fields.
Fixed a bug where the UI incorrectly forced the use of premium reporting for products that support premium reporting.
Fixed a bug where there could be duplicate proration holdbacks in the PolicyPriceChangeResponse.
2021-05-05: Version 2021.18
Beta Release!
The new Product Versioning Repair Beta is now available!
Product Enhancement
The Event Stream responses for premium reports now include a policyLocator
property.
Bug Fixes
Fixed a bug where endorsements could fail when updating optional fields with an empty value
Fixed a bug where calling
GET /policies/*/quotes
for a policy would fail if the policy was in grace
2021-04-28: Version 2021.17
Product Enhancement
Enabled the write off feature for the Payment Schedule Plugin.
Bug Fix
Fixed a bug where the payment schedule plugin did not set the time span for reinstatement invoices properly.
2021-04-21: Version 2021.16
New Features!
Product Versioning makes modifying configurations controlled and safe to avoid conflicts with already-existing data.
The Payment Schedule Plugin offers fine control over the creation and scheduling of invoices.
2021-04-14: Version 2021.15
New! Proration Holdbacks Beta
The new Holdbacks feature allows retaining more than just a proportionate amount of premium or fees in the event of a cancellation. This is useful for applying short rates or fee retention. See the Holdbacks Page for details.
Bug Fixes
Fixed a bug where certain short-term policies could be renewed with more than one invoice, which interfered with processing the renewal.
Fixed a bug where a policy could not lapse a second time after reinstatement
2021-04-07: Version 1.3.198
New Document Rendering Performance Improvements!
Documents are now rendered in parallel instead of serially. Policy transactions that render more than one document should see substantial performance improvements.
Note
If the feature flag property.docconversion.service.enabled
had previously been set to false
, document rendering will remain in serial. Set it to true
to enable this feature by default.
New Beta Releases!
The new Product Versioning Beta is now available!
The new Payment Schedule Plugin Beta is now available!
Updates to the New UI Beta
Enhancements and improvements are continuing.
Bug Fixes
Fixed a bug where renewals created an incorrect invoice due date
Fixed a bug where it was not possible to create a field group field for Premium Reports
Fixed a bug where the external rater was called even for non-premium-bearing endorsements
2021-03-31: Version 1.3.197
Bug Fix
Fixed a bug where the policyholder locator was not validated on policy creation.
2021-03-24: Version 1.3.196
Removal Notice
The following deprecated feature flags are planned for removal on September 24, 2021. Customers should set the value of these flags to true
in all tenants as soon as possible. Please contact Socotra support with any questions.
Quotes for New Business:
property.quotes.for.new.business.enabled
Quotes for Endorsements and Renewals:
property.quotes.for.endorsements.and.renewals.enabled
Premium Reporting:
property.premium.reporting.enabled
Bug Fixes
Fixed a bug where a migrated policy’s invoices could not be paid.
Fixed a bug in the UI where a quoted but not-yet-accepted renewal did not appear.
Fixed a bug in the UI where a policy reinstated with a gap in coverage erroneously displayed as in-force during the gap.
Fixed a bug in configuration studio where adding fields to premium reports that had no fields would fail.
2021-03-10: Version 1.3.194
New Feature! Table Lookups from Plugins
Plugins now support table lookups. Use the function
socotraApi.tableLookup(configVersion, tableName, key)
Note: The
configVersion
parameter will be used in a future version of Socotra. For now, pass the value0
.
New Event Stream Events
The following events have been added to the Event Stream:
Bug Fix
Fixed a bug in the UI where the price summary for reinstatements incorrectly showed the total rather than the amount of change.
2021-03-03: Version 1.3.193
New Feature! Proration Plugin
The proration plugin offers complete control over how premium is prorated and allocated after a cancellation or endorsement.
See details in the Proration and Premium Allocation topic.
Bug Fix
Fixed a bug where the reinstatement data was not available in the Liquid document renderer for cancellations.
Fixed a bug where adding a peril in an endorsement failed validation if there were no pre-existing perils.
2021-02-24: Version 1.3.192
Bug Fixes
Fixed a bug where fields of type
lookup
were not retrieved for read-only users.Fixed a bug where payment of certain policies would fail with an HTTP 500 error.
2021-02-17: Version 1.3.191
Feature Flag Deprecation
Several feature flags have been deprecated. See the API Change Log for details.
Bug Fixes
Fixed a bug where occasionally an invoice would be generated for a few cents for non-premium-bearing endorsements.
Fixed a bug where truncating a policy with an endorsement would sometimes generate a “Cannot build QuotedFinancialTransactionCreateRequest” error.
2021-02-10: Version 1.3.190
Bug Fixes
Fixed a bug where it was possible to finalize a policy with missing non-optional fields.
Fixed a bug in configuration studio where the maximum length setting for a string field was not being set correctly.
2021-02-03: Version 1.3.189
Bug Fixes
Fixed a bug where a grace period would not be settled after several delinquency events even if the payment had been posted.
Fixed a bug where trying to pay a reversed invoice resulted in an HTTP 500 error rather than HTTP 400.
2021-01-27: Version 1.3.188
New Feature! Improved Cancellations and Reinstatements
Cancellations and Policy Lapse have been combined.
New lifecycle controls for cancellations and reinstatements, including different flows and documents for different cancellation reasons.
Reinstatement after manual cancel is now supported.
Reinstatement with a gap in coverage is now supported.
See full details in cancellations and reinstatements.
Bug Fixes
Fixed a bug where the invoice issue event data included an incorrect policy locator.
2021-01-13: Version 1.3.187
No customer-facing changes; internal improvements only.
2020-12-22: Version 1.3.186
Payment Reversals
The
reverseTimestamp
property on the PaymentResponse object has been renamed toreversedTimetamp
.
Bug Fixes
Fixed a problem in payment reversals where payments for invoices that were settled by an endorsements or renewal and were reversed did not have the
reversedTimestamp
property populated, and the payment.reverse event was not raised.Fixed a bug where it was possible for a single past-due policy to have multiple lapses created.
Fixed a bug where exposures created in accepted-but-not-issued renewals and endorsements were included in the On-Risk Report
2020-12-16: Version 1.3.185
New! Payment Reversal
Payments can be reversed with the new reverse payment endpoint.
2020-12-09: Version 1.3.184
Bug Fix
Fixed a bug where an endorsement could not be priced with field groups removed as part of the transaction
2020-12-02: Version 1.3.183
Event Stream
Added Policyholder Create and Policyholder Update events to the Event Stream API
Bug Fixes
Fixed a bug where special characters in email addresses (like ä, ö, ü, ë, è, é, ê) would fail to pass validation
Fixed a bug where it was impossible to reinstate certain policies in the UI
Fixed a bug where removing a fieldGroup in an endorsement would fail
Fixed a bug where certain policies would not appear in the UI
2020-11-18: Version 1.3.182
Event Stream
Added Login and Login Failure events to the Event Stream API
2020-11-11: Version 1.3.181
Bug Fixes
Fixed a bug where the All Policies report did not return all rows
Fixed a bug where setting the
newPolicyEndTimestamp
to the existing end of a policy in an endorsement an error would be generatedFixed a bug where the fees in an endorsement were not set correctly in the EndorsementResponse
Fixed a problem where errors were caused by incomplete validation on policy acceptance
2020-10-28: Version 1.3.180
Bug Fixes
Fixed a bug where users could not get renewal details for some policies through the tenant UI
Fixed a bug where it was impossible to cancel a policy within a few hours of the original policy end
2020-10-21: Version 1.3.179
Bug Fix
Fixed a bug that sometimes caused the Paid Financial Transactions Report to fail to generate.
2020-10-14: Version 1.3.178
UI
Added the ability to discard quotes that are in the
invalidated
state
Bug Fixes
Fixed a bug where deploying a product configuration after removing a product would prevent redeploying a new product configuration
Fixed a bug where some policies would fail to renew based on incorrect timestamps
2020-10-07: Version 1.3.177
New! Scripting Plugins
“Plugins” is a new feature for configuring Socotra system behavior without the use of cumbersome Liquid code. See the Plugins Feature Overview for details.
Added new endpoints for uploading scripts and extracting logs from plugins
The first plugin is for the automated underwriting decision
Reports
Added the exposure locator to the Paid Financial Transactions report
Added the modification name to the Paid Financial Transactions report and the All Issued Policies report
Bug Fixes
Fixed a bug where creating a new quote did not use the original quote as the basis for exposures or perils.
2020-09-30: Version 1.3.176
Policy Change Management
Socotra now permits discarding quoted and invalidated endorsements and renewals through the API and UI
Claims Only Users
Socotra now permits claims-only users to upload media items
Bug Fixes
Fixed a bug where the zero due invoice generated by non-price changing endorsement only contained financial transactions for a single peril
Fixed a bug where adding a peril while extending the policy term in an endorsement would fail
Fixed a bug in the UI where it was not possible to see peril details for a newly added exposure on a quoted renewal
Fixed a bug where removing a table in configuration studio caused an error
2020-09-23: Version 1.3.175
Policy Change Management
Enabled policy change management features in the UI
Removed the need to set a feature flag to enable Quotation
BugFixes
Fixed a bug where an exception could occur when calling Preview endorsement price when removing field groups.
2020-09-16: Version 1.3.174
Added new endpoints to show the state that the policy will be in after an
accepted
endorsement or renewal is issued.Fixed a bug where an endorsement or renewal response object was missing the details about the changes to the policy.
Improved the object model documentation topic
2020-09-09: Version 1.3.173
Bug Fixes
Fixed a bug where an added exposure in an endorsement was not being priced properly.
Fixed a bug where creating an endorsement directly in the
quoted
state did not return planned invoices in the response.
2020-09-02: Version 1.3.172
New Feature
New Feature! Quotation of endorsements and renewals, including multiple concurrent quotes, is now supported. See Policy Change Management for details.
Bug Fixes
Fixed a bug where the
effectiveTimestamp
themodifications
array of the PolicyResponse could show an incorrect time.Fixed a bug where deploying a new configuration caused search to fail.
2020-08-26: Version 1.3.171
Financial Transactions
Merged the financial transaction object with the now-removed FinancialTransactionResponse2
. The new object has all the fields in both of the former objects.
Premium Reporting
Added individual premiums to price breakdown in the UI
Fixed a bug where the report timestamp in the premium calculation liquid context was incorrect
Configuration Studio
Fixed a bug where renaming perils after an account reset or revert to last deployment failed
Fixed a “Product Name undefined” error that could occur after deploying a new configuration
2020-08-19: Version 1.3.170
Bug Fixes
Fixed a performance issue with issuing renewals
Fixed a bug where the name of a premium report was not available in the UI
2020-08-12: Version 1.3.169
Renewal Rating
Added data.renewal information for renewal rating logic
Bug Fixes
Fixed a bug where claims only users could not access premium reporting policies
Fixed a bug where a policy could start a grace period even after the delinquent invoice was paid
Fixed a bug in the UI where users were not being prompted for endorsement reprice options
2020-08-05: Version 1.3.168
API Additions
Added the Integrations API, used for configuring external raters
Added a new authenticate admin user endpoint
Bug Fixes
Fixed a bug where multiple endorsements with exposure additions and removals sometimes failed with an Illegal Argument Exception
Fixed a bug where an endorsement followed by another endorsement that reduced the policy term to before the effective time of the first endorsement would fail
2020-07-22: Version 1.3.167
Bug Fixes and Improvements
Fixed a bug where on cancelling a renewed policy the refund invoice amount for the renewal was incorrect
Fixed a bug where premium reports were able to be issued even after errors in rendering documents
Fixed a bug in Configuration Studio where json errors did not prevent deploying the configuration
Fixed a bug in the UI where the
Get Pricing
button for a quote was improperly enabled even when the quote name was emptyFixed a bug in the UI where invoice settlement status was displayed as
null
Various performance enhancements
2020-07-15: Version 1.3.166
Configuration Studio
Added a Premium Reporting example product to the Configuration Studio Product Library. (From the Home screen in Configuration Studio, in the Products section, click Add New
and then click the Library
tab.)
External Rater
Added a quoteLocator
field to the payload for calls to external raters, for new business rating.
Bug Fixes
Fixed a bug with endorsements where updates to the start time before issuance caused the endorsements’ modification objects to have incorrect start timestamps
Fixed a bug where documents were not getting generated properly for premium reports
Fixed a bug where users with
account.tenant.admin
permissions did not have thePermissions
column populated on the Manage Users page
2020-07-08: Version 1.3.165
Premium Reporting
New! Added a new feature: Premium Reporting. See Premium Reporting for details.
Quotes
Quotes can now be named and renamed in the user interface.
Bug Fix
Fixed a bug where the next monthly invoice amount increased when an endorsement was in accepted
state but was not refunded when the endorsement was invalidated.
2020-07-01: Version 1.3.164
Bug Fixes
Fixed a bug in configuration studio where incorrect files were being generated in response to new fee and tax configurations.
Fixed a bug where it was impossible to set a field value for an optional field to the empty string.
2020-06-24: Version 1.3.163
Bug Fixes
Fixed a bug where an extra invoice for a few cents was sometimes generated at the end of a policy term.
2020-06-17: Version 1.3.162
Bug Fixes
Fixed a bug where read-only users were not able to generate reports
Fixed a bug where the total premiums after reinstatement without gap did not match the original premium
2020-06-10: Version 1.3.161
New Payment Schedules
Socotra has existing payment schedules of total
and monthly
. With this release we have added annually
, semiannually
, quarterly
, every_two_weeks
and weekly
as available payment schedules. See invoicing for more information.
End of Month Installment Scheduling
Previously, policies that started at the end of a month could exhibit unusual behavior when installments “fell off” the end of the month. For example, with a monthly policy starting on January 31, since there is no February 31, the next installment would fall on March 3.
Now installments will fall on the same day, or the last day in a month for shorter months:
January 31
February 28
March 31
April 30
etc…
Quotes in the UI
The full installment schedule for a quote is now available in the UI. See the
Future Invoices
section on the quote.When searching in the UI, matches that correspond to a specific quote will be returned as quote objects. Each quote can be clicked to get to that specific quote.
2020-06-03: Version 1.3.160
Quotes
Socotra now has controls for when documents are rendered in the quotes workflow:
Standard documents can be rendered at any of
quote
,accept
, orissue
.Invoice documents can be rendered at either of
accept
orissue
.
By deferring rendering until documents are needed, performance can be improved, which can be important for quickly generating and comparing multiple quotes.
See the Quotes Documentation for details.
Note
Configuration Studio does not yet support GUI controls for the configuration settings for the document generatingEvent
. This will be added to an upcoming release. You can use the text editor mode to add generating event properties to policy.json
.
2020-05-27: Version 1.3.159
Bug Fix
Fixed a bug where it was not possible to change renewal documents in configuration studio.
2020-05-20: Version 1.3.158
Configuration Studio
Configuration studio now has the ability to rename products, exposures, and perils from the UI. Click the context menu icon and choose the Rename
option.
2020-05-13: Version 1.3.157
Quotes
Released user interface support for the Quotes for New Business feature. Now, when the policy is in draft state, there is a dropdown that selects which quote to view and work with. The Create New Quote
button allows creating new quotes based on the selected quotes as a starting point. Quotes can be individually priced with the Quote
button. After the policy is issued, all quotes are accessible in the Historical Quotes
section.
External Rater
Socotra now checks responses sent from external raters for the field exceptionMessage
. If this field is found, the Socotra API will return an HTTP 409
error back to the client, with the error message in the message
field. In addition, this message will be displayed to the user in the Socotra UI if the transaction originated from the UI.
Bug Fix
Fixed a bug where the create quote endpoint failed when a payload was included with the request.
2020-04-29: Version 1.3.156
Bug Fixes
Fixed a bug that prevented document page numbers from being rendered correctly.
Fixed a bug where policies with accepted quotes were erroneously marked as finalized.
Fixed other minor quotes bugs.
2020-04-22: Version 1.3.155
New Product Library
A library of pre-configured products has been added to Configuration Studio. From the Home screen in Configuration Studio, click Add New
and then click the Library
tab. You can then choose from a list of products cultivated by Socotra.
2020-04-15: Version 1.3.154
CSS Injection
CSS Injection is a new feature that allows customizing the look and feel of the Socotra UI. See CSS Injection for details.
2020-03-25: Version 1.3.151
Quotes for New Business
Quotes for New Business is a new feature that allows the creation of multiple prospective versions of a policy, with different coverages and pricing.
Underwriting, rating, and document rendering is controlled separately for each quote.
User interface support for the Quotes API is underway and will be released soon.
See Quotes documentation for details.
2020-01-07: Version 1.3.141
New Configuration Studio!
A new version of the configuration studio released. Users should migrate to the new studio available at https://studio.sandbox.socotra.com/studio/ and transition away from the old version located at https://studio.sandbox.socotra.com/configstudio/ which has become deprecated.
2019-09-04: Version 1.3.125
New ‘All Issued Policies’ Report
All Issued Policies is a report on all policies issued within a time range, similar in structure to the On-Risk Report. See reporting documentation for details.
2019-08-07: Version 1.3.121
Event Stream
The Event Stream API now supports a policy.end
event which is fired when a policy expires.
2019-07-24: Version 1.3.119
Deposit Account API Deprecated
The Deposit Account API is now deprecated, and will be removed in a future release. See the API Change Log for details.
2019-05-01: Version 1.3.107
Peril Endorsements UI
The policy administration UI now allows endorsements on perils. Perils can be added, updated, and ended (same functionality as is in the API).
2019-04-24: Version 1.3.106
Claims Payables
The API now allows recording payables at the subclaim level.
See documentation here.
Reminder Events
Reminders can now be configured to alert of impending events.
The reminders will appear in the event stream.
See documentation here.
2019-03-27: Version 1.3.102
Updating Peril Limits in the UI
In the UI, all peril limits are now editable. Configured default values still appear, but can be overridden.
2019-03-20: Version 1.3.101
Invoice and Document Attribution
In the API, invoices and documents created by cancellations, endorsements, and other policy operations are now returned with the locator of the policy modification corresponding to the creating operation. See documentation for invoices and {{documents|PolicyDocumentResponse>}}.
2019-03-06: Version 1.3.99
Adding, Updating and Ending Perils During Renewals
Upon renewal, perils can be added to existing exposures. Existing perils can have coverage limits and other details updated, and can have coverage ended when the renewal period starts. See API documentation here
2019-02-20: Version 1.3.97
Adding Perils During Endorsements
An endorsement can now add a peril to an existing exposure. See API documentation here.
2019-02-13: Version 1.3.96
Renewal Documents
Documents can now be configured to be generated during renewals. See feature documentation here
Updating Perils During Endorsements
An endorsement can now update peril-level information via the API. See API documentation here.
2019-01-30: Version 1.3.95
Ending Coverage on Perils During Endorsements
An endorsement can now end coverage on an individual peril via the API. See API documentation here
2019-01-16: Version 1.3.93
Adding and Ending Exposures On Renewals
Exposures can be added to a policy as part of a renewal.
Exposures can be ended as part of a renewal, meaning they will not have coverage during the renewal period.
See API documentation here
2019-01-09: Version 1.3.92
Field Updates on Renewals
Field values at the policy and exposure levels can be updated upon renewal.
See API documentation here
2018-12-19: Version 1.3.91
2018-12-12: Version 1.3.90
Get All Policyholders Endpoint
The API now supports loading all policyholders in an instance via a paging mechanism. See documentation here
2018-12-05: Version 1.3.89
External Rater Support
Support for a new External Rater service has been added to calculate premium, technical premium, and commissions in lieu of Liquid peril premium calculation templates. See full documentation here
2018-11-07: Version 1.3.86
Removal of Obsolete Liquid Filters
Several Liquid filters have been removed:
set_peril_premium
in favor ofset_month_premium
andset_year_premium
add_commission
in favor ofadd_month_commission
andadd_year_commission
set_technical_premium
in favor ofset_month_technical_premium
andset_year_technical_premium
get_30_360_day_count
2018-10-24: Version 1.3.84
End of Life Notices
V2 claims and the card/form/dictionary configuration for them have been removed.
Several Liquid filters are being deprecated and will be removed on October 31, 2018. Please update your configuration as soon as possible
set_peril_premium
in favor ofset_month_premium
andset_year_premium
add_commission
in favor ofadd_month_commission
andadd_year_commission
set_technical_premium
in favor ofset_month_technical_premium
andset_year_technical_premium
get_30_360_day_count
2018-10-17: Version 1.3.83
End of Life Notice
V2 claims and the card/form/dictionary configuration for them are being sunset and will be removed on October 24, 2018. Please update your configuration as soon as possible.
2018-10-03: Version 1.3.81
UI Improvements
No more automatic deletion of input that doesn’t pass validation
Number field values may now be deleted during data input
No more autocorrection for text input into number fields
Typing after selecting a dropdown field now matches the beginning of each option, rather than any text in it
No need to select the Exposure when a product has only one Exposure type
No need to select the Peril when a product has only one Peril type
2018-09-19: Version 1.3.79
Claims Report
The Claims report is a report of all claims in the system and their case reserves as of a given time. See Reporting documentation.
2018-09-05: Version 1.3.77
Subclaim Statuses
Subclaims may now be closed or reopened independently of the parent claim.
2018-08-29: Version 1.3.76
More Claims Improvements
Closing a claim now sets the reserves on its subclaims to zero.
2018-08-22: Version 1.3.75
Claims Improvements
Claims are now validated against coverage dates. Loss reserves may not be set if no coverage was on at the incident time.
The workflow has been simplified, with more information visible on each screen.
You can now create and open claims with a single API call, and re-open closed claims for additional processing.
The event stream now records changes to a reserve.
2018-08-15: Version 1.3.74
New Claims Redesign
File claims and subclaims against a policy and specific coverage, respectively
Record loss and expense reserves on subclaims
Report on reserves
See Claims for more information
2018-08-01: Version 1.3.73
Updates to Rating and Invoicing
February and March invoices will have identical premiums for monthly billing.
Premium allocation is done on an “actual days within a billing period” basis. See Premium allocation documentation.
Socotra will automatically scale premiums for partial periods. You now specify premium in terms of 1 month or 1 year.
To turn on these updates:
Add
"improvedRating": true
to/config.json
Replace all uses of (1)
set_peril_premium
with eitherset_month_premium
orset_year_premium
; (2)add_commission
with eitheradd_month_commission
oradd_year_commission
; and (3)set_technical_premium
with eitherset_month_technical_premium
orset_year_technical_premium
2018-07-25: Version 1.3.72
User Management UI
You can now manage users in any given Socotra instance. This Supports viewing, creating, disabling, and updating users. Access this feature via the Administration
link at the top right of the login screen. Administrator/Configuration Studio credentials are needed to manage users in an instance. Once logged in, you may also change the password for the user. Click the user name at the top right and select Settings
.
2018-07-06: Version 1.3.70
More Security Improvements
Rate-limited login
Updated CORS policy
2018-06-27: Version 1.3.69
Security Improvements
Updated GDPR compliance measures
Simple and common passwords are no longer allowed. If a user tries to set too simple a password, the system will offer suggestions to improve it.
Resolved vulnerabilities
2018-06-20: Version 1.3.68
Single Login for Configuration Studio
Configuration Tester no longer requires a second login.
2018-06-13: Version 1.3.67
Password Complexity Enforcement
During a password change in the Socotra UI, simple and/or common passwords are no longer allowed. If this happens, the system will offer advice on how to make the password more secure.
2018-05-30: Version 1.3.65
Lapsing and Reinstatement
Socotra now supports lapsing and reinstatement on unpaid policies, with a grace period. See Lapsing and reinstatement documentation.
End of Life Notices
Socotra Administrator has been shut down. Please use Configuration Studio instead.
Socotra V2 has been shut down. It is no longer possible to log in to V2 test instances. Instances using the Policy-Exposure-Peril data model are on V3 and are not affected.
2018-05-23: Version 1.3.64
End of Life Notices
Socotra Administrator will be sunset. Please use Configuration Studio instead.
Socotra V2 is being sunset. V2 instances show a warning indicating this. Instances using the Policy-Exposure-Peril data model are on V3 and will not be affected.
2018-05-16: Version 1.3.63
Easier to Understand UI Design
The updated UI design now applies to all Socotra instances. Improvements include:
Related information is grouped together visually
Higher-contrast design makes it easier to see what information is related
More efficient use of screen space
More consistent terminology and visual elements
More intuitive workflows and button placement
2018-05-09: Version 1.3.62
Improved configuration Validations
Missing tax.liquid.premium file now results in an error while loading config Unused brand, payment, dictionary, and roles files are no longer required
Renewals Fees
Renewals may now apply fees. See Renewals documentation for details.
2018-05-02: Version 1.3.61
The Add Document endpoint now works for policies in any status. See API documentation for details.
2018-04-25: Version 1.3.60
Locator Format Change
Locators in future policies will be 9-digit decimal numbers rather than 36-digit strings. Existing policies will not change.
Settlement Types
Settlement types are now available on invoices in the API. Invoices can be settled as paid, written off, or zero due. See relevant API documentation for more information.
Field Groups in the On Risk Report
The first two instances of each field group now appear in the on risk report. Each field in the field group has its own column, and columns are named according to the convention: “[policy | exposure | peril ] [field group name] [1|2] [field name]”.
End-of-Life Notices
The field
policyInvoice2Response.paid
has been removed. Use the most recent entry in “statuses” instead.The Commissions Report has been removed, and replaced with the “Payable Commissions Report.”
2018-04-11: Version 1.3.59
All instances created after this version goes live will have encrypted policyholder data. Instances created before then will not be affected. All configuration and API endpoints remain the same
You can now add multiple products quickly in Config Studio. The “Add/Remove” workflow now allows adding multiple new items without re-opening the dialog box.
Perils are now shown in alphabetical order in the UI.
2018-04-04: Version 1.3.58
Renewals
Add a renewal term to a policy with the same coverage as at the end of the previous term but with new claims limits. See Renewals documentation and API documentation.
End-of-Life Notices
The field
policyInvoice2Response.paid
will be removed on April 11, 2018, because it doesn’t mean what a user would expect and shouldn’t be used. Use the most recent entry in “statuses” instead. See API documentation.The Commissions Report is being removed, because the results of the report are not what a user would expect. Use the “Payable Commissions Report” instead.
2018-03-28: Version 1.3.57
Endorsements can now change the policy end date, with the appropriate change in premium. See the endorsements documentation and API documentation for details.
Configuration deployment tools now allow zip files of up to 50MB
2018-03-21: Version 1.3.56
Configuration studio now loads faster.
Dates in the Payable Commissions report now use the “YYYYMMDD” format.
2018-03-14: Version 1.3.55
Use display names for taxes, fees, and perils in invoice document templates. This eliminates the need to format the field name to make it readable. See Relevant documentation for more.
You can now add or remove products, exposures, and/or perils in Configuration Studio.
The policy admin UX has been improved, with wording changes for clarity, breadcrumbs in the reporting UI, and report inputs shown above the preview pane.