> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://support.haddock.app/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Conectar tu TPV Atecresa (Ategest) con Haddock

# Conectar tu TPV Atecresa (Ategest) con Haddock

Esta guía explica cómo conectar tu TPV **Atecresa** —comercializado bajo el nombre **Ategest**— a Haddock. Una vez conectado, Haddock leerá automáticamente tus ventas y tu carta cada día, sin que tengas que hacer ningún paso manual.

## Antes de empezar

Necesitas:

1. **Acceso activo a Ategest.** Tienes que poder entrar a la aplicación Ategest con tu email y contraseña habituales.
2. **Permisos de administrador en Haddock.** Solo los usuarios con el rol *Admin* pueden conectar un nuevo TPV.

> **Nota:** Atecresa puede tardar hasta 24 horas en activar un usuario nuevo. Si has creado el usuario hoy, conecta el TPV mañana para asegurarte de que la integración encuentra al usuario.

## Pasos

### 1. Abre la pantalla de integraciones en Haddock

1. Inicia sesión en [app.haddock.app](https://app.haddock.app).
2. Ve a **Configuración → Integraciones → Punto de venta (TPV)**.
3. Busca la tarjeta **Atecresa** y pulsa **Conectar**.

### 2. Introduce tus credenciales de Ategest

Aparecerá un formulario con dos campos:

- **Email:** el mismo email que usas para acceder a Ategest.
- **Contraseña:** la misma contraseña que usas para acceder a Ategest.

Pulsa **Conectar**. Haddock validará las credenciales contactando con la API de Atecresa. Si todo es correcto verás el mensaje *Integración realizada*.

### 3. Espera la primera sincronización

La primera sincronización completa puede tardar entre 5 y 30 minutos en función del histórico de ventas. Recibirás una notificación en cuanto las ventas empiecen a aparecer en tu panel de Haddock.

## Qué se sincroniza

- **Ventas:** facturas y rectificativas, con fecha, hora, mesa, camarero, líneas y forma de pago.
- **Artículos:** código, descripción, precio, IVA y familia (categoría).
- **Categorías:** se generan automáticamente a partir del campo *familia* de cada artículo.

## Qué **no** se sincroniza

Esta versión de la integración no soporta:

- **Modificadores** ni **menús/combos** (Atecresa no los expone vía API).
- **Multi-local.** Cada login de Ategest se conecta a una única empresa.
- **Webhooks / push.** Haddock consulta la API en intervalos regulares (no es tiempo real).

## Solución de problemas

| Problema | Causa probable | Cómo resolverlo |
|---|---|---|
| Error *Credenciales incorrectas* | El email o la contraseña no son válidos en Ategest. | Verifica que puedes acceder a [Ategest](https://ategestapi.azurewebsites.net) con esos datos antes de volver a intentarlo. |
| El usuario no aparece reconocido | El usuario se creó hace menos de 24 h. | Espera 24 h y vuelve a conectar. |
| Las ventas no llegan después de 1 h | Sincronización inicial larga. | Si pasadas 2 h sigue sin haber ventas, contacta con soporte de Haddock. |

## ¿Necesitas ayuda?

Escríbenos desde el chat de soporte dentro de Haddock o [abre una solicitud desde el Centro de soporte](https://web.haddock.app/support) indicando *"Conexión Atecresa"*.