Introduction

AAGI – Motor Web Service

AAGI provides web service which allows Broker/Partner to get premium, issue policy, get policy information (car inspection status) and cancel policy.

Web Service Feature:

Get premium for VMI Type 1, VMI Type 2+ VMI Type 3+, VMI Type 3, CMI
Issue Policy for VMI Type 1, VMI Type 2+ VMI Type 3+, VMI Type 3, CMI
Issue E-Policy for VMI Type 1, VMI Type 2+ VMI Type 3+, VMI Type 3, CMI
Get Policy Information (Get car inspection result)
Cancel Policy for VMI Type 1, VMI Type 2+ VMI Type 3+, VMI Type 3, CMI

1. Quick Quotes API

Purpose of the API

To retrieve premiums without generating quotation in the system

How it works

Once API was trigger, it will calculate premium from conditions that contain in Request and return as response message or return fail if it has error information.

Web service URL

UAT environment : https://asia-uat-th-pc.apis.allianz.com/v1/motor/quickquotes
Pre-Production environment : https://asia-pre-th-pc.apis.allianz.com/v1/motor/quickquotes

(1) Get premiums by using default coverage value

1.1 All default coverage

sumInsured = null AND coverageItems = null
System will return all default coverage data.

API request/Response

Request - VMI1

{
   "policyStartDate": "2022-07-23",
   "policyExpiryDate": "2023-07-23",
   "channel": "WS",
   "productCode": "VMI",
   "vehicle": {
        "make": "39",
        "model": "1597",
        "usage": "110",
        "garageType": "COMPANY",
        "vehicleIdentificationNumber": "KNDJA723515687177",
        "registrationNumber": "กข1234",
        "registrationState": "0",
        "yearOfManufacture": "2022",
        "engineNumber": "52WVC10337",
        "owners": null,
        "color": 7,
        "registrationType": "GEN",
        "registrationCountry": "THA"

   },
   "productPackages": [
        {
            "name": "GRANU",
            "coverages": [
                {
                    "name": "VMI1",
                    "code": "VMI1",
                    "sumInsured": null,
                    "coverageItems": null
                }
            ]
        }
    ]
}

Response - VMI1

{
    "policyStartDate": "2022-07-23",
    "policyExpiryDate": "2023-07-23",
    "channel": "WS",
    "productCode": "VMI",
    "vehicle": {
        "make": "39",
        "model": "1597",
        "usage": "110",
        "garageType": "COMPANY",
        "vehicleIdentificationNumber": "KNDJA723515687177",
        "registrationNumber": "กข1234",
        "registrationState": "0",
        "yearOfManufacture": "2022",
        "engineNumber": "52WVC10337",
        "numberOfSeats": 7,
        "owner": null,
        "color": "7",
        "registrationType": "GEN",
        "registrationCountry": "THA"
    },
    "productPackages": [
        {
            "name": "GRANU",
            "coverages": [
                {
                    "name": "VMI1",
                    "code": "VMI1",
                    "sumInsured": 600000,
                    "coverageItems": [
                        {
                            "name": "Sum Insured",
                            "code": "OD",
                            "sumInsured": 600000
                        },
                        {
                            "name": "Deduct Amount",
                            "code": "DD",
                            "sumInsured": 0
                        },
                        {
                            "name": "TPBI/Persons",
                            "code": "TPBI_PERSON",
                            "sumInsured": 500000
                        },
                        {
                            "name": "TPBI Claims/Accident",
                            "code": "TPBI_ACCIDENT",
                            "sumInsured": 10000000
                        },
                        {
                            "name": "TPPD Claims",
                            "code": "TPPD",
                            "sumInsured": 2500000
                        },
                        {
                            "name": "RY01(PA)/Person",
                            "code": "PA",
                            "sumInsured": 100000
                        },
                        {
                            "name": "RY02(ME)/Person",
                            "code": "ME",
                            "sumInsured": 100000
                        },
                        {
                            "name": "RY03(BailBond)",
                            "code": "BB",
                            "sumInsured": 200000
                        },
                        {
                            "name": "Roadside Assistance",
                            "code": "RA85",
                            "sumInsured": null
                        }
                    ]
                }
            ],
            "premium": {
                "discounts": null,
                "additionalCosts": [
                    {
                        "name": null,
                        "type": "VAT",
                        "amount": 1308.44
                    },
                    {
                        "name": null,
                        "type": "STAMP",
                        "amount": 75
                    }
                ],
                "netPremium": 18617,
                "grossPremium": 20000.44
            }
        }
    ]
}

Request - VMI2+

{
   "policyStartDate": "2022-07-23",
   "policyExpiryDate": "2023-07-23",
   "channel": "WS",
   "productCode": "VMI",
   "vehicle": {
        "make": "39",
        "model": "1597",
        "usage": "110",
        "garageType": "COMPANY",
        "vehicleIdentificationNumber": "KNDJA723515687177",
        "registrationNumber": "กข1234",
        "registrationState": "0",
        "yearOfManufacture": "2022",
        "engineNumber": "52WVC10337",
        "owners": null,
        "color": 7,
        "registrationType": "GEN",
        "registrationCountry": "THA"

   },
   "productPackages": [
        {
            "name": "GRANU",
            "coverages": [
                {
                    "name": "VMI2+",
                    "code": "VMI2+",
                    "sumInsured": null,
                    "coverageItems": null
                }
            ]
        }
    ]
}

Request - VMI3+

{
   "policyStartDate": "2022-07-23",
   "policyExpiryDate": "2023-07-23",
   "channel": "WS",
   "productCode": "VMI",
   "vehicle": {
        "make": "39",
        "model": "1597",
        "usage": "110",
        "garageType": "COMPANY",
        "vehicleIdentificationNumber": "KNDJA723515687177",
        "registrationNumber": "กข1234",
        "registrationState": "0",
        "yearOfManufacture": "2022",
        "engineNumber": "52WVC10337",
        "owners": null,
        "color": 7,
        "registrationType": "GEN",
        "registrationCountry": "THA"

   },
   "productPackages": [
        {
            "name": "GRANU",
            "coverages": [
                {
                    "name": "VMI3+",
                    "code": "VMI3+",
                    "sumInsured": null,
                    "coverageItems": null
                }
            ]
        }
    ]
}

Request - VMI3

{
   "policyStartDate": "2022-07-23",
   "policyExpiryDate": "2023-07-23",
   "channel": "WS",
   "productCode": "VMI",
      "vehicle": {
        "make": "39",
        "model": "1597",
        "usage": "110",
        "garageType": "UNSPECIFIED",
        "vehicleIdentificationNumber": "WD33D2050426L009018",
        "registrationNumber": "4กฮ 2434",
        "registrationState": "0",
        "yearOfManufacture": "2020",
        "engineNumber": "",
        "owners": null,
        "color": "2",
        "registrationType": "REDPLATE",
        "registrationCountry": "THA"
   },
   "productPackages": [
       {
           "name": "GRANU",
           "coverages": [
               {
                   "name": "VMI3",
                   "code": "VMI3",
                   "sumInsured": null,
                   "coverageItems": null
               }
           ]
       }
   ]
}

Request - CMI

{
    "policyStartDate": "2022-07-23",
    "policyExpiryDate": "2023-07-23",
    "channel": "WS",
    "productCode": "CMI",
    "vehicle": {
        "make": "39",
        "model": "1597",
        "usage": "2.40A",
        "garageType": null,
        "vehicleIdentificationNumber": "WD33D2050426L009018",
        "registrationNumber": "4กฮ 2434",
        "registrationState": "0",
        "yearOfManufacture": "2020",
        "engineNumber": "",
        "owners": null,
        "color": "2",
        "registrationType": "REDPLATE",
        "registrationCountry": "THA"

    }
}

1.2 The default coverage with specific sumInsured

sumInsured = any valid value AND coverageItems = null
System will return the default coverage data with input sumInsured.

API request/Response

Request

{
   "policyStartDate": "2020-05-20",
   "policyExpiryDate": "2021-05-20",
   "channel": "WS",
   "productCode": "VMI",
   "vehicle": {
        "make": "39",
        "model": "1597",
        "usage": "110",
        "garageType": "COMPANY",
        "vehicleIdentificationNumber": "WD33D2050426L009018",
        "registrationNumber": "4กฮ 2434",
        "registrationState": "0",
        "yearOfManufacture": "2020",
        "engineNumber": "",
        "owners": null
   },
   "productPackages": [
       {
           "name": "GRANU",
           "coverages": [
               {
                   "name": "VMI1",
                   "code": "VMI1",
                   "sumInsured": 700000,
                   "coverageItems": null
               }
           ]
       }
   ]
}

Response

{
  "policyStartDate": "2020-05-20",
  "policyExpiryDate": "2021-05-20",
  "channel": "WS",
  "productCode": "VMI",
  "vehicle": {
    "make": "39",
    "model": "1597",
    "usage": "110",
    "garageType": "COMPANY",
    "vehicleIdentificationNumber": "WD33D2050426L009018",
    "registrationNumber": "4กฮ 2434",
    "registrationState": "0",
    "yearOfManufacture": "2020",
    "engineNumber": "",
    "numberOfSeats": 7,
    "owner": null
  },
  "productPackages": [
    {
      "name": "GRANU",
      "coverages": [
        {
          "name": "VMI1",
          "code": "VMI1",
          "sumInsured": 700000,
          "coverageItems": [
            {
              "name": "Sum Insured",
              "code": "OD",
              "sumInsured": 700000
            },
            {
              "name": "Deduct Amount",
              "code": "DD",
              "sumInsured": 0
            },
            {
              "name": "TPBI/Persons",
              "code": "TPBI_PERSON",
              "sumInsured": 500000
            },
            {
              "name": "TPBI Claims/Accident",
              "code": "TPBI_ACCIDENT",
              "sumInsured": 10000000
            },
            {
              "name": "TPPD Claims",
              "code": "TPPD",
              "sumInsured": 2500000
            },
            {
              "name": "RY01(PA)/Person",
              "code": "PA",
              "sumInsured": 100000
            },
            {
              "name": "RY02(ME)/Person",
              "code": "ME",
              "sumInsured": 100000
            },
            {
              "name": "RY03(BailBond)",
              "code": "BB",
              "sumInsured": 200000
            },
            {
              "name": "Roadside Assistance",
              "code": "RA85",
              "sumInsured": null
            }
          ]
        }
      ],
      "premium": {
        "discounts": null,
        "additionalCosts": [
          {
            "name": null,
            "type": "VAT",
            "amount": 1555.4
          },
          {
            "name": null,
            "type": "STAMP",
            "amount": 89
          }
        ],
        "netPremium": 22131,
        "grossPremium": 23775.4
      }
    }
  ]
}

(2) Get premiums by using specific coverage value

All coverage items need to be input

Coverage Items: mandatory fields

Code	Description (EN)	Description (TH)	VMI1	VMI2+	VMI3+	VMI3	Remark
OD	Sum Insured	ทุนประกันภัยรถยนต์	Yes	Yes	Yes	No	VMI3 should be “0” or null
DD	Deduct Amount	ความเสียหายส่วนแรก	Yes	Yes	Yes	No	VMI3 should be “0” or null
FL	Flood	ความเสียหายเนื่องจากภัยน้ำท่วม	No	Yes	Yes	No	VMI1 and VMI3 should be “0” or null
TPBI_PERSON	TPBI/Person	ความเสียหายต่อชีวิตร่างกายอนามัยบุคคลภายนอก/คน	Yes	Yes	Yes	Yes
TPBI_ACCIDENT	TPBI Claims/Accident	ความเสียหายต่อชีวิตร่างกายอนามัยบุคคลภายนอก/ครั้ง	Yes	Yes	Yes	Yes
TPPD	TPPD Claims	ความเสียหายต่อทรัพย์สินบุคคลภายนอก	Yes	Yes	Yes	Yes
PA	RY01 (PA)/Person	อุบัติเหตุส่วนบุคคล	Yes	Yes	Yes	Yes
ME	RY02 (ME)/Person	ค่ารักษาพยาบาล	Yes	Yes	Yes	Yes
BB	RY03 (BailBond)	การประกันภัยตัวผู้ขับขี่	Yes	Yes	Yes	Yes

API request/Response

Request

{
   "policyStartDate": "2019-12-25",
   "policyExpiryDate": "2020-12-25",
   "channel": "WS",
   "productCode": "VMI",
   "vehicle": {
        "make": "39",
        "model": "1538",
        "usage": "110",
        "garageType": "COMPANY",
        "vehicleIdentificationNumber": "KNDJA723515686177",
        "registrationNumber": "กข1234",
        "registrationState": "0",
        "yearOfManufacture": "2019",
        "engineNumber": "52WVC10337",
        "owner":{
           "birthDate": "1987-01-01",
             "address": {
                  "postalCode": "10400"
                     }
               }
   },
   "productPackages": [
       {
           "name": "GRANU",
           "coverages": [
               {
                   "name": "VMI1",
                   "code": "VMI1",
                   "sumInsured": 1300000,
                   "coverageItems": [
                    {
                "name": "Sum Insured",
                "code": "OD",
                "sumInsured": 1300000
              },
              {
                "name": "Deduct Amount",
                "code": "DD",
                "sumInsured": 0
              },
              {
                "name": "TPBI/Persons",
                "code": "TPBI_PERSON",
                "sumInsured": 1000000
              },
              {
                "name": "TPBI Claims/Accident",
                "code": "TPBI_ACCIDENT",
                "sumInsured": 10000000
              },
              {
                "name": "TPPD Claims",
                "code": "TPPD",
                "sumInsured": 2500000
              },
              {
                "name": "RY01(PA)/Person",
                "code": "PA",
                "sumInsured": 100000
              },
              {
                "name": "RY02(ME)/Person",
                "code": "ME",
                "sumInsured": 100000
              },
              {
                "name": "RY03(BailBond)",
                "code": "BB",
                "sumInsured": 200000
              }
                   ]
               }
           ]
       }
   ]
}

Response

{
  "policyStartDate": "2019-12-25",
  "policyExpiryDate": "2020-12-25",
  "channel": "WS",
  "productCode": "VMI",
  "vehicle": {
    "make": "39",
    "model": "1538",
    "usage": "110",
    "garageType": "COMPANY",
    "vehicleIdentificationNumber": "KNDJA723515686177",
    "registrationNumber": "กข1234",
    "registrationState": "0",
    "yearOfManufacture": "2019",
    "engineNumber": "52WVC10337",
    "owner": null
  },
  "productPackages": [
    {
      "name": "GRANU",
      "coverages": [
        {
          "name": "VMI1",
          "code": "VMI1",
          "sumInsured": 1300000,
          "coverageItems": [
            {
              "name": "Sum Insured",
              "code": "OD",
              "sumInsured": 1300000
            },
            {
              "name": "Deduct Amount",
              "code": "DD",
              "sumInsured": 0
            },
            {
              "name": "TPBI/Persons",
              "code": "TPBI_PERSON",
              "sumInsured": 1000000
            },
            {
              "name": "TPBI Claims/Accident",
              "code": "TPBI_ACCIDENT",
              "sumInsured": 10000000
            },
            {
              "name": "TPPD Claims",
              "code": "TPPD",
              "sumInsured": 2500000
            },
            {
              "name": "RY01(PA)/Person",
              "code": "PA",
              "sumInsured": 100000
            },
            {
              "name": "RY02(ME)/Person",
              "code": "ME",
              "sumInsured": 100000
            },
            {
              "name": "RY03(BailBond)",
              "code": "BB",
              "sumInsured": 200000
            },
            {
              "name": "Roadside Assistance",
              "code": "RA85",
              "sumInsured": null
            }
          ]
        }
      ],
      "premium": {
        "discounts": null,
        "additionalCosts": [
          {
            "name": null,
            "type": "VAT",
            "amount": 1937.67
          },
          {
            "name": null,
            "type": "STAMP",
            "amount": 111
          }
        ],
        "netPremium": 27570,
        "grossPremium": 29618.67
      }
    }
  ]
}

Data model

Data Attribute

Type

Mandatory

Description

Sample data

Remark

VMI

CMI

policyStartDate

String

Yes

The effective start date of policy

2019-12-25

policyExpiryDate

String

The expiration date of policy

2019-12-25

channel

String

Yes

Channel

Fixed Value

productCode

Enum

Yes

Product identifier

VMI, CMI

Fixed Value

vehicle

This provide the vehicle information

make

String

Yes

State the make (manufacturer) of the vehicle, e.g., Honda, Toyota.

model

String

Yes

State the model (manufacturer) of the vehicle, e.g., Honda Civic 2.0 4 Doors

1538

usage

String

Yes

The car usage propose e.g. private or commercial use etc.

VMI Ex. 110, 120
CMI Ex. 1.10, 1.40A

garageType

Enum

Automotive garages and repair shops type

DEALER, COMPANY, UNSPECIFIED //Find Garage Type table for the details

Fixed Value

vehicleIdentificationNumber

String

The car's vehicle identification number according to the manufacturer model certificate.

KNDJA723515686177

color

String

The Car color

code	Des (TH)	Des (EN)
1	น้ำเงิน	Blue
2	ดำ	Black
3	เขียว	Green
4	แดง	Red
5	ขาว	Whilte
6	เหลือง	Yellow
7	เทา	Grey
8	ม่วง	Violet
9	ทอง	Gold
10	ฟ้า	Light Blue
11	น้ำตาล	Brown

registrationNumber

String

The official ID number of the vehicle

กข1234
In the case of new car (don't have license plate no), please send blank value.
กรณีรถป้ายแดง กรุณาส่งเป็นค่าว่าง

If registerationType is REDPLATE, this field will be optional

registrationState

String

Yes

The official license plate province code

For CMI: if registerationCountry is not THA or registerationType is GOV or INTER, this field will be optional

registerationType

String

The type of license vehicle

GEN, REDPLATE, GOV, INTER

code	Des (TH)	Des (EN)
GEN	รถทั่วไป	General car
REDPLATE	ป้ายแดง	Red plate car
GOV	ราชการ	Government car
INTER	รถต่างประเทศ	Foreign car

registerationCountry

String

The country of the license vehicle

THA

Refer Country table

yearOfManufacture

String

Yes

The car manufacturer year

2019

engineNumber

String

This attribute indicates the engine number according to the manufacturer's model certificate.

52WVC10337

productPackages

Yes

This section is required for VMI product only

name

String

Package name for references

GRANU, null

Fixed Value

coverages

Coverage name, selected status and associated code. The Coverage list will be retrieved via the Offerings API.

name

Enum

Product coverage name

VMI1, VMI2+, VMI3+, VMI3

Fixed Value

code

Enum

Yes

A code indicating the type of coverage Item

VMI1, VMI2+, VMI3+, VMI3

Fixed Value

sumInsured

Number

Sum Insured for benefit

1300000

coverageItems

Policy benefits (the items depend on coverage)

name

String

Coverage item name

TPBI/Persons

code

String

Coverage item code Depends on product and coverage

TPBIP

sumInsured

Number

Sum Insured for benefit

1000000

Garage Type

Product	Garage Type
VMI1	“DEALER”, “COMPANY”
VMI2+	“COMPANY”
VMI3+	“COMPANY”
VMI3	null, “UNSPECIFIED”
CMI	null, “UNSPECIFIED”

DEALER = อู่ห้าง
COMPANY = อู่ประกัน
UNSPECIFIED = ไม่มีการระบุอู่ (จะใช้สำหรับ VMI3)

Validate mandatory fields conditions:

If registrationCountry is	If registrationType is	registrationState will be	registrationNumber will be	Remark
THA	GEN	Mandatory	Mandatory
THA	REDPLATE	Mandatory	Optional
THA	GOV	Optional	Mandatory
Other countries	INTER	Optional	Mandatory
Null	Null	Mandatory	Optional	Existing validation
Null	GEN	Mandatory	Mandatory
Null	REDPLATE	Mandatory	Optional
NULL	GOV	Optional	Mandatory
THA	Null	Mandatory	Optional
Other countries	Null	Optional	Mandatory

2. Issue Policy (Contracts)

Purpose of the API

To issue policy to OPUS system.

How it works

Once API was trigger, it will generate policy and e-Policy to system. In case it has car Inspection process, system will response with car inspection notice.

Web service URL

UAT environment : https://asia-uat-th-pc.apis.allianz.com/v1/motor/contracts
Pre-Production environment : https://asia-pre-th-pc.apis.allianz.com/v1/motor/contracts

(1) Insured Person is PERSON

API request/Response

Request

{
  "policyStartDate": "2022-06-17",
  "policyExpiryDate": "2023-06-17",
  "productCode": "VMI",
  "channel": "WS",
  "contractProcessState": "ISSUE",
  "isDigitalPolicy": true,
  "vehicle": {
        "make": "39",
        "model": "1597",
        "usage": "110",
        "garageType": "COMPANY",
        "vehicleIdentificationNumber": "MR0GSdrdshsh72X",
        "registrationNumber": "ฟผ3234",
        "registrationState": "0",
        "yearOfManufacture": "2021",
        "engineNumber": null,
        "numberOfSeats": 7,
        "owner": null,
        "color": "7",
        "registrationType": "GEN",
        "registrationCountry": "THA"
    },
    "productPackages": [
        {
            "name": "GRANU",
            "coverages": [
                {
                    "name": "VMI1",
                    "code": "VMI1",
                    "sumInsured": 600000,
                    "coverageItems": [
                        {
                            "name": "Sum Insured",
                            "code": "OD",
                            "sumInsured": 580000
                        },
                        {
                            "name": "Deduct Amount",
                            "code": "DD",
                            "sumInsured": 0
                        },
                        {
                            "name": "TPBI/Persons",
                            "code": "TPBI_PERSON",
                            "sumInsured": 500000
                        },
                        {
                            "name": "TPBI Claims/Accident",
                            "code": "TPBI_ACCIDENT",
                            "sumInsured": 10000000
                        },
                        {
                            "name": "TPPD Claims",
                            "code": "TPPD",
                            "sumInsured": 2500000
                        },
                        {
                            "name": "RY01(PA)/Person",
                            "code": "PA",
                            "sumInsured": 100000
                        },
                        {
                            "name": "RY02(ME)/Person",
                            "code": "ME",
                            "sumInsured": 100000
                        },
                        {
                            "name": "RY03(BailBond)",
                            "code": "BB",
                            "sumInsured": 200000
                        },
                        {
                            "name": "Roadside Assistance",
                            "code": "RA85",
                            "sumInsured": null
                        }
                    ]
                }
            ],
            "premium": {
                "discounts": null,
                "additionalCosts": [
                    {
                        "name": null,
                        "type": "VAT",
                        "amount": 1202.6
                    },
                    {
                        "name": null,
                        "type": "STAMP",
                        "amount": 69
                    }
                ],
                "netPremium": 17111,
                "grossPremium": 18382.6
            }
        }
    ],
    "insuredPerson": {
    "type": "PERSON",
    "title": "ร.ต.อ.",
    "firstName": "พอเพียง",
    "lastName": "ไชโย",
    "gender": "MALE",
    "identificationDocuments": [
      {
        "identityType": "NRIC",
        "identityNumber": "4254580668830"
      }
    ],
    "nationality": "TH",
    "birthDate": "1988-12-25",
    "occupation": "99",
    "registerId": "string",
    "companyPrefix": "string",
    "companyName": "string",
    "companySuffix": "string",
    "customerName": "string",
    "emailAddress": " string@string.com ", 
    "mobilePhone": "0820509431",
        "addresses": [
            {
                "type": "REGISTER",
                "addressLine1": "No. 9 G Tower Rama 9, 10th Floor",
                "addressLine2": "line2",
                "addressLine3": "line3",
                "addressLine4": "line4",
                "district": "1",
                "subDistrict": "3210",
                "state": "24",
                "postalCode": "96000"
            },
            {
                "type": "CURRENT",
                "addressLine1": "No. 10 G Tower Rama 9, 10th Floor",
                "addressLine2": "line2",
                "addressLine3": "line3",
                "addressLine4": "line4",
                "district": "1",
                "subDistrict": "3210",
                "state": "24",
                "postalCode": "96000"
            }
        ]
  },
  "beneficiary": {
    "type": "PERSON",
    "title": "คุณหญิง",
    "firstName": "พิมดาว",
    "lastName": "มีดี",
    "gender": "FEMALE",
    "identificationDocuments": [
      {
        "identityType": "NRIC",
        "identityNumber": "3011535486109"
      }
    ],
    "nationality": "TH",
    "birthDate": "2000-01-20",
    "occupation": "14",
    "registerId": "string",
    "companyPrefix": "string",
    "companyName": "string",
    "companySuffix": "string",
    "customerName": "string",
    "emailAddress": "test@bb.bb",
    "mobilePhone": "0820509431",
        "addresses": [
            {
                "type": "REGISTER",
                "addressLine1": "No. 9 G Tower Rama 9, 10th Floor",
                "addressLine2": "line2",
                "addressLine3": "line3",
                "addressLine4": "line4",
                "district": "1",
                "subDistrict": "3210",
                "state": "24",
                "postalCode": "96000"
            },
            {
                "type": "CURRENT",
                "addressLine1": "No. 10 G Tower Rama 9, 10th Floor",
                "addressLine2": "line2",
                "addressLine3": "line3",
                "addressLine4": "line4",
                "district": "1",
                "subDistrict": "3210",
                "state": "24",
                "postalCode": "96000"
            }
        ]
  },
  "payer": {
    "type": "PERSON",
    "title": "MS",
    "firstName": "บีบี",
    "lastName": "เอเอ",
    "gender": "MALE",
    "identificationDocuments": [
      {
        "identityType": "NRIC",
        "identityNumber": "3182431105753"
      }
    ],
    "nationality": "TH",
    "birthDate": "1999-05-11",
    "occupation": "14",
    "registerId": "string",
    "companyPrefix": "string",
    "companyName": "string",
    "companySuffix": "string",
    "customerName": "string",
    "emailAddress": "test@cc.cc",
    "mobilePhone": "0820509431",
        "addresses": [
            {
                "type": "REGISTER",
                "addressLine1": "No. 9 G Tower Rama 9, 10th Floor",
                "addressLine2": "line2",
                "addressLine3": "line3",
                "addressLine4": "line4",
                "district": "1",
                "subDistrict": "3210",
                "state": "24",
                "postalCode": "96000"
            },
            {
                "type": "CURRENT",
                "addressLine1": "No. 10 G Tower Rama 9, 10th Floor",
                "addressLine2": "line2",
                "addressLine3": "line3",
                "addressLine4": "line4",
                "district": "1",
                "subDistrict": "3210",
                "state": "24",
                "postalCode": "96000"
            }
        ]
  },
    "consents": [
        {
            "consentGroup": "Insured person/beneficiary/payor do not involve in Iran, North Korea, Russia or Syria",
            "consentType": "SANCTION_COUNTRY",
            "hasAccepted": true,
            "acceptanceDate": "2019-02-26"
        },
        {
            "consentGroup": "Data Privacy Policy Consent Form",
            "consentType": "INFORMATION",
            "hasAccepted": true,
            "acceptanceDate": "2019-02-26"
        },
        {
            "consentGroup": "Marketing  or  servicing, Accepting T&C, Promotional info",
            "consentType": "MARKETING",
            "hasAccepted": true,
            "acceptanceDate": "2019-02-26"
        }
    ]
}

Response

{
  "contractId": "_Uo9Et3pC2DqSgHH0UpD0g",
  "policyNumber": "22-001-M01-001689",
  "policyStartDate": "2022-06-17",
  "policyExpiryDate": "2023-06-17",
  "documentUrl": "https://example.com",
  "policyStatus": "SUCCESS"
}

Noted: The documentUrl link will be expired in 15 days from the issue date.

(2) Insured Person is COMPANY

API request/Response

Request

{
    "policyStartDate": "2020-05-20",
    "policyExpiryDate": "2021-05-20",
    "proposalDate": null,
    "channel": "WS",
    "productCode": "VMI",
    "contractProcessState": "ISSUE",
	"isDigitalPolicy": false,
    "vehicle": {
    "make": "39",
    "model": "1597",
    "usage": "110",
    "garageType": "COMPANY",
    "vehicleIdentificationNumber": "WD33D2050426019",
    "registrationNumber": "4กค4034",
    "registrationState": "0",
    "yearOfManufacture": "2020",
    "engineNumber": "",
    "numberOfSeats": 7,
    "owner": null,
	"color": "7",
	"registrationType": "GEN",
	"registrationCountry": "THA"
  },
  "productPackages": [
    {
      "name": "GRANU",
      "coverages": [
        {
          "name": "VMI1",
          "code": "VMI1",
          "sumInsured": 700000,
          "coverageItems": [
            {
              "name": "Sum Insured",
              "code": "OD",
              "sumInsured": 700000
            },
            {
              "name": "Deduct Amount",
              "code": "DD",
              "sumInsured": 0
            },
            {
              "name": "TPBI/Persons",
              "code": "TPBI_PERSON",
              "sumInsured": 500000
            },
            {
              "name": "TPBI Claims/Accident",
              "code": "TPBI_ACCIDENT",
              "sumInsured": 10000000
            },
            {
              "name": "TPPD Claims",
              "code": "TPPD",
              "sumInsured": 2500000
            },
            {
              "name": "RY01(PA)/Person",
              "code": "PA",
              "sumInsured": 100000
            },
            {
              "name": "RY02(ME)/Person",
              "code": "ME",
              "sumInsured": 100000
            },
            {
              "name": "RY03(BailBond)",
              "code": "BB",
              "sumInsured": 200000
            },
            {
              "name": "Roadside Assistance",
              "code": "RA85",
              "sumInsured": null
            }
          ]
        }
      ],
      "premium": {
        "discounts": null,
        "additionalCosts": [
          {
            "name": null,
            "type": "VAT",
            "amount": 1555.4
          },
          {
            "name": null,
            "type": "STAMP",
            "amount": 89
          }
        ],
        "netPremium": 22131,
        "grossPremium": 23775.4
      }
    }
  ],
  "insuredPerson": {
    "type": "COMPANY",
    "title": null,
    "firstName": null,
    "lastName": null,
    "gender": null,
	"identificationDocuments": null,
    "nationality": null,
    "birthDate": null,
    "occupation": null,
    "registerId": "4832380863313",
    "companyPrefix": "บริษัท",
    "companyName": "เทสดาต้า",
    "companySuffix": "จำกัด",
    "customerName": "นายชุม เชย",
    "emailAddress": null,
    "mobilePhone": null,
    "addresses": [
      {
        "type": "REGISTER",
        "addressLine1": "เลขที่234/15 หมู่7 ถนนสุขุมวิท",
        "addressLine2": null,
        "addressLine3": null,
        "addressLine4": null,
        "district": "1",
        "subDistrict": "25",
        "state": "56",
        "postalCode": "10280"
      },
      {
        "type": "CURRENT",
        "addressLine1": "เลขที่234/15 หมู่7 ถนนสุขุมวิท",
        "addressLine2": null,
        "addressLine3": null,
        "addressLine4": null,
        "district": "1",
        "subDistrict": "25",
        "state": "56",
        "postalCode": "10280"
      }
    ]
  },
  "payer": {
    "type": "COMPANY",
    "title": null,
    "firstName":null,
    "lastName": null,
    "gender": null,
	"identificationDocuments": null,
    "nationality": null,
    "birthDate": null,
    "occupation": null,
    "registerId": "4832380863313",
    "companyPrefix": "บริษัท",
    "companyName": "เทสดาต้า",
    "companySuffix": "จำกัด",
    "customerName": null,
    "emailAddress": null,
    "mobilePhone": null,
    "addresses": [
      {
        "type": "REGISTER",
        "addressLine1": "เลขที่234/15 หมู่7 ถนนสุขุมวิท",
        "addressLine2": null,
        "addressLine3": null,
        "addressLine4": null,
        "district": "1",
        "subDistrict": "25",
        "state": "56",
        "postalCode": "10280"
      },
      {
        "type": "CURRENT",
        "addressLine1": "เลขที่234/15 หมู่7 ถนนสุขุมวิท",
        "addressLine2": null,
        "addressLine3": null,
        "addressLine4": null,
        "district": "1",
        "subDistrict": "25",
        "state": "56",
        "postalCode": "10280"
		    }
	    ]
	},
	 "consents": [
    {
      "consentType": "SANCTION_COUNTRY",
      "hasAccepted": true,
      "acceptanceDate": "2020-03-05"
    },
    {
      "consentType": "INFORMATION",
      "hasAccepted": true,
      "acceptanceDate": "2020-03-05"
    },
    {
      "consentType": "MARKETING",
      "hasAccepted": true,
      "acceptanceDate": "2020-03-05"
    }
  ]
}

Response

{
    "contractId": "APZ-c5aScEZoYfTnsoCytA",
    "policyNumber": "20-001-M01-001690",
    "policyStartDate": "2020-05-20",
    "policyExpiryDate": "2021-05-20",
    "documentUrl": "https://example.com"
    "policyStatus": "SUCCESS"
}

Noted: The documentUrl link will be expired in 15 days from the issue date.

Data model

Data Attribute

Type

Mandatory

Format

Description

Sample data

Remark

VMI

CMI

policyStartDate

String

Yes

yyyy-mm-dd

The effective start date of policy

2019-12-25

policyExpiryDate

String

yyyy-mm-dd

The expiration date of policy

2020-12-25

If policyExpiryDate = null, system will return cover period for 1 year

proposalDate

String

yyyy-mm-dd

The proposal date of quotation

2020-11-25

If proposalDate = null, system will return premium as TODAY.

channel

String

Yes

Channel

Fixed Value

productCode

Enum

Yes

product identifier

VMI, CMI

Fixed Value

contractProcessState

Enum

Yes

This parameter allows to control the process state of policy VERIFY

ISSUE, VERIFY

Fixed Value

isDigitalPolicy

Boolean

Yes

E-Policy sending flag

true,false

Fixed Value

vehicle

make

String

Yes

State the make (manufacturer) of the vehicle, e.g., Honda, Toyota.

model

String

Yes

State the model (manufacturer) of the vehicle, e.g., Honda Civic 2.0 4 Doors

1538

usage

String

Yes

The car usage propose e.g. private or commercial use etc.

VMI Ex. 110, 120
CMI Ex. 1.10, 1.40A

garageType

Enum

Automotive garages and repair shops type

DEALER, COMPANY, UNSPECIFIED //Find Garage Type table for the details

Fixed Value

vehicleIdentificationNumber

String

Yes

The car's vehicle identification number according to the manufacturer model certificate.

E8D61F4FE8F0952C3

color

String

The Car color

code	Des (TH)	Des (EN)
1	น้ำเงิน	Blue
2	ดำ	Black
3	เขียว	Green
4	แดง	Red
5	ขาว	Whilte
6	เหลือง	Yellow
7	เทา	Grey
8	ม่วง	Violet
9	ทอง	Gold
10	ฟ้า	Light Blue
11	น้ำตาล	Brown

registrationNumber

String

The official ID number of the vehicle

กก1234
In the case of new car (don't have license plate no), please send blank value.
กรณีรถป้ายแดง กรุณาส่งเป็นค่าว่าง

If registerationType is REDPLATE, this field will be optional

registrationState

String

Yes

The official license plate province code

For CMI: If registerationCountry is not THA or registerationType is GOV or INTER, this field will be optional

registerationType

String

The type of license vehicle

GEN, REDPLATE, GOV, INTER

code	Des (TH)	Des (EN)
GEN	รถทั่วไป	General car
REDPLATE	ป้ายแดง	Red plate car
GOV	ราชการ	Government car
INTER	รถต่างประเทศ	Foreign car

registerationCountry

String

The country of the license vehicle

THA

Appendix Country table

yearOfManufacture

String

Yes

length = 4

The car manufacturer year

2019

engineNumber

String

This attribute indicates the engine number according to the manufacturer's model certificate.

52WVC10338

owner

birthDate

String

yyyy-mm-dd

The birth date of policy person

1987-01-01

address

postalCode

String

length = 5

Postal code

10400

productPackages

Yes

name

String

Package name for references

GRANU, null

Fixed Value

coverages

name

Enum

Product coverage name

VMI1, VMI2+, VMI3+, VMI3

Fixed Value

code

Enum

Yes

A code indicating the type of coverage Item

VMI1, VMI2+, VMI3+, VMI3

Fixed Value

sumInsured

Number

Sum Insured for benefit

200000

coverageItems

name

String

Coverage item name

TPBI/Persons

code

String

Coverage item code

TPBIP

sumInsured

Number

Sum Insured for benefit

1000000

premium

Yes

discounts

code

String

the Discount code

PAP10

rate

Number

The discount rate (in %)

10.5

name

String

The discount name

Promotional discount

type

String

The category of the discount

eCoupon

amount

Number

discount amount

10.5

recurring

Boolean

This indicates if the reduction recurs each year

false

additionalCosts

name

String

name of additional cost

GST

type

String

tax on product

tax

amount

Number

amount of additional cost

10.5

netPremium

Number

Net premium after discount and before taxes and any additional cost or reduction

7800

grossPremium

Number

Yes

Gross premium is after discount and after taxes and all additional costs

8580

Parameter	Type	Mandatory (VMI/CMI)		Format	Description	Sample data	Remark
Parameter	Type	PERSON	COMPANY	Format	Description	Sample data	Remark
insuredPerson
type	Enum	Yes	Yes		Person type	PERSON, COMPANY	Fixed Value
title	String	Yes	No		The policy's title code	นวอ.โท, ทพญ.	Required when type is PERSON
firstName	String	Yes	No		The policy's first name		Required when type is PERSON
lastName	String	Yes	No		The policy's last name		Required when type is PERSON
gender	Enum	Yes	No		The gender of policy person	MALE, FEMALE	Fixed Value Required when type is PERSON
identificationDocuments					unique id provided by customer
identityType	Enum	Yes	No		The ID type of Policy Holder [list will be retrieved via datalist API]	NRIC, PASS	Fixed Value Required when type is PERSON
identityNumber	String	Yes	No		The ID number of Policy Holder	A3208321X
nationality	String	Yes	No		The nationality of policy person	TH	Required when type is PERSON
birthDate	String	Yes	No	yyyy-mm-dd	The birth date of policy person
occupation	String	No	No		The occupation of policy person	99	default = 99
registerId	String	No	Yes		The company registration number		Required when type is COMPANY
companyPrefix	String	No	No		The company prefix		Required when type is COMPANY
companyName	String	No	Yes		The company name		Required when type is COMPANY
companySuffix	String	No	No		The company suffix e.g. Co., Ltd. / Part., Ltd. / Pub Co., Ltd.		Required when type is COMPANY
customerName	String	No	No		The specific customer name display in policy schedule ex. companyName (customerName)		Required when insuredPerson.type is COMPANY and actual usage is individual (110 or 210). It is required to fill in the name of the main driver of that vehicle and display on policy schedule.
emailAddress	String	No	No	xxx@xxx.xxx	The E-mail address of policy holder		Required when epolicy is true (for type = PERSON only)
mobilePhone	String	Yes	No	length = 10	The phone number of policy holder	086xxxxxxx
addresses
type	Enum	Yes	Yes		Defines the address type such as work address	REGISTER, CURRENT	Fixed Value
addressLine1	String	Yes	Yes	length = 250	Address line1	No. 9 G Tower Rama 9 10th Floor
addressLine2	String	No	No		Address line2
addressLine3	String	No	No		Address line3
addressLine4	String	No	No		Address line4
district	String	Yes	Yes		District code	8
subDistrict	String	Yes	Yes		Sub district code	95
state	String	Yes	Yes		Province code	0
postalCode	String	Yes	Yes	length = 5	Postal code	10400
beneficiary		No	No				Not required but if input, the data should be verified *If does not input data Beneficiary be set same as Insured Person
type	Enum	Yes	Yes		Person type	PERSON, COMPANY	Fixed Value
title	String	Yes	No		The policy's title code	นวอ.โท, ทพญ.
firstName	String	Yes	No		The policy's first name
lastName	String	Yes	No		The policy's last name
gender	Enum	Yes	No		The gender of policy person	MALE, FEMALE	Fixed Value Required when type is PERSON
identificationDocuments
identityType	Enum	Yes	No		The ID type of Policy Holder [list will be retrieved via datalist API]	NRIC, PASS	Fixed Value Required when type is PERSON
identityNumber	String	Yes	No		The ID number of Policy Holder	A3208321X
nationality	String	Yes	No		The nationality of policy person	TH
birthDate	String	Yes	No	yyyy-mm-dd	The birth date of policy person
occupation	String	No	No		The occupation of policy person	99	default = 99
registerId	String	No	Yes		The company registration number
companyPrefix	String	No	No		The company prefix
companyName	String	No	Yes		The company name
companySuffix	String	No	No		The company suffix e.g. Co., Ltd. / Part., Ltd. / Pub Co., Ltd.
customerName	String	No	Yes		The specific customer name display in policy schedule
emailAddress	String	No	No	xxx@xxx.xxx	The E-mail address of policy holder
mobilePhone	String	Yes	No	length = 10	The phone number of policy holder	086xxxxxxx
addresses
type	Enum	Yes	Yes		Defines the address type such as work address	REGISTER, CURRENT	Fixed Value
addressLine1	String	Yes	Yes	length = 250	Address line1	No. 9 G Tower Rama 9 10th Floor
addressLine2	String	No	No		Address line2
addressLine3	String	No	No		Address line3
addressLine4	String	No	No		Address line4
district	String	Yes	Yes		District code	8
subDistrict	String	Yes	Yes		Sub district code	95
state	String	Yes	Yes		Province code	0
postalCode	String	Yes	Yes	length = 5	Postal code	10400
payer		No	No				Not required but if input, the data should be verified *If does not input data Payer be set same as Insured Person
type	Enum	Yes	Yes		Person type	PERSON, COMPANY
title	String	Yes	No		The policy's title code	นวอ.โท, ทพญ.
firstName	String	Yes	No		The policy's first name
lastName	String	Yes	No		The policy's last name
gender	Enum	Yes	No		The gender of policy person	MALE, FEMALE	Fixed Value Required when type is PERSON
identificationDocuments
identityType	Enum	Yes	No		The ID type of Policy Holder [list will be retrieved via datalist API]	NRIC, PASS	Fixed Value Required when type is PERSON
identityNumber	String	Yes	No		The ID number of Policy Holder	A3208321X
nationality	String	Yes	No		The nationality of policy person	TH
birthDate	String	Yes	No	yyyy-mm-dd	The birth date of policy person
occupation	String	No	No		The occupation of policy person	99	default = 99
registerId	String	No	Yes		The company registration number
companyPrefix	String	No	No		The company prefix
companyName	String	No	Yes		The company name
companySuffix	String	No	No		The company suffix e.g. Co., Ltd. / Part., Ltd. / Pub Co., Ltd.
customerName	String	No	Yes		The specific customer name display in policy schedule
emailAddress	String	No	No	xxx@xxx.xxx	The E-mail address of policy holder
mobilePhone	String	Yes	No	length = 10	The phone number of policy holder	086xxxxxxx
addresses
type	Enum	Yes	Yes		Defines the address type such as work address	REGISTER, CURRENT	Fixed Value
addressLine1	String	Yes	Yes	length = 250	Address line1	No. 9 G Tower Rama 9 10th Floor
addressLine2	String	No	No		Address line2
addressLine3	String	No	No		Address line3
addressLine4	String	No	No		Address line4
district	String	Yes	Yes		District code	8
subDistrict	String	Yes	Yes		Sub district code	95
state	String	Yes	Yes		Province code	0
postalCode	String	Yes	Yes	length = 5	Postal code	10400
consents
consentGroup	String	No	No		The category of consent	Marketing or servicing, Accepting T&C, Promotional info
consentType	Enum	Yes	Yes		The type of consent	SANCTION_COUNTRY, INFORMATION, MARKETING
hasAccepted	Boolean	Yes	Yes		Indicates if the customer has accepted the consent	true
acceptanceDate	String	No	No	yyyy-mm-dd	The date and time of accepting the consent	2019-07-01

Package Issuing

For the brokers who issue policy by using package ID

Issue package support only VMI product
Issue policy by using package ID then no need to send the coverage data
Package ID will be placed on productPackages.name and should NOT be “GRANU” or “null”

"productPackages": [
        {
            "name": "package_ID",
            "coverages": [
                {
                    "name": "VMI1",
                    "code": "VMI1"
                }
            ],
            "premium": {
                "grossPremium": 26611.97
      }
    }
  ],

API request/Response

Request

{
    "policyStartDate": "2020-05-20",
    "policyExpiryDate": "2021-05-20",
    "proposalDate": null,
    "channel": "WS",
    "productCode": "VMI",
    "contractProcessState": "ISSUE",
	"isDigitalPolicy": false,
        "vehicle": {
        "make": "39",
		"model": "1597",
		"usage": "110",,
        "garageType": "COMPANY",
        "vehicleIdentificationNumber": "7TYSA7215687745",
        "registrationNumber": "พบ7938",
        "registrationState": "0",
        "yearOfManufacture": "2020",
        "engineNumber": "57YRF10337",
        "owner": null
    },
    "productPackages": [
        {
            "name": "0Y010556",
            "coverages": [
                {
                    "name": "VMI1",
                    "code": "VMI1"
                }
            ],
            "premium": {
                "grossPremium": 26611.97
      }
    }
  ],
  	"insuredPerson": {
		"type": "PERSON",
		"title": "ร.ต.อ.",
		"firstName": "พอเพียง",
		"lastName": "ไชโย",
		"gender": "MALE",
		"identificationDocuments": [
			{
				"identityType": "NRIC",
				"identityNumber": "1833445523445"
			}
		],
		"nationality": "TH",
		"birthDate": "1988-12-25",
		"occupation": "99",
		"registerId": null,
		"companyPrefix": null,
		"companyName": null,
		"companySuffix": null,
		"customerName": null,
		"emailAddress": "string@string.com",
		"mobilePhone": "0861234567",
		"addresses": [
	    	{
		      "type": "REGISTER",
		      "addressLine1": "No. 9 G Tower Rama 9, 10th Floor",
		      "addressLine2": null,
		      "addressLine3": null,
		      "addressLine4": null,
		      "district": "1",
		      "subDistrict": "3210",
		      "state": "24",
		      "postalCode": "96000"
		    },
		    {
		      "type": "CURRENT",
		      "addressLine1": "No. 9 G Tower Rama 9, 10th Floor",
		      "addressLine2": null,
		      "addressLine3": null,
		      "addressLine4": null,
		      "district": "1",
		      "subDistrict": "3210",
		      "state": "24",
		      "postalCode": "96000"
		    }
	    ]
	},
	"payer": {
		"type": "PERSON",
		"title": "ร.ต.อ.",
		"firstName": "พอเพียง",
		"lastName": "ไชโย",
		"gender": "MALE",
		"identificationDocuments": [
			{
				"identityType": "NRIC",
				"identityNumber": "1833445523445"
			}
		],
		"nationality": "TH",
		"birthDate": "1988-12-25",
		"occupation": "99",
		"registerId": null,
		"companyPrefix": null,
		"companyName": null,
		"companySuffix": null,
		"customerName": null,
		"emailAddress": "string@string.com",
		"mobilePhone": "0861234567",
		"addresses": [
	    	{
		      "type": "REGISTER",
		      "addressLine1": "No. 9 G Tower Rama 9, 10th Floor",
		      "addressLine2": null,
		      "addressLine3": null,
		      "addressLine4": null,
		      "district": "1",
		      "subDistrict": "3210",
		      "state": "24",
		      "postalCode": "96000"
		    },
		    {
		      "type": "CURRENT",
		      "addressLine1": "No. 9 G Tower Rama 9, 10th Floor",
		      "addressLine2": null,
		      "addressLine3": null,
		      "addressLine4": null,
		      "district": "1",
		      "subDistrict": "3210",
		      "state": "24",
		      "postalCode": "96000"
		    }
	    ]
	},
	 "consents": [
    {
      "consentType": "SANCTION_COUNTRY",
      "hasAccepted": true,
      "acceptanceDate": "2020-03-05"
    },
    {
      "consentType": "INFORMATION",
      "hasAccepted": true,
      "acceptanceDate": "2020-03-05"
    },
    {
      "consentType": "MARKETING",
      "hasAccepted": true,
      "acceptanceDate": "2020-03-05"
    }
  ]
}

Response

{
  "contractId": "YyjFWFLNZYPNaky-ZYGZCC",
  "policyNumber": "20-001-M01-006834",
  "policyStartDate": "2020-05-20",
  "policyExpiryDate": "2021-05-20",
  "documentUrl": "https://example.com"
  "policyStatus": "SUCCESS"
}

Noted: The documentUrl link will be expired in 15 days from the issue date.

Validate mandatory fields conditions:

If registrationCountry is	If registrationType is	registrationState will be	registrationNumber will be	Remark
THA	GEN	Mandatory	Mandatory
THA	REDPLATE	Mandatory	Optional
THA	GOV	Optional	Mandatory
Other countries	INTER	Optional	Mandatory
Null	Null	Mandatory	Optional	Existing validation
Null	GEN	Mandatory	Mandatory
Null	REDPLATE	Mandatory	Optional
NULL	GOV	Optional	Mandatory
THA	Null	Mandatory	Optional
Other countries	Null	Optional	Mandatory

3. Get policy information

Purpose of the API

To check status of policy.
To check the car inspection result.
Sample Status: PROCESS_CAR_INSPECTION, SUCCESS, REJECTED, CANCELLED

How it works

Broker request to get status updated for policy issuing.

Web service URL

UAT environment : https://asia-uat-th-pc.apis.allianz.com/v1/motor/contracts/{contractId}
Pre-Production environment : https://asia-pre-th-pc.apis.allianz.com/v1/motor/contracts/{contractId}

API request/Response

Request

Method	URI	Description
GET	/contracts/{contractId}	Get policy information

{contractId} = input contract id

Example Request

GET /contracts/{189a3f6b-e1d2-4aaa-b157-14a0c7f7b014}

Response

{
  "contractId": "189a3f6b-e1d2-4aaa-b157-14a0c7f7b014",
  "policyNumber": "19-001-M02-069005",
  "policyStartDate": "2019-12-25",
  "policyExpiryDate": "2020-12-25",
  "documentUrl": "https://example.com",
  "policyStatus": "SUCCESS"
}

Noted: The documentUrl link will be expired in 15 days from the issue date.

4. Cancel Policy

Purpose of the API

To cancel policy under business condition.

How it works

Broker request to cancel policy within one day of policy issued only. Once API was called system will update policy status to database. Policy number will be marked as invalid (endorsement).

Web service URL

UAT environment : https://asia-uat-th-pc.apis.allianz.com/v1/motor/contracts/{contractId}/amendments
Pre-Production environment : https://asia-pre-th-pc.apis.allianz.com/v1/motor/contracts/{contractId}/amendments

API request/Response

Request

Method	URI	Description
POST	/contracts/{contractId}/amendments	Policy Cancellation with in day

{contractId} = input contract id

Example Request

POST /contracts/{189a3f6b-e1d2-4aaa-b157-14a0c7f7b014}/amendments

{
  "type": "CANCEL",
  "reason": "User had cancelled the policy"
}

Response

{
  "type": "CANCEL",
  "reason": "User had cancelled the policy",
  "effectiveDate": "2019-12-25",
  "policyNumber": "19-001-M02-069005-2",
  "status": "SUCCESS"
}

Data model

Data Attribute	Type	Mandatory	Format	Description	Sample data
type	Enum	Yes	CANCEL (Fixed Value)	This attribute provides a classification of amendments, based on the operation the customer requested. E.g. contract substitution, suspension, cancellation.	CANCEL
reason	String	Yes	length = 50	This field provides a reason for an amendment (free text)	User had cancelled the policy

6. FAQ

คำถามที่พบบ่อย

Q:    ทำการทดสอบแล้วพบ error 999
    {"code":"999","message":"เกิดข้อผิดพลาดในระบบ"}
A:    ลองตรวจสอบว่า request ที่ส่งมา format ถูกต้องหรือไม่
        เช่น owner เมื่อไม่ต้องการส่งค่า ให้ส่งเป็น null (owner: null) แทนการส่งเป็น empty string (owner: "")

Q:    หากต้องการเบี้ยทั้งซ่อมศูนย์ และซ่อมอู่
A:    จำเป็นต้องส่ง request มา 2 ครั้ง แยกตาม garage type
        ดูตาราง Garage Type ที่นี่

Q: ทำการทดสอบแล้วพบ error

    {"code":"113","message":"อีเมล์นี้มีผู้อื่นใช้แล้ว กรุณาลองใช้อีเมล์อื่น"}

    {"code":"114","message":"หมายเลขโทรศัพท์นี้มีผู้อื่นใช้แล้ว กรุณาลองใช้หมายเลขโทรศัพท์อื่น"}

A: error นี้เกิดขึ้นเพราะ ระบบไม่อนุญาตให้ใช้ email และ เบอร์โทรศัพท์ที่เป็นของ agent
(ระบบจะตรวจสอบเฉพาะกรณีที่ส่งกรมธรรม์เป็น e-policy)

Q: ทำการทดสอบแล้วพบ error

    {"code":"003","message":"coverageItems ข้อมูลที่ส่งมาไม่ถูกต้อง"}

A: สามารถตรวจสอบข้อมูล coverage items ของแต่ละ product type ตามตาราง
Coverage Items: mandatory fields

Q: ทำการทดสอบแล้วพบ error

    {"code":"112","message":"ข้อมูลลูกค้า (ชื่อนามสกุล ชื่อบริษัท) ไม่ตรงกับฐานข้อมูล กรุณาติดต่อเจ้าหน้าที่"}

A:    ในกรณีที่เป็นลูกค้าประเภทบุคคล
        identityNumber, firstName และ lastName ที่ส่งมา ต้องตรงกับที่มีในฐานข้อมูล
        กรุณาติดต่อ Sales ผู้ดูแล เพื่อทำการแก้ไขข้อมูลลูกค้า
        ในกรณีที่เป็นลูกค้าประเภทนิติบุคคล
        registerId และ companyName ที่ส่งมา ต้องตรงกับที่มีในฐานข้อมูล
        กรุณาติดต่อ Sales ผู้ดูแล เพื่อทำการแก้ไขข้อมูลลูกค้า

Q:    customerName คืออะไร แล้วแตกต่างกับ firstName และ lastName อย่างไร
A:    1. firstName และ lastName คือชื่อและนามสกุลของผู้เอาประกันภัยประเภทบุคคล
        (insuredPerson.type = "PERSON")
        และไม่มีความจำเป็นจะต้องใส่ข้อมูล customerName ("customerName": null)

        2. customerName คือ ชื่อผู้ใช้รถ จำเป็นต้องส่งข้อมูลในกรณีที่
        ผู้เอาประกันภัยเป็น นิติบุคคล (insuredPerson.type = "COMPANY")และ
        รหัสรถภาคสมัครใจ คือ 110 รถยนต์นั่งส่วนบุคคล (usage": "110")

        โดยข้อมูลตรงส่วนนี้จะไปแสดงในรายละเอียดของกรมธรรม์

    กรุณาดูตัวอย่างการส่งค่า insuredPerson ประเภทบุคคล ("PERSON") และ นิติบุคคล ("COMPANY") ได้ที่
        Insured Person is PERSON
        Insured Person is COMPANY

Q: หลังจากออกกรมธรรม์ได้สำเร็จแล้ว documentUrl มีอายุนานเท่าไหร่
A: 15 วัน นับจากวันที่ URL ถูก generate

Q: เมื่อพบข้อผิดพลาดบางอย่าง
A: ลองตรวจสอบข้อมูลเบื้องต้นตามรายละเอียดดังต่อไปนี้

error "ลูกค้านิติบุคคล ไม่สามารถออกกรมธรรม์ E-Policy ได้" ต้องไปแก้ข้อมูลให้เป็น false ("isDigitalPolicy": false)
นิติบุคคลไม่จำเป็นต้องระบุ gender, firstName, lastName สามารถใส่เป็น null ได้
Address ต้องระบุทั้ง CURRENT และ REGISTER
Consent ต้องถูกส่งมาทั้ง 3 ค่า (INFORMATION, SANCTION_COUNTRY และ MARKETING)
ดูข้อมูลเพิ่มเติมได้ที่ Consent Details

Q: ถ้าเป็นรถใหม่ป้ายแดง ต้องใส่ข้อมูลอย่างไรบ้าง
A: ข้อมูลป้ายทะเบียน (registrationNumber) สำหรับรถป้ายแดงควรส่งเป็นค่าว่าง (blank)

Q:    การออกกรมธรรม์ภาคบังคับ แบบไม่ระบุรุ่นรถ หน้าตารางกรมธรรม์จะแสดงข้อมูลอย่างไร
A:    ตารางกรมธรรม์ จะไม่แสดง รุ่นรถ, แบบตัวถัง และ ขนาดเครื่องยนต์
        ใบเสร็จ จะไม่แสดง รุ่นรถ

Q: สามารถทำการทดสอบที่ UAT environment ได้เวลาใดบ้าง
A: ระบบจะเปิดให้ทดสอบ ทุกวันวันจันทร์ – ศุกร์ เวลา 8:00– 20:00 น.

**เพิ่มเติม**

สำหรับผู้ไม่เคยมีประสบการณ์ในการเรียก Rest API สามารถศึกษาข้อมูลเบื้องต้นได้ที่
มาทำความรู้จักกับ REST API กันดีกว่า

Support Time	09:00 a.m. – 18:00 p.m. (Mon-Sun)
Support Channel	Phone number: 02-305-7321 Email: ITServicedesk@azay.co.th Line official: @aagiapisupport For all channel, IT Support Team will send acknowledge back within 30 mins.

Introduction

AAGI – Motor Web Service

1. Quick Quotes API

Purpose of the API

How it works

Web service URL

(1) Get premiums by using default coverage value

1.1 All default coverage

API request/Response

1.2 The default coverage with specific sumInsured

API request/Response

(2) Get premiums by using specific coverage value

Coverage Items: mandatory fields

API request/Response

Data model

Garage Type

Validate mandatory fields conditions:

2. Issue Policy (Contracts)

Purpose of the API

How it works

Web service URL

(1) Insured Person is PERSON

API request/Response

(2) Insured Person is COMPANY

API request/Response

Data model

Consent Details

Package Issuing

For the brokers who issue policy by using package ID

API request/Response

Validate mandatory fields conditions:

3. Get policy information

Purpose of the API

How it works

Web service URL

API request/Response

4. Cancel Policy

Purpose of the API

How it works

Web service URL

API request/Response

Data model

5. Appendix

6. FAQ

7. Contact Point

If you have any inquiry, please don't hesitate to contact us