---
# System prepended metadata

title: CheckContinueForPD
tags: [Documentation, agentportal]

---

---
title: 'CheckContinueForPD'
disqus: hackmd
---
Version | Handler | Desc | Date 
---- | --- | --- | --- 
1.0.0 | Jum | Create | 2025-05-19

Description:
Call API check continue

CheckContinueForPD
===

## Specification
1. Endpoint Name: **CheckContinueForPD**
2. Environment URLs

| Environment | URL | 
| -------- | -------- |
| Test API URL | https://api-sit.cathay-ins.com.vn:9527/guarantee/api/Comprehensive/CheckContinueForPD |
| Test Gateway | https://api-sit.cathay-ins.com.vn:9527/guarantee/api/Comprehensive/CheckContinueForPD |
| Core | cxinsvn/servlet/HttpDispatcher/ATWA_1000/checkContinueForAccident |

### Header Specification
1. Frontend call to API Gateway – Header parameters

| Item | Description |
| ---- | ----------- |
| Method | POST |
| Required Request Header | Content-Type: application/json; charset=UTF-8 |
| Required Request Header | x-api-version=1 |
| Bearer Token | Call login API to receive "access_token". This token is in Bearer Token format. For details, please refer to the [login API](/lfbsyk40QCuaISPSf0x30g) |

2. Middleware call to Core – Header parameters

| Parameter Name | Core Parameter | Type | Required | Description |
| -------------- | -------------- | ---- | -------- | ----------- |
| loginId | CLIENT_TARGET | String | Y | Login account, pass the loginId from frontend |
| token | TOKEN | String | Y | TOKEN string received from login |
| language | LG_CODE | String | Y | Language code, Vietnamese: vi-VN, English: en-US, Chinese: zh-TW. If not provided, Vietnamese will be returned by default |

## Request Fields

| Field Name | Core Parameter | Data Type | Required | Description |
| ---------- | -------------- | --------- | -------- | ----------- |
| typePol | TYPE_POL | String | Y | Submission channel (M) |
| polRenewNo | POL_RENEW_NO | String | Y | Renewal policy number |
| prodPolCode | PROD_POL_CODE | String | Y | Product subcategory |
| polDt | POL_DT | String | Y | Old policy start date (YYYY-MM-DD HH:MM:SS) |
| polDueDt | POL_DUE_DT | String | Y | Old policy end date (YYYY-MM-DD HH:MM:SS) |

### Request 範例

1. 前端Request API Gateway 範例
```json=
{
 "language":"zh-TW",
 "loginId": "0100468880",
 "token": "NlXEt66fejIrQvIGampcPnLVdmIYVo0wdZf8T5H5xkM5lpVpvuhDn9qSaAQDSkbkOdUjxvXufQpyH0WZWvQThw==",
 "typePol":"M",
 "polRenewNo":"CI20P4001726",
 "prodPolCode":"AC01007",
 "polDt":"2020-11-22 12:00:00.0",
 "polDueDt":"2021-11-22 12:00:00.0" 
}
```
2. 中台呼叫核心API範例
```json=
{
 "TYPE_POL":"M",
 "POL_RENEW_NO":"CI20P4001726",
 "PROD_POL_CODE":"AC01007",
 "POL_DT":"2020-11-22 12:00:00.0",
 "POL_DUE_DT":"2021-11-22 12:00:00.0"  
}
```
## Response

1. If the core returns RETURN_CODE=0000, retrieve the CUSTOMER_LIST jsonList.
2. If the core returns RETURN_CODE=9999, write the value of RETURN_MSG directly to the message field.

### Relationship Code Mapping

| INSR_RELATION Code | Relationship Display | Notes |
| -------- | -------- | -------- | 
| 1 | Tôi | Code 1, self |
| 2 | vợ chồng | Code 2, spouse |
| 3 | con cái | Code 3, children |
| 4 | cha mẹ | Code 4, parents |
| 6 | anh chị em ruột | Grab INSR_RELATION_MEMO, siblings |
| 6 | người nuôi dưỡng | Grab INSR_RELATION_MEMO, caregiver |

### Response Fields

| Field Name | Data Type | Length | Description |
| ---------- | --------- | ------ | ----------- |
| status | Integer | 3 | Success:200 / Cathay Core Error:999 / System Error:500 / Timeout:504 |
| success | Boolean | - | true/false |
| message | String | - | "Success/Error messages" |
| total | Integer | - | Total number of records in the list |
| data | Object | - | Data list (returns null if no data) |

### Data Fields

| Field Name | Core Field | Data Type | Required | Description |
| ---------- | ---------- | --------- | -------- | ----------- |
| polDt | POL_DT | String | Y | Old policy start date (YYYY-MM-DD HH:MM:SS) |
| polDueDt | POL_DUE_DT | String | Y | Old policy end date (YYYY-MM-DD HH:MM:SS) |
| apcInsrName | APC_INSR_NAME | String | Y | Policyholder name |
| apcInsrCertType | APC_INSR_CERT_TYPE | String | Y | Policyholder certificate type (1: National ID, 2: Birth Certificate, 3: Passport, 4: Military ID, 5: Other, 6: Tax Identification Number) |
| apcInsrCertNumber | APC_INSR_CERT_NUMBER | String | Y | Policyholder certificate number (Id,Birth Certificate: Must be exactly 12 digits, Passport between 7 and 10) |
| apcSex | APC_SEX | String | Y | Policyholder gender, 1: Male, 2: Female |
| apcNationalId | APC_NATIONAL_ID | String | Y | Policyholder nationality |
| apcInsrBirthday | APC_INSR_BIRTHDAY | String | Y | Policyholder birthday (YYYY-MM-DD) |
| apcAddr | APC_ADD_PART8 | String | Y | Policyholder address |
| apcMobilePhone | APC_MOBILE_PHONE | String | Y | Mobile phone number |
| apcEmail | APC_E_MAIL | String | Y | Email |
| **customerList** | CUSTOMER_LIST | List | Y | Policyholder/insured person list |

#### customerList Details

| Field Name | Core Field | Data Type | Required | Description |
| ---------- | ---------- | --------- | -------- | ----------- |
| serNo | SER_NO | String | Y | List serial number |
| insrName | INSR_NAME | String | Y | Policyholder/insured name |
| insrCertType | INSR_CERT_TYPE | String | Y | Certificate type (1: National ID, 2: Birth Certificate, 3: Passport, 4: Military ID, 5: Other, 6: Tax Identification Number) |
| insrCertNumber | INSR_CERT_NUMBER | String | Y | Certificate number (Id,Birth Certificate: Must be exactly 12 digits, Passport between 7 and 10) |
| insrBirthday | INSR_BIRTHDAY | String | Y | Birthday (YYYY-MM-DD) |
| sex | SEX | String | Y | Gender (1: Male, 2: Female) |
| jobCat | JOB_CAT | String | Y | Job category code (may be empty for old cases) |
| riskClass | RISK_CLASS | String | Y | Risk class (may be empty for old cases) |
| **workCont** | work_cont | String | Y | Manually entered occupation description |
| insrProj | INSR_PROJ | String | Y | Project type (H1) |
| insrRelation | INSR_RELATION | String | Y | Relationship code with policyholder (1: Self, 2: Spouse, 3: Child, 4: Parent, 6: Other) (may be empty for old cases) |
| insrRelationMemo | INSR_RELATION_MEMO | String | Y | For code 6 other, relationship to policyholder (siblings, caregiver) (may be empty for old cases) |
| (New field) amt | AMT | String | Y | Insured amount |

### Response 範例
1. 符合續約資格
```json=
{
  "polDt": "2020-11-22 12:00:00.0",
  "apcAddPart8": "27 diệp minh châu, đà nẵng",
  "returnCode": "0000",
  "apcInsrCertType": "1",
  "apcNationalId": "vietn",
  "apcInsrCertNumber": "201864143",
  "apcInsrName": "nguyễn quốc tuấn",
  "apcInsrBirthday": "1988-12-10",
  "apcSex": "1",
  "polDueDt": "2021-11-22 12:00:00.0",
  "customerList": [
    {
      "serNo": "1",
      "insrCertNumber": "201864143",
      "insrName": "nguyễn quốc tuấn",
      "sex": "1",
      "insrProj": "h3",
      "insrCertType": "1",
      "insrRelationMemo": "",
      "insrRelation": "",
      "amt": "30000000.00",
      "jobCat": "",
      "riskClass": "",
      "workCont": "自由工作者"
    },
    {
      "serNo": "2",
      "insrCertNumber": "201854268",
      "insrName": "nguyễn thị thái",
      "sex": "1",
      "insrProj": "h3",
      "insrCertType": "1",
      "insrRelationMemo": "",
      "insrRelation": "",
      "amt": "30000000.00",
      "jobCat": "010101",
      "riskClass": "1",
      "workCont": ""
    },
    {
      "serNo": "3",
      "insrCertNumber": "182/2014",
      "insrName": "nguyễn quốc bảo nam",
      "sex": "1",
      "insrProj": "h1",
      "insrCertType": "2",
      "insrRelationMemo": "",
      "insrRelation": "",
      "amt": "30000000.00",
      "jobCat": "020102",
      "riskClass": "2",
      "workCont": ""
    }
  ]
}
```
2. 不符合續約資格/任何執行有問題(RETURN_CODE=9999)，直接把RETURN_MSG綁到message，
```json=
{
    "status": 999,
    "message": "國泰核心錯誤",
    "success": false,
    "total": 0,
    "data": "不符合續保資格"
}
```
###### tags: `agentportal` `Documentation`
