Process a Payroll
Make payroll payments using SingleView APIs
Overview
Payroll payments can be processed through SingleView APIs and require the following details to be enclosed in the payment processing request:
Mandatory information
- The user must provide the valid credentials in the header
- Valid
clientid,clientsecret, andsignature- The request should be in the specified format
- The request should include all the mandatory details with appropriate request tags
Process a Payroll
Endpoint details
Endpoint URL | Method | Grant type |
|---|---|---|
| POST | 1/. |
Initiate Payroll Payments
Note: A minimum of 3 payment entries are required to process a payroll request.
Sample request
curl --location --request POST 'https://servicesuat.onesingleview.com/v1/api/erp/svPayrollService' \
--header 'clientid: Enter_Client_ID' \
--header 'clientsecret: Enter_Client_Secret' \
--header 'signature: Enter_Signature' \
--header 'Content-Type: application/json' \
--data-raw '{
"svPayrollServiceRQ": {
"company": [
{
"companyCode": "Enter_Company_Code",
"payroll": [
{
"acERPcode": "Enter_Account_ERP_Code",
"amount": "Enter_Amount",
"currency": "Enter_Currency",
"description": "Enter_Description",
"dueDate": "YYYY-MM-DD",
"userName": "Enter_Username",
"payrollPayId":"Enter_Payroll_Payment_ID",
"payeeDetails": [
{
"bankCode": "Enter_Bank_Code",
"iban": "Enter_IBAN",
"name": "Enter_Name",
"payeeId": "Enter_Payee_ID",
"nationalId": "Enter_National_ID",
"basicSalary": "Enter_Basic_Salary",
"housingAllowance": "Enter_Housing_Allowance",
"otherAllowance": "Enter_Other_Allowance",
"deduction": "Enter_Deduction",
"amount": "Enter_Amount",
"currency": "Enter_Currency",
"remarks": "Enter_Remarks"
},
{
"bankCode": "Enter_Bank_Code",
"iban": "Enter_IBAN",
"name": "Enter_Name",
"payeeId": "Enter_Payee_ID",
"nationalId": "Enter_National_ID",
"basicSalary": "Enter_Basic_Salary",
"housingAllowance": "Enter_Housing_Allowance",
"otherAllowance": "Enter_Other_Allowance",
"deduction": "Enter_Deduction",
"amount": "Enter_Amount",
"currency": "Enter_Currency",
"remarks": "Enter_Remarks"
},
{
"bankCode": "Enter_Bank_Code",
"iban": "Enter_IBAN",
"name": "Enter_Name",
"payeeId": "Enter_Payee_ID",
"nationalId": "Enter_National_ID",
"basicSalary": "Enter_Basic_Salary",
"housingAllowance": "Enter_Housing_Allowance",
"otherAllowance": "Enter_Other_Allowance",
"deduction": "Enter_Deduction",
"amount": "Enter_Amount",
"currency": "Enter_Currency",
"remarks": "Enter_Remarks"
}
]
}
]
}
]
}
}'Request description
JSON Tag | Description | Data Type |
|---|---|---|
clientid Mandatory | Unique client identification details
| String |
clientsecret | Unique client identification secret code
| String |
signature | 64-Bit string obtained by processing client signature key through Base-64 and SHA-256 | String |
svPayrollServiceRQ | Tag carrying information on request to process a payroll | Object |
company | Tag carrying information about the company | Object |
companyCode | Unique company identification code
| Numerical |
payroll | Tag carrying information on payroll details in the request | Object |
acERPcode | Unique account ERP identification code
| Numerical |
amount | Total amount of the payroll | Numerical |
currency | Currency representing the payroll amount | String |
description | Description of the payroll
| String |
dueDate | Due date for processing the payroll in | Date |
userName | Unique user identification details
| String |
payrollPayId | Unique payroll payment identification
| String |
payeeDetails | Tag carrying information of payees included in the payroll request | Object |
bankCode | Unique bank identification code
| Stringt |
iban | Unique international bank account number | String |
name | Name of the payee
| String |
payeeId | Unique employee code or payee code identification
| String |
nationalId | Unique national identification details of the payee | String |
basicSalary | Basic salary amount of the payee | Numerical |
housingAllowance | Housing allowance amount of the payee | Numerical |
otherAllowance | Other allowance amount of the payee | Numerical |
deduction | Total deduction amount of the payee | Numerical |
amount | Total amount for the payee | Numerical |
currency | Currency representing the payee amount | String |
remarks | Remarks for payment to the payee
| String |
Sample response
{
"svPayrollServiceRS": {
"company": [
{
"companyCode": "Company_Code",
"payroll": [
{
"acERPcode": "Account_ERP_Code",
"payrollPayId":"Payroll_Payment_ID",
"authId":"Authentication_ID",
"status": 0,
"message": "Status_Message",
"payeeDetails": [
{
"bankCode": "Bank_Code",
"payeeId": "Payee_ID"
},
{
"bankCode": "Bank_Code",
"payeeId": "Payee_ID"
},
{
"bankCode": "Bank_Code",
"payeeId": "Payee_ID"
}
]
}
]
}
]
}
}Response description
| JSON Tag | Description | Data Type |
|---|---|---|
| svPayrollServiceRS | Tag carrying information on process response for payroll processing request | Object |
| company | Tag carrying information on company | Object |
| companyCode | Unique company identification code | Numerical |
| payroll | Tag carrying information on payroll payments in the response | Object |
| acERPcode | Unique ERP account code | Numerical |
| payrollPayId | Unique payroll payment identification details | String |
| authId | Unique authentication identification details | String |
| status | Status code of the response | Boolean |
| message | Status message description | String |
| payeeDetails | Tag carrying information on payee payment details in the response | Object |
| bankCode | Unique bank code identification | String |
| payeeId | Unique payee/employee identification | String |
Updated 4 days ago