Splio

Descripción

El modulo Splio proporciona integración completa con la plataforma de marketing Splio. Siempre autentica primero obteniendo un token mediante API key, y luego ejecuta la acción requerida. Soporta operaciones CRUD completas sobre productos: listar con paginación automática, crear, actualizar y eliminar. La paginación automática permite obtener todos los productos recorriendo todas las páginas con delays configurables para respetar rate limits. Es ideal para sincronizar catalogos de productos entre sistemas y la plataforma Splio.

Este modulo expone múltiples nodos:

• Splio get Products: Obtiene listado de productos con paginación
• Splio create_product: Crea un nuevo producto
• Splio update_product: Actualiza un producto existente
• Splio delete_product: Elimina un producto

Configuración

Parámetros (get_products)

Parámetro	Tipo	Requerido	Descripción
credentials_id	credentials	Si	Credenciales de Splio
action_splio	text	Si	Acción: get_products
per_page	number	No	Registros por página (por defecto: 50)
page_number	number	No	Página inicial (por defecto: 1)
auto_paginate	boolean	No	Obtener todas las páginas automáticamente (por defecto: true)
page_limit	number	No	Limite de páginas a obtener
delay_ms_between_pages	number	No	Pausa entre páginas en ms (por defecto: 100)

Parámetros (create_product)

Parámetro	Tipo	Requerido	Descripción
credentials_id	credentials	Si	Credenciales de Splio
action_splio	text	Si	Acción: create_product
product_data	json	Si	Datos del producto a crear

Parámetros (update_product)

Parámetro	Tipo	Requerido	Descripción
credentials_id	credentials	Si	Credenciales de Splio
action_splio	text	Si	Acción: update_product
product_id	text	Si	ID del producto a actualizar
product_data	json	Si	Datos a actualizar

Parámetros (delete_product)

Parámetro	Tipo	Requerido	Descripción
credentials_id	credentials	Si	Credenciales de Splio
action_splio	text	Si	Acción: delete_product
product_id	text	Si	ID del producto a eliminar

Credenciales

La credencial debe contener el campo:

• Token (o api_key, apikey, password): API Key de Splio

El modulo busca la API key en los campos Token, api_key, apikey o password de la credencial (en ese orden de prioridad).

Salida

get_products (página única)

{
  "nextModule": "siguiente_modulo",
  "data": {
    "splio_products": [
      { "id": "PROD001", "name": "Producto A" }
    ],
    "splio_products_meta": {
      "count_element": 500,
      "current_page": 1,
      "per_page": 50,
      "total_pages": 10
    }
  }
}

get_products (auto-paginación)

{
  "nextModule": "siguiente_modulo",
  "data": {
    "splio_products": [
      { "id": "PROD001", "name": "Producto A" },
      { "id": "PROD002", "name": "Producto B" }
    ],
    "splio_products_meta": {
      "count_element": 500,
      "per_page": 50,
      "start_page": 1,
      "total_pages": 10,
      "fetched_pages": 10
    }
  }
}

create_product

{
  "nextModule": "siguiente_modulo",
  "data": {
    "splio_product_created": { "id": "PROD003" },
    "status": 200
  }
}

Ejemplo de Uso

Obtener todos los productos

{
  "credentials_id": "cred_splio_01",
  "action_splio": "get_products",
  "auto_paginate": true,
  "per_page": 50,
  "delay_ms_between_pages": 100
}

Crear producto

{
  "credentials_id": "cred_splio_01",
  "action_splio": "create_product",
  "product_data": "{\"name\": \"Nuevo Producto\", \"price\": 29.99}"
}

API Utilizada

• Autenticación: POST https://api.splio.com/authenticate
• Listar productos: GET https://api.splio.com/data/v1/products?per_page={n}&page_number={n}
• Crear producto: POST https://api.splio.com/data/v1/products
• Actualizar producto: PATCH https://api.splio.com/data/v1/products/{id}
• Eliminar producto: DELETE https://api.splio.com/v1/products/{id}
• Documentación: https://dev-scp.splio.com/reference/

Notas

• El modulo siempre autentica antes de ejecutar cualquier acción
• El token se obtiene nuevo en cada ejecución
• auto_paginate: true recorre automáticamente todas las páginas acumulando resultados
• page_limit permite limitar el número de páginas a obtener en modo auto-paginación
• delay_ms_between_pages introduce una pausa para respetar rate limits
• continueOnError: true permite que el workflow continue aunque la operación falle
• Los campos _meta_ se eliminan recursivamente del payload antes de enviar en operaciones de escritura
• En create_product, el body se toma del data de entrada (eliminando _meta_)

Nodos Relacionados

• Todos los nodos de Splio comparten el parentNode splio: Splio get Products, Splio create_product, Splio update_product, Splio delete_product