Action Sales

Descripcion

El modulo Action Sales permite conectarse a la API de Action Sales CRM para obtener y enviar datos. Utiliza autenticacion mediante API Key y API Secret que se agregan como parametros de la URL. Incluye reintentos automaticos con backoff exponencial para errores de red, errores 5xx y rate limiting (429). Soporta variables dinamicas en la URL y deteccion inteligente de errores de API (respuestas con excepciones). Es ideal para sincronizar datos con el CRM Action Sales, obtener listados de clientes, ventas, o cualquier recurso disponible en su API.

Configuracion

Parametro	Tipo	Requerido	Descripcion
credentials_id	credentials	Si	Credenciales de Action Sales
actionsales_endpoint	text	Si	Endpoint de la API (se agrega despues de la URL base)
method	select	Si	Metodo HTTP: GET o POST
dataKey	text	No	Clave de datos para filtrado. Puede ser un atributo de un objeto o un array (ej: ‘data’ o ‘data[0].id’)

Credenciales

La credencial debe contener los campos:

• apiKey: API Key de Action Sales
• apiSecret: API Secret de Action Sales

Ambos valores se agregan como parametros de query string en cada peticion: ?ApiKey={apiKey}&ApiSecret={apiSecret}

Salida

{
  "nextModule": "siguiente_modulo",
  "data": {
    "clientes": [
      { "id": 1, "nombre": "Cliente A" }
    ]
  },
  "_meta_": {
    "url": "https://api.actionsales.com.ar/endpoint?ApiKey=...&ApiSecret=...",
    "data": {}
  }
}

Ejemplo de Uso

Caso basico

{
  "credentials_id": "cred_actionsales_01",
  "actionsales_endpoint": "api/clientes/list",
  "method": "GET"
}

Con variables dinamicas

{
  "credentials_id": "cred_actionsales_01",
  "actionsales_endpoint": "api/ventas/{{fechaInicio}}/{{fechaFin}}",
  "method": "GET"
}

API Utilizada

• URL base: https://api.actionsales.com.ar
• Formato: https://api.actionsales.com.ar/{endpoint}?ApiKey={key}&ApiSecret={secret}
• Autenticacion mediante ApiKey y ApiSecret en query string

Notas

• Soporta variables dinamicas {{variable}} en la URL completa
• Incluye reintentos automaticos (hasta 3) con backoff exponencial para errores de red, 5xx y 429
• El timeout por defecto es de 5 segundos (configurable via config.timeout)
• Se envian headers de User-Agent simulando un navegador Chrome
• El modulo detecta errores de API que vienen como excepciones (campo ClassName con exception) y los trata como errores
• continueOnError: true permite que el workflow continue aunque la API devuelva error
• Si los datos de entrada tienen contenido, se envian como body con Content-Type application/json
• Las credenciales de la API se envian como parametros de URL, no como headers

Nodos Relacionados

• http (peticiones HTTP genericas)
• odooApi (lectura de APIs con paginacion)