Glosario
Los términos e identificadores que aparecen en todas las secciones de este sitio. La mayoría son específicos del mercado de capitales argentino, y varios son palabras en español que se mantienen así porque son el nombre literal de un campo de la API.
Identificadores de cuenta
El número de cuenta de Allaria y el CVU de la billetera son dos cosas distintas.
El número de cuenta se escribe de formas diferentes según la familia de endpoints, porque cada una sigue la convención de su propio backend — pero siempre es el mismo número.
| Qué enviás | Dónde | Qué es |
|---|---|---|
comitente | Bodies de request y response de Aperturas | El número de cuenta de Allaria |
account-id | Path parameters de Trading | El mismo número |
account_number | Bodies de respuesta de Trading, Planes de ahorro y Posición | El mismo número |
accountNumber | Algunos endpoints de MEP | El mismo número |
accountId | Algunos endpoints de Trading | El mismo número |
cvu | Path parameters de Allaria+ | No es lo mismo. El CVU de una cuenta de billetera de Allaria+ |
external_id | Aperturas | Tu propio identificador, no el de Allaria. Lo elegís vos al abrir la cuenta y lo usás para consultar el estado |
onboarding_id | Onboarding | Identifica un onboarding en curso, no una cuenta. Deja de ser útil una vez que la cuenta existe |
client_id | Vincular cuentas | No es una cuenta. El id que Allaria le asigna a tu integración; Allaria vincula tus cuentas a él para que tus credenciales puedan leerlas; consultá el avance con el endpoint de estado de la vinculación. Solicitalo a Allaria |
O sea: el comitente que te devolvió Aperturas es lo que va en {account-id} cuando pedís las órdenes de esa cuenta, y en account_number cuando leés una posición.
Términos
comitente — el número de cuenta que un cliente tiene en Allaria. Es el nombre literal del campo de la API, así que la doc lo mantiene en los dos idiomas.
CUIT / CUIL — la identificación tributaria argentina. El CUIT corresponde a una empresa, el CUIL a una persona humana. Los dos tienen 11 dígitos.
CVU — Clave Virtual Uniforme. El identificador de una cuenta virtual en el sistema de pagos argentino, el equivalente al CBU pero para una billetera en vez de un banco. Las cuentas de Allaria+ tienen uno; las cuentas bursátiles no.
CBU — Clave Bancaria Uniforme. El identificador de una cuenta bancaria en Argentina.
CXU — el nombre genérico para un CBU o un CVU. Los campos llamados cxu devuelven cualquiera de los dos, según cuál identifique a la cuenta.
MEP — Mercado Electrónico de Pagos. En la práctica, el "dólar MEP" es la vía legal de comprar o vender dólares en Argentina a través del mercado de valores. Es una vía de liquidación, no una moneda.
La operación tiene dos patas, y los endpoints de Operaciones MEP ejecutan las dos:
- se compra un bono en pesos;
- se vende el mismo bono en dólares.
PPT — precio de punta a punta, las puntas que se usan para valuar una operación MEP.
SENEBI — Segmento de Negociación Bilateral de BYMA. Se usa para operaciones MEP por fuera del libro abierto.
PRI — Perfil de Riesgo del Inversor: Riesgo Bajo, Riesgo Medio o Riesgo Alto. Determina qué instrumentos puede operar un cliente.
PSP — Proveedor de Servicios de Pago, inscripto ante el BCRA. Si tu empresa lo es, ver Servicios para PSPs.
Sujeto obligado — empresa inscripta ante la UIF, legalmente responsable del KYC/AML de sus clientes. Que tu empresa lo sea o no define si usás Onboarding o Aperturas.
UIF — Unidad de Información Financiera, el organismo antilavado.
BCRA — Banco Central de la República Argentina.
CNV — Comisión Nacional de Valores, el regulador del mercado de capitales.
ALyC — Agente de Liquidación y Compensación. Allaria lo es, y para eso son los endpoints del tab Allaria.
BYMA — Bolsas y Mercados Argentinos.
CEDEAR — Certificado de Depósito Argentino, un certificado que representa una acción del exterior y se opera en pesos en BYMA.
FCI — Fondo Común de Inversión. Los endpoints de Fondos comunes de inversión operan estos.
Cuotapartista — inversor registrado en fondos comunes de inversión (FCI). La cuenta cuotapartista es independiente de la cuenta comitente y se identifica por el CUIT de la empresa; ver Cuentas cuotapartistas.
Tenencia — los activos que tiene una cuenta. Aparece como tenencia en algunos paths de los endpoints de PSP.
Sistemas que vas a ver nombrados
Son sistemas internos de Allaria. Nunca los llamás directamente — todo pasa por la base URL de Introducción — pero sus nombres aparecen en paths y mensajes de error, así que conviene saber qué son.
| Nombre | Qué es | Dónde lo ves |
|---|---|---|
| Esco | El back office bursátil. Tiene las cuentas y posiciones de registro | get-esco-position, el campo esco en respuestas de Aperturas, errores 500 |
| Caja de Valores | El depositario central de valores argentino. La apertura registra al titular ahí | Catálogos de Aperturas (paises-cv, localidades-cv) |
| Renaper | Registro Nacional de las Personas. Valida el DNI al abrir una cuenta | renaper en respuestas de Aperturas |
| Repet | Registro de personas inhabilitadas para operar. Se consulta al abrir una cuenta | repet en respuestas de Aperturas |
| OMS | El sistema de gestión de órdenes que las rutea al mercado | get-oms-position |
| Nasdaq | El motor detrás de algunos pasos del alta de cuenta | ejecutados / pendientes en el estado de Aperturas |
Dos nombres de servicios internos también aparecen dentro de paths de cara al cliente, por razones de infraestructura. No significan nada para vos y podés tratarlos como segmentos opacos:
/v1/bymas/allaria/...— los endpoints de Movimientos, Posición y vinculación de cuentas./v1/broker/...y/v1/operations/...— los endpoints de Trading.
Sobre el español en paths y valores
Algunos paths y valores de enum están en español porque son los nombres reales que espera el backend, y cambiarlos en la doc haría que los ejemplos no funcionen:
/v1/aperturas/cuentas-por-cuit,/v1/psp/fondos/{fondo}/cotizacion,/v1/aperturas/cuentas/pri- valores como
Riesgo Medio,No Residente,Si, directamente,Menos de 1.300.000
Envialos exactamente como están escritos, con acentos incluidos.