1. Instala el nodo comunitario
En n8n, ve a Settings → Community nodes, instala el paquete n8n-nodes-shalom y reinicia la instancia. Aparecerá como nodo "Shalom API" en el panel de nodos.
Guía de integración · n8n
Integrar Shalom con n8n por API.
El nodo comunitario n8n-nodes-shalom conecta tus flujos de n8n con la API en minutos: rastrea guías, lista agencias, cotiza y crea envíos reales sin escribir HTTP a mano. Funciona en n8n self-hosted v1 o superior.
2. Configura la credencial
Crea la credencial Shalom API con Base URL https://api.shalom-api.lat y tu API key (header x-api-key). El botón Test valida la conexión contra GET /validate.
3. Compón tu flujo
El nodo expone 5 recursos: 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) e Instancias (crear, login, estado). Las operaciones de Shalom Pro piden el instanceId como parámetro.
4. Alternativa: HTTP Request
Si prefieres no usar el nodo, un nodo HTTP Request apuntando a los endpoints logra lo mismo. Ejemplo mínimo para rastrear una guía:
HTTP Request (JSON)
{
"method": "POST",
"url": "https://api.shalom-api.lat/track",
"headers": {
"x-api-key": "TU_API_KEY",
"Content-Type": "application/json"
},
"body": {
"orderNumber": "={{ $json.orderNumber }}",
"orderCode": "={{ $json.orderCode }}"
}
}5. Reacciona a cambios de estado
Registra tu webhook con PUT /webhooks, suscribe guías con POST /tracking/subscriptions y recibe un POST firmado en n8n (nodo Webhook) por cada cambio de estado. Así tus flujos se ejecutan solos, sin polling.