Manual Tecnológico estructura R05

Anuncio
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
Descargar