n8n-nodes-ditextil-inventory

Community node de n8n para usar la API de la app Ditextil Inventory sin configurar nodos HTTP manualmente.

Qué hace

En n8n aparecerá el nodo:

Ditextil Inventory

Con recursos visuales:

• Producto
• Stock
• Venta
• Recepción
• Borrador
• Bodega
• Cliente
• Catálogo

Ejemplo: para generar reporte de stock ya no necesitas configurar GET, URL, query params, etc. Solo eliges:

Ditextil Inventory → Stock → Get Stock Report

y completas campos visuales:

• Estado de Stock: Todos / Con Stock / Sin Stock
• Buscar Producto
• ID Categoría
• ID Proveedor
• ID Bodega

Internamente llama a:

GET /api/stock/report

Operaciones incluidas

Stock

• Get Stock Report → GET /api/stock/report
• Listar Balance Por Bodega → GET /api/stock
• Listar Movimientos → GET /api/movements
• Crear Movimiento → POST /api/inventory/movements
• Transferir Stock → POST /api/inventory/transfers

Producto

• Listar Productos → GET /api/products
• Obtener Producto → GET /api/products/{id}
• Crear Producto → POST /api/products
• Actualizar Producto → PATCH /api/products/{id}

Incluye campos para:

• nombre
• SKU
• categoría
• proveedor
• precio venta
• precio costo
• imagen original
• imagen catálogo

Venta

• Crear Venta → POST /api/orders/sales
• Cancelar / Devolución → POST /api/orders/sales/{id}/cancel

Recepción

• Listar Recepciones → GET /api/receptions
• Obtener Recepción → GET /api/receptions/{id}
• Crear Recepción → POST /api/orders/receptions

Borrador

• Crear Borrador Desde Texto → POST /api/orders/text-drafts
• Listar Borradores → GET /api/order-drafts
• Obtener Borrador → GET /api/order-drafts/{id}
• Confirmar Borrador → POST /api/order-drafts/{id}/confirm
• Eliminar Borrador → DELETE /api/order-drafts/{id}

Bodega / Cliente / Catálogo

• Listar/crear bodegas
• Listar/crear clientes
• Listar categorías
• Listar proveedores
• Ver stats

Instalación local para desarrollo

Desde esta carpeta:

cd /Users/emimon/Desktop/ditextil/productos_html/n8n-nodes-ditextil-inventory
npm install
npm run build
npm link

Luego en la carpeta donde n8n corre localmente:

npm link n8n-nodes-ditextil-inventory

Reinicia n8n.

Instalación si usas Docker

Si n8n está en Docker, debes instalar el paquete dentro del contenedor o montar esta carpeta. Para que n8n dentro de Docker llegue a la app local Ditextil, usa normalmente:

http://host.docker.internal:8088

en vez de:

http://127.0.0.1:8088

Credenciales

Crea credenciales tipo:

Ditextil API

Campos:

• Base URL: http://127.0.0.1:8088 si n8n corre local.
• Base URL: http://host.docker.internal:8088 si n8n corre en Docker.
• API Key: opcional por ahora.

Ejemplo: reporte de stock

1. Agrega nodo Ditextil Inventory.
2. Selecciona recurso Stock.
3. Selecciona operación Get Stock Report.
4. Elige:
   • Estado de Stock: Con Stock
   • ID Bodega: 0 para todas, o el ID de bodega.
5. Ejecuta.

Resultado: n8n recibe el JSON completo de /api/stock/report con resumen, grupos y filas.

Estado

MVP funcional compilado con TypeScript. Pendiente para publicación pública en npm:

• cambiar URL de repositorio en package.json,
• agregar icono oficial si se desea,
• publicar con npm publish,
• agregar auth real cuando la app Ditextil tenga API key obligatoria.