Cuentas por CUIT

Verifica si una persona o entidad ya tiene cuentas abiertas en Allaria, sin importar el canal por el que fueron abiertas. Consulta en vivo a Esco.

GET/v1/aperturas/cuentas-por-cuit

Request

Headers

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

No aplica: Path Parameters, Body.

Query Parameters

Campo	Tipo	Requerido	Descripción
cuit	string	Sí	CUIT o CUIL de la persona o entidad. Numérico, de 10 a 12 dígitos.

Response

2XX Éxito

Status: 200 OK

Si el CUIT/CUIL no tiene cuentas abiertas, tiene_cuenta es false y comitentes viene vacío.

Campo	Tipo	Descripción
error	boolean	Siempre false en una respuesta exitosa.
errorMsg	string | null	Siempre null en una respuesta exitosa.
cuit	string	El CUIT/CUIL consultado.
tiene_cuenta	boolean	true si el CUIT/CUIL tiene al menos una cuenta abierta en Allaria.
comitentes	array	Cuentas (comitentes) asociadas al CUIT/CUIL. Vacío cuando tiene_cuenta es false.
comitentes[].comitente	string	Número de comitente.
comitentes[].cod_comitente	number | null	Código interno de comitente.
comitentes[].descripcion	string | null	Nombre del titular tal como está registrado en Esco.

Esco no disponible:

{
  "error": true,
  "errorMsg": "El servicio no está disponible, por favor reintente más tarde.",
  "cuit": "20370872946",
  "tiene_cuenta": null,
  "comitentes": null
}

Esta respuesta se devuelve con status HTTP 503 — ver Códigos de error.

Códigos de error

Status	Descripción
401	Unauthorized — token de acceso inválido o ausente
422	Unprocessable Entity — falta cuit o no es un número de 10 a 12 dígitos
503	Esco no está disponible. Misma estructura que 200, con error en true y tiene_cuenta/comitentes en null.

Ejemplo de código

cURL

curl -X GET "https://b2b.allaria.dev/v1/aperturas/cuentas-por-cuit?cuit=20370872946" \
  -H "Authorization: Bearer ACCESS_TOKEN"

JavaScript

const response = await fetch('https://b2b.allaria.dev/v1/aperturas/cuentas-por-cuit?cuit=20370872946', {
  method: 'GET',
  headers: { 'Authorization': 'Bearer ACCESS_TOKEN' }
});
const data = await response.json();
console.log(data);

Python

import requests
response = requests.get(
  'https://b2b.allaria.dev/v1/aperturas/cuentas-por-cuit',
  params={ 'cuit': '20370872946' },
  headers={ 'Authorization': 'Bearer ACCESS_TOKEN' }
)
data = response.json()
print(data)

Node.js

const axios = require('axios');
const response = await axios.get('https://b2b.allaria.dev/v1/aperturas/cuentas-por-cuit', {
  params: { cuit: '20370872946' },
  headers: { Authorization: 'Bearer ACCESS_TOKEN' }
});
console.log(response.data);

2XX Éxito

{
  "error": false,
  "errorMsg": null,
  "cuit": "20370872946",
  "tiene_cuenta": true,
  "comitentes": [
    {
      "comitente": "400000123",
      "cod_comitente": 123,
      "descripcion": "Perez, Juan"
    }
  ]
}