From b7aedb30f3409b31c969589cc5b1f16354e2ee05 Mon Sep 17 00:00:00 2001
From: Victoria O'Leary <54568958+VictoriaExpensify@users.noreply.github.com>
Date: Fri, 9 Aug 2024 16:54:09 +1000
Subject: [PATCH] Create Xero-Troubleshooting

New article for troubleshooting Xero issues - see related issue https://github.com/Expensify/Expensify/issues/413228
---
 .../connections/xero/Xero-Troubleshooting     | 37 +++++++++++++++++++
 1 file changed, 37 insertions(+)
 create mode 100644 docs/articles/new-expensify/connections/xero/Xero-Troubleshooting

diff --git a/docs/articles/new-expensify/connections/xero/Xero-Troubleshooting b/docs/articles/new-expensify/connections/xero/Xero-Troubleshooting
new file mode 100644
index 000000000000..0c69493f3935
--- /dev/null
+++ b/docs/articles/new-expensify/connections/xero/Xero-Troubleshooting
@@ -0,0 +1,37 @@
+---
+title: Xero Troubleshooting
+description: A list of common Xero errors and how to resolve them
+---
+
+## Report won’t automatically export to Xero
+
+If an error occurs during an automatic export to Xero:
+ 
+- You’ll receive an email detailing the error. 
+- The error will appear in the related Workspace Chat, indicated by a red dot next to the report. 
+- For auto-sync errors, a message will be posted in the related #admins room. The message contains a link to the workspace’s accounting settings where an explanation for the error appears next to the connection.
+
+An error on a report will prevent it from automatically exporting. 
+
+## How to resolve
+
+Open the expense and make the required changes. Then an admin must manually export the report to Xero by clicking the heading at the top of the expense and selecting Export. Then they’ll select Xero. 
+
+![Insert alt text for accessibility here]({{site.url}}/assets/images/Xero_help_02.png){:width="100%"}
+
+![Insert alt text for accessibility here]({{site.url}}/assets/images/Xero_help_03.png){:width="100%"}
+
+## Unable to manually export a report
+
+To export a report, it must be in the Approved, Closed, or Reimbursed state. If it is in the Open state, clicking Export will lead to a notification that the data is not yet available for export. 
+
+![Insert alt text for accessibility here]({{site.url}}/assets/images/Xero_help_04.png){:width="100%"}
+
+## How to resolve
+
+Open the report and make the required changes:
+
+- If the report is in the Open status, ensure that it is submitted.
+- If the report is in the Processing status, an admin or approver will need to approve it.
+
+Once complete, an admin must manually export the report to Xero by clicking the heading at the top of the expense and selecting Export. Then they’ll select Xero.