=== Integration Siigo Woocommerce ===
Contributors: saulmorales
Donate link: https://saulmoralespa.com/donation
Tags: siigo, woocommerce, facturacion, contabilidad, colombia, invoice, accounting, integration
Requires at least: 6.0
Tested up to: 6.9
Requires PHP: 8.2
Stable tag: 0.3.4
WC requires at least: 9.6
WC tested up to: 10.5
License: GNU General Public License v3.0
License URI: https://www.gnu.org/licenses/gpl-3.0.html

Integración completa de Siigo (sistema contable y de facturación) con WooCommerce para Colombia.

== Description ==

Integration Siigo Woocommerce es un plugin que permite integrar tu tienda WooCommerce con Siigo, el sistema contable y de facturación líder en Colombia. Esta integración automatiza procesos de facturación, sincronización de productos e inventario entre tu tienda online y tu sistema contable.

= Características principales =

* **Sincronización automática de productos**: Sincroniza productos desde Siigo a WooCommerce con precios, stock y descripciones
* **Control de inventario**: Actualiza automáticamente el stock de productos basado en la disponibilidad en Siigo
* **Facturación automática**: Genera facturas en Siigo cuando se completa una orden en WooCommerce
* **Soporte para fees de pasarela de pago**: Incluye automáticamente los cargos adicionales generados por métodos de pago en la factura
* **Gestión de clientes**: Sincroniza información de clientes entre WooCommerce y Siigo
* **Campo DNI en checkout**: Añade campo de documento de identidad requerido para facturación
* **Integración con ciudades y departamentos de Colombia**: Compatible con el plugin de departamentos y ciudades
* **Soporte para múltiples tipos de documento**: Cédula, NIT, pasaporte, etc.
* **Soporte sandbox y producción**: Prueba la integración en ambiente de pruebas antes de ir a producción
* **Sincronización programada**: Ejecuta sincronización automática diaria de productos
* **Compatible con WooCommerce Blocks**: Funciona con el nuevo sistema de checkout basado en bloques
* **Registro de errores (logs)**: Sistema de depuración para rastrear problemas

= Requisitos =

* WordPress 6.0 o superior
* WooCommerce 9.6 o superior
* PHP 8.2 o superior
* Plugin: Departamentos y Ciudades de Colombia para WooCommerce
* Cuenta activa en Siigo (Colombia)
* Credenciales API de Siigo (Username y Access Key)

= Compatibilidad =

* Compatible con WooCommerce High-Performance Order Storage (HPOS)
* Compatible con WooCommerce Blocks
* Optimizado para tiendas en Colombia

== Installation ==

= Instalación manual =

1. Descarga el archivo ZIP del plugin
2. Ve a WordPress > Plugins > Añadir nuevo > Subir plugin
3. Selecciona el archivo ZIP y haz clic en "Instalar ahora"
4. Activa el plugin

= Configuración inicial =

1. Asegúrate de tener instalado y activado WooCommerce
2. Instala y activa el plugin "Departamentos y Ciudades de Colombia para WooCommerce"
3. Ve a WooCommerce > Ajustes > Integraciones > Integration Siigo Woocommerce
4. Habilita la integración
5. Selecciona el ambiente (Sandbox para pruebas o Producción)
6. Ingresa tus credenciales de Siigo:
   - Username
   - Access Key
7. Haz clic en "Probar conexión" para verificar las credenciales
8. Configura los ajustes adicionales:
   - Grupo de cuenta
   - Impuesto
   - Tipo de documento
   - Método de pago
   - Bodega (warehouse)
   - Stock mínimo
9. Guarda los cambios

= Configuración de sincronización =

La sincronización automática de productos se ejecuta diariamente a las 5:00 AM. Los productos se sincronizan desde Siigo hacia WooCommerce, actualizando:

* Nombres de productos
* SKUs
* Precios
* Precios de oferta
* Descripciones
* Disponibilidad de stock
* Cantidades disponibles

== Frequently Asked Questions ==

= ¿Necesito una cuenta en Siigo para usar este plugin? =

Sí, necesitas una cuenta activa en Siigo Colombia y tus credenciales API (Username y Access Key). Puedes obtenerlas desde tu panel de Siigo en la sección de integraciones.

= ¿El plugin funciona en modo sandbox? =

Sí, el plugin incluye soporte para ambiente sandbox (pruebas) y producción. Recomendamos probar primero en sandbox antes de activar en producción.

= ¿Cómo obtengo mis credenciales API de Siigo? =

Inicia sesión en tu cuenta de Siigo, ve a Configuración > Integraciones > API y genera tus credenciales (Username y Access Key).

= ¿Qué sucede si un producto no existe en WooCommerce? =

El plugin creará automáticamente el producto en WooCommerce usando la información de Siigo (nombre, SKU, precio, descripción, stock).

= ¿Puedo sincronizar productos manualmente? =

Sí, la sincronización se ejecuta automáticamente cada día, pero también puedes forzar una sincronización manual usando el hook de WordPress o esperando al próximo ciclo programado.

= ¿El plugin sincroniza órdenes hacia Siigo? =

Sí, cuando una orden se completa en WooCommerce, el plugin genera la factura correspondiente en Siigo con todos los detalles del cliente y productos.

= ¿Qué información del cliente se sincroniza? =

Se sincroniza: nombre completo, tipo de documento, número de documento, dirección, ciudad, departamento, teléfono y correo electrónico.

= ¿Es compatible con WooCommerce Blocks? =

Sí, el plugin es totalmente compatible con el nuevo sistema de checkout basado en bloques de WooCommerce.

= ¿Cómo puedo ver los errores o problemas? =

Activa el modo debug en la configuración del plugin. Los registros (logs) se guardarán en WooCommerce > Estado > Registros.

= ¿Puedo limitar el stock sincronizado? =

Sí, en la configuración puedes establecer una cantidad mínima de stock. Si el stock en Siigo es mayor a este valor, se usará el mínimo configurado.

= ¿Qué pasa si hay un error de conexión con Siigo? =

El plugin registrará el error en los logs de WooCommerce. Puedes revisar los logs para identificar el problema y solucionarlo.

== Screenshots ==

1. Configuración principal de la integración
2. Campos de credenciales API de Siigo
3. Configuración de facturación y documentos
4. Campo DNI en el checkout
5. Logs y depuración

== Changelog ==

= 0.3.4 =
* Agregado valor vacio por defecto para el campo de Identificador único del impuesto (IVA)

= 0.3.3 =
* Soporte para fees de pasarelas de pago (compatible con Payment Gateway Based Fees and Discounts for WooCommerce)
* Los cargos adicionales generados por métodos de pago ahora se incluyen automáticamente en la factura de Siigo

= 0.3.2 =
* Mejora validación del campo DNI en el checkout

= 0.3.1 =
* Mejora validación del campo DNI en el checkout
* Mejora registro de logs

= 0.3.0 =
* Resuelto parametro due_date faltante al usar medios de pagos en la creación de facturas
* Resuelto cantidad de caracteres en el campo de descripción del producto para Siigo
* Resuelto validación de expiración de token al conectar con Siigo
* Comprobación de vendedores, facturas, impuestos y métodos de pagos activos en Siigo

= 0.2.0 =
* Compatibilidad con WooCommerce 9.7
* Compatibilidad con WordPress 6.8
* Soporte para WooCommerce High-Performance Order Storage (HPOS)
* Mejoras en la sincronización de productos
* Mejoras en el manejo de errores
* Optimizaciones de rendimiento

= 0.1.0 =
* Primera versión pública
* Sincronización de productos desde Siigo
* Generación de facturas automáticas
* Campo DNI en checkout
* Integración con ciudades y departamentos de Colombia
* Soporte sandbox y producción

== Upgrade Notice ==

= 0.2.0 =
* Solución a producto que sea crea al no tener nombre
* Validar  y aplicar el tipo de descuento según el documento

== Additional Info ==

= Soporte =

Para soporte técnico, por favor visita:
* [Sitio web del desarrollador](https://saulmoralespa.com)
* [LinkedIn](https://www.linkedin.com/in/saulmoralespa/)

= Contribuir =

Si deseas contribuir al desarrollo del plugin, visita el repositorio en GitHub o contacta al autor.

= Donaciones =

Si este plugin te ha sido útil, considera hacer una donación en: https://saulmoralespa.com/donation

== Credits ==

* Desarrollado por: [Saúl Morales Pacheco](https://saulmoralespa.com)
* [LinkedIn](https://www.linkedin.com/in/saulmoralespa/)

== Privacy Policy ==

Este plugin no recopila ni almacena datos personales de los usuarios más allá de lo necesario para la integración con Siigo. Los datos se transmiten de forma segura mediante API a los servidores de Siigo siguiendo sus políticas de privacidad.