Finnegans ERP

Descripción

Los nodos Finnegans conectan tus workflows con el ERP Finnegans GO / Teamplace a través de su API REST. Con ellos podés leer, listar, crear, actualizar y eliminar registros de cualquier entidad del ERP: proveedores, pedidos, comprobantes, productos, recibos, órdenes de pago, clientes, etc.

Hay cinco nodos genéricos, uno por operación:

Nodo	Operación	Método HTTP
Finnegans: Leer entidad (`finnegansGet`)	Lee un registro por su id/código	`GET /{Entidad}/{id}`
Finnegans: Listar entidad (`finnegansList`)	Lista/consulta con filtros	`GET /{Entidad}`
Finnegans: Crear entidad (`finnegansCreate`)	Crea un registro	`POST /{Entidad}`
Finnegans: Actualizar entidad (`finnegansUpdate`)	Actualiza un registro	`PUT /{Entidad}`
Finnegans: Eliminar entidad (`finnegansDelete`)	Elimina un registro	`DELETE /{Entidad}/{id}`

En todos, Entidad es el nombre del recurso en Finnegans (por ejemplo Proveedor, Pedido, Producto).

Credencial

Los nodos usan una credencial de tipo Finnegans ERP. Creala en Credenciales → Agregar → Finnegans ERP con estos campos:

Campo	Descripción
URL base del API	La URL de tu instancia, sin barra final. Por defecto `https://api.teamplace.finneg.com/api` (algunas instancias usan un subdominio por empresa).
Client ID	Se genera en el ERP: Configuración → Seguridad → Usuarios → Keys api.
Client Secret	Se genera junto al Client ID. Nunca se muestra en logs.
Entorno	Producción o Sandbox.

La autenticación es OAuth2 (client_credentials): los nodos obtienen automáticamente un token con tu Client ID/Secret, lo reutilizan mientras es válido (≈1 hora) y lo renuevan solos cuando expira. No tenés que gestionar el token manualmente. En instalaciones con varios servidores, el token se comparte entre ellos para minimizar las llamadas de autenticación al ERP.

Configuración

Comunes a todos los nodos

Parámetro	Tipo	Requerido	Descripción
credentials_id	credentials	Sí	Credencial de Finnegans
entity	texto	Sí	Nombre de la entidad (ej. `Proveedor`, `Pedido`)

Por nodo

Leer (finnegansGet): id (requerido) — id o código del registro. params (JSON, opcional) — parámetros extra de query.
Listar (finnegansList): filters (JSON, opcional) — filtros de consulta (paginación, campos, etc.).
Crear (finnegansCreate): body (JSON, opcional) — el registro a crear. Si se deja vacío, se usan los datos de entrada del nodo.
Actualizar (finnegansUpdate): id (opcional, según la entidad) y body (JSON, opcional; si se deja vacío usa los datos de entrada).
Eliminar (finnegansDelete): id (requerido).

Nodos convenientes (atajos por entidad)

Además de los cinco genéricos, hay atajos para las entidades más usadas: ya traen la entidad prefijada y campos con nombres claros, así no tenés que recordar el nombre exacto del recurso.

Nodo	Qué hace	Equivale a
Finnegans: Obtener proveedor (`finnegansGetProvider`)	Lee un proveedor por su código	`finnegansGet` con entity `Proveedor`
Finnegans: Obtener producto (`finnegansGetProduct`)	Lee un producto por su código	`finnegansGet` con entity `Producto`
Finnegans: Crear pedido (`finnegansCreateOrder`)	Crea un pedido	`finnegansCreate` con entity `Pedido`
Finnegans: Crear comprobante (`finnegansCreateInvoice`)	Crea un comprobante/factura	`finnegansCreate` con entity `Comprobante`

En los de creación, el cuerpo se toma del campo correspondiente (Pedido / Comprobante, en JSON) o, si se deja vacío, de los datos de entrada del nodo. Si tu instancia nombra el recurso distinto (por ejemplo PedidoVenta o Factura), podés sobrescribir el nombre en el campo Entidad del propio nodo.

Ejemplo

Leer el proveedor con código 4249:

Nodo: Finnegans: Leer entidad
entity: Proveedor
id: 4249

Salida (los datos de la entidad tal como los devuelve Finnegans):

{
  "Nombre": "EMPRESA PROVINCIAL DE ENERGIA DE CORDOBA",
  "Codigo": "4249",
  "Activo": true,
  "IdentificacionTributariaNumero": "30-99902748-9"
}

Manejo de errores

Cada nodo clasifica los errores para que el motor sepa si tiene sentido reintentar:

Situación	Reintentable	Qué hacer
Validación (400/422)	No	Finnegans devuelve el motivo (ej. “Falta especificar la organización”). Corregí los datos de entrada.
No encontrado (404)	No	La entidad o el id no existen. Revisá el nombre de la entidad y el id.
Autenticación (401/403)	No	Client ID/Secret inválidos o sin permiso. Revisá la credencial.
Servidor (500)	Sí	Error temporal del ERP; se reintenta automáticamente.
Red / Timeout / Límite (429)	Sí	Problema pasajero; se reintenta automáticamente.

El mensaje de error de Finnegans se propaga tal cual al workflow, para que puedas verlo en la traza de ejecución.

Ver también

Cola de reintentos (DLQ) — cómo se reintentan las ejecuciones que fallan.
Nodo HTTP — para llamar a endpoints de Finnegans no cubiertos por estos nodos.