=== Syncible Sync for Xero ===
Contributors: southcoastrjg
Tags: woocommerce, xero, accounting, sync, invoicing
Requires at least: 5.8
Tested up to: 6.9
Stable tag: 1.0.0
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Real-time WooCommerce to Xero sync. Orders flow to Xero as individual invoices the moment they are placed.

== Description ==

Syncible Sync for Xero connects your WooCommerce store to your Xero account so that every order is automatically posted as a Xero invoice in real time.

When an order is placed in WooCommerce, this plugin sends the order data to the Syncible service, which creates a corresponding invoice in Xero. Refunds in WooCommerce create credit notes in Xero. The result is that your Xero account reflects your WooCommerce sales activity without manual data entry.

= Features =

* Real-time order sync - orders post to Xero as individual invoices within seconds of being placed
* Refund sync - WooCommerce refunds create matching credit notes in Xero
* Configurable Xero account code for sales
* Configurable Xero tax code for sales
* Connection management for your Xero authorisation
* Activity history showing recent sync operations
* Onboarding wizard to guide initial setup

= External service =

This plugin connects to the Syncible service (https://syncible.co.uk) to perform the synchronisation between WooCommerce and Xero. The Syncible service:

* Receives order and refund data from your WooCommerce store
* Authenticates with Xero on your behalf using OAuth
* Creates invoices and credit notes in your Xero account
* Stores synchronisation history for the activity view

The following data is sent to the Syncible service:

* When syncing: order details (items, prices, tax, customer, payment method) and refund details
* On plugin activation: your store URL for identification
* On plugin deactivation: your store URL and an API token to clean up the connection

Terms of Service: https://syncible.co.uk/terms/
Privacy Policy: https://syncible.co.uk/privacy/

A separately-distributed companion plugin with additional features is available at https://syncible.co.uk.

== Installation ==

1. Install and activate the plugin from the WordPress plugin directory.
2. Visit the Syncible menu in your WordPress admin.
3. Follow the onboarding wizard to connect your Xero account.
4. Configure your default Xero sales account and tax code.
5. Place a test order in WooCommerce to verify the sync.

WooCommerce must be installed and activated before this plugin can be used.

== Frequently Asked Questions ==

= Do I need a Xero account? =

Yes. This plugin syncs WooCommerce orders to an existing Xero account. You will be prompted to authorise the connection during onboarding.

= Does this work with WooCommerce Subscriptions? =

This plugin syncs orders generated by WooCommerce, including those created by WooCommerce Subscriptions when a subscription renews.

= What happens if Xero rejects an invoice? =

Failed syncs appear in the activity history with the error reason. You can address the underlying issue (for example, an invalid tax code) and the next order will sync correctly.

= How do I disconnect from Xero? =

Use the disconnect option in the plugin settings. This revokes the Xero authorisation and notifies the Syncible service.

= Is my data secure? =

Order data is sent over HTTPS to the Syncible service. Xero authorisation uses OAuth 2.0 - your Xero credentials are never stored by this plugin. See the Privacy Policy at https://syncible.co.uk/privacy/ for full details.

= Is there a paid version with more features? =

Yes. A separately-distributed companion plugin with additional functionality is available at https://syncible.co.uk/woocommerce-xero/.

== Screenshots ==

1. The Syncible dashboard shows active sync status, recent activity, and connection health for both WooCommerce and Xero.
2. Connect your WooCommerce store in seconds with our guided setup — Syncible generates the required API keys for you.
3. Authorise Xero via OAuth — your tokens stay encrypted and we never see your credentials.
4. Configure your default Xero account codes and VAT settings to match your accounting setup.

== Changelog ==

= 1.0.0 =

* Initial public release.

== Upgrade Notice ==

= 1.0.0 =
Initial release.
