Catálogos de persona e impositivos

Enumeraciones cortas para los atributos personales e impositivos del titular. Están almacenadas en Allaria — no se proxean desde Esco — y cada fila tiene una opcion (la etiqueta) y, en algunas, un codigo.

Cuál se envía cambia según el catálogo. La tabla de abajo es el mapeo autoritativo; los valores se listan completos porque estos listados son cortos y estables.

Endpoint	Campo que alimenta	Valor a enviar
GET/v1/aperturas/es-pep	es_pep	opcion
GET/v1/aperturas/sexo	sexo	codigo
GET/v1/aperturas/estado-civil	estado_civil	codigo
GET/v1/aperturas/residencia-fiscal	residencia_fiscal	opcion
GET/v1/aperturas/provincia-fiscal	provincia_fiscal	opcion
GET/v1/aperturas/tipos-contrib-iva	tipo_contribuyente_iva	codigo

Las cuentas jurídicas usan IDs, no etiquetas

En Abrir cuenta de persona jurídica, la entidad y sus accionistas toman residencia_fiscal_id y provincia_fiscal_id — el id de la fila, no su opcion. El endpoint de persona humana toma el string de opcion. Mismos catálogos, campo distinto.

Condición PEP — es-pep

Se envía opcion.

opcion
No
Si, directamente
Sí, por vínculo familiar

Cualquier valor distinto de No vuelve obligatorio a motivo_consideracion_pep — siempre en cuentas jurídicas, y en cuentas de persona humana para PSPs externos.

Sexo — sexo

Se envía codigo.

codigo	opcion
1	masculino
2	femenino
3	otro

Estado civil — estado-civil

Se envía codigo. Ojo que los códigos no son secuenciales en el orden del listado.

codigo	opcion
1	soltero/a
2	casado/a
3	divorciado/a
4	separado/a
5	viudo/a
7	conviviente

Tipo de contribuyente de IVA — tipos-contrib-iva

Se envía codigo.

codigo	opcion
CF	Consumidor Final
EX	Exento
NC	No categorizado
RI	Responsable Inscripto
RM	Responsable Monotributo

En Abrir cuenta de persona humana este campo solo se exige para tipos de documento extranjeros — cuando tipo_documento no es el código de DNI, pasa a ser obligatorio. Con DNI argentino se ignora.

Residencia fiscal — residencia-fiscal

Se envía opcion — el nombre del país en español, por ejemplo Argentina, Estados Unidos, Brasil. El listado cubre todos los países, así que consultá el endpoint en vez de embeberlo.

Dos campos condicionales dependen de este valor:

Cuando residencia_fiscal es…	Entonces
cualquier valor distinto de Argentina	numero_impositivo (la identificación tributaria del exterior / NIT) pasa a ser obligatorio
Estados Unidos	ssn pasa a ser obligatorio

Provincia fiscal — provincia-fiscal

Se envía opcion.

opcion
CABA, Buenos Aires, Catamarca, Chaco, Chubut, Córdoba, Corrientes, Entre Ríos, Formosa, Jujuy, La Pampa, La Rioja, Mendoza, Misiones, Neuquén, Río Negro, Salta, San Juan, San Luis, Santa Cruz, Santa Fé, Santiago del Estero, Tierra del Fuego, Tucumán, No Residente

Las grafías son exactas: Santa Fé lleva acento, CABA va abreviado, y un titular fuera de Argentina usa No Residente.

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

Campo	Tipo	Descripción
id	integer	Identificador de la fila. Se envía como residencia_fiscal_id / provincia_fiscal_id solo en cuentas jurídicas
opcion	string	La etiqueta
codigo	string	El código. Ausente en es-pep, residencia-fiscal y provincia-fiscal, que no tienen código — ahí se envía opcion

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

JavaScript

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

Python

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

Node.js

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

2XX Éxito

[
  { "id": 1, "opcion": "soltero/a", "codigo": "1" },
  { "id": 2, "opcion": "conviviente", "codigo": "7" }
]