· Web viewA través de la Ley 1870 de 2017, la Superintendencia Financiera de Colombia está...

CONSTRUCCIÓN WEB SERVICE REQUERIMIENTO CAPITAL

CONGLOMERADOS FINANCIEROS

Noviembre de 2019

2

DOCUMENTO TÉCNICOA-DT-GTI-005

Versión 1

CONSTRUCCIÓN WEB SERVICE REQUERIMIENTO CAPITAL CONGLOMERADOS

FINANCIEROS Página 2 de 35

TABLA DE CONTENIDO

INTRODUCCIÓN____________________________________________________________3

OBJETIVO_________________________________________________________________3

1 DEFINICIONES__________________________________________________________4

2 EXPOSICIÓN DEL SERVICIO_______________________________________________4

2.1 RECURSOS EXPUESTOS_____________________________________________________42.1.1 Recurso RequerimientoCapital____________________________________________________52.1.2 Recurso RespuestaRequerimientoCapital___________________________________________27

2.2 SEGURIDAD_____________________________________________________________292.2.1 Autenticación mutua___________________________________________________________292.2.2 API Key______________________________________________________________________302.2.3 OAuth_______________________________________________________________________31

2.3 CONDICIONES PARA EXPONER EL WEB SERVICE________________________________32

3 VALIDACIONES________________________________________________________33

4 CODIGOS DE ESTADO HTTP______________________________________________34

5 HISTORIAL DE CAMBIOS________________________________________________35

2


Versión 1



INTRODUCCIÓN

Un conglomerado financiero es un conjunto de entidades con un controlante común que incluye dos o más entidades nacionales o extranjeras que ejercen una actividad propia de las entidades vigiladas por la Superintendencia Financiera de Colombia, siempre que al menos una de ellas ejerza dichas actividades en Colombia.

A través de la Ley 1870 de 2017, la Superintendencia Financiera de Colombia está obligada ejercer actividades de supervisión sobre los conglomerados financieros y las entidades que lo conforman.

A raíz de esta nueva Ley, y dado que la Superintendencia Financiera de Colombia ejerce inspección, vigilancia y control sobre estas entidades, se hace necesario un mecanismo de revelación de información en tiempo real para cumplir con el mandato de la supervisión financiera efectiva.

OBJETIVO

Explicar la funcionalidad del Recurso REST que expondrán este tipo de entidades para mantener su información financiera al día y disponible cuando la Superintendencia Financiera de Colombia lo requiera.

Este recurso REST debe ser construido por cada uno de los conglomerados financieros verificando los lineamientos de este documento y consumido a través de clientes, en este caso, la Superintendencia Financiera de Colombia como único y exclusivo cliente

2


Versión 1



1 DEFINICIONES

REST (Representational State Transfer o Transferencia de estados representacional): Estilo de arquitectura de comunicación entre un cliente y un servidor, comúnmente entre una URI (servidor) y un cliente (cliente) en donde el tipo de mensajes puede ser JSON o XML entre los más comunes. Es combinado generalmente con el protocolo de transporte HTTP para la interoperabilidad entre sistemas de información.

JSON (JavaScript Object Notation o Notación de Objetos JavaScript): Formato de intercambio ligero de datos. La gran propiedad es que es legible y entendible por humanos y de la misma forma es fácil para los sistemas su generación e interpretación.

Recurso REST: Elemento expuesto que cumple la especificación REST mediante una URI (Identificador Unforme de Recurso) a través de HTTP para intercambiar representaciones (tramas) de información. Este recurso está expuesto para el consumo de conectores que reciben y procesan la información.

2 EXPOSICIÓN DEL SERVICIO

La exposición del recurso estará sujeta a las siguientes características: Deberá estar expuesto en una dirección pública a la cual la Superintendencia

Financiera tenga acceso, ej. https://www.mientidad.com/Conglomerados/RequerimientoCapital/. (La parte final deberá ser obligatoria, es decir, Conglomerados/RequerimientoCapital)

La implementación del recurso REST deberá seguir los lineamientos tecnológicos descritos por el estándar REST y JSON. Por consiguiente, no se permitirá la implementación de Web Services tipo SOAP ni de otra tecnología.

El método HTTP usado para la comunicación entre el recurso REST y el cliente será GET.

El recurso GET debe solamente enviar peticiones tipo JSON y en la propiedad Content-Type del encabezado HTTP debe ser application/json

El servicio deberá estar expuesto exclusivamente a la Superintendencia Financiera toda vez que esta información es de uso exclusivo de esta Superintendencia.

2


Versión 1



2.1 RECURSOS EXPUESTOS

La entidad expondrá los siguientes recursos para la Superintendencia.

2.1.1 Recurso RequerimientoCapital

El recurso será expuesto mediante la URI …/Conglomerados/RequerimientoCapital y responderá únicamente bajo el método GET.

La invocación correcta se entenderá como el uso del código HTTP 200 una vez el cliente haya invocado el recurso.

Los datos de valores se deben aportar en millones de pesos, con o (sin cifras decimales aproximado al siguiente peso).

Este recurso no tendrá parámetros de entrada, pero sí manejará una estructura JSON de salida listada a continuación:

a. Datos de salida

Nombre Descripción Tipo Dato Obligatorio

formatoRequerimientoCapital Objeto que encapsula la salida de los estados financieros

FormatoRequerimientoCapital Si

El objeto FormatoRequerimientoCapital está especificado de la siguiente manera:


cartaPresentacion

Cadena de bytes codificada en Base64 que corresponde a un archivo pdf que presenta el informe correspondiente al nivel adecuado de capital para conglomerados financieros, el cual debe venir firmado, de forma digital, por el Representante legal y contador público del conglomerado financiero.

Cadena en base64 Si

2


Versión 1



archivo Cadena de bytes codificada en Base64 que corresponde a un archivo Excel que debe contener la explicación gerencial de la realización del cálculo de Capital Adecuado.

Cadena en base64 Si

encabezado Objeto que encapsula la salida de los estados financieros

Encabezado Si

unidadesCaptura Objeto que encapsula la salida de los estados financieros

Array de UnidadesCaptura

Si

El objeto FormatoRequerimientoCapital contiene en sí mismo un conjunto de objetos pequeños que complementan la información. A continuación, se detallan los atributos del objeto FormatoRequerimientoCapital

A continuación, se describe la estructura FormatoRequerimientoCapital en formato JSON-Schema

"formatoRequerimientoCapital": { "type": "object", "additionalProperties": false, "properties": { "cartaPresentacion": { "type": "string" }, "archivo": { "type": "string" },

"encabezado": { "$ref": "#/definitions/Encabezado" }, "unidadesCaptura": { "type": "array", "items": { "$ref": "#/definitions/UnidadesCaptura" } } }, "required": [

"archivo","cartaPresentacion",

"encabezado", "unidadesCaptura" ], "title": "FormatoRequerimientoCapital" },

Objeto Encabezado.

2


Versión 1



Es el objeto raíz de la respuesta. Contiene la información básica de la información financiera recibida en la respuesta de la invocación del servicio

Nombre Descripción Tipo Dato Formato Obligatorio

fechaCorte Fecha de corte a la cual corresponde esta información.

Fecha aaaa/mm/dd Sí.

tipoEntidadTransmite Tipo de entidad. Numérico / Entero

Tres primeros dígitos del código que identifica a la entidad ante la Superfinanciera.

Restricción: Enteros entre 1 y 999

Sí.

codigoEntidadTransmite Código de entidad. Numérico / Entero

Tres últimos dígitos del código que identifica a la entidad ante la Superfinanciera.Restricción: Enteros entre 1 y 999

Sí.

nombreEntidadTransmite Nombre de la entidad Cadena Sí.

numeroTransmision Consecutivo utilizado para identificar la transmisión.

Entero Sí.

base método usado por el Holding para calcular su nivel adecuado de capital. Puede ser

1. Consolidada,

2. Separada o

3. Combinada.

La entidad que prepara la información deberá informar a la SFC antes de la primera captura,

Entero Restricción: Enteros entre 1 y 3

Sí.

2


Versión 1




sobre qué base escogió para la preparación de la información

A continuación, se describe la estructura Encabezado en formato JSON-Schema

"Encabezado": { "type": "object", "additionalProperties": false, "properties": { "fechaCorte": { "type": "string", "format": "date" }, "tipoEntidadTransmite": { "type": "integer" }, "codigoEntidadTransmite": { "type": "integer" }, "nombreEntidadTransmite": { "type": "string" }, "numeroTransmision": { "type": "integer" }, "base": { "type": "integer" } }, "required": [ "base", "codigoEntidadTransmite", "fechaCorte", "nombreEntidadTransmite", "numeroTransmision", "tipoEntidadTransmite" ], "title": "Encabezado" }

2


Versión 1



Objeto UnidadesCaptura.

Es el objeto raíz de la respuesta que contiene la información a reportar. El formato utiliza una representación matricial (renglón - UnidadCaptura)


unidadCaptura Puede ser:

1. Entidades que tienen definición de capital adecuado dentro de la normativa colombiana.

2. Entidades que no tienen definición de capital adecuado dentro de la normativa colombiana.

3. Totales del conglomerado

Numérico Restricción: Enteros entre 1 y 3

Sí.

renglones Objeto que contiene la información financiera revelada en filas.

Array de Renglones

No aplica. Revisar la descripción del objeto Renglón.

Sí.

A continuación, se describe la estructura UnidadesCaptura en formato JSON-Schema

"UnidadesCaptura": { "type": "object", "additionalProperties": false, "properties": { "unidadCaptura": { "type": "integer" }, "renglones": { "type": "array", "items": { "$ref": "#/definitions/Renglon" } } }, "required": [ "renglones",

2


Versión 1



"unidadCaptura" ], "title": "UnidadesCaptura" },

Objeto Renglón

Es el objeto que contiene la información de los valores del formato, teniendo en cuenta que este elemento es el que se diligencia con la información financiera.


numeroRenglon Fila del formato Numérico Restricción: Enteros entre 1 y 99

Sí.

tipoEntidad Tipo de entidad. Si la unidad de captura es 3 entonces 999

Numérico / Entero

Tres primeros dígitos del código que identifica a la entidad ante la Superfinanciera.

Restricción: Enteros entre 1 y 999

Sí.

codigoEntidad Código de entidad. Si la unidad de captura es 3 entonces 999

Numérico / Entero

Tres últimos dígitos del código que identifica a la entidad ante la Superfinanciera.Restricción: Enteros entre 1 y 999

Sí.

tipoInforme Puede ser:

1. Basado en estados financieros individuales o separados.

2. Basado en estados financieros consolidados.

Si la unidad de captura es 3 entonces 999

Numérico / Entero

Restricción: Enteros entre 1 y 2, 999 si la unidad de captura es 3

Sí.

normaAplicable Definición y/o criterios Numérico / Restricción: Enteros Sí.

2


Versión 1




aplicables al cálculo de capital de la entidad que relaciona en la captura

así: 1. Establecimientos de Crédito. 2. Compañías de Seguros. 3. Sociedades Fiduciarias, 4. Fondos de Pensiones y Cesantías 5. Comisionistas de Bolsa y. Sociedades Administradoras de Inversión. 6. Otras.

Si la unidad de captura es 3 entonces 999

Entero entre 1 y 6, 999 si la unidad de captura es 3

patrimonioTecnico Suma del capital primario/patrimonio básico neto de deducciones, patrimonio básico adicional y el capital secundario/patrimonio adicional, menos deducciones al patrimonio técnico y el total de reservas de estabilización

Numérico / Entero con decimales

Restricción: 9 dígitos enteros y dos decimales, separados por punto (.)

Sí.

capitalPrimarioPatrimonioBasico

Suma del capital suscrito y pagado, reserva legal, prima en colocación de acciones, utilidades del ejercicio en curso, utilidades no distribuidas de ejercicios anteriores, dividendos decretados en acciones, los anticipos de capital y otros elementos de capital primario diferentes. Se deben restar las deduccciones al capital primario/patrimonio básico y las inversiones de capital



Sí.

2


Versión 1




y BOCEAs en entidades de seguros y sociedades de capitalización hechas por aseguradoras.

capitalSuscritoYPagado Valor correspondiente al capital de los accionistas que ha sido debidamente suscrito y efectivamente pagado, en concordancia con lo dispuesto en los artículos 2.1.1.1.10, 2.6.1.1.4, 2.8.1.1.5 y 2.31.1.2.2 del decreto 2555 de 2010



Sí.

reservaLegal Valor de la reserva legal, en concordancia con lo dispuesto en los artículos 2.1.1.1.10, 2.6.1.1.4, 2.8.1.1.5 y 2.31.1.2.2 del decreto 2555 de 2010



Si

primaColocacionAcciones Valor de la prima en colocación de acciones, en concordancia con lo dispuesto en los artículos 2.1.1.1.10, 2.6.1.1.4, 2.8.1.1.5 y 2.31.1.2.2 del decreto 2555 de 2010



Sí.

utilidadesEjercicioEnCurso Resultados del ejercicio, en concordancia con lo dispuesto en los artículos 2.1.1.1.10, 2.6.1.1.4, 2.8.1.1.5 y 2.31.1.2.2 del decreto 2555 de 2010



Sí.

utilidadesNoDistribuidasEjerciciosAnteriores

Resultados acumulados de ejercicios anteriores, en concordancia con lo dispuesto en los artículos 2.1.1.1.10, 2.6.1.1.4,



Sí.

2


Versión 1




2.8.1.1.5 y 2.31.1.2.2 del decreto 2555 de 2010

dividendosDecretadosAcciones

Los dividendos decretados en acciones, en concordancia con lo dispuesto en los artículos 2.1.1.1.10, 2.6.1.1.4, 2.8.1.1.5 y 2.31.1.2.2 del decreto 2555 de 2010



Sí.

anticiposCapital Los anticipos de capital, en concordancia con lo dispuesto en los artículos 2.1.1.1.10, 2.6.1.1.4, 2.8.1.1.5 y 2.31.1.2.2 del decreto 2555 de 2010



Si.

otrosElementosCapitalPrimarioPatrimonioBasico

Otros elementos de capital diferentes a capital suscrito y pagado, reserva legal, prima en colocación de acciones, utilidades del ejercicio en curso, utilidades no distribuidas de ejercicios anteriores, dividendos decretados en acciones y anticipos de capital.



Si.

deduccionesCapitalPrimarioPatrimonioBasico

Las deducciones al capital primario/patrimonio básico, en concordancia con lo dispuesto en los artículos 2.1.1.1.11, 2.6.1.1.5, 2.8.1.1.6, 2.9.1.1.5, 2.31.1.2.3 del decreto 2555 de 2010.



Sí.

inversionesCapitalEntidadesSegurosSociedadesCapitalizacion

El valor de las inversiones de capital, efectuadas en entidades de seguros generales, de vida y



Sí.

2


Versión 1




sociedades de capitalización, en concordancia con lo dispuesto en el artículo 2.31.1.2.3 del decreto 2555 de 2010

inversionesBOCEAsEntidadesSegurosSociedadesCapitalizacion

El valor de las inversiones en bonos obligatoriamente convertibles en acciones emitidos desde el 1o. De junio de 1990 por entidades de seguros generales, de vida y sociedades de capitalización, en concordancia con lo dispuesto en el artículo 2.31.1.2.3 del decreto 2555 de 2010



Sí.

patrimonioBasicoAdicional Patrimonio básico adicional, en concordancia con lo dispuesto en el artículo 2.1.1.1.12 del decreto 2555 de 2010.



Sí.

capitalSecundarioPatrimonioAdicional

Suma de las reservas estatutarias, reservas ocasionales, valorizaciones de activos, utilidades no computables en capital primario/patrimonio básico, boceas.

Para fiducuarias, entidades aseguradoras, AFP’s y SCBV debe ser menor o igual que el capital primario / patrimonio básico, si no, colocar le valor del capital primario / patrimonio



Sí.

2


Versión 1




básico.

reservasEstatutarias Las reservas estatutarias, en concordancia con lo dispuesto en el artículo 2.31.1.2.4 del decreto 2555 de 2010



Sí.

reservasOcasionales Las reservas ocasionales, en concordancia con lo dispuesto en el artículo 2.31.1.2.4 del decreto 2555 de 2010



Sí.

valorizacionesDesvalorizacionesActivos

El cincuenta por ciento (50%) de las valorizaciones de los activos y el 100% de las desvalorizaciones contabilizados, en concordancia con lo dispuesto en el artículo 2.31.1.2.4 del decreto 2555 de 2010



Sí.

utilidadesNoComputablesCapitalPrimarioPatrimonioBasico

Las utilidades no distribuidas de ejercicios anteriores, y las del ejercicio en curso, en el monto no computable en el capital primario, en concordancia con lo dispuesto en el artículo 2.31.1.2.4 del decreto 2555 de 2010.



Sí.

boceas Para establecimientos de crédito: los bonos obligatoriamente convertibles en acciones que sean efectivamente colocados y pagados y que cumplan con los requisitos



Sí.

2


Versión 1




establecidos por el artículo 86 del estatuto orgánico del sistema financiero, en concordancia con lo dispuesto en el artículo 2.1.1.1.13 del decreto 2555 de 2010. Para sociedades administradoras de fondos de pensiones y cesantías y para fiduciarias: los bonos obligatoriamente convertibles en acciones, en concordancia con el artículo 2.6.1.1.6 del decreto 2555 de 2010. Para entidades aseguradoras: los bonos obligatoriamente convertibles en acciones emitidos a partir del 1o. De julio de 1990 cuyo pago en caso de liquidación esté subordinado a la cancelación de los demás pasivos externos de la sociedad y que su tasa de interés al momento de la emisión sea menor o igual que el setenta por ciento (70%) de la tasa dtf calculada por el banco de la república para la semana inmediatamente anterior. En concordancia con lo dispuesto en el artículo 2.31.1.2.4 del decreto 2555 de 2010.

interesMinoritario Interés minoritario, en concordancia con el artículo 2.1.1.1.13 del decreto 2555 de 2010



Sí.

2


Versión 1




instrumentosDeudaPatrimonioAdicional

Instrumentos de deuda, en concordancia con el artículo 2.1.1.1.13 del decreto 2555 de 2010



Sí.

provisionGeneral La provisión general constituida por establecimientos de crédito, en concordancia con el artículo 2.1.1.1.13 del decreto 2555 de 2010



Sí.

otrosElementosCapitalSecundarioPatrimonioAdicional

Otros elementos del capital secundario/patrimonio adicional, diferentes a reservas estatutarias, reservas ocasionales, valorizaciones y desvalorizaciones de activos, utilidades no computables en capital primario, boceas, interés minoritario computable en el patrimonio adicional y provisión general.



Sí.

totalReservasEstabilizacion Suma de los valores de las reservas de estabilización por administración de: fondos de pensiones, fondos de cesantías, patrimonios autónomos y fonpet.



Sí.

reservasEstabilizacionAdmonFondosPensionesObl

Reservas de estabilización por administración de fondos pensiones obligatorias, en concordancia con lo dispuesto en la parte 2 libro 6 titulo 4 del decreto 2555 de 2010.



Sí.

2


Versión 1




reservasEstabilizacionAdmonFondosCesantias

Reservas de estabilización por administración de fdos cesantías, en concordancia con lo dispuesto en la parte 2 libro 6 titulo 4 del decreto 2555 de 2010.



Sí.

reservasEstabilizacionAdmonPatrimoniosAut




Sí.

reservasEstabilizacionAdmonFondosFonpet




Sí.

deduccionesPatrimonioTecnico

Inversiones de capital entre entidades del conglomerado y otras operaciones intragrupo que no deban computar en el patrimonio técnico.



Sí.

patrimonioAdecuado .

1. Para Establecimientos de Crédito: sumatoria del Total de los APNRs y 100/9 del Riesgo de mercado multiplicado por el 9%

2. Para AFPs, SCBV, SAIs y Fiduciarias: sumatoria del



Sí.

2


Versión 1




Total de los APNRs, 100/9 del Riesgo de mercado y 100/9 del Riesgo operacional, multiplicado por 9%.

3. Para Entidades Aseguradoras: Patrimonio Adecuado, en concordancia con el Artículo 2.31.1.2.5 del Decreto 2555 de 2010

totalRiesgosOperacionales

Para AFPs, SCBV, SAIs y Fiduciarias: Resta entre, los ingresos por comisiones y los gastos por comisiones provenientes de la custodia de valores.



Sí.

ingresosComisiones Ingresos por comisiones ponderados entre el 12% y el 16%, provenientes de la administración de fiducias, negocios fiduciarios, FICs, fondos de pensiones obligatorias, fondos de pensiones voluntarias, fondos de cesantías, patrimonios autónomos fonpet, patrimonios autónomos sobre pasivos pensionales diferentes a Fonpet, colocación de títulos, asesoría en el

2


Versión 1




mercado de valores y administración de activos que se realice a través de contratos de comisión, en concordancia con los Artículos 2.5.3.1.8, 2.6.1.1.7 y 2.9.1.1.13, del Decreto 2555 de 2010.

gastosCustodiaValores Gastos por comisiones ponderados entre el 12% y el 16%, provenientes de la custodia de valores, en concordancia con los Artículos 2.5.3.1.8, 2.6.1.1.7 y 2.9.1.1.13, del Decreto 2555 de 2010



Sí.

totalRiesgoSuscripcion Sumatoria del riesgo en función de primas, siniestros y reserva matemática.



Sí.

riesgoFuncionPrimas

Riesgo en función de primas, en concordancia con el Artículo 2.31.1.2.6 del Decreto 2555 de 2010



Sí.

riesgoFuncionSiniestros

Riesgo en función de siniestros, en concordancia con el Artículo 2.31.1.2.6 y 2.31.1.2.7 del Decreto 2555 de 2010



Sí.

riesgoFuncionReservaMatematica

Riesgo en función de la reserva matemática, en concordancia con el



Sí.

2


Versión 1




Artículo 2.31.1.2.7 del Decreto 2555 de 2010

totalApnr Suma de todas las categorías de APNR. Hay que tener en cuenta que cuando estos se calculen en establecimientos de crédito con la metodología del Decreto 1477 de 2018 se usaran los campos: APNR - ponderados al 0%, APNR - ponderados entre el 1% y el 49%, APNR - ponderados entre el 50% y el 99%, APNR - ponderados al 100% y APNR - ponderados a más del 100% - Contingencias. Mientras no se use esa metodología para establecimientos de crédito, los campos a usar son los APNR por categorías (i, ii, iii).



Sí.

apnrPonderadosAlCeroPorciento

En concordancia con lo dispuesto en los Artículos 2.1.1.3.2, 2.1.1.3.4 y 2.1.1.3.5 del Decreto 2555 de 2010



Sí.

apnrPonderadosEntreUnoYCuarentayNuevePorciento




Sí.

2


Versión 1




apnrPonderadosEntreCincuentaYNoventayNuevePorciento En concordancia con lo

dispuesto en los Artículos 2.1.1.3.2, 2.1.1.3.4 y 2.1.1.3.5 del Decreto 2555 de 2010



Sí.

apnrPonderadosAlCienPorciento




Sí.

apnrPonderadosDeMasDelCienPorciento




Sí.

apnrContingencias

En concordancia con lo dispuesto en el Artículo 2.1.1.3.5 del Decreto 2555 de 2011



Sí.

apnrCategoriaUno

Activos ponderados por nivel de riesgo categoría i, en concordancia con el Artículo 2.5.3.1.6, 2.6.1.1.10, 2.9.1.1.11, 2.31.1.2.9 del Decreto 2555 de 2010.



Sí.

apnrCategoriaDos

Activos ponderados por nivel de riesgo categoría ii,



Sí.

2


Versión 1




en concordancia con el Artículo 2.5.3.1.6, 2.6.1.1.10, 2.9.1.1.11, 2.31.1.2.9 del Decreto 2555 de 2010.

apnrCategoriaTres

Activos ponderados por nivel de riesgo categoría iii, en concordancia con el Artículo 2.5.3.1.6, 2.6.1.1.10, 2.9.1.1.11, 2.31.1.2.9



Sí.

riesgoMercado

Valor de la exposición por riesgo de mercado, en concordancia con los Artículos 2.1.1.3.1, 2.5.3.1.7, 2.6.1.1.11 y 2.31.1.2.10 del



Sí.

coeficienteCorrelacionSuscripcionMercado

Coeficientes de correlación, en concordancia con el Artículo 2.31.1.2.5 del Decreto 2555 de 2010.



Sí.

coeficienteCorrelacionSuscripcionActivo

Coeficientes de correlación, en concordancia con el Artículo 2.31.1.2.5 del Decreto 2555 de 2010.



Sí.

coeficienteCorrelacionSuscripcionActivoMercado

Coeficientes de correlación, en concordancia con el



Sí.

2


Versión 1




Artículo 2.31.1.2.5 del Decreto 2555 de 2010.

excesoDefecto

Total del patrimonio técnico menos el total del patrimonio adecuado.



Sí.

A continuación, se describe la estructura Renglon en formato JSON-Schema

"Renglon": { "type": "object", "additionalProperties": false, "properties": { "numeroRenglon": { "type": "integer" }, "tipoEntidad": { "type": "integer" }, "codigoEntidad": { "type": "integer" }, "tipoInforme": { "type": "integer" }, "normaAplicable": { "type": "integer" }, "patrimonioTecnico": { "type": "number" }, "capitalPrimarioPatrimonioBasico": { "type": "number" }, "capitalSuscritoYPagado": { "type": "number" }, "reservaLegal": { "type": "number" }, "primaColocacionAcciones": { "type": "number" },

2


Versión 1



"utilidadesEjercicioEnCurso": { "type": "number" }, "utilidadesNoDistribuidasEjerciciosAnteriores": { "type": "number" }, "dividendosDecretadosAcciones": { "type": "number" }, "anticiposCapital": { "type": "number" },

"otrosElementosCapitalPrimarioPatrimonioBasico": { "type": "number" }, "deduccionesCapitalPrimarioPatrimonioBasico": { "type": "number" }, "inversionesCapitalEntidadesSegurosSociedadesCapitalizacion": { "type": "number" }, "inversionesBOCEAsEntidadesSegurosSociedadesCapitalizacion": { "type": "number" }, "patrimonioBasicoAdicional": { "type": "number" }, "capitalSecundarioPatrimonioAdicional": { "type": "number" }, "reservasEstatutarias": { "type": "number" }, "reservasOcasionales": { "type": "number" }, "valorizacionesDesvalorizacionesActivos": { "type": "number" }, "utilidadesNoComputablesCapitalPrimarioPatrimonioBasico": { "type": "number" }, "boceas": { "type": "number" },

"interesMinoritario": { "type": "number" },

"instrumentosDeudaPatrimonioAdicional": { "type": "number" },

2


Versión 1



"provisionGeneral": { "type": "number" },

"otrosElementosCapitalSecundarioPatrimonioAdicional": { "type": "number" }, "totalReservasEstabilizacion": { "type": "number" }, "reservasEstabilizacionAdmonFondosPensionesObl": { "type": "number" }, "reservasEstabilizacionAdmonFondosCesantias": { "type": "number" }, "reservasEstabilizacionAdmonPatrimoniosAut": { "type": "number" }, "reservasEstabilizacionAdmonFondosFonpet": { "type": "number" }, "deduccionesPatrimonioTecnico": { "type": "number" }, "patrimonioAdecuado": { "type": "number" }, "totalRiesgosOperacionales": { "type": "number" }, "ingresosComisiones": { "type": "number" },

"gastosCustodiaValores": { "type": "number" },

"totalRiesgoSuscripcion": { "type": "number" }, "riesgoFuncionPrimas": { "type": "number" }, "riesgoFuncionSiniestros": { "type": "number" }, "riesgoFuncionReservaMatematica": { "type": "number" },

"totalApnr": { "type": "number" },

2


Versión 1



"apnrPonderadosAlCeroPorciento": { "type": "number" }, "apnrPonderadosEntreUnoYCuarentayNuevePorciento": { "type": "number" }, "apnrPonderadosEntreCincuentaYNoventayNuevePorciento": { "type": "number" }, "apnrPonderadosAlCienPorciento": { "type": "number" }, "apnrPonderadosDeMasDelCienPorciento": { "type": "number" }, "apnrContingencias": { "type": "number" }, "apnrCategoriaUno": { "type": "number" }, "apnrCategoriaDos": { "type": "number" }, "apnrCategoriaTres": { "type": "number" }, "riesgoMercado": { "type": "number" }, "coeficienteCorrelacionSuscripcionMercado": { "type": "number" }, "coeficienteCorrelacionSuscripcionActivo": { "type": "number" }, "coeficienteCorrelacionSuscripcionActivoMercado": { "type": "number" }, "excesoDefecto": { "type": "number" } }, "required": [ "anticiposCapital", "apnrCategoriaDos", "apnrCategoriaTres", "apnrCategoriaUno", "apnrContingencias", "apnrPonderadosAlCeroPorciento", "apnrPonderadosAlCienPorciento",

2


Versión 1



"apnrPonderadosDeMasDelCienPorciento", "apnrPonderadosEntreCincuentaYNoventayNuevePorciento", "apnrPonderadosEntreUnoYCuarentayNuevePorciento", "boceas", "capitalPrimarioPatrimonioBasico", "capitalSecundarioPatrimonioAdicional", "capitalSuscritoYPagado", "codigoEntidad", "coeficienteCorrelacionSuscripcionActivo", "coeficienteCorrelacionSuscripcionActivoMercado", "coeficienteCorrelacionSuscripcionMercado", "deduccionesCapitalPrimarioPatrimonioBasico ", "deduccionesPatrimonioTecnico", "dividendosDecretadosAcciones", "excesoDefecto", "gastosCustodiaValores", "ingresosComisiones", "instrumentosDeudaPatrimonioAdicional",

"interesMinoritario", "inversionesBOCEAsEntidadesSegurosSociedadesCapitalizacion", "inversionesCapitalEntidadesSegurosSociedadesCapitalizacion", "normaAplicable", "numeroRenglon",

"otrosElementosCapitalPrimarioPatrimonioBasico","otrosElementosCapitalSecundarioPatrimonioAdicional",

"patrimonioAdecuado","patrimonioBasicoAdicional",

"patrimonioTecnico", "primaColocacionAcciones",

"provisionGeneral", "reservaLegal", "reservasEstabilizacionAdmonFondosCesantias", "reservasEstabilizacionAdmonFondosFonpet", "reservasEstabilizacionAdmonFondosPensionesObl", "reservasEstabilizacionAdmonPatrimoniosAut", "reservasEstatutarias", "reservasOcasionales",

"riesgoFuncionPrimas","riesgoFuncionReservaMatematica","riesgoFuncionSiniestros",

"riesgoMercado", "riesgoSuscripcion", "tipoEntidad", "tipoInforme",

"totalAapnr", "totalReservasEstabilizacion", "totalRiesgosOperacionales", "utilidadesNoComputablesCapitalPrimarioPatrimonioBasico ", "utilidadesEjercicioEnCurso", "utilidadesNoDistribuidasEjerciciosAnteriores", "valorizacionesDesvalorizacionesActivos"

2


Versión 1



], "title": "Renglon" }

2.1.2 Recurso RespuestaRequerimientoCapital

El recurso será expuesto mediante la URI …/Conglomerados/RespuestaRequerimientoCapital y responderá únicamente bajo el método POST.

Este recurso tendrá parámetros de entrada, pero no de salida. La utilidad de este recurso es notificar las inconsistencias de información encontradas una vez se ejecuten los procesos de validación de la información consumida en el recurso anterior.

La invocación correcta se entenderá como el uso del código HTTP 204 una vez el cliente haya invocado el recurso.

a. Datos de entrada


respuestaRequerimientoCapital Objeto que encapsula la respuesta de las validaciones de la información recibida.

RespuestaRequerimientoCapital Si

El objeto respuestaRequerimientoCapital está especificado de la siguiente manera:


consecutivoTransmision Consecutivo utilizado para identificar la transmisión.

Entero Si

estadoSatisfactorio Bandera que indica si los datos recibidos fueron validados satisfactoriamente

Booleano Si

2


Versión 1



listaErrores Lista de errores en caso de presentarse.

Array de Cadenas Si

A continuación, se describe la estructura respuestaRequerimientoCapital en formato JSON-Schema

"RespuestaRequerimientoCapital": { "type": "object", "additionalProperties": false, "properties": { "consecutivoTransmision": { "type": "integer" }, "estadoSatisfactorio": { "type": "boolean" }, "listaErrores": { "type": "array", "items": { "type": "string" } } }, "required": [ "consecutivoTransmision", "estadoSatisfactorio", "listaErrores" ], "title": "RespuestaRequerimientoCapital" }

2.2 SEGURIDAD

Las comunicaciones se efectuarán sobre protocolo TLS versión 1.2 (TLSv1.2)

Los recursos REST deberán estar expuestos mediante uno de los mecanismos de seguridad descritos en los numerales 2.2.1, 2.2.2 o 2.2.3 de este documento, ó, la combinación de la Autenticación Mutua (numeral 2.2.1) con Api Key (numeral 2.2.2) o OAuth (2.2.3).

2


Versión 1



Se debe asegurar que el recurso REST sea expuesto EXCLUSIVAMENTE a esta Superintendencia ya que la información transmitida no debe ser accedida por ningún motivo por otras entidades.

La carta de presentación, que se transmite a través del servicio web, debe venir firmada digitalmente por el representante legal y el contador público del conglomerado financiero, como evidencia de la aceptación de la información por parte de los cargos antes mencionados.

2.2.1 Autenticación mutua

La Autenticación mutua en el protocolo TLS v1.2 consiste en la validación en doble vía de los servidores que se están comunicando, esta doble validación se realizará a través de certificados digitales SSL.

El proceso de validación inicia al momento de iniciar las conexiones entre los dos servidores y se conoce como el handsnake el cual consiste en cuatro etapas (acá una breve descripción):

1. El cliente envía un mensaje ClientHello al servidor para establecer comunicación.

2. El cliente, recibe un registro ServerHello, junto con los certificados del servidor

3. El cliente envía sus certificados y se realiza negociación de cifrados.

4. Se aceptan condiciones y se establece el canal de comunicaciones.

Posterior al establecimiento del canal, el cliente hace envío de la petición al recurso.

Para realizar la implementación de la autenticación mutua o autenticación a doble vía del protocolo TLS v1.2, es requerido que los dos actores, en este caso la Superfinanciera (cliente) y cada uno de los conglomerados (server), intercambien los certificados digitales con los cuales se establecera la relación de confianza para la funcionalidad descrita en el

2


Versión 1



documento.

2.2.2 API Key

Es un mecanismo o identificador que sirve como medio de autenticación de un servidor cliente al que se le proporciona, de acuerdo al rol que se le establezca, permisos de uso sobre un recurso expuesto en la web. Este identificador es único por servidor cliente y es únicamente conocido por las dos partes (cliente - servidor).

Previo a cualquier petición sobre un recurso, el administrador del servidor entrega el api-key al cliente, al momento de realizar las peticiones el cliente inyecta en el contexto de la petición un header con el nombre designado (ej: x-api-key) y como valor de este header el identificador único asignado al cliente.

2


Versión 1



2.2.3 OAuth

Es un estándar de autorización que permite, de forma limitada, acceso sobre recursos expuestos sobre HTTP. Este mecanismo refuerza la funcionalidad del API Key y la mezcla con la generación de un doble factor de autenticación equivalente al JWT (JSON Web Token por sus siglas en ingles). Aunque el flujo de autorización varía de acuerdo a su implementación, sin embargo, su idea general se muestra en el siguiente diagrama y se describe a continuación del mismo.

2


Versión 1



En primera instancia, el cliente, previo al consumo del recurso web, hace una petición de autorización a través de un servicio web en el cual envía un identificador único del cliente (ClientID) y una palabra secreta (ClientSecret), los cuales pueden ser enviados en el cuerpo o como header de la petición. Si los datos son correctos el servicio de autenticación retornara un token el cual es usado por el cliente para solicitar el recurso.

Posterior a esto, el cliente realiza una petición al recurso inyectando en el header de la misma, los datos de ClienID y del token obtenido previamente.

Si los datos enviados son correctos se servirá el recurso solicitado.

2.3 CONDICIONES PARA EXPONER EL WEB SERVICE

Cuando se surtan las pruebas de comunicación y de conectividad entre la entidad y la Superintendencia Financiera de Colombia en ambientes de desarrollo y pruebas, la entidad deberá remitir a la Superintendencia la dirección donde se encontrará el Web Service para consumir en ambiente productivo con el fin de adecuar y configurar los

2


Versión 1



permisos de firewall/direccionamiento y de registro en el cliente desarrollado por la Superintendencia para acceder al recurso.

Si la entidad hace cambios de infraestructura tecnológica por razón de migraciones, actualizaciones entre otras, deberá informar a la Superintendencia Financiera de Colombia el cambio realizado y se comenzará de nuevo el ciclo de pruebas para certificar el Web Service en la nueva infraestructura.

Para el caso de nuevas entidades que estén en la obligación de configurar el Web Service, debe contemplarse dentro de esas actividades informar a la Superintendencia Financiera de Colombia la información descrita anteriormente, después de surtir las pruebas requeridas para que se puedan realizar las configuraciones necesarias en la Superintendencia buscando garantizar el adecuado consumo del Web Service por parte de la Superintendencia.

3 VALIDACIONES

patrimonioTecnico ES IGUAL (capitalPrimarioPatrimonioBasico + patrimonioBasicoAdicional + capitalSecundarioPatrimonioAdicional) - (totalReservasEstabilizacion + deduccionesPatrimonioTecnico)

CapitalPrimarioPatrimonioBasico ES IGUAL

(capitalSuscritoYPagado + reservaLegal + primaColocacionAcciones + utilidadesEjercicioEnCurso + utilidadesNoDistribuidasEjerciciosAnteriores + dividendosDecretadosAcciones + anticiposCapital + otrosElementosCapitalPrimarioPatrimonioBasico) - (deduccionesCapitalPrimarioPatrimonioBasico + inversionesCapitalEntidadesSegurosSociedadesCapitalizacion + inversionesBOCEAsEntidadesSegurosSociedadesCapitalizacion )

CapitalSecundarioPatrimonioAdicional

ES MENOR O IGUAL

reservasEstatutarias + reservasOcasionales + valorizacionesDesvalorizacionesActivos + utilidadesNoComputablesCapitalPrimarioPatrimonioBasico + boceas + interesMinoritario + instrumentosDeudaPatrimonioAdicional + provisionGeneral + otrosElementosCapitalSecundarioPatrimonioAdicional

CapitalPrimarioPatrimonioBasicoES MAYOR O IGUAL

CapitalSecundarioPatrimonioAdicional (nota: aplica para Fiduciarias, entidades aseguradoras, AFP’s y SCBV

TotalReservasEstabilizacion ES IGUAL reservasEstabilizacionAdmonFondosCesantias +

reservasEstabilizacionAdmonFondosFonpet +

2


Versión 1



reservasEstabilizacionAdmonFondosPensionesObl +

reservasEstabilizacionAdmonPatrimoniosAut

totalRiesgoSuscripcionES IGUAL

riesgoFuncionPrimas + riesgoFuncionSiniestros + riesgoFuncionReservaMatematica

totalApnrES IGUAL

apnrCategoriaDos +apnrCategoriaTres + apnrCategoriaUno + apnrContingencias + apnrPonderadosAlCeroPorciento + apnrPonderadosAlCienPorciento +

apnrPonderadosDeMasDelCienPorciento + apnrPonderadosEntreCincuentaYNoventayNuevePorciento +

apnrPonderadosEntreUnoYCuarentayNuevePorciento

excesoDefecto ES IGUAL PatrimonioTecnico – patrimonioAdecuado

4 CODIGOS DE ESTADO HTTP

En el momento de realizar las peticiones a los diferentes conglomerados financieros para obtener el respectivo reporte o para entregar la respuesta de este, el conglomerado financiero deberá usar, en sus respuestas HTTP, el código de estado (status code) más adecuado y acorde a la situación presentada. Los siguientes enlaces de internet se toman como referencia para establecer los códigos de estado:

The Internet Engineering Task Force

https://www.ietf.org/assignments/http-status-codes/http-status-codes.xml

The World Wide Web Consortium

https://www.w3.org/Protocols/HTTP/HTRESP.html

Mozilla Developer Network

https://developer.mozilla.org/es/docs/Web/HTTP/Status

https://developer.mozilla.org/es/docs/Web/HTTP/Status

https://www.w3.org/Protocols/HTTP/HTRESP.html

https://www.ietf.org/assignments/http-status-codes/http-status-codes.xml

2


Versión 1



A continuación, presentamos alguno de los códigos de estado que se deben de usar al momento de dar respuesta a un evento en las operaciones de captura de información y respuesta:

GET ../../Conglomerados/RequerimientoCapital

Código de estado

Descripción Evento

200 OKEl recurso se ha obtenido y se transmite en el cuerpo del mensaje

Cuando se obtiene de forma satisfactoria el Reporte de Capital solicitado

401 Unautirized El recurso requiere una autorización

Cuando las credenciales de autenticación con el conglomerado financiero no se envían o no son correctas, esto solo aplica para los mecanismos de seguridad de API Key y OAuth

404 Not Found El servidor no encuentra el recurso solicitadoCuando el reporte de capital no se encuentre disponible para ser capturado por la petición enviada.

POST ../../Conglomerados/RespuestaRequerimientoCapital

204 Not ContentLa petición se proceso de forma correcta pero no hay cuerpo de mensaje en la respuesta.

Cuando se recibe de forma satisfactoria la respuesta del requerimiento enviada por la Superfinanciera

401 Unautirized El recurso requiere una autorización

Cuando las credenciales de autenticación con el conglomerado financiero no se envían o no son correctas, esto solo aplica para los mecanismos de seguridad de API Key y OAuth

500 Internal Server Error

El servidor ha encontrado una situación que no sabe como manejarla

Cuando las estructuras JSON del cuerpo de mensaje de la respuesta no coincide con la definición del servidor, o en cualquier caso que se asemeje la

2


Versión 1



situación.

No es obligatorio usar únicamente los códigos de estado descritos anteriormente, la entidad puede usar diferentes de acuerdo a las referencias y a las situaciones presentadas, sin embargo, sí se recomienda el uso de los descritos anteriormente en las situaciones mencionadas en la columna evento.

5 HISTORIAL DE CAMBIOSVersión Fecha Cambio

· Web viewA través de la Ley 1870 de 2017, la Superintendencia Financiera de Colombia está...

Documents

Transcript of · Web viewA través de la Ley 1870 de 2017, la Superintendencia Financiera de Colombia está...