Documentación Collectar

Documentación Collectar

Documentación técnica de integración

Recepción de órdenes de cobro

Estimated reading: 3 minutes 37 views
El servicio ofrece dos modos de recibir peticiones para la emisión de órdenes de cobro con el fin de adaptarse a los distintos volúmenes de información a recibir por cada una de las peticiones de los clientes.

Cada una de las peticiones recibidas por este servicio será considerada como un conjunto de órdenes, aisladas e independiente del resto. Serán transmitidas por EDITRAN al banco configurado de modo automático y no estará vinculada con ninguna de las otras que hayan podido procesarse para el cliente.

Ubicación del servicio

El método se ubica en el path

/api/N34/neworder
Estructura del mensaje
El servicio espera recibir un mensaje estructurado, en alto nivel, de la siguiente manera:

Identificación del cliente.
Listado de órdenes de pago.
Etiqueta de tiempo
Firma del mensaje
Petición

idCliente será la identificación del cliente dentro de la plataforma de Gestoría Virtual

Detalles de los datos de las órdenes de transferencia
Este bloque del mensaje especifica los detalles de la orden de transferencia que se pretende emitir. La información incluida en este bloque es la siguiente :

Fichero con formato XML
En el caso de que se envíe el detalle de las órdenes mediante el fichero indicado en el parámetro fileUrl, deberá ser en formato XML y las órdenes en formato estándar ISO 20022 para la emisión de transferencias en euros y en divisas, y cheques, pagarés y pagos domiciliados.
Este fichero será descargado de la ruta indicada, y realizaremos un mapeo contra los campos necesarios para que el flujo sea el mismo que si se indicara el detalle de las órdenes en la petición.
Respuesta del servicio

El servicio devolverá un código de status que indicará el resultado de la petición enviada por el cliente. Si la petición es correcta devolverá también un token que deberá ser utilizado por el cliente en solicitudes posteriores.

Los códigos que podrán ser devueltos en el campo resultado, son los siguientes:

La firma se realizará de la siguiente manera.
Se concatenan todos los campos de la petición, en el siguiente orden:

idCliente
requestTime
Número de transferOrders

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.
Ejemplo de petición
				
					{
 "idCliente": "bb9e34635fb7",
 "transferOrders":[{
 "payerName": "KÍNEOX SOLUTIONS S.L.",
 "payerCode": "ES22001B1234567",
 "payerIBAN": "ES4401822101221234567890",
 "idOrder": "FRA 2021/12345",
 "emissionDate": "2021-02-17",
 "priority": "NORM",
 "liquidation": "",
 "serviceLevel": "SEPA",
 "noteInAccount": false,
 "purpose": "OTHR",
 "seqType": "RCUR",
 "currency": 978,
 "amount":13.56,
 "concept": "PAGO FACTURA",
 "beneficiaryName": "EMPRESA S.L",
 "beneficiaryCIF": "57893482L",
 "beneficiaryIBAN": "ES8700774789657890654321"
 },
 {
 "payerName": "KÍNEOX SOLUTIONS S.L.",
 "payerCode": "ES22011B1234567",
 "payerIBAN": "ES4401822101221234567891",
 "idOrder": "PMT 220P",
 "emissionDate": "2021-02-17",
 "priority": "HIGH",
 "liquidation": "",
 "serviceLevel": "SEPA",
 "noteInAccount": true,
 "purpose": "OTHR",
 "seqType": "RCUR",
 "currency": "978",
 "amount":1345.58,
 "concept": "Cuota mes Enero",
 "beneficiaryName": "PRUEBA S.L.",
 "beneficiaryCIF": "45123488K",
 "beneficiaryIBAN": "ES813077478968520654322"
 }],
 "requestTime":"20210218165144495",
 "signature": "907DE8D29D7F0FF1F9E54DFA593F58CD642FC931B714F8FCA31E19B90DC135D8"
}

				
			
CONTENTS
en_GBEnglish (UK)