Instalar el nodo de n8n
Instala el nodo comunitario n8n-nodes-shalom en n8n self-hosted y conecta Shalom API a tus flujos: tracking, agencias, cotizaciones y creación de envíos sin escribir HTTP a mano.
El nodo comunitario n8n-nodes-shalom conecta tus flujos de n8n (self-hosted v1+) con Shalom API en minutos: rastrea guías, lista agencias, cotiza, valida DNI y crea envíos reales en Shalom Pro. Requiere una API key y, para las operaciones Pro, una instancia conectada.
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: se genera al crear tu cuenta en shalom-api.lat y la copias en el panel, en API Key. Las operaciones de Shalom Pro necesitan además un plan que incluya instancias.
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.
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 n8nConfigura 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 /validateConoce 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/loginFlujo 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.
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.
Preguntas frecuentes
No. Los nodos comunitarios requieren una instancia self-hosted de n8n.
Con el botón Test de la credencial, que consulta GET /validate y confirma que la API key está activa.
Como parámetro de cada operación de Shalom Pro, no en la credencial. Admite expresiones como ={{ $json.instanceId }}.
No. Para reaccionar a cambios de estado sin polling conviene usar webhooks; el nodo sirve para las llamadas puntuales del flujo.
En github.com/ronnaldrangel/n8n-nodes-shalom, y el paquete publicado se llama n8n-nodes-shalom en npm.