INTENDENCIA DE TECNOLOGÍA Estructura XML R03 MANUAL TÉCNICO (Versión 1.0)
Actualizaciones: Fecha Cambios/Campos Páginas 15/04/2015 Cambios: Aumento de nota 6 ÍNDICE 1. INTRODUCCIÓN... 3 2. OPERACIONES ANTERIORES (R03)... 3 3. CONSIDERACIONES... 3 4. CODIGO HASH PARA LOS ARCHIVOS XML... 3 5. ESTRUCTURA DEL XSD/XML PARA ESTRUCTURA R03... 5 6. DETALLE CAMPOS... 7 6.1. CABECERA... 7 6.2. DETALLE... 7 7. ANEXOS... 8 7.1. ANEXO 1.- TABLA 4: TIPO DE IDENTIFICACIÓN.... 8 SEPS Intendencia de Tecnología Página 2
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 por dos vías; generando el archivo XML a partir de sus core s bancarios. 2. OPERACIONES ANTERIORES (R03) Esta estructura comprende el detalle de las operaciones anteriores que fueron novadas, refinanciadas o reestructuradas por una nueva. Deberá incluirse un registro por cada operación anterior y éstas a su vez serán reportadas como canceladas en la estructura R05. 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 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
En donde, DD-MM-YYYY corresponde a la fecha de datos (fecha de corte) de la información. ejemplo: creditos_r03_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_r03_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_r03_123456789001_05-07-2012 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
5. ESTRUCTURA DEL XSD/XML PARA ESTRUCTURA R03 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/r03" elementformdefault="qualified" xmlns:xsd="http://www.w3.org/2001/xmlschema" xmlns:r03="http://www.seps.gob.ec/r03"> <xsd:element name="organizacion" type="r03:organizaciontype" /> <xsd:complextype name="organizaciontype"> <xsd:sequence> <xsd:element name="elemento" minoccurs="0" maxoccurs="unbounded" type="r03:elementotype"/> </xsd:sequence> <xsd:attribute name="estructura" use="required"> <xsd:maxlength value="3"></xsd:maxlength> <xsd:attribute name="rucorganizacion" use="required"> <xsd:maxlength value="13"></xsd:maxlength> <xsd:attribute name="fechacorte" use="required"> <xsd:pattern value="\d{2}/\d{2}/\d{4}"/> <xsd:attribute name="numregistro" use="required"> <xsd:restriction base="xsd:long"> <xsd:totaldigits value="7"></xsd:totaldigits> </xsd:complextype> <xsd:complextype name="elementotype"> <xsd:attribute name="tipoidentificacion" use="required"> SEPS Intendencia de Tecnología Página 5
<xsd:maxlength value="1"></xsd:maxlength> <xsd:attribute name="numidentificacion" use="required"> <xsd:maxlength value="13"></xsd:maxlength> </xsd:complextype> </xsd:schema> <xsd:attribute name="numoperacion" use="required"> <xsd:maxlength value="32"></xsd:maxlength> <xsd:attribute name="numoperacionanterior" use="required"> <xsd:maxlength value="32"></xsd:maxlength> <xsd:attribute name="fechanovarefirees" use="required"> <xsd:pattern value="\d{2}/\d{2}/\d{4}"/> 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. SEPS Intendencia de Tecnología Página 6
<?xml version="1.0" encoding="utf-8"?> <organizacion estructura="r03" rucorganizacion="xxxxxxxxxxxxx". fechacorte="dd/mm/aaaa" numregistro="00" xmlns="http://www.seps.gob.ec/r03"> <elemento. tipoidentificacion="x". numidentificacion="xxxxxxxxxxxxx". numoperacion="xxxx". numoperacionanterior="xxxx". fechanovarefirees="dd/mm/aaaa" /> </organizacion> 6. DETALLE CAMPOS 6.1. CABECERA Campo estructura rucorganizaci on fechacorte numregistro Tipo de caracter (3) caracter(13) fecha numérico (6) dato (dd/mm/aaaa) Opción obligatorio obligatorio obligatorio obligatorio estructura.- Codificación asignada a la estructura de Operaciones anteriores (R03). rucorganizacion.- RUC de la organización que reporta la estructura R03. fechacorte.- Fecha de corte de la información enviada. Debe corresponder al último día del mes de reporte. numregistro.- Número de elementos que contiene el archivo sin incluir el registro de cabecera. 6.2. DETALLE Campo tipoidentifica cion numidentificacion numoperaci on numoperacionanter ior fechanovarefire es Tipo de dato caracter (1) caracter (13) caracter (32) caracter (32) fecha (dd/mm/aaaa) Opción obligatorio obligatorio obligatorio obligatorio obligatorio Tabla tabla 4 SEPS Intendencia de Tecnología Página 7
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. numoperacionanterior.- Es el número de operación precedente, de la que proviene la nueva operación. fechanovarefirees.- Fecha en la que se creó la nueva operación, producto de la novación, refinanciación o reestructuración de la anterior. 7. ANEXOS 7.1. Anexo 1.- Tabla 4: Tipo de Identificación. CODIGO C R P DESCRIPCION Para personas naturales identificadas con la cédula de identidad ecuatoriana Para personas jurídicas identificadas con el número de RUC. Para personas naturales o jurídicas extranjeras identificadas con PASAPORTE SEPS Intendencia de Tecnología Página 8