Movimientos de Cuenta Bancaria (CBU)
Nivel de seguridad requerida para este servicio
Muy Alta (accessToken + mutual TLS + HMAC + VPN)
Objetivo
Esta API proporciona un listado de los movimientos de una cuenta bancaria operativa (CBU). Cada elemento contiene toda la información disponible para facilitar su imputación. El servicio devuelve un máximo de 200 registros por página.
Request
/v2/apibank/movements/$accountId
curl -X GET "https://$env/v2/apibank/movements/$accountId" \
-H 'Authorization: $YOUR_ACCESS_TOKEN' \
--data-urlencode "pageSize=200"env: Entorno de la API, como producción o desarrollo.accountId: Identificador de la cuenta operativa que se desea consultar.YOUR_ACCESS_TOKEN: Token obtenido en el servicio de autenticación.
Filtros
| Filtro | Descripción |
|---|---|
| startDate | Fecha de inicio (formato ISO 8601: YYYY-MM-DDTHH:mm:ssZ) |
| endDate | Fecha de fin (formato ISO 8601: YYYY-MM-DDTHH:mm:ssZ) |
| sortDirection | Dirección de ordenación (ASC o DESC) |
| pageSize | Tamaño de página (máximo 200 registros) |
| pageOffset | Número de página |
| originId | Filtro para obtener una sola transacción basado en el ID de tu organización |
| networkId | Filtro para obtener una sola transacción basado en el ID de la red |
Todos los filtros son opcionales. En caso de no enviar ningún parámetro, esta consulta devolverá por defecto las últimas 100 movimientos.
Ejemplo de Respuestas:
JSON Response Body
{
"page": 1,
"count": 200,
"total": 3500,
"transactions": [
{
"id": "001343432423424234332",
"counterparty": {
"personId": "20036675544",
"personIdType": "CUI",
"personName": "Juan García",
"accountRouting": {
"addressType": "CBU_CVU",
"address": "00000740000000000002"
}
},
"details": {
"type": "CREDIT_TRANSFER_RECEIVED_CVU",
"typeDescription": "Transferencia Recibida",
"originId": NULL,
"network": "COELSA",
"networkId": "Z63EMDN2E7JQWFVW5E7RA3",
"postingDatetime": "2024-04-12T10:00:00Z",
"completedDatetime": "2024-04-12T10:15:30Z",
"amountCurrency": "032",
"amount": 2500.5,
"motiveCode": "ALQ",
"message": "Alquiler del mes",
"newBalanceCurrency": "032",
"newBalanceAmount": 73500.6
},
"thisSubAccount": {
"owners": {
"personId": "27025667757",
"personIdType": "CUI",
"personName": "Marta Martínez",
"personType": "INDIVIDUAL"
},
"accountRouting": {
"addressType": "CVU",
"address": "0009401811100042119204"
}
}
},
{
"id": "001343432423424234367",
"counterparty": {
"personId": "20054335556",
"personIdType": "CUI",
"personName": "Carlos López",
"accountRouting": {
"addressType": "CBU_CVU",
"address": "8890076411100054934680"
}
},
"details": {
"type": "DEBIT_TRANSFER_SENT_CBU",
"typeDescription": "Transferencia Recibida",
"network": "COELSA",
"networkId": "Y54GMN92I4XJKVW12GHE1",
"postingDatetime": "2024-04-13T15:45:00Z",
"completedDatetime": "2024-04-13T16:00:00Z",
"amountCurrency": "ARS",
"amount": -3200.75,
"motiveCode": "FAC",
"message": "Pago Fc A 0001-00000342",
"newBalanceCurrency": "032",
"newBalanceAmount": 75600.85
},
"thisSubAccount": {
"owners": {
"personId": "20220427499",
"personIdType": "CUI",
"personName": "Alandra Agard",
"personType": "INDIVIDUAL"
},
"accountRouting": {
"addressType": "CBU_CVU",
"address": "0009401811100041101965"
}
}
}
]
}
Información adicional sobre campos
page: Número de página actual.count: Cantidad de movimientos devueltos en la página actual.total: Total de registros en todas las páginas utilizando los filtros de la consulta.networkId: Identificador de la transacción utilizado por la red. Ejemplo: Coelsa -> DebinId.postingDatetime: Es la fecha en formato ISO 8601 que indica el momento en que el banco recibió el movimiento. Este movimiento puede contener información faltante sobre la contrapartida (conterparty) la cual puede ser completada más tarde o en los días sucesivos.completedDatetime: Es la fecha en formato ISO 8601 en la que toda la información del movimiento fue recibida. No se agregará mas información al movimiento luego de esta fecha. Este campo puede ser null hasta tanto no se reciba toda la información disponible del movimiento.type: Es el tipo de movimiento según diccionario.amountCurrency: Es la moneda en la que esta expresada el movimiento. Se utiliza el formato ISO 4217. (Ejemplo: 032 Peso Argentino),motiveCode: Es el motivo de la transacción indicada por su iniciador. Utiliza los motivos de transacciones definidos en el diccionario según BCRA.message: Es un texto libre que ingresa la persona que inicia el movimiento. Puede tomar valores (NULL)thisSubAccount: Este campo proporciona información sobre la sub-cuenta virtual asociada al movimiento, si corresponde. En caso de que la transacción esté relacionada con una sub-cuenta, este campo contendrá todos los detalles necesarios para su correcta imputación. Si el movimiento no está vinculado a una sub-cuenta, el valor de este campo será NULL. Esto facilita la identificación de transacciones específicas dentro de cuentas principales que tienen sub-cuentas virtuales asociadas.