Account Services
Enlist your company's and suppliers' bank accounts
Account services allows you to add your own bank accounts as well as manage beneficiary bank accounts (supplier bank accounts).
Add account
Endpoint details
Endpoint URL | Method | Authentication requirements |
---|---|---|
/v1/api/erp/svAccService | POST | 1. clientid 2. clientsecret 3. signature |
A request in the following format should be posted to the mentioned URL endpoint.
curl --location --request POST 'https://servicesuat.onesingleview.com/v1/api/erp/svAccService' \
--header 'clientid: Enter_Client_ID' \
--header 'clientsecret: Enter_Client_Secret' \
--header 'signature: Enter_Signature' \
--header 'Content-Type: application/json' \
--data-raw '{
"svAccServiceRQ": {
"groupCode": "Enter_Group_Code",
"company": [
{
"companyCode": "Enter_Company_Code",
"userName": "Enter_Username",
"account": [
{
"bankCode": Enter_OSV_Bank_Code_Identifier,
"accountNum": "Enter_Bank_Account_Number",
"corpId": "Enter_Corporate_Bank_Code",
"holderName": "Enter_Bank_Account_Holder_Name",
"iban": "Enter_International_Bank_Account_Number",
"address": "Enter_ Bank_Address",
"currency": "Enter_Currency",
"acERPcode": "Enter_Unique_ERP_Account_Code"
},
{
"bankCode": Enter_OSV_Bank_Code_Identifier,
"accountNum": "Enter_Bank_Account_Number",
"corpId": "Enter_Corporate_Bank_Code",
"holderName": "Enter_Bank_Account_Holder_Name",
"iban": "Enter_International_Bank_Account_Number",
"address": "Enter_ Bank_Address",
"currency": "Enter_Currency",
"acERPcode": "Enter_Unique_ERP_Account_Code" // EX : ACC002
}
],
"beneficiary": [
{
"type": "Enter_Type",
"nickName": "Enter_Nickname",
"bankCode": Enter_OSV_Bank_Code_Identifier,
"accountNum": "Enter_Bank_Account_Number",
"name": "Enter_Bank_Account_Name",
"iban": "Enter_International_Bank_Account_Number",
"currency": "Enter_Currency",
"benERPcode": "Enter_Unique_ERP_Beneficiary_Code",
"description": "Enter_Description",
"country": "Enter_Country",
"supplierCode": "Enter_Unique_ERP_Supplier_Code",
"isPrimary": Enter_True/False
},
{
"type": "Enter_Type",
"nickName": "Enter_Nickname",
"bankCode": Enter_OSV_Bank_Code_Identifier,
"accountNum": "Enter_Bank_Account_Number",
"name": "Enter_Bank_Account_Name",
"iban": "Enter_International_Bank_Account_Number",
"currency": "Enter_Currency",
"benERPcode": "Enter_Unique_ERP_Beneficiary_Code",
"description": "Enter_Description",
"country": "Enter_Country",
"supplierCode": "Enter_Unique_ERP_Supplier_Code",
"isPrimary": Enter_True/False
}
]
}
]
}
}'
Request details:
JSON Tag | Description | Data type |
---|---|---|
clientid Mandatory | Client ID | String |
clientsecret Mandatory | Client Code | String |
signature Mandatory | Signature | String |
svAccServiceRQ Mandatory | Add Own Bank Accounts and Beneficiaries request tag | Object |
groupCode Specific Mandatory | Unique Group Code | String |
userName Mandatory | SingleView's account username | String |
account Specific Mandatory | Array of accounts | Array |
bankCode Mandatory | SingleView Unique bank code identifier | String |
acERPCode Mandatory | Unique code for bank accounts as per ERP | String |
accountNum Mandatory | Bank account number | String |
corpID Mandatory | Corporate identification code as per bank records of the debit account | String |
holderName Mandatory | Registered account name | String |
iban optional | International Bank Account Number | String |
address optional | Bank Account Address | String |
currency Mandatory | Default currency in ISO format | String |
beneficiary Specific Mandatory | Array of beneficiaries | Array |
benERPCode Mandatory | Unique beneficiary code as per ERP | String |
type Mandatory | Type of beneficiary; International or local | String |
nickName Optional | Nickname of the beneficiary | String |
bankCode Mandatory | Unique SingleView bank code identifier | String |
corpId Conditional | Corporate identification code as per bank records of the payee Required only for company accounts (payee) | String |
name Mandatory | Registered name in bank account | String |
iban Mandatory | International Bank Account Number/Beneficiary bank account number | String |
currency Mandatory | Beneficiary bank account currency in ISO format | String |
address Specific Mandatory | Beneficiary Bank Account Address in case of type = "International" | String |
swiftCode Specific Mandatory | Beneficiary Bank Account SWIFT code in case of type = "International" | String |
description Optional | Description of the beneficiary | String |
country Optional | Bank account country | String |
supplierCode Mandatory | Unique supplier code for beneficiary | String |
isPrimary Optional | Set true if is a primary account for beneficiary | Boolean |
Successful response
{
"svAccServiceRS": {
"groupCode": "Group_Code",
"company": [
{
"companyCode": "Company_Code",
"userName" : "Username",
"account": [
{
"acERPcode": "Account_ERP_Code",
"status": Status_Code,
"message": "Process/Status_Message"
},
{
"acERPcode": "Account_ERP_Code",
"status": Status_Code,
"message": "Process/Status_Message",
"errorCode": "Error_Code"
}
],
"beneficiary": [
{
"benERPcode": "Beneficiary_ERP_Code",
"status": Status_Code,
"message": "Process/Status_Message"
},
{
"benERPcode": "Beneficiary_ERP_Code",
"status": Status_Code,
"message": "Process/Status_Message",
"errorCode": "Error_Code"
}
]
}
]
}
}
JSON Tag | Description | Data type |
---|---|---|
svAccServiceRS | Add account services Response Tag | Object |
groupCode | Unique group code | String |
company | Array of companies | Array |
companyCode | Unique company code | String |
userName | SingleView Account's username | String |
account | Array of accounts | Array |
accERPCode | Account ERP Code | String |
status | Status code | Numerical |
code | Unique company code | String |
message | Process display message | String |
errorCode | Error code | String |
Updated about 2 months ago