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.
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
