Splio

Descripcion

El modulo Splio proporciona integracion completa con la plataforma de marketing Splio. Siempre autentica primero obteniendo un token mediante API key, y luego ejecuta la accion requerida. Soporta operaciones CRUD completas sobre productos: listar con paginacion automatica, crear, actualizar y eliminar. La paginacion automatica permite obtener todos los productos recorriendo todas las paginas con delays configurables para respetar rate limits. Es ideal para sincronizar catalogos de productos entre sistemas y la plataforma Splio.

Este modulo expone multiples nodos:

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

Configuracion

Parametros (get_products)

Parametro	Tipo	Requerido	Descripcion
credentials_id	credentials	Si	Credenciales de Splio
action_splio	text	Si	Accion: get_products
per_page	number	No	Registros por pagina (por defecto: 50)
page_number	number	No	Pagina inicial (por defecto: 1)
auto_paginate	boolean	No	Obtener todas las paginas automaticamente (por defecto: true)
page_limit	number	No	Limite de paginas a obtener
delay_ms_between_pages	number	No	Pausa entre paginas en ms (por defecto: 100)

Parametros (create_product)

Parametro	Tipo	Requerido	Descripcion
credentials_id	credentials	Si	Credenciales de Splio
action_splio	text	Si	Accion: create_product
product_data	json	Si	Datos del producto a crear

Parametros (update_product)

Parametro	Tipo	Requerido	Descripcion
credentials_id	credentials	Si	Credenciales de Splio
action_splio	text	Si	Accion: update_product
product_id	text	Si	ID del producto a actualizar
product_data	json	Si	Datos a actualizar

Parametros (delete_product)

Parametro	Tipo	Requerido	Descripcion
credentials_id	credentials	Si	Credenciales de Splio
action_splio	text	Si	Accion: 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 (pagina unica)

{
  "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-paginacion)

{
  "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

• Autenticacion: 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}
• Documentacion: https://dev-scp.splio.com/reference/

Notas

• El modulo siempre autentica antes de ejecutar cualquier accion
• El token se obtiene nuevo en cada ejecucion
• auto_paginate: true recorre automaticamente todas las paginas acumulando resultados
• page_limit permite limitar el numero de paginas a obtener en modo auto-paginacion
• delay_ms_between_pages introduce una pausa para respetar rate limits
• continueOnError: true permite que el workflow continue aunque la operacion 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