Ecomiq para WooCommerce

Conecta tu tienda WooCommerce con Ecomiq en un clic, sin copiar claves de API.

Descargar la última versión · Documentación · Panel de Ecomiq

Qué hace

Ecomiq reúne catálogo, stock, precios y pedidos de todos tus canales en un solo panel. Con este plugin, tu WooCommerce entra a Ecomiq de dos formas:

• Como origen. Ecomiq trae tus productos con variantes, categorías, atributos y fotos, además del stock y los pedidos. Los cambios llegan por webhooks.
• Como canal de venta. Ecomiq publica productos de su catálogo en tu WooCommerce, mantiene al día precio y stock, y recibe los pedidos. En un marketplace, un pedido con productos de varios vendedores se convierte en un pedido por vendedor.

En WordPress, el plugin agrega una página en WooCommerce → Ecomiq con:

• Conexión en un clic. Apruebas en WordPress y Ecomiq recibe su propia clave de API.
• Actividad. Qué cambió Ecomiq en tu tienda, qué solicitudes fallaron y qué webhooks no llegaron.
• Diagnóstico. Revisa HTTPS, enlaces permanentes, la API REST y los webhooks. Si un firewall o plugin de seguridad bloquea a Ecomiq, dice cuál es y qué IP permitir. También dice si los envíos parciales de WooCommerce están activos y ofrece activarlos.
• Pedidos con varios vendedores. Si un pedido trae productos de varios vendedores, o tuyos y de un vendedor, el recuadro Ecomiq del pedido muestra cada parte con sus productos, su estado y su seguimiento. Cada línea dice quién la envía.
• Webhooks que se recuperan solos. WooCommerce apaga un webhook tras 5 fallas seguidas. El plugin vuelve a activar los de Ecomiq a los 15 minutos.
• Pedidos de otros canales sin cobros. Cuando vendes un producto de tu tienda en otro canal, Ecomiq crea el pedido con el pago y el envío a nombre del canal donde se vendió (por ejemplo «Shopify»): no aparecen en tu checkout, no cobran envío y el comprador no recibe correos de tu tienda. Una nota dice dónde se vendió y con qué número, y la columna Origen de WooCommerce muestra el canal.
• Envío de Ecomiq. Agrega el método «Ecomiq» a una zona de envío y el checkout cobra las tarifas que configuraste en Ecomiq: un envío por vendedor, con su transportista. Si Ecomiq no responde, cobra la tarifa de respaldo que pongas en la zona.
• Estados a tu medida. Si tu tienda usa estados propios (por ejemplo «Despachado»), en Ecomiq eliges qué significa cada uno al recibir pedidos y cuál usar al actualizarlos.
• Desconexión limpia. Borra la clave de API y los webhooks de Ecomiq. Tus productos y pedidos no cambian.

Instalación

1. Descarga el zip y súbelo en Plugins → Añadir nuevo → Subir plugin. Actívalo.

2. En Ecomiq, entra a Canales → Agregar y elige WooCommerce como origen o como canal de venta.

3. Escribe la URL de tu tienda y pulsa Conectar cuenta.

   

4. WordPress muestra qué tienda de Ecomiq pide acceso y con qué usuario. Pulsa Aprobar.

   

5. Vuelves a Ecomiq con la tienda conectada y eliges qué productos traer o publicar.

   

Actualizaciones

Cuando sale una versión nueva, WordPress la avisa en Plugins y en WooCommerce → Ecomiq, y se instala con Actualizar ahora, como cualquier plugin. También puedes activar sus actualizaciones automáticas en Plugins. La conexión con Ecomiq se mantiene.

Las versiones anteriores a la 1.3.0 no traen el aviso: para pasar a la 1.3.0, súbela una vez en Plugins → Añadir nuevo → Subir plugin y elige Reemplazar el actual con el subido. No borres el plugin antes, porque al borrarlo se quita la conexión.

Requisitos

Detalles técnicos

Conexión

OAuth 2.0 con PKCE (S256). El plugin es el servidor de autorización y Ecomiq el cliente.

1. Ecomiq lee GET {tienda}/wp-json/ecomiq/v1/status y lleva al navegador a authorize_url con redirect_uri, state, code_challenge, code_challenge_method=S256 y store.
2. El plugin solo acepta redirect_uri igual a {servidor}/connect/woocommerce. El servidor es https://admin.ecomiq.pe salvo que se cambie en Avanzado.
3. Al aprobar, el navegador vuelve con code y state. El código vence a los 10 minutos y sirve una sola vez.
4. Ecomiq canjea el código con POST {rest_url}ecomiq/v1/token y su code_verifier, y recibe la clave de API.

Hay una clave por tienda: reconectar crea una nueva y borra la anterior. El canje exige HTTPS; solo un WordPress con WP_ENVIRONMENT_TYPE = local lo acepta sin HTTPS.

API REST

Envío

Cuando la zona de la dirección usa el método ecomiq_rates, el plugin manda a Ecomiq los productos del carrito (IDs, SKU, cantidad y precio) y la dirección de envío, firmados con el secreto de los webhooks de Ecomiq. Ecomiq responde un grupo por vendedor con sus tarifas, y el plugin arma un paquete por grupo. Cada tarifa guarda en la línea de envío del pedido la meta ecomiq_rate, oculta en la pantalla del pedido, con la que Ecomiq sabe qué método y transportista eligió el comprador. La respuesta se reutiliza 10 minutos mientras el carrito y la dirección no cambien.

Pedidos

• Sello. Ecomiq guarda en cada producto que publica la meta _ecomiq ({"v":1,"store":…,"listing":…,"product":…}). Al crearse un pedido, desde el checkout clásico o el de bloques, la API REST o la pantalla del pedido, el plugin copia el sello del producto (del padre, si es una variación) a la meta _ecomiq de la línea. Así Ecomiq sabe qué líneas son suyas aunque lea el pedido tarde. La meta no se ve en la pantalla del pedido ni en los correos.
• Partes. Ecomiq escribe en la meta privada _ecomiq_parts del pedido una parte por vendedor y otra con tus productos, cada una con sus líneas, su estado y sus envíos. El plugin la lee para el recuadro y las líneas; no llama a Ecomiq al abrir el pedido.
• Envíos parciales. Con la función Order Fulfillments de WooCommerce (beta desde la 10.2), Ecomiq registra el envío de cada vendedor en el pedido. WooCommerce no tiene un interruptor para activarla: el botón Activar envíos parciales de Diagnóstico pone la opción woocommerce_feature_fulfillments_enabled en yes, y el plugin nunca la activa solo. Si usas WooCommerce Shipping, las etiquetas compradas antes dejan de verse en el pedido (issue #69430).
• Un solo aviso a la compradora. Si Ecomiq ya le avisó con sus envíos (una fulfillment con la meta _ecomiq_shipment), el plugin no manda el correo «Pedido completado» de WooCommerce. Las fulfillments que crea la tienda no cuentan. Sin envíos de Ecomiq, o con los envíos parciales apagados, el correo sale como siempre.

Qué guarda en tu tienda

• Una clave de API de WooCommerce de lectura y escritura, a nombre del usuario que aprobó.
• Los webhooks de productos y pedidos que registra Ecomiq (product.*, order.*).
• Las opciones ecomiq_connection, ecomiq_settings y ecomiq_activity (últimos 50 eventos). La actividad también va al registro de WooCommerce con origen ecomiq.
• La meta _ecomiq en las líneas de los pedidos con productos que publicó Ecomiq.

Al desinstalar el plugin se borran la clave, los webhooks y las opciones. Los pedidos no cambian.

Privacidad

Ecomiq lee y actualiza productos, stock, precios y pedidos, incluidos nombre, correo, teléfono y direcciones del cliente de cada pedido. Si una zona usa el método de Ecomiq, el checkout también le manda el carrito y la dirección de envío para calcular el envío. El plugin agrega ese texto a la guía de privacidad de WordPress. Ecomiq trata los datos según su política de privacidad.

Enlaces

• Ecomiq: el sitio, con precios y contacto.
• Panel de Ecomiq: donde conectas y administras tus canales.
• Documentación: guías y referencia de la API.
• Términos y privacidad.

Desarrollo

Entorno local, datos de prueba, revisión y cómo sacar una versión: docs/desarrollo.md.

Licencia

GPL-2.0-or-later. Ver LICENSE.