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

# Cashback por unidad

> Configura las unidades de la red, el WhatsApp de cada tienda y la automatización de cashback de cada una.

## ¿Cómo funciona?

Cada tienda de la red se convierte en una **unidad** en la cuenta de la marca.
La unidad tiene su propio número de WhatsApp, su propio equipo y su propia
automatización de cashback.

Cuando la unidad registra una venta, Bevits crea el cashback y envía el mensaje
al cliente **por el WhatsApp de la unidad donde compró**. La casa matriz sigue
las ventas de todas las unidades en un solo lugar. El equipo de cada unidad ve
solo los clientes y las ventas de su propia unidad.

La unidad puede registrar la venta de dos formas:

* **Desde la pantalla de ventas de Bevits:** en **Ventas** → **Nueva venta**,
  en la computadora o en el celular.
* **Desde el WhatsApp de la unidad:** el equipo envía los datos de la venta al
  agente de ventas de Bevits, sin abrir el panel.

```mermaid theme={null}
flowchart LR
    A[Venta en mostrador] --> B{¿Cómo la registra la unidad?}
    B -->|Nueva venta en el panel| C[Bevits registra la venta]
    B -->|Mensaje al agente| C
    C --> D[Automatización de cashback de la unidad]
    D --> E[El cliente recibe el cupón en el WhatsApp de la unidad]
```

## Antes de empezar

Ten a mano:

* Acceso de **owner** o **administrador** en la cuenta de la marca (casa
  matriz), con permiso de integraciones y de configuración de la tienda.
* La lista de las unidades, con nombre, dirección y el responsable de cada una.
* Un celular por unidad, con la **WhatsApp Business App** activa en el número
  de la unidad.
* Acceso a la cuenta de Meta que administra el **portafolio de negocio** de la
  marca.
* Las reglas del cashback: porcentaje, tope de seguridad, vigencia y valor
  mínimo de la próxima compra. Mira cómo funciona cada regla en
  [Giftback](https://docs.bevits.com/es/features/giftback.md).

> [!TIP]
>
> Con más de dos unidades, verifica el negocio en Meta Business Suite antes de
> conectar el tercer número. El portafolio verificado acepta hasta 20 números.
> Detalles en
> [Coexistencia de WhatsApp](https://docs.bevits.com/es/send-methods/whatsapp-oficial-coexistencia.md#conectar-mas-numeros).

## Resumen de la configuración

La casa matriz repite los pasos de abajo para cada unidad.

| Paso | Qué hacer | Dónde |
| - | - | - |
| 1 | Conectar el WhatsApp de la unidad | Configuración → WhatsApp → API Oficial |
| 2 | Crear la unidad | Configuración → Tienda → Unidades |
| 3 | Crear la automatización de cashback de la unidad | Automatizaciones |
| 4 | Habilitar el registro de ventas por WhatsApp (opcional) | Configuración → Tienda → Unidades |
| 5 | Dar acceso al equipo de la unidad | Configuración → Equipo |

## Paso a paso

**1. Conecta el WhatsApp de la unidad**

Conecta el número de la unidad en coexistencia, siguiendo la guía
[Coexistencia de WhatsApp](https://docs.bevits.com/es/send-methods/whatsapp-oficial-coexistencia.md).
El número sigue funcionando en la WhatsApp Business App del celular de la
unidad y también empieza a enviar mensajes por la API oficial.

Conecta todos los números en el **mismo portafolio de negocio** de la marca.

**2. Crea la unidad**

Haz clic en tu correo en la esquina inferior izquierda y ve a
**Configuración** → **Tienda** → pestaña **Unidades** → **Nueva unidad**.

Completa:

* **Nombre de la unidad:** usa el nombre que el equipo reconoce, por
  ejemplo `Tienda Centro`.
* **Dirección (opcional):** calle, número, barrio, ciudad y estado.
* **Miembros del equipo (opcional):** las personas de la unidad que ya
  tienen acceso a Bevits. Quien todavía no tiene acceso entra con la
  invitación del paso 5, con la unidad ya marcada.
* **Números de WhatsApp oficial:** selecciona el número conectado en el
  paso 1.

Haz clic en **Guardar unidad**.

![Ventana Nueva unidad con nombre, dirección, miembros y números de WhatsApp oficial](https://bucket.bevits.com/docs/cashback-por-unidade/nova-unidade.png)

La unidad aparece en la lista con la cantidad de miembros y de números
vinculados.

![Pestaña Unidades con la unidad creada](https://bucket.bevits.com/docs/cashback-por-unidade/unidades.png)

**3. Crea la automatización de cashback de la unidad**

Ve a **Automatizaciones** y crea una automatización para la unidad. Dale un
nombre que identifique la unidad, por ejemplo `Cashback · Tienda Centro`.

Arma la automatización con estos bloques:

1. **Disparador:** origen **Tienda física** y evento **Venta manual**.
2. **Cupón:** define el porcentaje del cashback, el tope de seguridad y la
   vigencia.
3. **WhatsApp:** haz clic en **Agrega la plantilla** y crea el mensaje de
   cashback. En **Cuenta oficial de WhatsApp**, elige el **número de la
   unidad**: es por él que el cliente recibe el mensaje.
4. **Temporizador**, **Condicional** y un segundo **WhatsApp** (opcional):
   un recordatorio algunos días antes de que venza el cupón. En la
   **Condicional**, revisa que el cupón todavía no se haya usado, para
   recordarle solo a quien no volvió a la tienda.

![Disparador de la automatización con el origen Tienda física y el evento Venta manual](https://bucket.bevits.com/docs/cashback-por-unidade/gatilho-loja-fisica.png)

En la plantilla, usa las variables de la venta y del cupón:

| Variable | Ejemplo |
| - | - |
| Nombre del cliente | María |
| Código del cupón | `MARIA20` |
| Valor del cashback | R\$ 20,00 |
| Vigencia del cupón | 30/12/2026 |
| Valor mínimo de la próxima compra | R\$ 80,00 |
| Valor de la compra | R\$ 200,00 |

Ejemplo de texto:

> ¡Hola, \[nombre del cliente]! Gracias por tu compra en Tienda Centro.
> Ganaste \[valor del cashback] de cashback para usar hasta \[vigencia]. Solo
> presenta el cupón \[código del cupón] en tu próxima compra.

Envía la plantilla para la aprobación de Meta. Cuando aparezca como
**Aprobado**, activa la automatización. Pasa a aparecer en el campo
**Automatización de cashback** de la pantalla de ventas.

> [!TIP]
>
> Repite este paso para cada unidad, eligiendo siempre el número de la
> propia unidad en las plantillas. Bevits muestra a cada unidad solo las
> automatizaciones con plantillas de su número, y el cashback de una unidad
> nunca sale por el número de otra.

> [!NOTE]
>
> Cada venta genera un cupón. Usa un solo bloque **Cupón** por
> automatización.

**4. Habilita el registro de ventas por WhatsApp (opcional)**

Haz este paso si la unidad va a registrar ventas enviando mensajes al
agente de ventas de Bevits. Si solo usa la pantalla de ventas, pasa al
siguiente paso.

En **Configuración** → **Tienda** → pestaña **Unidades**, baja hasta
**Registro de ventas por WhatsApp**. En **Tiendas autorizadas**, para cada
unidad:

1. Revisa el **Número que envía las ventas**. Si la unidad tiene un solo
   número, ya viene seleccionado.
2. En **Automatización de cashback de esta tienda**, elige la
   automatización creada en el paso anterior. Si la unidad tiene solo una,
   ya viene seleccionada.
3. Haz clic en **Autorizar**. La unidad aparece como **Autorizada**.

![Registro de ventas por WhatsApp con el número y la automatización de la unidad](https://bucket.bevits.com/docs/cashback-por-unidade/vendas-whatsapp.png)

El agente reconoce la unidad por el número que envió el mensaje, ejecuta la
automatización de esa unidad y el cliente recibe el cashback por el
WhatsApp de la unidad. Para pausar el registro por WhatsApp de una unidad,
haz clic en **Quitar autorización**.

Guarda el número del agente de ventas de Bevits en los contactos del
celular de cada unidad: **+55 11 95213-1664**.

**5. Da acceso al equipo de la unidad**

En **Configuración** → **Equipo**, haz clic en **Agregar** y completa:

1. El **Email** y el **Rol** de la persona.
2. En **Alcance de acceso**, elige **Solo unidades vinculadas**.
3. Marca las unidades de la persona y haz clic en **Invitar**.

Cuando acepte la invitación, la persona ya entra con acceso solo a **Ventas**
y **Clientes**, y ve solamente los registros de las unidades marcadas. El
equipo de la casa matriz se queda con **Toda la organización** y sigue la red
completa.

Para cambiar el alcance de quien ya entró, abre el menú de la persona en
**Configuración** → **Equipo** y haz clic en **Permisos personalizados**.

![Permisos personalizados con el campo Alcance de acceso](https://bucket.bevits.com/docs/cashback-por-unidade/permissoes-escopo.png)

> [!NOTE]
>
> Una persona puede formar parte de más de una unidad. Es útil para quien
> gestiona varias tiendas o para un supervisor regional.

## Rutina de la unidad

### Registrar la venta desde la pantalla de ventas

1. En **Ventas**, haz clic en **Nueva venta**.
2. Escribe el **teléfono con código de área**. Si el cliente ya está
   registrado en tu unidad, Bevits completa el nombre.
3. Ingresa el **valor de la compra**.
4. En **Unidad de la venta**, revisa la unidad. Si tienes acceso a una sola
   unidad, ya viene seleccionada.
5. Si el cliente usó un cupón de cashback, escribe el código en **Cupón
   utilizado (opcional)**.
6. Marca **Disparar automatización de cashback**. La pantalla muestra solo
   las automatizaciones de la unidad seleccionada; si hay una, ya viene
   elegida. Haz clic en **Guardar**.

![Ventana Nueva venta con teléfono, nombre, valor, cupón, unidad y automatización de cashback](https://bucket.bevits.com/docs/cashback-por-unidade/nova-venda.png)

El cliente recibe el cashback enseguida, siempre por el WhatsApp de la unidad
seleccionada en **Unidad de la venta**.

### Registrar la venta por WhatsApp

En la WhatsApp Business App de la unidad, envía un mensaje al agente de ventas
de Bevits. Empieza con **nova venda** (nueva venta) y envía, **en un solo
mensaje**, el nombre del cliente, el teléfono con código de área y el valor de
la compra:

```text theme={null}
Nova venda, Maria Souza, (47) 99999-1234, R$ 200,00
```

Si el cliente usó un cupón de cashback en esta compra, agrega el código en el
mismo mensaje (**cupom** significa cupón). Bevits marca el cupón como usado:

```text theme={null}
Nova venda, Maria Souza, (47) 99999-1234, R$ 200,00, cupom MARIA20
```

Si falta algún dato, el agente lo pregunta. Cuando la venta está completa, el
agente la confirma, la venta aparece en **Ventas** y el cliente recibe el
cashback por el WhatsApp de la unidad.

> [!NOTE]
>
> Si la unidad envía una venta con el mismo teléfono y valor que otra de las
> últimas 24 horas, el agente pide una confirmación antes de disparar. Responde
> **confirmo a venda** (confirmo la venta) para registrar una nueva compra o
> **é outra compra** (es otra compra) si se trata de un registro distinto.

### Cliente que compra en otra unidad de la red

El registro del cliente es de la marca. Si compra en otra unidad, Bevits
reconoce el teléfono y agrega la nueva unidad al registro, sin duplicar al
cliente.

Cada unidad ve solo lo que pasó en ella: las compras, los cupones y los totales
del cliente en esa unidad. El historial completo en la red solo lo ve la casa
matriz.

## Seguir los envíos

La casa matriz sigue todo en dos lugares:

* **Ventas:** todas las ventas de la red, con la unidad de cada una.
* **Configuración** → **Tienda** → **Unidades** → **Últimos envíos de
  cashback:** los últimos envíos de cashback y el estado de cada uno.

| Estado | Qué significa |
| - | - |
| Esperando inicio | La venta se registró y el cashback está en la cola. |
| Automatización iniciada | La automatización está enviando el mensaje. |
| Ejecución completada | El cashback se creó y se envió. |
| Requiere revisión | Revisa la automatización y el número de la unidad y haz clic en **Reintentar**. |

## Checklist para cada nueva unidad

* [ ] Número de la unidad conectado en coexistencia en el portafolio de la
  marca.
* [ ] Unidad creada con nombre, dirección y número de WhatsApp.
* [ ] Automatización `Cashback · nombre de la unidad` activa, con la plantilla
  aprobada en el número de la unidad.
* [ ] Si la unidad registra ventas por WhatsApp: unidad **Autorizada** en
  **Registro de ventas por WhatsApp** y número del agente guardado en el
  celular de la unidad.
* [ ] Gerente y vendedores invitados con alcance **Solo unidades vinculadas**
  y la unidad marcada.
* [ ] Venta de prueba registrada y cashback recibido en WhatsApp.

## Problemas comunes

| Síntoma | Qué hacer |
| - | - |
| El número de la unidad no aparece al crear la unidad | Conecta el número en **Configuración** → **WhatsApp** → **API Oficial** y abre la unidad de nuevo. |
| La automatización no aparece en **Nueva venta** | Revisa que la automatización esté activa, que use el evento **Venta manual** y que tenga plantillas aprobadas del número de la unidad seleccionada en **Unidad de la venta**. |
| La automatización aparece deshabilitada en la configuración del agente | Lee el mensaje debajo del campo: indica el bloque o la plantilla que hay que ajustar. |
| El agente no responde al mensaje de la unidad | Revisa que la unidad aparezca como **Autorizada** y que el mensaje haya salido del número de la unidad. |
| La venta no se registra y Bevits avisa que la unidad no tiene número de WhatsApp | Vincula el número de la unidad en **Configuración** → **Tienda** → **Unidades**. Si la unidad tiene más de un número, elige el **Número que envía las ventas** en **Registro de ventas por WhatsApp**. |
| El agente avisa que el cupón no existe o ya se usó | Revisa el código con el cliente y envía la venta de nuevo. Cada cupón vale para una sola compra. |
| El equipo de la unidad ve clientes de otras unidades | Revisa en **Permisos personalizados** que el alcance esté en **Solo unidades vinculadas**. |
| La persona no ve ningún cliente | Agrega a la persona en **Miembros del equipo** de la unidad. |
| La conexión de un número se cayó | Abre WhatsApp Business en el celular de la unidad. La app necesita usarse al menos cada 13 días. |

Para dudas sobre la configuración de la red, escríbenos a **[hey@bevits.com](mailto:hey@bevits.com)** o
usa el chat de soporte en la plataforma.


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