El servicio espera recibir un mensaje estructurado de la siguiente manera:
Parámetros
Tipo de dato
Requerido
Descripción
idCliente
Alfanumérico
Si
Identificador del cliente
responseTime
Alfanumérico
Si
Marca de tiempo
signature
Alfanumérico
Si
Cadena de firma de validación del mensaje
El idCliente corresponde al identificador API que CollectAR proporciona por cada cliente
Respuesta del servicio
El servicio devolverá un listado de las remesas pendientes de envío con la siguiente estructura de campos.
Parámetros
Tipo de dato
Requerido
Descripción
msgIdentifier
Alfanumérico
Sí
Cadena con la identificación de la remesa para el cliente
presenterID
Alfanumérico
Sí
Identificador del presentador SEPA
creditorIBAN
Alfanumérico
Sí
Cuenta IBAN que recibirá los importes recuperados por la remesa
collectionDate
Fecha
Sí
Fecha en la que se espera que el banco ejecute la orden
Currency
Numérico
Sí
Sólo admite 978 (EURO) según la normativa ISO-4217
submittedOperations
Numérico
Sí
Número total de operaciones comunicadas
submittedAmount
Decimal
Sí
Suma total de los importes de la remesa
numPayments
Numérico
Sí
Número de las órdenes de pago asociadas a esa remesa
La firma se realizará de la siguiente manera.
Se concatenan todos los campos de la petición, en el siguiente orden:
idCliente
responseTime
Además, se añade también, al final, la clave privada del cliente.
Se aplicará una función SHA-256 sobre la cadena anterior. El resultado será codificado en una cadena hexadecimal y convertido a una cadena en mayúsculas.