Ingresar al portal

Documentación de la API

Referencia de los endpoints disponibles de Alfy Inversiones S.A.. Para usar la API necesitás un token de acceso.

URL base
https://nexus.alfyinversiones.com.ar
Autenticación

Obtené un token con POST /api/v1/auth/token (email + contraseña de API). Luego enviá el token en cada llamada protegida:

Authorization: Bearer <token>

Los endpoints públicos (como el de token) se pueden probar acá mismo. Para probar los endpoints protegidos, iniciá sesión en el portal y el token se genera automáticamente.

Autenticación

POST /api/v1/auth/token Público
Autenticación — Token

Devuelve un token JWT válido por 24 horas. El token se envía luego en la cabecera Authorization: Bearer <token>.

La contraseña de API se setea al crear el usuario en el portal y se le informa al cliente. Es distinta de la contraseña de acceso al panel. El token devuelto es válido por 24 horas.
Ejemplo de request
{
  "username": "acá_va_tu_email",
  "password": "acá_va_tu_contraseña_de_api"
}
Ejemplo de respuesta
{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "Bearer",
  "expires_in": 86400,
  "expires_at": "2026-06-10T15:48:54Z",
  "user": {
    "id": 1,
    "name": "Luis Heredia",
    "email": "[email protected]"
  }
}
curl
curl -X POST https://nexus.alfyinversiones.com.ar/api/v1/auth/token \
  -H "Content-Type: application/json" \
  -d '{
  "username": "acá_va_tu_email",
  "password": "acá_va_tu_contraseña_de_api"
}'
Probar este endpoint

Clientes

GET /api/v1/clientes Requiere token
Clientes — Listado

Devuelve los clientes (comitentes) importados desde la API externa de Gallo, filtrados por el número de manager del usuario que generó el token (solo se devuelven los clientes cuyo Productor coincide). Internamente solicita un token a Gallo y luego consulta los clientes. Params opcionales: fecd, fech, limit.

Requiere un token válido de api.alfyinversiones. La obtención del token de Gallo es interna y transparente. El resultado se filtra por el número de manager del usuario que generó el token (campo Productor). Si el usuario no tiene un número de manager asignado, devuelve 403 y no entrega la lista.
Ejemplo de respuesta
{
  "total": 1,
  "manager": 7,
  "clientes": [
    {
      "Nombre": "CALCAGNO, WALTER GUSTAVO",
      "FechaAlta": "18/09/2023",
      "Productor": "7",
      "CUIT": "20164924271",
      "Activa": "true",
      "Comitente": "53865",
      "TipoPersona": "Fisica",
      "OficialCuenta": "1",
      "EstadoCuenta": 0
    }
  ]
}
curl
curl -X GET https://nexus.alfyinversiones.com.ar/api/v1/clientes \
  -H "Authorization: Bearer <token>"
Probar este endpoint

Este endpoint requiere token. Para probarlo desde la web iniciá sesión en el portal: el token se genera automáticamente con tu sesión, sin cargar email ni contraseña.

Iniciar sesión
GET /api/v1/cuenta Requiere token
Cuenta — Datos

Devuelve los datos completos de cuentas comitentes importados desde la API externa de Gallo (DatosCuenta). Con el parámetro opcional 'comi': devuelve los datos de ese comitente, validando que pertenezca al manager. Sin 'comi': itera sobre todos los comitentes del manager y devuelve el array completo.

Requiere un token válido de api.alfyinversiones. El parámetro 'comi' es opcional: sin él se devuelven todos los comitentes del manager; con él se devuelven solo los datos de ese comitente (si no pertenece al manager devuelve 403). Internamente consulta primero GetClientes para obtener los comitentes del manager. La obtención del token de Gallo es interna.
Ejemplo de request
{
  "comi": "507"
}
Ejemplo de respuesta
{
  "Titular": {
    "CodigoComitente": "507",
    "Nombre": "PEREZ CLAUDIO GABRIEL - CPD",
    "CUIT": "20232099330",
    "Email": "[email protected]",
    "Domicilio": "AVDA. LA PLATA 2500",
    "Localidad": "BAHIA BLANCA",
    "Provincia": "2",
    "CodigoPostal": "8000",
    "Pais": "1",
    "Telefono": "2914380444",
    "Celular": "",
    "Contacto": "PEREZ CLAUDIO GABRIEL",
    "NDocumento": "23209933",
    "TipoDocumento": "2",
    "FechaNacimiento": "19730904",
    "Sexo": "0",
    "EstadoCivil": "0",
    "TipoPersona": "0",
    "Manager": "30",
    "OficialDeCuenta": "0",
    "NiveldeRiesgo": "1",
    "CondicionIVA": "0",
    "InscripcionGanancias": "0",
    "EstadoCuenta": "0",
    "Referencia": ""
  },
  "Condominos": [],
  "Registros": "1",
  "Success": "TRUE"
}
curl
curl -X GET https://nexus.alfyinversiones.com.ar/api/v1/cuenta \
  -H "Authorization: Bearer <token>"
Probar este endpoint

Este endpoint requiere token. Para probarlo desde la web iniciá sesión en el portal: el token se genera automáticamente con tu sesión, sin cargar email ni contraseña.

Iniciar sesión
GET /api/v1/aliquidar Requiere token
Operaciones — A liquidar

Devuelve las operaciones pendientes a liquidar de los clientes del manager, importadas desde la API externa de Gallo (GetALiquidar). Gallo devuelve la totalidad de clientes; el filtro por manager se aplica server-side cruzando el campo Comitente con los clientes del manager obtenidos de GetClientes.

Requiere un token válido de api.alfyinversiones. No acepta parámetros adicionales: Gallo devuelve todas las operaciones y el filtro por manager se aplica server-side usando el campo Comitente. Campos clave: FechaLiquidacion (fecha de liquidación pendiente), Operacion (COMPRA/VENTA/SUSCRIPCION FCI/etc.), ImportePesos, Cantidad, PrecioPromedio, Ticker, NombreEspecie.
Ejemplo de respuesta
{
  "total": 2,
  "manager": 7,
  "operaciones": [
    {
      "Comitente": "507",
      "NombreComitente": "PEREZ CLAUDIO GABRIEL - CPD",
      "NumeroOperacion": "38",
      "FechaOperacion": "05/08/2021",
      "FechaLiquidacion": "09/08/2021",
      "Ticker": "CRES",
      "NombreEspecie": "CRESUD",
      "CodigoEspecie": "00274",
      "Operacion": "COMPRA",
      "CodigoOperacion": "1",
      "Cantidad": "12",
      "PrecioPromedio": "52.07",
      "ImportePesos": "624.83",
      "ImporteMoneda": "0",
      "Moneda": "PESOS",
      "Corresponsal": "0",
      "NombreCorresponsal": "BANCO DE VALORES S.A. DEPOSITARIA",
      "Estado": ""
    },
    {
      "Comitente": "507",
      "NombreComitente": "PEREZ CLAUDIO GABRIEL - CPD",
      "NumeroOperacion": "40",
      "FechaOperacion": "06/08/2021",
      "FechaLiquidacion": "10/08/2021",
      "Ticker": "PAMP",
      "NombreEspecie": "PAMPA ENERGIA S.A.",
      "CodigoEspecie": "00457",
      "Operacion": "COMPRA",
      "CodigoOperacion": "1",
      "Cantidad": "34",
      "PrecioPromedio": "43.04",
      "ImportePesos": "1463.44",
      "ImporteMoneda": "0",
      "Moneda": "PESOS",
      "Corresponsal": "999999",
      "NombreCorresponsal": "BYMA",
      "Estado": ""
    }
  ]
}
curl
curl -X GET https://nexus.alfyinversiones.com.ar/api/v1/aliquidar \
  -H "Authorization: Bearer <token>"
Probar este endpoint

Este endpoint requiere token. Para probarlo desde la web iniciá sesión en el portal: el token se genera automáticamente con tu sesión, sin cargar email ni contraseña.

Iniciar sesión
GET /api/v1/operaciones Requiere token
Operaciones — Del día

Devuelve las operaciones del día de comitentes importadas desde la API externa de Gallo (OperacionesDia). La fecha siempre es la del día actual (seteada server-side). Con el parámetro opcional 'comi': devuelve las operaciones de ese comitente, validando que pertenezca al manager. Sin 'comi': itera sobre todos los comitentes del manager y devuelve el array completo de operaciones aplanado.

Requiere un token válido de api.alfyinversiones. La fecha (fecd) siempre es la del día actual en formato dd/mm/aa, seteada automáticamente por el servidor. El parámetro 'comi' es opcional: sin él se devuelven las operaciones de todos los comitentes del manager (array aplanado por especie); con él se devuelven solo las operaciones de ese comitente (403 si no pertenece al manager). Cada operación agrupa por especie con Detalle (operaciones individuales) y TotaleEspecie (resumen).
Ejemplo de request
{
  "comi": "507"
}
Ejemplo de respuesta
{
  "fecha": "11/07/26",
  "comi": "507",
  "total": 2,
  "operaciones": [
    {
      "Nombre": "CRESUD",
      "Codigo": "00274",
      "Ticker": "CRES",
      "Detalle": [
        {
          "Numero": "0",
          "Moneda": "$",
          "Cantidad": "1",
          "Ticker": "CRES",
          "NetoenPesos": "79.85",
          "BrutoBoleto": "49.55",
          "Gastos": "30.3",
          "Operacion": "CPRA",
          "Precio": "49.55",
          "NetoenMoneda": "0"
        },
        {
          "Numero": "0",
          "Moneda": "$",
          "Cantidad": "600",
          "Ticker": "CRES",
          "NetoenPesos": "30088.12",
          "BrutoBoleto": "29700",
          "Gastos": "388.12",
          "Operacion": "CPRA",
          "Precio": "49.5",
          "NetoenMoneda": "0"
        }
      ],
      "TotaleEspecie": [
        {
          "CantidadVenta": "0",
          "Moneda": "Pesos",
          "CantidadCompra": "601",
          "ImporteCompra": "29749.55",
          "ImporteVenta": "0"
        }
      ]
    },
    {
      "Nombre": "EDENOR ORDS I V",
      "Codigo": "00508",
      "Ticker": "EDN",
      "Detalle": [
        {
          "Numero": "0",
          "Moneda": "$",
          "Cantidad": "100",
          "Ticker": "EDN",
          "NetoenPesos": "4239.69",
          "BrutoBoleto": "4185",
          "Gastos": "54.69",
          "Operacion": "CPRA",
          "Precio": "41.85",
          "NetoenMoneda": "0"
        }
      ],
      "TotaleEspecie": [
        {
          "CantidadVenta": "0",
          "Moneda": "Pesos",
          "CantidadCompra": "100",
          "ImporteCompra": "4185",
          "ImporteVenta": "0"
        }
      ]
    }
  ]
}
curl
curl -X GET https://nexus.alfyinversiones.com.ar/api/v1/operaciones \
  -H "Authorization: Bearer <token>"
Probar este endpoint

Este endpoint requiere token. Para probarlo desde la web iniciá sesión en el portal: el token se genera automáticamente con tu sesión, sin cargar email ni contraseña.

Iniciar sesión
GET /api/v1/saldos Requiere token
Saldos — Pesos y Dólares

Devuelve los saldos en pesos y dólares de todas las cuentas comitentes, importados desde la API externa de Gallo (GetPesosDolares). Internamente solicita un token a Gallo y luego consulta los saldos. No aplica filtro por manager: devuelve todas las cuentas tal como las retorna Gallo.

Requiere un token válido de api.alfyinversiones. La obtención del token de Gallo es interna y transparente. Devuelve el campo Resultado de Gallo tal cual, que contiene la clave PesosyDolares: un array de cuentas, cada una con Comitente, Nombre y Detalle (array por moneda con saldos desagregados por plazo de liquidación: 24horas, 48horas, 72horas, Mas72horas, Garantia, Vencido).
Ejemplo de respuesta
{
  "PesosyDolares": [
    {
      "Comitente": "400",
      "Nombre": "ALLARIA SA - SENEBI",
      "Detalle": [
        {
          "Moneda": "PESOS",
          "24horas": "-165028884875.3",
          "48horas": "0",
          "72horas": "0",
          "Mas72horas": "0",
          "Garantia": "0",
          "Vencido": "0"
        },
        {
          "Moneda": "DOLAR MEP",
          "24horas": "125706",
          "48horas": "0",
          "72horas": "0",
          "Mas72horas": "0",
          "Garantia": "0",
          "Vencido": "0"
        }
      ]
    },
    {
      "Comitente": "507",
      "Nombre": "PEREZ CLAUDIO GABRIEL - CPD",
      "Detalle": [
        {
          "Moneda": "PESOS",
          "24horas": "0",
          "48horas": "0",
          "72horas": "0",
          "Mas72horas": "0",
          "Garantia": "0",
          "Vencido": "186285.5"
        }
      ]
    }
  ]
}
curl
curl -X GET https://nexus.alfyinversiones.com.ar/api/v1/saldos \
  -H "Authorization: Bearer <token>"
Probar este endpoint

Este endpoint requiere token. Para probarlo desde la web iniciá sesión en el portal: el token se genera automáticamente con tu sesión, sin cargar email ni contraseña.

Iniciar sesión
GET /api/v1/ordenes Requiere token
Órdenes — Estado

Devuelve el estado de las órdenes de comitentes importados desde la API externa de Gallo (EstadoOrden). Con el parámetro opcional 'comi': devuelve las órdenes de ese comitente, validando que pertenezca al manager. Sin 'comi': itera sobre todos los comitentes del manager y devuelve el array completo de órdenes aplanado. El campo ESTA indica el estado: Enviada, Cumplida o Anulada.

Requiere un token válido de api.alfyinversiones. El parámetro 'comi' es opcional: sin él se devuelven las órdenes de todos los comitentes del manager (array aplanado); con él se devuelven solo las órdenes de ese comitente (403 si no pertenece al manager). Estados posibles en el campo ESTA: Enviada, Cumplida, Anulada. Internamente consulta GetClientes para validar pertenencia.
Ejemplo de request
{
  "comi": "507"
}
Ejemplo de respuesta
{
  "total": 1,
  "comi": "507",
  "ordenes": [
    {
      "especie": "CRES",
      "totalImpoCompraPesos": "49.55",
      "totalcantVenta": "0",
      "totalImpoCompraDolarC": "0",
      "listaDetalleTiker": [
        {
          "ESPE": "CRES",
          "AMPL": "CRES- CRESUD",
          "HORA": "CONCLUIDA",
          "TOT1": "1",
          "TOT2": "49.55",
          "TOT3": "0",
          "TOT4": "0",
          "ORDE": [
            {
              "NUME": "5866",
              "TICK": "CRES",
              "TIPO": "CPRA",
              "ESTA": "Cumplida",
              "CANT": "1",
              "PCIO": "49.55",
              "IMPO": "49.55",
              "PLAZ": "48 Hs.",
              "FALT": "12/08/21",
              "FVTO": "12/08/21",
              "HORA": "100849",
              "CESP": "00274",
              "CPTE": "CPRA",
              "REFE": "",
              "OFFL": "",
              "APLI": [
                {
                  "CANT": "1",
                  "PCIO": "49.55",
                  "IMPO": "49.55",
                  "FALT": "12/08/21",
                  "HORA": "103342"
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}
curl
curl -X GET https://nexus.alfyinversiones.com.ar/api/v1/ordenes \
  -H "Authorization: Bearer <token>"
Probar este endpoint

Este endpoint requiere token. Para probarlo desde la web iniciá sesión en el portal: el token se genera automáticamente con tu sesión, sin cargar email ni contraseña.

Iniciar sesión

Exportar la API

Usá la especificación en tu herramienta favorita o importá el flujo listo para n8n.

OpenAPI 3

Especificación estándar de la API. Podés importarla en Postman, Insomnia, Bruno, Swagger UI / Redoc, generadores de código (openapi-generator) y agentes de IA. Importá la URL directamente o descargá el archivo.

https://nexus.alfyinversiones.com.ar/openapi.json
Ver Descargar OpenAPI
Workflow para n8n

n8n no importa OpenAPI, así que este archivo trae el flujo ya armado: disparador → nodo que obtiene el token → un nodo HTTP por endpoint con el Authorization: Bearer ya conectado. En n8n: Workflows → Import from File, y después completá tu email y contraseña de API en el nodo "Obtener token".

Descargar workflow n8n