# Actualizar contacto por ID
Source: https://docs.fint.app/api-reference/contactos/actualizar-contacto-por-id
patch /contact/:contactId
Actualizar detalles de contacto por ID
# Agregar o eliminar items a un contacto
Source: https://docs.fint.app/api-reference/contactos/agregar-o-eliminar-items-a-un-contacto
post /contact/:contactId/item
Agregar o eliminar items a un contacto, estos items luego se usaran para generar facturas en las liquidaciones
# Agregar o eliminar items a un contacto por documento
Source: https://docs.fint.app/api-reference/contactos/agregar-o-eliminar-items-a-un-contacto-por-documento
post /contact/document/:document/item
Agregar o eliminar items a un contacto por documento, si el contacto no existe no se agregara el item, si existe mas de un contacto con el mismo documento no se agregara el item a ninguno.
Estos items luego se usaran para generar facturas en las liquidaciones
# Agregar o eliminar tags a un contacto por documento
Source: https://docs.fint.app/api-reference/contactos/agregar-o-eliminar-tags-a-un-contacto-por-documento
post /contact/document/:document/tag
Agregar o eliminar tags a un contacto por documento, si el contacto no existe o existe mas de un contacto con el mismo documento no se agregara ni eliminara ningun tag.
Estos tags sirven para clasificar los contactos y luego poder filtrarlos por tags
# Agregar o eliminar tags a un contacto por id
Source: https://docs.fint.app/api-reference/contactos/agregar-o-eliminar-tags-a-un-contacto-por-id
post /contact/:contactId/tag
Agregar o eliminar tags a un contacto por id.
# Crear Estado Activo
Source: https://docs.fint.app/api-reference/contactos/crear-estado-activo
post /contact/active/status
Permite crear un estado activo nuevo, este puede utilizarse para describir detalladamente la condición actual del contacto y si esta activo o no en la plataforma.
# Crear un nuevo contacto
Source: https://docs.fint.app/api-reference/contactos/crear-un-nuevo-contacto
post /contact
Crear un nuevo contacto
# Crear una nota para un contacto
Source: https://docs.fint.app/api-reference/contactos/crear-una-nota-para-un-contacto
post /contact/:contactId([0-9]+)/note
Crear una nota para un contacto
# Eliminar contacto por ID
Source: https://docs.fint.app/api-reference/contactos/eliminar-contacto-por-id
delete /contact/:contactId
Eliminar el contact eliminara todas las facturas pendientes de pago asociadas al mismo.
# Eliminar una nota de un contacto
Source: https://docs.fint.app/api-reference/contactos/eliminar-una-nota-de-un-contacto
delete /contact/note/:noteId([0-9]+)
Eliminar una nota de un contacto
# Obtener contacto por ID
Source: https://docs.fint.app/api-reference/contactos/obtener-contacto-por-id
get /contact/:contactId
Obtener detalles de contacto por ID
# Obtener contacto por referencia externa
Source: https://docs.fint.app/api-reference/contactos/obtener-contacto-por-referencia-externa
get /contact/external-reference/:externalReference
Obtener detalles de contacto por referencia externa
# Obtener contactos paginados
Source: https://docs.fint.app/api-reference/contactos/obtener-contactos-paginados
get /contact
Obtener contactos paginados
# Obtener estados activos para contactos
Source: https://docs.fint.app/api-reference/contactos/obtener-estados-activos-para-contactos
get /contact/active/status
Obtener los posibles estados activos para los contactos, con el id del estado podemos actualizar el contacto para desactivarlo / activarlo
# Crear nueva etiqueta
Source: https://docs.fint.app/api-reference/etiquetas/crear-nueva-etiqueta
post /tag
Crear una nueva etiqueta con la información proporcionada
# Obtener etiquetas paginadas
Source: https://docs.fint.app/api-reference/etiquetas/obtener-etiquetas-paginadas
get /tag
Recuperar una lista paginada de etiquetas con filtrado y ordenamiento opcional
# Actualizar información del asistente del ticket
Source: https://docs.fint.app/api-reference/eventos/actualizar-información-del-asistente-del-ticket
put /event/ticket/reference/{reference}
Actualizar la información del asistente de un ticket de evento, incluyendo datos personales y respuestas a campos personalizados. Permite actualizar campos existentes (con id) y crear nuevas respuestas para campos agregados después de la compra (sin id).
# Buscar compras por email del comprador
Source: https://docs.fint.app/api-reference/eventos/buscar-compras-por-email-del-comprador
get /event/purchase/email/{email}
Buscar todas las compras donde el comprador tiene el email especificado. Incluye la lista de asistentes/tickets para cada compra.
# Buscar compras por payment ID
Source: https://docs.fint.app/api-reference/eventos/buscar-compras-por-payment-id
get /event/purchase/payment/{paymentId}
Buscar todas las compras de tickets asociadas a un paymentId. Incluye la lista de asistentes/tickets para cada compra.
# Buscar tickets por email del asistente
Source: https://docs.fint.app/api-reference/eventos/buscar-tickets-por-email-del-asistente
get /event/ticket/email/{email}
Buscar todos los tickets donde el asistente tiene el email especificado. Útil para que los usuarios puedan encontrar todos sus tickets.
# Crear tickets manualmente (Admin)
Source: https://docs.fint.app/api-reference/eventos/crear-tickets-manualmente-admin
post /event/checkout/ticket
Crear tickets de evento manualmente con información del comprador y asistentes. Este endpoint permite a los administradores crear tickets sin pasar por el proceso de checkout normal.
# Obtener campos personalizados de un evento
Source: https://docs.fint.app/api-reference/eventos/obtener-campos-personalizados-de-un-evento
get /event/page/{eventPageId}/custom-fields
Obtener todos los campos personalizados disponibles para un evento. Útil para conocer qué campos se pueden agregar a los tickets.
# Obtener ticket de evento por referencia
Source: https://docs.fint.app/api-reference/eventos/obtener-ticket-de-evento-por-referencia
get /event/ticket/reference/{reference}
Obtener información detallada de un ticket de evento usando su referencia única
# Crear una nueva factura
Source: https://docs.fint.app/api-reference/facturas/crear-una-nueva-factura
post /invoice
Crear una nueva factura con la posibilidad de crear un contacto nuevo o usar uno existente
# Eliminar una factura
Source: https://docs.fint.app/api-reference/facturas/eliminar-una-factura
delete /invoice/{invoiceId}
Eliminar una factura por su ID
# Obtener facturas paginadas
Source: https://docs.fint.app/api-reference/facturas/obtener-facturas-paginadas
get /invoice
Obtener facturas paginadas
# Obtener una factura por ID
Source: https://docs.fint.app/api-reference/facturas/obtener-una-factura-por-id
get /invoice/{invoiceId}
Obtener una factura por su ID
# API Reference
Source: https://docs.fint.app/api-reference/introduction
Documentación completa de los endpoints de la API de Fint
Esta referencia es generada automáticamente a partir de nuestra [especificación OpenAPI](https://dev.api.fint.app/api/v1/api-docs). Acá encontrás el detalle de cada endpoint: parámetros, cuerpo de la solicitud, respuestas posibles y ejemplos.
Si es tu primera vez integrando con Fint, te recomendamos empezar por la [Guía para Desarrolladores](/developers/introduction) donde explicamos autenticación, conceptos clave y casos de uso comunes.
## Autenticación
Todos los endpoints requieren el header `x-api-key` con tu API Key:
```bash theme={null}
curl -X GET "https://api.fint.app/api/v1/health" \
-H "x-api-key: TU_API_KEY"
```
Podés obtener tu API Key desde [Configuración > Desarrolladores](https://admin.fint.app/settings/developers/api-keys) en tu panel de Fint.
## Recursos disponibles
Creá, actualizá y gestioná los contactos de tu organización.
Generá facturas y consultá su estado.
Consultá el detalle de los pagos recibidos.
Gestioná eventos y la venta de tickets.
Configurá notificaciones en tiempo real para tu sistema.
Organizá tus contactos con etiquetas personalizadas.
## Entornos
| Entorno | URL Base |
| ---------- | --------------------------------- |
| Producción | `https://api.fint.app/api/v1` |
| Desarrollo | `https://dev.api.fint.app/api/v1` |
# Obtener pago por ID
Source: https://docs.fint.app/api-reference/pagos/obtener-pago-por-id
get /payment/:paymentId
Obtener detalles de pago por ID
# Actualizar webhook por ID
Source: https://docs.fint.app/api-reference/webhook/actualizar-webhook-por-id
put /webhook/:webhookId
Actualizar detalles del webhook por ID
# Crear un nuevo webhook
Source: https://docs.fint.app/api-reference/webhook/crear-un-nuevo-webhook
post /webhook
Crear un nuevo webhook
# Eliminar webhook por ID
Source: https://docs.fint.app/api-reference/webhook/eliminar-webhook-por-id
delete /webhook/:webhookId
Eliminar un webhook específico por su ID
# Obtener lista de registros de webhook
Source: https://docs.fint.app/api-reference/webhook/obtener-lista-de-registros-de-webhook
get /webhook/log
Registro de cada webhook que se ha enviado en su respectivo estado y evento el cual lo generó
# Obtener lista de webhooks
Source: https://docs.fint.app/api-reference/webhook/obtener-lista-de-webhooks
get /webhook
Obtener lista de webhooks
# Obtener registro de webhook por ID
Source: https://docs.fint.app/api-reference/webhook/obtener-registro-de-webhook-por-id
get /webhook/log/:webhookLogId
Obtener detalles del registro de webhook por ID
# Obtener webhook por ID
Source: https://docs.fint.app/api-reference/webhook/obtener-webhook-por-id
get /webhook/:webhookId
Obtener detalles del webhook por ID
# Estado Activo
Source: https://docs.fint.app/developers/contact/active-status
Controlá manualmente si un contacto está activo o inactivo
A diferencia del [ciclo de vida](/developers/contact/life-cycle) (que es automático), el estado activo lo controlás vos — ya sea desde el panel web o por API.
## Estados predeterminados
Recibe recordatorios, accede al portal de pago y se le generan órdenes en liquidaciones.
No recibe recordatorios, no accede al portal y no se le generan nuevas órdenes.
## Estados personalizados
Además de Activo e Inactivo, podés crear estados personalizados para mayor detalle (ej: "Suspensión temporal", "Egresado", "Licencia"). Cada estado personalizado hereda el comportamiento de Activo o Inactivo.
* Los estados Activo e Inactivo **no se pueden eliminar**
* Un estado personalizado **no se puede eliminar** si tiene contactos asignados
## Cambiar el estado por API
```bash theme={null}
curl -X PUT "https://api.fint.app/api/v1/contacts/{contactId}" \
-H "x-api-key: TU_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "active": false }'
```
El campo `activeStatus` en la respuesta del contacto muestra el estado actual:
```json theme={null}
{
"id": 12345,
"active": true,
"activeStatus": {
"id": 1,
"name": "Activo",
"description": "El contacto está activo"
}
}
```
Obtener, crear y gestionar estados activos via API.
# Contactos
Source: https://docs.fint.app/developers/contact/introduction
El modelo central de Fint: clientes y responsables de pago
En Fint, un **contacto** representa a cualquier persona vinculada a tu organización: puede ser un cliente directo (ej: un alumno) o un responsable de pago (ej: un padre).
Los contactos son el modelo central de la plataforma. Todo lo demás — órdenes, pagos, suscripciones, entradas — se vincula a un contacto.
## Propiedades principales
Cada contacto tiene:
* **Datos personales**: Nombre, apellido, email, documento, teléfono
* **Etiquetas**: Clasificaciones como nivel, turno, carrera (ej: "Primario / 3° A")
* **External reference**: Un ID de tu sistema para mantener la sincronización (ej: `"ALUMNO-12345"`)
* **Portal URL**: Link único al [Portal de Pago](/developers/contact/portal) donde el contacto puede ver y pagar sus deudas
* **Estado del ciclo de vida**: Estado financiero calculado automáticamente (ver [Ciclo de Vida](/developers/contact/life-cycle))
* **Estado activo**: Si el contacto está activo o inactivo, controlado manualmente (ver [Estado Activo](/developers/contact/active-status))
## Crear un contacto
```javascript theme={null}
const response = await fetch('https://api.fint.app/api/v1/contacts', {
method: 'POST',
headers: {
'x-api-key': 'TU_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
firstName: 'Juan',
lastName: 'Pérez',
email: 'juan.perez@email.com',
externalReference: 'ALUMNO-12345'
})
});
```
Crear, obtener, actualizar y eliminar contactos via API.
## Relación con la documentación de usuario
En la documentación de usuario, los contactos se dividen en dos conceptos:
* **Cliente**: El alumno o persona a quien se le factura
* **Responsable de pago**: La persona que paga (puede ser el mismo cliente u otra persona, como un padre)
A nivel de API, ambos son contactos. Un cliente tiene uno o más responsables de pago asociados como `familyMembers`.
# Ciclo de Vida
Source: https://docs.fint.app/developers/contact/life-cycle
Estados financieros automáticos de un contacto
El ciclo de vida refleja la situación financiera actual de un contacto. Los estados se calculan **automáticamente** según sus órdenes — no los controlás vos, los calcula Fint.
Si necesitás controlar manualmente si un contacto está activo o no, usá el [Estado Activo](/developers/contact/active-status) en su lugar.
## Estados
Cuenta creada, todavía no tiene ninguna orden emitida.
Tiene órdenes emitidas pero ninguna venció. Está dentro del plazo de pago.
Al menos una orden superó su fecha de vencimiento sin ser pagada. El contacto está en mora.
Todas las órdenes fueron pagadas. No hay saldos pendientes.
## Transiciones
```mermaid theme={null}
graph LR
A[ACCOUNT_OPENED] -->|Se emite una orden| B[NOT_DUE]
B -->|Orden vence sin pagarse| C[PAST_DUE]
B -->|Se pagan todas| D[ACCOUNT_SETTLED]
C -->|Se pagan todas| D
D -->|Nueva orden emitida| B
```
Los cambios de estado son automáticos:
* Se **crea un contacto** → `ACCOUNT_OPENED`
* Se **emite una orden** → `NOT_DUE`
* Una orden **vence sin pagarse** → `PAST_DUE`
* Se **pagan todas** las órdenes pendientes → `ACCOUNT_SETTLED`
* Se **emite una nueva orden** → vuelve a `NOT_DUE`
Un contacto en `PAST_DUE` se mantiene en ese estado aunque tenga órdenes no vencidas. Basta con que **una sola** orden esté vencida sin pagar.
## Webhook
Podés recibir notificaciones de cambios de estado configurando un webhook para el evento `contact.status`. Ver [Tipos de Eventos](/developers/webhooks/4_events).
# Portal de Pago
Source: https://docs.fint.app/developers/contact/portal
Acceso al portal de autoservicio de cada contacto via API
El portal de pago es una página web personalizada donde cada contacto puede ver sus deudas, pagar online y descargar comprobantes. Cada contacto tiene una **URL única** que podés obtener por API.
## Obtener la URL del portal
Hacé una petición GET para obtener los datos del contacto. La respuesta incluye el campo `portalUrl`:
```json theme={null}
{
"id": 15678,
"firstName": "Martín",
"lastName": "Gómez",
"portalUrl": "https://tuinstitucion.fint.app/?pid=a1b2c3d4e5f6",
"familyMembers": [
{
"id": 25689,
"firstName": "Laura",
"lastName": "Fernández",
"portalUrl": "https://tuinstitucion.fint.app/?pid=x9y8z7w6v5u4"
}
]
}
```
Cada contacto y cada miembro de la familia tiene su propia `portalUrl`. Usá esa URL directamente para redirigir al usuario a su portal.
## Métodos de acceso
Hay dos formas en que un contacto puede acceder al portal:
* **Link directo**: Compartido por email, WhatsApp o generado vía API con la `portalUrl`
* **Portal general**: El contacto entra al portal de la organización (`tuinstitucion.fint.app`) y se identifica con su número de documento
## Funcionalidades del portal
* Ver saldo pendiente y facturas vencidas
* Pagar una, varias o todas las facturas
* Descargar comprobantes de pago (PDF)
* Actualizar datos personales (email, teléfono, dirección de facturación)
El portal no requiere registro ni contraseña. El acceso es por link único o identificación por documento.
# Guía para Desarrolladores
Source: https://docs.fint.app/developers/introduction
Integra Fint con tus sistemas mediante nuestra API
Fint ofrece una API REST completa para integrar la gestión de cobranzas con tus sistemas existentes: ERPs, sistemas académicos, CRMs y más.
## Primeros Pasos
Accedé a [Configuración > Desarrolladores](https://admin.fint.app/settings/developers/api-keys) en tu panel de Fint y creá una nueva API Key.
Incluí tu API Key en el header `x-api-key` de cada solicitud.
Probá la conexión con el endpoint de health check.
## Autenticación
Todos los endpoints requieren autenticación mediante API Key:
```bash theme={null}
curl -X GET "https://api.fint.app/api/v1/health" \
-H "x-api-key: TU_API_KEY"
```
Nunca expongas tu API Key en código del lado del cliente. Mantené las llamadas a la API en tu backend.
## Conceptos Clave
Los contactos representan a tus clientes y responsables de pago. Aprendé sobre su ciclo de vida y estados.
Recibí notificaciones en tiempo real cuando ocurren eventos en Fint, como pagos completados.
## Casos de Uso Comunes
### Sincronizar clientes desde tu sistema académico
```javascript theme={null}
// Crear un nuevo contacto (cliente)
const response = await fetch('https://api.fint.app/api/v1/contacts', {
method: 'POST',
headers: {
'x-api-key': 'TU_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
firstName: 'Juan',
lastName: 'Pérez',
email: 'juan.perez@email.com',
externalReference: 'CLIENTE-12345' // ID de tu sistema
})
});
```
### Recibir notificaciones de pago
Configurá un [webhook](/developers/webhooks/1_introduction) para recibir eventos cuando un pago se complete:
```json theme={null}
{
"event": "payment.created",
"data": {
"paymentId": "pay_abc123",
"amount": 15000,
"contactId": "con_xyz789"
}
}
```
## Recursos
Documentación completa de endpoints
Configuración y eventos disponibles
Modelo de datos y ciclo de vida
## Entornos
| Entorno | URL Base |
| ---------- | --------------------------------- |
| Producción | `https://api.fint.app/api/v1` |
| Desarrollo | `https://dev.api.fint.app/api/v1` |
## Soporte Técnico
¿Tenés dudas sobre la integración? Escribinos a [soporte@fint.app](mailto:soporte@fint.app) con el asunto "Integración API".
# Introducción
Source: https://docs.fint.app/developers/webhooks/1_introduction
Recibí notificaciones en tiempo real sobre eventos en Fint
Usá webhooks para que tu aplicación reciba notificaciones automáticas cuando algo ocurre en Fint.
## ¿Qué es un webhook?
Un webhook es una llamada HTTP que Fint hace a tu servidor cuando ocurre un evento. Todos los webhooks usan HTTPS y envían un payload en formato JSON.
Podés usar webhooks para:
* Registrar pagos en tu sistema contable
* Sincronizar el estado de deuda de tus clientes
* Enviar notificaciones personalizadas desde tu sistema
* Bloquear o habilitar accesos cuando cambia el estado financiero de un contacto
## Primeros pasos
Implementá un endpoint HTTPS en tu servidor que reciba peticiones POST y responda con un código 2xx.
Desde [Configuración > Desarrolladores > Webhooks](https://admin.fint.app/settings/developers/webhooks) o via la [API de Webhooks](/api-reference/webhook/crear-un-nuevo-webhook), registrá la URL de tu endpoint y seleccioná los eventos que querés escuchar.
Verificá que tu endpoint reciba los eventos correctamente. Podés ver los logs de entrega desde el panel de Fint.
## Estados de entrega
En proceso de entrega, incluyendo reintentos.
Entregado exitosamente (respuesta 2xx).
Falló después de todos los reintentos (7 intentos).
## Herramientas para testing
* **[ngrok](https://ngrok.com/)**: Creá un túnel HTTPS a tu servidor local para probar webhooks en desarrollo.
* **[webhook.site](https://webhook.site/)**: Endpoint de prueba gratuito para inspeccionar los payloads que envía Fint.
# Reintentos y Logs
Source: https://docs.fint.app/developers/webhooks/2_configuration_and_handling
Política de reintentos y sistema de seguimiento de entregas
## Política de reintentos
Si Fint no recibe una respuesta 2xx de tu servidor, reintenta la entrega automáticamente con intervalos escalonados:
| Intento | Tiempo después del evento |
| ------- | ------------------------- |
| 1 | Inmediatamente |
| 2 | 5 minutos |
| 3 | 10 minutos |
| 4 | 15 minutos |
| 5 | 20 minutos |
| 6 | 1 día |
| 7 | 2 días |
Después de 7 intentos fallidos, el webhook queda en estado **Error**.
Tu servidor debe estar preparado para manejar **posibles duplicados**. Podés recibir el mismo evento más de una vez en caso de problemas de red o demoras en la respuesta. Usá el campo `id` del webhook para deduplicar.
## Sistema de logs
Cada webhook genera un log automático en Fint que registra todos los intentos de entrega. Podés consultarlos desde el panel web o por API.
El log tiene tres estados posibles:
* **ongoing**: La entrega está en proceso (incluyendo reintentos pendientes)
* **success**: El webhook se entregó exitosamente
* **error**: Todos los intentos fallaron
```mermaid theme={null}
graph TD
A[Evento generado] -->|Envío del webhook| B(Ongoing)
B -->|Respuesta 2xx| C[Success]
B -->|Fallo en todos los intentos| D[Error]
B -->|Reintento en curso| B
```
Consultá los logs de entrega programáticamente.
# Estructura
Source: https://docs.fint.app/developers/webhooks/3_structure
Formato del payload que recibe tu servidor
Todos los webhooks de Fint comparten la misma estructura base. El campo `data` contiene la información específica de cada tipo de evento.
```typescript theme={null}
interface WebhookBody {
id: string;
event: string;
attempt: number;
timestamp: number;
externalReference: string | null;
data: T;
}
```
## Campos
* **id**: Identificador único del webhook. Usalo para deduplicar eventos en caso de reintentos.
* **event**: Tipo de evento (ej: `payment.created`, `contact.status`).
* **attempt**: Número de intento de entrega (1 a 7).
* **timestamp**: Marca de tiempo en milisegundos (epoch) de cuando se generó el evento.
* **externalReference**: La referencia externa del recurso asociado, si fue definida al crearlo.
* **data**: Objeto con los datos específicos del evento. Ver [Tipos de Eventos](/developers/webhooks/4_events) para la estructura de cada uno.
# Tipos de Eventos
Source: https://docs.fint.app/developers/webhooks/4_events
Eventos disponibles y la estructura de datos de cada uno
Estos son los eventos que podés recibir a través de webhooks.
### `payment.created`
Se dispara cuando se registra un pago, ya sea manual (registrado por un admin) o automático (realizado por el contacto desde el portal).
**Ejemplo de payload:**
```json theme={null}
{
"id": "webhook_local_da7beb710d61463bbd55209538b59a37",
"event": "payment.created",
"attempt": 1,
"timestamp": 1716193401008,
"externalReference": null,
"data": {
"paymentId": 22,
"paymentMethod": "CREDIT_CARD",
"isManual": false,
"invoicesPaid": [
{
"id": 123,
"externalReference": "ref-123",
"uniqueId": "AAA-0000"
}
]
}
}
```
**Estructura de `data`:**
```typescript theme={null}
interface PaymentCreatedData {
paymentId: number;
paymentMethod: string;
isManual: boolean;
invoicesPaid: {
id: number;
externalReference: string | null;
uniqueId: string;
}[];
}
```
**Campos:**
* **paymentId**: ID del pago. Usalo con el endpoint [Obtener pago por ID](/api-reference/pagos/obtener-pago-por-id) para más detalles.
* **paymentMethod**: Método de pago utilizado (ej: `CREDIT_CARD`, `BANK_TRANSFER`, `CASH`)
* **isManual**: `true` si fue registrado manualmente por un admin, `false` si fue online
* **invoicesPaid**: Lista de órdenes pagadas con este pago
* **id**: ID de la orden
* **externalReference**: Referencia externa de la orden, si fue definida
* **uniqueId**: Identificador único en formato `{ContactHash}-{InvoiceNumber}`
### `contact.status`
Se dispara cuando cambia el [estado del ciclo de vida](/developers/contact/life-cycle) de un contacto.
**Ejemplo de payload:**
```json theme={null}
{
"id": "webhook_local_da7beb710d61463bbd55209538b59a37",
"event": "contact.status",
"attempt": 1,
"timestamp": 1716193401008,
"externalReference": null,
"data": {
"contactId": 12345,
"previousStatus": "NOT_DUE",
"newStatus": "PAST_DUE",
"timestamp": 1716193401008,
"invoices": [
{
"invoiceId": 5678,
"totalPending": "150.75",
"expirationDate": "2024-05-20",
"createdDate": "2024-04-20",
"status": "PENDING",
"externalReference": "ref-123"
}
],
"totalPending": "150.75",
"metadata": {},
"externalReference": "ALUMNO-12345"
}
}
```
**Estructura de `data`:**
```typescript theme={null}
interface ContactStatusData {
contactId: number;
previousStatus: 'ACCOUNT_OPENED' | 'NOT_DUE' | 'PAST_DUE' | 'ACCOUNT_SETTLED';
newStatus: 'ACCOUNT_OPENED' | 'NOT_DUE' | 'PAST_DUE' | 'ACCOUNT_SETTLED';
timestamp: number;
invoices?: InvoiceDetail[];
totalPending?: string;
metadata?: any;
externalReference: string | null;
}
interface InvoiceDetail {
invoiceId: number;
totalPending: string;
expirationDate: string;
createdDate: string;
status: 'PENDING' | 'PAID' | 'PARTIALLY_PAID';
externalReference: string | null;
}
```
**Campos:**
* **contactId**: ID del contacto
* **previousStatus / newStatus**: Estado anterior y nuevo (`ACCOUNT_OPENED`, `NOT_DUE`, `PAST_DUE`, `ACCOUNT_SETTLED`)
* **invoices** (opcional): Órdenes vencidas que el contacto adeuda
* **totalPending** (opcional): Suma total de las órdenes pendientes
* **metadata** (opcional): Datos personalizados del contacto
* **externalReference** (opcional): Referencia externa del contacto
Al suscribirte a `contact.status`, recibís una notificación por **cada cambio de estado**.
Más eventos próximamente.
## Ejemplo de implementación
```typescript theme={null}
function handleWebhook(webhookBody: WebhookBody) {
switch (webhookBody.event) {
case "payment.created":
const paymentData = webhookBody.data as PaymentCreatedData;
// Manejar el evento de pago creado
break;
case "contact.status":
const contactStatusData = webhookBody.data as ContactStatusData;
// Manejar el evento de cambio de estado
break;
default:
console.error("Evento desconocido:", webhookBody.event);
}
}
```
# Verificar solicitudes webhooks
Source: https://docs.fint.app/developers/webhooks/5_security
En proceso de construcción.
# App de Admisión
Source: https://docs.fint.app/docs/guides/app-admision
Guía paso a paso para controlar el acceso al evento mediante escaneo de QR
La App de Admisión permite al personal del evento controlar el acceso de los asistentes mediante escaneo de códigos QR. Es una herramienta simple y rápida que funciona desde cualquier dispositivo con cámara.
## Requisitos Previos
Antes de comenzar el día del evento, asegurate de tener:
* **Dispositivo con cámara**: Celular, tablet o computadora con cámara funcional
* **Acceso a internet**: Conexión estable durante todo el evento
* **Credenciales**: Usuario y contraseña proporcionados por el organizador
Mantené el dispositivo cargado durante todo el evento. Te recomendamos tener un cargador portátil a mano.
## Paso 1: Ingresar a la Aplicación
Ingresá a **[https://qr.fint.app/](https://qr.fint.app/)** desde cualquier navegador web. No hace falta instalar nada — la app funciona directo desde el navegador.
Ingresá las credenciales que te proporcionó el organizador:
* **Usuario**: El email de tu cuenta
* **Contraseña**: Tu contraseña
Hacé clic en **"Ingresar"**.
![Pantalla de inicio de sesión]()
Una vez autenticado, verás el panel principal con el evento seleccionado.
Vas a ver el listado de entradas con diferentes estados:
* **Sin registrar** (azul): Entrada válida que aún no ingresó al evento
* **Registrado** (verde): Entrada ya admitida
* **Cancelado** (rojo): Entrada anulada
![Panel principal con listado de entradas]()
## Paso 2: Activar el Escáner
En el panel principal, buscá y hacé clic en el botón **"ESCANEAR"** (generalmente ubicado en la parte inferior de la pantalla).
La primera vez que uses el escáner, el navegador te va a pedir permiso para acceder a la cámara.
Aparecerá un mensaje: *"¿Permitir que la aplicación acceda a la cámara?"*
Seleccioná **"Permitir"** o **"Permitir mientras visitas el sitio"**.
![Solicitud de permisos de cámara]()
La cámara se activará automáticamente y verás una interfaz con un marco para enfocar el código QR.
**Consejos para un escaneo óptimo:**
* Asegurate de tener buena iluminación
* Limpiá la lente de la cámara si está sucia
* Mantené el dispositivo estable al escanear
![Interfaz del escáner QR]()
## Paso 3: Escanear y Verificar Entradas
### Proceso de escaneo
Cuando un asistente llegue al evento:
1. **Pedile que muestre su entrada** con el código QR visible (puede estar en el celular o impresa)
2. **Apuntá la cámara hacia el QR** — no hace falta tocar ningún botón
3. **Mantené el dispositivo estable** hasta que el código sea reconocido
4. El sistema procesará la información automáticamente
### Verificar los datos
Una vez escaneado el código QR, aparecerán en pantalla:
* **Entrada #**: Código único del ticket (ej: TKT-Z2E9S3GCK)
* **Evento**: Nombre del evento
* **Fecha de compra**: Cuándo se adquirió la entrada
* **Asistente**: Nombre, documento y email
* **Comprador**: Quién realizó la compra (puede ser diferente al asistente)
Es normal que el **comprador** y el **asistente** sean personas diferentes. Por ejemplo, un padre puede comprar la entrada para su hijo.
**Verificá que la información coincida con la persona presente** — especialmente el nombre del asistente.
## Paso 4: Admitir al Asistente
### Estados de la entrada
Al escanear, la entrada puede estar en dos estados:
Estado normal de una entrada válida que aún no ingresó. Aparece en **color azul**.
Podés proceder a admitir al asistente.
La entrada ya fue utilizada anteriormente. Aparece en **color verde**.
Esto puede indicar un intento de entrada duplicada.
![Comparación de estados NO ADMITIDA vs ADMITIDA]()
### Confirmar la admisión
Si todo está correcto y el estado es **"NO ADMITIDA"**:
1. Confirmá con el asistente que los datos son correctos
2. Hacé clic en el botón **"ADMITIR"** (o **"Registrar"** según la versión)
3. El sistema actualizará el estado instantáneamente
4. La entrada cambiará a **"ADMITIDA"** (verde)
¡Listo! El asistente puede ingresar al evento. La app queda lista automáticamente para escanear la siguiente entrada.
## Casos Especiales
### Entrada ya utilizada
Si aparece **"YA ADMITIDA"** en verde:
* Informale al asistente que su entrada ya fue registrada previamente
* Verificá los datos del asistente para confirmar que es la persona correcta
* Consultá con tu supervisor si es necesario permitir el acceso de todas formas
Una entrada ya admitida puede indicar que alguien más usó ese QR. Siempre verificá la identidad del portador antes de permitir el ingreso.
### Código QR no válido
Si el código no se reconoce o aparece un error:
* Pedile al asistente que aumente el brillo de la pantalla (si está en el celular)
* Verificá que sea el código QR correcto del evento actual
* Asegurate de tener buena iluminación y enfoque
* Intentá limpiar la pantalla del dispositivo o la lente de la cámara
* Si el QR está muy dañado (impreso y roto), buscá manualmente la entrada por nombre desde el panel principal
### Problemas de conectividad
Si no podés escanear por problemas de internet:
* Verificá que el dispositivo esté conectado a WiFi o tenga datos móviles
* Intentá recargar la página
* Si el problema persiste, contactá al administrador del sistema o al equipo técnico
### Búsqueda manual
Si por algún motivo no podés escanear el QR, podés buscar la entrada manualmente:
1. Volvé al panel principal (cerrá el escáner)
2. Usá el buscador para encontrar la entrada por nombre, email o documento del asistente
3. Hacé clic en la entrada para ver sus detalles
4. Verificá los datos con el asistente
5. Hacé clic en **"Admitir"** desde el detalle
## Consejos para un Día Exitoso
* **Cargá el dispositivo**: Mantené batería suficiente durante todo el evento
* **Verificá identidad**: Siempre confirmá que los datos coincidan con la persona presente
* **Comunicá problemas**: Si encontrás algún inconveniente, avisá inmediatamente a tu supervisor
* **Sé amable**: Una buena experiencia de ingreso marca el tono del evento
## Contacto y Soporte
Si tenés dudas técnicas o problemas con la aplicación durante el evento:
* **Soporte Fint**: +54 9 11 2405-8816
* **Equipo técnico del evento**: Contactá al coordinador del evento
## Próximos Pasos
Conocé cómo crear y gestionar eventos
Configurá tipos de entradas
Enviá comunicaciones a asistentes
# Clientes
Source: https://docs.fint.app/docs/guides/clientes
Gestioná clientes, responsables de pago y su información
Acá gestionás a todos tus clientes: datos personales, etiquetas, items asignados y estado financiero.
Si tenés activado el módulo de **Cuotas institucionales** (en [Funcionalidades](/docs/guides/configuracion#funcionalidades)), este módulo se llama **Estudiantes** en toda la aplicación. Es el mismo módulo — solo cambia el nombre.
![Listado de clientes con etiquetas y estado financiero]()
## Crear Clientes
Para crear un cliente necesitás su **nombre y apellido**, y al menos un identificador: **email** o **documento** (DNI, CUIT, pasaporte, entre otros).
![Formulario de creación manual de un cliente]()
Si ya existe un cliente con el mismo email o documento, el sistema no permite crear un duplicado.
Importá múltiples clientes desde un archivo **Excel o CSV**.
Usá el botón **"Descargar modelo de Excel"** para obtener la plantilla con las columnas correctas.
Organizá los datos en columnas: nombre, apellido, email, documento, etc.
Desde el módulo de Clientes, hacé clic en **"+ Crear" > "Importar excel"** y seleccioná tu archivo.
Verificá que los datos se hayan mapeado correctamente antes de confirmar.
![Modal de importación de clientes desde Excel]()
Podés activar la opción **"Enviar email de bienvenida"** para que cada cliente importado reciba automáticamente un email con el enlace a su [Portal de Contacto](/docs/guides/portal-contacto).
Exportá tu listado de clientes a **Excel** con filtros opcionales por etiquetas, condición (activo/inactivo) o items asignados.
## Perfil del Cliente
Al hacer clic en un cliente, accedés a su perfil completo:
![Perfil del cliente: detalle, items y familia asociada]()
* **Detalle**: Información personal (nombre, documento, email, teléfono, etiquetas) y dos indicadores clave: la **condición** (que controlás vos) y el **estado** financiero (calculado automáticamente).
* **Items**: Los [items y descuentos](/docs/guides/items-descuentos) asignados para el período seleccionado. Desde acá podés asignar nuevos.
* **Familia asociada**: Clientes relacionados (ej: hermanos en la misma institución). Permite vincular clientes entre sí para gestionar las cuentas compartidas de una familia.
* **Contactos**: Los **responsables de pago** del cliente (ej: papá, mamá). Un cliente puede ser su propio responsable o tener múltiples. Sus datos son esenciales para la [facturación con ARCA](/docs/guides/facturacion-arca) y para el acceso al [Portal de Contacto](/docs/guides/portal-contacto).
* **Órdenes**: Historial de todas las solicitudes de pago del cliente.
![Familia asociada, contactos responsables de pago y órdenes del cliente]()
* **Actividad**: Registro cronológico de todas las acciones realizadas sobre el cliente.
* **Notas**: Comentarios internos visibles solo para el equipo administrativo.
## Condición y Baja
La **condición** del cliente la controlás vos manualmente:
* **Activo**: Recibe recordatorios, accede al portal y se le generan facturas.
* **Inactivo**: No recibe recordatorios, no accede al portal y no se le generan nuevas facturas.
La baja es **reversible**: si el cliente vuelve, lo reactivás y recupera todo su historial.
## Estado Financiero
El **estado** se calcula automáticamente según las facturas del cliente:
Todas sus facturas están pagadas
Tiene facturas emitidas pero no vencidas
Tiene facturas vencidas sin pagar
## Próximos Pasos
Configurá qué se les cobra
Generá facturas para tus clientes
Donde los contactos pagan
# Conciliar un ingreso
Source: https://docs.fint.app/docs/guides/conciliacion-bancaria
Asigná un ingreso bancario a su responsable y conciliá una orden por el mismo importe
La conciliación bancaria permite relacionar movimientos del extracto con las órdenes y los pagos de Fint.
En este recorrido, una transferencia de **\$75.000,00** paga una única orden por el mismo importe.
Al completar el flujo, Fint registra un pago por transferencia, deja la orden como **Pagada** y cambia el movimiento a **Conciliada**.
```mermaid theme={null}
flowchart LR
A[En revisión] --> B[Asignar responsable]
B --> C[Con sugerencias]
C --> D[Revisar orden recomendada]
D --> E[Conciliar]
E --> F[Conciliada y pago asociado]
```
## Antes de empezar
Esta guía parte de un movimiento que ya aparece en **Conciliación**.
Si todavía no preparaste el origen, consultá [Configurar una cuenta bancaria](/docs/guides/conciliacion-bancaria-cuentas) y [Subir y seguir un extracto](/docs/guides/conciliacion-bancaria-extractos).
Para seguir el ejemplo, necesitás:
* La funcionalidad **Conciliación** activada en **Configuración → Funcionalidades**.
* Acceso de **Administrador**. Este primer recorrido no documenta otros roles.
* Una transferencia entrante en estado **En revisión**.
* Un responsable de pago cargado. En este caso, Carolina Rodríguez es responsable de Sofía Rodríguez.
* Una orden **Por Cobrar** cuyo pendiente coincida con la transferencia. En el ejemplo, es **Cuota de agosto 2026** por **\$75.000,00**.
Podés consultar cómo administrar responsables en [Clientes](/docs/guides/clientes).
Para revisar órdenes, consultá [Órdenes y Liquidaciones](/docs/guides/solicitudes-pago).
## Conciliar un ingreso exacto
Entrá a **Conciliación → Movimientos** y elegí la transferencia de **\$75.000,00**.
El detalle muestra el estado **En revisión** y la sección **Contacto** como **Sin asignar**.
Antes de avanzar, verificá la fecha, el importe y el concepto del movimiento.
![Movimiento de ingreso por setenta y cinco mil pesos en estado En revisión y sin contacto asignado]()
En **Contacto**, presioná el lápiz. Buscá “Rodríguez, Carolina”, elegí el resultado y confirmá con **Seleccionar**.
Después de asignar a Carolina, el movimiento cambia a **Con sugerencias**. Fint muestra **Cuota de agosto 2026** seleccionada y con la etiqueta **Recomendado**.
Comprobá que la orden corresponda a Sofía Rodríguez, continúe **Por Cobrar** y tenga el mismo importe que la transferencia.
El resumen debe indicar **Total a conciliar: \$75.000,00**.
![Orden Cuota de agosto 2026 recomendada y total de setenta y cinco mil pesos listo para conciliar]()
Presioná **Conciliar**. Fint aplica la sugerencia seleccionada y registra el pago.
Revisá el responsable, la orden y el total antes de continuar. En este flujo, **Conciliar** registra la operación sin una confirmación adicional.
El detalle cambia a **Conciliada** y muestra la sección **Pago Asociado**.
Allí vas a ver el medio **Transferencia**, el importe de **\$75.000,00** y el estado **Exitoso**.
La orden **Cuota de agosto 2026** queda **Pagada**.
![Movimiento en estado Conciliada con un pago por transferencia asociado]()
## Qué cambia al conciliar
| Registro | Antes | Después |
| ------------- | ------------------------------------- | ------------------------------- |
| Movimiento | **En revisión** o **Con sugerencias** | **Conciliada** |
| Orden | **Por Cobrar** | **Pagada** |
| Pago asociado | Sin pago | **Transferencia** · **Exitoso** |
## Alcance de esta guía
Este recorrido cubre una sola transferencia aplicada a una única orden por el importe exacto.
Consultá [Casos frecuentes de conciliación bancaria](/docs/guides/conciliacion-bancaria-casos-frecuentes) para transferencias que reúnen varias órdenes, mora puntual o movimientos que no aparecen.
Quedan fuera de esta primera guía:
* Deudas de varios períodos y mora sobre órdenes parcialmente pagadas.
* Pagos parciales y diferencias de importe.
* Otras sugerencias y reglas automáticas.
* La creación de órdenes desde un movimiento, la vinculación de pagos existentes y la reversión.
* Egresos, roles y permisos.
## Próximos pasos
Varias personas, mora y movimientos que no aparecen
Importá movimientos y seguí su revisión
Revisá el saldo y el estado de cada cobro
# Casos frecuentes de conciliación bancaria
Source: https://docs.fint.app/docs/guides/conciliacion-bancaria-casos-frecuentes
Resolvé transferencias que cubren varias órdenes, mora puntual y movimientos que no aparecen
Esta guía amplía el [recorrido básico de conciliación bancaria](/docs/guides/conciliacion-bancaria) con situaciones frecuentes.
Antes de conciliar, verificá siempre el responsable, las personas alcanzadas, las órdenes seleccionadas y el **Total a conciliar**.
## Una transferencia cubre órdenes de dos personas
Una persona puede transferir el total de órdenes que pertenecen a distintos integrantes de una familia.
Para conciliarlas juntas, ambas personas deben estar vinculadas al mismo responsable de pago en Fint.
Abrí el movimiento y asigná a la persona que realizó el pago.
Fint reúne las órdenes pendientes de todas las personas vinculadas a ese responsable. Cada orden indica a quién pertenece.
Seleccioná únicamente las órdenes incluidas en la transferencia.
Si Fint encuentra una combinación exacta, puede mostrarlas ya seleccionadas con la etiqueta **Recomendado**.
En este ejemplo, las órdenes de **\$40.000,00** y **\$60.000,00** suman una transferencia de **\$100.000,00**.
![Dos órdenes de personas diferentes seleccionadas para conciliar una transferencia exacta de cien mil pesos]()
Confirmá que **Total a conciliar** coincida con el movimiento y presioná **Conciliar**.
Fint registra un único pago por transferencia, deja ambas órdenes **Pagadas** y cambia el movimiento a **Conciliada**.
Si una orden no aparece, comprobá primero que su titular esté vinculado al responsable asignado y que la orden continúe pendiente. No concilies otra orden solo para completar el importe.
## La fecha del movimiento define la mora
Para una orden pendiente sin pagos anteriores, Fint calcula la mora a la fecha guardada en el movimiento bancario.
La fecha de carga del archivo y el día en que conciliás no reemplazan esa fecha.
| Dato | Fecha del ejemplo | Efecto |
| ----------------------- | -------------------- | --------------------------------------------------- |
| Vencimiento de la cuota | 10 de julio de 2026 | Desde esta fecha se evalúa la configuración de mora |
| Transferencia | 9 de julio de 2026 | No genera mora porque ocurrió antes del vencimiento |
| Carga y conciliación | Días o meses después | No cambia la fecha usada para calcular la mora |
Si la transferencia ocurrió el **13 de julio**, Fint muestra la mora calculada hasta ese día. El importe depende de la configuración de la institución.
Antes de continuar, distinguí por qué querés cambiar el resultado:
* Si la fecha del movimiento es incorrecta, corregila con respaldo del banco.
* Si la fecha es correcta pero la institución decide no cobrar la mora, quitá la mora de esa orden.
### Corregir la fecha de una transferencia
Usá este camino cuando el movimiento quedó fechado después del día en que la persona realmente transfirió.
Si el movimiento ya está **Conciliada**, bajá hasta **Acciones**, presioná **Revertir conciliación** y confirmá.
Fint desvincula el pago y vuelve a dejar disponible la orden. La fecha no se puede cambiar mientras el movimiento continúa conciliado.
En **Detalle**, presioná la fecha, elegí el día respaldado por el extracto o comprobante y agregá el motivo del cambio.
Fint vuelve a calcular las órdenes y la mora con la fecha corregida.
Si una cuota vencía el 10 y la transferencia ocurrió el 9, el total vuelve a ser únicamente el capital.
Comprobá el responsable, la orden y el total antes de presionar **Conciliar** otra vez.
No cambies la fecha para evitar una mora válida. La fecha del movimiento debe coincidir con la evidencia bancaria; para una excepción comercial, usá la quita individual.
### Quitar la mora de una sola orden
Usá este camino cuando la transferencia fue posterior al vencimiento, pero la institución decide no cobrar la mora de esa cuota.
Para que aparezca este desglose, la institución debe tener [intereses por mora configurados](/docs/guides/configuracion#intereses-por-mora) y la orden debe generar mora.
En **Conciliar**, ubicá la orden correcta y la línea **Incluye mora**, que también indica la fecha usada para calcularla.
En el ejemplo, la transferencia es de **\$90.000,00** y la orden suma **\$90.450,00** con mora. Antes de quitarla, el resumen deja **\$450,00** pendientes.
![Orden por noventa mil cuatrocientos cincuenta pesos con cuatrocientos cincuenta pesos de mora calculada al 13 de julio]()
Presioná la cruz junto al importe de mora. Fint vuelve a calcular esa orden y el **Total a conciliar**.
Confirmá que el total coincida con el capital transferido antes de continuar.
Presioná **Conciliar** y verificá el pago asociado y el estado de la orden.
La quita desactiva **Genera mora** en esa orden. No cambia otras órdenes, pero permanece aunque reviertas la conciliación. Si necesitás cobrarla otra vez, abrí la orden y volvé a habilitar **Genera mora**.
## Un movimiento del archivo no aparece
Que el archivo tenga más filas que la pantalla no implica necesariamente que se haya perdido un ingreso.
Revisá estas causas antes de volver a cargar el extracto:
| Qué revisar | Qué sucede | Qué hacer |
| -------------------------------- | -------------------------------------------------------------- | --------------------------------------------------------------------------------- |
| Búsqueda, estado, banco o fechas | El movimiento puede estar oculto | Elegí **Todos**, borrá la búsqueda y usá **Limpiar todo** si hay filtros visibles |
| Mensaje de carga con duplicados | Fint reconoce un movimiento ya importado y no crea otra copia | Buscá el movimiento original por fecha, importe o responsable |
| Fila sin fecha | Fint no puede tratarla como un movimiento | Volvé a exportar el período con fecha e importe completos |
| Fila vacía o con importe cero | No se considera un movimiento bancario | Compará contra las filas que realmente tienen fecha e importe |
| Egreso o débito | Actualmente **Movimientos** muestra solo ingresos conciliables | No vuelvas a importarlo como cobro; revisá el total de egresos en **Extractos** |
La tarjeta del extracto conserva el total de movimientos importados y, cuando existen, los duplicados omitidos y las advertencias. También separa ingresos, egresos y el avance de revisión.
Si sigue faltando un **ingreso válido**, guardá el archivo original y registrá:
* El banco y la cuenta seleccionada.
* El nombre del archivo y la hora de carga.
* La fecha, el importe y el concepto de una fila que no aparece.
* Los movimientos importados, duplicados y advertencias que muestra la tarjeta.
Con esos datos se puede distinguir una fila omitida por el formato, un duplicado o un problema de importación sin volver a cargar el archivo a ciegas.
## Casos que todavía no cubre esta guía
* Una transferencia que deja una orden parcialmente pagada.
* Diferencias que generan un saldo adicional.
* Deudas de varios períodos y mora sobre órdenes parcialmente pagadas.
* Reglas automáticas de identificación y conciliación.
## Próximos pasos
Volvé al recorrido principal paso a paso
Revisá importación, duplicados y avance
Consultá vencimientos, saldos y estados
# Configurar una cuenta bancaria
Source: https://docs.fint.app/docs/guides/conciliacion-bancaria-cuentas
Registrá la cuenta que vas a usar para importar y conciliar movimientos bancarios
Creá una cuenta bancaria para indicarle a Fint de qué banco proviene cada extracto que vas a importar.
Esta configuración no conecta Fint con el banco ni descarga movimientos. Después de crearla, vas a subir cada extracto desde **Conciliación → Extractos**.
## Antes de empezar
Necesitás:
* La funcionalidad **Conciliación** activada en **Configuración → Funcionalidades**.
* Acceso de **Administrador**. Los demás roles no pueden abrir las pantallas ni usar las operaciones de conciliación.
* Un nombre que permita reconocer la cuenta y el banco al que pertenece.
Fint admite extractos de **ICBC**, **Banco Provincia (BAPRO)**, **BBVA**, **Credicoop** y **Banco Patagonia**.
El nombre y el banco son los únicos datos obligatorios. El CBU, el alias, el CUIT, la razón social y la descripción son opcionales.
## Crear la cuenta
Entrá a **Conciliación → Cuentas bancarias** y presioná **Nueva cuenta**.
Completá **Nombre de referencia** y **Banco**.
Usá un nombre que distinga su función y moneda. Por ejemplo: **Cuenta recaudadora ARS**.
Podés completar una descripción, el CBU, el alias, el CUIT del titular y la razón social.
En el ejemplo se usa el alias **colegio.modelo.recaudacion** y la descripción “Cuenta destinada a transferencias de cuotas”. No se cargan datos fiscales ni bancarios reales.
![Formulario de una cuenta recaudadora de ICBC con alias y descripción, sin CBU ni CUIT]()
Activá **Usar como método de pago** solo si la institución también quiere ofrecer esa cuenta al registrar pagos por transferencia.
Esta opción no es necesaria para importar extractos ni para conciliar. En el ejemplo queda desactivada.
Presioná **Crear Cuenta**. La tarjeta muestra el nombre, el banco y los datos opcionales que cargaste.
![Tarjeta de la Cuenta recaudadora ARS de ICBC con alias y descripción]()
## Qué queda configurado
La cuenta aparece como opción al subir un extracto. El banco elegido define la estructura que Fint espera encontrar en el archivo.
Elegí el banco correcto. Si el archivo no respeta la estructura esperada para esa cuenta, la importación puede rechazarse o informar filas que no pudo procesar.
## Editar o eliminar la cuenta
Usá las acciones de la tarjeta para corregir sus datos o eliminarla.
Al eliminar una cuenta, Fint conserva los extractos que ya fueron importados. La eliminación de la cuenta no sirve para borrar esos movimientos.
## Próximos pasos
Importá movimientos y seguí su revisión
Aplicá una transferencia a una orden
Varias personas, mora y filas que no aparecen
# Subir y seguir un extracto
Source: https://docs.fint.app/docs/guides/conciliacion-bancaria-extractos
Importá movimientos bancarios y seguí qué ingresos todavía necesitan revisión
Subí un extracto para convertir sus movimientos en ingresos que puedas revisar y conciliar en Fint.
La tarjeta del archivo separa dos momentos: qué ocurrió durante la **Importación** y cuánto avanzó la **Revisión de ingresos**.
## Antes de empezar
Necesitás:
* La funcionalidad **Conciliación** activada.
* Acceso de **Administrador**.
* Una [cuenta bancaria configurada](/docs/guides/conciliacion-bancaria-cuentas).
* Un extracto del mismo banco que la cuenta, en formato **.xlsx**, **.xls** o **.csv**, de hasta **20 MB**.
## Subir el archivo
Entrá a **Conciliación → Extractos** y presioná **Subir extracto**.
Seleccioná la cuenta bancaria que corresponde al archivo. Fint usa el banco de esa cuenta para interpretarlo.
Arrastrá el archivo al área de carga o hacé clic para buscarlo en tu computadora.
Verificá el nombre antes de continuar. En el ejemplo se usa **extracto-icbc-septiembre-2026.csv** con dos ingresos de cuotas: **\$45.000,00** y **\$55.000,00**.
![Diálogo de carga con la Cuenta recaudadora ARS y un extracto CSV de septiembre seleccionado]()
Presioná **Subir archivo** y esperá a que termine el procesamiento.
Si el archivo continúa en curso, su tarjeta lo indica. No vuelvas a subirlo mientras esperás.
Cuando termina, la tarjeta muestra los importes de ingresos y egresos, el resultado de la importación y el avance de revisión.
**Importación completada** significa que Fint terminó de leer y guardar el archivo. Las sugerencias pueden aparecer poco después, a medida que Fint analiza los ingresos; no tienen un progreso separado.
En el ejemplo se importaron dos movimientos, sin duplicados ni advertencias. La revisión empieza en **0/2**.
![Revisión de ingresos en cero de dos, con dos movimientos importados y cien mil pesos de ingresos]()
## Entender la tarjeta del extracto
* **Importación** resume los movimientos guardados, los duplicados omitidos y las advertencias detectadas al leer el archivo.
* **Revisión de ingresos** muestra cuántos ingresos quedaron conciliados o ignorados sobre el total importado.
* **Ingresos** suma los movimientos entrantes importados.
* **Egresos** suma los movimientos salientes importados.
La revisión cuenta solo ingresos no duplicados. Los egresos no aumentan el total y los duplicados omitidos no se vuelven a revisar.
Un ingreso se considera resuelto cuando queda **Conciliado** o **Ignorado**. Asignar un responsable o recibir una sugerencia no completa la revisión por sí solo.
## Seguir el avance
| Avance | Lectura |
| ------- | ---------------------------------------------------- |
| **0/2** | Hay dos ingresos pendientes de resolver |
| **1/2** | Uno está conciliado o ignorado y queda uno pendiente |
| **2/2** | Los dos ingresos están resueltos |
Después de resolver el primer ingreso, la tarjeta avanza a **1/2**.
![Revisión de ingresos en uno de dos después de conciliar el primer movimiento]()
Al resolver el segundo, llega a **2/2**.
![Revisión de ingresos completa en dos de dos]()
Si hay ingresos ignorados, la tarjeta separa cuántos quedaron **conciliados** y cuántos **ignorados**. Por eso **2/2** no significa necesariamente que los dos hayan generado pagos.
## Revisar los movimientos
Entrá a **Conciliación → Movimientos** para trabajar sobre los ingresos importados.
Para el recorrido principal, seguí [Conciliar un ingreso](/docs/guides/conciliacion-bancaria). Volvé a **Extractos** cuando quieras comprobar el avance general del archivo.
## Si la carga no coincide con lo esperado
| Situación | Qué revisar |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| El archivo sigue procesándose | Esperá a que termine antes de repetir la carga |
| Fint rechaza el formato | Confirmá que elegiste la cuenta correcta y que el archivo respeta la estructura del banco |
| El archivo supera el límite | Exportá un período más corto o reducí el archivo para que no supere 20 MB |
| Aparecen duplicados omitidos | Buscá los movimientos que ya habían sido importados; no repitas la carga a ciegas |
| Aparecen advertencias | Conservá el original y compará sus filas con los movimientos importados |
| Un ingreso no aparece | Revisá filtros, duplicados y filas inválidas en [Casos frecuentes](/docs/guides/conciliacion-bancaria-casos-frecuentes#un-movimiento-del-archivo-no-aparece) |
Podés eliminar un extracto de Fint únicamente cuando terminó de procesarse y ninguno de sus movimientos fue conciliado. La acción también elimina esos movimientos de la vista de Fint y no se puede deshacer.
## Próximos pasos
Asigná un responsable y revisá la orden sugerida
Varias personas, mora y filas que no aparecen
Registrá el origen de otro banco
# Conectar Mercado Pago
Source: https://docs.fint.app/docs/guides/conectar-mercado-pago
Vinculá tu cuenta de Mercado Pago para cobrar online y, en Argentina, con Point o QR
Mercado Pago permite cobrar online en Argentina y Uruguay. En organizaciones de Argentina, también puede habilitar Point o QR en el Punto de Venta. La conexión con Fint se autoriza desde tu cuenta, sin copiar credenciales ni hacer una configuración técnica.
## Antes de empezar
Solo necesitás una **cuenta de Mercado Pago activa** con acceso para iniciar sesión. La moneda de cobro (ARS para Argentina, UYU para Uruguay) queda definida al dar de alta tu organización en Fint.
## Conectar tu cuenta
En **Configuración → Integraciones**, ubicá la tarjeta **Mercado Pago** (aparece como "No conectado") y hacé clic en **"Conectar"**.
![Tarjeta de Mercado Pago en Integraciones]()
Fint te redirige al sitio de Mercado Pago: iniciá sesión con tu cuenta y autorizá la aplicación de Fint.
De vuelta en Fint, hacé clic en **"Autorizar integración"**. Vas a ver el mensaje **"Cuenta conectada exitosamente"** y la tarjeta pasa a estado **Activo**.
Una vez conectada, la tarjeta muestra la **cuenta vinculada**: email, usuario y documento.
El acceso **Configurar plazos y comisión** abre el panel de Mercado Pago, donde definís los plazos de acreditación y consultás sus comisiones.
## Qué cambia al conectar
* Tu organización queda cobrando **online con Mercado Pago**: cuando una familia paga desde el portal, un link de pago o un evento, Fint la redirige al **checkout de Mercado Pago**, donde elige su medio de pago y paga.
* En organizaciones de **Argentina**, la conexión habilita la administración de cajas, dispositivos Point y QR en el **Punto de Venta**. Cada caja todavía debe [asociarse y configurarse](/docs/guides/pos-cajas-dispositivos) antes de que esos medios aparezcan al cobrar.
* Las confirmaciones de pago llegan **automáticamente** — no hay que configurar webhooks ni ningún paso técnico adicional.
* Las comisiones y los plazos de acreditación de Mercado Pago se consultan y gestionan desde su panel.
## Desconectar o reconectar
Desde la misma tarjeta podés **Desconectar** la cuenta. Fint pide confirmación y deja de procesar pagos con Mercado Pago. Esto incluye los cobros online y, si tu organización usa Point o QR, los cobros desde las cajas presenciales. Podés volver a conectar la misma cuenta u otra cuando quieras.
Si la autorización deja de ser válida, Fint avisa a los administradores por email. Entrá a **Integraciones**, desconectá la cuenta y volvé a conectarla.
## Próximos Pasos
Donde las familias pagan online
Vendé online cobrando con MP
Seguimiento de los cobros
Point y QR para organizaciones de Argentina
# Configuración
Source: https://docs.fint.app/docs/guides/configuracion
Personalizá tu organización, equipo, cobranzas e integraciones
Desde Configuración gestionás todo lo que define cómo funciona tu organización en Fint: datos de contacto, marca, equipo, recordatorios, intereses, integraciones y más.
## General
### Organización
* **Nombre de la organización**: Nombre interno para identificar el proyecto. No es visible para tus usuarios.
* **Información de soporte**: El email de soporte, el email de respuesta (reply to) y el número de WhatsApp que aparecen en mensajes, recordatorios y en el [Portal de Contacto](/docs/guides/portal-contacto).
* **URL personalizada**: Tu subdominio en Fint (ej: `tuinstitucion.fint.app`). Es donde tus usuarios ven sus pagos, mensajes y datos de facturación.
![Configuración general: nombre de la organización, información de soporte y URL personalizada]()
### Marca
* **Nombre de fantasía**: El nombre que ven tus usuarios en el portal y en las comunicaciones.
* **Logo**: La imagen que acompaña tu marca. Aparece en emails, portal y página de eventos.
![Sección Marca: nombre de fantasía y logo]()
Configurá la marca antes de enviar comunicaciones o publicar eventos. Es lo primero que ven tus usuarios.
## Etiquetas
Las etiquetas te permiten clasificar a tus clientes por grupo, nivel, turno, carrera o cualquier criterio que necesites. Se organizan en **grupos** que contienen **etiquetas individuales**.
Por ejemplo: un grupo "Nivel" con etiquetas "Inicial", "Primario", "Secundario". O un grupo "Turno" con "Mañana", "Tarde", "Noche".
Cada etiqueta muestra la cantidad de clientes que la tienen asignada, lo que te permite ver de un vistazo cómo está distribuida tu base.
![Etiquetas: grupo Nivel con las etiquetas Inicial, Primario y Secundario]()
Las etiquetas son fundamentales para gestionar correctamente las liquidaciones y filtrar clientes. Configuralas antes de empezar a cargar clientes.
## Campos Personalizados
Los campos personalizados te permiten guardar información extra en tus contactos y facturas, más allá de los datos estándar (por ejemplo: legajo, curso, división o cualquier dato propio de tu institución).
Para crear uno, hacé clic en **"Agregar campo personalizado"** y definí su nombre. Después vas a poder completarlo desde la ficha de cada cliente.
![Campos personalizados: información extra para contactos y facturas]()
## Miembros
Acá gestionás las personas que tienen acceso al panel: administradores, cajeros y acomodadores de evento.
La guía de [Miembros y roles](/docs/guides/miembros-y-roles) explica qué puede hacer cada rol, cómo invitarlo y cómo limitar su acceso a eventos, puntos de venta y cajas.
Invitaciones, permisos y alcance para el equipo.
## Recordatorios
Los recordatorios son emails automáticos que se envían a tus clientes en relación a sus solicitudes de pago. Hay dos tipos:
**Antes del vencimiento** — Se disparan cuando se emite la orden de pago. Sirven para avisar al cliente que tiene un pago próximo.
**Después del vencimiento** — Se disparan cuando la orden vence sin ser pagada. Sirven como recordatorio de deuda.
Podés crear varios recordatorios de cada tipo. Por ejemplo: 7 y 3 días antes del vencimiento, y 2, 7, 14 y 21 días después.
![Recordatorios antes y después del vencimiento, con su estado]()
Cada recordatorio se configura con:
* **Estado**: Activo o Pausado (podés desactivar un recordatorio sin eliminarlo)
* **Tipo**: Email
* **Programado**: Cuántos días antes o después de la fecha de vencimiento se envía
Los recordatorios solo se envían a clientes con condición **Activo**. Los clientes dados de baja no reciben comunicaciones.
## Intereses por Mora
Configurá las reglas de recargo que se aplican automáticamente cuando un cliente no paga a tiempo. Las reglas se ejecutan en orden secuencial, lo que te permite crear **esquemas escalonados**.
Cada regla tiene:
* **Inicio**: Cuántos días después del vencimiento comienza a aplicar
* **Duración**: Durante cuántos días aplica el recargo
* **Monto**: Porcentaje o valor fijo del recargo
* **Base de cálculo**: Sobre qué monto se calcula el recargo (por ejemplo, el monto bruto antes de descuentos)
![Creación de una regla de mora: inicio, duración, monto y base de cálculo]()
El sistema calcula el recargo como una **Tasa Efectiva Anual (TEA)** aplicada diariamente sobre el monto base de la factura. Por ejemplo: una TEA del 60% que comienza el día 1 después del vencimiento y dura 10 días.
Podés crear múltiples reglas escalonadas (ej: un recargo alto los primeros días para incentivar el pago rápido, y uno menor después). Asegurate de cumplir con la normativa local.
## Integraciones
Conectá Fint con los servicios que necesites:
![Integraciones: procesadores de pago y facturación]()
### Procesadores de pago
Cobros online en Argentina y Uruguay; Point y QR del POS en Argentina
Pagos simplificados con todos los medios de pago
Cobros internacionales en dólares simplificados
### Facturación
* **ARCA**: Facturación electrónica automática integrada con ARCA (ex AFIP). Consultá la [guía paso a paso](/docs/guides/facturacion-arca) para configurarla.
### Plataformas de aprendizaje
* **Teachable**: Plataforma de cursos online para crear y vender contenido educativo.
Cada integración tiene un estado visible (Activo o "Contactarse para activar"). Para activar un procesador de pago, hacé clic en la tarjeta correspondiente.
## Funcionalidades
Activá o desactivá módulos de Fint según lo que necesite tu organización. Esto te permite mantener la interfaz limpia mostrando solo lo que usás.
**Canales de cobro:**
* **Eventos**: Creación y gestión de eventos con venta de entradas
* **Cuotas institucionales**: Cobro de cuotas y mensualidades recurrentes
* **Punto de venta**: Sistema de punto de venta para cobros presenciales
**Cobranzas:**
* **[Conciliación](/docs/guides/conciliacion-bancaria)**: Relaciona movimientos de extractos bancarios con órdenes y pagos
**Facturación:**
* **Arca**: Habilita el módulo de facturación electrónica (ver [Integraciones](#facturación) más arriba)
Si no usás un módulo, desactivalo. Siempre podés volver a activarlo cuando lo necesites.
## Desarrolladores
Desde acá gestionás las credenciales para conectar Fint con otros sistemas.
Las claves API son códigos únicos que permiten acceder a la API de Fint desde sistemas externos. Cada clave tiene un nombre identificativo y se muestra parcialmente oculta por seguridad.
Para crear una nueva, hacé clic en **"+ Crear API Key"** e ingresá un nombre descriptivo.
![Pestaña API keys en Desarrolladores]()
Los webhooks envían información a herramientas externas cuando ocurre un evento específico en Fint.
Para crear uno, hacé clic en **"+ Crear webhook"**, ingresá la URL del endpoint y seleccioná los eventos que querés escuchar (ej: `payment.created`, `contact.status`).
Cada webhook puede estar **Activo** o **Pausado**.
![Pestaña Webhooks en Desarrolladores]()
Endpoints y referencia técnica
Recibí notificaciones en tiempo real
## Facturación
Acá cargás la información fiscal de tu organización, necesaria para emitir facturas electrónicas con [ARCA](/docs/guides/facturacion-arca).
![Información fiscal: datos básicos, domicilio y condición fiscal]()
Tipo de persona (Física o Jurídica), razón social y CUIT.
Dirección registrada ante las autoridades fiscales y código postal.
Forma jurídica (Asociación Civil, SRL, SA, etc.), condición frente al IVA (Responsable Inscripto, Exento, Monotributo), condición de Ingresos Brutos y número de IIBB.
Fecha de inicio de actividades, correo electrónico y teléfono de contacto.
## Mi Cuenta
Desde acá editás tu información personal como administrador: **nombre completo**, **número de WhatsApp** y **correo electrónico** (el email de acceso no se puede modificar).
![Mi cuenta: información personal del administrador]()
## Próximos Pasos
Agregá tus clientes al sistema
Configurá los conceptos de cuotas
Configurá facturación electrónica
# Panel de Inicio
Source: https://docs.fint.app/docs/guides/dashboard
La foto general de tu cobranza: pagos recibidos, cobrado vs. adeudado y evolución mensual
Al entrar a Fint, la pantalla de **Inicio** muestra la evolución de tu cobranza de un vistazo. No requiere configuración: se arma sola con tus órdenes y pagos.
## Primeros pasos
Mientras tu organización se está configurando, el Inicio muestra una **guía de primeros pasos** con el checklist para empezar a cobrar: completar los datos generales, conectar un procesador de pagos, conectar ARCA, crear tu primer evento o liquidación y recibir el primer pago. A medida que completás cada paso, se va marcando solo.
![Checklist de primeros pasos del panel de inicio]()
Cuando el checklist se completa, el Inicio pasa a mostrar los gráficos de cobranza.
## Los gráficos
La plata que entró en los **últimos 30 días**: el total del período y la evolución día por día.
Dos series mensuales: **Total cobrado** (verde) y **Total adeudado** (lo que sigue pendiente de cada mes). Es el gráfico para detectar meses con cobranza floja.
El total facturado por mes en los últimos 12 meses (cobrado + adeudado), para ver la evolución de tu facturación.
Qué porcentaje de lo facturado efectivamente cobraste, mes a mes. Un termómetro rápido de la salud de la cobranza.
Los gráficos de 12 meses se agrupan por la **fecha de emisión** de cada orden: una cuota de marzo pagada en abril suma como "cobrado" de marzo.
## Próximos Pasos
Gestioná la información de tus clientes
El detalle de cada factura
Historial completo de transacciones
# Eventos
Source: https://docs.fint.app/docs/guides/eventos
Vendé entradas online con validación QR, combos y control de asistentes
Organizá eventos y vendé entradas online con página propia, validación QR, combos, descuentos y control de asistentes en tiempo real. Ideal para fiestas, conferencias, graduaciones, torneos o cualquier tipo de evento.
Eventos es un módulo separado de [Links de Pago](/docs/guides/links-pago). Usá Eventos cuando necesites validación QR, categorías de tickets, combos o control de asistentes.
## Panel del Módulo
Al entrar al módulo ves tres pestañas: **Eventos** (tus eventos, en una línea de tiempo), **Asistentes** (todas las entradas vendidas) y **Analytics**.
![Listado de eventos en línea de tiempo]()
Al hacer clic en un evento ves su detalle con tres indicadores clave, el gráfico mensual de ventas y el ranking de tipos de entrada más vendidos:
Monto total recaudado
Vendidas sobre el total disponible
Asistentes admitidos sobre entradas vendidas
![Detalle del evento con estadísticas de ventas, entradas y admisión]()
## Crear un Evento
Ingresá el **título**, **subtítulo**, **fechas** (desde/hasta con zona horaria), **ubicación** (nombre del recinto y dirección) y datos de **contacto** (email y WhatsApp para consultas).
Escribí una **descripción** que se va a mostrar en la página pública del evento.
**Imagen del evento**: Subí una imagen representativa que se mostrará en la página pública y en la sección Descubre. Podés usar formatos **cuadrados** (1:1, ej: 1080x1080px) o **rectangulares** (16:9, ej: 1920x1080px). Recomendamos imágenes de alta calidad (mínimo 1000px de ancho) para mejor visualización.
![Editor del evento: datos generales, entradas, descuentos y opciones]()
Seleccioná entradas existentes o creá nuevas. Las entradas son [items de tipo Entrada de eventos](/docs/guides/items-descuentos#campos-segun-el-tipo) donde configurás nombre, precio, stock, QR y datos del asistente.
Si querés ofrecer paquetes, creá **combos** que agrupan varias entradas a un precio especial (ej: "Pack Familiar" con 2 adultos + 2 niños).
![Entradas del evento con stock y precio, y sección de combos]()
Seleccioná descuentos existentes (creados en [Items y Descuentos](/docs/guides/items-descuentos)) para incentivar las ventas. Los descuentos son porcentuales y se aplican al momento de la compra.
Personalizá la experiencia del evento con las opciones avanzadas (detalladas más abajo).
Hacé clic en **"Guardar"** para publicar el evento, o en **"Guardar como borrador"** si todavía no está listo para salir.
Una vez publicado, la página pública queda disponible en tu URL de Fint (ej: `tuinstitucion.fint.app/eventos/mi-evento`) para compartir por donde quieras:
![Página pública del evento con las entradas a la venta]()
## Opciones del Evento
Al crear o editar un evento, tenés varias secciones de opciones avanzadas:
Podés modificar la configuración del evento **en cualquier momento**, incluso mientras las entradas están en venta. Esto incluye cambiar la imagen, agregar o quitar entradas, modificar descuentos, actualizar fechas, y ajustar el pedido de información.
![Configuración del evento: URL, costo del servicio, expiración del carrito]()
* **URL de página**: Personalizá la URL pública del evento.
* **Costo del servicio**: Comisión del 5% que podés configurar como **incluido** en el precio o **discriminado** (por separado), tanto para pagos online como manuales.
* **Tiempo de expiración del carrito**: Minutos que el comprador tiene para completar la compra antes de que se liberen las entradas.
* **Texto de éxito en email**: Mensaje personalizado que se incluye en el email de confirmación.
* **Aforo total estimado**: Capacidad máxima del evento.
* **Tracking y analítica**: Conectá tu [Meta Pixel, Google Analytics o Tag Manager](/docs/guides/meta-pixel) para medir las conversiones de tus campañas en la página pública.
* **Mostrar en Descubrir**: Activá este toggle para que el evento aparezca en la sección pública **Descubre** (accesible en `https://fint.app/discover`) donde la gente puede explorar eventos disponibles. Los eventos aparecen con su imagen, título, fecha y ubicación, permitiendo que nuevos compradores encuentren tu evento sin necesitar el link directo. Esta funcionalidad aumenta la visibilidad y puede generar ventas adicionales de público que busca eventos en tu zona.
Agregá preguntas y respuestas que se muestran en la página del evento. Útil para resolver dudas comunes antes de la compra (ej: "¿Hay estacionamiento?", "¿Puedo llevar menores?").
Configurá qué datos pedirle a las personas al momento de la compra.
**Del comprador** se piden siempre nombre y email. Opcionalmente podés activar documento y teléfono.
**De los asistentes**, los campos base (nombre, documento, email, teléfono) se configuran en cada entrada desde [Items y Descuentos](/docs/guides/items-descuentos#campos-segun-el-tipo).
![Pedido de información: campos del comprador y de los asistentes]()
Además, con **"+ Agregar campo"** creás **campos personalizados** para pedir información específica del evento: talle de remera, restricciones alimentarias, "¿Participaste anteriormente?", o cualquier dato que necesites. Cada campo tiene **nombre**, **descripción** opcional (se muestra como ayuda), **tipo de campo** (texto, selección, número, fecha, etc.), si es **obligatorio**, si está **activo**, y a qué entradas **aplica** (todas o algunas).
![Modal para agregar un campo personalizado al evento]()
Escribí un mensaje que se muestra de forma prominente en la página del evento. Ideal para avisos de último momento, cambios de horario o información importante. Tiene un toggle para activar o desactivar su visibilidad.
**Información adicional**: Agregá detalles complementarios sobre el evento que aparecerán en una sección dedicada de la página pública. Útil para información logística, políticas del evento, o cualquier detalle relevante.
**Condiciones especiales**: Definí términos y condiciones específicos del evento que los compradores deben aceptar antes de finalizar la compra. Por ejemplo: políticas de reembolso, restricciones de edad, código de vestimenta, o términos de responsabilidad.
## Estados del Evento
Los eventos pueden estar en dos estados:
* **Borrador**: No es visible públicamente. Ideal para preparar todo antes de publicar.
* **Activo**: Publicado y con entradas disponibles para la venta.
## El Día del Evento
### Validación por QR
Desde la pestaña **Asistentes**, usá el botón **"Escanear"** para validar el ingreso:
* Cada ticket tiene un **QR único**. Si alguien compra 5 entradas, recibe 5 QR diferentes.
* Al escanear, el sistema muestra los datos del asistente y permite **admitirlo** al instante.
* También podés buscar asistentes por nombre o email desde el listado.
Guía paso a paso para el personal del evento sobre cómo usar el escáner QR
### Gestión de entradas
La pestaña **Asistentes** muestra todas las entradas vendidas con su ID (TKT-XXXX), evento, tipo de entrada, comprador, asistente, fecha y estado (No admitido / Admitido). Podés filtrar por evento, tipo de entrada o estado, y **exportar a Excel**.
![Pestaña Asistentes con las entradas vendidas y su estado de admisión]()
El **comprador** y el **asistente** pueden ser personas distintas: si alguien compra 2 entradas, cada una tiene su propio asistente y su propio QR.
#### Crear entradas manuales
Para crear entradas sin cobro (cortesías, staff, invitados, prensa):
1. Hacé clic en **"+ Crear entrada"** desde la pestaña Asistentes
2. Seleccioná el **evento** y el **tipo de entrada**
3. Completá los datos del **asistente** (nombre, email, documento si es requerido)
4. Opcionalmente ingresá datos del **comprador** (quien "otorga" la cortesía)
5. Guardá y el sistema generará un QR válido para esa persona
Las entradas manuales **no aparecen en el link de venta público** del evento. Son generadas directamente por vos desde el panel de administración, ideal para invitaciones especiales o entradas de cortesía que no pasan por el proceso de compra.
### Detalle de una entrada
Al hacer clic en una entrada ves toda su información:
* **QR descargable** y estado actual
* **Acciones**: Admitir (marcar ingreso) o Cancelar (invalida el QR)
* **Detalles**: ID del ticket, evento, fecha de compra, monto y origen (Online o Manual)
* **Orden**: La solicitud de pago asociada con su estado
* **Asistentes**: Nombre, documento y email del asistente
* **Información adicional**: Respuestas a los campos personalizados del evento
* **Comprador**: Datos de quien realizó la compra (puede ser distinto al asistente)
El **comprador** es quien paga y el **asistente** es quien va al evento. Pueden ser la misma persona o no — por ejemplo, un padre que compra la entrada para su hijo.
## Cancelaciones y Devoluciones
* **Cancelar entradas**: Desde el detalle de la entrada, hacé clic en **"Cancelar"**. El QR deja de ser válido inmediatamente.
* **Devolver dinero**: Las devoluciones se hacen desde el procesador de pago (Mercado Pago, Stripe, etc.). Fint detecta el reembolso automáticamente y actualiza el estado.
## Mensajería a Participantes
Enviá comunicaciones a compradores y asistentes desde [Mensajería](/docs/guides/mensajeria). Podés enviar recordatorios, cambios de horario o información importante. Si el evento tiene entradas con QR, podés incluir las entradas en el mensaje.
## Facturación Automática
Fint genera facturas automáticamente cumpliendo con la normativa argentina. Los compradores reciben su comprobante por email junto con el ticket.
Paso a paso para integrar con ARCA (ex AFIP)
## API de Eventos
Endpoints para buscar tickets, obtener por referencia, actualizar asistentes y crear entradas.
## Próximos Pasos
Guía para el personal del día del evento
Configurá entradas y descuentos
Comunicá a los asistentes
# Facturación
Source: https://docs.fint.app/docs/guides/facturacion
Emití comprobantes electrónicos de ARCA sobre tus pagos, de forma automática con reglas o manual
Con la integración de [ARCA](/docs/guides/facturacion-arca) activa, Fint emite comprobantes electrónicos (facturas, notas de crédito y débito, recibos) directamente sobre los **pagos** que recibís. Podés automatizarlo con reglas o emitir manualmente desde cada pago.
Todo lo de esta guía requiere tener la integración con ARCA configurada. Si todavía no la tenés, empezá por la [guía de configuración de ARCA](/docs/guides/facturacion-arca).
## Conceptos clave
En Fint, los comprobantes **siempre están asociados a un pago**: primero se registra el cobro (online o manual) y sobre ese pago se emite el comprobante.
### Tipos de comprobante
El comprobante principal de la operación
Comprobante electrónico con CAE, alternativa a la factura
Anula o reduce una factura o recibo existente
Aumenta el importe de una factura existente
### La letra no se elige: se calcula
Fint determina automáticamente si el comprobante es **A**, **B** o **C** según la condición fiscal tuya (el emisor) y la del receptor:
* Si sos **Responsable Inscripto**: emitís **A** a Responsables Inscriptos y Monotributistas, y **B** a Consumidores Finales y Exentos.
* Si sos **Monotributista** o **Exento**: emitís siempre **C**.
### ¿A nombre de quién sale el comprobante?
Se factura al **contacto de pago** (responsable) del pago, con su tipo y número de documento. Si el documento es un CUIT/CUIL de 11 dígitos, Fint consulta el **padrón de ARCA** para deducir su condición fiscal (Responsable Inscripto, Monotributista, Exento). Si no puede determinarla, factura como **Consumidor Final**.
Verificá que tus contactos de pago tengan el documento cargado y correcto: sin documento válido el comprobante no se puede emitir.
## Facturación automática con reglas
En **Configuración → Facturación → Reglas de facturación** definís reglas para que los pagos se facturen solos. Cada regla configura:
* **Nombre** de la regla y **fecha de inicio** (se facturan los pagos recibidos a partir de esa fecha)
* **Tipo de comprobante**: Factura, Recibo o Ambos
* **Punto de venta**: los puntos habilitados se traen directo de ARCA
* **Origen** del pago: Online, Manual o Ambos
* **Métodos de pago**: elegí cuáles facturar (tarjetas, transferencia, efectivo, Mercado Pago, etc.)
* **Tipos de cliente**: Consumidor Final, Monotributista, Responsable Inscripto, entre otros
* **Momento de facturación**: Inmediata (al registrarse el pago) o un día específico de la semana
* **Concepto** (Servicios, Productos o ambos) y **Alícuota** de IVA
Cada regla puede estar **Activa** o **Pausada**.
### Cómo se aplican
Cuando entra un pago, Fint recorre tus reglas activas y aplica **la primera que coincida** con el método de pago y el tipo de cliente — una sola regla por pago. Si ninguna regla coincide, el pago queda sin facturar (siempre podés emitir manualmente después).
Empezá simple: una regla "Inmediata" con tipo Factura, todos los métodos de pago online y todos los tipos de cliente cubre la mayoría de los casos. Coordiná con tu contador el punto de venta y la alícuota.
## Emisión manual
Para facturar un pago puntual (o emitir una nota de crédito/débito), desde el detalle del pago:
En **Pagos**, hacé clic en el pago que querés facturar y ubicá la sección **Comprobantes**.
![Sección Comprobantes en el detalle de un pago]()
Con el botón **+** se abre el modal **"Registrar comprobante"**: elegí el tipo (Factura, Nota de Crédito, Nota de Débito o Recibo), la fecha, el concepto, el punto de venta y el monto (viene precargado con el total del pago, editable). Para una Factura elegís también la alícuota de IVA; para una Nota de Crédito o Débito, el comprobante al que aplica.
Fint envía la solicitud a ARCA y el comprobante queda asociado al pago, con su CAE y PDF descargable.
Reglas a tener en cuenta:
* Un pago admite **una factura válida**; si necesitás corregirla, emitís una **Nota de Crédito**.
* La Nota de Crédito requiere una factura o recibo previo; la Nota de Débito, una factura.
* No se puede emitir una nota sobre otra nota.
### ¿Cómo se anula una factura?
Por normativa de ARCA una factura **no se anula**: se emite una **Nota de Crédito por el total**, que la cancela fiscalmente. Ambos comprobantes quedan registrados.
## Estados y seguimiento
En el listado de **Pagos**, cada pago facturado muestra badges con sus comprobantes: **F** (Factura), **NC** (Nota de Crédito), **ND** (Nota de Débito), **R** (Recibo) — en **verde** si fue procesado por ARCA, en **rojo** si hubo un error.
Dentro del pago, cada comprobante muestra su estado:
| Estado | Significado |
| ------------- | ----------------------------------------------------------------------------- |
| **Pendiente** | En proceso de emisión |
| **Procesado** | Emitido correctamente, con CAE — PDF disponible para descargar |
| **Error** | ARCA rechazó la emisión — el detalle del error se ve en el tooltip del estado |
| **Cancelado** | Comprobante sin efecto |
Ante un **Error** (CUIT inválido, punto de venta no habilitado, datos fiscales incompletos), corregí el problema y volvé a emitir el comprobante manualmente desde el mismo pago.
Los comprobantes procesados también quedan disponibles para el responsable de pago en su [Portal de Contacto](/docs/guides/portal-contacto).
## Próximos Pasos
Certificados y autorización, paso a paso
Donde viven los comprobantes
Información fiscal de tu organización
# Facturación con ARCA (ex AFIP)
Source: https://docs.fint.app/docs/guides/facturacion-arca
Configurá la facturación electrónica automática integrada con ARCA
Conectá Fint con ARCA para que se emitan facturas automáticamente cada vez que recibís un pago. Definí reglas para elegir qué pagos facturar, qué comprobante emitir y con qué condiciones.
Emite facturas o recibos al recibir pagos
Definí qué pagos facturar: digitales, efectivo, o todos
Ajustes cuando sea necesario
Diferentes puntos de venta habilitados por ARCA
## Configuración
Para activar la facturación automática necesitás configurar dos partes: primero en Fint y luego en el portal de ARCA.
### Datos fiscales
1. Accedé a [Configuración](https://admin.fint.app/settings/general) en Fint
2. Entrá a la sección [Facturación](https://admin.fint.app/settings/tax/rules)
3. Completá la información requerida en cada sección:
**Información básica**
* Tipo de empresa (Persona física o jurídica)
* Razón social
* Inicio de actividades
* CUIL o CUIT
**Domicilio fiscal**
* Dirección completa
* Código postal
* Localidad y provincia
**Condición fiscal**
* Tipo de inscripción (Responsable Inscripto, Monotributista, Exento, etc.)
* Condición IVA
* Condición Ingresos Brutos
* Condición Seguridad Social
**Información adicional**
* Datos complementarios sobre la actividad económica
* Información específica para la emisión de comprobantes
**Condiciones Especiales**
* Estado frente a regímenes especiales
* Condición Seguridad Social específica
* Condición Ganancias
### Reglas de facturación
Una vez integrado con ARCA, configurá las reglas:
| Campo | Descripción |
| --------------- | ------------------------------------------------ |
| Fecha de inicio | Desde cuándo comenzar a facturar automáticamente |
| Punto de venta | El habilitado por ARCA |
| Concepto | Productos, servicios o ambos |
| Alícuota de IVA | Porcentaje correspondiente |
### 2.1 Habilitar Administrador de Certificados
Primero tenés que agregar el servicio "Administración de Certificados Digitales" a tu escritorio de ARCA.
Accedé con los datos fiscales de tu organización y buscá "Administrador de Relaciones de Clave Fiscal".
![Portal de Clave Fiscal]()
Hacé clic en el botón "Adherir Servicio".
![Botón Adherir Servicio]()
Navegá a **ARCA > Servicios Interactivos > Administración de Certificados Digitales** y seleccionalo.
![Seleccionar Administración de Certificados Digitales]()
### 2.2 Generar el certificado CSR
En tu escritorio de ARCA, ingresá a "Administración de Certificados Digitales" y hacé clic en "Agregar alias".
![Agregar alias]()
En el campo "Alias", escribí **"Fint Facturacion"**. Luego hacé clic en "Examinar" y seleccioná el certificado CSR proporcionado por Fint.
![Subir CSR]()
Una vez creado, vas a ver el certificado en la lista. Hacé clic en "Ver" para ver los detalles.
![Lista de certificados]()
Hacé clic en el botón de descarga para obtener el certificado generado.
![Descargar certificado]()
Enviá el certificado descargado al equipo de Fint a [soporte@fint.app](mailto:soporte@fint.app).
### 2.3 Habilitar servicios web
Necesitás habilitar 3 servicios para que Fint pueda facturar:
* **Facturación electrónica**
* **Padrón A13**
* **Constancia de CUIT**
En "Administrador de Relaciones de Clave Fiscal", seleccioná "Nueva Relación" y hacé clic en "Buscar" para seleccionar el servicio.
![Nueva Relación - Buscar]()
Navegá a **ARCA > WebServices** y elegí el servicio que querés autorizar.
![Lista de WebServices]()
Hacé clic en "Buscar" para seleccionar el certificado que generaste anteriormente.
![Buscar representante]()
Revisá los datos y hacé clic en "Confirmar".
![Confirmar relación]()
Confirmá la autorización del servicio.
![Confirmar autorización]()
Repetí el proceso de "Nueva Relación" para cada uno de los 3 servicios: **Facturación electrónica**, **Padrón A13** y **Constancia de CUIT**.
## Preguntas Frecuentes
Fint puede emitir facturas A, B y C, recibos X, y notas de crédito/débito según corresponda al tipo de cliente y condición fiscal.
Podés generar una nota de crédito para anular el comprobante original. Fint te guía en el proceso.
Sí, podés configurar múltiples puntos de venta habilitados en ARCA y asignarlos a diferentes reglas de facturación.
Una vez que envíes el certificado a Fint, la activación se completa en menos de 24 horas hábiles.
## Próximos Pasos
Otras opciones de configuración
Visualizá pagos facturados
Integración programática
# Items y Descuentos
Source: https://docs.fint.app/docs/guides/items-descuentos
Configurá los conceptos que forman parte de las cuotas y los descuentos aplicables
Los **items** son los conceptos que cobrás: cuotas, matrículas, productos o entradas. Los **descuentos** reducen esos importes.
Cada item pertenece a un tipo: liquidación, venta online o eventos. El [Punto de Venta](/docs/guides/punto-de-venta) reutiliza los items de **Venta online** con pago único para su catálogo presencial.
## Items
Un item es un concepto de cobro. Según su tipo, se asigna a clientes, se publica en un canal de venta o se agrega a una venta presencial.
![Listado de items: cuotas de liquidación y productos de venta online, con estado y stock]()
### Tipos de Item
Cuotas y conceptos que vas a facturar masivamente a tus clientes. Se incluyen automáticamente cuando ejecutás una [liquidación](/docs/guides/solicitudes-pago).
Productos o servicios que vendas a través de [Links de Pago](/docs/guides/links-pago) o del [Punto de Venta](/docs/guides/punto-de-venta). Para el POS deben tener vigencia de pago único.
Entradas y tickets que vendas a través de [Eventos](/docs/guides/eventos). Incluye validación QR y control de asistentes.
### Campos según el tipo
Cada item de liquidación tiene **nombre**, **monto** y un toggle para **generar intereses por mora** en caso de pago tardío.
Además de nombre y monto, los items de venta online tienen:
* **Imagen**: Foto del producto (se muestra en el checkout)
* **Descripción**: Texto visible en la página de compra
* **Stock disponible**: Cantidad de unidades disponibles
Un item de venta online puede ser de **pago único** o **recurrente**. El segundo genera una [suscripción](/docs/guides/links-pago#suscripciones) con cobro periódico.
Configurá esta opción en la [vigencia](#vigencia) del item.
Además de nombre, monto, imagen, descripción y stock, las entradas tienen opciones exclusivas:
* **Generar código QR**: Cada entrada genera un QR único para validación
* **Solicitar información al asistente**: Pide nombre, apellido y email del asistente
* **Incluir texto en email con las entradas**: Mensaje personalizado que se envía con los tickets
Los códigos QR se usan para validar el ingreso al evento. Podés escanearlos desde la app móvil de Fint.
### Crear un item de Venta online
Para usar un producto en el Punto de Venta:
Entrá a **Items**, presioná **Crear item** y elegí **Venta online** como tipo.
Ingresá un nombre claro, el monto y el stock disponible. También podés sumar una imagen y una descripción para identificarlo mejor.
En **Vigencia**, seleccioná **Pago único**. Los items recurrentes no se ofrecen en el catálogo del Punto de Venta.
Presioná **Guardar** para crearlo activo. Si todavía no querés publicarlo, usá **Guardar como borrador** y activalo desde el menú (⋯) cuando esté listo.
![Alta de un item de Venta online con nombre, descripción, monto, stock y vigencia de pago único]()
Después, [agregalo al catálogo del Punto de Venta](/docs/guides/pos-configuracion#agregarlos-al-pos).
### Estados: Borrador vs Activo
Al crear un item, elegís su estado con la acción final: **Guardar** lo deja activo y **Guardar como borrador** conserva la configuración para publicarla después. Antes de asociarlo a clientes, liquidaciones o un punto de venta, activalo.
Para activar un item, hacé clic en el menú (⋯) y seleccioná **"Activar item"**.
### Vigencia
Definí cuándo aplica el item (para items de **Liquidación** y **Venta online** — las entradas de evento no llevan vigencia propia, valen para su evento):
El item se cobra una sola vez en una fecha específica. Solo configurás el **mes de cobro**.
El item se cobra periódicamente. Configurás:
* **Frecuencia**: Mensual o Anual
* **Mes de inicio**: Desde qué mes comienza a cobrarse
* **Tipo de duración**: **Definida** (cantidad de cuotas específica) o **Indefinida** (se cobra siempre)
* **Cantidad de cuotas**: Si elegiste duración definida, cuántas veces se cobra
**Ejemplo**: Item "Cuota Mensual" con frecuencia Mensual, inicio en Marzo 2024, duración definida de 10 cuotas → Se cobrará desde Marzo 2024 hasta Diciembre 2024 inclusive.
![Creación de un item de liquidación con vigencia recurrente]()
### Importar desde Excel
Importá múltiples items desde un archivo Excel: hacé clic en **"Importar Excel"**, descargá el modelo con las columnas correctas, completalo y subilo.
### Duplicar Items
Si necesitás crear un item similar a uno existente, usá la opción **"Duplicar item"** del menú (⋯). Esto crea una copia exacta que podés modificar.
## Descuentos
Un descuento reduce el monto final de la solicitud de pago. Puede ser un **valor fijo** (ej: \$5.000) o un **porcentaje** (ej: 10%).
Los descuentos de tipo **Venta online** no se ingresan como cupón en el checkout público de Links de Pago, pero los descuentos activos de ese tipo sí se pueden aplicar desde el [Punto de Venta](/docs/guides/pos-descuentos).
Funcionan distinto según el canal:
* **En liquidaciones**: el descuento se **asigna al cliente** (igual que un item) y se aplica automáticamente en cada orden que genera la liquidación.
* **En eventos**: funcionan como **códigos de descuento** que el comprador ingresa en el checkout — no se asignan a nadie de antemano.
* **En el Punto de Venta**: el cajero elige uno o varios descuentos guardados para la orden. También puede combinarlos con descuentos manuales creados durante la venta.
Cada descuento tiene un **nombre** identificativo (ej: "Beca Académica 50%"), un **valor** (fijo o porcentaje) y la configuración de **a qué items aplica** (específicos o a todos).
Algunos ejemplos: becas académicas o deportivas, descuento por hermanos, pago anticipado, pago en efectivo.
![Listado de descuentos con porcentaje y clientes asignados]()
**Ejemplo**: Un cliente tiene cuota mensual ($15.000) + salida escolar ($3.000). Si el descuento por pago en efectivo (10%) aplica solo a la cuota, el total será $13.500 + $3.000 = \$16.500.
Al crear un descuento, usá **Guardar** para dejarlo activo o **Guardar como borrador** para publicarlo más adelante.
### Condición de cantidad para el Punto de Venta
En un descuento de tipo **Venta online**, podés activar **Requerir una cantidad mínima de productos**. Configurás:
* La cantidad mínima de unidades.
* Qué productos cuentan para alcanzar esa cantidad. Si no elegís ninguno, cuentan todos los productos de la orden.
* Por separado, los items sobre los que se calcula el descuento.
Los items de monto libre no cuentan para activar la condición de cantidad.
Esta separación permite, por ejemplo, exigir dos prendas y aplicar un 5% sobre toda la compra. Consultá [Descuentos en el Punto de Venta](/docs/guides/pos-descuentos) para ver alcance, activación y múltiples descuentos.
![Condición de cantidad de un descuento de Venta online con dos prendas seleccionadas]()
## Asignar a Clientes (solo Liquidación)
La asignación item–cliente existe **únicamente para items y descuentos de Liquidación**. Esta relación alimenta las [liquidaciones](/docs/guides/solicitudes-pago).
Al liquidar un período, Fint genera una orden para cada cliente con los items asignados. Sin asignación, no hay orden.
Los items de otros tipos **no se asignan previamente**:
* **Venta online**: el item puede publicarse en un [Link de Pago](/docs/guides/links-pago) o agregarse al catálogo del [Punto de Venta](/docs/guides/punto-de-venta). El comprador queda registrado al realizar la compra.
* **Entrada de eventos**: se compra desde la página pública del [evento](/docs/guides/eventos), completando los datos del comprador y los asistentes en ese momento.
Por eso, al crear un item, la sección **Clientes** solo aparece si el tipo es Liquidación.
Para los items de liquidación, podés asignar de varias formas:
Selección manual uno por uno desde el perfil del cliente o desde el item
Todos los de un grado, carrera o nivel (ej: todos los de "3er año")
Buscá clientes por nombre, etiquetas o estado y seleccioná múltiples
Al asignar un item desde su panel, podés buscar clientes y filtrarlos por etiquetas. Se muestra un contador de cuántos clientes están seleccionados antes de confirmar.
![Selector de clientes con filtro por etiquetas al asignar un item de liquidación]()
Para quitar un item de un cliente, entrá al perfil del cliente, ubicá el item en la sección "Items" y eliminalo. El item deja de facturarse en las próximas liquidaciones.
## Próximos Pasos
Usá los items en liquidaciones
Asigná items a clientes
Venta online de items
Venta presencial de productos
# Links de Pago
Source: https://docs.fint.app/docs/guides/links-pago
Publicá productos o servicios para cobrar online, con opción de pago único o suscripción
Creá páginas de pago para vender productos, servicios, cursos o membresías. Compartí el link y cobrá online.
## Crear un Link de Pago
Ingresá un **nombre de la página** (uso interno, no visible al comprador) y opcionalmente una **fecha de expiración** para que el link deje de estar disponible automáticamente.
Completá el **título** visible, una **descripción** (hasta 264 caracteres), subí una **imagen de portada** (1200 x 630 px recomendado) y definí la **dirección web** personalizada del link (ej: `tuinstitucion.fint.app/mi-curso`).
La **vista previa** de la derecha muestra en tiempo real cómo se verá la página pública.
![Formulario de creación de un link de pago con vista previa en vivo]()
Hacé clic en **"+ Agregar artículo"** y seleccioná los items de tipo "Venta online" creados en [Items y Descuentos](/docs/guides/items-descuentos). Podés agregar varios artículos al mismo link — el comprador elige uno al momento de la compra.
Opcionalmente, asigná **etiquetas** al link. Cuando alguien compra, se crea un nuevo cliente y contacto en Fint, y se le asignan automáticamente esas etiquetas.
![Selección de artículos de venta online para el link]()
Para items recurrentes podés activar un **día fijo de emisión**: todas las facturas se emiten el día indicado de cada mes, sin importar cuándo se suscribió el contacto. También podés definir los **días hasta el vencimiento** después de la emisión.
Activá el toggle **"Agregar texto al finalizar el proceso"** para configurar un mensaje que verá el comprador al completar el pago (instrucciones, próximos pasos, etc.).
Cuando esté listo, hacé clic en **"Guardar"** para publicar o **"Guardar como borrador"** si todavía no querés que esté disponible.
## Listado y Estados
El listado de links muestra el nombre interno, título visible, fecha de expiración y estado. Los links pueden estar en estado **Activa** (disponible para compras) o como borrador.
![Listado de links de pago con su estado]()
## Compartir
Una vez publicado, compartí tu link por email, WhatsApp, redes sociales o integralo en tu sitio web. El comprador ve una página con tu logo, el título, la descripción y los artículos disponibles para seleccionar y pagar.
***
## Suscripciones
Las suscripciones **no son un tipo de link diferente**. Se crean desde el mismo formulario de Link de Pago. La diferencia está en el **item**: si agregás un item con cobro recurrente, al comprarlo se genera una suscripción automáticamente. La descripción del item le explica al comprador que es una suscripción y su duración.
Esto significa que en un mismo link podés mezclar items de pago único e items recurrentes.
### ¿Cómo funciona el cobro recurrente?
El modo de cobro se configura en el link, en la sección **Cobro**:
Con la opción **"Debitar automáticamente todos los meses"**, el cobro de cada período es automático: con **Stripe**, Fint debita la tarjeta guardada (con reintentos si falla); con **Mercado Pago**, el débito lo maneja la suscripción de MP. Si el cobro falla tras todos los reintentos, podés elegir que la suscripción se cancele sola o que se sigan emitiendo facturas con intereses.
Fint **genera y envía una factura** en cada período. El cliente la paga desde el [Portal de Contacto](/docs/guides/portal-contacto) o presencialmente.
### Configuración de la suscripción
La recurrencia se configura en el item desde [Items y Descuentos](/docs/guides/items-descuentos#vigencia):
* **Frecuencia**: Mensual o anual
* **Duración**: Indefinida o cantidad de cobros específica
### Gestionar suscripciones activas
Desde el [panel de suscripciones](/docs/guides/suscripciones) podés ver el detalle de cada una y **cancelarla** definitivamente — no se generan más órdenes de pago.
Para **modificar el monto** no se edita la suscripción: se cambia el precio del **item** en [Items y Descuentos](/docs/guides/items-descuentos), y el nuevo valor se propaga automáticamente a todas las suscripciones activas que lo usan (aplica desde el próximo período).
El cliente no puede cancelar directamente — solo el administrador puede hacerlo.
### ¿Cuándo usar suscripciones vs liquidaciones?
| Suscripciones | Liquidaciones |
| --------------------------------------------- | ------------------------------ |
| El cliente se inscribe voluntariamente | Vos generás las facturas |
| Cobro automático (Stripe) o factura periódica | El cliente paga cada factura |
| Ideal para servicios opcionales | Ideal para cuotas obligatorias |
## Próximos Pasos
Creá items de tipo "Venta online"
Pagos recibidos por links
Otra forma de vender online
# Mensajería
Source: https://docs.fint.app/docs/guides/mensajeria
Enviá comunicados por email a tus clientes y responsables de pago
Enviá emails masivos o individuales a tus clientes. Ideal para recordatorios de pago, avisos importantes o promociones.
## Tipos de Destinatarios
Al crear un mensaje, elegís a quién va dirigido:
Enviá mensajes a personas que compraron entradas a tus eventos.
Enviá mensajes a clientes con items asignados (liquidación, venta online) o a sus responsables de pago.
![Selección del tipo de destinatario del comunicado]()
Si el cliente tiene **responsables de pago** con email, el comunicado les llega a ellos; si no tiene, va directo al email del cliente. Antes de enviar, Fint te muestra qué destinatarios no tienen email cargado.
## Crear y Enviar un Mensaje
Seleccioná si vas a enviar el mensaje a compradores de eventos o a clientes.
Buscá y seleccioná los contactos específicos a quienes enviar el mensaje. Podés filtrar por etiquetas, items asignados o estado.
Completá el **asunto**, **título**, elegí un **color** de paleta para el tema del email y escribí el **contenido** del mensaje. El **remitente** se toma del nombre y logo de tu organización (configurado en [Configuración](/docs/guides/configuracion)).
A medida que completás los campos, la vista previa de la derecha muestra cómo se verá el email final.
![Compositor del comunicado con vista previa del email]()
Según el tipo de destinatario tenés opciones adicionales:
* **Para Compradores de Eventos**: Podés activar **"Incluir Entrada QR"** para adjuntar el código QR de la entrada.
* **Para Clientes**: Podés activar **"Incluir botón al portal"** que agrega un botón al [Portal de Contacto](/docs/guides/portal-contacto) con texto personalizable (ej: "Ir al portal", "Ver mi cuenta").
El botón al portal es útil para recordatorios de pago, ya que lleva al cliente directo a su estado de cuenta.
Revisá cómo se ve el email en la vista previa antes de enviarlo.
## Estadísticas
Una vez enviado el mensaje, podés ver estadísticas detalladas:
![Vista de estadísticas de mensaje enviado]()
Las métricas principales son: **total enviados**, **entregados** (llegaron correctamente), **abiertos** (el destinatario lo abrió), **clicks** (hizo clic en un enlace) y **rebotados** (no pudieron ser entregados). Cada métrica muestra su porcentaje.
También podés ver el estado de cada destinatario individual: **Entregado** o **No enviado (bloqueado)** si el email es inválido.
Las estadísticas se actualizan en tiempo real. Podés usar esta información para hacer seguimiento de la efectividad de tus comunicaciones.
## Historial de Mensajes
El listado de mensajes enviados muestra quién lo envió, el asunto, la cantidad de destinatarios y la fecha de envío. Hacé clic en un mensaje para ver sus estadísticas y el listado de destinatarios.
Los comunicados enviados no se pueden editar ni cancelar, pero podés **duplicar** uno para reutilizarlo como base de un nuevo envío.
## Límites y Restricciones
* Los mensajes se envían por **email** únicamente
* **No hay límite** de envíos mensuales
* **No se pueden adjuntar archivos**, pero podés incluir enlaces
## Próximos Pasos
Configurá recordatorios automáticos
Gestioná información de contacto
Generá facturas para cobrar
# Meta Pixel y Analítica
Source: https://docs.fint.app/docs/guides/meta-pixel
Medí las conversiones de tus campañas en la página pública de tu evento: Meta Pixel, Google Analytics y Tag Manager
Si promocionás tu evento con Meta Ads (Instagram/Facebook) o campañas de Google, podés conectar tus herramientas de medición directamente a la **página pública del evento**. Fint se encarga de disparar los eventos de conversión — vos solo pegás tu ID.
La configuración es **por evento**: cada evento puede tener su propio píxel y sus propias propiedades de análisis.
## Configurar el tracking
En **Eventos**, editá tu evento y entrá a **Configuración**. Al final del panel está la sección **"Tracking y analítica"**.
![Sección Tracking y analítica en la configuración del evento]()
* **Meta Pixel ID**: el número de tu píxel (lo encontrás en el [Administrador de eventos de Meta](https://business.facebook.com/events_manager2), en la configuración del píxel o conjunto de datos).
* **Google Analytics ID** (`G-XXXXXXXXXX`) y/o **Google Tag Manager ID** (`GTM-XXXXXX`), si medís con Google.
Los campos de la API de Conversiones (Test Event Code y CAPI Access Token) podés dejarlos vacíos.
Desde ese momento, la página pública del evento carga tus scripts de medición.
## Qué se mide
Con el **Meta Pixel ID** configurado, en el navegador del comprador se disparan:
| Evento de Meta | Cuándo | Datos |
| -------------- | ---------------------------------------------------------- | --------------------------------------------------------------------------------------------------- |
| **PageView** | Al entrar a la página pública del evento | — |
| **Purchase** | En la pantalla de confirmación, cuando el pago se acredita | Valor de la compra, nombre del evento y un **ID de transacción único** (la referencia de la compra) |
El ID de transacción evita que una misma compra se cuente dos veces, incluso si el comprador recarga la página de confirmación.
Con **Google Analytics** se registra la navegación y un evento `purchase` con el monto y la transacción; con **Tag Manager**, el mismo evento `purchase` se empuja al `dataLayer` para que lo uses en tus tags.
## ¿A dónde apunto mis anuncios?
Hay dos formas de armar la campaña, y la atribución funciona distinto en cada una:
### Anuncio → página del evento en Fint (recomendado)
Usá la **URL pública del evento** (`tuinstitucion.fint.app/eventos/mi-evento`) como destino del anuncio. No hay que hacer nada más: Meta agrega automáticamente el parámetro `fbclid` al link, el píxel lo captura al cargar la página, y el **Purchase queda atribuido a la campaña** de punta a punta.
### Anuncio → tu propia web → página del evento en Fint
Si el anuncio apunta primero a tu sitio (una landing propia) y desde ahí el visitante pasa a Fint, hay un detalle clave: **los parámetros de la campaña no viajan solos entre dominios**. El `fbclid` (y los UTM) quedan en la URL de *tu* web — si el botón "Comprar entradas" linkea a Fint sin ellos, el píxel en la página del evento no puede vincular la compra con el anuncio y la atribución se pierde.
La solución es que tu web **reenvíe los query params** al link de Fint. Si tu página no usa parámetros propios, alcanza con este snippet:
```html theme={null}
Comprar entradas
```
Lo mínimo indispensable para Meta es propagar **`fbclid`**. Si además medís con Google Analytics, propagá también los parámetros **`utm_*`**. Y si tu web tiene instalado el mismo píxel, mejor: Meta ve el recorrido completo.
### ¿Y si no reenvío los parámetros?
Puede que igual veas **algunas** conversiones atribuidas en el Ads Manager: si la persona está logueada en Facebook o Instagram en ese mismo navegador, Meta a veces logra vincular la compra al anuncio por sus propios medios. Pero es una atribución **parcial y cada vez menos confiable** — depende de que el usuario esté logueado y de que el navegador no bloquee las cookies de terceros (Safari y Firefox las bloquean por defecto, y Chrome las está restringiendo).
En la práctica: sin el reenvío de parámetros vas a **subcontar** las conversiones de tus campañas, y no de forma pareja — verás resultados erráticos. El `fbclid` propagado convierte la atribución en determinística. Por eso, si podés elegir, el flujo directo (anuncio → página del evento) es siempre la opción más confiable.
## Verificar que funciona
1. Instalá la extensión [Meta Pixel Helper](https://chrome.google.com/webstore/detail/meta-pixel-helper/fdgfkebogiimcoedlicjlajpkdmockpc) en Chrome y entrá a la página pública de tu evento: deberías ver el **PageView** de tu píxel.
2. Hacé una compra de prueba y verificá el **Purchase** en la pantalla de confirmación.
3. En el Administrador de eventos de Meta, los eventos aparecen en **"Probar eventos"** y en el resumen del píxel.
## Próximos Pasos
Creá y publicá tu evento
El día del evento
Comunicate con los asistentes
# Miembros y roles
Source: https://docs.fint.app/docs/guides/miembros-y-roles
Invitá a tu equipo y definí el acceso de administradores, cajeros y acomodadores de evento
Desde **Configuración → Miembros** los administradores gestionan quién puede entrar al panel y con qué alcance.
Usá un rol de operación para cada tarea. Reservá el rol de administrador para quienes necesiten configurar la organización o administrar al equipo.
## Roles disponibles
| Rol | Experiencia disponible | Alcance que podés definir |
| ------------------------ | -------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
| **Administrador** | Acceso completo al panel y a la configuración de la organización. | No requiere restricciones adicionales. |
| **Cajero** | **Puntos de venta** y **Configuración → Mi cuenta**. Dentro de un POS, ve **Inicio** y **Ventas**. | Todos o algunos puntos de venta y cajas; además, visibilidad sobre ventas de otros cajeros. |
| **Acomodador de evento** | **Eventos** y **Configuración → Mi cuenta**. | Todos los eventos o una selección. También podés guardar el permiso **Ver dinero en estadísticas de eventos**. |
Un cajero no puede crear ni configurar puntos de venta, productos, grupos o cajas. Prepará esos elementos antes de darle acceso. Un acomodador no recibe una experiencia de Punto de Venta en la interfaz.
## Invitar a una persona
Entrá a **Configuración → Miembros** y presioná **Invitar**.
Escribí el correo de la persona y seleccioná **Administrador**, **Cajero** o **Acomodador de evento**.
Para cajeros y acomodadores, completá las opciones que aparecen para ese rol antes de enviar la invitación.
La persona queda en **Invitaciones pendientes** hasta que acepte el email. Sus permisos se aplican al aceptar la invitación.
## Configurar un cajero para Punto de Venta
Al elegir **Cajero**, el formulario muestra tres decisiones:
1. **Acceso a todos los puntos de venta:** activalo para que pueda operar en todos. Si lo desactivás, seleccioná los puntos de venta permitidos.
2. **Puede usar todas las cajas:** activalo para que use cualquier caja de los puntos de venta a los que tiene acceso. Si lo desactivás, seleccioná las cajas permitidas. La lista se limita a las cajas de los puntos de venta elegidos.
3. **Ver ventas de otros cajeros:** activalo si debe consultar todas las ventas de sus puntos de venta. Desactivado, el listado de ventas queda limitado a sus propias operaciones.
![Invitación de un cajero con permisos para puntos de venta, cajas y ventas de otros cajeros]()
Si desactivás el acceso a todos los puntos de venta, aparece el selector para limitarlo a los mostradores correspondientes:
![Configuración de un cajero restringido a puntos de venta seleccionados]()
Si restringís puntos de venta o cajas, seleccioná al menos uno antes de enviar la invitación. De lo contrario, el botón para enviar no se habilita.
Preparación recomendada:
1. [Configurá el catálogo y el comportamiento del POS](/docs/guides/pos-configuracion).
2. [Creá o asociá las cajas y dispositivos](/docs/guides/pos-cajas-dispositivos).
3. Invitá al cajero con el alcance correspondiente.
4. Compartile la guía de [operación diaria del Punto de Venta](/docs/guides/pos-venta).
### Comparar las vistas
Dentro del POS ve **Inicio**, **Items**, **Grupos**, **Ventas** y **Config**. Además puede crear puntos de venta, preparar cajas y consultar reportes.
![Vista del administrador dentro del Punto de Venta con navegación de catálogo y configuración]()
Dentro de un POS permitido ve solamente **Inicio** y **Ventas**. Opera el catálogo preparado por un administrador y no puede abrir la configuración por una URL directa.
![Vista del cajero dentro del Punto de Venta con navegación limitada a Inicio y Ventas]()
## Configurar un acomodador de evento
Al elegir **Acomodador de evento**, podés:
* Activar **Acceso a todos los eventos**; o desactivarlo y seleccionar los eventos permitidos.
* Activar **Ver dinero en estadísticas de eventos**.
El permiso **Ver dinero en estadísticas de eventos** se puede guardar, pero la vista actual del acomodador no incluye **Estadísticas**. Activarlo hoy no cambia su interfaz.
Cuando la invitación se restringe a eventos concretos, Fint abre el paso **Seleccionar eventos**. Elegí al menos uno para poder enviarla.
![Invitación de un acomodador con permisos de eventos y visibilidad de estadísticas]()
### Qué ve el acomodador
Al ingresar, el acomodador encuentra **Eventos** y **Configuración** en la navegación principal. Dentro de Eventos puede abrir la lista de eventos y **Asistentes**; la configuración queda limitada a **Mi cuenta**.
No ve ni puede abrir el Punto de Venta.
![Vista del acomodador con acceso a Eventos, Asistentes y Configuración, sin Punto de Venta]()
Para la operación del día del evento, consultá [Eventos](/docs/guides/eventos) y la [App de Admisión](/docs/guides/app-admision).
## Editar un miembro existente
En la fila de cada miembro, abrí el menú de acciones y elegí **Editar permisos**. Podés cambiar el rol y las opciones que corresponden a ese rol; presioná **Guardar** para aplicar los cambios.
Al pasar una persona a **Administrador**, Fint deja de aplicar sus restricciones de eventos, puntos de venta, cajas y ventas. Al cambiar entre roles operativos, revisá el alcance que aparece en el formulario antes de guardar.
La pantalla de edición avisa si un rol restringido quedó sin eventos, puntos de venta o cajas seleccionados. Corregí esa selección antes de guardar para no dejar a la persona sin área de trabajo.
## Próximos pasos
Prepará el mostrador y asigná cajeros.
Definí qué cajas puede usar cada cajero.
Prepará eventos y el acceso del equipo de admisión.
# Pagos
Source: https://docs.fint.app/docs/guides/pagos
Historial y gestión de todos los pagos recibidos
Acá ves todos los pagos recibidos y gestionás devoluciones, exportaciones y pagos manuales.
## Listado de Pagos
El listado muestra todos los pagos con: cliente, fecha, concepto, medio de pago, importe y estado. Los pagos manuales se distinguen con la marca **(M)** junto al medio de pago.
Usá el **buscador** para encontrar pagos por nombre del cliente, número de transacción, concepto o monto. También podés filtrar por **medio de pago** (tarjeta, transferencia, efectivo), **origen** (Manual u Online), **registrado por** (qué admin lo registró) y **etiquetas** del cliente.
![Listado de pagos con medio de pago, marca de pago manual y estado]()
### Estados de un Pago
El pago se acreditó. Todo pago nace en este estado.
El pago fue devuelto desde el procesador
El pagador desconoció el pago ante su tarjeta
## Detalle del Pago
Al hacer clic en un pago, accedés a su detalle completo. La información varía según el tipo:
Un pago manual muestra: fecha real del pago, fecha de registro en Fint, importe, medio de pago (con indicador "Manual"), estado, quién lo registró, quién pagó y el cliente asociado.
También muestra las **órdenes de pago** cubiertas (si fue pago total o parcial).
![Detalle de un pago manual: quién lo registró, quién pagó y las órdenes cubiertas]()
Si registraste un pago por error, podés eliminarlo con el botón **"Eliminar pago manual"**. Esto revierte el pago y restaura el estado de las órdenes asociadas.
Solo los pagos **manuales** se pueden eliminar. Los pagos online deben revertirse desde el procesador de pago.
Un pago online muestra: fecha de procesamiento, importe, medio de pago, estado, **número de referencia** (clic para verlo en Mercado Pago/Stripe), quién pagó y el cliente asociado.
También muestra las **órdenes de pago** cubiertas.
Los pagos online **no se pueden eliminar** desde Fint. Consultá [Devoluciones y Contracargos](#devoluciones-y-contracargos) para más información.
## Registrar Pagos Manuales
Para registrar un pago en efectivo, transferencia u otro medio fuera de línea:
Entrá a la orden del cliente (desde el módulo de [Órdenes](/docs/guides/solicitudes-pago) o desde el perfil del cliente).
En la sección **Pagos** del detalle de la orden, hacé clic en **+** y completá los datos: medio de pago (efectivo, tarjeta de débito/crédito o transferencia), fecha y monto. El monto viene precargado con el total pendiente (mora incluida), y podés bajarlo para registrar un **pago parcial**. También elegís qué **contacto** de pago lo realizó.
![Modal Registrar pago con el monto pendiente precargado]()
Esto actualiza el estado de la orden y el pago aparece inmediatamente en el historial.
En un pago parcial, el monto se imputa **primero al capital** de la orden; los intereses por mora se cobran recién cuando el capital queda cubierto. Al registrar un pago parcial sobre una orden vencida, la mora acumulada se congela para no seguir corriendo sobre lo ya pagado.
## Devoluciones y Contracargos
Las devoluciones se gestionan desde el **procesador de pago** (Mercado Pago, Stripe, Pagos Online). Fint escucha los eventos del procesador y actualiza el sistema automáticamente:
* **Reembolso**: Fint actualiza el estado del pago. Si estaba asociado a entradas de un evento, las entradas se cancelan.
* **Contracargo**: Fint detecta los contracargos y los refleja en el sistema.
## Exportar a Excel
Hacé clic en **"Exportar"** para descargar los pagos en formato Excel. Podés elegir un **rango de fechas** y si filtrar por la **fecha en que se ejecutó el pago** (fecha real) o la **fecha en que se creó en Fint** (fecha de registro).
Para pagos manuales, la fecha de ejecución puede ser diferente a la de registro (ej: recibiste un pago el 1 de marzo pero lo registraste el 5).
La exportación respeta los filtros activos en el listado (medio de pago, origen, registrado por, etiquetas).
## Próximos Pasos
Facturas pendientes de cobro
Métricas generales
Pagos por enlaces públicos
# Portal de Contacto
Source: https://docs.fint.app/docs/guides/portal-contacto
Donde los contactos consultan deudas, pagan online y descargan comprobantes
El Portal de Contacto es la página que ven tus clientes y sus contactos. Desde ahí consultan su estado de cuenta, pagan online y descargan comprobantes.
## Acceso
Cada contacto accede a través de un **link único** — no necesita registro ni contraseña.
Desde el perfil del cliente, enviá el enlace automáticamente.
Copiá el enlace y compartilo por WhatsApp, SMS o cualquier medio.
Si un contacto tiene **varios hijos** en la institución, ve el estado de cuenta de todos en un **portal unificado**.
Si el contacto pierde el link, puede recuperarlo desde la página de la institución ingresando su **número de documento**: el portal lo busca y lo redirige a su estado de cuenta.
## ¿Qué puede hacer el contacto?
### Consultar deudas
El responsable de pago ve en tiempo real: saldo pendiente, facturas vencidas, próximos vencimientos e intereses acumulados. Si una factura está vencida, el monto ya incluye el **recargo por mora** calculado al momento.
![Portal de contacto: factura vencida con recargo por mora incluido]()
### Pagar online
1. Seleccioná una, varias, o todas las facturas pendientes
2. Elegí el método de pago (tarjeta, transferencia, Rapipago, Pago Fácil — según el procesador que tengas [configurado](/docs/guides/configuracion))
3. Completá el pago con confirmación inmediata
![Selección del medio de pago en el portal]()
Las facturas se pagan **de la más antigua a la más nueva**: el portal no permite pagar una factura si hay otras anteriores impagas.
### Descargar comprobantes
Historial completo de pagos realizados con descarga de recibos PDF y detalle de cada factura emitida.
![Historial de facturas pagadas en el portal]()
### Actualizar datos
El responsable puede modificar su email, teléfono y dirección de facturación.
## Personalización
El portal muestra el **logo y nombre** de tu institución, configurados en [Configuración](/docs/guides/configuracion). También muestra tu email y WhatsApp de soporte.
## Notificaciones
Cuando se realiza un pago desde el portal:
1. El contacto recibe email de confirmación con recibo adjunto
2. El pago aparece inmediatamente en tu [módulo de Pagos](/docs/guides/pagos)
3. Se dispara el webhook `payment.created` si tenés [integraciones](/developers/webhooks/1_introduction) configuradas
## Próximos Pasos
Gestioná perfiles y enviá enlaces
Personalizá tu marca
Visualizá pagos recibidos
# Cajas y dispositivos
Source: https://docs.fint.app/docs/guides/pos-cajas-dispositivos
Creá cajas, asocialas al punto de venta y prepará Point y QR
En organizaciones de Argentina, una **caja** vincula el punto de venta con los canales presenciales de Mercado Pago. Puede habilitar un **dispositivo Point**, un **QR** o ambos.
Dentro del POS, **Config → Cajas y dispositivos** resume la caja asociada y la disponibilidad real de cada canal.
![Caja Mostrador principal asociada al punto de venta, sin Point ni QR disponibles]()
## Antes de crear una caja
Point y QR del Punto de Venta están disponibles para organizaciones de **Argentina**. Para usarlos, la organización necesita una conexión activa con Mercado Pago. Si todavía no la tenés, seguí [Conectar Mercado Pago](/docs/guides/conectar-mercado-pago).
La pantalla **Punto de Venta → Cajas y dispositivos** está disponible para administradores. Si la integración no está conectada, Fint muestra un acceso directo a **Integraciones** en lugar de la grilla.
## Crear o asociar una caja
Presioná **Crear caja**. El asistente ofrece dos caminos:
Usalo si la caja ya existe en la cuenta de Mercado Pago.
1. Ingresá un nombre para reconocerla en Fint.
2. Elegí el punto de venta asignado.
3. Seleccioná **Asociar existente**.
4. Elegí una caja disponible del proveedor y guardá.
Las cajas ya vinculadas aparecen deshabilitadas y no se pueden asociar dos veces.
Usalo para dar de alta los recursos desde Fint.
1. Ingresá el nombre y elegí el punto de venta.
2. Seleccioná **Crear caja nueva** y presioná **Continuar**.
3. Elegí una sucursal existente de Mercado Pago o **Crear sucursal nueva**.
4. Si creás una sucursal, completá calle, número, ciudad, provincia y ubicación en el mapa.
5. Guardá.
Varias cajas pueden compartir la misma sucursal.
Podés dejar la caja sin punto de venta durante el alta y asignarlo después desde su tarjeta. Para que el cajero pueda usarla, debe quedar vinculada al POS correspondiente.
## Administrar una caja
Cada tarjeta muestra:
* El nombre y estado de la caja.
* El **PDV asignado**.
* El **dispositivo** asignado y su modo.
* Alertas de configuración o conexión, cuando corresponda.
Hacé clic en el bloque **PDV asignado** para cambiarlo. Podés elegir un punto de venta o dejar la caja sin asignar.
Desde el menú `…` también podés abrir **Ver detalle** o **Editar** para cambiar el nombre y dejarla activa o inactiva.
El detalle informa además el proveedor, origen de la caja, sucursal, dirección, identificadores del proveedor y disponibilidad real de dispositivo y QR.
## Sincronizar y asignar un dispositivo
En la tarjeta de la caja, hacé clic en el bloque **Dispositivo**.
Presioná **Sincronizar dispositivos** para traer los equipos vinculados a la cuenta del proveedor.
Marcá el dispositivo y guardá. Un equipo que ya pertenece a otra caja o que dejó de aparecer en la cuenta no se puede seleccionar.
El dispositivo debe estar en **modo de venta (PDV)** para recibir cobros enviados por Fint.
Cada caja admite un solo dispositivo asignado. Cambiar el equipo libera el anterior antes de asociar el nuevo.
### Cambiar entre PDV e independiente
Desde el menú del dispositivo podés elegir **Pasar a modo de venta (PDV)** o **Pasar a modo independiente**.
Después de cambiar el modo:
1. Reiniciá el dispositivo físico.
2. Volvé a **Sincronizar dispositivos**.
3. Confirmá que Fint ya muestre el modo esperado.
El modo independiente sirve para operar directamente desde el equipo, pero no recibe cobros iniciados desde el POS de Fint.
## Cuándo aparecen Point y QR
Fint usa el estado calculado por el servidor:
* **Dispositivo Point** aparece solo si la conexión está activa, la caja tiene un dispositivo asignado y ese dispositivo está listo en modo PDV.
* **QR Mercado Pago** aparece solo si la caja tiene un QR provisionado y está operativa para ese canal.
* **Efectivo** y **Transferencia** siguen disponibles aunque la caja no tenga canales de Mercado Pago listos.
Podés revisar el resumen desde **Config → Cajas y dispositivos** dentro del POS. La tabla separa “Cobro con dispositivo” y “Cobro con QR”, porque una caja puede estar lista para uno y no para el otro.
## Caja de este dispositivo
Si un punto de venta tiene varias cajas, cada navegador elige la suya. En el primer ingreso Fint abre **Seleccionar caja**; después podés cambiarla desde **Config**.
La selección es local al navegador. Si una caja fue desasignada del POS, Fint no adopta otra silenciosamente: el cajero debe elegir una caja válida.
## Cambios de cuenta y recuperación
Si la conexión de una caja queda desconectada, la tarjeta conserva el historial pero bloquea las acciones del proveedor.
Cuando exista una conexión activa nueva, usá **Reconectar caja** para asociarla a una caja existente o crear recursos nuevos sin perder su identidad en Fint.
Si el provisionamiento falla y el servidor marca la caja como recuperable, aparece **Reintentar configuración**.
## Próximos pasos
Usá la caja desde Inicio
Point, QR y combinados
Revisá la integración
# Cobrar la venta
Source: https://docs.fint.app/docs/guides/pos-cobros
Usá efectivo, transferencia, Point, QR o un pago combinado y resolvé excepciones
Después de presionar **Continuar al pago**, Fint crea una sesión temporal, reserva la orden y muestra únicamente los medios disponibles para la caja elegida.
![Medios de pago disponibles en el checkout del POS]()
En esta captura, **Mostrador principal** no tiene Point ni QR configurados. Por eso Fint ofrece solo efectivo, transferencia y pago combinado. Cada caja muestra únicamente los medios que puede usar.
## Medios disponibles
| Medio | Qué hace Fint | Requisito |
| --------------------- | ------------------------------------------------------- | ------------------------------------------------------ |
| **Efectivo** | Registra un pago manual en efectivo | Orden válida; identificación si la venta no es anónima |
| **Transferencia** | Registra un pago manual identificado como transferencia | Orden válida; identificación si la venta no es anónima |
| **Dispositivo Point** | Envía el importe al equipo físico y espera su resultado | Caja con dispositivo listo en modo PDV |
| **QR Mercado Pago** | Muestra el QR de la caja y espera la confirmación | Caja con QR listo |
| **Combinado** | Reparte el total entre dos o más medios | Las partes deben sumar exactamente el total |
Point y QR no aparecen si la caja actual no está lista para ese canal. Revisá [Cajas y Dispositivos](/docs/guides/pos-cajas-dispositivos) si falta una opción.
## Datos del cliente
Según el rol y la configuración del POS, Fint usa uno de estos caminos:
* **Contacto seleccionado:** la venta queda asociada al cliente elegido en la orden.
* **Consumidor final:** se permite cuando la compra anónima está habilitada y el total no supera el máximo configurado.
* **Información del cliente:** si un cajero registra un cobro manual no anónimo, Fint solicita nombre, apellido, email y documento antes de confirmar. Teléfono, dirección y país son opcionales.
## Efectivo o transferencia
Seleccioná **Efectivo** o **Transferencia**.
Verificá nombre, apellido, email y documento.
Presioná **Registrar pago**. La operación queda asentada de inmediato y Fint muestra la confirmación de venta.
## Cobrar con dispositivo Point
Confirmá que la caja mostrada corresponde a este puesto y presioná **Enviar cobro al dispositivo**.
Fint muestra primero “Enviando el cobro”, después “Esperando el dispositivo” y, cuando el equipo lo toma, “El cliente está pagando”.
El cliente sigue las instrucciones del equipo. No cierres ni repitas la operación mientras el cobro esté pendiente.
Cuando Mercado Pago lo aprueba, Fint registra la venta automáticamente y abre la pantalla de confirmación.
Si el Point no toma el cobro después de unos segundos, revisá que esté encendido y tocá **Actualizar** en el equipo o presioná su botón de encendido.
## Cobrar con QR
Elegí **QR Mercado Pago** y presioná **Generar QR**. Fint muestra el código de la caja y su tiempo restante; el cliente lo escanea desde Mercado Pago y paga.
Mientras el pago se confirma, el QR puede quedar atenuado y Fint sigue consultando el estado. Si vence o es rechazado, podés **Regenerar QR** o **Cambiar método**.
Una caja no puede tener dos cobros QR activos al mismo tiempo. Si Fint encuentra uno anterior, muestra **Cancelar el cobro anterior** antes de permitir el nuevo intento.
## Pago combinado
Seleccioná **Combinado** y distribuí el total entre:
* Efectivo.
* Transferencia.
* Dispositivo Point, si está disponible.
* QR, si está disponible.
Podés escribir cada monto o usar **Resto** para asignar lo que falta a un medio. La pantalla indica **Falta asignar**, **Sobra** o **Listo para cobrar**.
![Pago combinado repartido entre varios medios]()
La combinación es válida cuando:
* Usa al menos dos medios con importe mayor a cero.
* Las partes suman exactamente el total.
* No incluye Point y QR a la vez: puede haber como máximo un cobro procesado por el proveedor en la venta.
* La porción de Point o QR, si existe, alcanza el mínimo de 30 unidades de la moneda de la organización.
Podés combinar efectivo y transferencia, o sumar una de esas partes a Point o QR. Los pagos manuales se registran recién cuando el cobro del proveedor queda aprobado.
## Cancelar un cobro en curso
Mientras Point o QR está en creación, pendiente o en el dispositivo, el botón `×` solicita cancelar **el cobro activo**, no la orden completa.
El resultado puede ser:
* **Cobro abortado:** podés elegir otro medio.
* **Cancelación pedida:** Fint espera la confirmación del proveedor.
* **Ya finalizado:** el proveedor ya tenía un resultado definitivo.
* **Ya aprobado:** no se fuerza la cancelación; Fint conserva la aprobación para evitar inconsistencias.
No inicies otro cobro hasta que Fint muestre el resultado de la cancelación.
## Rechazos y vencimientos
Cuando un cobro no se completa, la pantalla ofrece:
* **Reintentar cobro** para Point.
* **Regenerar QR** para QR.
* **Cambiar método** para volver al selector sin perder la orden.
Los intentos rechazados también quedan disponibles en **Ventas** mediante el filtro de estado **Rechazado**, junto con el motivo y las referencias del proveedor.
## Cuando el resultado es incierto
Si Fint no puede determinar si el equipo aprobó o rechazó, el cobro pasa a **Esperando verificación manual**.
Revisá el resultado real y el comprobante en el dispositivo. No decidas por el estado visual del navegador solamente.
El aviso superior indica que existe un cobro para resolver. Presioná **Resolver**.
La pantalla exige una nota, por ejemplo el resultado y número de cupón del equipo.
Elegí **Se aprobó** o **Se rechazó**. Si Mercado Pago ya informó un resultado definitivo, Fint conserva ese estado y te lo muestra.
## Confirmación y siguiente venta
Al completar el cobro aparece **La venta se registró correctamente**, el nombre del cliente cuando corresponde y el número de operación si está disponible.
![Confirmación de una venta registrada correctamente]()
Presioná **Crear otra orden** para limpiar el resumen y volver al catálogo.
## Próximos pasos
Controlá resultados e intentos
Revisá cómo se calcula el total
Solucioná medios no disponibles
# Catálogo y configuración
Source: https://docs.fint.app/docs/guides/pos-configuracion
Prepará el catálogo, los grupos y las reglas de identificación del comprador
Cada punto de venta tiene su propio catálogo y organización visual. Esta configuración la realiza un administrador; después, el cajero encuentra todo listo al entrar a **Inicio**.
## Crear el punto de venta
Entrá a **Punto de Venta → Puntos de venta**.
Presioná **Crear**, escribí un nombre que identifique el espacio —por ejemplo, “Tienda escolar”— y confirmá con **Crear**.
Seleccioná la tarjeta del punto de venta. En el menú lateral vas a encontrar **Inicio**, **Items**, **Grupos**, **Ventas** y **Config**.
Desde el menú de la tarjeta también podés **Duplicar** el punto de venta o exportar sus ventas a Excel. La copia sirve como base para otra sede y después se configura por separado.
## Preparar productos
Antes de asociar un producto, [creá un item de Venta online](/docs/guides/items-descuentos#crear-un-item-de-venta-online) con estas características:
* Tipo **Venta online**.
* Vigencia de **pago único**.
* Precio y stock correctos.
Antes de asociarlo al POS, dejalo en estado **Activo** para distinguirlo de productos que todavía estás preparando.
Encontrás el resto de la configuración general en [Items y Descuentos](/docs/guides/items-descuentos).
### Agregarlos al POS
En el menú lateral del punto de venta, elegí **Items**.
Presioná **Agregar**, buscá los productos y marcá todos los que querés incluir. La opción **Seleccionar todos** actúa sobre los resultados visibles de la búsqueda.
Confirmá con **Guardar**. La tabla muestra producto, precio, stock y estado. Para retirarlo de este POS, abrí su menú y elegí **Quitar del punto de venta**.
![Administración de productos asociados a un punto de venta]()
Quitar un producto del punto de venta no elimina el item general ni sus ventas anteriores; solamente deja de ofrecerlo en este POS.
## Organizar el catálogo con grupos
Los grupos funcionan como filtros rápidos del catálogo: por ejemplo, **Libros** e **Indumentaria**. La pantalla se llama **Grupos** y el formulario usa el término **categoría** para cada grupo.
1. Entrá a **Grupos** y presioná **Nueva categoría**.
2. Definí un nombre y un color.
3. Usá **Agregar items** o **Editar items** para elegir los productos del grupo.
4. Desde el menú de cada tarjeta podés renombrar, cambiar sus items o eliminar el grupo.
Un producto puede pertenecer a más de un grupo. En **Inicio**, el cajero puede filtrar por esos grupos y ordenar el catálogo por frecuencia, uso reciente, nombre o categoría.
![Grupos Libros e Indumentaria configurados en la tienda escolar]()
![Catálogo del POS con buscador, grupos y productos disponibles]()
## Configurar la identificación del comprador
Entrá a **Config** para editar el nombre del punto de venta y decidir si se permiten ventas a **Consumidor final**.
![Configuración de compra anónima y límite del punto de venta]()
Dejá desactivado **Permitir compra anónima**. Las ventas deben identificar a una persona. El momento y el formulario dependen del rol y del medio de pago.
Activá **Permitir compra anónima** y definí el **Monto máximo anónimo**. Si la orden no supera ese tope, Fint muestra “Consumidor final” y permite seguir sin seleccionar un contacto.
El administrador puede elegir el contacto mientras arma la orden. El cajero lo selecciona al cobrar con Point o QR; en cobros manuales, Fint puede pedir los datos del comprador en el paso de pago.
## Elegir la caja de esta computadora
Cuando el POS tiene más de una caja, Fint pregunta cuál usa ese dispositivo. También podés cambiarla desde **Config → Cajas y dispositivos → Caja de este dispositivo**.
La elección se guarda localmente en el navegador. Esto permite que dos mostradores entren al mismo POS y cada uno conserve su propia caja.
## Próximos pasos
Asociá el mostrador y Point
Armá la primera orden
Administrá catálogo y stock
# Aplicar descuentos
Source: https://docs.fint.app/docs/guides/pos-descuentos
Combiná descuentos guardados y manuales con alcance y condiciones diferentes
Una misma orden puede tener **varios descuentos**. Cada uno conserva su valor, alcance y regla de activación, por lo que podés descontar productos distintos y sumar además una promoción global.
## Dos formas de descontar
Se configura previamente en **Items → Descuentos**. Es reutilizable, tiene nombre propio y puede definir alcance y una cantidad mínima de activación.
Se crea durante la venta. Puede ser un monto fijo o porcentaje sobre toda la orden o sobre productos concretos.
## Preparar un descuento guardado
Entrá a **Items → Descuentos**, presioná **Crear** y elegí el tipo **Venta online**. Ese es el tipo que el POS reconoce para descuentos presenciales.
Ingresá nombre, descripción, valor de **Monto Fijo** o **Porcentaje** y stock disponible.
En **Condiciones**, elegí todos los items, algunos items o todos excepto algunos. Esta selección determina la base sobre la que se calcula el descuento.
Activá **Requerir una cantidad mínima de productos**, ingresá la cantidad y elegí qué productos cuentan para alcanzarla.
Guardalo y dejalo en estado **Activo**. El POS muestra descuentos de Venta online activos; también valida su stock al usarlos.
Encontrás la configuración general en [Items y Descuentos](/docs/guides/items-descuentos).
## Alcance y activación son cosas distintas
Esta separación permite promociones como “llevando dos prendas, 5% sobre toda la compra”:
* **Aplica sobre:** define qué líneas reciben el descuento. En el ejemplo, **Todos los items**.
* **Cantidad mínima:** define cuándo se habilita. En el ejemplo, `2`.
* **Productos que cuentan:** define qué unidades activan la regla. En el ejemplo, remera y buzo.
Los productos que activan la promoción no tienen que ser los mismos que reciben el descuento. Esa diferencia es intencional.
Si no elegís productos calificadores, cuentan todas las unidades de productos del catálogo presentes en la orden. Los items de monto libre no activan esta condición.
![Descuento del cinco por ciento con mínimo de dos productos y Remera escolar y Buzo escolar como calificadores]()
## Aplicar descuentos guardados
Con productos en la orden, presioná **Descuento**.
Hacé clic en cada tarjeta. El ícono de información muestra la regla de alcance y, si existe, la cantidad mínima.
La sección **Seleccionados** muestra cada descuento y el importe calculado. Podés quitar uno sin perder los demás.
Presioná **Aplicar N descuentos**. Fint solo habilita la acción cuando la combinación es válida.
![Descuentos guardados de la tienda escolar disponibles para combinar]()
Después de elegirlos, revisá la base y el importe de cada regla antes de confirmar:
![Combinación de cuatro descuentos seleccionados antes de aplicarlos]()
## Crear descuentos manuales
Elegí la tarjeta **Descuento personalizado** y completá:
1. **Monto fijo** o **Porcentaje**.
2. **Aplicar sobre** toda la orden o uno o más productos del catálogo presentes en ella.
3. El valor; un porcentaje no puede superar el 100%.
4. Una descripción opcional, útil para identificarlo en la orden. En Reportes, los descuentos manuales se agrupan como **Descuentos manuales**.
5. **Agregar a la combinación**.
Podés mezclar descuentos manuales con guardados antes de aplicar la combinación, hasta un máximo de 50 descuentos por orden.
![Descuento personalizado del diez por ciento aplicado a un producto]()
El selector individual del descuento manual lista productos del catálogo. Para incluir también items de monto libre, elegí **Toda la orden**.
## Cómo se combinan
Fint calcula cada descuento contra su **base original elegible** y suma los importes. No aplica un porcentaje sobre el resultado ya reducido por el descuento anterior.
Este ejemplo fue calculado con una orden de cinco productos:
| Regla | Base | Descuento |
| ----------------------------------------------------- | --------: | --------: |
| 25% sobre Libro de actividades | \$18.000 | \$4.500 |
| 10% sobre Libro de lectura | \$22.000 | \$2.200 |
| 25% sobre Guía de estudio | \$20.000 | \$5.000 |
| 5% global, activado por Remera escolar y Buzo escolar | \$127.000 | \$6.350 |
El subtotal es \$127.000, los cuatro descuentos suman \$18.050 y el total final es \$108.950.
![Orden con varios descuentos aplicados y total recalculado]()
Si cambiás una cantidad después de aplicar descuentos, Fint vuelve a pedir una vista previa y recalcula la orden automáticamente.
## Si una regla deja de aplicar
Fint valida la combinación antes de aplicarla y otra vez antes de cobrar. Comprueba las condiciones de cantidad, los productos alcanzados, los topes configurados y que el descuento no supere el importe elegible.
Si una regla deja de aplicar, Fint muestra el motivo —por ejemplo, “Se requieren al menos 2 productos calificadores”— y bloquea la combinación hasta que corrijas la orden o quites esa regla.
## Editar una orden descontada
Desde **Orden actual** podés:
* Abrir otra vez **Descuento** para sumar o quitar reglas.
* Quitar un descuento individual desde la línea correspondiente.
* Cambiar cantidades y esperar el recálculo.
* Limpiar toda la orden, lo que también elimina la combinación.
## Próximos pasos
Productos y monto libre
Confirmá el total final
Creá reglas reutilizables
# Armar la orden
Source: https://docs.fint.app/docs/guides/pos-venta
Armá la orden, elegí al cliente y agregá productos o montos libres
La pantalla **Inicio** reúne el catálogo a la izquierda y la **Orden actual** a la derecha. El total se actualiza mientras agregás unidades, items libres y descuentos.
![Orden del POS con productos, cantidades y total]()
## 1. Elegir la caja
Si este navegador todavía no tiene una caja elegida y el POS tiene varias, Fint abre **Seleccionar caja**. Elegí la que corresponde a este mostrador.
La caja determina si después vas a poder elegir Point o QR. Podés cambiarla desde **Config → Caja de este dispositivo** antes de iniciar el cobro.
## 2. Identificar al cliente
La experiencia depende del rol y del medio de pago:
En la orden, presioná **Elegir cliente**. Podés buscar un contacto o crearlo sin salir de la venta.
En cobros con Point o QR, elegí o creá el contacto en el paso de pago. Para efectivo o transferencia, Fint puede solicitar los datos del comprador antes de registrar el pago.
Si la compra anónima está habilitada y el total no supera el máximo, Fint permite continuar sin seleccionar un contacto.
Cuando la venta no califica como Consumidor final, Point y QR requieren un contacto seleccionado.
## 3. Agregar productos
Hacé clic sobre un producto para sumarlo. Podés buscar por nombre, filtrar por grupo y ordenar por:
* Más frecuentes.
* Recientes.
* Nombre de producto de A a Z.
* Categoría de A a Z.
En **Orden actual**, usá `+` y `−` para cambiar la cantidad. Los productos sin stock se muestran deshabilitados y no se pueden agregar.
El stock se valida nuevamente al iniciar el checkout. Si cambió desde que abriste el catálogo, Fint identifica el producto sin stock y no crea la sesión de pago.
## 4. Agregar un item de monto libre
Usá **Item de monto libre** para cobrar algo que no está preparado en el catálogo.
En la parte inferior de la orden, presioná **Item de monto libre**.
Cargá un monto mayor a cero con el teclado en pantalla o el teclado físico.
Presioná **+ Agregar descripción** para poner un concepto reconocible. Si lo dejás vacío, la línea se guarda como “Item de monto libre”.
Confirmá con **Agregar item**. Después podés modificar su cantidad desde la orden igual que un producto.
![Carga de un item de monto libre con descripción opcional]()
Un item de monto libre existe solamente dentro de esa venta: no se agrega al catálogo general ni crea stock.
## 5. Revisar o limpiar la orden
Antes de cobrar, verificá:
* Cliente o Consumidor final.
* Productos y cantidades.
* Items de monto libre.
* Descuentos aplicados y sus importes.
* Total final.
El ícono de papelera limpia los items, los descuentos y el cliente después de pedir confirmación. Si ya existía una sesión de checkout, Fint la cancela antes de vaciar la orden y libera las reservas.
## 6. Continuar al pago
Presioná **Continuar al pago**. Fint valida de nuevo los descuentos, el total y el stock, crea una sesión temporal y muestra **Método de pago**.
Durante el checkout aparece un contador. Volver a la orden cancela la sesión; si vence, Fint libera la reserva.
Si el navegador se recarga durante un cobro Point o QR, Fint intenta recuperar la sesión de ese mismo navegador en vez de iniciar otra venta encima.
La interfaz del POS exige un total mínimo de **30 unidades de la moneda configurada para la organización** para iniciar el cobro.
## Próximos pasos
Guardados, manuales y múltiples
Elegí el medio y confirmá
Productos y grupos
# Ventas y reportes
Source: https://docs.fint.app/docs/guides/pos-ventas-reportes
Consultá operaciones, intentos rechazados, descuentos y resultados por punto de venta
Fint ofrece dos niveles de seguimiento:
* **Ventas** dentro de cada punto de venta, para la operación diaria.
* **Reportes**, para analizar uno o todos los puntos de venta de la organización.
## Listado de ventas
Entrá al punto de venta y elegí **Ventas**. La tabla muestra cliente, fecha, medio de pago, importe y estado.
![Listado de ventas del POS con búsqueda y filtros]()
Podés buscar por cliente y filtrar por:
* Estado: exitoso, pendiente, parcialmente pagado, cancelado, borrador o rechazado, según los datos disponibles.
* Medio: efectivo, transferencia, dispositivo, QR, combinado u otros métodos registrados.
La vista inicial muestra ventas y oculta los intentos fallidos. Para investigarlos, elegí **Rechazado** en el filtro de estado.
## Revisar un intento rechazado
Al seleccionar una fila rechazada, Fint abre **Intento de cobro** con:
* Importe y estado.
* Motivo del rechazo, si el proveedor lo informó.
* Método y caja utilizados.
* Fecha del intento.
* Los identificadores disponibles de orden, operación y referencia del proveedor.
Podés tocar los identificadores disponibles para copiarlos y buscar el movimiento en el panel de Mercado Pago.
Los intentos vencidos o cancelados no aparecen en ese filtro. **Rechazado** muestra solo los intentos que requieren investigación.
## Resolver verificaciones pendientes
Si un cobro queda en estado incierto, aparece un aviso arriba de la tabla. Presioná **Resolver**, verificá el equipo físico, escribí una nota y elegí **Se aprobó** o **Se rechazó**.
La pantalla exige una nota que describa la evidencia observada. Si Mercado Pago ya confirmó un resultado, Fint prioriza esa información y te muestra qué resultado aplicó.
## Exportar las ventas de un POS
Desde el listado general de puntos de venta, abrí el menú `…` de una tarjeta y elegí **Exportar ventas (Excel)**. Podés indicar **Desde** y **Hasta** o dejar ambos vacíos para incluir todos los períodos.
El archivo se descarga con el nombre del punto de venta para facilitar su archivo y conciliación.
El archivo respeta el alcance del usuario: un cajero sin permiso para ver ventas ajenas exporta solo las operaciones propias de ese POS.
## Reportes generales
Los administradores pueden entrar a **Punto de Venta → Reportes** y elegir un punto de venta particular o ver todos.
El tablero incluye:
Ventas totales, cantidad de órdenes, unidades y ticket promedio.
Unidades y monto cobrado por día, con vistas de 30 días, 90 días o todo el historial.
Productos más vendidos y un detalle buscable con unidades, órdenes e importe bruto.
Cantidad, monto y participación de cada medio.
Total descontado, órdenes con descuento, usos e importe de cada regla.
Excel por rango de fechas para un POS o para todos los seleccionados.
![Reporte filtrado por Tienda escolar con ventas, órdenes, unidades, ticket promedio y gráficos]()
### Ver todos o un punto de venta
El selector superior recuerda la última elección en ese navegador. Elegí **Todos los puntos de venta** para el consolidado o uno específico para analizarlo por separado.
No se pueden consolidar puntos de venta con monedas diferentes. En ese caso, elegí uno en particular para ver sus resultados.
## Qué revisar al cerrar el día
En **Ventas**, elegí el estado **Rechazado** y revisá si hay intentos que necesiten seguimiento.
No dejes cobros en “Esperando verificación manual”. Contrastá cada uno con el equipo físico.
En **Reportes**, compará los importes de efectivo, transferencia y Mercado Pago con tu cierre externo. Una venta combinada aparece distribuida entre los medios que la componen.
Descargá el Excel del período y conservá las referencias del proveedor para cualquier diferencia.
## Próximos pasos
Rechazos, cancelación y verificación
Entendé el total descontado
Historial general de cobros
# Descripción general
Source: https://docs.fint.app/docs/guides/punto-de-venta
Configurá tu mostrador, armá órdenes y cobrá ventas presenciales desde Fint
El módulo **Punto de Venta** reúne el catálogo, el stock, los clientes y los pagos de tus ventas presenciales. Podés cobrar en efectivo, por transferencia o con varios medios en una misma venta. En organizaciones de Argentina, también podés usar Point y QR de Mercado Pago.
![Listado de puntos de venta disponibles en Fint]()
## Cómo se organiza
Es el espacio de trabajo del cajero. Define qué productos puede vender, cómo se agrupan y qué configuración usa.
Vincula el punto de venta con Point y QR. Puede tener un dispositivo, un QR o ambos.
Es la terminal física sincronizada con Mercado Pago. Para recibir cobros desde Fint debe estar asignada a una caja y en modo **PDV**.
```mermaid theme={null}
flowchart LR
A[Productos e items] --> B[Punto de venta]
C[Caja] --> B
D[Dispositivo o QR] --> C
B --> E[Orden]
F[Descuentos] --> E
E --> G[Cobro]
G --> H[Venta y reportes]
```
Los administradores crean puntos de venta y administran productos, grupos, cajas y reportes.
Al invitar o editar un **Cajero**, definen sus puntos de venta, cajas y visibilidad sobre ventas de otros cajeros. En cada POS permitido, el cajero opera desde **Inicio** y **Ventas**.
Consultá [Miembros y roles](/docs/guides/miembros-y-roles) para configurar ese acceso.
## Preparación inicial
Configurá estos elementos en este orden:
1. **Productos:** [creá items de tipo **Venta online**](/docs/guides/items-descuentos#crear-un-item-de-venta-online), con pago único y stock disponible.
2. **Integración:** si vas a cobrar con Point o QR, [conectá Mercado Pago](/docs/guides/conectar-mercado-pago).
3. **Punto de venta:** entrá a **Punto de Venta → Puntos de venta**, presioná **Crear** y usá un nombre claro, como “Tienda escolar”.
4. **Caja:** creá o asociá una caja, vinculala al punto de venta y, si corresponde, asignale el dispositivo.
5. **Equipo:** [creá o editá un miembro con rol **Cajero**](/docs/guides/miembros-y-roles#configurar-un-cajero-para-punto-de-venta) y definí qué puntos de venta, cajas y ventas puede consultar.
![Creación de un punto de venta con un nombre identificable]()
## Flujo de trabajo
[Agregá productos y grupos](/docs/guides/pos-configuracion). Después [asociá la caja y, si corresponde, el dispositivo](/docs/guides/pos-cajas-dispositivos).
[Invitá a los cajeros y limitá sus puntos de venta, cajas y visibilidad de ventas](/docs/guides/miembros-y-roles#configurar-un-cajero-para-punto-de-venta).
[Seleccioná al cliente, agregá productos o un item de monto libre y revisá las cantidades](/docs/guides/pos-venta).
[Combiná descuentos guardados y manuales con alcance global o por producto](/docs/guides/pos-descuentos).
[Elegí el medio y resolvé excepciones](/docs/guides/pos-cobros). Luego [consultá la venta o los reportes](/docs/guides/pos-ventas-reportes).
## Límites importantes
* El catálogo del POS acepta items de tipo **Venta online**, con vigencia de **pago único**.
* La interfaz del POS exige que la orden alcance un mínimo de **30 unidades de la moneda de la organización** para pasar al cobro.
* Los descuentos guardados del POS deben ser de tipo **Venta online**, estar activos y tener stock disponible.
* Point y QR están disponibles para organizaciones de **Argentina** y aparecen como medios de pago solo si la caja elegida está lista para ese canal.
* La caja elegida queda guardada en el navegador de ese dispositivo. Elegirla en una computadora no cambia la selección de otra.
## Próximos pasos
Catálogo, grupos y compra anónima
Prepará Point y QR
Operación diaria del cajero
# Órdenes y Liquidaciones
Source: https://docs.fint.app/docs/guides/solicitudes-pago
Generá facturas individuales o masivas, y gestioná todo el ciclo de cobro desde un solo lugar
Una **orden** es una factura individual que un cliente debe pagar. El módulo de **Órdenes** centraliza toda la facturación en tres tabs:
Todas las facturas individuales, sin importar su origen
Facturación masiva basada en items asignados a clientes
Cobros recurrentes generados desde Links de Pago
***
## Órdenes
### ¿De dónde vienen las órdenes?
Cada orden tiene un origen distinto, pero todas se gestionan desde el mismo lugar:
Creadas por un administrador para cobros puntuales
Generadas masivamente al ejecutar una [liquidación](#liquidaciones)
Creadas cuando alguien compra desde un [Link de Pago](/docs/guides/links-pago)
Generadas periódicamente por una [suscripción activa](/docs/guides/suscripciones)
Creadas al vender entradas de un [Evento](/docs/guides/eventos)
### Listado de Órdenes
El listado muestra todas las órdenes con su **número**, **descripción**, **fecha de vencimiento**, **cliente**, **importe** y **estado**. Usá el buscador para encontrar órdenes por nombre del cliente o descripción, y los filtros de **Estado** y **Etiquetas** para acotar resultados. Las fechas de vencimiento superadas se muestran en rojo.
![Listado de órdenes con estados Por Cobrar, Pagada y Pago Parcial]()
### Estados de una Orden
Enviada, pendiente de pago
Pagada en su totalidad
Un administrador registró un pago parcial
Cancelada administrativamente
Los descuentos redujeron el monto a cero
Por cobrar con la fecha de vencimiento superada
"Vencida" no es un estado aparte sino un filtro: una orden **Por cobrar** (o con **Pago parcial**) cuya fecha de vencimiento ya pasó. En el listado, esas fechas se muestran en rojo.
### Detalle de una Orden
Al hacer clic en una orden, se abre un panel con toda la información:
* **Cliente**: Nombre y etiquetas del cliente (clickeable para ir a su perfil)
* **Actividad**: Timeline con el historial de cambios de la orden
* **Items**: Desglose de los conceptos facturados y el total
* **Pagos**: Pagos asociados a esta orden (manuales u online)
* **Detalle**: Número de orden, cliente, importe base, total pagado, estado, fecha de vencimiento y origen (ej: de qué liquidación proviene)
Si la orden está vencida y sus items generan intereses, el desglose muestra el **Interés por mora acumulado** como un renglón más (en rojo). El interés se calcula al momento de consultar la orden, según las reglas de [Intereses por Mora](/docs/guides/configuracion#intereses-por-mora).
![Detalle de una orden vencida con el interés por mora acumulado]()
### Crear una Orden Manual
Para cobros puntuales que no forman parte de una liquidación:
**Venta online** (items de pago único) o **Liquidación** (items de liquidación del período).
![Selección del tipo de factura: venta online o liquidación]()
Seleccioná el **cliente**, la **fecha de emisión** y la **fecha de vencimiento**, agregá una **descripción** opcional y sumá los **items** a facturar con "+ Agregar item". El importe total surge de los items seleccionados.
![Formulario de creación de una orden con vista previa]()
Activá el toggle **"Enviar por correo electrónico"** para que el cliente reciba la factura por email con un enlace al [Portal de Contacto](/docs/guides/portal-contacto) donde puede pagarla.
La vista previa de la derecha muestra cómo se verá la factura. Cuando esté lista, confirmá para crearla.
### Importar desde Excel
Para crear múltiples órdenes de una vez, hacé clic en **"Importar Excel"**, descargá el modelo con las columnas correctas, completalo y subilo.
### Exportar
Hacé clic en **"Exportar"** para descargar las órdenes en formato Excel.
***
## Liquidaciones
La liquidación es la herramienta central de facturación masiva. En lugar de crear órdenes una por una, Fint genera automáticamente una orden para cada cliente basándose en los [items de liquidación](/docs/guides/items-descuentos) que tenga asignados.
### ¿Cómo funciona?
La liquidación es completamente **item-céntrica**: vos configurás los items y los asignás a clientes, y la liquidación se encarga del resto.
Al crear una liquidación para un período (ej: Marzo 2024), Fint busca todos los clientes que tengan items de liquidación pendientes para ese mes — es decir, items cuya vigencia incluya ese período y que todavía no tengan una orden generada. Con esa información, crea **una orden por cliente** que incluye todos sus items aplicables y sus [descuentos](/docs/guides/items-descuentos#descuentos) correspondientes.
Solo se incluyen los clientes con condición **Activo**. Los clientes dados de baja no generan órdenes.
![Liquidación en borrador: una orden por estudiante con los descuentos ya aplicados]()
Cada orden incluye todos los items del cliente con sus [descuentos](/docs/guides/items-descuentos#descuentos) aplicados automáticamente.
### Crear una Liquidación
Hacé clic en **"+ Nueva Liquidación"** e ingresá un **nombre** descriptivo (ej: "Cuota Marzo"), el **período** (mes y año) y la **fecha de vencimiento** de las órdenes.
La liquidación se crea en estado **Borrador** junto con todas sus órdenes. Este es el momento de revisar que todo esté correcto: los clientes incluidos, los items facturados y los montos calculados.
Podés buscar órdenes dentro de la liquidación y filtrar por **etiquetas** del cliente. Al hacer clic en una orden, ves su detalle completo con el desglose de items.
Cuando todo esté correcto, enviá la liquidación. Esto cambia cada orden de borrador a **Por cobrar** y envía un **email a cada cliente** con su factura y un enlace al [Portal de Contacto](/docs/guides/portal-contacto) para pagar.
### Corregir Errores en Borrador
Mientras la liquidación está en borrador, es un **reflejo en vivo** de los items asignados a tus clientes. No se editan los montos ni las órdenes directamente — todo se gestiona desde los items:
* **Sobra una orden**: Desvinculá el item del cliente (desde [Items y Descuentos](/docs/guides/items-descuentos) o desde el detalle de la orden dentro de la liquidación). La orden desaparece automáticamente.
* **Falta una orden**: Asigná el item al cliente que falta. La liquidación se actualiza sola con la nueva orden.
* **Monto incorrecto**: Revisá los items y descuentos asignados al cliente y corregí lo que corresponda.
Si eliminás un item desde el detalle de una orden en la liquidación, eso también **desvincula al cliente de ese item para futuras liquidaciones**. Fint te pide confirmación antes de hacerlo.
### Descuentos y Casos Especiales
Los descuentos se aplican automáticamente al generar la liquidación. Hay dos situaciones especiales:
* **Monto = \$0** (bonificación total): La orden se genera con estado **Bonificado**. No requiere pago, pero queda registrada.
* **Monto negativo**: Indica un error en la configuración de descuentos. La liquidación **no se puede enviar** hasta que se corrija. Las órdenes con problemas se marcan visualmente para que puedas identificarlas rápido.
### Cancelar una Liquidación
Podés cancelar una liquidación ya enviada. Esto elimina todas las órdenes que aún no fueron pagadas — las que ya tienen un pago registrado se mantienen intactas.
Solo podés tener **una liquidación en borrador** por período. Si necesitás crear otra para el mismo mes, primero enviá o eliminá la que está en borrador.
### Intereses por Mora
Si un item tiene activado **"Generar intereses por mora"** (configurado en [Items y Descuentos](/docs/guides/items-descuentos)), los intereses se calculan automáticamente cuando la orden supera la fecha de vencimiento. El porcentaje de interés se define en [Configuración](/docs/guides/configuracion).
### Listado de Liquidaciones
El listado muestra todas las liquidaciones con su **nombre**, **período**, **cantidad de clientes**, **monto total a cobrar** y **estado**. Podés filtrar por **Estado** y **Período**.
![Listado de liquidaciones: una enviada y una pendiente en borrador]()
***
## Preguntas Frecuentes
No se genera orden para ese cliente. Asegurate de tener los [items configurados](/docs/guides/items-descuentos) y asignados antes de liquidar.
No, cada liquidación se ejecuta manualmente para que puedas revisar los montos antes de enviar.
Solo un **administrador** puede registrar pagos parciales de forma manual. Desde el Portal de Contacto, el cliente paga el monto completo.
## Próximos Pasos
Configurá los conceptos antes de liquidar
Historial de pagos recibidos
Enviá recordatorios de pago
# Suscripciones
Source: https://docs.fint.app/docs/guides/suscripciones
Cobrá de forma recurrente con pagos periódicos automáticos
Las suscripciones se generan automáticamente cuando un comprador adquiere un **item recurrente** desde un [Link de Pago](/docs/guides/links-pago). No es un tipo de link diferente — la recurrencia se configura en el item.
Cómo funciona el cobro recurrente, gestionar suscripciones activas y diferencia con liquidaciones.
## Ver suscripciones activas
Las suscripciones se gestionan desde la tab **Suscripciones** dentro del módulo de [Órdenes](/docs/guides/solicitudes-pago). Ahí podés ver el listado completo con cliente, página de origen, intervalo, artículos y estado.
![Listado de suscripciones con página de origen, intervalo y estado]()
Al hacer clic en una, ves su detalle: fecha de inicio, finalización, medio de pago, historial de facturas generadas, calendario de **próximas facturas** y el registro de actividad (cobros exitosos y fallidos incluidos).
![Detalle de una suscripción: facturas emitidas y próximas facturas proyectadas]()
## Estados
Genera una factura por período en la fecha que corresponde
Creada pero con el primer cobro aún sin confirmar
Completó todos sus ciclos de cobro
Dada de baja por el administrador — no genera más órdenes
## Casos de uso
* **Cursos online**: Cobro mensual mientras el cliente esté inscripto
* **Membresías**: Acceso a gimnasio, club o servicios
* **Servicios adicionales**: Comedor, transporte, actividades extra
* **Planes de pago**: Cuotas mensuales para matrículas
## Próximos Pasos
Creá páginas de venta online
Configurá items recurrentes
Gestioná las facturas generadas
# Bienvenido a Fint
Source: https://docs.fint.app/docs/introduction
Gestión de cobranzas inteligente para instituciones educativas
Fint es la plataforma de gestión de cobranzas para colegios, universidades, academias y todo tipo de instituciones educativas: cuotas, venta online, eventos y suscripciones, con cobro online y seguimiento de deuda en un solo lugar.
## ¿Cómo funciona Fint?
Hay dos maneras de cobrar, y las podés combinar:
Definís tus [items](/docs/guides/items-descuentos) (cuota, comedor, matrícula) y se los asignás a tus estudiantes. Cada mes ejecutás una [liquidación](/docs/guides/solicitudes-pago) que genera una orden de pago por estudiante — con descuentos e [intereses por mora](/docs/guides/configuracion#intereses-por-mora) aplicados automáticamente.
Publicás [links de pago](/docs/guides/links-pago) para venta online y [suscripciones](/docs/guides/suscripciones), o vendés entradas con [eventos](/docs/guides/eventos). Acá no asignás nada: la gente compra desde una página pública.
Vengan de donde vengan, todos los cobros terminan en el mismo lugar: las **[órdenes](/docs/guides/solicitudes-pago)** (lo que hay que cobrar) y los **[pagos](/docs/guides/pagos)** (lo que ya entró). Las familias consultan y pagan desde su [Portal de Contacto](/docs/guides/portal-contacto), y si tenés [ARCA conectado](/docs/guides/facturacion-arca), los comprobantes se [emiten solos con reglas](/docs/guides/facturacion).
## Primeros pasos
Nombre, marca, equipo y recordatorios en [Configuración](/docs/guides/configuracion).
Por ejemplo [Mercado Pago](/docs/guides/conectar-mercado-pago), para cobrar online.
Importá tus [estudiantes](/docs/guides/clientes) desde Excel y creá tus [items y descuentos](/docs/guides/items-descuentos).
Ejecutá tu primera [liquidación](/docs/guides/solicitudes-pago), o publicá un [link de pago](/docs/guides/links-pago) o [evento](/docs/guides/eventos).
Cada guía incluye capturas reales de la aplicación y, en la mayoría de los casos, un **video tutorial** paso a paso.
## Todas las guías
### Cobranzas
Lo que cobrás y las reducciones que aplicás
Facturación masiva y todas las órdenes de pago
Todo lo cobrado: online, manual y conciliado
Comprobantes de ARCA, automáticos o manuales
### Estudiantes y familias
Perfiles, etiquetas, responsables de pago y estado financiero
Donde las familias consultan deudas y pagan
### Canales de venta
Vendé productos y servicios online
Cobros recurrentes que nacen de un link
Entradas con QR y control de asistentes
El escáner para el día del evento
### Comunicación y configuración
Comunicados por email con estadísticas
La evolución de tu cobranza de un vistazo
Marca, equipo, recordatorios, mora e integraciones
Vinculá tu cuenta y cobrá online en minutos
Certificados y autorización para facturar
## Para Desarrolladores
Si necesitás integrar Fint con otros sistemas, visitá la [documentación para desarrolladores](/developers/introduction) y la [referencia de la API](/api-reference/introduction).
## Soporte
¿Necesitás ayuda? Contactá a nuestro equipo en [soporte@fint.app](mailto:soporte@fint.app).