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.
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
/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
Identificación del cliente.
Listado de órdenes de pago.
Etiqueta de tiempo
Firma del mensaje
Petición
| Campo/bloque | Tipo de dato | Requerido | Descripción |
|---|---|---|---|
| idCliente | Alfanumérico | Si | Identificador del cliente |
| transferOrders | Estructura | No | Datos relacionados con la remesa a ejecutar |
| fileURL | Alfanumérico | No | Url del fichero XML |
| requestTime | Alfanumérico | Si | Fecha (yyyyMMddHHmmssfff) |
| signature | Alfanumérico | Cadena de firma de validación del mensaje |
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 :| Parámetro | Tipo de dato | Requerido | Descripción |
|---|---|---|---|
| payerName | Alfanumérico | Si | Nombre del ordenante |
| payerCode | Alfanumérico | Si | Código del ordenante (Presentador) |
| payerIBAN | Alfanumérico | Si | IBAN Ordenante del pago |
| idOrder | Alfanumérico | Si | Identificación única del pago para el ordenante |
| emissionDate | Alfanumérico | Si | Fecha de emisión del pago |
| priority | Alfanumérico | Si | Prioridad (HIGH O NORM) |
| liquidation | Alfanumérico | No | Liquidación en el mismo día (SDCL, vacío si no es necesario) |
| serviceLevel | Alfanumérico | No | Nivel de servicio (SEPA/URGP). SEPA por defecto |
| noteInAcoount | Verdadero/Falso | Si | Apunte detallado en cuenta |
| seqType | Alfanumérico | Si | Tipo de secuencia (RCUR por defecto) |
| purpose | Alfanumérico | Si | Propósito del pago (OTHR por defecto) |
| currency | Alfanumérico | Si | Divisa (Siempre 978 -> EURO) |
| amount | Decimal | Si | Importe de la transferencia |
| concept | Alfanumérico | Si | Concepto de la transferencia |
| beneficiaryName | Alfanumérico | Si | Nombre del beneficiario |
| beneficiaryCIF | Alfanumérico | Si | CIF del beneficiario |
| beneficiaryIBAN | Alfanumérico | Si | IBAN del beneficiario |
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.
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.
| Parámetros | Tipo de datos | Requerido | Descripción |
|---|---|---|---|
| resultado | Numérico | Si | Resultado de la petición |
| token | Cadena | No | Identificador de la remesa |
Los códigos que podrán ser devueltos en el campo resultado, son los siguientes:
| Código | Descripción |
|---|---|
| 0 | Petición procesada correctamente |
| 1000 | URL de descarga no segura/incorrecta |
| 1001 | No se ha encontrado el documento especificado |
| 1003 | IdOrder supera longitud de 35 caracteres |
| 9000 | Petición errónea |
| 9001 | Firmas de mensaje incoherentes |
| 9998 | Firma del mensaje inválida |
| 9999 | Error no especificado |
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.
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"
}