=== Sync to Xero from WooCommerce - Xelation ===

Contributors: glidedigital
Donate link: https://xelation.org/#pricing-plans
Tags: xero, woocommerce xero, connect xero, woocommerce xero sync, sync xero
Requires at least: 4.0
Tested up to: 6.5
Stable tag: 0.1.1
Requires PHP: 7.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Automatically sync your WooCommerce orders with Xero along with payments, contacts & inventory.

== Description ==

Automatically sync your WooCommerce orders with Xero along with payments, contacts & inventory.

With Xelation your WooCommerce orders are seamlessly synchronized as sales invoices in Xero including line items & customer details.

Xelation allows you to specify separate account mappings for:

* sales
* shipping
* transaction fees (which are rendered as a purchase bill)
* payments (which are reconciled with your specified bank account)
* ...and much more!

== The pitch! ==

* Free 14 day trial!
* Start synching invoices in less than a minute!
* Simply connect to Xero and configure your mappings

...then watch your invoices sail into Xero!

== Typical scenario ==

A typical client scenario is where:

* a WooCommerce order needs to be rendered as a sales invoice in Xero with its line items and shipping costs mapped to the corresponding Sales account in Xero
* the corresponding transaction fee needs to be rendered as a purchase bill in the Costs account e.g. COGS
* the captured payment needs to be mapped as to the specified Bank account in Xero.  If the transaction is matched in the bank feed then the pairing will be automatically set to reconciled.

You can also:

* determine when WooCommerce orders are pushed to Xero i.e. **Processing, Completed** or **Pending** status
* determine the status of Xero invoices i.e. **Draft, Submitted, Authorised** or **Paid**
* set your preferred **invoice prefix** e.g. **Web**004567
* **deep link** between your WooCommerce **Order Notes** and the generated Xero invoice in either direction allowing you to quickly toggle between the two platforms
* enable the **stock control** feature which will automatically synchronize your WooCommerce inventory with the quantity to hand set in Xero

== Installation ==

1. Install the Xelation plugin either via the WordPress plugin directory, or by uploading the files to your web server (in the /wp-content/plugins/ directory).
2. Activate the Xelation plugin through the 'Plugins' menu in WordPress.
3. Navigate to the 'Settings > Xelation' page to connect to Xero and start configuring your mappings, triggers and stock control.

If you have an issue or question while setting up or using the plugin then please submit a support ticket to [support@xelation.org](mailto:support@xelation.org) and we'll get back to you as soon as we can.

== Use of 3rd Parties ==

Please note this plugin requires the use of 3rd party services:

* [Xero](https://xero.com/)
* [Xelation](https://xelation.org/)

By allowing access to Xero, you agree to the transfer of your data between Xero and Xelation in accordance with Xero's [terms of use](https://www.xero.com/uk/legal/terms/) and Xelation's [terms of use](https://xelation.org/terms) and [privacy policy](https://xelation.org/privacy-policy).

You can disconnect Xero from the live Xelation service at any time by clicking the **Disconnect from Xero** button.

You can fully disconnect the Xelation app from Xero at any time under the **Connected apps** section of your Xero settings.

== Requirements ==

* [WooCommerce plugin](https://wordpress.org/plugins/woocommerce/)
* [Xero instance](https://xero.com/)

== De-activate plugin ==

To de-activate the plugin:

1. Click the **Disconnect from WooCoomerce** button
2. De-activate the plugin

== Uninstall ==

To completely uninstall the plugin:

1. Click the **Disconnect from WooCoomerce** button
2. De-activate the plugin
3. Manually remove Xelation webhooks under: WooCoomerce > Settings > Advanced > Webhooks
3. Manually remove Xelation API keys under: WooCoomerce > Settings > Advanced > REST API

== Frequently Asked Questions ==

Consult our comprehensive FAQs on our [website](https://xelation.org/#faqs).

== Support ==

Please email us at info@xelation.org if you have any questions or need help.

== Changelog ==

= 0.1 =
* Initial release.

= 0.1.1 =
* Dependencies check.

== Screenshots ==

TBC

== Upgrade Notice ==

TBC