=== ZeroComa Verifactu for WooCommerce ===
Contributors: heikelv
Tags: factura electrónica, facturae, zerocoma, verifactu, woocommerce
Requires at least: 6.8
Tested up to: 7.0
Requires PHP: 8.1
Stable tag: 1.0.0
License: GPLv3 or later
License URI: https://www.gnu.org/licenses/gpl-3.0.html

Generates and sends invoices in Facturae 3.2.2 format to the ZeroComa API from WooCommerce.

== Description ==

Standalone WooCommerce plugin that generates electronic invoices in Facturae 3.2.2 format (official Spanish electronic invoice standard) and automatically sends them to ZeroComa's EdasInvoiZE system for processing and compliance.

== External services ==

This plugin requires connection to external services in order to generate, validate, and send electronic invoices in compliance with Spanish regulations. These external services are essential for the plugin to operate.

= 1. Facturae Format Specification =

The plugin uses the official electronic invoice XML schemas defined by the Spanish Tax Agency to generate Facturae-compatible XML files.

The schemas are used as XML namespaces to structure invoice data. No invoice, customer, company, or other personal data is sent to the Facturae website.

The plugin references the following public XML schema definitions:

https://www.facturae.gob.es/formato/Versiones/Facturaev3_2.xml

https://www.facturae.gob.es/formato/Versiones/Facturaev3_2_2.xml

Service provider: Spanish Government (Ministerio de Hacienda)

Reference URL: https://www.facturae.gob.es

Terms of Service: https://www.hacienda.gob.es/es-ES/Paginas/AvisoLegal.aspx

Privacy Policy: https://www.hacienda.gob.es/es-ES/Paginas/Politica-de-Privacidad.aspx

= 2. ZeroComa EdasInvoiZE API Services =

The plugin connects to ZeroComa EdasInvoiZE API services to receive, process, validate, store, and manage electronic invoices.

The services are used to submit Facturae invoices to the ZeroComa invoicing platform, validate company tax identifiers (CIF), and monitor invoice status.

API URLs used by the plugin:

https://gestionfacturaspre.zerocoma.com/api/

https://gestionfacturaspreservice.zerocoma.com/api/

Data sent to ZeroComa may include:

* WooCommerce order data, including invoice number, totals, and dates.
* Customer billing data required to generate the Facturae invoice.
* Company tax identifier (CIF) for validation and document compliance.
* Authentication API tokens required to authenticate API requests.

Data transmission occurs when:

* Automatic invoice generation is triggered after an order is completed.
* Manual invoice submission is executed.
* Invoice status is checked.
* Company data validation is requested.

Service provider: ZeroComa - EdasInvoiZE Platform

Terms of Service: https://www.zerocoma.com/aviso-legal

Privacy Policy: https://www.zerocoma.com/politica-de-privacidad

The plugin does not send invoice or customer data to external services other than those described above.

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/zerocoma-electronic-invoicing` directory, or install the plugin through the WordPress Plugins screen.
2. Activate the plugin through the Plugins screen in WordPress.
3. Go to the Verifactu menu to configure your ZeroComa API credentials.
4. Once configured, the plugin will automatically generate and send electronic invoices in Facturae 3.2.2 format to the ZeroComa EdasInvoiZE system when a WooCommerce order is completed.

== Frequently Asked Questions ==

= What version of WooCommerce is required? =

WooCommerce 7.0 or higher.

= Does this plugin work with any theme? =

Yes, as long as the theme is compatible with WooCommerce.

= What PHP version is required? =

PHP 8.1 or higher.

= Can I use the plugin without a ZeroComa account? =

No. A valid ZeroComa EdasInvoiZE API account is mandatory.

= Are invoices stored locally? =

Yes, invoices are temporarily generated in Facturae 3.2.2 XML format before being sent to ZeroComa.

= What information is sent externally? =

Only invoice, company, and customer billing data required for legal compliance is sent externally, using the services listed in the External services section.

== Changelog ==

= 1.0.0 =

* Initial release.
* Generates and sends Facturae 3.2.2 electronic invoices to ZeroComa EdasInvoiZE.
* Added required external service documentation for WordPress Plugin Directory compliance.


== Screenshots ==

1. Verifactu plugin configuration screen.
2. ZeroComa API configuration.
3. Generated electronic invoice information in Order Details
