Catálogos de Esco

Consultas de solo lectura que se sirven en vivo desde Esco. Todas devuelven la misma forma — un array de { codigo, descripcion } — y en todos los casos el valor que se envía en el body de apertura es codigo, nunca descripcion.

[
  { "codigo": "16", "descripcion": "SERVICIOS DE ASESORAMIENTO" },
  { "codigo": "4",  "descripcion": "CULTIVO DE CEREALES" }
]

Campo	Tipo	Descripción
codigo	string	El valor a enviar. Se compara sin distinguir mayúsculas en la validación
descripcion	string	Etiqueta legible. Nunca se envía

paises no es paises-cv

Allaria mantiene dos catálogos de países distintos, con códigos distintos: este (Esco) y el de Caja de Valores. Enviar un código de Esco donde se espera un valor de Caja de Valores falla con 422.

Campo	Toma
nacionalidad, codigo_pais_domicilio, tributa_exterior_pais_codigo	El codigo de Esco
lugar_nacimiento	El name de Caja de Valores

Los endpoints

Endpoint	Campos que alimenta
GET/v1/aperturas/actividades	actividad en los dos endpoints de apertura, y en cada persona de una cuenta jurídica
GET/v1/aperturas/paises	nacionalidad, codigo_pais_domicilio, tributa_exterior_pais_codigo
GET/v1/aperturas/provincias	codigo_provincia_domicilio
GET/v1/aperturas/tipos-documento	tipo_documento
GET/v1/aperturas/tipos-registracion-juridica	tipo_registracion_juridica en Abrir cuenta de persona jurídica
GET/v1/aperturas/tipos-riesgo-comitente	Solo referencia — los niveles de riesgo que reconoce Esco

Los tipos de documento dependen del tenant

tipos-documento puede sembrarse por tenant, así que los códigos no son un contrato fijo. Consultá el endpoint en vez de hardcodearlos.

En el catálogo por defecto el 6 es el DNI argentino, y varias validaciones dependen de eso:

• tipo_documento es el código de DNI: documento, numero_tramite_dni, cuil y tipo_contribuyente_iva se validan de forma más estricta.
• Cualquier otro código: se validan como para un titular extranjero.

Request

Headers

Campo	Tipo	Requerido	Descripción
Authorization	string	Sí	Access token en formato Bearer ACCESS_TOKEN

No aplica: Path Parameters, Query Parameters, Body.

Response

2XX Éxito

Ver la forma al principio de esta página.

Códigos de error

Status	Descripción
401	Unauthorized — access token inválido o ausente
403	Forbidden — tus credenciales no están autorizadas para Aperturas
500	Internal Server Error — Esco no responde o devolvió un error. Estos catálogos se proxean en vivo, así que un 500 acá normalmente significa que Esco está caído, no que tu request esté mal

Ejemplo de código

Todos los endpoints de esta página toman el mismo request. Reemplazá el path.

cURL

curl -X GET "https://b2b.allaria.cloud/v1/aperturas/actividades" \
  -H "Authorization: Bearer ACCESS_TOKEN"

JavaScript

const response = await fetch('https://b2b.allaria.cloud/v1/aperturas/actividades', {
  method: 'GET',
  headers: { 'Authorization': 'Bearer ACCESS_TOKEN' }
});
const actividades = await response.json();

Python

import requests
response = requests.get(
  'https://b2b.allaria.cloud/v1/aperturas/actividades',
  headers={'Authorization': 'Bearer ACCESS_TOKEN'}
)
actividades = response.json()

Node.js

const axios = require('axios');
const response = await axios.get('https://b2b.allaria.cloud/v1/aperturas/actividades', {
  headers: { Authorization: 'Bearer ACCESS_TOKEN' }
});
const actividades = response.data;

Cacheo

Estos listados cambian poco, y cada request de apertura los vuelve a validar. Cacheálos de tu lado y refrescálos periódicamente en vez de llamarlos en cada request.