N O R M A

C O M P L E M E N T AR I A

ESTÁNDAR GENERAL PARA INTERCAMBIO ELECTRÓNICO DE DATOS SERIE DE NORMAS Y PROCEDIMIENTOS

NC-IED

NORMA COMPLEMENTARIA

ESTÁNDAR GENERAL PARA INTERCAMBIO ELECTRÓNICO DE DATOS SERIE DE NORMAS Y PROCEDIMIENTOS

NC-IED

Norma complementaria - Estándar general para intercambio electrónico de datos

Tabla de contenido 1. Introducción ...................................................................................... 1 2. Alcance ............................................................................................. 1 3. Términos empleados .......................................................................... 2 4. Documentos aplicables y anexos ........................................................ 2 5. Archivos con lotes de operaciones ...................................................... 2 5.1. Consideraciones generales................................................................. 2 5.1.1. Estructura del archivo ................................................................................2 5.1.2. Comentarios ..............................................................................................4 5.1.3. Generación de errores ................................................................................4 5.1.3.1. Formato del archivo de errores ................................................................5

5.2. Validación de estructura del archivo................................................... 5 5.3. Validación de contenido .................................................................... 7 5.3.1. Validaciones generales ...............................................................................7 5.3.2. Encabezado ...............................................................................................9 5.3.2.1. CICLO ...................................................................................................9 5.3.2.2. ENTIDAD ..............................................................................................9 5.3.3. Bloque de Datos ......................................................................................10 5.3.3.1. Nodo de Datos ......................................................................................10 5.3.3.2. RESUMEN ...........................................................................................10

6. Validaciones adicionales para archivos SCL .................................... 10 7. Procesamiento de operaciones en Tiempo Real ................................ 11

Edición: 3

Público

Vigencia: 26-12-2006

Norma complementaria - Estándar general para intercambio electrónico de datos

Sistema Nacional de Pagos Electrónicos Sistemas de Pago - BCCR

Año 2006

1. Introducción Este documento es un material de apoyo para los participantes en los servicios electrónicos del Sistema Nacional de Pagos Electrónicos (SINPE) que utilizan archivos para la importación de operaciones o tienen un funcionamiento en tiempo real mediante el uso de WebServices - Servicios de Liquidación Bruta (SLB), o cuya operativa se basa en la compensación y liquidación de lotes de operaciones - Servicios de Compensación y Liquidación (SCL). Para los servicios SCL y la importación en SLB se describen las generalidades del estándar electrónico para un archivo de intercambio electrónico de datos, y en combinación con los estándares particulares de cada servicio, sirve como referencia para que los departamentos de informática de las entidades verifiquen el estado de sus sistemas internos e identifiquen los ajustes necesarios para facilitar la generación y recepción de archivos estandarizados para el Sistema de Pagos. Es importante destacar que la validación de archivos se lleva a cabo en forma distribuida, prácticamente en un 100%, en los nodos ubicados en las instalaciones de los diferentes participantes. Debido a esta particularidad, un proceso vital para cada usuario será la ejecución del proceso de validación desde un nodo del SINPE, ya que si el mismo no es exitoso no existe posibilidad de realizar el envío del archivo o la importación de las operaciones. Este procesamiento distribuido constituye una gran ventaja operativa, ya que el éxito en la validación del archivo prácticamente garantiza que el mismo será procesado sin mayores dificultades. Sin embargo, para los servicios SCL es posible que después de la validación existan errores menores que, en todo caso, serán detectados en el momento de la transmisión. Este tipo de errores de describen en la sección 6 de este documento. Adicionalmente, para los servicios que procesan las operaciones en tiempo real mediante la comunicación de los sistemas de las entidades y el SINPE, se describen los aspectos comunes para dicha comunicación, como por ejemplo el manejo de las excepciones.

2. Alcance Este documento debe ser utilizado por cada uno de los participantes en el Sistema Nacional de Pagos de Costa Rica y que necesiten hacer uso de alguno de los servicios del SINPE.

Edición: 3

Público

Vigencia: 26-12-2006 1

Norma complementaria - Estándar general para intercambio electrónico de datos

3. Términos empleados Para los fines del presente documento, se entenderá por: 

BCCR: Banco Central de Costa Rica.



SCL: Servicios de Compensación y Liquidación.



SINPE: Sistema Nacional de Pagos Electrónicos.



SLB: Servicios de Liquidación Bruta.



XML: eXtensible Markup Language, el cual es un formato universal para documentos estructurados.

Para consultar algún otro término que se utilice en este documento, remítase a la Norma complementaria - Glosario general.

4. Documentos aplicables y anexos Siglas

Nombre del documento

NC-CC

Norma complementaria - Cuenta Cliente (CC) e IBAN.

NC-GG

Norma complementaria - Glosario general.

5. Archivos con lotes de operaciones 5.1. Consideraciones generales 5.1.1. Estructura del archivo Los archivos para el intercambio electrónico de datos del SINPE tienen un formato conocido como XML que constituye un formato universal para documentos estructurados. Su estructura puede ser diferente dependiendo del tipo de información que se quiere almacenar, pero siempre deben estar “bien formados” según los estándares del W3C (www.w3c.org/) y ser válidos según las normas de validación del SINPE para cada uno de los servicios electrónicos. De manera muy general, un archivo XML está compuesto por una estructura jerárquica de nodos, donde cada nodo está identificado por una etiqueta (Tag) de inicio que tiene la siguiente forma “”. Cada nodo con una etiqueta de inicio, debe contar con una etiqueta de cierre, de la siguiente forma “”. El contenido del nodo está representado por los datos entre la etiqueta de inicio y de cierre, y puede estar compuesto por otros nodos anidados y / o por atributos, estos últimos están ubicados luego de la etiqueta del nodo, y deben seguir el siguiente formato NombreAtributo=”Valor”.

Edición: 3

Público

Vigencia: 26-12-2006 2

Norma complementaria - Estándar general para intercambio electrónico de datos

Las etiquetas de los nodos deben estar en mayúsculas y los nombres de los atributos deben seguir el estándar de PascalCasing, definiendo cada letra de inicio de palabra con mayúscula y el resto con minúscula. Además, el nodo principal del archivo debe ser . A continuación se presenta un ejemplo de un archivo bien formado siguiendo los estándares propuestos.

Los archivos de intercambio electrónico de datos se componen de dos estructuras principales conocidas como encabezado y bloque de datos. El encabezado identifica los datos generales del archivo, como el servicio al que pertenece el archivo, la entidad que utiliza el servicio, y cuál es su propósito (si contiene datos que son enviados al SINPE para su procesamiento o como resultado de devoluciones). Si algún servicio contiene información específica en el encabezado del archivo, esto se indicará en su estándar particular. El archivo puede contener uno o varios bloques de datos, según se indique en el estándar electrónico de cada servicio. Dentro de cada bloque de datos, hay un nodo por cada documento que es enviado para cobro o devolución, o que es importado en el SINPE. La etiqueta del nodo que representa una operación dependerá del estándar específico del servicio implementado. Además, como último nodo del bloque de datos debe existir un nodo de resumen que contiene información de verificación de la cantidad de registros y el monto total sin distinción de moneda del bloque. A continuación se presentan los nodos en un archivo válido para intercambio electrónico de datos. Para efectos de este ejemplo, se utiliza como etiqueta REGISTROS como bloque de datos y para cada nodo de documento la etiqueta REGISTRO, aunque las mismas dependerán de los estándares particulares de cada servicio.

Edición: 3

Público

Vigencia: 26-12-2006 3

Norma complementaria - Estándar general para intercambio electrónico de datos

Nodo Principal para los archivos del SINPE



Nodo de Encabezado

Nodo de Datos

Final del nodo de Encabezado Nodo de Bloque de Datos

...

Resumen de Nodos de Datos



Final del Nodo Principal

Final Nodo de Bloque de Datos



Las generalidades de la estructura de un archivo de intercambio electrónico de datos se describen en los puntos siguientes. 5.1.2. Comentarios Cuando se elabora un archivo de intercambio electrónico de datos, se permite que la entidad que lo genera incluya comentarios, los cuales deben colocarse entre “”, caracteres que indican que su contenido debe ser ignorado por la validación del archivo. Esta facilidad permite contar con una documentación interna del archivo para la entidad, sin embargo, es importante recordar que durante el proceso de validación estos comentarios son eliminados. El uso de estos comentarios depende de cada entidad, sin embargo, debe ser restringido ya que su utilización puede afectar el rendimiento en el proceso de validación. 5.1.3. Generación de errores Existe una rutina que se encarga de validar cada línea del archivo y emitir un listado detallado de cada error encontrado en un archivo de salida. Este archivo puede ser examinado posteriormente por el personal indicado y ser usado como fuente primaria para la corrección respectiva. Es importante rescatar que cualquier error de una severidad distinta a advertencia dentro del archivo, es motivo suficiente para considerarlo no apto para ser enviado al SINPE para su procesamiento.

Edición: 3

Público

Vigencia: 26-12-2006 4

Norma complementaria - Estándar general para intercambio electrónico de datos

5.1.3.1. Formato del archivo de errores El archivo de errores que se genera también se encuentra en formato XML y se compone de un nodo principal “SINPEERRORESXML” que contendrá un nodo por cada error que se haya encontrado en el archivo. Un ejemplo de la estructura del archivo de errores es el siguiente: