Versions Compared

Key

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

...

To enable the integration, it’s necessary to create a Connection (authentication) and Webhooks in Tātou. Please follow the next steps to set them up correctly.

Before you start

  1. Make sure you have a Xero account with Payroll permission;

  2. Make sure you have Administrator permission in Tātou;

  3. If not enabled yet, ask Tātou team to enable the RESTful API to your account;

  4. If you already have employees in Tātou, make sure the First name, Last name, and e-mail are identical in both Tātou and Xero.

Setting a new connection with Xero

Xero uses OAuth 2.0 as the authentication method. To connect both systems, you need to create a new Connection in Tātou.

...

  • After a successful connection, you should be able to see the “Connected” status:

...

Webhook configuration

This integration requires two webhooks to be set. To know more about how Tātou webhooks work, please click here.

Employee webhook

Webhook configuration:

Field

Value

Name

Xero - Employees Sync

Description

Sync employees from Xero to Tātou twice a day

URL

https://integrations-tatou.app/production/xero-au/employees

Connection

Use the previous connection created (Xero)

Request params

tatou_token = <your Tātou restful api token>

Trigger type

Schedule

This is how it should look:

...

Pay period webhook

Webhook configuration:

Field

Value

Name

Xero - Pay period

Description

Submit pay period to Xero, creating a Pay run and Payslip earning lines

URL

https://integrations-tatou.app/production/xero-au/pay-period

Connection

Use the previous connection created (Xero)

Request params

tatou_token = <your Tātou restful api token>

Trigger type

Event

Event subscription

Pay Period - Send

This is how it should look:

...

Filter by label (Content by label)
showLabelsfalse
max5
spacescom.atlassian.confluence.content.render.xhtml.model.resource.identifiers.SpaceResourceIdentifier@957
sortmodified
showSpacefalse
reversetrue
typepage
cqllabel = "kb-how-to-article" and type = "page" and space = "KB"
labelskb-how-to-article