Submission web services

Use the SubmissionAPI web service to start draft and quote submissions for policy renewals from external systems.

Passing in external policy period data for submissions

To start submission jobs in PolicyCenter, the SubmissionAPI web service accepts data that populates PolicyCenter policy periods, which submission jobs use. The entire set of external data comes in the policyPeriodData parameter, defined as a String. You can use any text-based format in your implementation that you can parse, for example XML format.

To parse the policyPeriodData parameter, the methods on the SubmissionAPI web service parse the String data as XML by using the Guidewire XML model (GX model) definition. The GX Model is available at the location gw.webservice.pc.pc1000.gxmodel.policyperiodmodel. Then the code calls the populatePolicyPeriod enhancement method on the XML object. The enhancement method is implemented in gw.webservice.pc.pc1000.gxmodel.PolicyPeriodModelEnhancement.

If you want to add line-specific populating or validation code, modify the populatePolicyPeriod enhancement method. If you need to use a different XSD or GX model, modify the SubmissionAPI web service implementation class directly.

Start a submission

The startDraftSubmission method create a submission and leaves it in a draft state.

function startDraftSubmission(accountNumber : String, productCode : String, producerCodeId : String,
                                policyPeriodData : String, parseOptions : String) : String

The method accepts the following arguments.

  • Account number as a String
  • Product code as a String
  • Producer code public ID as a String
  • XML representation of policy period data from the external system as a String
  • Set of parse options as a String that controls how your implementation parses the policy period data

The method returns a String that contains the job number of the submission.

Start a submission and generate a quote

The quoteSubmission method creates a submission and attempts to generate a quote.

function quoteSubmission(accountNumber : String, productCode : String, producerCodeId : String,
                                policyPeriodData : String, parseOptions : String) : String

The method accepts the following arguments.

  • Account number as a String
  • Product code as a String
  • Producer code public ID as a String
  • XML representation of policy period data from the external system as a String
  • Set of parse options as a String that controls how your implementation parses the policy period data

The method returns a String that contains the job number of the submission.