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

# Contactos, empresas y deals

> Cómo se organiza tu cartera: leads, empresas, oportunidades, embudos y quién ve qué.

> [!NOTE]
>
> Requisito: haber completado la [configuración inicial](https://help.clientix.io/configuracion-inicial.md) (dominio verificado). Sin ella el CRM no se puede usar.

## Qué es cada cosa

| Concepto | Qué representa |
| - | - |
| **Contacto** | Una persona con la que hablas: nombre, correo, teléfono y la empresa donde trabaja |
| **Lead** | Un contacto que todavía está en etapa inicial. **No es un registro aparte**: es un contacto cuya etapa de vida es *lead* |
| **Empresa** | La organización a la que le vendes (puede tener varios contactos) |
| **Deal** | Una oportunidad de venta con un monto, una fecha estimada de cierre y una etapa del embudo |
| **Embudo (pipeline)** | La lista ordenada de etapas por las que pasa un deal hasta ganarse o perderse |

### Etapa de vida de un contacto

`lead` → `qualified` (calificado) → `customer` (cliente) → `lost` (perdido). Cambiarla no duplica ni mueve datos: es el mismo contacto.

## El embudo que ya trae tu empresa

Al crear tu cuenta recibes un embudo llamado **Ventas** con estas etapas:

| Etapa | Probabilidad de cierre | Tipo |
| - | - | - |
| Nuevo | 10 % | Abierta |
| Contactado | 25 % | Abierta |
| Propuesta | 50 % | Abierta |
| Negociación | 75 % | Abierta |
| Ganado | 100 % | Ganada |
| Perdido | 0 % | Perdida |

* Un deal nuevo empieza en la **primera etapa** del embudo.
* Al moverlo a una etapa **Ganada** o **Perdida** el deal se **cierra**. Si lo devuelves a una etapa abierta, se reabre.
* Cada movimiento queda guardado con quién lo hizo y cuándo; ese historial no se puede modificar.
* Un deal solo puede moverse a etapas **de su propio embudo**.

### Personalizar el embudo

Dueños y gerentes pueden crear otros embudos (por ejemplo "Soporte" o "Renovaciones"), renombrarlos, y agregar, reordenar o quitar etapas.

> [!WARNING]
>
> No se puede eliminar una etapa que tiene o tuvo deals, porque se perdería su historial. Mueve los deals a otra etapa y conserva la etapa antigua, o cámbiale el nombre.

## Quién ve y modifica qué

Cada contacto, empresa y deal tiene un **responsable**. Por defecto, quien lo crea es el responsable. Lo que cada persona ve depende de su rol:

| Rol | Contactos, empresas y deals que ve y edita |
| - | - |
| **Dueño** y **Gerente** | Todos los de la empresa |
| **Supervisor** | Los suyos y los de **su equipo y subequipos** |
| **Vendedor** | Solo los **suyos** |

* Un supervisor **sin equipo asignado** solo ve lo suyo.
* Los registros ajenos **no aparecen**: si alguien intenta abrir uno por su dirección, el sistema responde que no existe.
* Solo puedes **asignar** un registro a personas que estén dentro de tu alcance: un vendedor solo a sí mismo; un supervisor a su equipo; dueño y gerente a cualquiera.
* Al vincular un deal con un contacto o una empresa, solo puedes elegir los que **tú mismo puedes ver**.
* **Eliminar** contactos, empresas y deals lo pueden hacer dueños y gerentes. Si necesitas que otro rol lo haga, el dueño puede ajustar los permisos.

## Buscar contactos y empresas

Cuando tu lista crece, usa el cuadro **Buscar** que está arriba de la lista de **Contactos** y de **Empresas**.

* **Contactos:** busca por **nombre**, **correo** o **teléfono**. Para el teléfono puedes escribir el número con espacios o guiones (`+57 300 111`) o solo una parte (`3001112`).
* **Empresas:** busca por **nombre** o **dominio**.
* **No importan las mayúsculas ni los acentos:** escribir `gomez` encuentra a «María Gómez».
* **Perdona errores pequeños de escritura:** `gomes` también encuentra a «Gómez».
* Escribe **al menos 2 letras** (hasta 100). Los resultados aparecen un instante después de que dejas de escribir.
* La búsqueda respeta lo que cada rol puede ver: un vendedor solo encuentra sus propios contactos.
* Se combina con el filtro **Etapa** de los contactos.

Si no aparece nada verás «No encontramos resultados para…». Revisa la escritura o prueba con otra parte del nombre.

## Evitar duplicados

Clientix no deja crear dos registros iguales dentro de tu empresa:

| Dato | Cómo se compara |
| - | - |
| **Correo** del contacto | Sin importar mayúsculas: `Ana@x.com` y `ana@x.com` son el mismo |
| **Teléfono** del contacto | En formato internacional |
| **Dominio** de la empresa | Sin `https://`, sin `www.` y sin mayúsculas: `https://www.Acme.com/ventas` equivale a `acme.com` |

Si intentas crear uno repetido verás el aviso "Ya existe…". Busca el registro existente y actualízalo en lugar de crear otro. Otra empresa de Clientix **puede** tener el mismo correo o dominio: tus datos nunca se mezclan con los de nadie más.

### Formato del teléfono

Escribe el número **con el código de país**, por ejemplo `+57 300 123 4567` (Colombia) o `+52 55 1234 5678` (México). Los espacios, guiones y paréntesis se limpian solos. Un número sin código de país se rechaza, porque no se puede saber a qué país pertenece.

## Montos y fechas de un deal

* **Monto:** un número sin signo, con hasta dos decimales.
* **Moneda:** código de 3 letras. En el formulario puedes elegir dólar, euro y las monedas de Latinoamérica (`MXN`, `COP`, `BRL`, `ARS`, `CLP`, `PEN`, `UYU`, `GTQ`, `CRC`, `DOP`, `BOB`, `PYG`, `HNL`, `NIO`, `PAB`), además de `GBP` y `CAD`. Si no indicas una, se usa `USD`. **Cada deal conserva su propia moneda y los totales nunca mezclan monedas**: una columna con deals en dólares y en pesos muestra un total por cada moneda.
* **Cómo se ven los montos:** siempre con el **código** de la moneda (`USD 12,400.50`), no con «\$», porque ese símbolo es el mismo para dólares, pesos mexicanos, colombianos y argentinos. Los separadores siguen la costumbre de la **región de tu navegador**: en México y gran parte de Latinoamérica `12,400.50`; en Colombia, Argentina y Chile `12.400,50`; en España `12.400,50 USD`. Los miles se separan desde 4 cifras (`3.800`).
* **Monedas que no se admiten:** las que usan 3 decimales (dinar kuwaití `KWD`, bahreiní `BHD`, omaní `OMR`, jordano `JOD`, tunecino `TND` y libio `LYD`), porque el monto se guarda con 2 decimales y quedaría mal redondeado. Un código inventado también se rechaza.
* **Fecha estimada de cierre:** formato `AAAA-MM-DD`.

## Qué pasa si borras algo

* Al borrar una **empresa**, sus contactos y deals **se conservan**, solo quedan sin empresa.
* Al borrar un **contacto**, sus deals se conservan sin contacto.
* Todo cambio (crear, editar, mover, eliminar) queda en la **bitácora** de la empresa.


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