Introducción

Esta sección es la API bursátil de Allaria: todo lo que se hace con una cuenta después de que existe.

• Colocar órdenes.
• Leer posiciones y movimientos.
• Comprar y vender dólares por MEP.
• Operar fondos comunes de inversión.
• Operar planes de ahorro.
• Consultar datos de mercado.
• Invertir en fondos comunes los saldos de los clientes de un PSP.

Allaria es un ALyC (Agente de Liquidación y Compensación, inscripto ante la CNV).

Antes de empezar

Tres cosas tienen que estar dadas, en orden. Los endpoints de acá las asumen todas.

1. Credenciales y un token. Ver Primeros pasos.
2. Una cuenta abierta. Nada de acá crea cuentas. La cuenta sale de Onboarding si tu empresa no es sujeto obligado, o de Aperturas si lo es.
3. El número de la cuenta. Todos los endpoints de esta sección identifican la cuenta por su comitente — el número que devolvió Onboarding o Aperturas. Aparece con varios nombres distintos según el endpoint; ver Identificadores de cuenta.

Un número, varias formas de escribirlo

Todos estos son el comitente:

• account-id en los paths de Trading;
• account_number en la mayoría de los bodies de respuesta;
• accountNumber en algunos endpoints de MEP.

El cvu es el único identificador que no es lo mismo — pertenece a una cuenta de billetera de Allaria+, no a una cuenta bursátil.

Para qué es cada sección

Sección	Usala cuando	Notas
Movimientos	Necesitás el historial de movimientos de una cuenta, o querés que te notifiquen cuando entran fondos	listen-fund-deposits es un webhook que recibís, no un endpoint que llamás
Posición	Necesitás qué tiene la cuenta hoy y cuánto vale	Es una foto. Para la vista del sistema de trading, ver get-oms-position y get-esco-position en Trading
Planes de ahorro	Tu cliente invierte un monto recurrente en un plan administrado	Los términos y condiciones tienen que estar aceptados para cada nueva suscripción
Datos de mercado	Necesitás precios: el tipo de cambio del dólar, o cotizaciones de fondos	Solo lectura y no depende de una cuenta, así que no necesita comitente
Trading	Tu cliente compra o vende: órdenes, dólares MEP, fondos, comisiones, perfil de riesgo, documentos firmados	La sección más grande. Está ordenada aproximadamente en la secuencia en que se necesita
Servicios para PSPs	Tu empresa es un PSP e invierte los saldos de sus clientes en un fondo común de Allaria	Un flujo end-to-end con su propia introducción. Solo para PSPs

Trading, en el orden en que se usa

La sección Trading tiene ocho subsecciones, listadas en el sidebar en el orden en que las vas a necesitar. La secuencia para colocar la primera orden de un cliente es:

1. Perfil de inversión — leé el PRI del cliente. Define qué instrumentos puede operar. Una orden fuera de su perfil se rechaza.
2. Documentos — el cliente tiene que tener firmados los términos y condiciones, y para algunas operaciones la declaración jurada diaria. check-document-signed te dice si los tiene.
3. Datos de referencia — get-byma-data para los instrumentos operables, get-holiday-assessment para saber si el mercado está abierto.
4. Comisiones — calculate-fees antes de confirmar, para poder mostrarle al cliente el costo real.
5. Operaciones — check-operation-allowed es el chequeo previo que combina todo lo anterior.
6. Órdenes — colocala: a mercado, limitada o stop-limit. Después get-order-by-id o get-orders-by-account para seguirla.

Operaciones MEP y Fondos comunes de inversión son flujos aparte que no pasan por Órdenes:

• Operaciones MEP compra o vende dólares a través del mercado de valores. Son dos patas — comprar un bono en pesos, venderlo en dólares — que Allaria ejecuta por vos:
  1. Cotizá con get-mep-quote.
  2. Ejecutá con execute-mep-operation.
  3. Después consultá get-mep-operation-status.
  4. create-mep-transfer saca los dólares resultantes.
• Fondos comunes de inversión suscribe y rescata FCIs con create-mutual-fund-operation y después get-mutual-fund-operation-by-id.

Paths que parecen inconsistentes

En esta sección aparecen tres formas y las tres son correctas — reflejan cómo se alcanza cada servicio, no un error de la doc.

Forma	Secciones	Por qué
/v1/bymas/allaria/...	Movimientos, Posición	bymas es un nombre de servicio interno que quedó en el path público. Tratalo como un segmento opaco
/v1/broker/... y /v1/operations/...	Trading	Misma situación, otro servicio
/v1/psp/fondos/{fondo}/cotizacion, /v1/psp/tenencia-val	Servicios para PSPs	El servicio que los atiende tiene sus rutas en español. Envialos exactamente como están documentados

No hay nada que configurar por esto. Ver Sistemas que vas a ver nombrados si un nombre en un path o en un mensaje de error te resulta desconocido.

Errores frecuentes

Síntoma	Causa
403 en todos los endpoints de una sección	Tus credenciales no están autorizadas para ese producto — contactá a integraciones@allaria.com.ar
404 en una cuenta que existe	Enviaste un cvu donde se esperaba un comitente, o al revés. Ver Identificadores de cuenta
Una orden se rechaza como no permitida	El PRI del cliente no cubre ese instrumento, o falta un documento firmado. Corré check-operation-allowed primero
Una operación falla fuera del horario de mercado	El mercado está cerrado. Chequeá get-holiday-assessment
El request expira por timeout, sin código de estado	Tu IP no está whitelisteada — ver Acceso