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:
- Presiona Probar conexión.
- EtchManager consulta la instancia Dolibarr configurada.
- Si la verificación es correcta, el estado cambia a Verificada.
- 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:
- Existe una conexión Dolibarr configurada.
- La conexión está habilitada.
- La conexión está verificada.
- 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).