-
Notifications
You must be signed in to change notification settings - Fork 3k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge branch 'Expensify:main' into fix-51888-cors-errors-are-displaye…
…d-for-attachments
- Loading branch information
Showing
178 changed files
with
2,272 additions
and
5,022 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Submodule Mobile-Expensify
updated
from ea3433 to f370c5
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -11,50 +11,50 @@ To begin, review our [Integration Server Manual](https://integrations.expensify. | |
|
||
We've compiled answers to some frequently asked questions to help you get started. | ||
|
||
**Should I give your support team my API credentials when I need help?** | ||
## Should I give your support team my API credentials when I need help? | ||
|
||
If you’re seeking help with Expensify's API, do not share your partnerUserSecret. If you do, immediately rotate your credentials on [this page](https://www.expensify.com/tools/integrations/). | ||
|
||
**Is there a rate limit?** | ||
## Is there a rate limit? | ||
|
||
To keep our platform stable and handle high traffic, Expensify limits how many API requests you can send: | ||
- Up to 5 requests every 10 seconds | ||
- Up to 20 requests every 60 seconds | ||
|
||
Sending more requests than allowed may result in an error with status code `429`. | ||
|
||
**What is a Policy ID?** | ||
## What is a Policy ID? | ||
|
||
This is also known as a Workspace ID. To find your Policy/Workspace ID, | ||
Hover over Settings and click Workspaces. | ||
Click the name of the Workspace. | ||
Copy the ID number from the URL. For example, if the URL is https://www.expensify.com/policy?param={"policyID":"0810E551A5F2A9C2”}, then your workspace ID is 0810E551A5F2A9C2. | ||
|
||
**Can I use the parent type `file` to export workspace/policy data?** | ||
## Can I use the parent type `file` to export workspace/policy data? | ||
|
||
No. The parent type `file` can only be used to export expense and report data — not policy information. To export policy data (e.g., categories, tags), you must use the `get` type with `inputSettings.type` set to `policy`. | ||
|
||
**Can I use the API to create Domain Groups?** | ||
## Can I use the API to create Domain Groups? | ||
|
||
No, you cannot create domain groups. You can only assign users to them. | ||
|
||
**I’m exporting expense IDs `${expense.transactionID}` but when I open my CSV in Excel, it’s changing all the IDs and making them look the same. How can I prevent this?** | ||
## I’m exporting expense IDs `${expense.transactionID}` but when I open my CSV in Excel, it’s changing all the IDs and making them look the same. How can I prevent this? | ||
|
||
Try prepending a non-numeric character like a quote to force Excel to interpret the value as a string and not a number (i.e., `'${expense.transactionID}`). | ||
|
||
**How can we export the person who will approve a report while the reports are still processing?** | ||
## How can we export the person who will approve a report while the reports are still processing? | ||
|
||
Use the field ${report.managerEmail}. | ||
|
||
**Why won’t my boolean field return any data?** | ||
## Why won’t my boolean field return any data? | ||
|
||
Boolean fields won't output values without a string. For example, instead of using `${expense.billable}`, use `${expense.billable?string("Yes", "No")}`. This will display "Yes" if the expense is billable and "No" if it is not. | ||
|
||
**Can I export the reports for just one user?** | ||
## Can I export the reports for just one user? | ||
|
||
Not in a quick convenient way, as you would need to include the user in your template. The simplest approach is to export data for all users and then apply a filter in your preferred spreadsheet program. | ||
|
||
**Can I create expenses on behalf of users?** | ||
## Can I create expenses on behalf of users? | ||
|
||
Yes. However, to access the Expense Creator API on behalf of employees, Expensify needs to verify the following setup: | ||
|
||
|
@@ -63,17 +63,17 @@ Verify you have internal authorization to add data to other accounts within your | |
|
||
If you need this access, contact [email protected] and reference this help page. | ||
|
||
## Using Postman | ||
# Using Postman | ||
|
||
Many customers use Postman to help them build out their APIs. Below are some guides contributed by our customers. Please note, in all cases, you will need to first generate your authentication credentials, the steps for which can be found [here](https://integrations.expensify.com/Integration-Server/doc/#introduction) and have them ready: | ||
|
||
### Download expenses from a report as a CSV file | ||
## Download expenses from a report as a CSV file | ||
|
||
**Step 1: Get the ID of a report you want to export in Expensify** | ||
|
||
Find the ID by opening the expense report and clicking Details at the top right corner of the page. At the top of the menu, the ID is provided as the “Long ID.” | ||
|
||
**Step 3: Export (generate) a "Report" as a CSV file** | ||
**Step 2: Export (generate) a "Report" as a CSV file** | ||
{% include info.html %} | ||
For this you'll use the Documentation under [Report Exporter](https://integrations.expensify.com/Integration-Server/doc/#export). | ||
{% include end-info.html %} | ||
|
@@ -146,11 +146,11 @@ The template key will have the value like below: | |
|
||
The template variable determines what information is saved in your CSV file. If you want more columns than merchant, amount, and transaction date, follow the syntax as defined in the export template format documentation. | ||
|
||
**Step 4: Save your generated file name** | ||
**Step 3: Save your generated file name** | ||
|
||
Expensify currently supports only the "onReceive":{"immediateResponse":["returnRandomFileName"]} option in step 3, so you should receive a random filename back from the API like "exportc111111d-a1a1-a1a1-a1a1-d1111111f.csv". You will need to document this filename if you plan on running the download command after this one. | ||
Expensify currently supports only the "onReceive":{"immediateResponse":["returnRandomFileName"]} option in step 2, so you should receive a random filename back from the API like "exportc111111d-a1a1-a1a1-a1a1-d1111111f.csv". You will need to document this filename if you plan on running the download command after this one. | ||
|
||
**Step 5: Download your exported report** | ||
**Step 4: Download your exported report** | ||
|
||
Set up another API call in almost the same way you did before. You don't need the template key in the Body anymore, so delete that and set the Body type to "none". Then modify your requestJobDescription to read like below, but with your own credentials and file name: | ||
|
||
|
@@ -170,7 +170,7 @@ Click Go and you should see the CSV in the response body. | |
|
||
*Thank you to our customer Frederico Pettinella who originally wrote and shared this guide.* | ||
|
||
### Use Advanced Employee Updater API with Postman | ||
## Use Advanced Employee Updater API with Postman | ||
|
||
1. Create a new request. | ||
2. Select POST as the method. | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -51,6 +51,11 @@ When an expense is submitted to a workspace, your approver will receive an email | |
|
||
{% include end-selector.html %} | ||
|
||
![Click Global Create]({{site.url}}/assets/images/ExpensifyHelp-CreateExpense-1.png){:width="100%"} | ||
![Click Submit expense]({{site.url}}/assets/images/ExpensifyHelp-CreateExpense-2.png){:width="100%"} | ||
![Click Scan]({{site.url}}/assets/images/ExpensifyHelp-CreateExpense-3.png){:width="100%"} | ||
![Enter workspace or individual's name]({{site.url}}/assets/images/ExpensifyHelp-CreateExpense-4.png){:width="100%"} | ||
|
||
{% include info.html %} | ||
You can also forward receipts to [email protected] using your primary or secondary email address. SmartScan will automatically extract all the details from the receipt and add them to your expenses. | ||
{% include end-info.html %} | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.