=== Declarando - Invoice Management ===
Contributors: declarando
Tags: woocommerce, invoicing, billing, declarando, automation
Requires at least: 5.0
Tested up to: 6.8
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Automatically integrate your online store with Declarando to manage invoices, sync orders, and keep your accounting up to date.

== Description ==

**Declarando - Invoice Management** is the official plugin that connects your online store with the Declarando platform, fully automating invoice management and ecommerce accounting.

= Why choose this plugin? =

* **Automatic synchronization**: All your store orders are automatically sent to Declarando
* **Simple setup**: You only need your API Key to get started
* **Refund management**: Refunds are automatically synchronized
* **Testing environment**: Sandbox mode for testing without affecting real data
* **Multiple status support**: Configure which order statuses to sync
* **Native interface**: Integrates perfectly into your store's admin area

= Main features =

* **Automatic order synchronization** with the Declarando platform
* **Centralized admin panel** to manage all your invoices
* **Native integration** without complex configurations
* **Integrated and automated refund management**
* **Custom columns** in the orders list
* **REST API** for external queries and updates
* **Complete logging system** for debugging and tracking
* **Compatible with test and production environments**
* **Multilingual** ready for translations

= Use cases =

* **Online stores** that need to automate their invoicing
* **B2B ecommerce** with business client management
* **Marketplaces** requiring detailed fiscal control
* **Multi-currency stores** with international management
* **Businesses requiring automated fiscal compliance**

= Requirements =

* WordPress 5.0 or higher
* PHP 7.4 or higher
* Active account at [Declarando](https://declarando.es)
* Valid Declarando API Key

== External Services ==

This plugin connects to the Declarando API (an external third-party service) to synchronize orders and manage invoices automatically. This connection is essential for the plugin's core functionality.

**What data is sent:**
* Order information (order ID, items, quantities, prices, dates)
* Customer data (name, email, billing address if provided)
* Store configuration (currency, tax settings)
* Refund information when refunds are processed

**When data is sent:**
* When an order reaches a configured status (e.g., Processing, Completed)
* When a refund is created or processed
* When manually synchronizing from the admin panel
* During initial plugin setup and connection

**Service provider:** Declarando (https://declarando.es)

**API endpoints used:**
* Production: https://declarando-api-ecommerce-828031991052.europe-west4.run.app
* Sandbox (testing): Configurable test environment

**Legal information:**
* [Declarando Terms of Service](https://declarando.es/condiciones-uso)
* [Declarando Privacy Policy](https://declarando.es/proteccion-datos)

By using this plugin, you agree to send the above data to Declarando's servers for invoice management and accounting purposes. No data is sent without your explicit configuration and connection to a Declarando account.

= How it works =

Once installed and configured, the plugin:

1. **Automatically detects** new WooCommerce orders
2. **Validates information** from order and customer
3. **Sends data** to Declarando via secure API
4. **Synchronizes changes** like refunds or cancellations
5. **Provides visual feedback** in WooCommerce administration

= Useful links =

* [Official Declarando website](https://declarando.es)
* [Help center](https://declarando.es/faqs)
* [Support channel](https://declarando.es/faqs)

== Installation ==

= Automatic installation (recommended) =

1. Go to **Plugins > Add New** in your WordPress dashboard
2. Search for "Declarando WooCommerce"
3. Click **"Install Now"** on the Declarando plugin
4. Once installed, click **"Activate"**
5. Go to **WooCommerce > Declarando** to configure

= Manual installation =

1. Download the plugin ZIP file from WordPress.org
2. Go to **Plugins > Add New > Upload Plugin**
3. Select the downloaded ZIP file
4. Click **"Install Now"** and then **"Activate"**
5. Go to **WooCommerce > Declarando** to configure

= Initial setup =

1. **Get your API Key**:
   - Log in to your [Declarando](https://declarando.es) account
   - Go to **Profile > Online Store**
   - Generate a new connection code

2. **Configure the plugin**:
   - Go to **WooCommerce > Declarando** in WordPress
   - Enter your Declarando **connection code**
   - Click **"Link Store"**
   - Done! Orders will sync automatically

= Advanced configuration =

For advanced users, the plugin allows you to configure:

* Order statuses that are synchronized
* Statuses that generate refunds
* Operation mode (Production/Sandbox)
* Company-specific settings

== Frequently Asked Questions ==

= Do I need a Declarando account? =

Yes, you need an active account at [Declarando](https://declarando.es) and obtain your connection code from the **Profile > Online Store** panel.

= Is the plugin free? =

The plugin is completely free. However, you need a Declarando account to function, which may have costs depending on your plan.

= Is it compatible with other invoicing plugins? =

Yes, Declarando works independently and can coexist with other invoicing plugins without conflicts.

= Can I test the plugin without affecting my production? =

Yes, the plugin includes a **Sandbox mode** that allows you to do complete tests without affecting your real production data.

= Does the plugin store sensitive data? =

The plugin uses WordPress's secure Options API to save configurations. Data is stored encrypted and the API Key is handled securely.

= What happens with orders prior to installation? =

Orders created before plugin installation are not automatically synchronized. Only new orders (after activation) will be sent to Declarando.

= How does the plugin handle refunds? =

Refunds are automatically detected when you change an order status to "Refunded" or "Cancelled" in WooCommerce, and are synchronized with Declarando.

= Is it compatible with multi-currency stores? =

Yes, the plugin works with any WooCommerce configuration, including multi-currency stores. Make sure the currency configuration in Declarando matches.

= What information is sent to Declarando? =

Order information (products, quantities, prices), customer data (if invoicing is accepted), order status, and relevant metadata for invoicing are sent.

= How can I get technical support? =

You can:
- Open a ticket in the [WordPress.org support forum](https://wordpress.org/support/plugin/declarando-gestion-facturas/)
- Contact [Declarando support](https://declarando.es/faqs) directly
- Check the [official documentation](https://declarando.es/faqs)

= Does the plugin affect my store's performance? =

No, the plugin is optimized and synchronization operations are performed in the background without affecting user experience.

== Screenshots ==

1. **Main configuration panel** - Simple interface to link your store with Declarando
2. **Successful linking** - Connection confirmation established with Declarando
3. **WooCommerce integration** - Direct access from the WooCommerce menu
4. **Sync statuses** - Advanced configuration of which orders to sync
5. **Order columns** - Sync information visible in the orders list
6. **Refund management** - Interface to handle synchronized refunds

== Changelog ==

= 1.0.0 - 2024-11-07 =
* Initial plugin release
* Full integration with Declarando API v1
* Automatic WooCommerce order synchronization
* Automated refund management
* Native admin panel
* Support for Sandbox and Production modes
* Logging system for debugging
* Compatibility with WooCommerce 3.0+
* Multilingual interface ready
* Complete documentation included

== Upgrade Notice ==

= 1.0.0 =
Initial version of the official Declarando plugin for WooCommerce. Install to fully automate your invoicing and accounting.

== Additional Information ==

= Documentation =

For more information and detailed documentation, visit [the official Declarando documentation](https://declarando.es/).

= Privacy =

This plugin connects with external Declarando services to synchronize orders and generate invoices. The data sent includes:
* Order information (products, amounts, dates)
* Customer data (name, email, address if necessary)
* Your company's tax information

Check the [Declarando privacy policy](https://declarando.es/proteccion-datos) for more information.

= Contributing =

If you wish to contribute to the development of this plugin, visit our GitHub repository.
