Consultar órdenes N43
Estimated reading: 2 minutes
49 views
Este servicio tiene como finalidad permitir que los usuarios puedan consultar por fechas las órdenes de la Norma 43.
El servicio estará disponible en la siguiente ruta:
api/n43/getorders
Estructura del mensaje
El servicio esperará una petición con la siguiente información:
Identificador del cliente
Fecha
Firma del mensaje
Identificador del cliente
Fecha
Firma del mensaje
| Parámetros | Tipo de dato | Requerido | Descripción |
|---|---|---|---|
| idCliente | Alfanumérico | Si | Identificador API del cliente |
| date | Date | Si | Día de las órdenes que se quieren consultar |
| signature | Alfanumérico | Si | Cadena de firma de validación de mensaje |
- El idCliente corresponde al identificador API que CollectAR proporciona por cada cliente.
La firma se realizará de la siguiente manera:
Se concatenan todos los campos de la petición en el siguiente orden:
idCliente
date
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
idCliente
date
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
Respuesta del servicio
Los códigos que podrán ser devueltos en el campo resultado son los siguientes:
| Código | Descripción |
|---|---|
| 0 | Sin error |
| 1000 | Url errónea |
| 1001 | No hay registros para mostrar |
| 9000 | Petición errónea |
| 9998 | Firma Errónea |
| 9999 | Error no específicado |
Ejemplo de petición
{
"idCliente":"460d8726efbd",
"date":"2021-02-02",
"signature":"B9A4BFBEBAB750C6C3A3D7EDE0DDD7C985CBC43F72C4BFFE611323704FAE9B19"
}
Ejemplo de respuesta
{
"signature": "F7B2BB6146E1274C9FE8E50288456000000000001DAFB910F06D202D4769C352A",
"responseTime": "20230328101959754",
"header": {
"fileId": "CBC2AED9-3285-4711-92D9-626AC3B1139B",
"bankCode": "1234",
"bankOffice": "3456",
"bankAccount": "0000000001",
"holderShortName": "CLIENTE DE PRUEBA, S.L.",
"processDate": "2021-02-01T11:18:34",
"downloadFrom": ""
},
"transactions": [
{
"srcOffice": "5924",
"operationDt": "2021-01-29T00:00:00",
"valueDt": "2021-01-29T00:00:00",
"commonConceptCd": "04",
"commonConceptDesc": "GIROS - TRANSFERENCIAS - TRASPASOS - CHEQUES",
"bankConceptCd": "546",
"bankConceptDesc": "TRANSF.A SU FAVOR",
"amount": 38000.00,
"isSEPA": 1,
"generatedByKineox": 0,
"KineoxOperationId": null,
"pmtChannel": "",
"docNumber": "0000000000",
"firstRef": "000000000000",
"secondRef": "21770611",
"payerName": "GABRIELA DIAZ",
"payerCode": "5555555K",
"payerRef": null,
"schema": null,
"from": "",
"transferPrp": "",
"prpCat": "",
"concept": "RF35821073PAGOCARTERA",
"freeText": "",
"extraData": "",
"audit": {
"uniqueId": 32167,
"prevTrials": 0
}
],
"resultado": 0
}