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.  
ClosedcreateAmendment
 
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: Service Request Microservice
Enterprise API:

{base_url}/v2.0.0/orders/party/$partyId/type/$type/subtype/$subtype/serviceRequest

Field Mapping

UI Field Experience API field MS API Field Transact API Field
NA guaranteeSrmsId NA NA
Applicant applicant NA NA
Product Type productType NA NA
GT & SBLC Type lcType NA NA
Amount amount NA NA
Currency currency NA NA
Amendment Charges amendmentCharges NA NA
Date of Amount Change dateOfAmountChange NA NA
Amount amendAmount NA NA
Expiry Type amendExpiryType NA NA
Expiry Date amendExpiryDate NA NA
Expiry Conditions amendExpiryConditions NA NA
Beneficiary Details beneficiaryDetails NA NA
Governing Law governingLaw NA NA
Other Instructions otherInstructions NA NA
Message from Bank messageFromBank NA NA
Supporting Documents supportingDocuments NA NA
NA amendmentSrmsId NA NA
Received On receivedOn NA NA
Self Acceptance selfAcceptance NA NA
Status status NA NA
ClosedgetAmendments
 
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: Service Request Microservice
Enterprise API:

{base_url}/v2.0.0/orders/party/$partyId?$queryParams

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
Expiry Conditions amendExpiryConditions NA NA
Charges amendmentCharges NA NA
Expiry Date amendExpiryDate NA NA
Message from Bank messageFromBank NA NA
Expiry Type amendExpiryType NA NA
Enter reason for self rejection reasonForSelfRejection NA NA
NA guaranteeSrmsId NA NA
NA amendmentSrmsId NA NA
Received On receivedOn NA NA
Beneficiary Details beneficiaryDetails NA NA
Currency currency NA NA
Self Acceptance selfAcceptance NA NA
Amount amendAmount NA NA
Request Amount amountWithCurrency NA NA
Product Type productType NA NA
Amount amount NA NA
Governing Law governingLaw NA NA
Applicant applicant NA NA
Message to Bank messageToBank NA NA
LC Type lcType NA NA
Other Instructions otherInstructions NA NA
Supporting Documents supportingDocuments NA NA
Status status NA NA
Self Acceptance Date selfAcceptanceDate NA NA
Date of Amount Change dateOfAmountChange NA NA
ClosedgetAmendmentById
 
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: 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
Expiry Conditions amendExpiryConditions NA NA
Charges amendmentCharges NA NA
Expiry Date amendExpiryDate NA NA
Message from Bank messageFromBank NA NA
Expiry Type amendExpiryType NA NA
Enter reason for self rejection reasonForSelfRejection NA NA
NA guaranteeSrmsId NA NA
NA amendmentSrmsId NA NA
Received On receivedOn NA NA
Beneficiary Details beneficiaryDetails NA NA
Currency currency NA NA
Self Acceptance selfAcceptance NA NA
Amount amendAmount NA NA
Request Amount amountWithCurrency NA NA
Product Type productType NA NA
Amount amount NA NA
Governing Law governingLaw NA NA
Applicant applicant NA NA
Message to Bank messageToBank NA NA
LC Type lcType NA NA
Other Instructions otherInstructions NA NA
Supporting Documents supportingDocuments NA NA
Status status NA NA
Self Acceptance Date selfAcceptanceDate NA NA
Date of Amount Change dateOfAmountChange NA NA
ClosedupdateAmendment
 
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: Service Request Microservice
Enterprise API:

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

Field Mapping

UI Field Experience API field MS API Field Transact API Field
Expiry Conditions amendExpiryConditions NA NA
Charges amendmentCharges NA NA
Expiry Date amendExpiryDate NA NA
Message from Bank messageFromBank NA NA
Expiry Type amendExpiryType NA NA
Enter reason for self rejection reasonForSelfRejection NA NA
NA guaranteeSrmsId NA NA
NA amendmentSrmsId NA NA
Received On receivedOn NA NA
Beneficiary Details beneficiaryDetails NA NA
Currency currency NA NA
Self Acceptance selfAcceptance NA NA
Amount amendAmount NA NA
Request Amount amountWithCurrency NA NA
Product Type productType NA NA
Amount amount NA NA
Governing Law governingLaw NA NA
Applicant applicant NA NA
Message to Bank messageToBank NA NA
LC Type lcType NA NA
Other Instructions otherInstructions NA NA
Supporting Documents supportingDocuments NA NA
Status status NA NA
Self Acceptance Date selfAcceptanceDate NA NA
Date of Amount Change dateOfAmountChange NA NA
ClosedgenerateAmendmentReport
 
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: 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 amendmentSRMSRequestId NA NA
NA fileId NA NA
ClosedgenerateAmendmentsList
 
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: Service Request Microservice
Enterprise API:

{base_url}/v2.0.0/orders/party/$partyId?$queryParams

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 timeParam NA NA
NA timeValue NA NA
NA filterByValue NA NA
NA filterByParam NA NA
NA fileId NA NA
ClosedObject Data Model
ClosedReceived Guarantees
 
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
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 8:38:08 PM IST