Upload
others
View
3
Download
0
Embed Size (px)
Citation preview
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
DOCUMENTO TÉCNICOA-DT-GTI-005
Versión 1
CONSTRUCCIÓN WEB SERVICE REQUERIMIENTO CAPITAL CONGLOMERADOS
FINANCIEROS Página 3 de 35
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
DOCUMENTO TÉCNICOA-DT-GTI-005
Versión 1
CONSTRUCCIÓN WEB SERVICE REQUERIMIENTO CAPITAL CONGLOMERADOS
FINANCIEROS Página 4 de 35
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
DOCUMENTO TÉCNICOA-DT-GTI-005
Versión 1
CONSTRUCCIÓN WEB SERVICE REQUERIMIENTO CAPITAL CONGLOMERADOS
FINANCIEROS Página 5 de 35
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:
Nombre Descripción Tipo Dato Obligatorio
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
DOCUMENTO TÉCNICOA-DT-GTI-005
Versión 1
CONSTRUCCIÓN WEB SERVICE REQUERIMIENTO CAPITAL CONGLOMERADOS
FINANCIEROS Página 6 de 35
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
DOCUMENTO TÉCNICOA-DT-GTI-005
Versión 1
CONSTRUCCIÓN WEB SERVICE REQUERIMIENTO CAPITAL CONGLOMERADOS
FINANCIEROS Página 7 de 35
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
DOCUMENTO TÉCNICOA-DT-GTI-005
Versión 1
CONSTRUCCIÓN WEB SERVICE REQUERIMIENTO CAPITAL CONGLOMERADOS
FINANCIEROS Página 8 de 35
Nombre Descripción Tipo Dato Formato Obligatorio
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
DOCUMENTO TÉCNICOA-DT-GTI-005
Versión 1
CONSTRUCCIÓN WEB SERVICE REQUERIMIENTO CAPITAL CONGLOMERADOS
FINANCIEROS Página 9 de 35
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)
Nombre Descripción Tipo Dato Formato Obligatorio
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
DOCUMENTO TÉCNICOA-DT-GTI-005
Versión 1
CONSTRUCCIÓN WEB SERVICE REQUERIMIENTO CAPITAL CONGLOMERADOS
FINANCIEROS Página 10 de 35
"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.
Nombre Descripción Tipo Dato Formato Obligatorio
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
DOCUMENTO TÉCNICOA-DT-GTI-005
Versión 1
CONSTRUCCIÓN WEB SERVICE REQUERIMIENTO CAPITAL CONGLOMERADOS
FINANCIEROS Página 11 de 35
Nombre Descripción Tipo Dato Formato Obligatorio
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
Numérico / Entero con decimales
Restricción: 9 dígitos enteros y dos decimales, separados por punto (.)
Sí.
2
DOCUMENTO TÉCNICOA-DT-GTI-005
Versión 1
CONSTRUCCIÓN WEB SERVICE REQUERIMIENTO CAPITAL CONGLOMERADOS
FINANCIEROS Página 12 de 35
Nombre Descripción Tipo Dato Formato Obligatorio
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
Numérico / Entero con decimales
Restricción: 9 dígitos enteros y dos decimales, separados por punto (.)
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
Numérico / Entero con decimales
Restricción: 9 dígitos enteros y dos decimales, separados por punto (.)
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
Numérico / Entero con decimales
Restricción: 9 dígitos enteros y dos decimales, separados por punto (.)
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
Numérico / Entero con decimales
Restricción: 9 dígitos enteros y dos decimales, separados por punto (.)
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,
Numérico / Entero con decimales
Restricción: 9 dígitos enteros y dos decimales, separados por punto (.)
Sí.
2
DOCUMENTO TÉCNICOA-DT-GTI-005
Versión 1
CONSTRUCCIÓN WEB SERVICE REQUERIMIENTO CAPITAL CONGLOMERADOS
FINANCIEROS Página 13 de 35
Nombre Descripción Tipo Dato Formato Obligatorio
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
Numérico / Entero con decimales
Restricción: 9 dígitos enteros y dos decimales, separados por punto (.)
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
Numérico / Entero con decimales
Restricción: 9 dígitos enteros y dos decimales, separados por punto (.)
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.
Numérico / Entero con decimales
Restricción: 9 dígitos enteros y dos decimales, separados por punto (.)
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.
Numérico / Entero con decimales
Restricción: 9 dígitos enteros y dos decimales, separados por punto (.)
Sí.
inversionesCapitalEntidadesSegurosSociedadesCapitalizacion
El valor de las inversiones de capital, efectuadas en entidades de seguros generales, de vida y
Numérico / Entero con decimales
Restricción: 9 dígitos enteros y dos decimales, separados por punto (.)
Sí.
2
DOCUMENTO TÉCNICOA-DT-GTI-005
Versión 1
CONSTRUCCIÓN WEB SERVICE REQUERIMIENTO CAPITAL CONGLOMERADOS
FINANCIEROS Página 14 de 35
Nombre Descripción Tipo Dato Formato Obligatorio
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
Numérico / Entero con decimales
Restricción: 9 dígitos enteros y dos decimales, separados por punto (.)
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.
Numérico / Entero con decimales
Restricción: 9 dígitos enteros y dos decimales, separados por punto (.)
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
Numérico / Entero con decimales
Restricción: 9 dígitos enteros y dos decimales, separados por punto (.)
Sí.
2
DOCUMENTO TÉCNICOA-DT-GTI-005
Versión 1
CONSTRUCCIÓN WEB SERVICE REQUERIMIENTO CAPITAL CONGLOMERADOS
FINANCIEROS Página 15 de 35
Nombre Descripción Tipo Dato Formato Obligatorio
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
Numérico / Entero con decimales
Restricción: 9 dígitos enteros y dos decimales, separados por punto (.)
Sí.
reservasOcasionales Las reservas ocasionales, en concordancia con lo dispuesto en el artículo 2.31.1.2.4 del decreto 2555 de 2010
Numérico / Entero con decimales
Restricción: 9 dígitos enteros y dos decimales, separados por punto (.)
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
Numérico / Entero con decimales
Restricción: 9 dígitos enteros y dos decimales, separados por punto (.)
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.
Numérico / Entero con decimales
Restricción: 9 dígitos enteros y dos decimales, separados por punto (.)
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
Numérico / Entero con decimales
Restricción: 9 dígitos enteros y dos decimales, separados por punto (.)
Sí.
2
DOCUMENTO TÉCNICOA-DT-GTI-005
Versión 1
CONSTRUCCIÓN WEB SERVICE REQUERIMIENTO CAPITAL CONGLOMERADOS
FINANCIEROS Página 16 de 35
Nombre Descripción Tipo Dato Formato Obligatorio
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
Numérico / Entero con decimales
Restricción: 9 dígitos enteros y dos decimales, separados por punto (.)
Sí.
2
DOCUMENTO TÉCNICOA-DT-GTI-005
Versión 1
CONSTRUCCIÓN WEB SERVICE REQUERIMIENTO CAPITAL CONGLOMERADOS
FINANCIEROS Página 17 de 35
Nombre Descripción Tipo Dato Formato Obligatorio
instrumentosDeudaPatrimonioAdicional
Instrumentos de deuda, en concordancia con el artículo 2.1.1.1.13 del decreto 2555 de 2010
Numérico / Entero con decimales
Restricción: 9 dígitos enteros y dos decimales, separados por punto (.)
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
Numérico / Entero con decimales
Restricción: 9 dígitos enteros y dos decimales, separados por punto (.)
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.
Numérico / Entero con decimales
Restricción: 9 dígitos enteros y dos decimales, separados por punto (.)
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.
Numérico / Entero con decimales
Restricción: 9 dígitos enteros y dos decimales, separados por punto (.)
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.
Numérico / Entero con decimales
Restricción: 9 dígitos enteros y dos decimales, separados por punto (.)
Sí.
2
DOCUMENTO TÉCNICOA-DT-GTI-005
Versión 1
CONSTRUCCIÓN WEB SERVICE REQUERIMIENTO CAPITAL CONGLOMERADOS
FINANCIEROS Página 18 de 35
Nombre Descripción Tipo Dato Formato Obligatorio
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.
Numérico / Entero con decimales
Restricción: 9 dígitos enteros y dos decimales, separados por punto (.)
Sí.
reservasEstabilizacionAdmonPatrimoniosAut
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.
Numérico / Entero con decimales
Restricción: 9 dígitos enteros y dos decimales, separados por punto (.)
Sí.
reservasEstabilizacionAdmonFondosFonpet
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.
Numérico / Entero con decimales
Restricción: 9 dígitos enteros y dos decimales, separados por punto (.)
Sí.
deduccionesPatrimonioTecnico
Inversiones de capital entre entidades del conglomerado y otras operaciones intragrupo que no deban computar en el patrimonio técnico.
Numérico / Entero con decimales
Restricción: 9 dígitos enteros y dos decimales, separados por punto (.)
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
Numérico / Entero con decimales
Restricción: 9 dígitos enteros y dos decimales, separados por punto (.)
Sí.
2
DOCUMENTO TÉCNICOA-DT-GTI-005
Versión 1
CONSTRUCCIÓN WEB SERVICE REQUERIMIENTO CAPITAL CONGLOMERADOS
FINANCIEROS Página 19 de 35
Nombre Descripción Tipo Dato Formato Obligatorio
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.
Numérico / Entero con decimales
Restricción: 9 dígitos enteros y dos decimales, separados por punto (.)
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
DOCUMENTO TÉCNICOA-DT-GTI-005
Versión 1
CONSTRUCCIÓN WEB SERVICE REQUERIMIENTO CAPITAL CONGLOMERADOS
FINANCIEROS Página 20 de 35
Nombre Descripción Tipo Dato Formato Obligatorio
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
Numérico / Entero con decimales
Restricción: 9 dígitos enteros y dos decimales, separados por punto (.)
Sí.
totalRiesgoSuscripcion Sumatoria del riesgo en función de primas, siniestros y reserva matemática.
Numérico / Entero con decimales
Restricción: 9 dígitos enteros y dos decimales, separados por punto (.)
Sí.
riesgoFuncionPrimas
Riesgo en función de primas, en concordancia con el Artículo 2.31.1.2.6 del Decreto 2555 de 2010
Numérico / Entero con decimales
Restricción: 9 dígitos enteros y dos decimales, separados por punto (.)
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
Numérico / Entero con decimales
Restricción: 9 dígitos enteros y dos decimales, separados por punto (.)
Sí.
riesgoFuncionReservaMatematica
Riesgo en función de la reserva matemática, en concordancia con el
Numérico / Entero con decimales
Restricción: 9 dígitos enteros y dos decimales, separados por punto (.)
Sí.
2
DOCUMENTO TÉCNICOA-DT-GTI-005
Versión 1
CONSTRUCCIÓN WEB SERVICE REQUERIMIENTO CAPITAL CONGLOMERADOS
FINANCIEROS Página 21 de 35
Nombre Descripción Tipo Dato Formato Obligatorio
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).
Numérico / Entero con decimales
Restricción: 9 dígitos enteros y dos decimales, separados por punto (.)
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
Numérico / Entero con decimales
Restricción: 9 dígitos enteros y dos decimales, separados por punto (.)
Sí.
apnrPonderadosEntreUnoYCuarentayNuevePorciento
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
Numérico / Entero con decimales
Restricción: 9 dígitos enteros y dos decimales, separados por punto (.)
Sí.
2
DOCUMENTO TÉCNICOA-DT-GTI-005
Versión 1
CONSTRUCCIÓN WEB SERVICE REQUERIMIENTO CAPITAL CONGLOMERADOS
FINANCIEROS Página 22 de 35
Nombre Descripción Tipo Dato Formato Obligatorio
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
Numérico / Entero con decimales
Restricción: 9 dígitos enteros y dos decimales, separados por punto (.)
Sí.
apnrPonderadosAlCienPorciento
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
Numérico / Entero con decimales
Restricción: 9 dígitos enteros y dos decimales, separados por punto (.)
Sí.
apnrPonderadosDeMasDelCienPorciento
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
Numérico / Entero con decimales
Restricción: 9 dígitos enteros y dos decimales, separados por punto (.)
Sí.
apnrContingencias
En concordancia con lo dispuesto en el Artículo 2.1.1.3.5 del Decreto 2555 de 2011
Numérico / Entero con decimales
Restricción: 9 dígitos enteros y dos decimales, separados por punto (.)
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.
Numérico / Entero con decimales
Restricción: 9 dígitos enteros y dos decimales, separados por punto (.)
Sí.
apnrCategoriaDos
Activos ponderados por nivel de riesgo categoría ii,
Numérico / Entero con decimales
Restricción: 9 dígitos enteros y dos decimales, separados por punto (.)
Sí.
2
DOCUMENTO TÉCNICOA-DT-GTI-005
Versión 1
CONSTRUCCIÓN WEB SERVICE REQUERIMIENTO CAPITAL CONGLOMERADOS
FINANCIEROS Página 23 de 35
Nombre Descripción Tipo Dato Formato Obligatorio
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
Numérico / Entero con decimales
Restricción: 9 dígitos enteros y dos decimales, separados por punto (.)
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
Numérico / Entero con decimales
Restricción: 9 dígitos enteros y dos decimales, separados por punto (.)
Sí.
coeficienteCorrelacionSuscripcionMercado
Coeficientes de correlación, en concordancia con el Artículo 2.31.1.2.5 del Decreto 2555 de 2010.
Numérico / Entero con decimales
Restricción: 9 dígitos enteros y dos decimales, separados por punto (.)
Sí.
coeficienteCorrelacionSuscripcionActivo
Coeficientes de correlación, en concordancia con el Artículo 2.31.1.2.5 del Decreto 2555 de 2010.
Numérico / Entero con decimales
Restricción: 9 dígitos enteros y dos decimales, separados por punto (.)
Sí.
coeficienteCorrelacionSuscripcionActivoMercado
Coeficientes de correlación, en concordancia con el
Numérico / Entero con decimales
Restricción: 9 dígitos enteros y dos decimales, separados por punto (.)
Sí.
2
DOCUMENTO TÉCNICOA-DT-GTI-005
Versión 1
CONSTRUCCIÓN WEB SERVICE REQUERIMIENTO CAPITAL CONGLOMERADOS
FINANCIEROS Página 24 de 35
Nombre Descripción Tipo Dato Formato Obligatorio
Artículo 2.31.1.2.5 del Decreto 2555 de 2010.
excesoDefecto
Total del patrimonio técnico menos el total del patrimonio adecuado.
Numérico / Entero con decimales
Restricción: 9 dígitos enteros y dos decimales, separados por punto (.)
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
DOCUMENTO TÉCNICOA-DT-GTI-005
Versión 1
CONSTRUCCIÓN WEB SERVICE REQUERIMIENTO CAPITAL CONGLOMERADOS
FINANCIEROS Página 25 de 35
"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
DOCUMENTO TÉCNICOA-DT-GTI-005
Versión 1
CONSTRUCCIÓN WEB SERVICE REQUERIMIENTO CAPITAL CONGLOMERADOS
FINANCIEROS Página 26 de 35
"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
DOCUMENTO TÉCNICOA-DT-GTI-005
Versión 1
CONSTRUCCIÓN WEB SERVICE REQUERIMIENTO CAPITAL CONGLOMERADOS
FINANCIEROS Página 27 de 35
"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
DOCUMENTO TÉCNICOA-DT-GTI-005
Versión 1
CONSTRUCCIÓN WEB SERVICE REQUERIMIENTO CAPITAL CONGLOMERADOS
FINANCIEROS Página 28 de 35
"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
DOCUMENTO TÉCNICOA-DT-GTI-005
Versión 1
CONSTRUCCIÓN WEB SERVICE REQUERIMIENTO CAPITAL CONGLOMERADOS
FINANCIEROS Página 29 de 35
], "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
Nombre Descripción Tipo Dato Obligatorio
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:
Nombre Descripción Tipo Dato Obligatorio
consecutivoTransmision Consecutivo utilizado para identificar la transmisión.
Entero Si
estadoSatisfactorio Bandera que indica si los datos recibidos fueron validados satisfactoriamente
Booleano Si
2
DOCUMENTO TÉCNICOA-DT-GTI-005
Versión 1
CONSTRUCCIÓN WEB SERVICE REQUERIMIENTO CAPITAL CONGLOMERADOS
FINANCIEROS Página 30 de 35
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
DOCUMENTO TÉCNICOA-DT-GTI-005
Versión 1
CONSTRUCCIÓN WEB SERVICE REQUERIMIENTO CAPITAL CONGLOMERADOS
FINANCIEROS Página 31 de 35
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
DOCUMENTO TÉCNICOA-DT-GTI-005
Versión 1
CONSTRUCCIÓN WEB SERVICE REQUERIMIENTO CAPITAL CONGLOMERADOS
FINANCIEROS Página 32 de 35
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
DOCUMENTO TÉCNICOA-DT-GTI-005
Versión 1
CONSTRUCCIÓN WEB SERVICE REQUERIMIENTO CAPITAL CONGLOMERADOS
FINANCIEROS Página 33 de 35
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
DOCUMENTO TÉCNICOA-DT-GTI-005
Versión 1
CONSTRUCCIÓN WEB SERVICE REQUERIMIENTO CAPITAL CONGLOMERADOS
FINANCIEROS Página 34 de 35
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
DOCUMENTO TÉCNICOA-DT-GTI-005
Versión 1
CONSTRUCCIÓN WEB SERVICE REQUERIMIENTO CAPITAL CONGLOMERADOS
FINANCIEROS Página 35 de 35
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
DOCUMENTO TÉCNICOA-DT-GTI-005
Versión 1
CONSTRUCCIÓN WEB SERVICE REQUERIMIENTO CAPITAL CONGLOMERADOS
FINANCIEROS Página 36 de 35
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
2
DOCUMENTO TÉCNICOA-DT-GTI-005
Versión 1
CONSTRUCCIÓN WEB SERVICE REQUERIMIENTO CAPITAL CONGLOMERADOS
FINANCIEROS Página 37 de 35
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
DOCUMENTO TÉCNICOA-DT-GTI-005
Versión 1
CONSTRUCCIÓN WEB SERVICE REQUERIMIENTO CAPITAL CONGLOMERADOS
FINANCIEROS Página 38 de 35
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