Objeto Movement

Movement Object

{
    "id": "mov_BO381oEATXonG6bj",
    "object": "movement",
    "amount": 59400,
    "comment": "Pago factura 198",
    "currency": "CLP",
    "description": "Traspaso de:Fintoc SpA",
    "pending": false,
    "post_date": "2020-04-17T00:00:00.000Z",
    "recipient_account": null,
    "reference_id": "123740123",
    "sender_account": {
        "holder_id": "771806538",
        "holder_name": "Comercial y Producción SpA",
        "institution": {
          "id": "cl_banco_de_chile",
          "country": "cl",
          "name": "Banco de Chile"
        },
        "number": "1530108000"
    },
    "status": "confirmed",
    "transaction_date": "2020-04-16T11:31:12.000Z",
    "type": "transfer"
}

Atributo	Tipo	Descripción
`id`	`string`	Identificador único del Movement
`object`	`string`	Identificador del tipo de objeto. Su valor para los `Movements` siempre corresponderá a `movement`
`amount`	`integer`	Monto del movimiento, representado como un entero . Este número es positivo cuando entra dinero a la cuenta bancaria y negativo cuando sale dinero de ella. Por ejemplo, comprar algo se reflejará como un movimiento con un atributo `amount` negativo, mientras que recibir una transferencia se reflejará como un movimiento con un atributo `amount` positivo. Estos montos se muestran en centavos.
`comment`	`string`	Si el movimiento es una transferencia, este atributo indica el comentario de la transferencia. Puede ser `null`
`currency`	`string`	Código ISO de moneda
`description`	`string`	Descripción del movimiento, obtenida desde la institución
`pending`	`boolean`	Si el movimiento es un cheque, este campo indica si está pendiente la confirmación por parte del banco. Si el movimiento no es un cheque, este atributo es `false`
`post_date`	`string`	Fecha contable del movimiento, usando ISO 8601
`recipient_account`	`object`	Si el movimiento es una transferencia, este atributo indica la cuenta a la que se realizó la transferencia. Puede ser `null`. Revisa la tabla del objeto Transfer Account más abajo para aprender más
`reference_id`	`string`	Identificador del movimiento obtenido desde la institución. Puede ser `null`. Si el Movement es una transferencia, representa el número de operación o `id` de transacción. Además, si el banco no entrega el `id` de transacción, a veces usamos el número de documento. Si el Movement es un cheque, representa el número de documento.
`sender_account`	`object`	Si el movimiento es una transferencia, este atributo indica la cuenta que realizó la transferencia. Puede ser `null`. Revisa la tabla del objeto Transfer Account más abajo para aprender más
`status`	`string`	Muestra el estado del movimiento. Sus valores pueden ser `confirmed`, `processing`, `reversed` y `duplicated`. El estado `pending` es transitorio hasta que un movimiento se define con otro estado.
`transaction_date`	`string`	Fecha y hora en la que se realizó el Movement, usando ISO 8601. Puede ser `null` cuando el movimiento no es una transferencia
`type`	`string`	Tipo de movimiento. Sus valores pueden ser `transfer`, `check` u `other`

Post date y transaction dateComo probablemente notaste, cada movimiento incluye dos fechas distintas: un post_date y un transaction_date 🧐. Esto se debe a que el banco usa fechas contables internamente. Algunos bancos incluso crean movimientos en el futuro. Por ejemplo, si haces una transacción un sábado, esta aparecerá con fecha de lunes. En este ejemplo, el sábado corresponde al transaction_date y el lunes al post_date.

Cheques pendientesLos cheques tardan un tiempo en ser confirmados por el banco. Esto puede demorar hasta 48 horas hábiles. Los cheques pendientes pueden ser revertidos por varios motivos (por ejemplo, falta de fondos). Fintoc marca los cheques pendientes con la bandera pending para que sepas que el movimiento aún no fue confirmado por el banco.

Estado del movimiento

El campo status indica el estado actual de un movimiento. Los movimientos se confirman inicialmente, pero pueden transitar a otros estados a medida que los datos del banco se procesan y validan.

Status	Descripción
`confirmed`	El movimiento ha sido confirmado y se considera final. Este es el estado por defecto para todos los movimientos.
`processing`	El movimiento está siendo evaluado y puede cambiar a `confirmed` o `reversed`. Este es un estado transitorio que normalmente se resuelve en 12 horas.
`reversed`	El movimiento fue revertido por el banco. La transacción original fue deshecha.

Objeto Transfer Account

Atributo	Tipo	Descripción
`holder_id`	`string`	Identificador del titular de la cuenta. En Chile, corresponde a un RUT
`holder_name`	`string`	Nombre del titular de la cuenta
`institution`	`object`	Institución a la que pertenece la cuenta. Puede ser `null`
`number`	`string`	Número de cuenta. No incluye guiones ni ceros a la izquierda. Puede ser `null`

Problemas con datos de transferenciaLos datos de transferencia a veces pueden ser null o estar incorrectos. Esto puede deberse a que el movimiento no es una transferencia o a problemas de coincidencia con las cartolas del banco. Siempre verifica dos veces los datos de transferencia antes de conciliar tus movimientos. Por otro lado, los datos del movimiento son siempre confiables. Los datos de transferencia pueden cambiar hasta 5 días después de que se creó el movimiento.

API de Fintoc

Recursos principales

API de Pagos

API de Transferencias

API de Movimientos

Direct Debit (Legacy)

API Fiscal

Objeto Movement

Estado del movimiento

Objeto Transfer Account

​Estado del movimiento

​Objeto Transfer Account

Estado del movimiento

Objeto Transfer Account