# FinUp Docs

> Guías de uso de FinUp para comercios y referencia de la API para integraciones.

- [FinUp Docs](https://docs.finup.ar/index.md): Guías de uso de FinUp para comercios y referencia de la API para integraciones.
- [Guía de uso](https://docs.finup.ar/guia/index.md): Índice de las guías para usar FinUp en el día a día del negocio.
- [Primeros pasos](https://docs.finup.ar/guia/primeros-pasos.md): Cómo ingresar a FinUp y dejar el negocio listo para otorgar el primer crédito.
- [Clientes](https://docs.finup.ar/guia/clientes.md): Alta, edición y verificación de clientes por DNI (ARCA y BCRA).
- [Créditos y cuotas](https://docs.finup.ar/guia/creditos-y-cuotas.md): Cómo se arma un crédito, cómo se calculan las cuotas y cómo se refinancia.
- [Pagos](https://docs.finup.ar/guia/pagos.md): Registrar pagos totales o parciales, movimientos y comprobantes.
- [Configuraciones de crédito](https://docs.finup.ar/guia/configuraciones.md): Creá, editá, duplicá y activá/desactivá los planes de crédito del negocio.
- [Sucursales](https://docs.finup.ar/guia/sucursales.md): Organizá el negocio por sucursal para separar créditos, pagos y reportes.
- [Usuarios y roles](https://docs.finup.ar/guia/usuarios-y-roles.md): Invitá a tu equipo y asigná roles de encargado o empleado.
- [Reportes y exportaciones](https://docs.finup.ar/guia/reportes.md): Cuánto prestaste, cuánto cobraste y cuánto falta cobrar.
- [Auditoría](https://docs.finup.ar/guia/auditoria.md): El registro de quién creó, cambió o eliminó cada dato.
- [Cuenta de prueba](https://docs.finup.ar/guia/cuenta-de-prueba.md): Cómo reconocer un negocio de demostración (testing) dentro de FinUp.
- [Claves API](https://docs.finup.ar/guia/api-keys.md): Crear y gestionar API keys para conectar FinUp con otros sistemas (ERP, CRM, scripts).
- [API de FinUp](https://docs.finup.ar/api/index.md): Conectá sistemas externos a un negocio de FinUp con una API key.
- [Quickstart](https://docs.finup.ar/api/quickstart.md): De cero a tu primera llamada autenticada a la API de FinUp.
- [Authentication](https://docs.finup.ar/api/authentication.md): Cómo autenticar requests con una API key del negocio y qué alcance tiene.
- [Convenciones y errores](https://docs.finup.ar/api/conventions.md): Formato de datos, paginación, fechas y códigos de error de la API.
- [Flujo: clientes y créditos](https://docs.finup.ar/api/flujo-clientes-y-creditos.md): Alta de cliente, verificación ARCA/BCRA y creación de un crédito con sus cuotas.
- [Flujo: pagos](https://docs.finup.ar/api/flujo-pagos.md): Registrar un pago (total o parcial) y leer los movimientos de un crédito.
- [Flujo: claves API](https://docs.finup.ar/api/flujo-api-keys.md): Cómo se administran las claves (desde la app) y cómo se usan en las integraciones.
- [Listar clientes](https://docs.finup.ar/api-reference/clientes/listar-clientes.md): Lista paginada de clientes del negocio, ordenada por fecha de creación (descendente). Usa `cursor` con el `nextCursor` de la respuesta anterior.
- [Crear cliente](https://docs.finup.ar/api-reference/clientes/crear-cliente.md): Crea un cliente. El `dni` es obligatorio y único por negocio.
- [Obtener cliente](https://docs.finup.ar/api-reference/clientes/obtener-cliente.md): Devuelve el cliente junto con sus créditos, cuotas, movimientos y archivos.
- [Editar cliente](https://docs.finup.ar/api-reference/clientes/editar-cliente.md): Actualiza los campos enviados (los omitidos no cambian).
- [Eliminar cliente](https://docs.finup.ar/api-reference/clientes/eliminar-cliente.md): Requiere **acceso total** (una clave de solo lectura recibe 403).
- [Listar créditos de un cliente](https://docs.finup.ar/api-reference/créditos/listar-créditos-de-un-cliente.md)
- [Crear crédito](https://docs.finup.ar/api-reference/créditos/crear-crédito.md): Genera un crédito y sus cuotas a partir de un plan (configuración). Las cuotas se calculan con la configuración elegida.
- [Listar cuotas de un crédito](https://docs.finup.ar/api-reference/créditos/listar-cuotas-de-un-crédito.md)
- [Marcar crédito como refinanciado](https://docs.finup.ar/api-reference/créditos/marcar-crédito-como-refinanciado.md): Requiere **acceso total**.
- [Registrar un pago](https://docs.finup.ar/api-reference/pagos/registrar-un-pago.md): Registra un pago (total o parcial) sobre una cuota y recalcula los estados de la cuota y del crédito. Requiere **acceso total**.
- [Movimientos de un crédito](https://docs.finup.ar/api-reference/pagos/movimientos-de-un-crédito.md): Movimientos (cuotas, punitorios y pagos) de todas las cuotas del crédito.
- [Listar planes de crédito](https://docs.finup.ar/api-reference/configuraciones/listar-planes-de-crédito.md)
- [Crear plan de crédito](https://docs.finup.ar/api-reference/configuraciones/crear-plan-de-crédito.md): Requiere **acceso total**.
- [Editar plan de crédito](https://docs.finup.ar/api-reference/configuraciones/editar-plan-de-crédito.md): Actualiza los campos enviados (por ejemplo `is_active` para activar/desactivar). Requiere **acceso total**.
- [Listar sucursales](https://docs.finup.ar/api-reference/sucursales/listar-sucursales.md)
- [Crear sucursal](https://docs.finup.ar/api-reference/sucursales/crear-sucursal.md): Requiere **acceso total**.
- [Editar sucursal](https://docs.finup.ar/api-reference/sucursales/editar-sucursal.md): Requiere **acceso total**.
- [Eliminar sucursal](https://docs.finup.ar/api-reference/sucursales/eliminar-sucursal.md): Baja lógica. Requiere **acceso total**.
- [Listar usuarios](https://docs.finup.ar/api-reference/usuarios/listar-usuarios.md)
- [Crear usuario](https://docs.finup.ar/api-reference/usuarios/crear-usuario.md): El email debe tener ya un AuthUser (la persona inició sesión alguna vez). Requiere **acceso total**.
- [Editar usuario](https://docs.finup.ar/api-reference/usuarios/editar-usuario.md): Requiere **acceso total**.
- [Eliminar usuario](https://docs.finup.ar/api-reference/usuarios/eliminar-usuario.md): Requiere **acceso total**.
- [Reporte de créditos](https://docs.finup.ar/api-reference/reportes/reporte-de-créditos.md)
- [Reporte de pagos](https://docs.finup.ar/api-reference/reportes/reporte-de-pagos.md)
- [Resumen del negocio](https://docs.finup.ar/api-reference/reportes/resumen-del-negocio.md)
- [Listar registros de auditoría](https://docs.finup.ar/api-reference/auditoría/listar-registros-de-auditoría.md)
- [Consultar persona en ARCA y BCRA](https://docs.finup.ar/api-reference/verificación/consultar-persona-en-arca-y-bcra.md): Resuelve una persona por DNI (o CUIT/CUIL) consultando ARCA (constancia de inscripción) y el BCRA, sin persistir nada. Para verificar y guardar el snapshot de un cliente usá `POST /api/clients/{id}/verification`.
- [Última verificación del cliente](https://docs.finup.ar/api-reference/verificación/última-verificación-del-cliente.md)
- [Verificar cliente (ARCA + BCRA)](https://docs.finup.ar/api-reference/verificación/verificar-cliente-arca-+-bcra.md): Corre una consulta nueva y guarda el snapshot en la ficha del cliente. Requiere **acceso total**.
- [Listar archivos del cliente](https://docs.finup.ar/api-reference/archivos/listar-archivos-del-cliente.md)
- [Subir archivo](https://docs.finup.ar/api-reference/archivos/subir-archivo.md): Subida multipart (`multipart/form-data`) con el campo `file`. Requiere **acceso total**.
- [Eliminar archivo](https://docs.finup.ar/api-reference/archivos/eliminar-archivo.md): Requiere **acceso total**.
- [Descargar archivo](https://docs.finup.ar/api-reference/archivos/descargar-archivo.md): Devuelve el contenido del archivo.
- [Listar API keys](https://docs.finup.ar/api-reference/api-keys/listar-api-keys.md): Requiere un usuario **encargado** (no se puede administrar claves con otra clave).
- [Crear API key](https://docs.finup.ar/api-reference/api-keys/crear-api-key.md): Devuelve el secreto **una sola vez** en el campo `key`. Requiere un usuario **encargado**.
- [Revocar API key](https://docs.finup.ar/api-reference/api-keys/revocar-api-key.md): Revoca la clave (baja lógica). Cualquier integración que la use deja de funcionar de inmediato. Requiere un usuario **encargado**.

## OpenAPI Specs

- [openapi](/openapi.json)