Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/lucumaagency/woocommerce-inventario/archive/refs/heads/main.zipPlugin de WordPress que extiende WooCommerce para operar varias tiendas físicas + la tienda virtual:
- Inventario por sede — stock independiente por cada tienda.
- Recojo en tienda — sin delivery por web; el cliente compra y recoge en la sede elegida.
- POS de mostrador — cobro presencial que genera pedidos WooCommerce.
- Caja chica — apertura, ingresos, egresos y arqueo por sede y turno.
Se apoya en WooCommerce (productos, pedidos, pagos, Local Pickup). No lo reemplaza.
Requisitos
- WordPress 6.0+
- PHP 7.4+
- WooCommerce 7.0+
Estado del desarrollo
| Fase | Módulo | Estado |
|---|---|---|
| 1 | Esqueleto + Sedes + Roles | ✅ Implementado |
| 2 | Inventario multi-sede | ✅ Implementado |
| 3 | Recojo en tienda | ✅ Implementado |
| 4 | POS de mostrador | ✅ Implementado |
| 5 | Caja chica | ✅ Implementado |
| + | Compra por tienda (stock por sede en la web) | ✅ Implementado (v1.1.0) |
| + | Boletas electrónicas SUNAT (emisión, cola, anulación, ticket con QR) | ✅ Implementado |
| + | Impresión ESC/POS por RawBT (terminales Android tipo iMin Falcon 1) | ✅ Implementado (v1.22.0) |
| + | Facturas electrónicas en la web (RUC en el checkout) | ✅ Implementado (v1.23.0) · sin notas de crédito |
| + | Facturas en el POS de mostrador | ✅ Implementado (v1.25.0) |
| + | Notas de crédito (devoluciones) con aprobación del gerente | ✅ Implementado (v1.26.0) |
| + | Varias empresas emisoras (multi-RUC) | ✅ Implementado (v1.24.0) |
Compra por tienda
Desde la v1.1.0, la tienda online opera por sede: el cliente elige una tienda y solo ve y compra el stock de esa sede. El stock que muestra WooCommerce, la validación de carrito y la sede de recojo se basan en la tienda elegida.
Coloca el selector donde quieras con el shortcode [msp_selector_sede] (además aparece un banner automático en las páginas de tienda, producto, carrito y checkout).
La Fase 1 ya crea: el menú Sedes, los roles Gerente de sede y Cajero, y las tablas msp_stock, msp_caja_sesiones y msp_caja_movimientos (listas para las fases siguientes).
Instalación
- Copiar la carpeta
multisede-posawp-content/plugins/(o instalar vía Git Updater, ver abajo). - Activar Multisede POS desde Plugins.
- Aparece el menú Sedes: crear las tiendas físicas y marcar una como tienda virtual.
Despliegue GitHub → WordPress (Git Updater)
El archivo principal incluye las cabeceras GitHub Plugin URI y Primary Branch. Pasos:
- Crear el repo en GitHub y editar en
multisede-pos.phplas líneas:Plugin URI:yGitHub Plugin URI:→ poner tu usuario/repo real.
- Instalar el plugin Git Updater en el WordPress.
- Conectar el repositorio; a partir de ahí cada release/tag se ofrece como actualización desde el panel de WP.
Para producción se puede migrar a un deploy por GitHub Actions (SFTP/SSH).
Estructura
multisede-pos/
├── multisede-pos.php # archivo principal
├── uninstall.php
├── includes/
│ ├── class-msp-plugin.php # bootstrap
│ ├── class-msp-activator.php # tablas + roles
│ ├── class-msp-deactivator.php
│ ├── class-msp-sedes.php # CPT sede
│ └── class-msp-roles.php
└── languages/