> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vitawallet.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Conciliación y reportes automáticos

> Automatiza la conciliación contable con webhooks y endpoints de lectura.

Equipos de finanzas y de producto necesitan que los movimientos lleguen solos a su sistema contable o a su panel. Con las llamadas de lectura y los webhooks automatizas ese trabajo y eliminas el polling manual.

## Flujo

```mermaid theme={null}
sequenceDiagram
  participant Ops as Tu equipo / sistema
  participant Vita as Vita API
  participant Accounting as Sistema contable

  loop Al iniciar el día
    Ops->>Vita: GET /wallets/{uuid}
    Vita-->>Ops: Saldos actuales
    Ops->>Vita: GET /transactions (desde última conciliación)
    Vita-->>Ops: Lista paginada
    Ops->>Accounting: Vuelca movimientos
  end
  Vita-->>Ops: Webhook (evento en tiempo real)
  Ops->>Ops: Deduplica por event_id
  Ops->>Accounting: Marca el movimiento
  Ops->>Vita: GET /events (debug / audit)
```

## Paso a paso

**1. Lee saldos**

`GET /wallets/{uuid}` devuelve el saldo disponible en tiempo real de cada wallet.

**2. Lista movimientos**

`GET /transactions` con filtros y paginación, o `GET /transactions/get_all_transactions` para la vista completa.

**3. Recibe eventos**

Configura la URL con `PUT /webhooks` y elige las categorías. **Valida siempre la firma** antes de procesar.

**4. Revisa entregas**

`GET /events` muestra los últimos eventos y si tu servidor respondió `200`. Útil para depurar entregas fallidas.

## Buenas prácticas

> [!TIP]
>
> **Deduplica con `event_id`**, tratándolo como texto opaco. No asumas formato.

> [!TIP]
>
> **Responde `200` rápido** y procesa en segundo plano. Vita retiene y reintenta si tu servidor tarda; aprovecha la ventana corta.

> [!TIP]
>
> Programa una **conciliación nocturna** que compare tu ledger con `GET /transactions`. Las discrepancias se arrastran si no las detectas pronto.

## Patrón recomendado

**1. Fuente de verdad**

Trata tu propia base de datos como la fuente de verdad para saldos por cliente final, y la API como la fuente de verdad para saldos de la empresa.

**2. Timestamps**

Guarda `created_at` del evento para reconstruir la línea de tiempo exacta si hay que investigar.

**3. Reintentos**

Si un webhook falla, `GET /events` te permite replayar los últimos 10 — no hace falta tu propia cola.

## Endpoints clave

> [card] [Saldos](https://docs.vitawallet.io/api-reference/user-information/overview.md)
>
> `GET /wallets/{uuid}`

> [card] [Lista de transacciones](https://docs.vitawallet.io/api-reference/transactions/overview.md)
>
> `GET /transactions` / `GET /transactions/get_all_transactions`

> [card] [Configurar webhook](https://docs.vitawallet.io/api-reference/webhooks/overview.md)
>
> `PUT /webhooks`

> [card] [Historial de eventos](https://docs.vitawallet.io/api-reference/webhooks/overview.md)
>
> `GET /events`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.