Antes de empezar
Necesitás plan Business, o Pro con el complemento API y desarrollador. Entrá como ADMIN. Tu tienda tiene que ser HTTPS. En esta versión, productos simples (sin combinaciones de talla o color).
En Inventario, dejá visibles en el catálogo público los productos que van a la web. El código de barras de Kipu es el SKU de la tienda.
Cómo funciona
El plugin copia a la tienda solo lo público. Cuando el cliente paga, Kipu arma una factura cobrada: entra al libro fiscal. El stock lo manda Kipu; la tienda no lleva un segundo inventario de esos productos.
Lo recomendado es Conectar con Kipu (iniciás sesión y autorizás). El modo avanzado es pegar una clave kipu_live_ de Configuración → Desarrollador: se muestra una sola vez. Los avisos (stock y ventas) van con una firma kipu_whsec_, también una sola vez. Si Conectar no la registró, pulsá Registrar avisos.
Descargá los plugins
En Configuración → Desarrollador o Integraciones están los botones Descargar plugin WooCommerce y Descargar módulo PrestaShop.
Misma descarga en tu sitio: /downloads/kipu-woocommerce.zip y /downloads/kipu-prestashop.zip. Código y versiones: github.com/Chourioz/kipu/releases.
WooCommerce
Descargá el plugin en Configuración → Desarrollador o Integraciones (botón Descargar plugin WooCommerce). La misma URL en tu sitio: /downloads/kipu-woocommerce.zip. En WordPress: Plugins → Subir plugin. Activá Kipu for WooCommerce (hace falta WooCommerce).
WooCommerce → Kipu. Poné la URL de Kipu (https://app.kipuapp.store o la de tu instancia). Pulsá Conectar con Kipu, iniciá sesión como ADMIN y autorizá. Tiene que decir Conectada.
Probar conexión. Registrar avisos si falta la firma. En Modo avanzado, mapeá cada pasarela a Efectivo, Transferencia, Zelle, Tarjeta o Pago móvil. Sincronizar productos. Hacé un pedido de prueba y pagalo. En Kipu → Ventas tiene que aparecer la factura cobrada.
Si no podés usar Conectar: creá una clave en Desarrollador, pegala en Modo avanzado y registrá avisos. Un pedido con un producto sin mapeo no arma factura a medias: queda un error en el pedido.
- SKU de Woo = código de barras de Kipu
- Solo productos visibles en el catálogo público
- Woo no descuenta de nuevo el stock de productos ya conectados
PrestaShop 8
Descargá el módulo (Descargar módulo PrestaShop, o /downloads/kipu-prestashop.zip). El ZIP extrae la carpeta kipu: copiala a modules/kipu. Module Manager → Kipu → Instalar → Configurar.
Poné la URL de Kipu y pulsá Conectar con Kipu. Probar conexión, registrar avisos, mapear pagos, sincronizar. La referencia de Presta es el código de barras de Kipu. Pagá un pedido de prueba y mirá Ventas en Kipu.
Tu página, n8n u otro sistema
En Desarrollador creá una clave kipu_live_ (una sola vez). Con esa clave tu servidor o n8n habla con Kipu.
Listá productos y publicá en la web solo los del catálogo público. Cuando el pago está confirmado, creá la factura. Usá una clave de idempotencia estable (por ejemplo el número de pedido) para no duplicar ventas si n8n reintenta.
En Avisos a tu servidor registrá una URL HTTPS pública (no localhost ni redes internas). Copiá la firma kipu_whsec_ una sola vez. Cuando llegue un cambio de stock, actualizá tu web. No llevés un segundo inventario.
Qué no hace esta versión
No hay variantes, ni empujar el catálogo de la tienda hacia Kipu, ni un libro fiscal aparte para la web. Lo cobrado en la web es venta de Kipu. Hoy no se anulan facturas ya cobradas desde la tienda.
Si rotás una clave o la firma, Kipu te dice qué pegar en el plugin. Si habías usado Conectar, Desconectá y volvé a Conectar. Si rotás la conexión en Integraciones, el plugin tiene que conectar de nuevo.
Dudas: support@kipuapp.store.