Manual Tecnico WebServices - v.08!10!2020

Manual de uso Técnico
Online Banking Cash Management - WebServices
Versión 08-10-2020
Online Banking Cash Management – WebServices
- Contenido -
1 PREFACIO .............................................................................................................................. 3
2 GUÍA DE REFERENCIA ......................................................................................................... 4
3 INTRODUCCIÓN .................................................................................................................... 5
4 MANEJO DE LA ENCRIPCIÓN MEDIANTE EL MÓDULO RSABC ...................................... 6
4.1 PREPARACIÓN DE ARCHIVOS Y TAGS PARA ENVIAR AL BANCO ............................................. 6
4.1.1 Armado del MD5 del archivo plano ....................................................................... 6
4.1.2 Encripción del archivo a enviar al Banco .............................................................. 7
4.1.3 Preparado de la clave 3Des para enviar al Banco ................................................ 7
4.1.4 Preparado del TAG de firmantes ........................................................................... 8
4.2 OBTENCIÓN DE ARCHIVOS DESDE EL BANCO ...................................................................... 9
4.2.1 Desencripción del archivo ..................................................................................... 9
4.2.2 Obtención y verificación de la firma del archivo .................................................... 9
4.2.3 Resumen de los pasos para enviar y recibir un archivo ..................................... 10
5 COBRANZA INTERACTIVA Y PAGOS ............................................................................... 11
5.1 PRODUCTOS Y FUNCIONES ............................................................................................. 11
PARA AQUELLAS FUNCIONES QUE REQUIERAN LOS TAGS DE FIRMANTES , EL TIPO DE DOCUMENTO
PUEDE TENER ALGUNO DE LOS SIGUIENTES VALORES:.................................................................... 12
5.2 FUNCIONES PARA EL MODULO DE DEUDA ......................................................................... 12
5.2.1 Función 1: Importación de archivo de publicación de deuda. ............................. 12
5.2.2 Función 2: Exportación de archivos de rechazos de deuda ............................... 22
5.2.3 Función 3: Exportación de archivos de rendición de Cobranzas ........................ 23
5.2.4 Función 4: Consulta de estado de un envío de deuda ........................................ 25
5.2.5 Función 5: Consulta de archivos de rechazos de deuda. ................................... 28
5.2.6 Función 6: Consulta de archivos de rendición de deuda por rango de fechas ... 29
5.2.7 Función 7: Publicación de Deuda On Line .......................................................... 30
5.2.8 Función 8: Pedido de archivo de información adicional IA4 ............................... 38
5.2.9 Función 9: Consulta de Cobros ONLINE ............................................................ 40
5.2.10 Función 12: Publicación de DEBIN On Line........................................................ 46
5.3 FUNCIONES PARA EL MODULO DE PAGOS ......................................................................... 55
5.3.1 Función 1: Importación de archivo de pagos ...................................................... 55
5.3.2 Función 2: Exportación de archivos de pagos .................................................... 58
5.3.3 Función 3: Consulta de estado de un envío de pago .......................................... 60
5.3.4 Función 4: Consulta de archivos de rechazos de pago. ..................................... 62
5.3.5 Función 5: Consulta de archivos de rendición de pago por rango de fechas ..... 63
6 CONFIGURACIONES........................................................................................................... 66
6.1 INVOCACIÓN A ONLINE CASH MANAGEMENT - WEBSERVICES. .......................................... 66
6.1.1 Invocación al WebService con el cliente provisto ............................................... 66
6.1.2 Invocación al Web Service sin el cliente provisto ............................................... 67
6.2 CONFIGURACIONES Y URLS DE ACCESO AL SISTEMA ....................................................... 68
2
1 Prefacio
Este manual está destinado al responsable técnico de integrar los sistemas de la Empresa
Cliente con los Web Services del Banco Santander Río S.A. A lo largo del mismo se detallan los
elementos necesarios para establecer la interconexión con los Servicios del Banco:
 Clases y métodos.
 Estructura de archivos XML.
 Funcionalidad.
 Metodología de encripción de archivos y firmas.
3
2 Guía de Referencia
Los tipos de letras e íconos detallados a continuación tienen el siguiente significado a lo largo de
este manual técnico:
Random r=new Random(); Courier 9 se utiliza para indicar código fuente o

archivos XML
Ejemplo
Nota
4
3 Introducción
Los WebServices de Online Cash Management intercambiarán información con los clientes por
medio de una conexión SOAP sobre HTTPS con autenticación a ambos lados. A tal efecto es
necesario que el cliente disponga del certificado que le permita efectuar tal conexión. El mismo
es emitido por la autoridad certificadora designada por Banco Santander Río S.A.
Cada cliente que desee incorporar la modalidad de transmisión vía webservices deberá construir
las interfaces necesarias en sus sistemas para que se generen tanto los archivos a enviar como
los XML que contienen los parámetros requeridos para cada invocación.
Los XMLs podrán contener elementos firmados, compactados y encriptados. Estos deberán ser
generados utilizando los estándares definidos por Banco Santander Río S.A..
La Importación es el proceso en el cual la Empresa genera archivos para enviar posteriormente

al Banco (Importación a Online Cash Management). Por su parte, la exportación es el proceso
por el cual la Empresa descarga archivos desde el Banco (Exportación desde Online Cash
Management).
La Empresa, a través de su sistema, invocará una URL donde enviará distintos datos contenidos
en un XML, mediante el protocolo SOAP. De esta manera se podrán efectuar los procesos de
recepción, envío y consultas. El XML será distinto para cada función a invocar.
Los XMLs recibidos por el servidor serán validados utilizando schemas. Los schemas validarán
que los campos obligatorios estén presentes, los tipos, las longitudes y los valores posibles.
5
4 Manejo de la encripción mediante el módulo RSABC

Preparación de los archivos a enviar mediante el módulo RSABC
Existen dos modos de operación posibles para la transmisión de archivos entre un Cliente y el
Banco:
 Con encripción de archivos
 Sin encripción de archivos
La elección del Esquema de seguridad deberá ser consensuada de común acuerdo entre el
Cliente y el Banco y una vez establecida no podrá ser modificada unilateralmente.
En el caso en que el Cliente acuerde con el Banco que utilizará el esquema de encripción,
deberá enviar y recibir todos los archivos en forma encriptada. Para poder recibir o enviar
archivos no encriptados, el cliente deberá comunicar la decisión al Banco previamente al envío.
El módulo RSABC es la solución propuesta por el Banco para la encripción de archivos tanto en
el cliente como en el servidor. Este módulo trabaja con la encripción RSA PCKS1 (en los casos
en que se requiera trabajar con RSA) y 3DES ECB/PKCS5Padding para la encripción de
archivos.
4.1 Preparación de archivos y tags para enviar al Banco

4.1.1 Armado del MD5 del archivo plano
Lo primero que se debe hacer para preparar un envío es obtener el MD5 del archivo plano a
enviar, el cual se debe encriptar luego con la clave privada del cliente. El siguiente código
muestra como la librería RSABC obtiene el MD5 del archivo:
RSABC.obtenerMD5("c:\envio.txt");
Luego, se debe realizar la encripción de la firma mediante la siguiente interfaz:
RSABC.procesarStringPriv( true, "cliente.p12", "password", md5);
El fragmento de código que se empleará será entonces el siguiente:
...
String str = RSABC.procesarStringPriv(true,
"C:\cliente.P12",
password",
RSABC.obtenerMD5("C:\envio.txt"));
...
El resultado se ubicará en el tag <firmaArchivo>, indicando al Banco de que cliente proviene el

archivo.
6
El paso siguiente es la compactación del archivo mediante el algoritmo de ZIP. Esta encripción
se realiza mediante librerías standard.
4.1.2 Encripción del archivo a enviar al Banco
Luego de la compactación se requiere la encripción del archivo. Dicha encripción se debe

realizar si la empresa ha optado por este modo de operación. Cabe destacar que usar este modo
de envío también implica que los archivos recibidos por el Cliente también se encontrarán
encriptados (es necesario el paso inverso para ver su contenido).
Para encriptar archivos, el algoritmo elegido es el 3DES. Para realizar la encripción de un

archivo con 3DES, se puede seguir el siguiente ejemplo que emplea la librería RSABC:
...
//Generación de la clave
Provider p = new org.bouncycastle.jce.provider.BouncyCastleProvider();
byte[] key = new byte[24];
Random r = new Random();
r.nextBytes(key);
SecretKey secKey = new SecretKeySpec(key, "DESede");
TripleDES t = new TripleDES();
t.encriptar( "C:\\archivo.zip", "c:\\archivo.3des", secKey, true);
...
4.1.3 Preparado de la clave 3Des para enviar al Banco
La clave generada en el paso anterior deberá ser encriptada con la clave pública del Banco y
colocada en el tag <clave3Des> (ver XML de envío de archivo). Los pasos para preparar la clave
de manera que pueda ser colocada en el tag mencionado se pueden observar en el siguiente
código:
7
...
String sKey = new String(key);
Base64 b64 = new Base64();
String claveB64 = b64.encode(key);
RSABC.procesarStringPubCert(true, "c:\BancoRio.cer", claveB64);
...
4.1.4 Preparado del TAG de firmantes

El último paso es el armado de la firma de los firmantes. Esta identificará unívocamente a los
firmantes que fueron enviados por el cliente. Para ello, lo primero que se necesita es obtener el
MD5 del string de firmantes. Esto se realiza mediante la siguiente interfaz:
public static String obtenerMD5String(String cadena)
Donde cadena es la concatenación de los campos de los firmantes. Si se quieren enviar por
ejemplo los DNIs 23485674, 22487556 y 21693485 el valor de la cadena sobre la que se debe
hacer el MD5 debe ser:
<tpoDoc>N</tpoDoc><nroDoc>23485674</nroDoc><tpoDoc>N</tpoDoc><nroDoc>22487556</
nroDoc><tpoDoc>N</tpoDoc><nroDoc>21693485</nroDoc>
Luego se debe encriptar el digesto con la clave privada del cliente, de la misma forma que se ha
encriptado el MD5 del archivo. El siguiente código muestra el proceso completo:
...
firmantes = "<tpoDoc>N</tpoDoc><nroDoc>23485674</nroDoc>
<tpoDoc>N</tpoDoc><nroDoc>22487556</nroDoc><tpoDoc>N</tpoDoc>
<nroDoc>21693485</nroDoc>";
String str = RSABC.procesarStringPriv(true,

"C:\cliente.P12",
"password",
RSABC.obtenerMD5String(firmantes));
...
En caso de que no se hayan enviado firmantes, es necesario indicar el hecho al Banco, por lo
que el string que se debe emplear es:
<tpoDoc></tpoDoc><nroDoc></nroDoc><tpoDoc></tpoDoc><nroDoc></nroDoc><tpoDoc></t
poDoc><nroDoc></nroDoc><tpoDoc></tpoDoc><nroDoc></nroDoc><tpoDoc></tpoDoc><nroD
oc></nroDoc>
Finalmente el resultado debe ser ubicado en el tag <firmaFirmantes> del XML de envío.
8
4.2 Obtención de archivos desde el Banco

Tal como se menciona anteriormente, una empresa que ha decidido enviar archivos de manera
encriptada, también los recibirá así. Existen dos pasos principales que debe seguir una empresa
para poder trabajar con el contenido de los archivos bajados de los sistemas del Banco:
 Desencripción del archivo.
 Obtención y verificación de la firma del archivo
4.2.1 Desencripción del archivo
Para desencriptar el archivo, lo primero que se debe hacer es obtener la clave 3Des. Dicha clave
se encuentra en el tag <clave3Des>, encriptada con la clave pública del cliente. Para
desencriptarla, es necesario realizar el paso inverso al hecho en la sección anterior. Esto se
puede ver en el siguiente código:
...
String str = RSABC.procesarStringPriv (false,
"C:\certificado.P12",
"password",
Clave3DES);
Base64 b64 = new Base64();
byte[] key = b64.decode(key);
...
Luego es necesario emplear el método de desencripción de 3Des, de la siguiente manera para

obtener el contenido del archivo:
...
SecretKey secKey = new SecretKeySpec(key, "DESede");
TripleDES t = new TripleDES();
t.encriptar( "C:\\archivo.zip", "C:\\archivo.3des", secKey, false);
...
Quedando el contenido final en archivo.zip.
4.2.2 Obtención y verificación de la firma del archivo
La firma del archivo viene encriptada con la clave privada del Banco. Por consiguiente, es
necesario desencriptarla con la clave pública del Banco. Esto se puede ver en el siguiente
ejemplo:
9
...
RSABC.procesarStringPubCert(false, "Banco.cer", firma);
...
El resultado obtenido es un MD5, el cual representa el digesto del archivo plano. Para corroborar
que el mismo corresponde al archivo enviado por el Banco, es necesario descompactar el
archivo recibido (luego de desencriptado si corresponde) y obtener el digesto MD5 del mismo
(mediante la función obtenerMD5 mostrada en el caso de la preparación para el envío).
4.2.3 Resumen de los pasos para enviar y recibir un archivo

Los pasos a seguir para preparar el archivo para enviar son:
 Obtener el MD5 del archivo plano y encriptarlo con la clave privada del cliente. Esa cadena
debe ser ubicada en el tag <firmaArchivo>.
 Comprimir el archivo utilizando la librería standard ZIP de Java.
 Generar la clave de 3DES, en caso que la empresa decida operar encriptando.
 Encriptar el archivo comprimido con la clave 3DES generada en el paso anterior.
 Enviar la clave en el tag <clave3Des>, firmada con la clave pública del Banco (obtenida de
su certificado .cer).
 Armar la firma de firmantes, obteniendo el MD5 de la concatenación de sus campos. Una
vez realizada esta operación, la cadena obtenida es introducida en el tag <firmantes>.
Cuando se recibe el archivo, los pasos son los siguientes:
 Obtener la clave del tag <clave3Des>

 Desencriptar la clave 3DES con la clave privada del cliente.
 Desencriptar el archivo con la clave obtenida en el paso anterior.
 Desencriptar la firma del archivo (tag <firmaArchivo>) con la clave pública del Banco.
 Hacer un MD5 del archivo plano (luego de descomprimirlo) y compararlo con la firma
obtenida en el paso anterior.
10
5 Cobranza Interactiva y Pagos

Los módulos de Cobros y Pagos se dividen en varios productos, cada uno de los cuales puede
hacer uso de las funciones disponibles en el web service.
Cada función presenta su propia interfaz hacia el servidor (representada por un XML) que cuenta
con una parte general a todas las funciones y una particular para cada una de ellas.
A continuación se detalla la parte común del XML:
Parámetros de Entrada
Campo Oblig. Form. Descripción
moduloRioserv SI Char Indica el módulo en el cual se quiere realizar la
operación.
codproducto SI Num(3) Indica el código de producto empleado
instancia SI Num(2) Indica el número de instancia de producto.
funcion SI Num(1) Indica la funcionalidad a invocar.
marEmpresa Si Num (1) Dígito desempatador de la Empresa (Generalmente es
Cero, pero consultar el dato al Banco).
cuit SI Num(11) Indica el CUIT de la Empresa.
Valores del tag moduloRioserv

Código Descripción
001 Publicación de Deuda
002 Envío de Pagos
5.1 Productos y Funciones

Los productos disponibles junto con el código que los identifica se muestran en la siguiente tabla:
Descripción Producto Código de Producto

Cobranza Interactiva 001
Cobranza Electrónica Plus 004
Pago a Proveedores 010
Pago de Haberes 011
Pagos Personalizados 012
Pago de Honorarios 013
Pago de Haberes Previsionales 015
Pago de Seguros 016
11
Las funciones disponibles para cada uno de los productos enunciados en la tabla anterior, se
muestran a continuación:
Cobranza Interactiva
1 Importación de archivo de publicación de deuda.
2 Exportación de archivos de rechazos de deuda.
3 Exportación de archivos de rendición de Cobranzas.
4 Consulta del estado de un envío de deuda.
5 Consulta de archivos de rechazos de deuda.
6 Consulta de archivos de rendición de deuda por rango de fechas.
7 Publicación de deuda ONLINE
8 Solicitud de generación de rendición de información adicional IA4
9 Consulta de Cobros ONLINE
Envío de Pagos
1 Importación de un archivo de pagos.
2 Exportación de archivos de pagos.
3 Consulta de estado de un envío de pagos.
4 Consulta de archivos de rechazo de pagos.
5 Consulta de archivos de rendición de pagos por rango de fechas.
Para aquellas funciones que requieran los tags de firmantes, el tipo de documento puede tener
alguno de los siguientes valores:
Tipos de Documento
N DNI
C LIBRETA CIVICA
E LIBRETA DE ENROLAMIENTO
I CEDULA DE IDENTIDAD
M CEDULA MILITAR
P PASAPORTE
T CUIT
L CUIL
D CDI
X DNI EXTRANJERO
F CERTIFICADO INTERNACIONAL
5.2 Funciones para el modulo de Deuda

5.2.1 Función 1: Importación de archivo de publicación de deuda.
El proceso de Importación consiste en el envío de un archivo desde el Cliente hasta los sistemas
del Banco. Para ello el Cliente generará desde sus sistemas de gestión (ERP o similares) un
archivo basado en el diseño de registro propio del banco (FUR).
12
El archivo a transmitir debe estar previamente compactado (Zip) y puede estar opcionalmente
encriptado (3DES). Asimismo, no puede contener más de un envío.
 Parámetros de entrada:
El Web Service deberá recibir un XML que contará con los siguientes tags 1:
moduloRioserv SI Char Debe ser igual a ‘001’ para Cobranzas
funcion SI Num(1) Debe ser igual a 1.
marEmpresa Si Num (1) Dígito desempatador de la Empresa (Generalmente es

Cero, pero consultar el dato al Banco)..
nroEnvio SI Num(5) Indica el número de envío.
Firmantes (repetición de 5 ocurrencias)
tpoDoc SI Char(1) Tipo de documento del firmante I (CI), N (DNI), C (LC),

E (LE), P (PAS), X (Documento Extranjero) T (CUIT)
nroDoc SI Num(11) Numero de documento del firmante
Fin de campo repetitivo de firmantes
firmaFirmante SI Char MD5 de String de Firmantes (aunque no se hayan

informado), encriptado con la clave privada del cliente.
(long string 512)
firmaArchivo SI Char MD5 encriptado con clave privada del cliente del archivo
plano (long string 512)
archivo SI Archivo Archivo adjuntado con el envío de deuda.
Clave3des NO Char Clave 3DES con la que fue encriptada el archivo, encriptada
con la clave pública del Banco.
(long string 512)
Campos exclusivos de Publicación de Deuda
cant_reg SI Numérico Indica la cantidad de registros que tiene la publicación.
ult_rendic Si Numérico Ultima rendición procesada.
importevto1 Si Numérico Importe total del primer vencimiento.
1 En caso de no emplear el cliente provisto por el Banco, el tag archivo se debe enviar vacío. El
resto de los tags y la obligatoriedad de los mismos se mantiene idéntica.
13
Para la parte decimal se utiliza punto (.) como separador de

decimales.
importevto2 Si Numérico Importe total del segundo vencimiento. Para la parte

decimal se utiliza punto (.) como separador de decimales.
cantFactElect No Numérico Cantidad de facturas electrónicas del lote
puntoVtaFeDesde No Numérico Punto de Venta desde del lote
nroDocFeDesde No Numérico Número de Factura desde del lote
tipoCompFeDesde No Char Tipo de Comprobante desde del lote
puntoVtaFeHasta No Numérico Punto de Venta hasta del lote
nroDocFeHasta No Numérico Número de Factura hasta del lote
tipoCompFeHasta No Char Tipo de Comprobante hasta del lote
 Parámetros de salida:
Parámetros de Salida
status SI Num(1) Status del mensaje (error/warning/OK)
código SI Num(2) Indica el código de retorno del procesador.
descripción SI Char Descripción del código devuelto.
Donde Status puede ser:
Códigos de Tipo de Respuesta del Servidor

0 OK
1 Error
2 Warning
Y algunos de los códigos pueden ser:
Respuestas del Servidor

Cód. Tipo Descripción
<descripcion>Ha habido un error en la escritura
<codigo>0</codigo> <status>1</status> del buffer a disco.</descripcion>
<descripcion>La escritura del buffer a disco ha
<codigo>1</codigo> <status>0</status> sido exitosa.</descripcion>
<descripcion>El usuario esta
<codigo>2</codigo> <status>0</status> autorizado.</descripcion>
<descripcion>El archivo ha sido informado como
<codigo>3</codigo> <status>1</status> de 0 bytes de tamano.</descripcion>
<descripcion>El archivo que se quiere subir
supera el tamano permitido por el
<codigo>4</codigo> <status>1</status> sistema.</descripcion>
14

<descripcion> -= FIN DE TRANSMISION DEL
<codigo>5</codigo> <status>0</status> ARCHIVO DESDE EL CLIENTE. CONSULTE SU
ESTADO EN UNOS MINUTOS =- </descripcion>
<descripcion>Ha habido un problema en la
<codigo>6</codigo> <status>1</status>
creacion del archivo temporal.</descripcion>
<descripcion>El archivo temporal se ha creado
satisfactoriamente.</descripcion>
<descripcion>El archivo se ha obtenido
exitosamente del CORE.</descripcion>
<codigo>9</codigo> <status>1</status> devolucion del archivo desde el servidor del
banco.</descripcion>
<descripcion>El fragmento de archivo ha sido
obtenido exitosamente.</descripcion>
<descripcion> -= FIN DE TRANSMISION DEL
ARCHIVO AL CLIENTE =- </descripcion>
<descripcion> -= COMIENZO DE TRANSMISION
DEL ARCHIVO AL CLIENTE =- </descripcion>
<descripcion> -= COMIENZO DE TRANSMISION
<codigo>13</codigo> <status>0</status> DEL ARCHIVO DESDE CLIENTE =-
</descripcion>
<descripcion>El codigo de producto es
inexistente.</descripcion>
<descripcion>El XML se encuentra
corrupto.</descripcion>
<descripcion>La carpeta especificada para
<codigo>16</codigo> <status>1</status> donwload de archivos no ha sido
creada.</descripcion>
<descripcion>Hubo un problema en la obtencion
del estado del envio.</descripcion>
<descripcion>El estado del envio ha sido obtenido
<descripcion>El listado de archivos de rechazo ha
sido obtenido satisfactoriamente.</descripcion>
<descripcion>No se han encontrado archivos de
<codigo>20</codigo> <status>0</status> rechazo para el numero de envio
indicado.</descripcion>
Error por archivo no encontrado de Rendicion o
rechazo. Dos descripciones posibles:

rechazo para el numero de envio
indicado.</descripcion>

rendiciones para el rango de fechas y el tipo de
rendicion indicado.</descripcion>
15

<descripcion>El listado de archivos de
<codigo>21</codigo> <status>0</status> rendiciones ha sido obtenido
<codigo>22</codigo> <status>0</status> rendiciones para el rango de fechas y el tipo de
rendicion indicado.</descripcion>
<descripcion>Ha habido un problema con las
fechas indicadas. Verifique que ninguna sea nula
y que la fecha hasta sea mayor a la fecha
desde.</descripcion>
<descripcion>El CUIT no corresponde a una
empresa que tenga Servicio Web o la empresa no
esta autorizada a operar con el Producto
informado.</descripcion>
<descripcion>El codigo de producto es
invalido.</descripcion>
<descripcion>Los firmantes informados no han
sido reconocidos.</descripcion>
<descripcion>El codigo de funcion es
<descripcion>Se recibio un pedido de listado de
archivos de rechazo.</descripcion>
<descripcion>El listado de archivos de rechazo
<codigo>29</codigo> <status>0</status> fue enviado exitosamente al
cliente.</descripcion>
archivos de rendiciones.</descripcion>
<descripcion>El listado de archivos de
<codigo>31</codigo> <status>0</status> rendiciones fue enviado exitosamente al
<descripcion>Se recibio un pedido de publicacion
de archivo de deuda.</descripcion>
<descripcion>Se comenzo el procesamiento off-
line de la publicacion de deuda.</descripcion>
<codigo>34</codigo> <status>0</status> <descripcion>Validando empresa...</descripcion>
<descripcion>Validando
firmantes...</descripcion>
<descripcion>Validando firma de
firmantes...</descripcion>
<descripcion>El envio tiene el numero de
secuencia correcto.</descripcion>
<descripcion>El nro. de envio debe ser mayor a
uno informado.</descripcion>
<descripcion>Validando el numero de
envio...</descripcion>
<descripcion>El archivo se recibio correctamente.
<codigo>40</codigo> <status>2</status> ATENCION: Algunos de los firmantes indicados
no fueron reconocidos.</descripcion>
<descripcion>Se recibio un pedido de consulta de
estados.</descripcion>
16

<descripcion>Se recibio un pedido de download
de archivo de rechazos.</descripcion>
<descripcion>Se recibio un pedido de download
de archivo de rendiciones.</descripcion>
<descripcion>Ha habido un error en las
<codigo>45</codigo> <status>1</status> comunicaciones. Por favor reintente mas
tarde.</descripcion>
<descripcion>El XML empleado tiene problemas
<codigo>46</codigo> <status>1</status> de formato o no corresponde al standard
empleado.</descripcion>
<descripcion>El archivo a publicar no ha sido
encontrado en la ruta especificada.</descripcion>
<descripcion>Faltan datos de entrada
<codigo>48</codigo> <status>1</status> obligatorios. Por favor revise el XML
parametro.</descripcion>
<descripcion>Los datos de entrada obligatorios
<codigo>49</codigo> <status>0</status> han sido satisfactoriamente
chequeados.</descripcion>
<descripcion>El usuario ha sido validado
exitosamente.</descripcion>
<descripcion>El usuario no se encuentra
autorizado a operar con Web Services de Online
Banking Cash Management o no pertence a la
Empresa informada.</descripcion>
<codigo>52</codigo> <status>0</status> <descripcion>Validando Usuario...</descripcion>
<descripcion>ERROR consultando la informacion
con los datos del usuario.</descripcion>
<descripcion>El valor del campo "ultima rendicion
procesada" es incorrecto.</descripcion>
<descripcion>El valor del campo "cantidad de
registros" es incorrecto.</descripcion>
<descripcion>El valor del campo de archivo del
XML es nulo.</descripcion>
<descripcion>El valor del campo de directorio de
download es nulo.</descripcion>
<descripcion>El valor del campo "numero de
envio" es incorrecto.</descripcion>
<descripcion>El valor de uno de los rangos de
fecha es nulo.</descripcion>
<descripcion>El codigo de tipo de rendicion
especificado no es correcto.</descripcion>
<descripcion>El digito verificador debe ser
0.</descripcion>
<descripcion>Los importes al vencimiento deben
ser mayores que 0.</descripcion>
17

<descripcion>El formato de los importes al
<codigo>64</codigo> <status>1</status> vencimiento es incorrecto
(+99999999999.99).</descripcion>
<descripcion>El valor especificado para
"instancia" no es correcto.</descripcion>
<descripcion>La firma de los firmantes, no
<codigo>66</codigo> <status>1</status> coincide con los documentos
especificados.</descripcion>
ATENCION: La firma de los firmantes es
incorrecta para los documentos indicados. Los
firmantes no fueron considerados.</descripcion>
<descripcion>El codigo de Modulo es
<descripcion>Se ha recibido un pedido de
exportacion de archivo del banco.</descripcion>
<descripcion>La firma del archivo recibido desde
el cliente no pudo ser validada.</descripcion>
<descripcion>El archivo enviado al banco no pudo
ser importado.</descripcion>
<descripcion>No se ha podido encontrar el envio
pedido.</descripcion>
<descripcion>El Archivo ha sido transmitido
exitosamente al cliente.</descripcion>
<descripcion>No se encontraron archivos de
<codigo>74</codigo> <status>2</status> rechazos para la fecha y numero de envio
indicados.</descripcion>
<descripcion>En este momento la informacion
<codigo>75</codigo> <status>2</status> requerida no se encuentra disponible. Por favor
reintente mas tarde.</descripcion>
<descripcion>El directorio de download es
<codigo>76</codigo> <status>1</status> inexistente. Por favor verifique la
ruta</descripcion>
<descripcion>El archivo pedido no ha podido ser
<codigo>77</codigo> <status>1</status> encontrado. Por favor verifique que el nombre sea
correcto.</descripcion>
<descripcion>La fecha desde no puede ser mayor
que la fecha hasta.</descripcion>
rendiciones.</descripcion>
informacion adicional.</descripcion>
<descripcion>El archivo a importar no se ha
<codigo>81</codigo> <status>1</status> podido ubicar en la ruta
especificada.</descripcion>
<descripcion>El archivo ha sido informado como
de 0 bytes de tamano.</descripcion>
creacion del archivo en el servidor.</descripcion>
ATENCION: Algunos de los firmantes indicados
18

no fueron reconocidos.</descripcion>

ATENCION: La firma de los firmantes es
incorrecta para los documentos indicados. Los
firmantes no fueron considerados.</descripcion>
<descripcion>Se recibio un pedido de importacion
de archivo de pagos.</descripcion>
<descripcion>Los firmantes no han sido
<codigo>87</codigo> <status>1</status> reconocidos. La publicacion de los documentos
NO se ha realizado.</descripcion>
<descripcion>Ha ocurrido un problema con la
publicacion de los documentos.</descripcion>
<descripcion>Los documentos no hubieran
<codigo>89</codigo> <status>1</status> quedado aprobados, por lo que NO se han
procesado.</descripcion>
<descripcion>En este momento no se puede
<codigo>90</codigo> <status>1</status> atender el pedido. Por favor reintente mas
tarde.</descripcion>
<descripcion>Hubo un problema en la
desencripcion de los documentos.</descripcion>
<descripcion>La publicacion se ha efectuado
<codigo>92</codigo> <status>0</status> exitosamente. No se han registrado
rechazos.</descripcion>
<descripcion>Ha habido un problema con el
<codigo>93</codigo> <status>1</status> pedido de generacion de archivo de informacion
adicional.</descripcion>
<descripcion>El pedido de generacion de archivo
<codigo>94</codigo> <status>0</status> de informacion adicional ha sido realizado
exitosamente.</descripcion>
cobros.</descripcion>
<descripcion>El listado de cobros ha sido
obtenido satisfactoriamente.</descripcion>
<codigo>97</codigo> <status>1</status> <descripcion>Error de Backend.</descripcion>
<descripcion>Problemas en el proceso de
encriptacion.</descripcion>
<descripcion>Hubo un problema en el proceso de
firma digital.</descripcion>
<descripcion>Fecha Desde y Hasta deben ser
iguales.</descripcion>
<descripcion>Hora Desde y Hasta solo podran
informarse para fecha del dia.</descripcion>
<descripcion>Hubo un problema en el proceso de
codificacion.</descripcion>
<descripcion>Hora Desde debe ser menor a Hora
Hasta.</descripcion>
<descripcion>No coinciden los datos enviados
<codigo>115</codigo> <status>1</status> con la firma Digital almacenada en el tag
firma_documentos.</descripcion>
19

<descripcion>Existen datos de documentos, que
<codigo>116</codigo> <status>1</status> no cumplen con el schema de XML del producto
publicacion de deuda.</descripcion>
<descripcion>Hubo documentos no publicados
.</descripcion>
<descripcion>Empresa encripta pero el cliente
esta configurado para no encriptar.</descripcion>
<descripcion>Empresa no encripta pero el cliente
esta configurado para encriptar.</descripcion>
<descripcion>Importe total no coincide con la
<codigo>120</codigo> <status>1</status> suma de los importes del primer vencimiento de
los documentos a publicar.</descripcion>
<descripcion>Empresa no encripta pero
<codigo>121</codigo> <status>1</status> desencripcion_automatica es
'True'.</descripcion>
<codigo>122</codigo> <status>1</status> <descripcion>Firma Digital invalida.</descripcion>
<descripcion>Para realizar esta operacion, fecha
<codigo>123</codigo> <status>1</status> desde y fecha hasta deben ser iguales a la fecha
del dia.</descripcion>
<descripcion>Los datos indicados en el certificado
no corresponden a una empresa habilitada para
utilizar Web Services. Por favor contactese al
4341-3042.</descripcion>
<descripcion>Error con el esquema de seguridad
de la empresa. Por favor comuniquese con su
oficial de empresas o con nuestro soporte tecnico
llamando al (011) 4341-3042.</descripcion>
<descripcion>No se encontraron datos para la
busqueda realizada.</descripcion>
<descripcion>La fecha desde no debe superar los
60 dias anteriores al dia de hoy.</descripcion>
<descripcion>El archivo enviado al banco no pudo
ser importado porque se supero el limite de
publicaciones diarias. Contactese con el Soporte
Tecnico del banco.</descripcion>
 XML de entrada:


<pedido>
<moduloRioserv>001</moduloRioserv>
<funcion>1</funcion>
<codproducto>001</codproducto>
<instancia>01</instancia>
<marEmpresa>0</marEmpresa>
<cuit>30504077078</cuit>
<nroEnvio>99048</nroEnvio>
<importevto1>0001900</importevto1>
20
<cant_reg>0000014</cant_reg>
<ult_rendic>99047</ult_rendic>
<archivo>D:/ArchivoEncriptado.3des</archivo>
<firmaArchivo>
9777f3e2623e73faac7b34f21c2354ef2b528cfe
...
</firmaArchivo>
<firmaFirmante>
2d40c81bfaa5e2421b18cad0e34355a0dd6aa0
...
</firmaFirmante>
<firmantes>
<tpoDoc>N</tpoDoc>
<nroDoc>12345678</nroDoc>
...
</firmantes>
<clave3Des>
48e102f7595d836854a35bb657b0c118c4e614fbe106c16319f
...
</clave3Des>
</pedido>


<pedido>
<cuit>30504077078</cuit>
<cant_reg>0000014</cant_reg>
<cantFactElect>78</cantFactElect>
<puntoVtaFeDesde>86</puntoVtaFeDesde>
<nroDocFeDesde>35454</nroDocFeDesde>
<tipoCompFeDesde>NC</tipoCompFeDesde>
<puntoVtaFeHasta>87</puntoVtaFeHasta>
<nroDocFeHasta>78214</nroDocFeHasta>
<tipoCompFeHasta>ND</tipoCompFeHasta>
<archivo>D:/ArchivoEncriptado.3des</archivo>
<firmaArchivo>
9777f3e2623e73faac7b34f21c2354ef2b528cfe
...
</firmaArchivo>
<firmaFirmante>
2d40c81bfaa5e2421b18cad0e34355a0dd6aa0
...
</firmaFirmante>
<firmantes>
<tpoDoc>N</tpoDoc>
...
</firmantes>
<clave3Des>
48e102f7595d836854a35bb657b0c118c4e614fbe106c16319f
...
</clave3Des>
</pedido>
21
 XML de salida:
La respuesta obtenida desde el Servidor contendrá los siguientes elementos:
<respuesta>
<código>5</código>
<descripcion>
-= FIN DE TRANSMISION DEL ARCHIVO DESDE EL CLIENTE =-
</descripcion>
<status>0</status>
</respuesta>
5.2.2 Función 2: Exportación de archivos de rechazos de deuda

El proceso de exportación de un archivo consiste en la copia de un archivo desde los sistemas
del Banco a los sistemas del Cliente.
moduloRioserv SI Char Debe ser igual a 001.

marEmpresa SI Num(1) Indica el dígito desempatador de la Empresa (Generalmente es
archivo SI Char Nombre del archivo que se desea bajar.
directorioDownload SI Char Indica el directorio donde se bajará el archivo pedido.
22
Descripción SI Char(2) Descripción del código devuelto.
Status SI Char Indica si la devolución es error/warning/ok
Archivo SI Archivo Archivo Pedido
firmaArchivo Si Char Firma del Archivo Pedido.
claveTripleDes No Char Clave 3DES del archivo si este se encuentra encriptado
 XML de entrada:
<pedido>
<cuit>30700005573</cuit>
<archivo>R307000055730010022006051700002162424.txt</archivo>
<directorioDownload>C:\usuario\</directorioDownload>
</pedido>
 XML de salida:
<respuesta>
<descripcion>El Archivo ha sido transmitido exitosamente al
<status>0</status>
<firmaArchivo>62...17e31cbe29c129964</firmaArchivo>
<claveTripleDes>0963....733da390b78c</claveTripleDes>
<archivo>3ykxlLUfds...fd4Y4iwa2XGO4=</archivo>
</respuesta>
5.2.3 Función 3: Exportación de archivos de rendición de Cobranzas

23
Codproducto SI Num(3) Indica el código de producto empleado

Instancia SI Num(2) Indica el número de instancia de producto.
Funcion SI Num(1) Debe ser igual a 3.
Cuit SI Num(11) Indica el CUIT de la Empresa.
Archivo SI Char Nombre del archivo que se desea bajar.
Campos exclusivo de Web Service Pagos
tpoArchivo SI Char Indica el tipo de archivo que se va a exportar. Los valores
posibles son RCH, RND, INF.
Campo Obigl. Form. Descripción
descripción SI Char(2) Descripción del código devuelto.
status SI Char Indica si la devolución es error/warning/ok
archivo SI Archivo Archivo Pedido
 XML de entrada:
<pedido>
<cuit>30700005573</cuit>
<archivo>FE30700005573000101-00001-00001-20060510.txt</archivo>
<directorioDownload>C:\usuario\</directorioDownload>
</pedido>
 XML de salida:
<respuesta>
<descripcion>El Archivo ha sido transmitido exitosamente al
<status>0</status>
<firmaArchivo>966...91345ad78d</firmaArchivo>
24
<claveTripleDes>9c8...07d</claveTripleDes>
<archivo>cG6MR2...TbULL7CIkB7vNhvTOU/98g==</archivo>
</respuesta>
5.2.4 Función 4: Consulta de estado de un envío de deuda

La consulta de estado devuelve un código y una descripción de estado, que representa la fase
del procesamiento en la que se encuentra el envío.
marEmpresa Si Num(1) Indica el dígito desempatador de la Empresa (Generalmente es
fechaProceso SI Date(8) Indica la fecha en la que se realizó el envío que se quiere
consultar.
Campo Obl. Form. Descripción
Código SI Num Indica el código de retorno del procesador.
Estado SI Char Código del estado.
descripcionEstado SI Char Descripción del código de estado devuelto.
En el caso de deuda, los estados posibles se pueden ver en la siguiente Tabla:

Publicación de deuda - Códigos de Estado del envío (Instancia Backend)
Tipo de
Código Descripción Estado Mensaje Observaciones
estado
El envío fue recibido por el
0 VALIDADA TRANSITORIO backend del banco y está
listo para ser procesado.
El envío fue validado por el
VALIDACION backend del banco, pero
1 CON TRANSITORIO existen registros rechazados.
RECHAZOS Para consultar y descargar el
archivo de rechazos en
validación deberán ejecutarse
25
Tipo de
estado
las funciones 2 y 5
respectivamente.
El envío fue procesado por
PROCESADA el backend del banco y no
2 FINAL
TOTALMENTE presenta registros
rechazados.
el backend del banco, pero
El estado del contiene algunos registros
rechazados. Para consultar y
18 envío ha sido PROCESADA
3 FINAL descargar el archivo de
obtenido PARCIALMENTE
rechazos en validación
satisfactoriamente deberán ejecutarse las
funciones 2 y 5
respectivamente,
el backend del banco, pero
todos los registros se han
rechazado. Para consultar y
4 RECHAZADA FINAL descargar el archivo de
rechazos en validación
deberán ejecutarse las
funciones 2 y 5
respectivamente.

backend del banco pero sólo
PENDIENTE DE será procesado cuando al
90 TRANSITORIO
APROBACION menos uno o dos apoderados
lo autoricen a través de la
página del banco.
backend del Banco pero
el/los firmante/s informado/s
El estado del en el xml pedido de
envío ha sido publicación de deuda no
PARCIALMENTE
91 TRANSITORIO posee/n la facultad para
18 obtenido FIRMADA
autorizar de forma indistinta
satisfactoriamente el envío. Se requiere la
autorización de un apoderado
más para que el envío sea
procesado.
backend del Banco y los
firmantes informados han
92 AUTORIZADA TRANSITORIO
sido validados correctamente
y tienen la facultad para
autorizar el envío
Mensaje interno del Banco.
PENDIENTE DE El envío fue recibido y está
93 TRANSITORIO
TRANSMISION pendiente de ser transmitido
al backend.
94 PENDIENTE DE TRANSITORIO Mensaje interno del Banco.
26
Tipo de
estado
PROCESO El envío fue recibido y está
pendiente de ser procesado
por el backend del banco.
Mensaje interno del Banco.
El envío fue recibido y ha
95 TRANSMITIDA TRANSITORIO sido transmitido al backend
del banco para ser
procesado.
Publicación de deuda - Códigos de Estado del envío (Instancia WebService)
Tipo de
estado
100 ERROR DE El envío fue recibido por
DESCOMPACTACION el webservice del banco
FINAL
pero no se ha podido
deszipear.
101 ERROR DE El envío fue recibido por
DESENCRIPCION el webservice del banco
pero no se ha podido
FINAL
desencriptar. Verificar lo
El estado del informado en el tag
envío ha sido clave3des
obtenido 102 FIRMA INVALIDA El envío fue recibido por
18
satisfactoriamente el webservice del banco
pero la firma digital es
FINAL
inválida. Verificar lo
informado en el tag
firmaArchivo
Error interno del banco.
El estado del 103 TRANSMISION El envío fue recibido por
envío ha sido INCOMPLETA el webservice del banco
18 obtenido FINAL pero no ha podido ser
satisfactoriamente transmitido al backend.
La empresa deberá volver
a transmitir el envío.
 XML de entrada:


<pedido>
<cuit>30123456781</cuit>
</pedido>
27
 XML de salida:
<respuesta>
<status>0</status><codigo>18</codigo><descripcion>El estado del envio ha sido
obtenido satisfactoriamente.</descripcion><estado>92</estado>
</respuesta>
5.2.5 Función 5: Consulta de archivos de rechazos de deuda.

Este proceso devuelve al cliente un archivo XML con el listado de nombres de archivos de
rechazo.

fechaAlta SI Date(8) Formato AAAAMMDD (solo para obtención de listados de Pagos)
descripcion SI Char Descripción del código devuelto.
Archivo SI Char Nombre del Archivo. Este campo se repite n veces por cada archivo
encontrado.
 XML de entrada:
28
<pedido>
<cuit>30700005573</cuit>
</pedido>
 XML de salida:
<respuesta>
<status>0</status>
<descripcion>El listado de archivos de rechazo ha sido obtenido
<archivo>R307000055730001020705457F20070814-H151126.TXT</archivo>
</respuesta>
5.2.6 Función 6: Consulta de archivos de rendición de deuda por

rango de fechas
rendición o información adicional que se encuentran disponibles para exportar a los sistemas del
Cliente.

tpoRendicion SI Char Indica los tipos de rendiciones posibles a pedir. Los valores
posibles son RND (rendición de Cobranzas y factura electrónica),
INF (información adicional), LIS (listados).
29
fechaDesde SI Num(8) Formato AAAAMMDD
fechaHasta SI Num(8) Formato AAAAMMDD
archivo SI Char Nombre del Archivo. Este campo se repite n veces por cada archivo
encontrado.
 XML de entrada:
<pedido>
<cuit>30700005573</cuit>
<tpoRendicion>RND</tpoRendicion>
<fechaDesde>20000101</fechaDesde>
<fechaHasta>20070504</fechaHasta>
</pedido>
 XML de salida:
<respuesta>
<status>0</status>
<descripcion>El listado de archivos de rendiciones ha sido obtenido
</respuesta>
5.2.7 Función 7: Publicación de Deuda On Line
Esta función permite transmitir el o los documentos de deuda a publicar en forma on-line, que
serán tratados como altas, para ser procesados por el banco.
30
Aclaraciones:
1. Si un cliente envía 10 documentos se informarán las 10 ocurrencias con sus
contenidos; no hará falta que envía las 10 restantes con los tags en blanco o cero.
2. Para los campos no obligatorios, si no existe valor para informar no es necesario
generar el tag correspondiente.
3. En los campos numéricos, si no se utiliza toda la longitud de campo se debe rellenar
con ceros a la izquierda, SALVO en el tag Nro_Doc donde debe informarse
solamente el documento real del firmante sin relleno de ceros a la izquierda.
4. En los campos alfabéticos, usar solamente la longitud de campos necesaria. No es
necesario completar rellenando con espacios en blanco a la derecha dentro del tag.
5. En los importes con decimales, deberá utilizarse punto ( . ) como separador de
decimales.
6. Los tags referentes a Fechas (Fec_1er_vto / Fech_2do_vto / Fech_ hasta_dscto /
Fech_ hasta_ Punit) NO son obligatorios si la empresa NO opera con vencimientos.
Si OPERA con vencimientos (trabado por acuerdo), es OBLIGATORIO informar el
TAG con fechas válidas que se manejen dentro del rango de menores al año 0099
(ej. 01-01-0099) y las mayores al año 9900 (ej. 01-01-9999). Se rechazarán fechas
inválidas (ej. 35-02-2006).
7. Para los tags alfanuméricos: No está soportado enviar caracteres especiales,
principalmente nombres con Apóstrofe y Ampersand.
Nombre Tipo. Obl? Descripción
ModuloRioserv Alf(3) S Debe ser igual a 001.
Funcion Num(1) S Debe ser igual a 7.
Cuit Num(11) S Número de CUIT .
MarEmpresa Num(1) S Valor igual a 0.
Codproducto Num(3) S Nro de producto (valor igual a 001).
Instancia Num(2) S Nro de acuerdo Comercial (Instancia del acuerdo).
Cod_canal Num(3) S Código de Canal (valor igual a 007) .
NroEnvio Num(5) S Número secuencial de deuda publicación.
Ult_rendic Num(5) S Ultima rendición procesada.
Importe_total Num(14+2) S Importe total de los documentos.
Cant_documentos Num(2) S Cantidad de documentos informados.

Tag con las firmas
Firmantes S
Ocurrencias hasta 5 repeticiones

Tipo de documento del firmante de la empresa
Tpo_Doc Alf(1) S
Nro. de documento del firmante de la empresa
Nro_Doc Num(11) S
31
Fin 5 Repeticiones
Firma digital del contenido del tag Firmantes.
FirmaFirmante Alf(512) S
Firma_documentos y firmaFirmante estarán siempre,
independientemente de si encripta o no. Esto es para el
cliente Java y para clientes webservices desarrollados por la
propia empresa. Para el cliente .Net es opcional, si no
existen los genera automáticamente y si existen no los
modifica.
(long string 512)
Datos S Tag con los documentos que se publican
*Si la empresa no encripta enviará los tags detallados a continuación:
Documento Contiene los datos del documento, uno por ocurrencia
Tpo_Oper Alf(1) S Valor ‘A’.
Nro_clte Num(15) S Número de cliente
tpo_cprb Alf(2) S Tipo de comprobante. Valores posibles:
Tipo Descripción
FC Factura
NC Nota de Crédito
ND Nota de Débito
AP Anticipo
PC Pago a Cuenta
OP Orden de Pago
CA Anticipos al Crédito
nro_cprb Alf(15) S Número de comprobante.
nro_cuo Num(4) N Número de cuota.
cod_mone Num(1) S Código de moneda . Valores posibles:

0 Pesos
2 Dólares
nom_clte Alf(30) S Nombre del cliente o razón social.
des_dire Alf(30) S Dirección del cliente.
des_loc Alf (20) S Localidad del cliente.
pref_cpost Alf(1) N Prefijo del código postal.
nro_cpost Num(5) S Número de código postal. . Si se tiene el nro de cod. Postal

de 4 dígitos, rellenar con cero a la izquierda. Ej. 01439
ubic_cpost Alf(3) N Ubicación manzana del código postal.
fec_1er_vto Alf(8) N Fecha de 1er. Vencimiento del comprobante informado

.(AAAAMMDD).
32
El tag NO es obligatorio si la empresa NO opera con

vencimientos, y SI es obligatorio si OPERA con vencimientos
imp_1er_vto Num(15) N Importe a la fecha de 1er vencimiento.

Importante: Tag usado para informar el importe de deuda,
aunque no se opere con vencimientos. En el caso del tipo de
comprobante AP no se envía tag de importe por ser un
documento de adelanto/ Pago a Cuenta
fec_2do_vto Alf(8) N Fecha de 2do. Vencimiento del comprobante informado .

(AAAAMMDD).
imp_2do_vto Num(15+2) N Importe a la fecha de 2do vencimiento.
fec_hasta_dscto Alf(8) N Fecha límite hasta la cual el cliente puede pagar la factura
con el importe de pronto pago. (AAAAMMDD).
imp_pronto_pago Num(15+2) N Importe a fecha de hasta descuento.
fec_hasta_punit Alf(8) N Fecha límite hasta la cual se cobran punitorios.

(AAAAMMDD).
tsa_punit Num(6+2) N Tasa de punitorios.

Indica si la comisión es cobrada a la empresa recaudadora o
mar_excep_3ra Alf(1) S
al depositante. Valores posibles:
“S” Cobra comisión al depositante
“N” Cobra comisión a la empresa
cod_form_pago Alf(10) N Formas de Cobro permitidas para abonar este documento.
Solo se utiliza este campo para restringir las formas de cobro
del cliente.
cui_clte Num(11) S Número de CUIT del Cliente. Se controla en dígito

verificador. Si no tiene este dato, la empresa debe publicar
en este campo su propio cuit.
Código de Ingresos Brutos del cliente. Se debe completar en
ing_brutos Alf(1) N
forma obligatoria para acuerdos que cobran punitorios, o
cuando la comisión se cobra al pagador. Caso contrario no
es necesario informar el tag. Valores posibles:
Tipo Descripción
0 Contribuyente Exento
1 Contribuyente Local
2 Convenio Multilateral
9 No Informado
33
Código de Condición de Iva del Cliente. Se debe completar

cod_cond_iva Alf(1) N
en forma obligatoria para acuerdos que cobran punitorios, o
cuando la comisión se cobra al pagador. Valores posibles:
Tipo Descripción
1 Consumidor Final
2 Responsable Monotributo
3 Responsable exento o no alcanzado
4 Responsable No Inscripto
5 Responsable Inscripto sin Percepción
6 Responsable Inscripto con Percepción
7 Sujeto no Categorizado
cod_concepto Alf(3) N Código de Concepto del Comprobante informado
des_docum Alf(40) N Dato libre informado por la empresa.
obs_lib_1er Alf(18) N Dato libre informado por la empresa.
obs_lib_2da Alf(15) N Dato libre informado por la empresa.
obs_lib_3ra Alf(15) N Dato libre informado por la empresa.
obs_lib_4ta Alf(15) N Dato libre informado por la empresa.
sin_uso_ocurrs Alf(40) N Reservado para usos futuros.
sin_uso Alf(39) N Reservado para usos futuros.
Fin 20 Repeticiones
* Si la empresa encripta enviará el tag detallado a continuación:
documentos_encriptados Resultado del proceso de encriptación sobre el contenido del
tag Datos. Esto es para el cliente Java y para clientes
webservices desarrollados por la propia empresa. Para el
cliente .Net es opcional, si no existe lo genera
automáticamente a partir de los tags <documento> y si existe
no lo modifica.
* Tanto si la empresa encripta como si no encripta firmará el contenido de ‘Datos’
firma_documentos S Firma digital del contenido del tag ‘Datos’.
Firma_documentos y firmaFirmante estarán siempre ,
propia empresa. Para el cliente .Net es obligatorio si existe el
tag documentos_encriptados sino es opcional (si existe el tag
documentos_encriptados entonces no existen los tags
<documento> y el cliente no pude calcular la
firma_documentos), si no existen los genera
automáticamente y si existen no los modifica.
34
 XML de entrada:
Empresa que no encripta:
<pedido>
<modulorioserv>001</modulorioserv>
<cuit>...</cuit>
<marempresa>...</marempresa>
<codproducto>...</codproducto>
<instancia>...</instancia>
<cod_canal>...</cod_canal>
<nro_envio>...</nro_envio>
<ult_rendic>...</ult_rendic>
<importe_total>...</importe_total>
<cant_documentos>...</cant_documentos>
<firmantes>
<tpo_doc>...</tpo_doc>
<nro_doc>...</nro_doc>
...
<tpo_doc>...</tpo_doc>
<nro_doc>...</nro_doc>
</firmantes>
<firma_firmantes>...</firma_firmantes>
<datos>
<documento>
<tpo_oper>...</tpo_oper>
<nro_clte>...</nro_clte>
<tpo_cprb>...</tpo_cprb>
<nro_cprb>...</nro_cprb>
<nro_cuo>...</nro_cuo>
<cod_mone>...</cod_mone>
<nom_clte>...</nom_clte>
<des_dire>...</des_dire>
<des_loc>...</des_loc>
<pref_cpost>...</pref_cpost>
<nro_cpost>...</nro_cpost>
<ubic_cpost>...</ubic_cpost>
<fec_1er_vto>...</fec_1er_vto>
<imp_1er_vto>...</imp_1er_vto>
<fec_2do_vto>...</fec_2do_vto>
<imp_2do_vto>...</imp_2do_vto>
<fec_hasta_dscto>...</fec_hasta_dscto>
<imp_pronto_pago>...</imp_pronto_pago>
<fec_hasta_punit>...</fec_hasta_punit>
<tsa_punit>...</tsa_punit>
<mar_excep_3ra>...</mar_excep_3ra>
<cod_form_pago>...</cod_form_pago>
<cui_clte>...</cui_clte>
<ing_brutos>...</ing_brutos>
<cod_cond_iva>...</cod_cond_iva>
<cod_concepto>...</cod_concepto>
<des_docum>...</des_docum>
<obs_lib_1er>...</obs_lib_1er>
<obs_lib_2da>...</obs_lib_2da>
<obs_lib_3ra>...</obs_lib_3ra>
<obs_lib_4ta>...</obs_lib_4ta>
<sin_uso_ocurrs>...</sin_uso_ocurrs>
<sin_uso>...</sin_uso>
35
</documento>
...
<documento>...</documento>
</datos>
<firma_documentos>...</firma_documentos>
</pedido>
Empresa que encripta:
<pedido>
<cuit>...</cuit>
<marEmpresa>...</marEmpresa>
<nroEnvio>...</nroEnvio>
<firmantes>
<tpoDoc>...</tpoDoc>
<nroDoc>...</nroDoc>
...
</firmantes>
<firmaFirmante>...</firmaFirmante>
<datos>
<documentos_encriptados>...</documentos_encriptados>
</datos>
</pedido>
<pedido>
<cuit>...</cuit>
<nroEnvio>...1</nroEnvio>
<firmantes>
<tpoDoc>N</tpoDoc><nroDoc>...</nroDoc>
</firmantes>
<datos>
<documento>
36
</documento>
...
</datos>
</pedido>
 XML de salida:
El formato de mensaje de respuesta tendrá el siguiente formato:
<respuesta>
<status>[código de Status]</status>
<código>[código de mensaje]</código>
<descripcion>...</descripcion>
</respuesta>
Si no hay errores y se publican todos los documentos:
<respuesta>
<status>0</status>
<descripcion>La publicacion se ha efectuado exitosamente. No se han
registrado rechazos.</descripcion>
</respuesta>
37
Si existiera al menos un documento rechazado, se informará para todos los documentos el

estado del mismo (‘A’ si no hubo errores o ‘R’ en caso contrario) y la descripción del estado
(‘Aceptado’ si el estado es ‘A’ o ‘Rechazado’ si el estado es ‘R’. Además si el estado es ‘R’ se
listarán los errores del documento). Por Ejemplo, se publican dos documentos, uno se acepta y
el otro se rechaza:
<respuesta>
<status>2</status>
<codigo>117</codigo>
<descripcion>Hubo documentos no publicados .</descripcion>
<nro_envio>91446</nro_envio>
<cant_docs_aceptados>01</cant_docs_aceptados>
<cant_docs_rechazados>01</cant_docs_rechazados>
<cant_docs_tratados>02</cant_docs_tratados>
<documento>
<tpo_operacion>A</tpo_operacion>
<nro_cliente>...</nro_cliente>
<tpo_comprobante>FC</tpo_comprobante>
<nro_comprobante>000000000203720</nro_comprobante>
<nro_cuota>0220</nro_cuota>
<estado_documento>
<codigo_estado>A</codigo_estado>
<descripcion_estado>Aceptado</descripcion_estado>
</estado_documento>
</documento>
<documento>
<estado_documento>
<codigo_estado>R</codigo_estado>
<descripcion_estado>Rechazado</descripcion_estado>
<errores>
<cod_error>115</cod_error>
<des_error>ERROR EN DATOS 2DO VENCIMIENTO</des_error>
</errores>
</estado_documento>
</documento>
</respuesta>
5.2.8 Función 8: Pedido de archivo de información adicional IA4
Existe un archivo de información adicional que el Banco Santander Rio sólo genera ante un
pedido explícito del cliente. Luego de la generación, la obtención del mismo se realiza mediante
los pasos detallados en el inciso 5.2.3 - Exportación de Archivos desde Online Cash
Management - WebServices.
38
La función de WS de pedido de generación de IA4 debe recibir un XML desde el cliente con los
siguientes parámetros:

cuit SI Num(11) Indica el CUIT de la empresa.
MarEmpresa Si Num (1) Dígito desempatador de la empresa.
FechaDesde SI Date Debe ser igual al día corriente.
FechaHasta SI Char Debe ser igual al día corriente.

status SI Num Status del mensaje (error/warning/OK)
codigo SI Num Indica el código de retorno del procesador.
 XML de entrada:
De esta manera, el XML para realizar el pedido quedaría como en el siguiente ejemplo:
<?xml version="1.0" encoding="UTF-8"?>

<pedido>
<cuit>30678519681</cuit>
<mar_empresa>0</mar_empresa>
</pedido>
 XML de salida:
Si el pedido de generación no contiene errores, se devuelve un XML con el siguiente formato:
39
<respuesta>
<status>0</status>
<codigo>78</codigo>
<descripcion>El pedido de generacion de archivo de informacion
adicional ha sido realizado exitosamente.</descripcion>
</respuesta>
Si hubiera algún problema con la generación del archivo, el XML devuelto respondería al
siguiente formato:
<respuesta>
<descripcion>Para realizar esta operacion, fecha desde y fecha
hasta deben ser iguales a la fecha del dia.</descripcion>
<status>1</status>
</respuesta>
 Pedido de IA4 sin el cliente provisto:
El XML empleado para realizar el pedido de IA4 es muy similar al usado con el cliente provisto:
<pedidodatos>
<cnusuario>W00000000001</cnusuario>
<pedido xmlns:er="urn:oasis:names:tc:entity:xmlns:xml:catalog"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="C:\cliente\pedidoIA4.xsd">
<cuit>30678519681</cuit>
<mar_empresa>0</mar_empresa>
</pedido>
</pedidodatos>
5.2.9 Función 9: Consulta de Cobros ONLINE
Esta función permitirá consultar los cobros en forma on-line informando el acuerdo, rango de
fechas (inicialmente se consultará de a un día), rango de horas (opcional; podrá informarse solo
para consultas con fecha del día) y el cliente (también opcional). Si se informa el número de
cliente se devolverán todos los cobros originados por el cliente entre las fechas y horas
indicadas. Si no se informa se devolverán todos los cobros recibidos entre las fechas y horas
indicadas, independientemente del cliente que los generó.
En la respuesta a enviar al cliente se aplicará encriptación (si el cliente tiene la marca de

encriptar en el módulo de administración de Online Cash Management se encriptará la
información a enviar empleando un algoritmo Triple DES y la clave utilizada mediante RSA),
40
codificación (luego de encriptado, el contenido del tag ‘Datos’ viajará codificado en base64 para
evitar problemas con ciertos caracteres en la transferencia) y Firma Digital (se obtendrá el hash
mediante MD5 y se lo encriptará con RSA).
La cantidad de cobros a devolver será limitada y por ello el WebService soporta reanudar la
consulta a partir del último cobro devuelto. Si en los parámetros de salida el tag MarcaFinDatos =
‘N’ indica que existen más cobros para devolver y debe ejecutarse nuevamente la consulta,
informando todos los tags de la misma manera que para la primera invocación pero informando
los tags de rellamada de la siguiente forma:
- SigCliente = ProxCliente del xml de salida
- SigFecCobro = ProxFecCobro del xml de salida
- SigHoraCobro = ProxHoraCobro del xml de salida
- SigIdenCobro = ProxIdenCobro del xml de salida
ModuloRioserv SI Char Debe ser igual a 001.
Función SI Num(1) Debe ser igual a 9 .
FechaDesde SI Num(8) Fecha inicial del período de cobros (aaaammdd)
FechaHasta SI Num(8) Fecha final del período de cobros (aaaammdd)
HoraDesde NO Num(12) Hora inicial del período de cobros. Formato hhmmsszzzzzz
(hora, minutos, segundos, milisegundos)
HoraHasta NO Num(12) Hora final del período de cobros . Formato hhmmsszzzzzz (hora,
minutos, segundos, milisegundos)
Cliente NO Char(15) Identificación de Cliente
Acuerdo Datos del Acuerdo
Cuit SI Num(11) Indica el CUIT de la empresa.
MarEmpresa Si Num (2) Dígito desempatador de la empresa. Cada empresa se identifica
por CUIT-Mar_Empresa.
CodProducto SI Num(3) Indica el código de producto empleado
Rellamada Datos de Rellamada: estos tags deberán informarse si de una consulta previa se
tiene en el XML de salida MarcaFindatos = ‘N’. Para completar la consulta la
búsqueda se reanudará a partir de estos datos
SigIdenCobro NO Char(19) Siguiente Identificador de Cobro.
SigFecCobro NO Char(10) Siguiente Fecha de Cobro. Formato aaaa-mm-dd
SigHoraCobro NO Num(12) Siguiente Hora de Cobro
SigCliente NO Char(15) Siguiente Cliente
41
Campo Form. Descripción – Origen
Resultado Resultado del procesamiento
Status Num (2) Status del mensaje (error/warning/OK)
Código Num (3) Indica el código de retorno del procesador.
Descripción Char(80) Descripción del código devuelto.
Si Status = 0 (OK):
Rellamada Datos para la siguiente invocación. Hay más información para devolver y la
consulta se deberá reanudar a partir de estos datos Estos tags se deberán
completar cuando corresponda (*1).
ProxIdenCobro Char(19) Próximo Identificador de Cobro para rellamada.
ProxFecCobro Char(10) Próxima Fecha de Cobro para rellamada.
ProxHoraCobro Num(12) Próxima Hora de Cobro para rellamada
ProxCliente Char(15) Próximo Cliente para rellamada.
MarcaFinDatos Char(1) Valor ‘S’: indica que hay más valores para consultar mediante
rellamada.
Valor ‘N’: no hay más valores que los que se devuelven
FiltrosInput Filtros de búsqueda recibidos
InCuit Num(11) ‘CUIT’ del xml de entrada
InMarEmpresa Num (1) ‘MarEmpresa’ del xml de entrada
InCodproducto Num(3) ‘CodProducto’ del acuerdo del xml de entrada
InInstancia Num(2) ‘Instancia’ del xml de entrada
InFechaDesde Num(8) ‘FechaDesde’ del xml de entrada
InFechaHasta Num(8) ‘FechaHasta’ del xml de entrada
InHoraDesde Num(12) ‘HoraDesde’ del xml de entrada
InHoraHasta Num(12) ‘HoraHasta’ del xml de entrada
InCliente Char(15) ‘Cliente’ del xml de entrada
CantidadCobros Num(6) Cantidad de Cobros
Datos Datos de la consulta (*2)
(*2) si los datos no se encriptan se enviarán los tags detallados a continuación:
Iteraciones1 (según CantidadCobros)
CobroX Datos del Cobro, donde X varia desde 1 hasta CantidadCobros
FechaCobro Num(10) Fecha de Cobro
HoraCobro Num(12) Hora de Cobro
IdCliente Char(15) Código de Cliente
NombreCliente Char(30) Nombre del Cliente
Canal Char(3) Código de canal
SucOrigen Char(3) Sucursal
IdCobro Char(19) Código de cobro
NroBoleta Char(18) Número de Boleta
ImporteTotal Num(12E,2D) Importe total cobrado
Cobrado
ImporteComisión Num(7E,2D) Importe de la comisión
42
EstadoCobro Char(9) Estado del cobro

CantidadDocumentos Num(6) Cantidad de Documentos asociados al Cobro
Iteraciones2 (según CantidadDocumentos)
DocumentoX Datos de los documentos del cobro, donde X varia desde 1 hasta
CantidadDocumentos
TipoDoc Char(2) Tipo de comprobante
NroDoc Char(15) Número de comprobante
NroCuota Char(4) Número de cuota
FechaVtoDoc Char(10) Fecha de vencimiento del documento
ImporteCobrado Num(12E,2D) Importe cobrado
Dato1 Char(18) Primera observación
Dato2 Char(15) Segunda observación
Dato3 Char(15) Tercera observación
ImporteDoc Num(13E,2D) Importe del documento
Fin Iteraciones2
CantidadInstrumentos Num(6) Cantidad Instrumentos asociados al Cobro
Iteraciones3 (según CantidadInstrumentos)
InstrumentoX Datos de los instrumentos del cobro, donde X varia desde 1 hasta
CantidadInstrumentos
NroInstrumento Char(31) Número de instrumento de cobro
FormaPago Num(2) Código de forma de pago
DescFormaPago Char(8) Descripción del código de forma de pago
Moneda Char(8) Moneda
FechaVtoCPD Char(10) Fecha de vencimiento
FechaAcreditación Char(10) Fecha de acreditación
EstadoInstrumento Char(3) Código de estado del instrumento
DescEstInstrumento Char(8) Descripción del código de estado del instrumento
ImporteInstrumento Num(13E,2D) Importe
Fin Iteraciones3
Fin Iteraciones1
(*2) si los datos se encriptan se enviarán los dos tags detallados a continuación:
DatosEncriptados Origen: resultado del proceso de encriptación sobre Datos. Para
el cliente .Net: en el archivo de configuración WSClient.exe.config
existe el tag ‘desencripcion_automatica’, si es ‘true’ el cliente
desencriptará automáticamente el tag ‘DatosEncriptados’; si es
false no lo hará.
Clave3Des Origen: Clave encriptada utilizada para la encriptación de los
datos. Para el cliente .Net: en el archivo de configuración
WSClient.exe.config existe el tag ‘desencripcion_automatica’, si
es ‘true’ este tag no exsitirá.
FirmaDigital Firma digital de los datos
Firma Origen: Firma de los datos. El cliente .Net verificará
automáticamente la firma recibida desde la aplicación. Si no es
correcta devolverá el error ‘Firma Digital Inválida’
43
 XML de entrada:
Sin rellamada:
<pedido>
<cuit>...</cuit>
<fechaDesde>...</fechaDesde>
<fechaHasta>...</fechaHasta>
<horaDesde>...</horaDesde>
<horaHasta>...</horaHasta>
<cliente>...</cliente>
</pedido>
Con rellamada:
<pedido>
<cuit>...</cuit>
<fechaDesde>...</fechaDesde>
<fechaHasta>...</fechaHasta>
<horaDesde>...</horaDesde>
<horaHasta>...</horaHasta>
<cliente>...</cliente>
<SigIdenCobro>...</SigIdenCobro>
<SigFecCobro>...</SigFecCobro>
<SigHoraCobro>...</SigHoraCobro>
<sigCliente>...</sigCliente>
</pedido>
 XML de salida:
De empresa que encripta:
<respuesta>
<código>...</código>
<status>...</status>
<rellamada>
<ProxIdenCobro>...</ProxIdenCobro>
<ProxFecCobro>...</ProxFecCobro>
<ProxHoraCobro>...</ProxHoraCobro>
44
<proxCliente>...</proxCliente>
<marcaFinDatos>...</marcaFinDatos>
</rellamada>
<filtrosInput>
<inCuit>...</inCuit>
<inMarEmpresa>...</inMarEmpresa>
<inCodProducto>...</inCodProducto>
<inInstancia>...</inInstancia>
<inFechaDesde>...</inFechaDesde>
<inFechaHasta>...</inFechaHasta>
<inHoraDesde>...</inHoraDesde>
<inHoraHasta>...</inHoraHasta>
<inCliente>...</inCliente>
</filtrosInput>
<cantidadCobros>...</cantidadCobros>
<datosEncriptados>...</datosEncriptados>
<firma>...</firma>
<claveTripleDes>...</claveTripleDes>
</respuesta>
De empresa que no encripta:
<respuesta>
<código>...</código>
<status>...</status>
<rellamada>
<ProxIdenCobro>...</ProxIdenCobro>
<ProxFecCobro>...</ProxFecCobro>
<ProxHoraCobro>...</ProxHoraCobro>
<proxCliente>...</proxCliente>
<marcaFinDatos>...</marcaFinDatos>
</rellamada>
<filtrosInput>
<inCuit>...</inCuit>
<inMarEmpresa>...</inMarEmpresa>
<inCodProducto>...</inCodProducto>
<inInstancia>...</inInstancia>
<inFechaDesde>...</inFechaDesde>
<inFechaHasta>...</inFechaHasta>
<inHoraDesde>...</inHoraDesde>
<inHoraHasta>...</inHoraHasta>
<inCliente>...</inCliente>
</filtrosInput>
<cantidadCobros>...</cantidadCobros>
<datos>
<cobro1>
<fechaCobro>...</fechaCobro>
<horaCobro>...</horaCobro>
<idCliente>...</idCliente>
<nombreCliente>...</nombreCliente>
<canal>...</canal>
<sucOrigen>...</sucOrigen>
<idCobro>...</idCobro>
<nroBoleta>...</nroBoleta>
<importeTotalCobrado>...</importeTotalCobrado>
45
<importeComision>...</importeComision>
<estadoCobro>...</estadoCobro>
<cantidadDocumentos>...</cantidadDocumentos>
<documento1>
<tipoDoc>...</tipoDoc>
<nroCuota>...</nroCuota>
<fechaVtoDoc>...</fechaVtoDoc>
<importeCobrado>...</importeCobrado>
<dato1>...</dato1>
<dato2>...</dato2>
<dato3>...</dato3>
<importeDoc>...</importeDoc>
</documento1>
<documento2>
...
</documento2>
...
<cantidadInstrumentos>...</cantidadInstrumentos>
<instrumento1>
<nroInstrumento>...</nroInstrumento>
<formaPago>...</formaPago>
<descFormaPago>...</descFormaPago>
<moneda>...</moneda>
<fechaVtoCPD>...</fechaVtoCPD>
<fechaAcreditacion>...</fechaAcreditacion>
<estadoInstrumento>...</estadoInstrumento>
<descEstInstrumento>...</descEstInstrumento>
<importeInstrumento>...</importeInstrumento>
</instrumento1>
...
</cobro1>
<cobro2>
...
</cobro2>
...
</datos>
<firma>...</firma>
</respuesta>
5.2.10 Función 12: Publicación de DEBIN On Line
Esta función permite transmitir el o los documentos de deuda a publicar en forma on-line, que
serán tratados como altas, para ser procesados por el banco.
Aclaraciones:
Si un cliente envía 10 documentos se informarán las 10 ocurrencias con sus
contenidos; no hará falta que envía las 10 restantes con los tags en blanco o cero.
Para los campos no obligatorios, si no existe valor para informar no es necesario
generar el tag correspondiente.
En los campos numéricos, si no se utiliza toda la longitud de campo se debe rellenar
con ceros a la izquierda, SALVO en el tag Nro_Doc donde debe informarse
solamente el documento real del firmante sin relleno de ceros a la izquierda.
En los campos alfabéticos, usar solamente la longitud de campos necesaria. No es
necesario completar rellenando con espacios en blanco a la derecha dentro del tag.
En los importes con decimales, deberá utilizarse punto ( . ) como separador de
decimales.
46
Los tags referentes a Fechas (Fec_1er_vto / Fech_2do_vto / Fech_ hasta_dscto /

Fech_ hasta_ Punit) NO son obligatorios si la empresa NO opera con vencimientos.
Si OPERA con vencimientos (trabado por acuerdo), es OBLIGATORIO informar el
TAG con fechas válidas que se manejen dentro del rango de menores al año 0099
(ej. 01-01-0099) y las mayores al año 9900 (ej. 01-01-9999). Se rechazarán fechas
inválidas (ej. 35-02-2006).
Para los tags alfanuméricos: No está soportado enviar caracteres especiales,
principalmente nombres con Apóstrofe y Ampersand.
Nombre Tipo. Obl? Descripción
ModuloRioserv Alf(3) S Debe ser igual a 001.
Funcion Num(2) S Debe ser igual a 12.
Cuit Num(11) S Número de CUIT .
MarEmpresa Num(1) S Valor igual a 0.
Codproducto Num(3) S Nro de producto (valor igual a 001).
Instancia Num(2) S Nro de acuerdo Comercial (Instancia del acuerdo).
Cod_canal Num(3) S Código de Canal (valor igual a 007) .
NroEnvio Num(5) S Número secuencial de deuda publicación.
Ult_rendic Num(5) S Ultima rendición procesada.
Importe_total Num(14+2) S Importe total de los documentos.
Cant_documentos Num(2) S Cantidad de documentos informados.

Tag con las firmas
Firmantes S

Tipo de documento del firmante de la empresa
Tpo_Doc Alf(1) S
Nro. de documento del firmante de la empresa
Nro_Doc Num(11) S
Fin 5 Repeticiones
Firma digital del contenido del tag Firmantes.
FirmaFirmante Alf(512) S
Firma_documentos y firmaFirmante estarán siempre,
propia empresa. Para el cliente .Net es opcional, si no
existen los genera automáticamente y si existen no los
modifica.
(long string 512)
Datos S Tag con los documentos que se publican
47
*Si la empresa no encripta enviará los tags detallados a continuación:

Documento Contiene los datos del documento, uno por ocurrencia
Tpo_Oper Alf(1) S Valor ‘A’.
Nro_clte Num(15) S Número de cliente
tpo_cprb Alf(2) S Tipo de comprobante. Valores posibles:
Tipo Descripción
FC Factura
NC Nota de Crédito
ND Nota de Débito
AP Anticipo
PC Pago a Cuenta
OP Orden de Pago
CA Anticipos al Crédito
nro_cprb Alf(15) S Número de comprobante.
nro_cuo Num(4) N Número de cuota.
cod_mone Num(1) S Código de moneda . Valores posibles:

0 Pesos
2 Dólares
nom_clte Alf(30) S Nombre del cliente o razón social.
des_dire Alf(30) S Dirección del cliente.
des_loc Alf (20) S Localidad del cliente.
pref_cpost Alf(1) N Prefijo del código postal.
nro_cpost Num(5) S Número de código postal. . Si se tiene el nro de cod. Postal

de 4 dígitos, rellenar con cero a la izquierda. Ej. 01439
ubic_cpost Alf(3) N Ubicación manzana del código postal.
fec_1er_vto Alf(8) N Fecha de 1er. Vencimiento del comprobante informado

.(AAAAMMDD).
El tag NO es obligatorio si la empresa NO opera con
vencimientos, y SI es obligatorio si OPERA con vencimientos
imp_1er_vto Num(15) N Importe a la fecha de 1er vencimiento.

Importante: Tag usado para informar el importe de deuda,
aunque no se opere con vencimientos. En el caso del tipo de
comprobante AP no se envía tag de importe por ser un
documento de adelanto/ Pago a Cuenta
fec_2do_vto Alf(8) N Fecha de 2do. Vencimiento del comprobante informado .

(AAAAMMDD).
48
imp_2do_vto Num(15+2) N Importe a la fecha de 2do vencimiento.
fec_hasta_dscto Alf(8) N Fecha límite hasta la cual el cliente puede pagar la factura
con el importe de pronto pago. (AAAAMMDD).
imp_pronto_pago Num(15+2) N Importe a fecha de hasta descuento.
fec_hasta_punit Alf(8) N Fecha límite hasta la cual se cobran punitorios.

(AAAAMMDD).
tsa_punit Num(6+2) N Tasa de punitorios.

Indica si la comisión es cobrada a la empresa recaudadora o
mar_excep_3ra Alf(1) S
al depositante. Valores posibles:
“S” Cobra comisión al depositante
“N” Cobra comisión a la empresa
cod_form_pago Alf(10) N Formas de Cobro permitidas para abonar este documento.
Solo se utiliza este campo para restringir las formas de cobro
del cliente.
cui_clte Num(11) S Número de CUIT del Cliente/Pagador. Este CUIT debe ser el
del titular de la cuenta a sobre la cual se generará el DEBIN.
Es decir, al del titular de la cuenta referenciada por el campo
cbu_comprador ó alias_comprador
Código de Ingresos Brutos del cliente. Se debe completar en
ing_brutos Alf(1) N
forma obligatoria para acuerdos que cobran punitorios, o
cuando la comisión se cobra al pagador. Caso contrario no
es necesario informar el tag. Valores posibles:
Tipo Descripción
0 Contribuyente Exento
1 Contribuyente Local
2 Convenio Multilateral
9 No Informado
Código de Condición de Iva del Cliente. Se debe completar

cod_cond_iva Alf(1) N
en forma obligatoria para acuerdos que cobran punitorios, o
cuando la comisión se cobra al pagador. Valores posibles:
Tipo Descripción
1 Consumidor Final
2 Responsable Monotributo
3 Responsable exento o no alcanzado
49
4 Responsable No Inscripto
5 Responsable Inscripto sin Percepción
6 Responsable Inscripto con Percepción
7 Sujeto no Categorizado
cod_concepto Alf(3) N Código de Concepto del Comprobante informado
des_docum Alf(40) N Dato libre informado por la empresa.
obs_lib_1er Alf(18) N Dato libre informado por la empresa.
obs_lib_2da Alf(15) N Dato libre informado por la empresa.
obs_lib_3ra Alf(15) N Dato libre informado por la empresa.

Alias de la cuenta Pagadora a la que se le generará el
alias_comprador Alf(20)
DEBIN. Este campo solo debe completarse cuando se quiera
generar un DEBIN a partir de este registro de deuda.
Si se completa el campo DEBIN-CBU Cuenta Comprador
entonces el alias de la cuenta ya no se hace necesario.
CBU de la cuenta Pagadora a la que se le generará el
cbu_comprador Alf(22)
DEBIN. Este campo solo debe completarse cuando se quiera
generar un DEBIN a partir de este registro de deuda.
Este campo CBU tiene prioridad sobre el Alias; si se
completan ambos campos de la cuenta del Comprador, el
Alias será ignorado. Si no se informa ni el Alias ni el CBU, el
DEBIN no podrá darse de alta.
Dato utilizado solo si se quiere generar un DEBIN a partir de
importe_debin Num(15)
este registro de deuda.
En caso el que campo tipo de comprobante sea AP
(Anticipo) o PC (Pago a Cuenta), el campo Importe DEBIN
deberá estar completo, de lo contrario, no se podrá generar
el DEBIN.
Si el campo tipo de comprobante es FC-Factura ó OP-Orden
de Pago, este campo Importe DEBIN es no-requerido (es
decir, puede contener ceros). En este caso, el importe del
DEBIN a generar será tomado del campo 15-Importe al 1er.
Vencimiento del presente registro.
En cambio, si este campo Importe DEBIN tiene un valor
distinto de ceros, el DEBIN se creará con este importe.
Dato utilizado solo si la deuda pública DEBIN.
flg_act_debin Alf(01)
Los valores posibles son “S”, “N” o Blanco. El valor Blanco se
tomará como si fuese informado “N”.
Se debe informar ‘S’ cuando se desee que se actualice el
importe del DEBIN ante un cambio de Fecha de
Vencimiento.
Si este es el caso, este mecanismo ejecutará la baja del
DEBIN generado con el importe del 1er Vencimiento y
generará el alta de un nuevo DEBIN con el importe
correspondiente a la Fecha del Segundo Vencimiento.
hra_expira Alf(04)
50
Valores aceptados entre 0 y 4320. Está expresado en

minutos. Si el campo es informado en 0 se toma como valor
por defecto 4320 minutos (72hs).
recurrencia_debin Alf(01)
Indica si el DEBIN a crear será un Recurrente o un SPOT.
Corresponde a un campo alfanumérico de 1 posición cuyos
valores posibles son “S”, “N” o espacios. El valor espacios
será tomado como “N”.
Para que la marca ‘S’ tenga sentida, la empresa
Recaudadora previamente tuvo que haber generado la
Adhesión de la cuenta Pagadora a su Acuerdo de Servicio
de DEBIN. (Por el momento esta marca no tiene efecto, ya
que el DEBIN generado siempre será Spot)
sin_uso_ocurrs Alf(40) N Reservado para usos futuros.
sin_uso Alf(39) N Reservado para usos futuros.
Fin 20 Repeticiones
* Si la empresa encripta enviará el tag detallado a continuación:
documentos_encriptados Resultado del proceso de encriptación sobre el contenido del
tag Datos. Esto es para el cliente Java y para clientes
webservices desarrollados por la propia empresa. Para el
cliente .Net es opcional, si no existe lo genera
automáticamente a partir de los tags <documento> y si existe
no lo modifica.
* Tanto si la empresa encripta como si no encripta firmará el contenido de ‘Datos’
firma_documentos S Firma digital del contenido del tag ‘Datos’.
Firma_documentos y firmaFirmante estarán siempre ,
propia empresa. Para el cliente .Net es obligatorio si existe el
tag documentos_encriptados sino es opcional (si existe el tag
documentos_encriptados entonces no existen los tags
<documento> y el cliente no pude calcular la
firma_documentos), si no existen los genera
automáticamente y si existen no los modifica.
 XML de entrada:
Empresa que no encripta:
<pedido>
<cuit>30700005573</cuit>
<cod_canal>007</cod_canal>
51
<importe_total>0.05</importe_total>
<cant_documentos>01</cant_documentos>
<firmantes>
<tpoDoc>N</tpoDoc>
<tpoDoc>N</tpoDoc>
</firmantes>
<datos>
<documento>
<tpo_oper>A</tpo_oper>
<nro_clte>000000000000156</nro_clte>
<tpo_cprb>OP</tpo_cprb>
<nro_cprb>111111111111118</nro_cprb>
<cod_mone>0</cod_mone>
<nom_clte>FORD ARGENTINA SCA</nom_clte>
<des_dire>AV HENRY FORD 3295</des_dire>
<des_loc>GRAL PACHECO</des_loc>
<pref_cpost>B</pref_cpost>
<nro_cpost>01617</nro_cpost>
<ubic_cpost>BKK</ubic_cpost>
<fec_1er_vto>20190530</fec_1er_vto>
<imp_1er_vto>0.05</imp_1er_vto>
<fec_hasta_dscto></fec_hasta_dscto>
<imp_pronto_pago>0000000000000.00</imp_pronto_pago>
<fec_hasta_punit></fec_hasta_punit>
<tsa_punit>0000.00</tsa_punit>
<mar_excep_3ra>N</mar_excep_3ra>
<cui_clte>20232433486</cui_clte>
<ing_brutos>0</ing_brutos>
<cod_cond_iva>0</cod_cond_iva>
<cod_concepto>001</cod_concepto>
<des_docum></des_docum>
<obs_lib_1er>CAMPO OBSERV 1</obs_lib_1er>
<obs_lib_2da>CAMPO OBSERV 2</obs_lib_2da>
<obs_lib_3ra>CAMPO OBSERV 3</obs_lib_3ra>
<obs_lib_4ta>CAMPO OBSERV 4</obs_lib_4ta>
<obs_lib_5ta>CAMPO OBSERV 5</obs_lib_5ta>
<ag_Fp_Canal></ag_Fp_Canal>
<alias_comprador></alias_comprador>
<cbu_comprador>0720201088000036369254</cbu_comprador>
<importe_debin>0.05</importe_debin>
<flg_act_debin>N</flg_act_debin>
<recurrencia_debin>N</recurrencia_debin>
<min_expira>4320</min_expira>
<sin_uso_ocurrs></sin_uso_ocurrs>
<FP_Tas>000</FP_Tas>
<sin_uso></sin_uso>
</documento>
</datos>
</pedido>
Empresa que encripta:
<pedido>
<cuit>...</cuit>
52
<nroEnvio>...</nroEnvio>
<firmantes>
...
</firmantes>
<datos>
<documentos_encriptados>...</documentos_encriptados>
</datos>
</pedido>
<pedido>
<cuit>...</cuit>
<nroEnvio>...1</nroEnvio>
<firmantes>
</firmantes>
<datos>
<documento>
53
</documento>
...
</datos>
</pedido>
 XML de salida:
El formato de mensaje de respuesta tendrá el siguiente formato:
<respuesta>
<status>[código de Status]</status>
<código>[código de mensaje]</código>
</respuesta>
Si no hay errores y se publican todos los documentos:
<respuesta>
<status>0</status>
<descripcion>La publicacion se ha efectuado exitosamente. No se han
registrado rechazos.</descripcion>
</respuesta>
Si existiera al menos un documento rechazado, se informará para todos los documentos el

estado del mismo (‘A’ si no hubo errores o ‘R’ en caso contrario) y la descripción del estado
(‘Aceptado’ si el estado es ‘A’ o ‘Rechazado’ si el estado es ‘R’. Además si el estado es ‘R’ se
listarán los errores del documento). Por Ejemplo, se publican dos documentos, uno se acepta y
el otro se rechaza:
<respuesta>
<status>2</status>
<descripcion>Hubo documentos no publicados .</descripcion>
<nro_envio>91446</nro_envio>
<cant_docs_aceptados>01</cant_docs_aceptados>
<cant_docs_rechazados>01</cant_docs_rechazados>
<cant_docs_tratados>02</cant_docs_tratados>
54
<documento>
<estado_documento>
<codigo_estado>A</codigo_estado>
<descripcion_estado>Aceptado</descripcion_estado>
</estado_documento>
</documento>
<documento>
<estado_documento>
<codigo_estado>R</codigo_estado>
<descripcion_estado>Rechazado</descripcion_estado>
<errores>
<cod_error>115</cod_error>
<des_error>ERROR EN DATOS 2DO VENCIMIENTO</des_error>
</errores>
</estado_documento>
</documento>
</respuesta>
5.3 Funciones para el modulo de Pagos

5.3.1 Función 1: Importación de archivo de pagos
El proceso de Importación consiste en el envío de un archivo desde el Cliente hasta los sistemas
del Banco. Para ello el Cliente generará desde sus sistemas de gestión (ERP o similares) un
archivo con el formato APRP.
El archivo a transmitir debe estar previamente compactado (Zip) y puede estar opcionalmente
encriptado (3DES). Asimismo, no puede contener más de un envío.
El Web Service deberá recibir un XML que contará con los siguientes tags 2:
2 En caso de no emplear el cliente provisto por el Banco, el tag archivo se debe enviar vacío. El
resto de los tags y la obligatoriedad de los mismos se mantiene idéntica.
55
marEmpresa Si Num (1) Dígito desempatador de la Empresa.
Firmantes (repetición de 5 ocurrencias)
tpoDoc SI Char(1) Tipo de documento del firmante I (CI), N (DNI), C (LC),

E (LE), P (PAS), X (Documento Extranjero) T (CUIT)
nroDoc SI Num(11) Numero de documento del firmante
Fin de campo repetitivo de firmantes
firmaFirmante SI Char MD5 de String de Firmantes (aunque no se hayan

informado), encriptado con la clave privada del cliente.
(long string 512)
firmaArchivo SI Char MD5 encriptado con clave privada del cliente del archivo
plano. (long string 512)
autoriz_automatica NO Char Opciones: ‘S’ o ‘N’

Autorizar automáticamente el envío.
archivo SI Archivo Archivo adjuntado con el envío de pagos.
Clave3des NO Char Clave 3DES con la que fue encriptada el archivo, encriptada
con la clave pública del Banco.
(long string 512)
status SI Num(1) Status del mensaje (error/warning/OK)
Donde Status puede ser:
Códigos de Tipo de Respuesta del Servidor

56
0 OK
1 Error
2 Warning
Y algunos de los códigos pueden ser:
0 1 Ha habido un error en la escritura del buffer a disco.
5 0 -= FIN DE TRANSMISION DEL ARCHIVO DESDE EL CLIENTE =-
9 1 Ha habido un problema en la devolución del archivo desde el servidor del banco.
17 1 Hubo un problema en la obtención del estado del envío.
18 0 El estado del envío ha sido obtenido satisfactoriamente.
19 0 El listado de archivos de rechazo ha sido obtenido satisfactoriamente.
21 0 El listado de archivos de rendiciones ha sido obtenido satisfactoriamente.
No se han encontrado archivos de rendiciones para el rango de fechas y el tipo de

22 0
rendición indicado.
Ha habido un problema con las fechas indicadas. Verifique que ninguna sea nula y que la
23 1
fecha hasta sea mayor a la fecha desde.
El CUIT no corresponde a una Empresa que tenga Servicio Web o la Empresa no esta
24 1
autorizada a operar con el Producto informado.
70 1 La firma del archivo recibido desde el cliente no pudo ser validada.
71 1 El archivo enviado al banco no pudo ser importado.
72 1 No se ha podido encontrar el envío pedido.
74 2 No se encontraron archivos de rechazos para la fecha y numero de envío indicados.
En este momento la información requerida no se encuentra disponible. Por favor reintente

75 2
mas tarde.
El archivo pedido no ha podido ser encontrado. Por favor verifique que el nombre sea
77 1
correcto.
78 1 La fecha desde no puede ser mayor que la fecha hasta.
79 1 No se encontraron archivos de rendiciones.
80 1 No se encontraron archivos de información adicional.
82 2 El archivo ha sido informado como de 0 bytes de tamaño.
83 1 Ha habido un problema en la creación del archivo en el servidor.
84 1 El archivo se recibió correctamente. ATENCION: Algunos de los firmantes indicados no
57
fueron reconocidos.
El archivo se recibió correctamente. ATENCION: La forma de los firmantes es incorrecta

85 1
para los documentos indicados. Los firmantes no fueron considerados.
La Empresa no se encuentra autorizada a operar con Web Services con el producto

86 1
indicado.
 XML de entrada:
<pedido>
<cuit>30700005573</cuit>
<autoriz_automatica>S</autoriz_automatica>
<archivo>D:/archivo.zip</archivo>
<firmaArchivo>c388d30...cd9f52119</firmaArchivo>
<firmaFirmante>d51e87...47c4c9b63</firmaFirmante>
<firmantes>
<nroDoc></nroDoc>
...
</firmantes>
<clave3Des>35b...b657b0c118c4e614</clave3Des>
</pedido>
 XML de salida:
La respuesta obtenida desde el Servidor contendrá los siguientes elementos:
<respuesta>
<descripcion> -= FIN DE TRANSMISION DEL ARCHIVO DESDE EL CLIENTE.
CONSULTE SU ESTADO EN UNOS MINUTOS =- </descripcion>
<status>0</status>
</respuesta>
5.3.2 Función 2: Exportación de archivos de pagos

58

Archivo SI Char Nombre del archivo que se desea bajar.
Campos exclusivo de Web Service Pagos
tpoArchivo SI Char Indica el tipo de archivo que se va a exportar. Los valores
posibles son RCH, RND, INF.
Campo Obigl. Form. Descripción
Descripción SI Char(2) Descripción del código devuelto.
Archivo SI Archivo Archivo Pedido
 XML de entrada:
<pedido>
<cuit>30700005573</cuit>
<tpoArchivo>RND</tpoArchivo>
<archivo>E3070000557300120100002.txt</archivo>
<directorioDownload>C:\downloads\</directorioDownload>
</pedido>
59
 XML de salida:
<respuesta>
<descripcion>El Archivo ha sido transmitido exitosamente
al cliente.</descripcion>
<status>0</status>
<firmaArchivo>6d2defdfdfafdsqlko...eashfadsde1db</firmaArchivo>
<claveTripleDes>1a40ada8fb71287c..179c59a8e8b0</claveTripleDes>
<archivo>DtCizYJRQHIUZzG1uwAYy4e...TnvqRRNacD7YLAcQ==</archivo>
</respuesta>
5.3.3 Función 3: Consulta de estado de un envío de pago

La consulta de estado devuelve un código y una descripción de estado, que representa la fase
del procesamiento en la que se encuentra el envío.
fechaProceso SI Date(8) Indica la fecha en la que se realizó el envío que se quiere
consultar.
código SI Num Indica el código de retorno del procesador.
estado SI Char Código del estado.
descripcionEstado SI Char Descripción del código de estado devuelto.
60
En el caso de pagos, los estados posibles se pueden ver en la siguiente Tabla:
Códigos de Estado dados por el Web Service Pagos

código Descripción
WS01 ENVIO RECIBIDO EN SERVIDOR
WS02 ERROR EN DESENCRIPCION
WS03 ENVIO DESENCRIPTADO
WS04 ERROR EN DESCOMPACTACION
WS05 ENVIO DESCOMPACTADO
WS06 ERROR EN FIRMA DE ARCHIVO
WS07 ERROR EN NOTIFICACION A BACKEND
WS08 ENVIO NOTIFICADO A BACKEND
WS09 ENVIO EN PROCESO
WS10 ENVIO RECHAZADO POR INCONSISTENCIA
WS11 ENVIO RECHAZADO
Códigos de Estado dados por PIRYP Pagos

código Descripción
001 ENVIO RECIBIDO
003 PARCIALMENTE FIRMADO
005 FIRMADO
007 BAJA SOLICITADA D/FIRMADO
008 BAJA PARC. FIRMADA D/FIRMADO
010 AUTORIZADO
015 BAJA SOLICITADA D/AUTORIZ
016 BAJA PARC. FIRMADA D/AUTORIZ.
020 EN PROCESO
090 BAJA POR ENVIO
094 ANULADO
 XML de entrada:
<pedido>
<cuit>30123456781</cuit>
<fechaProceso>20050209</fechaProceso>
</pedido>
61
 XML de salida:
<respuesta>
<descripcion>El estado del envío ha sido obtenido
<estado>WS03</estado>
<descripcionEstado>ENVIO DESENCRIPTADO</descripcionEstado>
<status>0</status>
</respuesta>
5.3.4 Función 4: Consulta de archivos de rechazos de pago.

rechazo.

fechaAlta SI Date(8) Formato AAAAMMDD (solo para obtención de listados de Pagos)
62
Archivo SI Char Nombre del Archivo. Este campo se repite n veces por cada archivo
encontrado.
 XML de entrada:
<pedido>
<cuit>30700005573</cuit>
<fechaAlta>20070806</fechaAlta>
</pedido>
 XML de salida:
<respuesta>
<descripcion>El listado de archivos de rechazo ha sido obtenido
<status>0</status>
<archivo>R307000055730011012007080600600150710.TXT</archivo>
<archivo>R307000055730011012007080600600150711.TXT</archivo>
</respuesta>
5.3.5 Función 5: Consulta de archivos de rendición de pago por

rango de fechas
rendición o información adicional que se encuentran disponibles para exportar a los sistemas del
Cliente.
63

tpoRendicion SI Char Indica los tipos de rendiciones posibles a pedir. Los valores
posibles son RND, INF, LIS.
fechaDesde SI Num(8) Formato AAAAMMDD
fechaHasta SI Num(8) Formato AAAAMMDD
archivo SI Char Nombre del Archivo. Este campo se repite n veces por cada archivo
encontrado.
 XML de entrada:
<pedido>
<cuit>30700005573</cuit>
<tpoRendicion>RND</tpoRendicion>
</pedido>
64
 XML de salida:
<respuesta>
<descripcion>El listado de archivos de rendiciones ha sido obtenido
<status>0</status>
</respuesta>
65
6 Configuraciones.
6.1 Invocación a Online Cash Management - WebServices.

Existen dos formas de invocar al WebService para acceder a sus distintas funcionalidades:
 Con un cliente provisto por el Banco.

 Con un cliente desarrollado por la Empresa Cliente.
Si la Empresa opta por utilizar la funcionalidad provista por el Banco, deberá incorporar las
librerías recibidas a su ERP. El cliente contiene toda la funcionalidad necesaria para realizar la
conexión, pero no es una aplicación autónoma, por tal motivo deberá ser invocada en el cuerpo
de un programa.
Si no se utiliza el cliente provisto por el Banco, la Empresa deberá desarrollar el módulo para
conectarse con el servidor del Banco mediante las interfaces XML definidas en este documento.
6.1.1 Invocación al WebService con el cliente provisto
El acceso al WebService a través del cliente provisto por el Banco, se realiza a través de la
clase:
Clase:
ar.com.bancorio.rioserv.client.WSRioServ
Método:
procesar()
Nombre Tipo Comentario
mensaje ar.com.bancorio.rioserv.commons.WSM Cuenta con dos atributos: el XML con el
essage pedido a realizar (del tipo String) y un
arreglo de bytes (del tipo byte[]) que
contiene el archivo a enviar al Banco en
caso de que sea necesario.
exportar boolean Indica, en caso de que sea verdadero, que
no se invocará al Web Service, sino que se
exporta el xml (y el archivo a enviar en caso
de que sea necesario) a un archivo del
sistema de archivos de la máquina del
Cliente. Este campo se envía en true en
caso de no poder enviar el archivo usando
el circuito normal (contingencia).
66
respuesta ar.com.bancorio.rioserv.commons.WSM Contiene el XML de respuesta (de tipo
essage String), y opcionalmente un arreglo de bytes
(del tipo byte[]) que contiene el archivo
exportado desde el Banco.
6.1.2 Invocación al Web Service sin el cliente provisto
Para hacer uso del Web Service sin el cliente provisto por el Banco, se deberá construir un
método que pueda establecer una conexión SOAP a través de HTTPS. Asimismo se deberá
invocar al método procesar() del Web Service con los siguientes parámetros:
xml String Contiene el XML generado por cliente, cuyo contenido es interpretado
por el Web Service para llevar a cabo alguna funcionalidad
especifica.
archivo byte[ ] Arreglo de bytes que representa el archivo a enviar al Banco en caso
de que el XML descrito arriba implique una importación de un archivo
desde el cliente hacia Banco.
Tanto el cliente provisto por el Banco, como el Web Service, poseen un método llamado procesar() que
cumplen distintas funciones. En este caso se hace referencia al método del Web Service.
67
6.2 Configuraciones y URLs de Acceso al Sistema
La configuración del cliente de Online Cash Management - WebServices se realiza mediante un

archivo denominado config.xml. A continuación se muestra el mismo tanto para los ambientes de
Homologación (test) como para el ambiente productivo:
Configuración para el ambiente de HOMOLOGACION:

<configuracion>
<mensajes>configuracion/</mensajes>
<tamanomaximoarchivo>327809453</tamanomaximoarchivo>
<logs>/</logs>
<pass>clave</pass>
<certificado>C:/Certificado.p12</certificado>
<urlconn>test.wscash.santanderrio.com.ar</urlconn>
<dirconn/RSWebServices/servlet/rpcrouter</dirconn>
<port>443</port>
<hostproxy></hostproxy>
<archivoXmlContingencia>D:/temp.xml</archivoXmlContingencia>
</configuracion>
Configuración para el ambiente de PRODUCCION

<configuracion>
<mensajes>configuracion/</mensajes>
<tamanomaximoarchivo>327809453</tamanomaximoarchivo>
<logs>/</logs>
<pass>clave</pass>
<certificado>C:/Certificado.p12</certificado>
<urlconn>www.wscash.santanderrio.com.ar</urlconn>
<dirconn>/RSWebServices/servlet/rpcrouter</dirconn>
<port>443</port>
<hostproxy></hostproxy>
<archivoXmlContingencia>D:/temp.xml</archivoXmlContingencia>
</configuracion>
68

Manual Tecnico WebServices - v.08!10!2020

Cargado por

Información del documento

Título original

Derechos de autor

Formatos disponibles

Compartir este documento

Compartir o incrustar documentos

Opciones para compartir

¿Le pareció útil este documento?

¿Este contenido es inapropiado?

Copyright:

Formatos disponibles

Manual Tecnico WebServices - v.08!10!2020

Cargado por

Copyright:

Formatos disponibles

Manual de uso Técnico

Online Banking Cash Management - WebServices

Random r=new Random(); Courier 9 se utiliza para indicar código fuente o

La Importación es el proceso en el cual la Empresa genera archivos para enviar posteriormente

4 Manejo de la encripción mediante el módulo RSABC

4.1 Preparación de archivos y tags para enviar al Banco

Luego, se debe realizar la encripción de la firma mediante la siguiente interfaz:

RSABC.procesarStringPriv( true, "cliente.p12", "password", md5);

El fragmento de código que se empleará será entonces el siguiente:

El resultado se ubicará en el tag <firmaArchivo>, indicando al Banco de que cliente proviene el

4.1.2 Encripción del archivo a enviar al Banco

Luego de la compactación se requiere la encripción del archivo. Dicha encripción se debe

Para encriptar archivos, el algoritmo elegido es el 3DES. Para realizar la encripción de un

4.1.3 Preparado de la clave 3Des para enviar al Banco

4.1.4 Preparado del TAG de firmantes

public static String obtenerMD5String(String cadena)

String str = RSABC.procesarStringPriv(true,

4.2 Obtención de archivos desde el Banco

4.2.1 Desencripción del archivo

Luego es necesario emplear el método de desencripción de 3Des, de la siguiente manera para

Quedando el contenido final en archivo.zip.

4.2.2 Obtención y verificación de la firma del archivo

4.2.3 Resumen de los pasos para enviar y recibir un archivo

Cuando se recibe el archivo, los pasos son los siguientes:

 Obtener la clave del tag <clave3Des>

5 Cobranza Interactiva y Pagos

A continuación se detalla la parte común del XML:

Valores del tag moduloRioserv

5.1 Productos y Funciones

Descripción Producto Código de Producto

5.2 Funciones para el modulo de Deuda

Campo Oblig. Form. Descripción

moduloRioserv SI Char Debe ser igual a ‘001’ para Cobranzas

codproducto SI Num(3) Indica el código de producto empleado

instancia SI Num(2) Indica el número de instancia de producto.

funcion SI Num(1) Debe ser igual a 1.

cuit SI Num(11) Indica el CUIT de la Empresa.

marEmpresa Si Num (1) Dígito desempatador de la Empresa (Generalmente es

nroEnvio SI Num(5) Indica el número de envío.

Firmantes (repetición de 5 ocurrencias)

tpoDoc SI Char(1) Tipo de documento del firmante I (CI), N (DNI), C (LC),

nroDoc SI Num(11) Numero de documento del firmante

Fin de campo repetitivo de firmantes

firmaFirmante SI Char MD5 de String de Firmantes (aunque no se hayan

archivo SI Archivo Archivo adjuntado con el envío de deuda.

Campos exclusivos de Publicación de Deuda

cant_reg SI Numérico Indica la cantidad de registros que tiene la publicación.

ult_rendic Si Numérico Ultima rendición procesada.

importevto1 Si Numérico Importe total del primer vencimiento.

Para la parte decimal se utiliza punto (.) como separador de

importevto2 Si Numérico Importe total del segundo vencimiento. Para la parte

cantFactElect No Numérico Cantidad de facturas electrónicas del lote

puntoVtaFeDesde No Numérico Punto de Venta desde del lote

nroDocFeDesde No Numérico Número de Factura desde del lote

tipoCompFeDesde No Char Tipo de Comprobante desde del lote

puntoVtaFeHasta No Numérico Punto de Venta hasta del lote

nroDocFeHasta No Numérico Número de Factura hasta del lote

tipoCompFeHasta No Char Tipo de Comprobante hasta del lote

Donde Status puede ser:

Códigos de Tipo de Respuesta del Servidor

Y algunos de los códigos pueden ser:

Respuestas del Servidor

Respuestas del Servidor