Batch Import Status

Introduction

Depending on the size of the data import, it may take 1 second to 30 minutes for a policy transaction import batch to complete. Once complete, you can receive the specific batch status including errors such as tax calculation errors, missing fields, and missing documents.

🚧

Before Getting Started:

InsCipher utilizes data tables outside of the documentation for every request to provide the most up to date requirements for your integration. Depending on your configuration, you may need to reference the following tables, which will be mentioned further down in the documentation.

Feel free to open these in a new window or bookmark for future use:

• Generic Lines of Business List

Request Method - GET

Authentication and URL

A user is authenticated using an API key, which is provided by your InsCipher implementation specialist. The API key is typically around 40 characters.

API Key: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

ENDPOINT URL

https://surpluslines.inscipher.com/api/v4/transaction-import-results.json?apikey=xxxxx&batch_id=yyyyyy

Sucess Response Sample

 {
"batch_id": "912a654e961bb083981145c344ca40c6",
"status": "processed",
"transactions": [
{
"id": "201909240000000001",
"policy_number": "CA20170228-05",
"transaction_id": 34859,
"status": 0,
"status_message": "Success"
}]
}

Success Response + Warnings Sample

 {
"batch_id": "912a654e961bb083981145c344ca40c6",
"status": "processed",
"transactions": [
{
"id": "201909240000000001",
"policy_number": "CA20170228-05",
"transaction_id": 34859,
"status": 0,
"status_message": "Success",
"warnings": {
"lineOfBusiness": "Line of business is invalid.",
"total": "Transaction total values don't match. Provided - 4224.80. Calculated - 3407.98",
"slTax": "SL tax values don't match. Provided - 117.00. Calculated - 93.26",
"stampingFee": "Stamping fee values don't match. Provided - 7.80. Calculated - 6.22"
}
}]
}

Error Response Sample

 {
"batch_id":"f6272344cc2b5dccdaf24c9120ab77de",
"status": "processed",
"transactions":[
{
"id":"00001",
"policy_number":"ABC 0099",
"status":1001,
"status_message":"Error: missing required document with code 'POLIC'."
}]
}

Response Status (Batch) Codes

Response Status Codes

Available Warning Messages

How Do I View And Correct Batch Import Errors Manually?

If there are errors, you can go to the "Filings Import Log" page to identify the transactions that have errors and correct them.

If there are many errors that came through on a batch, you can delete the entire batch by clicking the "Delete" button on the batch:

You can also click under the "Not Imported Filings" or the "Error Log" to download a list of errors in the batch.

When pulling up the error code list, you will see the reason for the error followed by the policy number that was trying to be uploaded.

You will then need to go into the batch and correct the error.