Netvy Custom Nodes for n8n

Custom nodes for integrating the Netvy ERP API with n8n. Source of truth: openapi/ (144 specs OpenAPI 3.2.0).

Included Nodes

1. Netvy (API Unificada)

Resource-based node. Current resources:

| Recurso | Operaciones | Spec | |---------|------------|------| | Auth | Sign In, Refresh Token, Me, Sign Out, Change Active Company | openapi/auth.yaml v1.3.0 | | Artículos WMS | Listar, Obtener, Crear, Modificar, Eliminar, Reactivar, Consultar Precio, Subir Imagen, Ajuste Masivo | openapi/articulos-wms.yaml v1.0.0 |

Authentication modes: Credentials (n8n credential) or From Input Item (legacy webhook compat).

2. Netvy Trigger

Webhook trigger that receives POST events from Netvy. Optional login verification on receive.

Roadmap

• Iteración 2: Tickets CRM + GD + Catálogos
• Iteración 3: CRM (ofertas, oportunidades, tarjetas, calls)
• Iteración 4: WMS completo + MES + Kanban
• Full plan: see PLAN.md

Quick Install (Docker Self-Hosted)

# 1. Copy .tgz to the n8n container
docker cp n8n-nodes-netvy-1.1.1.tgz <container>:/tmp/

# 2. Install inside the container
docker exec -it <container> sh -c "cd ~/.n8n/nodes && npm install /tmp/n8n-nodes-netvy-1.1.1.tgz"

# 3. Set env var (if not already set)
# N8N_CUSTOM_EXTENSIONS=/home/node/.n8n/nodes

# 4. Restart
docker restart <container>

Custom Dockerfile

FROM n8nio/n8n:latest
USER root
RUN mkdir -p /home/node/.n8n/nodes
COPY n8n-nodes-netvy-1.1.1.tgz /tmp/
RUN cd /home/node/.n8n/nodes && npm install /tmp/n8n-nodes-netvy-1.1.1.tgz
ENV N8N_CUSTOM_EXTENSIONS=/home/node/.n8n/nodes
USER node

Development

npm install           # Install dependencies
npm run build         # Build (tsc + icons)
npm pack              # Create .tgz for distribution
npm run dev           # Watch mode

Project Structure

n8n-nodes-netvy/
├── openapi/                 # 144 OpenAPI specs (canonical source)
├── credentials/
│   └── NetvyApi.credentials.ts
├── nodes/
│   ├── Netvy/
│   │   ├── Netvy.node.ts    # Unified node
│   │   ├── GenericFunctions.ts  # Auth + HTTP helpers
│   │   └── resources/
│   │       ├── auth.ts
│   │       └── articulos.ts
│   └── NetvyTrigger/
│       └── NetvyTrigger.node.ts
├── index.ts
├── package.json
├── tsconfig.json
├── PLAN.md
└── README.md