Está en la página 1de 10

“2020 – AÑO DEL GENERAL MANUEL BELGRANO”

INFORME TÉCNICO DE SOLUCIÓN

Verificador BCRA
Extranet

Aplicaciones de Banca Central

Versión 1.0

28/10/2020

Banco Central de la República Argentina 1


“2020 – AÑO DEL GENERAL MANUEL BELGRANO”

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 Verificador Cuentas API REST ...................................................................................................... 5
5.1.3 Normativas API REST................................................................................................................... 7

Banco Central de la República Argentina 2


“2020 – AÑO DEL GENERAL MANUEL BELGRANO”

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 por parte de Banco Central para ser consumido por parte de las Entidades Financieras 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 Linea, pero la respuesta que devolverá será en
función a los datos ficticios cargados en dicho entorno.

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/verificacion/{CUITEntidad/{CUIL}}
API REQUEST GET /api/normativas/{CUITEntidad/{CUIL}}

API RESPONSE Service


Entidades Financieras Verificador
API REST

Banco Central de la República Argentina 3


“2020 – AÑO DEL GENERAL MANUEL BELGRANO”

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 verificador API REST


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
Producción: https://verificador.bcra.sfa/api/healthcheck
Método
GET
Content Type
application/json

Banco Central de la República Argentina 4


“2020 – AÑO DEL GENERAL MANUEL BELGRANO”

5.1.1.4.2 API Response

5.1.2 Verificador Cuentas 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/verificacion/{CUITEntidad}/{CUIL}
Producción: https://verificador.bcra.sfa/api/verificacion/{CUITEntidad}/{CUIL}
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.
CUIL de la persona sobre la Si
CUIL String 11 11
cual se desea consultar.

Banco Central de la República Argentina 5


“2020 – AÑO DEL GENERAL MANUEL BELGRANO”

5.1.2.2 API Response

Contenido Respuesta
Tag Descripción Tipo de Dato Long. min Long máx.

CUIL CUIL de la persona consultada. Long 11 11


Valor booleano (True/False),
Valido 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":"CUIL inválido"} El CUIL consultado


Request es inválido.

Banco Central de la República Argentina 6


“2020 – AÑO DEL GENERAL MANUEL BELGRANO”

404 – Not {“Mensaje":"CUIL inexistente "} No existe el


found registro de CUIL
dentro de padrón.

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


Internal
Server Error

200 – OK {"CUIL":"20212121216","Valido":"True"} Respuesta de


consulta
satisfactoria

200 – OK {"CUIL":"20212121216","Valido":"False"} Respuesta de


consulta No
satisfactoria

5.1.3 Normativas API REST


El servicio es el encargado de atender todas las transacciones entrantes por parte de las entidades financieras
realizando la consulta de un CUIT/CUIL para obtener causales de exportación sobre las bases del BCRA.
Dicho servicio se encuentra expuesto para que pueda ser consumido por las entidades directamente mediante
un HTTP POST con los datos solicitados.

5.1.3.1 API POST

URL
Homologación: https://verificador.homologacion.bcra.sfa/api/normativas/
Producción: https://verificador.bcra.sfa/api/normativas/
Método
POST
Content Type
Query string
Authorization
Bearer TOKEN_STRING

Banco Central de la República Argentina 7


“2020 – AÑO DEL GENERAL MANUEL BELGRANO”

5.1.3.2 API POST - JSON Esperado

Contenido
Requerido Long. Long.
Tag Descripción Tipo Dato
Min. Máx.
CUIT de la entidad que realiza la Si
CUITEntidad String 11 11
solicitud.
CUIL/CUIT sobre la cual se desea Si
CUITEmpresa String 11 11
consultar.
Importe en dólares (USD) a Si
Monto Decimal
declarar en importación
Envío de concepto de importación Si
Concepto a consultar (B05, B12, B07, B10, Char 3 3
B16, B06, B14, P13)

5.1.3.3 API Response – JSON

Contenido Respuesta
Tag Descripción Tipo de Dato Long. min Long máx.
Identificador de la consulta
Hash String 16 16
realizada.
Cumple Retorno de consulta Boolean
Mensaje Mensaje de respuesta String

Response
HTTP status Respuesta Aclaración

Banco Central de la República Argentina 8


“2020 – AÑO DEL GENERAL MANUEL BELGRANO”

401 - {"Cumple":false,"Hash":"","Mensaje":"Autenticación necesaria"} Sin Header


Unauthorized Authorization:
Bearer

401 - {"Cumple":false,"Hash":"","Mensaje":"Error al validar el token: El token Con Header


Unauthorized está mal formado o vacío"} Authorization:
Bearer vacío

401 - {"Cumple":false,"Hash":"","Mensaje":"Error al validar el token: Algoritmo Algoritmo de token


Unauthorized inválido"} inválido

401 - {"Cumple":false,"Hash":"","Mensaje":"Error al validar el token: el token El token no es el


Unauthorized no es válido o ha sido renovado"} que tenemos en la
base para esa
entidad

401 - {"Cumple":false,"Hash":"","Mensaje":"Error al validar el token: El token Token expirado


Unauthorized ha expirado"}

401 - {"Cumple":false,"Hash":"","Mensaje":"Error al validar el token: Entidad La entidad que


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

400 – Bad {"Cumple":false,"Hash":"","Mensaje":"CUIT invalido"} El CUIL consultado


Request es inválido.

400 – Bad {"Cumple":false,"Hash":"","Mensaje":"Concepto invalido"} El concepto


Request consultado es
inválido.

400 – Bad {"Cumple":false,"Hash":"","Mensaje":"El endpoint no se encuentra Endpoint no


Request habilitado"} habilitado

400 – Bad {"Cumple":false,"Hash":"","Mensaje":"El servicio se encuentra fuera de Fuera de horario


Request horario operativo."} operativo

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


Internal
Server Error

Banco Central de la República Argentina 9


“2020 – AÑO DEL GENERAL MANUEL BELGRANO”

200 – OK {"Cumple":true,"Hash":"6B9FD489-272D-43","Mensaje":""} Respuesta de


consulta
satisfactoria

200 - OK {"Cumple":false,"Hash":"140D0956-F0FF-49","Mensaje":""} Respuesta de


consulta no
satisfactoria

Banco Central de la República Argentina 10

También podría gustarte