Temenos Digital
Updated On 22 March 2025 | Min(s) read

Guarantees and SBLC Received - Amendments

Name Description Introduced In
createAmendment This API creates the received guarantee amendments. 2022.10
getAmendments This API retrieves the list of received guarantee amendments for the customer. 2022.10
getAmendmentById This API retrieves the list of received guarantee amendments by ID. 2022.10
updateAmendment This API updates a received guarantee amendment record. 2022.10
generateAmendmentReport This API downloads the report for received guarantee amendments records. 2022.10
generateAmendmentsList This API exports the list of received guarantee amendment records. 2022.10
Object Data Model This Object Data Model describes the parameter name and other attribute details for Trade Finance.  
 
Description: This API creates Guarantees Amendments.
Method: POST
URL: {base_url}/services/data/v1/TradeFinance/operations/ReceivedGuarantees/createAmendment
Security Level: Authenticated App User
Header Request: X-Kony-Authorization
Body Request: 
{
    "guaranteeSrmsId": "RGUA22228MXYD7",
    "applicant": "Meiyaz",
    "productType": "Guarantee",
    "lcType": "BID",
    "amount": "1234.00",
    "currency": "USD",
    "amendmentCharges": "23",
    "dateOfAmountChange": "2025-12-12",
    "amendAmount": "12,345.00",
    "amendExpiryType": "Open Ended",
    "amendExpiryDate": "2025-12-12",
    "amendExpiryConditions": "Some expiry conditions",
    "beneficiaryDetails": "[{'beneficiaryName':'Meiyaz','address1':'Temenos','address2':'KG360','city':'Chennai','state':'Tamil Nadu','country':'India','zipcode':'600097','isCorporate':'false','payeeId':'71014689','payeeType':'sameBank','isChanged':false}]",
    "governingLaw": "G Law",
    "otherInstructions": "Other Instructions",
    "messageFromBank": "SOme message from bank",
    "supportingDocuments": "[{'documentName':'Letter Of Credit Acknowledgement.pdf','documentReferences':'TFD-c05H9v6E-T1fdRSeb-6Id2RQ3u-ztrtQBhU'}]"
}
Response: 
{
    "amendExpiryConditions": "Some expiry conditions",
    "amendmentCharges": "23",
    "amendExpiryDate": "2025-12-12",
    "messageFromBank": "SOme message from bank",
    "amount": "1234.00",
    "amendExpiryType": "Open Ended",
    "governingLaw": "G Law",
    "guaranteeSrmsId": "RGUA22228MXYD7",
    "amendmentSrmsId": "RGAM22228VBBUY",
    "applicant": "Meiyaz",
    "lcType": "BID",
    "receivedOn": "2022-08-16T07:57:49Z",
    "beneficiaryDetails": "[{'beneficiaryName':'Meiyaz','address1':'Temenos,'address2':'KG360','city':'Chennai,'state':'Tamil Nadu','country':'India','zipcode':'600097','isCorporate':'false','payeeId':'71014689','payeeType':'sameBank','isChanged':false}]",
    "otherInstructions": "Other Instructions",
    "currency": "USD",
    "selfAcceptance": "Pending",
    "amendAmount": "12,345.00",
    "supportingDocuments": "[{'documentName':'Letter Of Credit Acknowledgement.pdf','documentReferences':'TFD-c05H9v6E-T1fdRSeb-6Id2RQ3u-ztrtQBhU'}]",
    "productType": "Guarantee",
    "status": "New",
    "dateOfAmountChange": "2025-12-12",
    "opstatus": 0,
    "httpStatusCode": 0
}
Error Code(s):
  • Error Code: 26014
    Error Message: "Failed to fetch Customer ID"
  • Error Code: 29073
    Error Message: "Record cannot be edited further"
  • Error Code: 12001
    Error Message: "Guarantee is not eligible to create amendment"
  • Error Code: 29071
    Error Message: "Unable to fetch the record"
  • Error Code: 29070
    Error Message: "SECURITY EXCEPTION - UNAUTHORIZED ACCESS"
  • Error Code: 29091
    Error Message: "Unable to create guarantee request order"
  • Error Code: 12007
    Error Message: "Logged in User is not authorized to perform this action"
  • Error Code: 12002
    Error Message: "Error occurred while creating record"
Enterprise Provider:  
Enterprise API:

 

Field Mapping

UI Field Experience API field Transact API Field
NA guaranteeSrmsId NA
Applicant applicant NA
Product Type productType NA
GT & SBLC Type lcType NA
Amount amount NA
Currency currency NA
Amendment Charges amendmentCharges NA
Date of Amount Change dateOfAmountChange NA
Amount amendAmount NA
Expiry Type amendExpiryType NA
Expiry Date amendExpiryDate NA
Expiry Conditions amendExpiryConditions NA
Beneficiary Details beneficiaryDetails NA
Governing Law governingLaw NA
Other Instructions otherInstructions NA
Message from Bank messageFromBank NA
Supporting Documents supportingDocuments NA
NA amendmentSrmsId NA
Received On receivedOn NA
Self Acceptance selfAcceptance NA
Status status NA
 
Description: This API retrieves the list of received guarantee amendments for the customer.
Method: POST
URL: {base_url}/services/data/v1/TradeFinance/operations/ReceivedGuarantees/getAmendments
Security Level: Authenticated App User
Header Request: X-Kony-Authorization
Body Request: 
{
    "searchString": "",
    "pageSize": "",
    "pageOffset": "",
    "sortByParam": "",
    "sortOrder": "",
    "timeParam": "",
    "timeValue": "",
    "filterByValue": "New",
    "filterByParam": "status"
}
Response: 
{
    "ReceivedAmendments": [{
        "amendExpiryConditions": "Some expiry conditions",
        "amendmentCharges": "23",
        "amendExpiryDate": "2025-12-12",
        "messageFromBank": "SOme message from bank",
        "amendExpiryType": "Open Ended",
        "guaranteeSrmsId": "RGUA22228MXYD7",
        "amendmentSrmsId": "RGAM22228VBBUY",
        "receivedOn": "2022-08-16T07:57:49Z",
        "beneficiaryDetails": "[{'beneficiaryName':'Meiyaz','address1':'Temenos','address2':'KG360','city':'Chennai','state':'Tamil Nadu','country':'India','zipcode':'600097','isCorporate':'false','payeeId':'71014689','payeeType':'sameBank','isChanged':false}]",
        "currency": "USD",
        "selfAcceptance": "Pending",
        "amendAmount": "12,345.00",
        "amountWithCurrency": "$ 1234.00",
        "productType": "Guarantee",
        "amount": "1234.00",
        "governingLaw": "G Law",
        "applicant": "Meiyaz",
        "lcType": "BID",
        "otherInstructions": "Other Instructions",
        "supportingDocuments": "[{'documentName':'Letter Of Credit Acknowledgement.pdf','documentReferences':'TFD-c05H9v6E-T1fdRSeb-6Id2RQ3u-ztrtQBhU'}]",
        "status": "New",
        "dateOfAmountChange": "2025-12-12"
    }],
    "opstatus": 0,
    "httpStatusCode": 0
}
Error Code(s):
  • Error Code: 26014
    Error Message: "Failed to fetch Customer ID"
  • Error Code: 29093
    Error Message: "Get Request failed"
  • Error Code: 12007
    Error Message: "Logged in User is not authorized to perform this action"
Enterprise Provider:  
Enterprise API:  

Field Mapping

UI Field Experience API field Transact API Field
NA searchString NA
NA pageSize NA
NA pageOffset NA
NA sortByParam NA
NA sortOrder NA
NA timeParam NA
NA timeValue NA
NA filterByValue NA
Expiry Conditions amendExpiryConditions NA
Charges amendmentCharges NA
Expiry Date amendExpiryDate NA
Message from Bank messageFromBank NA
Expiry Type amendExpiryType NA
Enter reason for self rejection reasonForSelfRejection NA
NA guaranteeSrmsId NA
NA amendmentSrmsId NA
Received On receivedOn NA
Beneficiary Details beneficiaryDetails NA
Currency currency NA
Self Acceptance selfAcceptance NA
Amount amendAmount NA
Request Amount amountWithCurrency NA
Product Type productType NA
Amount amount NA
Governing Law governingLaw NA
Applicant applicant NA
Message to Bank messageToBank NA
LC Type lcType NA
Other Instructions otherInstructions NA
Supporting Documents supportingDocuments NA
Status status NA
Self Acceptance Date selfAcceptanceDate NA
Date of Amount Change dateOfAmountChange NA
 
Description: This API retrieves the list of received guarantee amendments by ID.
Method: POST
URL: {base_url}/services/data/v1/TradeFinance/operations/ReceivedGuarantees/getAmendmentById
Security Level: Authenticated App User
Header Request: X-Kony-Authorization
Body Request: 
{
    "amendmentSrmsId": "RGAM222281QGPR"
}
Response: 
{
    "amendExpiryConditions": "Some expiry conditions",
    "amendmentCharges": "23",
    "amendExpiryDate": "2025-12-12",
    "messageFromBank": "SOme message from bank",
    "amendExpiryType": "Open Ended",
    "guaranteeSrmsId": "RGUA22228MXYD7",
    "amendmentSrmsId": "RGAM22228VBBUY",
    "receivedOn": "2022-08-16T07:57:49Z",
    "beneficiaryDetails": "[{'beneficiaryName':'Meiyaz','address1':'Temenos','address2':'KG360','city':'Chennai','state':'Tamil Nadu','country':'India','zipcode':'600097','isCorporate':'false','payeeId':'71014689','payeeType':'sameBank','isChanged':false}]",
    "currency": "USD",
    "selfAcceptance": "Pending",
    "amendAmount": "12,345.00",
    "amountWithCurrency": "$ 1234.00",
    "productType": "Guarantee",
    "amount": "1234.00",
    "governingLaw": "G Law",
    "applicant": "Meiyaz",
    "lcType": "BID",
    "otherInstructions": "Other Instructions",
    "supportingDocuments": "[{'documentName':'Letter Of Credit Acknowledgement.pdf','documentReferences':'TFD-c05H9v6E-T1fdRSeb-6Id2RQ3u-ztrtQBhU'}]",
    "status": "New",
    "dateOfAmountChange": "2025-12-12",
    "opstatus": 0,
    "httpStatusCode": 0
}
Error Code(s):
  • Error Code: 26014
    Error Message: "Failed to fetch Customer ID"
  • Error Code: 29049
    Error Message: "Mandatory fields are missing"
  • Error Code: 29070
    Error Message: "SECURITY EXCEPTION - UNAUTHORIZED ACCESS"
  • Error Code: 29071
    Error Message: "Unable to fetch the record"
  • Error Code: 12007
    Error Message: "Logged in User is not authorized to perform this action"
Enterprise Provider:  
Enterprise API:  

Field Mapping

UI Field Experience API field Transact API Field
Expiry Conditions amendExpiryConditions NA
Charges amendmentCharges NA
Expiry Date amendExpiryDate NA
Message from Bank messageFromBank NA
Expiry Type amendExpiryType NA
Enter reason for self rejection reasonForSelfRejection NA
NA guaranteeSrmsId NA
NA amendmentSrmsId NA
Received On receivedOn NA
Beneficiary Details beneficiaryDetails NA
Currency currency NA
Self Acceptance selfAcceptance NA
Amount amendAmount NA
Request Amount amountWithCurrency NA
Product Type productType NA
Amount amount NA
Governing Law governingLaw NA
Applicant applicant NA
Message to Bank messageToBank NA
LC Type lcType NA
Other Instructions otherInstructions NA
Supporting Documents supportingDocuments NA
Status status NA
Self Acceptance Date selfAcceptanceDate NA
Date of Amount Change dateOfAmountChange NA
 
Description: This API updates a received guarantee amendment record.
Method: POST
URL: {base_url}/services/data/v1/TradeFinance/operations/ReceivedGuarantees/updateAmendment
Security Level: Authenticated App User
Header Request: X-Kony-Authorization
Body Request: 
{
    "amendmentSrmsId": "RGAM22228VBBUY",
    "selfAcceptance": "Rejected",
    "reasonForSelfRejection": "Test",
    "messageToBank": "Message"
}
Response: 
{
    "amendExpiryConditions": "Some expiry conditions",
    "amendmentCharges": "23",
    "amendExpiryDate": "2025-12-12",
    "messageFromBank": "SOme message from bank",
    "amendExpiryType": "Open Ended",
    "reasonForSelfRejection": "Test",
    "guaranteeSrmsId": "RGUA22228MXYD7",
    "amendmentSrmsId": "RGAM22228VBBUY",
    "receivedOn": "2022-08-16T07:57:49Z",
    "beneficiaryDetails": "[{'beneficiaryName':'Meiyaz','address1':'Temenos','address2':'KG360','city':'Chennai','state':'Tamil Nadu','country':'India','zipcode':'600097','isCorporate':'false','payeeId':'71014689','payeeType':'sameBank','isChanged':false}]",
    "currency": "USD",
    "selfAcceptance": "Rejected",
    "amendAmount": "12,345.00",
    "amountWithCurrency": "$ 1234.00",
    "productType": "Guarantee",
    "amount": "1234.00",
    "governingLaw": "G Law",
    "applicant": "Meiyaz",
    "messageToBank": "Message",
    "lcType": "BID",
    "otherInstructions": "Other Instructions",
    "supportingDocuments": "[{'documentName':'Letter Of Credit Acknowledgement.pdf','documentReferences':'TFD-c05H9v6E-T1fdRSeb-6Id2RQ3u-ztrtQBhU'}]",
    "status": "Submitted to Bank",
    "selfAcceptanceDate": "2022-08-16T07:59:31Z",
    "dateOfAmountChange": "2025-12-12",
    "opstatus": 0,
    "httpStatusCode": 0
}
Error Code(s):
  • Error Code: 26014
    Error Message: "Failed to fetch Customer ID"
  • Error Code: 29049
    Error Message: "Mandatory fields are missing"
  • Error Code: 29093
    Error Message: "Get Request failed"
  • Error Code: 12003
    Error Message: "Invalid status found in request payload"
  • Error Code: 12002
    Error Message: "Invalid input found in request payload"
  • Error Code: 29070
    Error Message: "SECURITY EXCEPTION - UNAUTHORIZED ACCESS"
  • Error Code: 29071
    Error Message: "Unable to fetch the record"
  • Error Code: 29092
    Error Message: "Unable to update guarantee request order"
  • Error Code: 12007
    Error Message: "Logged in User is not authorized to perform this action"
Enterprise Provider:  
Enterprise API:  

Field Mapping

UI Field Experience API field Transact API Field
Expiry Conditions amendExpiryConditions NA
Charges amendmentCharges NA
Expiry Date amendExpiryDate NA
Message from Bank messageFromBank NA
Expiry Type amendExpiryType NA
Enter reason for self rejection reasonForSelfRejection NA
NA guaranteeSrmsId NA
NA amendmentSrmsId NA
Received On receivedOn NA
Beneficiary Details beneficiaryDetails NA
Currency currency NA
Self Acceptance selfAcceptance NA
Amount amendAmount NA
Request Amount amountWithCurrency NA
Product Type productType NA
Amount amount NA
Governing Law governingLaw NA
Applicant applicant NA
Message to Bank messageToBank NA
LC Type lcType NA
Other Instructions otherInstructions NA
Supporting Documents supportingDocuments NA
Status status NA
Self Acceptance Date selfAcceptanceDate NA
Date of Amount Change dateOfAmountChange NA
 
Description: This API downloads the report for received guarantee amendments records.
Method: POST
URL: {base_url}/services/data/v1/TradeFinance/operations/ReceivedGuarantees/generateAmendmentReport
Security Level: Authenticated App User
Header Request: X-Kony-Authorization
Body Request: 
{
    "amendmentSrmsId": "RGAM222281QGPR"
}
Response: 
{
    "fileId": "RGAM-Jgvukl3R-xDwmid6f-ag2hOke5-c1QZD8OG",
    "opstatus": 0,
    "httpStatusCode": 0
}
Error Code(s):
  • Error Code: 26014
    Error Message: "Failed to fetch Customer ID"
  • Error Code: 10118
    Error Message: "Input Validation Failed"
  • Error Code: 29070
    Error Message: "SECURITY EXCEPTION - UNAUTHORIZED ACCESS"
  • Error Code: 29071
    Error Message: "Unable to fetch the record"
  • Error Code: 12007
    Error Message: "Logged in User is not authorized to perform this action"
Enterprise Provider:  
Enterprise API:  

Field Mapping

UI Field Experience API field Transact API Field
NA amendmentSRMSRequestId NA
NA fileId NA
 
Description: This API exports the list of received guarantee amendment records.
Method: POST
URL: {base_url}/services/data/v1/TradeFinance/operations/ReceivedGuarantees/generateAmendmentsList
Security Level: Authenticated App User
Header Request: X-Kony-Authorization
Body Request: 
{
    "searchString": "",
    "pageSize": "",
    "pageOffset": "",
    "sortByParam": "",
    "sortOrder": "",
    "timeParam": "",
    "timeValue": "",
    "filterByValue": "New",
    "filterByParam": "status"
}
Response: 
{
    "fileId": "RGAM-Jgvukl3R-xDwmid6f-ag2hOke5-c1QZD8OG",
    "opstatus": 0,
    "httpStatusCode": 0
}
Error Code(s):
  • Error Code: 29054
    Error Message: "Error occurred while initiating the trade finance download"
  • Error Code: 29055
    Error Message: "Something went wrong while generating report"
  • Error Code: 29056
    Error Message: "Error occurred while generating the trade finance file"
Enterprise Provider:  
Enterprise API:  

Field Mapping

UI Field Experience API field Transact API Field
NA searchString NA
NA pageSize NA
NA pageOffset NA
NA sortByParam NA
NA timeParam NA
NA timeValue NA
NA filterByValue NA
NA filterByParam NA
NA fileId NA
 
Parameter Name DataType Optional/Mandatory Description
amendAmount String Mandatory Amendment Amount
amendExpiryConditions String Mandatory Amendment Expiry Conditions
amendExpiryDate String Mandatory Amendment Expiry Date
amendExpiryType String Mandatory Amendment Expiry Type
amendmentCharges String Mandatory Amendment Charges
amendmentSrmsId String Mandatory SRMS id for amendments
amendmentSRMSRequestId String Mandatory SRMS requests id for amendments
amount String Mandatory Amount
amountWithCurrency String Mandatory Amount with Currency
applicableRules String Mandatory Applicable Rules
applicant String Mandatory Applicant Name
applicantAddress String Mandatory Applicant Address
applicantName String Mandatory Applicant Name
applicantParty String Mandatory Applicant Party
autoExtensionExpiry String Mandatory Auto Extension Expiry
beneficiaryDetails String Mandatory Beneficiary Details
beneficiaryName String Mandatory Beneficiary Name
chargesDebitAccount String Mandatory Charges Debit Account
claimAmount String Mandatory Claim Amount
claimCreditAccount String Mandatory Claim Credit Account
claimCurrency String Mandatory Claim Currency
claimsSRMSId String Mandatory Claim SRMS Id
clausesAndConditions String Mandatory Clauses and Conditions
createdOn String Mandatory Created Date
currency String Mandatory Currency
dateOfAmountChange String Mandatory Date of Amount Change
deliveryInstructions String Mandatory Delivery Instructions
demandType String Mandatory Demand Type
discrepancy1 String Mandatory First Discrepancy
discrepancy1UserComment String Mandatory First Discrepancy User Comment
discrepancy1UserResponse String Optional First Discrepancy User Response
discrepancy2 String Mandatory Second Discrepancy
discrepancy2UserComment String Mandatory Second Discrepancy User Comment
discrepancy2UserResponse String Optional Second Discrepancy User Response
documentInformation String Mandatory Reference for uploaded documents
documentStatus String Mandatory Document Status
expectedIssueDate String Mandatory Expected Isse Date
expiryConditions String Mandatory Expiry Conditions
expiryDate String Mandatory Expiry Date
expiryType String Mandatory Expiry Type
exportLCId String Mandatory SRMS request id of the export LC
extensionCapPeriod String Mandatory Extension Cap Period
extensionDetails String Mandatory Extension Details
extensionPeriod String Mandatory Extension Period
fileId String Mandatory Generated file id from server
filterByParam String Optional Filter parameter in comma separated
filterByValue String Optional Filter value in comma separated
forwardDocuments String Mandatory Forward Documents Status
governingLaw String Mandatory Governing Law
guaranteeAndSBLCType String Mandatory Guarantee and SBLC Type
GuaranteeClaims String Mandatory Guarantee Claims
guaranteesReferenceNo String Mandatory Guarantee Reference Number
guaranteesSRMSId String Mandatory Guarantees SRMS Id
issueDate String Mandatory Issuing Date
issuingBank String Mandatory Issuing Bank Name
issuingBankAddress String Mandatory Issuing Bank Address
issuingBankIban String Mandatory Issuing Bank IBAN
issuingBankLocalCode String Mandatory Issuing Bank Local Code
issuingBankName String Mandatory Issuing Bank Name
issuingBankSwiftBicCode String Mandatory Issuing Bank Swift or BIC Code
lcType String Mandatory Letter of Credit Type
messageFromBank String Optional Message from Bank
messageToBank String Optional Message to Bank
modeOfTransaction String Mandatory Mode of Transaction
newExtensionDate String Mandatory New Extension Date
notificationPeriod String Mandatory Notification Period
otherDemandDetails String Mandatory Other Demand Details
otherInstructions String Mandatory Other Instructions
pageOffset String Optional Defines fetching records from the count mentioned
pageSize String Optional The count of records in response
paymentSettledDate String  Mandatory Payment Settled Date
paymentStatus String Mandatory Payment Status
physicalDocuments String Mandatory Physical Document Status
productType String Mandatory Product Type
reasonForReturn String Mandatory Reason for Return
reasonForSelfRejection String Optional Reason for Self Rejection
receivedOn String Mandatory Received Date
relatedTransactionReference String Optional Related Transaction Reference
returnedCount String Mandatory Returned Count from Bank
returnedDocuments String Optional Returned Documents from Bank
returnedHistory String Optional Returned History from Bank
returnedTime String Mandatory Returned Time
returnMessageToBank String Optional Return Message To Bank
searchString String Optional Search Keyword
selfAcceptance String Mandatory Self Acceptance
selfAcceptanceDate String Mandatory Self Acceptance Date
selfRejectionHistory String Mandatory Self Rejection History
sortByParam String Optional Sorting parameter in comma separated
sortOrder String Optional Sorting values in comma separated
srmsClaimRequestId String Mandatory SRMS requests id for claims record
status String Mandatory Status of record
supportingDocuments String Mandatory Supporting Documents
timeParam String Optional Time Parameter
timeValue String Optional Time value separated with count and time period
totalDocuments String Mandatory Total Count of Documents
transactionReference String Mandatory Transaction Reference
uploadedDocuments String Mandatory Uploaded Documents
utilizedAmount String Mandatory Utilized Amount

Copyright © 2020- Temenos Headquarters SA

Contact Us

knowledge@temenos.com

Published on :
Sunday, March 23, 2025 3:07:44 PM IST