|
1 | 1 | --- |
2 | | -title: Playroll Integration |
| 2 | +title: Playroll |
3 | 3 | description: Learn how to connect Expensify with Playroll to automatically sync approved expenses for HR and EOR processing. |
4 | 4 | keywords: [Expensify Classic, Playroll, HR, EOR, expense sync, integration, payroll] |
5 | | -internalScope: Audience is Workspace Admins and Workspace Owners. Covers connecting Expensify Classic to Playroll for one-way expense syncing. Does not cover Playroll configuration beyond the Expensify integration. |
| 5 | +internalScope: Audience is Workspace Admins and Workspace Owners. Covers connecting to Playroll for one-way expense syncing. Does not cover Playroll configuration beyond the Expensify integration. |
6 | 6 | --- |
7 | 7 |
|
| 8 | +# Playroll |
8 | 9 |
|
9 | 10 | The Expensify-Playroll integration allows approved expenses in Expensify to automatically sync into Playroll for processing. This is a one-way integration (Expensify to Playroll only) — changes made after syncing will not sync back. |
10 | 11 |
|
11 | 12 | **Important:** Only approved expenses will sync, and expenses without receipts will not sync to Playroll. |
12 | 13 |
|
13 | 14 | --- |
| 15 | + |
14 | 16 | ## Who can connect Expensify to Playroll |
15 | | -# Prerequisites |
16 | 17 |
|
17 | | -Before setting up the integration, ensure the following: |
| 18 | +You can connect Expensify to Playroll if: |
| 19 | + |
| 20 | +- You are a Workspace Admin or Workspace Owner |
| 21 | +- You have permission to configure integrations in Playroll |
| 22 | +- You are signed into the Expensify account that owns or administers the workspace |
18 | 23 |
|
19 | | -- You are a **Workspace Admin** or **Workspace Owner** in Expensify |
20 | | -- You have Playroll integration permissions |
21 | | -- You are logged into the same Expensify account that owns or administers the workspace |
22 | | -- You can access Expensify Classic |
| 24 | +This feature is not available on mobile. |
23 | 25 |
|
24 | 26 | --- |
25 | 27 |
|
26 | 28 | ## How to connect Expensify to Playroll |
27 | 29 |
|
28 | | -## Step 1: Switch to Expensify Classic |
29 | | - |
30 | | -1. Log into Expensify. |
31 | | -2. Click your account logo. |
32 | | -3. Select **Troubleshoot**. |
33 | | -4. Click **Switch to Expensify Classic**. |
| 30 | +Before connecting Playroll, configure the required workspace settings in Expensify. |
34 | 31 |
|
35 | | -## Step 2: Enable Public Receipt Visibility |
36 | | - |
37 | | -1. Go to **Settings > Workspaces**. |
38 | | -2. Select the workspace you want to connect. |
| 32 | +1. In the navigation tabs on the left, go to **Settings > Workspaces**. |
| 33 | +2. Select your workspace. |
39 | 34 | 3. Go to **Rules**. |
40 | 35 | 4. Enable **Public Receipt Visibility**. |
| 36 | +5. Set **Receipt Required Amount** to **$0**. |
| 37 | +6. Save your changes. |
| 38 | + |
| 39 | +Then connect the integration in Playroll. |
41 | 40 |
|
42 | | -{% include info.html %} |
43 | | -If Public Receipt Visibility is not enabled, expenses will not sync to Playroll. |
44 | | -{% include end-info.html %} |
| 41 | +1. In Playroll, go to **Dashboard > Tools > Integrations**. |
| 42 | +2. Select **Expensify**. |
| 43 | +3. Open the **Configuration** tab. |
| 44 | +4. Click **Connect**. |
| 45 | +5. In Expensify, click **Find our Partner ID**. |
| 46 | +6. Copy the **Partner User ID** and **Partner User Secret**. |
| 47 | +7. Paste the credentials into Playroll. |
| 48 | +8. Click **Submit**. |
45 | 49 |
|
46 | | -## Step 3: Set Receipt Required Amount to $0 |
| 50 | +After the integration connects successfully, Playroll displays the status as **Active / Connected**. |
47 | 51 |
|
48 | | -1. In the **Rules** section, locate **Receipt Required Amount**. |
49 | | -2. Set the value to **$0**. |
50 | | -3. Save your changes. |
| 52 | +Employee email addresses in Expensify must match the Personal Email addresses in Playroll. |
51 | 53 |
|
52 | | -{% include info.html %} |
53 | | -Expenses without receipts do not sync to Playroll. Setting this to $0 ensures all expenses have receipts attached. |
54 | | -{% include end-info.html %} |
| 54 | +--- |
55 | 55 |
|
56 | | -## Step 4: Confirm Workspace Permissions |
| 56 | +## What happens after you connect Expensify to Playroll |
57 | 57 |
|
58 | | -Verify that the user configuring the integration is a **Workspace Admin** or **Workspace Owner**. |
| 58 | +After the integration is connected: |
59 | 59 |
|
60 | | -## Step 5: Connect Expensify to Playroll |
| 60 | +- Approved expenses automatically sync from Expensify to Playroll |
| 61 | +- Expenses without attached receipts do not sync |
| 62 | +- Changes made after syncing do not sync back into Expensify |
| 63 | +- Expense category mappings in Playroll determine how synced expenses appear in Playroll |
61 | 64 |
|
62 | | -1. In Playroll, go to **Dashboard**. |
63 | | -2. Click **Tools > Integrations**. |
64 | | -3. Select **Expensify**. |
65 | | -4. Open the **Configuration** tab. |
66 | | -5. Click **Connect**. |
67 | | -6. You will need your **Partner User ID** and **Partner User Secret**. To get these credentials: |
68 | | - - While logged into Expensify, click **Find our Partner ID**. |
69 | | - - Copy your **Partner User ID** and **Partner User Secret**. |
70 | | - - Paste them into Playroll. |
71 | | - - Click **Submit**. |
| 65 | +--- |
72 | 66 |
|
73 | | -A successful setup will display **Active / Connected**. |
| 67 | +# FAQ |
74 | 68 |
|
75 | | -## Step 6: Map Expense Categories |
| 69 | +## Why are expenses not syncing to Playroll? |
76 | 70 |
|
77 | | -1. Open the Expensify integration page in Playroll. |
78 | | -2. Go to **Expense Categories**. |
79 | | -3. Click **Map Categories**. |
80 | | -4. Match your Expensify categories to the corresponding Playroll categories. |
81 | | -5. Save your mappings. |
| 71 | +Expenses may not sync if: |
82 | 72 |
|
83 | | -For example: |
84 | | -- Expensify "Car" → Playroll "Car Rental" |
85 | | -- Expensify "Equipment" → Playroll "Equipment" |
| 73 | +- The expense is not approved |
| 74 | +- The expense does not include a receipt |
| 75 | +- **Public Receipt Visibility** is disabled |
| 76 | +- Employee email addresses do not match between Expensify and Playroll |
| 77 | +- Expense categories are not mapped in Playroll |
86 | 78 |
|
87 | | -{% include info.html %} |
88 | | -Employee email addresses in Expensify must match Personal Emails in Playroll for expenses to sync correctly. |
89 | | -## How to verify the Playroll integration is set up correctly |
| 79 | +## Can members connect Expensify to Playroll? |
90 | 80 |
|
91 | | ---- |
| 81 | +No. Only Workspace Admins and Workspace Owners can configure the integration. |
| 82 | + |
| 83 | +## Does the Playroll integration sync changes back into Expensify? |
| 84 | + |
| 85 | +No. The integration only syncs expenses from Expensify to Playroll. |
92 | 86 |
|
93 | | -# Completion Checklist |
| 87 | +## Can I connect Expensify to Playroll on mobile? |
94 | 88 |
|
95 | | -- [ ] Public Receipt Visibility enabled |
96 | | -- [ ] Receipt Required Amount set to $0 |
97 | | -- [ ] Correct workspace permissions confirmed |
98 | | -- [ ] Expensify connected to Playroll (showing "Active / Connected") |
99 | | -- [ ] Expense categories mapped and saved |
| 89 | +No. This feature is not available on mobile. |
0 commit comments