> For the complete documentation index, see [llms.txt](https://academy.trowelapp.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://academy.trowelapp.com/administracion/integraciones/sage50/configuracion.md).
# Configuración
### 1. Primera configuración (sin conexión previa)
Cuando el entorno **no** tiene aún configuración de API:
* Se muestra el formulario con los campos :
* **URL** del servicio Sage 50 / eConnect al que Trowel llamará.
* **Usuario** y **contraseña** de autenticación ante ese servicio.
* **Grupo** de empresas.
* El botón **Guardar** solo se habilita cuando el formulario es válido. Al guardar se persiste la configuración y la pantalla pasa al modo “ya configurado” (tarjetas + menú Configuración).
Tras la primera carga correcta, las credenciales también pueden editarse desde el modal de credenciales (ver siguiente apartado).
### 2. Menú “Configuración” (barra superior)
Con la integración ya activa, el desplegable **Configuración** agrupa las acciones siguientes
#### 2.1. Credenciales
* Permite revisar o cambiar **URL**, **grupo**, **usuario** y **contraseña** sin pasar por el formulario inicial.
* Al guardar se vuelve a validar la conexión lógica mediante el mismo servicio de guardado de API que la primera vez.
#### 2.2. Sage 50 eConnect — contabilidad
* Objetivo: alinear Trowel con las **reglas contables y de facturación** que exige el conector al crear facturas en Sage.
Parámetros que el administrador debe completar
| Parámetro | Rol de negocio |
| ----------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Código de empresa Sage para facturas** | Código de la empresa en Sage 50 a la que pertenece la factura de venta |
| **Cuenta de ventas por defecto** | Cuenta del plan contable Sage para contrapartidas de venta. Es el valor por defecto al se asignará la contrapartida al crearse en sage. En sage 50 será necesario asignarle uno más específico si es necesario. Debe tener la **longitud de cuenta** configurada. |
| **Cuenta de compras por defecto** | Igual para facturas de gasto. |
| **Longitud del código de cuenta** | Debe coincidir con el plan de cuentas del ejercicio Sage (rango típico validado en aplicación, p. ej. 5–32). Las cuentas por defecto deben tener **exactamente** esa longitud. |
| **Operación — ventas (normal / ISP)** | Códigos numéricos de **operación** en Sage para facturas de venta en régimen general y en **inversión del sujeto pasivo (ISP)**. |
| **Operación — compras (normal / ISP)** | Igual para facturas de gasto. |
| **Tipo de IVA general por defecto (0 %)** | Referencia al catálogo de tipos de IVA de Trowel cuando no se ha asignado un impuesto a la línea de la factura. Se asginará este valor por defecto ya que es obligatorio asignar uno para crear la factura en sage. |
| **Tipo de IVA ISP por defecto (0 %)** | Análogo para líneas en contexto ISP. |
Si falta algún dato obligatorio o la longitud de las cuentas no cuadra con el parámetro de longitud, el modal no permite guardar.
#### 2.3. Mapeos de impuestos
* Relaciona cada **tipo de IVA (catálogo Trowel)** con el **código de IVA en Sage** que debe enviarse en la factura hacia el conector.
* Sin estos mapeos, la resolución del código IVA por línea cogerá tipo por defecto en configuración eConnect y tratamiento fiscal de la línea, con mayor riesgo de rechazo o asiento incorrecto en Sage.
#### 2.4. Mapeos de países
* **País** en Trowel → **código de país** reconocido por Sage.
* Afecta principalmente al alta/actualización de **empresas** (clientes/proveedores) enviados a Sage: el país debe poder traducirse a un código que acepte el conector.
#### 2.5. Dirección de integración
* Por cada **tipo de entidad** (empresas / contactos, facturas de venta, facturas de gasto) se elige si la sincronización predominante es **Trowel → Sage** o **Sage → Trowel**.
**Regla de producto específica Sage 50 — facturas**
* Para **facturas de venta** y **facturas de gasto**, la opción **Sage → Trowel** **no** está disponible ya que el conector de sage no expone la manera de consultar facturas y de esa manera actualizar los registros en Trowel.
Las **empresas** sí pueden configurarse en ambas direcciones.
#### 2.6. Estados de factura para integración
* Define **qué estados de aprobación** (venta y gasto) disparan la inclusión de la factura en el circuito de integración (pendientes de sincronizar, etc.).
* Debe alinearse con el proceso interno de aprobación/emisión de facturas en Trowel antes de esperar envíos a Sage.