Instalar el nodo de n8n

1. Instala el nodo comunitario

En n8n, ve a Settings → Community nodes, busca e instala el paquete n8n-nodes-shalom (o cópialo en ~/.n8n/custom). Reinicia n8n: el nodo "Shalom API" aparece en el panel de nodos.

# Opción A: desde la UI de n8n (Settings → Community nodes) buscar "n8n-nodes-shalom"

# Opción B: instalación manual en el directorio custom de n8n
mkdir -p ~/.n8n/custom
npm install n8n-nodes-shalom --prefix ~/.n8n/custom/n8n-nodes-shalom
# Reinicia n8n

2. Configura la credencial Shalom API

Al arrastrar el nodo al flujo, crea la credencial Shalom API. El botón Test valida tu conexión contra GET /validate. Las operaciones Shalom Pro piden el instanceId como parámetro de cada nodo (p. ej. con la expresión {{ $json.instanceId }}).

Base URL: https://api.shalom-api.lat
API Key:  sk_tu_api_key   (header x-api-key)

# Botón Test → valida contra GET /validate

3. Conoce los 5 recursos del nodo

Agencias (listar y búsqueda avanzada) · Ubicaciones (departamentos, provincias, distritos) · Tracking (rastrear, lote, comprobante, etiqueta) · Cuentas (cotizar, DNI, registrar envío individual o masivo, pendientes, usuario) · Instancias (crear, listar, eliminar, login, estado, logout).

Agencias    → GET /agencies, GET /agencies/search
Ubicaciones → GET /locations/departments, .../provinces, .../districts
Tracking    → POST /track, POST /track/batch, GET /track/voucher, GET /track/label
Cuentas     → POST /account/quote, GET /account/dni/:dni, POST /account/register,
              POST /account/register-bulk, POST /account/pending-shipments, POST /account/get-user
Instancias  → POST /instances, GET /instances, DELETE /instances, POST /instances/login

4. Flujo de ejemplo: registrar y rastrear

Flujo típico de ecommerce: Instancias → Iniciar sesión (Shalom Pro) con instanceId + usuario + contraseña; Cuentas → Registrar envío individual (o masivo con shipments[] y securityCode); Tracking → Rastrear envío con orderNumber y orderCode; opcionalmente Tracking → Descargar comprobante para adjuntar el voucher.

5. Sin polling: usa webhooks

Registra tu URL con PUT /webhooks y suscribe guías con POST /tracking/subscriptions (nodo Webhook de n8n apuntando a tu endpoint). Recibirás un POST firmado por cada cambio de estado sin consultar en bucle.

Qué necesitas antes de empezar

Una instancia de n8n self-hosted, versión 1 o superior. Los nodos comunitarios no se pueden instalar en n8n Cloud, así que si usas el servicio hospedado este camino no aplica.

Y una API key, que se solicita por WhatsApp y llega el mismo día.

Instalar el nodo

Desde n8n: Settings → Community nodes → instalar el paquete `n8n-nodes-shalom` y reiniciar la instancia. También puedes instalarlo con npm y copiarlo en la carpeta de nodos custom.

Al reiniciar, el nodo aparece en el panel como «Shalom API».

Configurar la credencial

La credencial pide dos cosas: la base URL `https://api.shalom-api.lat` y tu API key, que viaja en el header `x-api-key`.

Usa el botón Test para validarla contra GET /validate antes de montar el flujo. Te dice si la key está activa y cuánto has consumido en el mes.

Los cinco recursos del nodo

Agencias, Ubicaciones, Tracking, Cuentas e Instancias. Las operaciones de Shalom Pro piden el instanceId como parámetro de cada nodo, no a nivel de credencial, así que puedes tener varias instancias en el mismo flujo.

Un flujo típico

Iniciar sesión en la instancia, registrar el envío, rastrearlo y avisar. Y si quieres reaccionar a los cambios de estado sin consultar cada rato, suma un webhook en lugar de un bucle de polling.