Write Deduction, Earning & Tax

this guide provides a step by step walkthrough on how to add earnings in adp using bindbee write apis pre requisites paragraph{liststyletype="disc" indent="1"} already have a connector in bindbee with payroll write permissions have a user with permission to view employee's employment information and payroll information in adp dashboard \ step 1 open the connector which has adp payroll write permissions in bindbee step 2 make sure that the data has been synced now we need to get the id of the employee for which we want to add earnings to get that go to bindbee api documentation https //docs bindbee dev/hris/employee/get employees step 3 select the get employee api to authenticate and authorise a request, we need bindbee api key and x connector token you can get the api key from the api key section of bindbee dashboard make sure to add it in the headers in this format headers { "authorization" "bearer "} step 4 copy the connector token for the connector you want to write the data in step 5 paste the x connector token in the headers of the api as follows headers {'x connector token' } step 6 click on send step 7 this will return the employee data copy the id of the employee for which you want to write the payroll earnings step 8 now that we have employee id, click on create employee payroll run api step 9 create a postman or any other preferred tool of your choice request with the create employee endpoint make sure that the request method is post copy the authorisation and x connector token headers from the previous request into this request for the request body, use this body { "employee" "01929ee7 20ac 7100 9c84 d89838e8f3f1", "earnings" \[ { "code" "bn", "amount" 0 01 }, { "code" "r", "amount" 0 02 } ], "payroll file" "000169", "payroll process name" "hours, earning code" } step 10 add the employee id we had copied from the above step here next we will need payroll file information to get that open the adp dashboard and go to people section step 11 then go to employment profile step 12 in the position card you can get the payroll file number copy it and paste it in the request body step 13 now add the appropriate payroll action name step 14 add appropriate earnings details here two json objects have been added with code bn representing bonus and r representing regular earnings, each of them with $0 3 then make the request step 15 to verify that earnings have been added, go to adp dashboard and open the process tab step 16 open payroll dashboard step 17 open manage payroll step 18 find the earnings name that we just created and verify the earnings