Integrations/Xero - Revision history

Scarpenter at 03:21, 14 May 2018

2018-05-14T03:21:16Z

Scarpenter: Replaced content with "=This Content Has Moved House= This article has been moved to our new home for documentation and help content, the new Emersion Knowledge Base. We are sorry for the unti..."

2018-05-14T03:20:53Z

Replaced content with "=This Content Has Moved House= This article has been moved to our new home for documentation and help content, the new Emersion Knowledge Base. We are sorry for the unti..."

Show changes

Dcowan: minor formatting

2018-03-01T23:36:33Z

minor formatting

Dcowan: cleaned up

2018-02-12T02:01:23Z

cleaned up

Dcowan: added link kto bulk upload ledger code mapping

2018-02-05T02:21:11Z

added link kto bulk upload ledger code mapping

Dcowan: modified the first steps sections to be a little more accurate

2018-01-29T06:58:02Z

modified the first steps sections to be a little more accurate

Dcowan: added note about reconcile auto payment

2018-01-23T06:25:02Z

added note about reconcile auto payment

CMichaels at 23:39, 6 December 2017

2017-12-06T23:39:27Z

Dcowan: fixed formatting

2017-10-10T02:28:29Z

fixed formatting

Dcowan: added xero bulk actions info

2017-10-10T01:15:32Z

added xero bulk actions info

@@ Line 5: / Line 5: @@
 We are sorry for the untidiness while we are shifting locations and we appreciate your patience during the transition to our new home.
-[https://resources.emersion.com/display/EKB/Xero]
+[https://resources.emersion.com/display/EKB/Xero Take me to the new articles]
 [[file:new_home_sm.jpg|900px]]

@@ Line 170: / Line 170: @@
 * If a Xero created payment is applied to a Xero invoice as a result of an "[https://help.xero.com/au/BankAccounts-Reconciliation-AcceptMatch automatic reconcile match]" before a matching payment from Emersion has been pushed, the Emersion payment will continue to attempt to push to Xero and will never complete (<span title="Failed pushing payment allocated against Invoice #123456 to Xero due to: Validation Error (Payments can only be made against Authorised documents, Payment amount exceeds the amount outstanding on this document)">''hover over me for sample error''</span>). <br />
-Emersion recommend you do not allow automatic reconciliation matches against invoices unless an Emersion initiated payment is the target of the match (as indicated by by [https://go.xero.com/common/images/icon-banktransfer-a3df40bc03255229137fe3ba3ef04b0f.gif double arrow icon]).
+Emersion recommend you do not allow automatic reconciliation matches against invoices unless an Emersion initiated payment is the target of the match (as indicated by [https://go.xero.com/common/images/icon-banktransfer-a3df40bc03255229137fe3ba3ef04b0f.gif double arrow icon]).
 == Xero Bulk Actions ==

@@ Line 18: / Line 18: @@
 == First Time Setup ==
-You have had the Xero Integration module activated and would like to know how to initially configure Emersion to integrate with Xero. Apart from watching the short video below, the basic steps for you to now complete are as follows:
+{| style="color: black; background-color: #ffffcc;
 ) Nav: '''Admin > Xero''' <br />
@@ Line 38: / Line 39: @@
 * It is absolutely imperative that you link an Emersion Account to a Xero Contact. Firstly click the refresh button to update our cache with a fresh list of contacts directly from your Xero instance, then DOUBLE-click the input box to load the list. You can start typing a name to search this list.
 * This step must be performed for any existing accounts you wish to sync to Xero.
 == Overview of Supported and Non Supported Transactions ==
@@ Line 92: / Line 94: @@
 You can ''link'' an Emersion Account to a Xero Contact by utilizing one of the following methods;
-=== Creating a new Customer ===
+== Creating a new Customer ==
 When you create a new customer in Emersion, first screen in the wizard includes a '''Xero Account Name''' field. Use the drop-down to select which account to link to this new customer. This will perform an integration request to your Xero instance and pull a list of active contacts. The contact you wish to link to must already have been created in Xero.
 [[File:xero-create-customer.png|border|The Create Customer Wizard showing Xero fields]]
-=== Updating Existing Account ===
+== Updating Existing Account ==
 To do this;
 Nav: [[Account_Management/Customer_Screen/Details#Xero_Integration|'''Customer > Detail > Xero Integration''']]. Click the link to go to this page's help page.
@@ Line 144: / Line 146: @@
 <br />
-== Important Information ==
+== Xero Pollers ==
 * There are 4 ''pollers'' that handle Xero integration automatically. The frequency of these pollers are as follows;
 {| class="wikitable"
@@ Line 172: / Line 172: @@
 Emersion recommend you do not allow automatic reconciliation matches against invoices unless an Emersion initiated payment is the target of the match (as indicated by by [https://go.xero.com/common/images/icon-banktransfer-a3df40bc03255229137fe3ba3ef04b0f.gif double arrow icon]).
-=== Xero Bulk Actions ===
+== Xero Bulk Actions ==
 You may wish to bring forward one or more of the "poller" processes manually rather than wait for the scheduled processing time.
@@ Line 224: / Line 224: @@
 </gallery>
-= Related Reports =
+== Related Reports ==
 The report '''Xero Integration Errors''' (id: 1063) is included with this module. It can be found under '''Report > List > Finance'''. It is advised you run this report on a regular basis to confirm the transactions are successfully syncing. <br />
 Further info on this report: [[Integrations/Xero/Troubleshooting#Xero_Integration_Errors_Report Xero Integration Errors Report]]
 =See Also=

@@ Line 31: / Line 31: @@
 ) Nav: '''Admin > Ledger Mapping'''<br />
 * On this page, users can map Emersion ledger codes to Xero account codes. This step is optional but recommended - at least for common ledger codes like PACKAGE_PLAN_ACCESS_FEE_ADV, CARRIER_PRODUCT_USAGE, etc.
 '''! IMPORTANT !''' By default, Emersion's ledger codes will map to Xero's default revenue code 200 "Sales".  For this reason, Emersion strongly advises not to archive or delete this code.

@@ Line 20: / Line 20: @@
 You have had the Xero Integration module activated and would like to know how to initially configure Emersion to integrate with Xero. Apart from watching the short video below, the basic steps for you to now complete are as follows:
-Nav: '''Admin > Xero''' <br />
+) Nav: '''Admin > Xero''' <br />
-On this page, link your Xero company to Emersion by clicking on the '''Connect to Xero''' button and following the on-screen prompts. With a connection is established, users can add the default bank account.
+* On this page, link your Xero company to Emersion by clicking on the '''Connect to Xero''' button and following the on-screen prompts. With a connection is established, users can add the default bank account.
-Nav:  '''Admin > Xero > Xero Payments'''<br />
+) Nav:  '''Admin > Xero > Xero Payments'''<br />
 On this page:
-# Set a default Bank Account
+* Set a default Bank Account. This will be used as a default/fallback bank account for payment transactions that do not specifically have a mapping as per the following step;
-# If appropriate, create a payment mapping between alternate Xero bank accounts and Emersion's payment methods. Once this is done, the user can move into mapping Emersion's ledger codes with Xero's account codes.
+* If appropriate, create a payment mapping between alternate Xero bank accounts and Emersion's payment methods. Once this is done, the user can move into mapping Emersion's ledger codes with Xero's account codes.
-Nav: '''Admin > Ledger Mapping'''<br />
+) Nav: '''Admin > Ledger Mapping'''<br />
-On this page, users can map Emersion ledger codes to Xero account codes. This step is optional.
+* On this page, users can map Emersion ledger codes to Xero account codes. This step is optional but recommended - at least for common ledger codes like PACKAGE_PLAN_ACCESS_FEE_ADV, CARRIER_PRODUCT_USAGE, etc.
-'''''! IMPORTANT ! By default, Emersion's ledger codes will map to Xero's default revenue code 200 "Sales".  For this reason, Emersion strongly advises not to archive or delete this code.'''''
+'''! IMPORTANT !''' By default, Emersion's ledger codes will map to Xero's default revenue code 200 "Sales".  For this reason, Emersion strongly advises not to archive or delete this code.
-. Assign the Xero Account to the Customer's account in Emersion.<br />
+) Nav: '''Customer > Detail > Xero Integration ''' <br />
-To do this;
+* It is absolutely imperative that you link an Emersion Account to a Xero Contact. Firstly click the refresh button to update our cache with a fresh list of contacts directly from your Xero instance, then DOUBLE-click the input box to load the list. You can start typing a name to search this list.
-Nav: [[Account_Management/Customer_Screen/Details#Xero_Integration|'''Customer > Detail > Xero Integration''']]. Click the link to go to this page's help page.
+* This step must be performed for any existing accounts you wish to sync to Xero.
 == Overview of Supported and Non Supported Transactions ==

@@ Line 82: / Line 82: @@
 * Associate Emersion 'accounts' with Xero 'contacts'
-<mediaplayer MWPlayerConfig="MyCustomConfig" height="400" width="600">http://wiki.emersion.com.au/wiki/media/xero-integration.mp4</mediaplayer>
+<mediaplayer MWPlayerConfig="MyCustomConfig" height="400" width="600">https://wiki.emersion.com/wiki/media/xero-integration.mp4</mediaplayer>
 <br />

@@ Line 179: / Line 179: @@
 ** Push Completed Invoices to Xero (''the page will dynamically determine of any payments are valid and can be pushed'')
-[[File:Xero bulk actions 001.png|left|800px]]
+[[File:Xero bulk actions 001.png|800px]]
 == Xero / Emersion Ledger Transaction ==

← Older revision		Revision as of 01:15, 10 October 2017
Line 167:		Line 167:

	* If an overpayment amount in Xero is then allocated to an outstanding invoice, we will NOT pull this information in to Emersion		* If an overpayment amount in Xero is then allocated to an outstanding invoice, we will NOT pull this information in to Emersion
		+
		+	=== Xero Bulk Actions ===
		+
		+	You may wish to bring forward one or more of the "poller" processes manually rather than wait for the scheduled processing time.
		+
		+	* '''Nav:''' Admin > Xero > Xero Bulk Actions
		+	* Simply click on the appropriate process you wish to action. You may choose from;
		+	** Push Pending Payments to Xero (''the page will dynamically determine of any invoices are valid and can be pushed'')
		+	** Pull Payments from Xero
		+	** Pull Credits from Xero
		+	** Push Completed Invoices to Xero (''the page will dynamically determine of any payments are valid and can be pushed'')
		+
		+	[[File:Xero bulk actions 001.png\|left\|800px]]

	== Xero / Emersion Ledger Transaction ==		== Xero / Emersion Ledger Transaction ==