Configure a Socotra external rater integration to connect to a third-party ISO rating engine for personal auto

Steps

1. Deploy your third-party ISO rating engine as a publicly reachable HTTPS service (or accessible via private network to Socotra's cloud); note the HTTPS POST endpoint URL that will receive rating requests
2. In the Socotra Administration UI (or via the Integrations API), create an external rater configuration: assign a unique name, set the endpoint URL, and optionally configure authentication headers (e.g., 'Authorization: YOUR_RATER_TOKEN') to secure the callback
3. Edit the product's policy.json configuration file to include the entry 'externalRater': '<your_rater_name>' for the personal auto product; deploy the updated configuration to your Socotra tenant
4. When Socotra calls your rater, it sends an HTTP POST with the full policy JSON including all characteristic data; implement your rater to extract vehicle, driver, and coverage details, apply ISO rate tables, and return a response with pricedPerilCharacteristics populated
5. If rating fails or business rules are violated, include an exceptionMessage field in the response body; Socotra will surface this as an HTTP 409 error to the API caller — make error messages actionable for the front-end developer
6. Test in Socotra sandbox by initiating a quote via the Policy API; confirm that Socotra calls your rater endpoint, your rater returns correct premiums, and the Socotra policy record reflects the rated premium