Save Branch Insurance
This API function creates or updates branch insurance information on the server.
It includes insurance code, name, and premium rate.
Endpoint
POST /saveBhfInsurance
Request Object: BhfInsuranceSaveReq
Request Fields
| Field | Description | Type | Required | Length |
|---|---|---|---|---|
isrccCd | Insurance Code | CHAR | ✅ Yes | 10 |
isrccNm | Insurance Name | CHAR | ✅ Yes | 100 |
isrcRt | Premium Rate (%) | NUMBER | ✅ Yes | 3 |
useYn | Active Status (Y/N) | CHAR | ✅ Yes | 1 |
regrId | Registration ID | CHAR | ✅ Yes | 20 |
regrNm | Registration Name | CHAR | ✅ Yes | 60 |
modrId | Modifier ID | CHAR | ✅ Yes | 20 |
modrNm | Modifier Name | CHAR | ✅ Yes | 60 |
JSON Request Example
{
"isrccCd": "ISRCC01",
"isrccNm": "ISRCC NAME",
"isrcRt": 20,
"useYn": "Y",
"regrId": "Test",
"regrNm": "Test",
"modrId": "Test",
"modrNm": "Test"
}
Response Object: BhfInsuranceSaveRes
Response Fields
| Field | Description | Type | Length |
|---|---|---|---|
resultCd | Result Code (000 = success) | CHAR(3) | 3 |
resultMsg | Result Message | CHAR | - |
resultDt | Response Timestamp | CHAR(14) | 14 |
data | Always null | - | - |
JSON Response Example
{
"resultCd": "000",
"resultMsg": "It is succeeded",
"resultDt": "20200226192852",
"data": null
}
SDK Usage Examples
- Python
- JavaScript / TypeScript
- PHP
insurance_data = {
'isrccCd': 'ISRCC01',
'isrccNm': 'ISRCC NAME',
'isrcRt': 20,
'useYn': 'Y',
'regrId': 'Test',
'regrNm': 'Test',
'modrId': 'Test',
'modrNm': 'Test',
}
response = etims.save_branch_insurance(insurance_data)
if response.get('resultCd') == '000':
print("✅ Branch insurance saved successfully")
else:
abort(f"Failed to save branch insurance: {response.get('resultMsg', 'Unknown error')}")
const response = await client.saveBranchInsurance({
isrccCd: `INS12345`,
isrccNm: `Test Insurance ${Date.now()}`,
isrcRt: 20,
useYn: 'Y',
regrId: 'Test',
regrNm: 'Test',
modrId: 'Test',
modrNm: 'Test',
});
console.log(`✅ Branch insurance saved: ${response.resultMsg}`);
$requestData = [
'isrccCd' => 'ISRCC01',
'isrccNm' => 'ISRCC NAME',
'isrcRt' => 20,
'useYn' => 'Y',
'regrId' => 'Test',
'regrNm' => 'Test',
'modrId' => 'Test',
'modrNm' => 'Test',
];
$response = $etims->saveBranchInsurance($requestData);
if (($response['resultCd'] ?? '') === '000') {
echo "✅ Branch insurance saved successfully\n";
} else {
abort("Failed to save branch insurance: " . ($response['resultMsg'] ?? 'Unknown error'));
}
Best Practices
- Ensure
isrccCdis unique for each insurance company. useYnmust reflect whether the insurance is active.- Track
regrIdandmodrIdfor auditing. - Premium rate
isrcRtis an integer representing percentage.