Documentación Collectar

Documentación Collectar

Documentación técnica de integración

Consultar órdenes N43

Estimated reading: 2 minutes 50 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

  • 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

Respuesta del servicio

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

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
}
				
			
CONTENTS
es_ESEspañol