Skip to main content

​
Sincronizar con cursor

Los movimientos de un banco cambian después de creados: una pendiente se postea, el banco retira una fila, Tupana resuelve la contraparte o reclasifica. Si relees por rango de fechas, acumulas basura y pierdes las correcciones. GET /movements/sync/ te entrega esos cambios en orden, con un cursor que dice hasta dónde llegaste.
1

Carga inicial, sin cursor

Llama sin cursor y recorre la historia visible de tu key página a página con limit=500, siguiendo next_cursor mientras has_more sea true. Cada página trae solo added.
2

Persiste el cursor

Guarda el último next_cursor junto a tu copia, en la misma transacción con la que aplicas la página. Es opaco: no lo interpretes ni lo recortes.
3

Cada vez que vuelvas, trae solo lo que cambió

Llama con el cursor guardado. Aplica en este orden: removed (marca o borra), modified (reemplaza la fila completa), added (inserta). Guarda el nuevo cursor. Repite mientras has_more.
4

Deja que el webhook marque el ritmo

Suscríbete a movement.created y bank_account.refreshed (webhooks bancarios) y sincroniza al recibirlos. También puedes consultar /events/ si un webhook no llegó. Llamar más seguido no trae datos más frescos.

​
pending y posted

  • Un movimiento pending todavía no está contabilizado. Puede desaparecer o convertirse en posted. Para cerrar el mes, trabaja con posted.
  • Si el banco lo postea con el mismo id, te llega en modified con status: "posted".
  • Si lo postea con un id nuevo, la pendiente te llega en removed y la posteada en added; en el detalle de la pendiente retirada, posted_movement_id apunta a la que la reemplazó.
  • Si el banco la retiró sin más, llega en removed.

​
Si recibes 410 cursor_expired

Tu cursor es más antiguo que la retención de cambios (400 días) y pudo perder cambios ya purgados. Vuelve al paso 1: sincroniza sin cursor y reconstruye la copia. No intentes “arreglar” el cursor.

​
Idempotencia

Aplicar una página dos veces no rompe nada si usas el id del movimiento como llave: added hace upsert, modified reemplaza y removed es idempotente.