=== 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.3 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 == Changelog == = 1.0.3 - 2026-06-10 = * Updated WC tested up to WooCommerce 10.8.1 = 1.0.2 - 2026-06-10 = * Updated Tested up to WordPress 6.8 = 1.0.1 - 2026-06-10 = * General fixes and improvements = 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.3 = Marked as compatible with WooCommerce 10.8.1. = 1.0.2 = Marked as compatible with WordPress 6.8. = 1.0.1 = General fixes and improvements. = 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.