“2021 - AÑO DE HOMENAJE AL PREMIO NOBEL DE MEDICINA DR.

CÉSAR MILSTEIN”

INFORME TÉCNICO DE SOLUCIÓN

Censo Nacional Económico INDEC

Extranet

Aplicaciones de Banca Central

Versión 1.1

22/02/2021

Banco Central de la República Argentina 1

 “2021 - AÑO DE HOMENAJE AL PREMIO NOBEL DE MEDICINA DR. CÉSAR MILSTEIN”

1 Tabla de contenido

1 Tabla de contenido ...........................................................................................................................................2

2 Introducción .....................................................................................................................................................3
3 Accesos Extranet...............................................................................................................................................3
4 Homologación...................................................................................................................................................3
5 Especificación Técnica ......................................................................................................................................3
5.1 Servicio Web API REST ..............................................................................................................................4
5.1.1 Introducción .....................................................................................................................................4
5.1.2 Censo Económico API REST ..............................................................................................................5

Banco Central de la República Argentina 2

 “2021 - AÑO DE HOMENAJE AL PREMIO NOBEL DE MEDICINA DR. CÉSAR MILSTEIN”

2 Introducción
El presente documento especifica la solución técnica que permite a las Entidades Financieras disponer de un
servicio de verificación de cumplimiento del Censo Nacional Económico (CNE) informado por el INDEC para ser
consumido en el ambiente de extranet.

3 Accesos Extranet

Homologación
verificador.homologacion.bcra.sfa 192.168.10.35 https
verificadorweb.homologacion.bcra.sfa 192.168.10.37 https

Producción
verificador.bcra.sfa 192.168.10.36 https
verificadorweb.bcra.sfa 192.168.10.38 https

4 Homologación
La homologación del servicio se realizará sobre un entorno de prueba tanto de servicios como de base de datos.

Para la invocación al servicio en el ambiente de homologación se provee un lote de CUIT que puede descargar
de https://aplicaciones.homologacion.bcra.sfa Ayuda en Línea, cuya respuesta será que aún no han realizado
el Censo (Censado = false).

5 Especificación Técnica
El siguiente esquema muestra a nivel funcional, la vía de comunicación automática, sobre el contexto en el cual
se encuentra enmarcado el sistema.

EXTRANET

HTTPS
API REQUEST GET /api/censoeconomico/{CUITEntidad/{CUIT}

API RESPONSE Service

Entidades Financieras Verificador
Censo Economico
API REST

Banco Central de la República Argentina 3

 “2021 - AÑO DE HOMENAJE AL PREMIO NOBEL DE MEDICINA DR. CÉSAR MILSTEIN”

5.1 Servicio Web API REST

5.1.1 Introducción
5.1.1.1 Propiedades del Header HTTP
Para poder consumir el servicio API REST, es necesario enviar los siguientes campos en el header HTTP.

Content Type
application/json
Authorization
Bearer TOKEN_STRING

5.1.1.2 Authorization

Se informa que el TOKEN_STRING a ser utilizado para la invocación del presente servicio es el mismo que la
entidad financiera hace uso hoy en día para comunicarse contra el servicio de control de cambio.

5.1.1.3 TimeOut de Transacción

Se propone que el tiempo estándar y por defecto de timeout para una transacción es de 10 segundos. En caso
de presentarse un gran número de transacciones concurrentes, este valor puede ascender a valores cercanos a
los 30 ó 40 segundos.

5.1.1.4 Disponibilidad del servicio Censo Económico API REST

El servicio API REST Censo Económico se encontrará operativo los 365 días del año, estando en línea de las
09:00 am a 18:00 pm. Para conocer el estado actual del servicio, mediante la ejecución de un GET, se obtiene
un JSON el cual informa si la API se encuentra activa.

5.1.1.4.1 API GET

URL
Homologación: https://verificador.homologacion.bcra.sfa/api/healthcheck/censoeconomico
Producción: https://verificador.bcra.sfa/api/healthcheck/censoeconomico
Método
GET
Content Type
application/json

Banco Central de la República Argentina 4

 “2021 - AÑO DE HOMENAJE AL PREMIO NOBEL DE MEDICINA DR. CÉSAR MILSTEIN”

5.1.1.4.2 API Response

5.1.2 Censo Económico API REST

El servicio API REST es el encargado de atender todas las transacciones entrantes por parte de las entidades
financieras realizando la consulta de un CUIT para obtener la verificación de dicho CUIT en las bases del BCRA.
Dicho servicio se encuentra expuesto para que pueda ser consumido por las entidades directamente mediante
un HTTP GET con los datos solicitados.

5.1.2.1 API GET

URL
Homologación: https://verificador.homologacion.bcra.sfa/api/censoeconomico/{CUITEntidad}/{CUIT}
Producción: https://verificador.bcra.sfa/api/censoeconomico/{CUITEntidad}/{CUIT}
Método
GET
Content Type
Query string
Authorization
Bearer TOKEN_STRING

Contenido
Requerido Long. Long.
Tag Descripción Tipo Dato
Min. Máx.
CUIT de la entidad que realiza Si
CUITEntidad String 11 11
la solicitud.
CUIT/CUIL sobre el cual se Si
CUIT String 11 11
desea consultar.

Banco Central de la República Argentina 5

 “2021 - AÑO DE HOMENAJE AL PREMIO NOBEL DE MEDICINA DR. CÉSAR MILSTEIN”

5.1.2.2 API Response

Contenido Respuesta
Tag Descripción Tipo de Dato Long. min Long máx.
Valor booleano (True/False),
Censado representa la respuesta de BCRA Boolean - -
ante la consulta.

Response
HTTP status Respuesta Aclaración

401 - {Mensaje":"Autenticación necesaria"} Sin Header

Unauthorized Authorization:
Bearer

401 - {"Mensaje":"Error al validar el token: el token está mal formado o vacío"} Con Header
Unauthorized Authorization:
Bearer vacío

401 - {"Mensaje":"Error al validar el token: Algoritmo inválido"} Algoritmo de token

Unauthorized inválido

401 - {"Mensaje":"Error al validar el token: el token no es válido o ha sido El token no es el

Unauthorized renovado"} que tenemos en la
base para esa
entidad

401 - {"Mensaje":"Error al validar el token: El token ha expirado"} Token expirado

Unauthorized

401 - {"Mensaje":"Error al validar el token: Entidad no habilitada para La entidad que

Unauthorized consulta"} consulta no se
encuentra
habilitada realizar
dicha verificación.

400 – Bad {"Mensaje":" CUIT/CUIL inválido"} El CUIT/CUIL

Request consultado es
inválido.

Banco Central de la República Argentina 6

 “2021 - AÑO DE HOMENAJE AL PREMIO NOBEL DE MEDICINA DR. CÉSAR MILSTEIN”

500 – {“Mensaje":"Error de time out BCRA "}

Internal
Server Error

200 – OK {"Censado":"True"} Respuesta de

consulta
satisfactoria. El
CUIT/CUIL ha
realizado el censo o
no aplica al mismo.

200 – OK {"Censado":"False"} Respuesta de

consulta no
satisfactoria. El
CUIT/CUIL no ha
realizado el censo.

Banco Central de la República Argentina 7