Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Note

Please ensure to contact Readysell - Greg Payne   before you commence with the set up of Keypay

Four steps needs to be completed before you can commence with Keypay:

1. Sign up for the Keypay which is part of the white label by clicking on the link  https://readysell.com.au/product/payroll/
2. API Key to be registered into your Readysell
3. Business ID to be registered into Readysell
4. ATO Settings for ABA File to be set up in Keypay
5. Super Clearing House to be set up in Keypay

Log on as the username and password for that site.



Info

Questions that may arise from being unable to import the key pay journal into Readysell.


If your question/s are about a problem you’re having, please help us diagnose the API issue by providing them with:


- API Endpoint and HTTP Method that you are calling (eg: POST /API/v2/business/1234) eg the Business ID
  Method https://readysell.yourpayroll.com.au/api/v2/????? (is the business ID number for that site)

- JSON Request that you are sending
  Readysell cannot see the JSON request or response as we are using KeyPayApiV2Client Library

- JSON Response/message that you are receiving
   Error message when trying to import key pay into readysell bank payment
   EG
   Unable to retrieve pay runs. KeyPayApiClient.Exceptions.TokenExpiredException: Unauthorized at KeyPayApiClient.KeyPayApi.HandleResponse(IRestResponse resp) at RestSharp.RestClient.Deserialize[T](IRestRequest request, IRestResponse raw) at            RestSharp.RestClient.Execute[T](IRestRequest request) at KeyPayApiClient.KeyPayApi.Execute[T](RestRequest request) at Readysell.Module.Win.Controllers.Bankings.WinBankPaymentController.ImportPayrollFromKeyPay(SimpleActionExecuteEventArgs e, BankPayment bankPayment, String keyPayApiKey)


- KeyPay Username associated with the API Key you are using to send the request

  API key from within either Readysell>system type>Payroll>API or get the API from keypay under My Accounts 
  You need to be logged in as the user.


Note

If you wish to break up expenses and liabilities further you need to ensure that the general ledger accounts have been set up in Readysell firstly before you continue with Advanced Configurations.

Refer link Creating/ Modifying a general ledger account

Overview

Readysell Payroll is powered by KeyPay, an online payroll system designed to make payroll simpler for small to medium businesses.
KeyPay is quick to set up, intuitive and easy to use and integrated into your Readysell system.
You can learn more about the features of Readysell Payroll at our web site. https://readysell.com.au/product/payroll/
You need to sign up first by clicking on the link above and taking it from there.

Before you can use the payroll import feature, you must ensure that you've set up the integration in Readysell. Follow these steps to set up Readysell appropriately.
Payroll

So far every dealer has been able to setup keypay without any help from Readysell, just using the documentation. But you can always book a few hours of assistance from our implementation team if you want us to do the setup work for you.

Procedure

Standard configuration
API Key & Business ID setup

This is the recommended configuration for most Readysell customers. Payroll data is automatically mapped to Readysell general ledger accounts based on pre-defined rules.

  1. In Readysell, navigate to Log onto Readysell>Payroll
  2. Log in using your payroll username and password At the top right, (sites) wait for verification code
  3. Obtaining your API Key

    To obtain your API key, log into KeyPay and click your name in the top right corner, then click My Account

    Copy the "API Key" to your clipboard

    .

    Image Added

    Click Generate API Key and a key will be generated for you.

    Image Added

    Your key will now be generated. Double click the text and copy it. Store this key somewhere safe. Please note that clicking Change API Key will invalidate your old API key.

    Image Added

  4. Log into Readysell to set your API Key
  5. Navigate to Administration > Advanced > System TypesSelect the "PAYROLL" system typeTypes>PAYROLL
  6. Paste the API Key from your clipboard into the Value field of the "KEYPAY-API-KEY" system reference and click on Save

    Expand
    titleShow me

    Click on Save

  7. Switch back to the Payroll tabUnder Related Businesses right click your business' name and click Properties
    Expand
    titleShow me

    Image Removed

    Dashboard/Company name
  8. On the top URL bar you will see https://readysell.yourpayroll.com.au/business/111111/businessdetails (EG)
    Note the number at the end of the Address (URL) 

  9. Click Cancel
  10. Switch back to the System Types tab within Readysell
  11. Enter the number you noted into the Value field of the "KEYPAY-BUSINESS-ID" system reference and click on SaveGo back into Readysell and paste this number into the VALUE field in Readysell>Administration > Advanced > System Types>PAYROLL>keypay-business-id


    Image Removed
    Expand
    titleShow me
    Business ID

    Image Added

    Click on Save

  12. If you have tweaked your Readysell chart of accounts (that is changed the accountid within the chart), modify the account IDs as necessary in the system reference to reflect your accountid from the chart and leave the system reference for 'use-keypay-journal' with a value = False
  13. Click Save

...

  1. In Readysell, navigate to Payroll
  2. Log in using your payroll username and password
  3. At the top right, click your name, then My Account
  4. Copy the "API Key" to your clipboard
  5. Navigate to Administration > Advanced > System Types
  6. Select the "PAYROLL" system type
  7. Paste the API Key from your clipboard into the value field of the "KEYPAY-API-KEY" system reference
  8. Set the value field of the "USE-KEYPAY-JOURNAL" system reference to "True"
  9. Switch back to the Payroll tab
  10. Under Related Businesses right click your business' name and click Properties
  11. Note the number at the end of the Address (URL)
  12. Click Cancel
  13. Switch back to the System Types tab
  14. Enter the number you noted into the value field of the "KEYPAY-BUSINESS-ID" system reference
  15. Click Save
  16. Create any general ledger accounts you require to facilitate your payroll configuration (see Creating/ Modifying a general ledger account)
  17. Switch back to the Payroll tab
  18. Click Business > Select Company Name
  19. Click Business >Payroll Settings
  20. Under Business Settings click Chart Of Accounts

     


    Click On Manual
    Expand
    titleShow Me

    Image Removed

  21. You have the option to Import the Accounts from a Journal or click on Manual
  22. Image Added


  23. Click On Manage Accounts and start inserting the general ledger accounts breakup for each pay category
  24. Start Adding the First GL Account,  Description, Type of Account for each Pay Category you are breaking up. Eg below

    Expand
    titleShow me

    Image Added


  25. Add each of the relevant accounts to the list eg Bank, Payg Liability, Payg Expense, Super Liability and Expense, Salary Sacrifice (if you use it), Car allowances if you use it etc.
  26. Click Back to Chart of Accounts
  27. Expand Default Accounts, Pay CategoriesDeduction Categories and Deduction Expense Categories and set up your account mappings add any appropriate categories (see Mapping GL accounts)
  28. Click Save on each
    Once the Categories have been set up, if you wish to see the categories against a different general ledger account, you need to go to each category and apply the specific general ledger account.

  29. Go back to Readysell as when you import the keypay journal into Readysell, you will need to use the general ledger accounts on the journal.
    Click on System Types in Administration
    Type = Payroll
    Code = use-keypay-journal

    Set this to be True 
    Click on Save

ABA File Setup

  1. Log onto Keypay
    Select Payroll settings
  2. Select Payment file
    Add your aba file settings
    Click on Save
  3. Next click on ATO Settings from within Payroll settings
    Insert your ATO Supplier settings
    Click on Save

Expand
titleShow me ABA File
Image Added

Registering for Automated Super Payments

KeyPay has the ability to pay employee super contributions directly to any registered super fund in Australia by integrating with the Beam super fund clearing house (https://beamconnect.com.au).

Automated super payments are available for all users and quarterly super processing is included at no additional cost.If you wish to process super at more regular intervals, there is an additional 25c per employee per batch submission.

To register for Beam:

  • log into your business in KeyPay, click the Business menu, then Super Payments
Expand

Image Added

  • Click the ‘Register for Beam’ button on the page
Expand

Image Added

  • Read the PDS on the Beam registration page, accept the terms and conditions and click “Submit”
  • Complete the registration details on the registration page and click “submit”

Once you’ve registered you can make automated super payments by following  these instructions.

If you would like any more information on automated super payments within KeyPay, please contact us via support@yourpayroll.com.au