¿Qué hace?
La integración de Gesnex con WooCommerce te permite mantener sincronizado el stock de Gesnex con tu comercio, así como generar una nota de venta, boleta, factura o guía de despacho electrónica automática y enviársela a tu cliente cada vez que realice el pago de la compra o realices el despacho de la misma.
¿Qué necesitas?
Solo debe funcionar correctamente la API Rest de WooCommerce y que tu sitio esté alojado mediante HTTPS (con certificado SSL). Tampoco requiere plugins, salvo desees la emisión de facturas o guías, o bien desees entregar diferentes alternativas.
Paso a paso
Para dejar operativa la integración, debes ir a la página https://app.gesnex.com/integraciones/woocommerce luego ingresar la URL de tu comercio aquí y presionar "Crear". En el ejemplo, se ingresó "woocoomerce.gesnex.com"
El sistema preparará y verificará que el sitio exista y sea apto, luego será agregado y te solicitará Autorizar a Gesnex para que pueda solicitar y enviar información, por lo que deberás presionar "Autorizar".
Una vez autorizada, solo debes marcar "Activar sincronización...", seleccionas la sucursal donde deseas que se asignen las ventas, la bodega de donde se descontará stock, presionas "Guardar" ¡y listo! con esto el sistema ya habrá creado credenciales para que Gesnex pueda conectarse a tu tienda a través de la API Rest y habrá creado un webhook para el envío de información a Gesnex.
Verificaciones
Para ayudarte a ver si la configuración es correcta, te debieran aparecer 2 tickets en verde. El primero indica que la tienda tiene impuestos activados (que es importante para diferenciar productos afectos o exentos de IVA), mientras que el segundo indica que la moneda está configurada a pesos Chilenos (CLP).
Opciones
Gesnex te entregará diferentes opciones para que puedas personalizar tu configuración, si tienes dudas específicas de las opciones, nos puedes escribir
¿Necesitas el plugin?
Actualmente estamos trabajando para publicarlo en un repositorio abierto. Mientras tanto, puedes solicitarlo a través del chat de soporte. El plugin tiene dos requisitos:
Usar WooCommerce en su versión 8.3 o superior.
Utilizar el checkout basado en bloques (requiere un tema compatible con los bloques de WordPress).
De acuerdo con WooCommerce, desde la versión 8.3 el checkout basado en bloques es la experiencia predeterminada en nuevas instalaciones y “es el futuro del checkout en WooCommerce”, por lo que incentivan a los desarrolladores a adaptarse a esta nueva arquitectura (fuente: The WooCommerce Developer Blog ).
Aunque su adopción aún no es masiva, representa el camino oficial hacia el futuro. Si encuentras dificultades para integrar el plugin, no dudes en consultar con nuestro equipo de soporte para ver tu compatibilidad.
¿Deseas hacerlo más personalizado?
Puedes personalizar WooCommerce como gustes, solicitar validaciones cuando prefieras y de la manera que prefieras, nuestro plugin es neutro en cuanto a diseño y mensajes. Si necesitas otra manera de operar, solo debes considerar que se agregue la siguiente información al webhook para que podamos generar correctamente tus ventas.
El objeto order de WooCommerce, enviado vía webhook, incluye el atributo meta_data. Dentro de este arreglo deben existir ciertos metadatos que Gesnex utiliza para generar la venta y/o el documento tributario correspondiente.
Key (Nombre del campo) | Value (Valores válidos / formato) | Descripción | Obligatorio |
_wc_billing/gesnex/tipo-documento | "BoletaElectronica" "FacturaElectronica" "GuiaDespachoElectronica" "NotaVenta" | Se indica el tipo de documento electrónico a crear, o si es una nota de venta (generas una venta sin DTE con esta última opción). | ✅ Siempre |
_wc_billing/gesnex/rut | RUT válido (con o sin puntos, con o sin DV) | RUT receptor del documento. | ❌ Boleta / Nota venta |
_wc_billing/gesnex/razon-social | Texto (Max: 100 caracteres) | Razón Social del receptor del documento. | ❌ Boleta / Nota venta |
_wc_billing/gesnex/giro | Texto (Max: 40 caracteres) | Giro del receptor del documento. | ❌ Boleta / Nota venta |
_wc_billing/gesnex/comuna | Texto (Max: 20 caracteres) | Comuna del receptor del documento. | ❌ Boleta / Nota venta |
Teniendo los campos obligatorios anteriores, estás en condiciones de generar los documentos que necesites y en las condiciones que prefieras.
¿Tuviste algún problema?
Contáctanos vía chat y resolveremos tu caso. Considera que WooCommerce es una plataforma que cada proveedor instala y configura existiendo muchísimas configuraciones y opciones, por lo que debemos convivir con todo ese universo de posibilidades.