1.5.9 Authorized Signatory
Event notification for amendment including addition, deletion and update in party-to-party relationship of the authorized signatory relationship.
Auth Signatory Relationship event is published during an amendment process through.
- User Interface (PUT API)
- PUT API Request
- PATCH API Request
Table 1-63 Data Segment
Data Segment Code | Data Segment Name | Topic Name | Party Type |
---|---|---|---|
DS0063 | AUTH_SIG_REL | obpySmbAmendAuthSigRel | SMB |
Event for PUT API
The PUT API method, an HTTP request method, is utilized for updating the entire Data Segment of customer information. PUT method replaces the entire Data Segment with the new data provided in the request.
Using the PUT API method for amendments, event publishing will not be contingent on the information provided in the request and will include all the attributes of the data segment.
Note:
For PUT API Request “httpMethod” is populated as “PUT”.{
"applicationNumber": "SBAT17157581812",
"branchCode": "100006",
"userId": "USER1",
"partyId": "PTY00001",
"externalCustomerId": "PTY00001",
"partyType": "S",
"eventType": "AMEND",
"handoffStatus": "SUCCESS",
"sourceProductId": "OBPY",
"datasegmentCode": "DS0063",
"datasegmentName": "AUTH_SIG_REL",
"httpMethod": "PUT",
"amendPayload": "{\"recordId\":\"1349362009053814784\",\"parentId\":\"1349362007397064705\",\"partyId\":\"PTY00001\",\"versionNo\":2,\"recordStat\":\"O\",\"createdBy\":\"USER1\",\"createdDate\":\"2021-01-20T07:42:45\",\"updatedBy\":\"USER1\",\"updatedDate\":\"2021-01-20T07:43:01\",\"authSignatoryList\":[{\"id\":\"1349362044604735492\",\"parentId\":\"1349362009053814784\",\"associatePartyId\":\"000370635\",\"versionNo\":1,\"recordStat\":\"O\",\"createdBy\":\"USER1\",\"createdDate\":\"2021-01-20T07:43:01\",\"updatedBy\":\"USER1\",\"updatedDate\":\"2021-01-20T07:43:01\"}],\"links\":[]}",
"amendDateTime": "2025-03-12T12:43:06.180398",
"applicationDate": "2021-01-20"
}
Event for PATCH API
The PATCH API method, an HTTP request method, is utilized for record and field-level modifications within a Data Segment of customer information, rather than updating the entire Data Segment Information.
Using PATCH API method for amendments, event publishing will be contingent on the information provided in the request and will solely include the attributes that have been modified. Through PATCH API method specific records can be added, updated, or deleted. During record update specific fields can be added, updated, or removed by specifying the attributes requiring modification.
Structure of the Event generated through PATCH API
The Event body is divided into the following key sections:
- "op": Defines the applicable operation to identify the nature of the action as
- Update of existing record ("op": "replace"): Update of specific fields in an existing record.
- New record ("op": "add"): New record added to the data segment.
- Delete of existing Record ("op": "remove"): Delete of an existing record from the data segment.
- "param": A combination of Party ID and Associated Party ID to identify unique identifier Auth Signatory relationship records.
- "values": Contains the attributes that are modified within the uniquely identified record.
Note:
For PATCH API Request “httpMethod” is populated as “PATCH”.Table 1-64 Param and Value availability with respect to Operation
Operation | param | values |
---|---|---|
"op": "replace" | Combination of Party ID and Associated Party ID used to uniquely identify the record | Modified fields |
"op": "add" | Empty | New record added to the data segment. |
"op": "remove" | Combination of Party ID and Associated Party ID used to uniquely identify the record | Empty |
{
"applicationNumber": "000000APP25071160072",
"branchCode": "000",
"userId": "USER1",
"partyId": "PTY0001",
"externalCustomerId": "PTY0001",
"partyType": "S",
"eventType": "AMEND",
"handoffStatus": "SUCCESS",
"sourceProductId": "OBPY",
"datasegmentCode": "DS0063",
"datasegmentName": "AUTH_SIG_REL",
"httpMethod": "PATCH",
"amendPayload": "{\"sourceProductId\":\"OBPY\",\"externalCustomerNo\":\"PTY0001\",\"applicationNumber\":\"000000APP25071160072\",\"authSignatoryList\":[{\"op\":\"add\",\"params\":{},\"values\":{\"id\":\"1349391965112721411\",\"parentId\":\"1349391965112721410\",\"associatePartyId\":\"PTY0002\",\"authSigRemarks\":\"AA\",\"versionNo\":1,\"createdBy\":\"USER1\",\"createdDate\":\"2018-03-30T12:44:29\",\"updatedBy\":\"USER1\",\"updatedDate\":\"2018-03-30T12:44:29\",\"titleAuthSign\":\"OWN\"}},{\"op\":\"replace\",\"params\":{\"partyId\":\"PTY0001\",\"associatePartyId\":\"PTY0003\"},\"values\":{\"id\":\"1349391965112721411\",\"parentId\":\"1349391965112721410\",\"associatePartyId\":\"PTY0002\",\"authSigRemarks\":\"AA\",\"versionNo\":1,\"createdBy\":\"USER1\",\"createdDate\":\"2018-03-30T12:44:29\",\"updatedBy\":\"USER1\",\"updatedDate\":\"2018-03-30T12:44:29\",\"titleAuthSign\":\"OWN\"}}]}",
"amendDateTime": "2025-03-12T14:41:56.261742",
"applicationDate": "2022-09-20"
}
Parent topic: Small & Medium Business (SMB) Party Amendment