=== GoRoute E-Invoicing for WooCommerce ===
Contributors: goroute
Tags: e-invoicing, oman, fawtara, woocommerce, tax
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Fawtara-ready e-invoicing for Oman WooCommerce stores. Every paid order gets a compliant simplified tax invoice with the Fawtara QR code.

== Description ==

From 2027, VAT-registered businesses in Oman must issue e-invoices (Tax
Authority Decision No. 189/2026: 1 April 2027 above OMR 5,000,000 annual
supplies, 1 October 2027 for all remaining VAT registrants).

This plugin connects your WooCommerce store to GoRoute, an accredited Fawtara
service provider and certified Peppol Access Point (POP000991). On every paid
order it issues a simplified tax invoice with the Fawtara QR code, shows it on
the thank-you page and in the order email, and files the Tax Data Document with
the Oman Tax Authority — automatically. Refunds raise credit notes referencing
the original invoice. Duplicate submissions are impossible: a retried order
returns the same invoice.

**This plugin requires a paid GoRoute account.** The plugin itself is free; a
GoRoute subscription is what issues the documents. Plans start at OMR 25/month
including 1,000 documents. Create an account at https://goroute.ai/.

The plugin sends order data (line items, totals, your VAT number, and the
customer's name and email if present) to GoRoute's API to issue each invoice.
See https://goroute.ai/privacy-policy.html for the service's privacy policy.
Omani customer data is processed in-country.

== External Services ==

This plugin connects to the GoRoute e-invoicing API (https://goroute.ai) to
issue tax documents. It is useless without it, by design: the compliance rules,
validation and QR construction live on the service so they stay current.

What is sent, and when: on each paid order and each refund, the plugin sends
the order's line items (name, quantity, net price, tax rate, SKU), totals,
currency, your configured legal seller name and VAT number, and the customer's
billing name and email if present. On "Test connection" a single authenticated
read is made to verify your API key. Nothing is sent at any other time, and
nothing is sent for stores that have not entered an API key.

Service provider: GoRoute (ClayDesk LLC / Union Digital Technologies SPC).
Terms: https://goroute.ai/terms.html · Privacy: https://goroute.ai/privacy-policy.html

== Installation ==

1. Upload the plugin zip under Plugins → Add New → Upload Plugin, and activate.
2. Open WooCommerce → GoRoute E-Invoicing.
3. Paste your GoRoute API key, enter your legal seller name and VAT number.
4. Press "Test connection", then place a test order.

== Frequently Asked Questions ==

= Do I need to change my theme or checkout? =
No. The plugin hooks the order events WooCommerce already fires.

= What happens on a refund? =
A credit note is issued referencing the original invoice, with its own QR, and
reported. Partial refunds credit only the refunded lines.

= What if GoRoute is unreachable when an order is paid? =
The checkout is never blocked. Issuing retries automatically with backoff, the
order note records each attempt, and the receipt follows by email once issued.

== Changelog ==

= 1.0.0 =
* First release: issue on payment, credit note on refund, QR on the thank-you
  page and in order emails, admin status box with retry, HPOS compatible.
