Como enviar marcas de tiempo

El flujo regulatorio exige enviar marcas de tiempo dentro del procesamiento transaccional. ACH En Línea dispone el servicio POST: v1/money-movements/transfers/{id}/status para que las Entidades Participantes envíen las marcas de tiempo al momento requerido por la regulación.

Campos de entrada marcas de tiempo

Campo Tipo Validación Descripción Obligatoriedad
Authorization String Min 1 – Máx 64 Bearer token OAuth2. Si
x-hash String Min 64 – Máx 64 Cadena de comprobación de integridad de la trama. Serializar el objeto data y aplicar SHA256. Si

Campos de entrada actualizacion de marcas de tiempo (body)

Campo Tipo Validación Longitud Obligatoriedad
data objeto N/A N/A SI
movementType lista Identificador del schema del flujo transaccional. Ver tabla “VALORES PARA LAS LOS MOVEMENT TYPE” lista SI
status cadena Estado en el que quedará la transacción. Ver tabla "VALORES PARA LAS ACCIONES Y ESTADOS (status)" Lista SI
creationDateTime fecha Marca de tiempo del evento de regulación Ver tabla "REGLAS PARA LOS VALORES DE TIPO FECHA" SI
debitId string Identificador del débito o crédito Min 1 Max 36 SI
coreId cadena Identificador interno del banco Min 1 Max 255 SI
useCaseInformation objeto Objeto para informar marcas de tiempo N/A COND. Obligatorio si se enviarán marcas de tiempo
timestamps sub-objeto Objeto para informar marcas de tiempo N/A COND. Obligatorio si se enviarán marcas de tiempo
received fecha Objeto para informar marcas de tiempo. Todos los campos de fecha deben tener este formato: - AAAA-MM-DDThh:mm:ss.sss Reglas para el dato: - Formato ISO 8601 hora local con milisegundos. - No lleva la Z - Expresado en hora Colombiana (UTC-5). N/A COND. Obligatorio si se enviarán marcas de tiempo
dispatched fecha Objeto para informar marcas de tiempo. Todos los campos de fecha deben tener este formato: - AAAA-MM-DDThh:mm:ss.sss Reglas para el dato: - Formato ISO 8601 hora local con milisegundos. - No lleva la Z - Expresado en hora Colombiana (UTC-5). N/A COND. Obligatorio si se enviarán marcas de tiempo

Request actualización del transfer

curl --location 'https://url_ach/v1/money-movement/transfers/{id}/status' \
--header 'hash: 695ffdf84f0dad0c19e3b8b09a4565246c156d747ffb26149e4c2dc5d3b66ca1' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiJkZW1vLXVzdWFyaW8iLCJyb2xlIjoiYXBwLXRlc3QiLCJpYXQ iOjE3MDAwMDAwMDAsImV4cCI6MTcwMDA4NjQwMH0.abc123xyz987fakeSignatureOnlyForDemoPurposes' \
--data '{...}'

Data:

{
  "data": {
    "movementType": "P2P-BREB",
    "status": "prepared",
    "creationDateTime": "2026-03-15T10:30:05.000",
    "debitId": "DBT-20260315-0000000123",
    "coreId": "CORE-12345",
    "useCaseInformation": {
      "timestamps": {
        "received": "2026-03-15T10:29:58.000",
        "dispatched": "2026-03-15T10:29:59.500"
      }
    }
  }

Response registro marcas de tiempo

{
  "meta": {
    "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "timestamp": "2026-03-15T10:30:05.000",
    "status": "SUCCESS",
    "statusCode": "200",
    "statusDesc": "OK"
  },
  "data": {
    "id": "20260315800037800TFY000000000001246",
    "status": "prepared",
    "creationDateTime": "2026-03-15T10:30:05.000",
    "movementType": "P2P-BREB"
  }
}

El status que enviará en el cuerpo del mensaje no será tenido en cuenta como el estado de la transacción.

Orderarticle 7
Notificación estado final Anterior