Catálogos de Caja de Valores

Consultas de solo lectura para los campos que se validan contra Caja de Valores en lugar de Esco. Devuelven { id, name, code } — y a diferencia de los catálogos de Esco, cuál de los dos se envía depende del campo.

[
  { "id": 1, "name": "Argentina", "code": "1" },
  { "id": 2, "name": "Brasil", "code": "3" }
]

Campo	Tipo	Descripción
id	integer	Identificador interno de la fila. No se usa en los bodies de apertura
name	string	Nombre legible. Se envía en lugar_nacimiento
code	string	Código de Caja de Valores. Se envía en localidad

name o code — no son intercambiables

lugar_nacimiento se valida contra paises-cv.name, así que se envía "Argentina". localidad se valida contra localidades-cv.code, así que se envía el código, no el nombre de la localidad. Confundir uno por otro es el 422 más frecuente en los campos de esta página.

Los códigos de acá tampoco son los códigos de país de Esco — ver la advertencia en Catálogos de Esco.

Los endpoints

Endpoint	Campo que alimenta	Valor a enviar
GET/v1/aperturas/paises-cv	lugar_nacimiento	name
GET/v1/aperturas/localidades-cv	localidad	code
GET/v1/aperturas/localidades-ext-cv	Localidades fuera de Argentina	code

Las filas de localidades-cv traen además un campo esco — la localidad equivalente en Esco — que Allaria usa internamente para traducir el valor. No se envía.

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 — error interno del servidor

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/paises-cv" \
  -H "Authorization: Bearer ACCESS_TOKEN"

JavaScript

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

Python

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

Node.js

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

Cacheo

Estos listados están almacenados en Allaria y cambian poco. Cacheálos de tu lado en vez de llamarlos una vez por cuenta.