=== Dynamica Facturacion Electronica ===
Contributors: leo2904
Tags: woocommerce, electronic invoicing, uruguay, eticket, cfe
Requires at least: 6.6
Tested up to: 6.9
Requires PHP: 8.2
Stable tag: 0.1.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Automatiza la facturacion electronica de tu tienda WooCommerce en Uruguay y reduce errores, tiempo operativo y trabajo manual.

== Description ==

Dynamica Facturacion Electronica agrega una base orientada a WooCommerce para facturacion electronica en Uruguay.

https://www.youtube.com/watch?v=w3yDCNuZc8k

Caracteristicas principales:

* **Emision automatica de CFE:** Genera borradores y procesa documentos electronicos desde pedidos de WooCommerce.
* **Integracion con Uruguay:** Orientado a e-Ticket, e-Factura y otros tipos de CFE segun el CAE configurado.
* **Sincronizacion remota:** Permite traer configuracion de empresa, datos del emisor y catalogo de CAE mediante bearer token.
* **Control de numeracion:** Soporta seleccion de CAE y manejo local del consecutivo de documentos.
* **Soporte SOAP/XML:** Prepara y envia la informacion fiscal al proveedor compatible cuando el comercio habilita el envio real.
* **Historial y seguimiento:** Guarda respuestas, estado de documentos y enlaces PDF para consulta administrativa.
* **Ambientes separados:** Incluye modos sandbox y produccion para pruebas y salida en vivo.
* **Operacion segura:** El envio SOAP real permanece desactivado por defecto hasta que el comercio decide habilitarlo.

Esta version esta enfocada en flujos CFE de Uruguay, incluyendo e-Ticket, e-Factura y otros tipos de documentos soportados segun el CAE del comercio y la configuracion del servicio. Esta pensada para comercios que ya operan su facturacion electronica con Dynamica.

== Quick Start ==

1. Active WooCommerce y este plugin.
2. Abra `WooCommerce > Factura Electronica`.
3. Revise la configuracion de conexion con Dynamica e ingrese el bearer token si su cuenta usa sincronizacion remota.
4. Sincronice los datos de la empresa y revise el catalogo de CAE.
5. Confirme el ambiente, la numeracion y los datos del emisor.
6. Mantenga desactivado el envio real hasta completar las pruebas de sandbox. Las instalaciones nuevas inician con el envio real desactivado por defecto.
7. Cree un pedido en WooCommerce y verifique la generacion del documento antes de habilitar el envio a produccion.

== External Services ==

Este plugin se conecta a servicios externos de Dynamica para obtener configuracion de empresa y para procesar documentos fiscales electronicos.

= 1. Sincronizacion y emision con Dynamica =

El plugin puede conectarse a servicios operados por Dynamica para sincronizar configuraciones de empresa y para procesar comprobantes electronicos de comercios que ya usan ese servicio.

URL del servicio:

* `https://www.datosdynamica.net/woocommerce`

Cuando se utiliza:

* cuando un administrador ejecuta manualmente la sincronizacion desde la configuracion del plugin
* cuando el comercio habilita la emision real y procesa documentos elegibles

Que se envia:

* el bearer token ingresado por el comercio en la configuracion del plugin
* datos fiscales y comerciales necesarios para identificar el comercio emisor
* datos del documento electronico generados a partir del pedido de WooCommerce cuando el comercio habilita la emision real

Que se recibe y almacena:

* identificadores de empresa
* datos comerciales del emisor
* datos del catalogo de CAE
* configuracion requerida para el flujo de facturacion electronica
* respuestas del servicio sobre el estado del documento y, cuando corresponda, acceso al PDF emitido

Terminos del servicio y privacidad:

* Sitio de Dynamica: `https://dynamica.com.uy/`
* Servicio de integracion: `https://www.datosdynamica.net/woocommerce`
* Politica de Privacidad: `https://www.datosdynamica.net/plugin/woocommerce/politica-de-privacidad.html`
* Terminos de Servicio: `https://www.datosdynamica.net/plugin/woocommerce/terminos-de-servicio.html`

== Requirements ==

* WordPress 6.6 o superior
* WooCommerce activo
* PHP 8.2 o superior
* acceso a una cuenta activa de facturacion electronica con Dynamica

== Installation ==

1. Suba el archivo ZIP en `Plugins > Add New > Upload Plugin`.
2. Active WooCommerce si aun no esta activo.
3. Active este plugin.
4. Vaya a `WooCommerce > Factura Electronica`.
5. Revise la configuracion de conexion e ingrese el bearer token si usa sincronizacion remota.
6. Revise el CAE, la numeracion y la configuracion del ambiente.
7. Mantenga desactivado el envio real hasta validar el flujo de sandbox.

== Frequently Asked Questions ==

= El plugin funciona sin WooCommerce? =

No. WooCommerce es requerido porque el plugin se integra con pedidos, checkout y pantallas administrativas de WooCommerce.

= Donde se almacenan los XML, respuestas y logs? =

El plugin almacena XML generados, respuestas JSON, certificados y logs en `wp-content/uploads/dynamica-facturacion-electronica/`, fuera de la carpeta del plugin, para que las actualizaciones no eliminen archivos de ejecucion.

= El plugin vuelve a exponer al navegador los tokens o claves guardadas? =

No. Los secretos guardados intencionalmente no se muestran otra vez en la interfaz administrativa. Dejar el campo relacionado vacio conserva el valor almacenado.

= El plugin contacta servicios externos automaticamente? =

La sincronizacion remota de configuracion solo se ejecuta por accion de un administrador. El envio SOAP real comienza desactivado por defecto y solo ocurre cuando el comercio lo habilita en la configuracion y dispara un flujo de documento elegible.

= Puedo usar este plugin sin una cuenta de proveedor? =

Puede configurar y probar la generacion local de borradores, pero el envio real requiere credenciales validas del proveedor y acceso a un servicio compatible de facturacion electronica.

== Screenshots ==

1. Configuracion inicial del plugin con sincronizacion por token y datos base de empresa.
2. Configuracion visible del CAE, numeracion, ambiente y automatizacion de emision.
3. Flujo de checkout con captura de datos fiscales del cliente en WooCommerce.
4. Pantalla de documentos generados con estado, proveedor y acceso al PDF del comprobante.

== Changelog ==

= 0.1.2 =

* Se agregaron enlaces publicos de politica de privacidad y terminos de servicio para el servicio de configuracion remota.
* Se deshabilito por defecto el envio SOAP real para nuevas instalaciones.
* Se agrego contenido sugerido para politica de privacidad mediante las herramientas de privacidad de WordPress.
* Se movieron los estilos de presentacion de la pagina administrativa a una hoja de estilos cargada correctamente.
* Se alinearon las capacidades administrativas de WooCommerce entre configuracion, reenvio y descarga de documentos.
* Se agrego la carga estandar del textdomain del plugin durante el arranque.
* Se corrigieron las URLs de acciones administrativas para reenvio y descarga del paquete XML.

= 0.1.1 =

* Se eliminaron claves tecnicas hardcodeadas del plugin distribuido.
* Se dejo de exponer secretos guardados en respuestas AJAX y campos de interfaz administrativa.
* Se ocultaron valores sensibles en los logs del plugin.
* Se movio el registro de archivos del plugin al directorio de uploads de WordPress.
* Se eliminaron rutas internas de archivos de registros almacenados, metadatos de pedidos y vistas administrativas.
* Se mantuvo el ZIP distribuido libre de logs internos de ejecucion del plugin.
* Se amplio la documentacion del readme para servicios externos y flujo de datos.

= 0.1.0 =

* Base inicial de integracion de facturacion electronica para WooCommerce.
