INTENDENCIA DE TECNOLOGÍA Estructura XML R05 MANUAL TÉCNICO (Versión 1.0) Estructura XML Actualizaciones: Fecha Cambios/Campos 15/04/2015 Cambios: Aumento de nota Páginas 7 ÍNDICE 1. INTRODUCCIÓN .............................................................................................................................. 3 2. CANCELACIONES Y CAMBIOS DE CALIFICACION (R05) ................................................... 3 3. CONSIDERACIONES ....................................................................................................................... 3 4. CODIGO HASH PARA LOS ARCHIVOS XML ........................................................................... 3 5. ESTRUCTURA DEL XSD/XML PARA ESTRUCTURA R05 ...................................................... 5 6. DETALLE CAMPOS ......................................................................................................................... 7 6.1. CABECERA........................................................................................................................................ 7 6.2. 7. DETALLE ................................................................................................................................ 8 ANEXOS ............................................................................................................................................. 9 7.1. ANEXO 1.- TABLA 4: TIPO DE IDENTIFICACIÓN. .................................................................. 9 7.2. ANEXO 2.- TABLA 29: CALIFICACIÓN (CATEGORIA DE RIESGO). ................................ 10 7.3. ANEXO 3.- TABLA 39: FORMA DE CANCELACION. ............................................................. 10 7.4. ANEXO 4.- TABLA 208: TIPO DE TRANSACCIÓN (R05). ...................................................... 11 SEPS – Intendencia de Tecnología Página 2 Estructura XML 1. INTRODUCCIÓN Las organizaciones de la SFPS pueden cargar sus estructuras de reporte de créditos a la base de datos de la SEPS generando el archivo XML a partir de sus core’s bancarios. 2. CANCELACIONES Y CAMBIOS DE CALIFICACION (R05) Esta estructura comprende el detalle de las operaciones de crédito y contingentes que han sido canceladas o cedidas, así como también la cancelación definitiva de las tarjetas de crédito. Adicionalmente comprende información de cambios de calificaciones de las operaciones que aún se encuentran activas (de manera excepcional, cuando se requiere reportar el cambio de calificación antes el proceso mensual). 3. CONSIDERACIONES Los campos que hagan referencia a fecha, serán de tipo string y deberán tener el formato dd/mm/aaaa. Los campos que sean de tipo double utilizará el símbolo punto (.) como separador decimal. No se utilizará símbolo para la separación de miles. 4. CODIGO HASH PARA LOS ARCHIVOS XML Para cargar los archivos tanto de Créditos por medio del sistema de Servicios Electrónicos de la SEPS, la organización debe generar un archivo .zip, que incluye el XML y un archivo HASH tipo .txt, que contiene un código para verificar la validez del XML y su NO manipulación después de la generación. El código HASH es generado a partir de un algoritmo basado en MD5. El nombre del archivo XML que contiene la información de créditos, debe conservar el formato: “creditos_RXX_RUC_DD-MM-YYYY”.xml, SEPS – Intendencia de Tecnología Página 3 Estructura XML En donde, DD-MM-YYYY corresponde a la fecha de datos (fecha de corte) de la información. ejemplo: creditos_R05_123456789001_31-03-2014.xml El nombre del archivo TXT que contiene el código verificador HASH debe conservar el formato: “creditos_RXX_RUC_DD-MM-YYYY-hash”.txt, En donde, DD-MM-YYYY debe ser la misma del archivo XML ejemplo: creditos_R05_123456789001_05-07-2012-hash.txt El nombre del archivo ZIP que contiene los archivos debe conservar el formato: “creditos_RXX_RUC_DD-MMM-YY HH-MM-SS.zip”, siendo: creditos, tipo de información que se reporta. RXX, nombre de la estructura que se reporta. RUC, ruc de la organización que reporta la información. DD, dia de la fecha de datos con dos dígitos. MM, mes de la fecha de datos con dos dígitos. AAAA, año de la fecha de datos con cuatro dígitos. HH, hora a la que se generó el archivo. No va MM, minutos a la que se generó el archivo. No va SS, segundos a la que se generó el archivo. No va Ejemplo “creditos_R05_123456789001_05-07-2012Y 12-00-00.zip”. Si la organización NO genera este .zip con los archivos XML y HASH, el sistema no les permitirá cargar la estructura. SEPS – Intendencia de Tecnología Página 4 Estructura XML 5. ESTRUCTURA DEL XSD/XML PARA ESTRUCTURA R05 El archivo XSD para validación del XML generado es: <?xml version="1.0" encoding="UTF-8"?> <xsd:schema targetNamespace="http://www.seps.gob.ec/r05" elementFormDefault="qualified" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:r05="http://www.seps.gob.ec/r05"> <xsd:element name="organizacion" type="r05:organizacionType" /> <xsd:complexType name="organizacionType"> <xsd:sequence> <xsd:element name="elemento" minOccurs="0" maxOccurs="unbounded" type="r05:elementoType"/> </xsd:sequence> <xsd:attribute name="estructura" use="required"> <xsd:simpleType> <xsd:restriction base="xsd:string"> <xsd:maxLength value="3"></xsd:maxLength> </xsd:restriction> </xsd:simpleType> </xsd:attribute> <xsd:attribute name="rucOrganizacion" use="required"> <xsd:simpleType> <xsd:restriction base="xsd:string"> <xsd:maxLength value="13"></xsd:maxLength> </xsd:restriction> </xsd:simpleType> </xsd:attribute> <xsd:attribute name="fechaCorte" use="required"> <xsd:simpleType> <xsd:restriction base="xsd:string"> <xsd:pattern value="\d{2}/\d{2}/\d{4}"/> </xsd:restriction> </xsd:simpleType> </xsd:attribute> <xsd:attribute name="numRegistro" use="required"> <xsd:simpleType> <xsd:restriction base="xsd:long"> <xsd:totalDigits value="7"></xsd:totalDigits> </xsd:restriction> </xsd:simpleType> </xsd:attribute> </xsd:complexType> <xsd:complexType name="elementoType"> <xsd:attribute name="tipoIdentificacion" use="required"> SEPS – Intendencia de Tecnología Página 5 Estructura XML <xsd:simpleType> <xsd:restriction base="xsd:string"> <xsd:maxLength value="1"></xsd:maxLength> </xsd:restriction> </xsd:simpleType> </xsd:attribute> <xsd:attribute name="numIdentificacion" use="required"> <xsd:simpleType> <xsd:restriction base="xsd:string"> <xsd:maxLength value="13"></xsd:maxLength> </xsd:restriction> </xsd:simpleType> </xsd:attribute> <xsd:attribute name="numOperacion" use="required"> <xsd:simpleType> <xsd:restriction base="xsd:string"> <xsd:maxLength value="32"></xsd:maxLength> </xsd:restriction> </xsd:simpleType> </xsd:attribute> <xsd:attribute name="tipoTransaccion" use="required"> <xsd:simpleType> <xsd:restriction base="xsd:string"> <xsd:maxLength value="1"></xsd:maxLength> </xsd:restriction> </xsd:simpleType> </xsd:attribute> <xsd:attribute name="fechaCancelacionCambio" use="required"> <xsd:simpleType> <xsd:restriction base="xsd:string"> <xsd:pattern value="\d{2}/\d{2}/\d{4}"/> </xsd:restriction> </xsd:simpleType> </xsd:attribute> <xsd:attribute name="formaCancelacion"> <xsd:simpleType> <xsd:restriction base="xsd:string"> <xsd:maxLength value="2"></xsd:maxLength> </xsd:restriction> </xsd:simpleType> </xsd:attribute> <xsd:attribute name="calificacion"> <xsd:simpleType> <xsd:restriction base="xsd:string"> <xsd:maxLength value="2"></xsd:maxLength> </xsd:restriction> </xsd:simpleType> SEPS – Intendencia de Tecnología Página 6 Estructura XML </xsd:attribute> </xsd:complexType> </xsd:schema> El archivo XML deberá generarse a partir de la siguiente estructura: NOTA: Despues de cada línea deberá ser incluido un espacio en blanco como se muestra en el siguiente formato XML. <?xml version="1.0" encoding="utf-8"?> <organizacion estructura="R05" rucOrganizacion="xxxxxxxxxxxxx". fechaCorte="dd/mm/AAAA" numRegistro="00" xmlns="http://www.seps.gob.ec/r05"> <elemento. tipoIdentificacion="x". numIdentificacion="xxxxxxxxxxxxx". numOperacion="xxxx". tipoTransaccion="xxx". fechaCancelacionCambio="dd/mm/AAAA". formaCancelacion="xxx". calificacion="xxxx" /> </organizacion> 6. DETALLE CAMPOS 6.1. CABECERA Campo código de la estructura código de entidad fecha de datos número total de registros Tipo de dato Opción caracter (3) caracter (13) numérico (6) obligatorio obligatorio fecha (dd/mm/aaaa) obligatorio obligatorio estructura.- Codificación asignada a la estructura de “Cancelaciones y cambios de calificación” (R05). rucOrganizacion.- RUC de la organización que reporta la estructura R05. fechaCorte.- Fecha de corte de la información enviada. Debe corresponder al último día del mes de reporte. SEPS – Intendencia de Tecnología Página 7 Estructura XML 6.2. Campo numRegistro.- Número de elementos que contiene el archivo sin incluir el registro de cabecera. DETALLE tipoIdentifica numIdentifica numOperacio tipoTransaccio fechaCancelaci formaCancelaci cion cion n n onCambio on Tipo de dato string string string string string (dd/mm/aaaa) Opción Tabla obligatorio tabla 4 obligatorio obligatorio obligatorio tabla 208 obligatorio Campo calificación Tipo de dato Opción Tabla string string tabla 39 tabla 29 tipoIdentificacion.- Tipo identificación del sujeto.- Se refiere al tipo de documento de identificación del sujeto, puede ser “C”, “R” ó “P”. refencia tabla 4 numIdentificacion.- Corresponde al número de identificación del sujeto. Para personas naturales ecuatorianas será el número de cédula, para personas jurídicas el número de ruc y para personas extranjeras el número de pasaporte. numOperacion.- Código único con el que la entidad financiera identifica a cada operación que efectúa. tipoTransaccion.- Código que indica la transacción que se está reportando: cancelación de operación de crédito, cancelación definitiva de tarjeta de crédito o cambio de calificación de una operación de crédito, referencia tabla 208. SEPS – Intendencia de Tecnología Página 8 Estructura XML fechaCancelacionCambio.- Si el tipo de transacción refiere a una cancelación de una operación de crédito, entonces este campo indica la fecha en la que se realizó dicha cancelación. Si el tipo de transacción refiere a una cancelación de una tarjeta de crédito, entonces este campo indica la fecha en la que se realizó la cancelación definitiva de la tarjeta, para lo cual el campo número de operación debe corresponder al código o número de tarjeta de crédito. Si el tipo de transacción refiere a un cambio de calificación de una operación de crédito vigente, entonces este campo indica la fecha en la que se realizó esta modificación de la calificación de dicha operación. formaCancelacion.- Código que especifica la forma en que se canceló la operación (tipo de transacción=”C”). Si existiera más de una forma de cancelación para una misma operación, deberá registrarse la más significativa en función del monto. Si se trata de una cancelación de tarjeta de crédito (tipo de transacción=”T”), este campo solo podrá tener el código “X”, es decir cuando el sujeto de crédito deja de ser tarjetahabiente de la entidad. Referencia tabla 39. Será de uso *obligatorio cuando el registro refiera a una cancelación total de la operación de crédito o una cancelación definitiva de tarjeta de crédito. Si se trata de un cambio de calificación, este campo será NULO. calificacion.- Es la nueva calificación a la categoría de riesgo, asignada a la operación fuera del cierre mensual. Referencia tabla 29. Será de uso *obligatorio cuando el campo tipo de transacción tenga el valor “A”, caso contario será NULO. 7. ANEXOS 7.1. Anexo 1.- Tabla 4: Tipo de Identificación. SEPS – Intendencia de Tecnología Página 9 Estructura XML CODIGO 7.2. DESCRIPCION C Para personas naturales identificadas con la cédula de identidad ecuatoriana R Para personas jurídicas identificadas con el número de RUC. P Para personas naturales o jurídicas extranjeras identificadas con PASAPORTE Anexo 2.- Tabla 29: Calificación (Categoria de Riesgo). CODIGO DESCRIPCION A1 Créditos de riesgo normal categoría A-1 A2 Créditos de riesgo normal categoría A-2 A3 Créditos de riesgo normal categoría A-3 B1 Créditos con riesgo potencial categoría B-1 B2 Créditos con riesgo potencial categoría B-2 C1 Créditos deficientes categoría C-1 C2 Créditos deficientes categoría C-2 D Créditos de dudoso recaudo categoría D E Pérdidas categoría E Sin calificación (solo para operaciones con acuerdo concordatorio) N No aplica para el campo calificación homolgada AL Sin calificación (Cuando la institución del sistema financiero cuente con garantías autoliquidables que cubran el cien por ciento del saldo del crédito otorgado). No aplica para el campo calificación homolgada 7.3. Anexo 3.- Tabla 39: Forma de Cancelacion. DESCRIPCION – FORMA DE CANCELACION CODIGO N En efectivo SEPS – Intendencia de Tecnología Página 10 Estructura XML DESCRIPCION – FORMA DE CANCELACION CODIGO 7.4. E Efectivización de garantías G Pago del garante C Títulos R Certificados de depósito restringidos S Sustitución de deudor D Bienes o títulos adjudicados o recibidos en dación en pago J Adjudicación judicial por pago O Con otra operación en la misma institución (novación, refinanciación, reestructuración) V Venta de cartera P Cesión de operaciones A Compensación B Cambio de status interno M Migración de plataforma K Obligaciones extinguidas por acuerdos concordatarios y otros contratos X Cancelación de tarjeta de crédito Z Pagada por el banco comunal I Cancelación por falta de sustento F Cesantía H Seguros sobre saldos L Condonación (circular no. IG-DNE-2009-010) Q Condonación (Resolución No. JB-2009-1269 Rebaja de deudas) Anexo 4.- Tabla 208: Tipo de Transacción (R05). CODIGO C SEPS – Intendencia de Tecnología DESCRIPCION Cancelación de operación de crédito Página 11 Estructura XML CODIGO DESCRIPCION T Cancelación definitiva de tarjeta de crédito A Cambio de calificación de una operación de crédito SEPS – Intendencia de Tecnología Página 12