Objeto Movement

El objeto `Movement`

Un Movement representa una transacción en una cuenta bancaria, como una transferencia, un cheque u otro cargo o abono. Fintoc obtiene el objeto desde una institución para una cuenta asociada a un Link. La API devuelve el objeto cuando listas o consultas movimientos.

Movement Object

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

El objeto Movement incluye los siguientes atributos:

Atributo	Tipo	Descripción
`id`	`string`	Identificador único del `Movement`.
`object`	`string`	Identificador del tipo de objeto. El valor siempre es `movement`.
`amount`	`integer`	Monto del movimiento en la unidad mínima de la moneda. Un valor positivo aumenta el saldo de la cuenta y un valor negativo lo disminuye. Por ejemplo, una compra genera un `amount` negativo y una transferencia recibida genera un `amount` positivo.
`comment`	`string`	Comentario de la transferencia. Puede ser `null` si el movimiento no es una transferencia.
`currency`	`string`	Código de moneda ISO 4217.
`description`	`string`	Texto del movimiento que entrega la institución.
`document_number`	`string` o `null`	Número de documento que la institución asigna al movimiento. `null` cuando la institución no entrega un número de documento.
`pending`	`boolean`	Si el movimiento es un cheque, indica si el banco aún no hace efectivo el cheque. El valor es `false` si el movimiento no es un cheque. `pending` es independiente de `status`. Consulta `pending` y `status`.
`post_date`	`string`	Fecha contable del movimiento en formato ISO 8601. Este campo solo contiene una fecha, por lo que su hora siempre es `00:00:00.000Z`.
`recipient_account`	`object`	Cuenta que recibió la transferencia. El valor es `null` si el movimiento no es una transferencia. Consulta la tabla del objeto Transfer Account más abajo.
`reference_id`	`string`	Identificador del movimiento que entrega la institución. Puede ser `null`. Para una transferencia, representa el número de operación o `id` de la transacción. Si el banco no entrega el `id`, Fintoc puede usar el número de documento. Para un cheque, representa el número de documento.
`sender_account`	`object`	Cuenta que realizó la transferencia. El valor es `null` si el movimiento no es una transferencia. Consulta la tabla del objeto Transfer Account más abajo.
`status`	`string`	Estado del movimiento. Uno de `confirmed`, `processing` o `reversed`. Consulta Estado del movimiento.
`transaction_date`	`string`	Fecha y hora de la transacción en formato ISO 8601. La hora proviene de la institución. En algunas instituciones, este valor corresponde a la hora local de Chile aunque termine en `Z`. Puede ser `null` si el movimiento no es una transferencia.
`transfer_id`	`string` o `null`	Identificador que la institución asigna a la transferencia. `null` cuando el movimiento no es una transferencia o no hay un identificador de transferencia disponible.
`type`	`string`	Clasificación del movimiento. Uno de `transfer`, `check` u `other`.

post_date y transaction_dateCada movimiento incluye dos fechas: post_date y transaction_date. Los bancos usan fechas contables, por lo que una transacción realizada un sábado puede aparecer con fecha del lunes. En este ejemplo, transaction_date corresponde al sábado y post_date, al lunes.El campo post_date es una fecha sin hora, por lo que Fintoc siempre la entrega a las 00:00:00.000Z. No la conviertas a tu zona horaria local, porque la conversión puede moverla al día anterior.El campo transaction_date incluye la hora que informa la institución. Según la institución, Fintoc puede entregar la hora local de Chile con el sufijo Z en lugar de una hora UTC real. Revisa los valores que recibes de cada institución antes de convertir transaction_date a otra zona horaria.

Cheques pendientesEl banco puede tardar hasta 48 horas hábiles en confirmar un cheque. El banco puede revertir un cheque pendiente por motivos como la falta de fondos. Fintoc marca estos cheques con pending para que sepas que el banco aún no los hace efectivos. El campo pending no cambia el status del movimiento.

Estado del movimiento

El campo status indica el estado actual de un movimiento. La mayoría de los movimientos están confirmed. Un movimiento puede pasar a processing o reversed mientras Fintoc procesa y valida los datos del banco. Por defecto, List movements solo entrega movimientos confirmed. Envía confirmed_only=false para obtener también los movimientos processing y reversed:

Estado	Descripción
`confirmed`	El movimiento está confirmado y se considera final. `confirmed` es el estado por defecto para todos los movimientos.
`processing`	Fintoc evalúa el movimiento, que puede cambiar a `confirmed` o `reversed`. El tiempo estimado de resolución es de 12 horas.
`reversed`	El banco revirtió el movimiento y deshizo la transacción original.

`pending` y `status`

pending y status son campos distintos, y cada uno responde una pregunta diferente:

pending aplica solo a cheques. Es true mientras el banco aún no hace efectivo el cheque. Para cualquier otro tipo de movimiento, siempre es false.
status aplica a todos los movimientos. Indica si el movimiento está confirmed, processing o reversed.

Un cheque puede tener pending en true y status en confirmed. Usa status para decidir si un movimiento es final. Los movimientos que guardaste antes no se actualizan solos. Vuelve a consultar el movimiento para obtener sus valores actuales de pending y status.

El objeto Transfer Account dentro de `Movement`

El objeto Transfer Account identifica la cuenta en el otro extremo de una transferencia. Aparece en los campos sender_account y recipient_account de un Movement:

Atributo	Tipo	Descripción
`holder_id`	`string`	Identificador tributario del titular de la cuenta. En Chile, corresponde al identificador tributario chileno (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 sin guiones ni ceros a la izquierda. Puede ser `null`.

Problemas con datos de transferenciaLos datos de transferencia pueden ser null o incorrectos si el movimiento no es una transferencia o existen problemas de coincidencia con las cartolas del banco. Verifica los datos de transferencia antes de conciliar tus movimientos. Los demás datos del movimiento son siempre confiables. Los datos de transferencia pueden cambiar durante los 5 días posteriores a la creación del movimiento.

​El objeto Movement

​Estado del movimiento

​pending y status

​El objeto Transfer Account dentro de Movement

El objeto `Movement`

Estado del movimiento

`pending` y `status`

El objeto Transfer Account dentro de `Movement`