Guarantees Amendments APIs

Name Description Introduced In
createGuaranteeAmendment This API creates Guarantees Amendments. 2022.07
getImportLetterOfCreditAmendments This API retrieves the list of Import LC Amendments. 2022.07
getGuaranteeAmendmentById This API retrieves the Guarantee Amendments by ID. 2022.07
updateGuaranteeAmendment This API updates the Guarantee Amendments. 2022.07
ClosedcreateGuaranteeAmendment
 
Description: This API creates Guarantees Amendments.
Method: POST
URL: {base_url}/services/data/v1/TradeFinance/operations/Guarantees/createGuaranteeAmendment
Security Level: Authenticated App User
Header Request: X-Kony-Authorization
Body Request: 
{
    "benificiaryName": "test",
    "guaranteesReference": "123",
    "currency": "USD",
    "amount": "123",
    "expiryDate": "2022-03-24",
    "productType": "test",
    "issueDate": "2022-03-24",
    "instructingParty": "partytest",
    "billType": "billtest",
    "expiryType": "testExp",
    "applicantParty": "partytest",
    "amendmentNo": "02",
    "amendmentEffectiveDate": "2022-03-24",
    "amendAmount": "123",
    "amendCurrency": "USD",
    "amendExpiryType": "test",
    "amendExpiryDate": "2022-03-24",
    "amendExpiryCondition": "test",
    "amendDetails": "test",
    "messageToBank": "test",
    "amendStatus": "test",
    "cancellationStatus": "test",
    "corporateUserName": "test",
    "supportingDocument": "test",
    "guaranteesSRMSId": "GUA221514XEW3"
}
Response: 
{
    "benificiaryName": "test",
    "guaranteesReference": "123",
    "currency": "USD",
    "amount": "123",
    "expiryDate": "2022-03-24",
    "productType": "test",
    "issueDate": "2022-03-24",
    "instructingParty": "partytest",
    "billType": "billtest",
    "expiryType": "testExp",
    "applicantParty": "partytest",
    "amendmentNo": "02",
    "amendmentEffectiveDate": "2022-03-24",
    "amendAmount": "123",
    "amendCurrency": "USD",
    "amendExpiryType": "test",
    "amendExpiryDate": "2022-03-24",
    "amendExpiryCondition": "test",
    "amendDetails": "test",
    "messageToBank": "test",
    "amendStatus": "test",
    "amendRequestedDate": "2022-06-06 12:47:28.045",
    "amendmentReference": "GUAM2215709FFV",
    "amendmentSRMSRequestId": "GUAM2215709FFV",
    "cancellationStatus": "test",
    "corporateUserName": "test",
    "supportingDocument": "test",
    "guaranteesSRMSId": "GUA221514XEW3",
    "opstatus": 0,
    "httpStatusCode": 0
}
Error Code(s):
  • Error Code: 29045
    Error Message: "Unable to create letter of credits request"
  • Error Code: 26014
    Error Message: "Failed to fetch Customer ID"
  • Error Code: 10117
    Error Message: "Logged in User is not authorized to perform this action"
  • Error Code: 10118
    Error Message: "Input Validation Failed"
  • Error Code: 29070
    Error Message: "SECURITY EXCEPTION - UNAUTHORIZED ACCESS"
  • Error Code: 29048
    Error Message: "Failed to Update letter of credits"
  • Error Code: 29052
    Error Message: "Unable to create order. Failed to find service request id in Response"
  • Error Code: 29065
    Error Message: "Error while Get LOC Call by ID"
  • Error Code: 12007
    Error Message: "Logged in User is not authorized to perform this action"
Enterprise Provider: Service Request Microservice
Enterprise API:

{base_url}/v2.0.0/orders/serviceRequest/$serviceRequestIds

Field Mapping

UI Field Experience API Field MS API Field Transact API Field
Benificiary Name benificiaryName NA NA
GuaranteesCReference guaranteesReference NA NA
Currency currency NA NA
Amount amount NA NA
Expiry Date expiryDate NA NA
Product Type productType NA NA
Issue Date issueDate NA NA
Instructing Party instructingParty NA NA
Bill Type billType NA NA
Expiry Type expiryType NA NA
Applicant Party applicantParty NA NA
Amendment No amendmentNo NA NA
Amendment Effective Date amendmentEffectiveDate NA NA
Amend Amount amendAmount NA NA
Amend Currency amendCurrency NA NA
Amend Expiry Type amendExpiryType NA NA
Amend Expiry Condition amendExpiryCondition NA NA
Amend Details amendDetails NA NA
Message To Bank messageToBank NA NA
Amend Status amendStatus NA NA
Amend Requested Date amendRequestedDate NA NA
Amendment Reference amendmentReference NA NA
Amendment SRMS RequestId amendmentSRMSRequestId NA NA
Cancellation Status cancellationStatus NA NA
Corporate UserName corporateUserName NA NA
Supporting Document supportingDocument NA NA
ClosedgetImportLetterOfCreditAmendments
 
Description: This API retrieves the list of Import LC Amendments.
Method: POST
URL: {base_url}/services/data/v1/TradeFinance/operations/LetterOfCredit/getImportLetterOfCreditAmendments
Security Level: Authenticated App User
Header Request: X-Kony-Authorization
Body Request: 
{
    "searchString": "",
    "pageSize": "",
    "pageOffset": "",
    "sortByParam": "",
    "sortOrder": "",
    "timeParam": "",
    "timeValue": "",
    "filterByValue": "",
    "filterByParam": "",
    "fromDateFilter": "",
    "toDateFilter": ""
}
Response: 
{

    "GuaranteeLCAmendments": [

        {

            "benificiaryName": "test",
            "guaranteesReference": "123",
            "currency": "USD",
            "amount": "123",
            "expiryDate": "2022-03-24",
            "productType": "test",
            "issueDate": "2022-03-24",
            "instructingParty": "partytest",
            "billType": "billtest",
            "expiryType": "testExp",
            "applicantParty": "partytest",
            "amendmentNo": "02",
            "amendmentEffectiveDate": "2022-03-24",
            "amendAmount": "123",
            "amendCurrency": "USD",
            "amendExpiryType": "test",
            "amendExpiryDate": "2022-03-24",
            "amendExpiryCondition": "test",
            "amendDetails": "test",
            "messageToBank": "test",
            "amendStatus": "test",
            "amendmentReference": "GUAM22157LQY15",
            "amendmentSRMSRequestId": "GUAM22157LQY15",
            "cancellationStatus": "test",
            "corporateUserName": "test",
            "supportingDocument": "test",
            "guaranteesSRMSId": "GUA221514XEW3"
        }
    ],

    "opstatus": 0,
    "httpStatusCode": 0
}
Error Code(s):
  • Error Code: 29046
    Error Message: "Unable to Fetch letter of credits requests"
  • Error Code: 29054
    Error Message: "No letter of credits available between entered range"
  • Error Code: 29053
    Error Message: "Failed to fetch letter of credits"
  • Error Code: 12007
    Error Message: "Logged in User is not authorized to perform this action"
Enterprise Provider: Service Request Microservice
Enterprise API:

{base_url}/v2.0.0/orders/serviceRequest/$serviceRequestIds

Field Mapping

UI Field Experience API Field MS API Field Transact API Field
NA searchString NA NA
NA pageSize NA NA
NA pageOffset NA NA
NA sortByParam NA NA
NA sortOrder NA NA
NA timeParam NA NA
NA timeValue NA NA
NA filterByValue NA NA
ClosedgetGuaranteeAmendmentById
 
Description: This API retrieves the Guarantee Amendments by ID.
Method: POST
URL: {base_url}/services/data/v1/TradeFinance/operations/Guarantees/getGuaranteeAmendmentById
Security Level: Authenticated App User
Header Request: X-Kony-Authorization
Body Request: 
{
    "amendmentSRMSRequestId": "GUAM221572RWDM"
}
Response: 
{

    "benificiaryName": "test",
    "guaranteesReference": "123",
    "currency": "USD",
    "amount": "123",
    "expiryDate": "2022-03-24",
    "productType": "test",
    "issueDate": "2022-03-24",
    "instructingParty": "partytest",
    "billType": "billtest",
    "expiryType": "testExp",
    "applicantParty": "partytest",
    "amendmentNo": "02",
    "amendmentEffectiveDate": "2022-03-24",
    "amendAmount": "123",
    "amendCurrency": "USD",
    "amendExpiryType": "test",
    "amendExpiryDate": "2022-03-24",
    "amendExpiryCondition": "test",
    "amendDetails": "test",
    "messageToBank": "test",
    "amendStatus": "test",
    "cancellationStatus": "test",
    "corporateUserName": "test",
    "supportingDocument": "test",
    "guaranteesSRMSId": "GUAM221572RWDM",
    "opstatus": 0,
    "httpStatusCode": 0

}
Error Code(s):
  • Error Code: 29046
    Error Message: "Unable to Fetch letter of credits requests"
  • Error Code: 29049
    Error Message: "Mandatory fields are missing"
  • Error Code: 29057
    Error Message: "Record for the specified SRMSID not found"
  • Error Code: 29053
    Error Message: "Failed to fetch letter of credits"
  • Error Code: 12007
    Error Message: "Logged in User is not authorized to perform this action"
Enterprise Provider: Service Request Microservice
Enterprise API:

{base_url}/v2.0.0/orders/serviceRequest/$serviceRequestIds

Field Mapping

UI Field Experience API Field MS API Field Transact API Field
Amendment Reference amendmentReference NA NA
ClosedupdateGuaranteeAmendment
 
Description: This API updates the Guarantee Amendments.
Method: POST
URL: {base_url}/services/data/v1/TradeFinance/operations/Guarantees/updateGuaranteeAmendment
Security Level: Authenticated App User
Header Request: X-Kony-Authorization
Body Request: 
{
    "benificiaryName": "test",
    "guaranteesReference": "123",
    "currency": "USD",
    "amount": "123",
    "expiryDate": "2022-03-24",
    "productType": "test",
    "issueDate": "2022-03-24",
    "instructingParty": "partytest",
    "billType": "billtest",
    "expiryType": "testExp",
    "applicantParty": "partytest",
    "amendmentNo": "02",
    "amendmentEffectiveDate": "2022-03-24",
    "amendAmount": "123",
    "amendCurrency": "USD",
    "amendExpiryType": "test",
    "amendExpiryDate": "2022-03-24",
    "amendExpiryCondition": "test",
    "amendDetails": "test",
    "messageToBank": "test",
    "amendStatus": "test",
    "cancellationStatus": "test",
    "corporateUserName": "test",
    "supportingDocument": "test",
    "guaranteesSRMSId": "GUA221514XEW3"
}
Response: 
{
    "benificiaryName": "DevUA",
    "guaranteesReference": "GUA221514XEW3",
    "currency": "USD",
    "amount": "123",
    "expiryDate": "2022-03-24",
    "productType": "Standby LC",
    "issueDate": "2022-03-24",
    "instructingParty": "test - instructingParty",
    "billType": "BID",
    "expiryType": "Open Ended",
    "applicantParty": "test - applicantParty",
    "amendmentNo": "02",
    "amendmentEffectiveDate": "2022-03-24",
    "amendAmount": "123",
    "amendCurrency": "USD",
    "amendExpiryType": "Open Ended",
    "amendExpiryDate": "2022-03-24",
    "amendExpiryCondition": "test - amendExpiryCondition",
    "amendDetails": "test - amendDetails",
    "messageToBank": "Accept Amendment2",
    "amendStatus": "Submitted to Bank",
    "amendRequestedDate": "2022-06-16T08:12:07Z",
    "amendmentReference": "GUAM22167C291K",
    "amendmentSRMSRequestId": "GUAM22167C291K",
    "cancellationStatus": "test - cancellationStatus",
    "reasonForReturned": "Change Amendment Details",
    "corporateUserName": "test - corporateUserName",
    "supportingDocument": "test - supportingDocument",
    "guaranteesSRMSId": "GUA221514XEW3",
    "AmendmentHistory": [{
        "amendmentHistory1": "{'ReturnMessageToBank':'Accept Amendment','ReasonforReturned':'ChangesAmendmentdetails','CorporatorName':'Naveen'}",
        "amendmentHistory2": "{'ReasonforReturned':'ChangesAmendmentdetails','CorporatorName':'Naveen','ReturnMessageToBank':'Accept Amendment2'}"
    }],
    "historyCount": "2",
    "opstatus": 0,
    "httpStatusCode": 0
}
Error Code(s):
  • Error Code: 29048
    Error Message: "Failed to Update letter of credits"
  • Error Code: 26014
    Error Message: "Failed to fetch Customer ID"
  • Error Code: 10117
    Error Message: "Logged in User is not authorized to perform this action"
  • Error Code: 10118
    Error Message: "Input Validation Failed"
  • Error Code: 29070
    Error Message: "SECURITY EXCEPTION - UNAUTHORIZED ACCESS"
  • Error Code: 29052
    Error Message: "Unable to create order. Failed to find service request id in Response"
  • Error Code: 29065
    Error Message: "Error while Get LOC Call by ID"
  • Error Code: 12007
    Error Message: "Logged in User is not authorized to perform this action"
Enterprise Provider: Service Request Microservice
Enterprise API:

{base_url}/v2.0.0/orders/serviceRequest/$serviceRequestIds

Field Mapping

UI Field Experience API Field MS API Field Transact API Field
Benificiary Name benificiaryName NA NA
GuaranteesCReference guaranteesReference NA NA
Currency currency NA NA
Amount amount NA NA
Expiry Date expiryDate NA NA
Product Type productType NA NA
Issue Date issueDate NA NA
Instructing Party instructingParty NA NA
Bill Type billType NA NA
Expiry Type expiryType NA NA
Applicant Party applicantParty NA NA
Amendment No amendmentNo NA NA
Amendment Effective Date amendmentEffectiveDate NA NA
Amend Amount amendAmount NA NA
Amend Currency amendCurrency NA NA
Amend Expiry Type amendExpiryType NA NA
Amend Expiry Condition amendExpiryCondition NA NA
Amend Details amendDetails NA NA
Message To Bank messageToBank NA NA
Amend Status amendStatus NA NA
Amend Requested Date amendRequestedDate NA NA
Amendment Reference amendmentReference NA NA
Amendment SRMS RequestId amendmentSRMSRequestId NA NA
Cancellation Status cancellationStatus NA NA
Corporate UserName corporateUserName NA NA
Supporting Document supportingDocument NA NA
Field Name
|
Application/Table name
Expand/ Collapse
Share
Print

In this topic

Temenos Headquarters SA
2 Rue de l'Ecole-de-Chimie
CH - 1205 Geneva
Switzerland

Copyright © 2020- Temenos Headquarters SA

Contact Us

knowledge@temenos.com

Published on :
Tuesday, May 23, 2023 9:43:43 PM IST