# 05 — Interación con ERP

# Configuración ERP — Dolibarr

## Descripción

EtchManager permite conectar el sistema con Dolibarr para sincronizar notas de venta generadas desde las órdenes de grabados y de servicios.

La configuración se administra desde:

**Ajustes → Integración ERP (Dolibarr)**

Esta sección está destinada a usuarios con rol **Admin** o **Super Admin**.

## Datos de conexión

La configuración incluye:

- **Habilitar integración Dolibarr**.
- **Nombre de la conexión**.
- **URL API**.
- **API key**.
- **Estado de verificación**.
- **Organizaciones autorizadas**.

## API key

La API key se guarda de forma cifrada.

Después de guardar una conexión existente, la clave no vuelve a mostrarse. Si se deja el campo vacío al editar, EtchManager conserva la clave actual.

## Verificar la conexión

Después de guardar los datos:

1. Presiona **Probar conexión**.
2. EtchManager consulta la instancia Dolibarr configurada.
3. Si la verificación es correcta, el estado cambia a **Verificada**.
4. Se muestra la empresa emisora identificada por Dolibarr.

## Organizaciones autorizadas

La integración puede habilitarse de forma granular por organización cliente.

Solo podrán sincronizarse las órdenes pertenecientes a organizaciones marcadas como autorizadas.

Para que una orden pueda enviarse a Dolibarr deben cumplirse simultáneamente estas condiciones:

1. Existe una conexión Dolibarr configurada.
2. La conexión está habilitada.
3. La conexión está verificada.
4. La organización de la orden está autorizada.

## Seguridad de la configuración

- La API key no se muestra nuevamente una vez guardada.
- Cambiar la API key obliga a verificar nuevamente la conexión.
- Las organizaciones no autorizadas quedan bloqueadas para sincronización.

# Sincronización de órdenes con Dolibarr

# Sincronización de órdenes con Dolibarr

## Órdenes compatibles

La integración ERP puede utilizarse desde:

- **Órdenes de grabados**.
- **Órdenes de servicios**.

En los listados se muestra un **Estado Dolibarr** independiente del estado propio de la orden en EtchManager.

## Estados Dolibarr

Una orden puede mostrar alguno de los siguientes estados:

- No sincronizada.
- Borrador.
- Validada.
- Facturada.
- Cerrada.
- Anulada.
- Eliminada.
- Error.

El estado remoto no reemplaza el estado local de la orden en EtchManager.

## Enviar una orden

Desde el detalle de una orden, un usuario autorizado puede utilizar **Enviar a Dolibarr**.

La orden se crea inicialmente en Dolibarr y EtchManager conserva la referencia remota.

## Validar una orden

Una orden ya sincronizada puede validarse mediante **Validar en Dolibarr**.

EtchManager solicita confirmación antes de realizar esta acción, ya que una orden validada en Dolibarr puede quedar sujeta a restricciones de edición.

## Abrir la orden en Dolibarr

Cuando existe una referencia remota válida, EtchManager ofrece un acceso directo para abrir la orden correspondiente en Dolibarr.

## Orden eliminada en Dolibarr

Si la orden vinculada deja de existir en Dolibarr, EtchManager la identifica como **Eliminada**.

En ese caso puede utilizarse **Recrear en Dolibarr**. El nuevo ID y la nueva referencia remota reemplazan el vínculo anterior.

## Orden facturada

Cuando Dolibarr informa que la orden ya fue facturada, EtchManager muestra el estado **Facturada** y evita operaciones incompatibles con ese estado.

## Requisitos para sincronizar

La sincronización solo está disponible cuando la conexión ERP está habilitada y verificada, y la organización de la orden está autorizada en **Ajustes → Integración ERP (Dolibarr)**.