> 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/entidades-direcciones-y-datos-intercambiados.md).

# Entidades, direcciones y datos intercambiados

Este documento describe qué **entidades de negocio** cubre la integración con Sage 50, en qué **dirección** puede fluir la información y **qué datos** se envían o reciben. Sirve como referencia para pruebas funcionales, formación de usuarios y alineación con contabilidad o fiscalidad.

<figure><img src="/files/iicdY6TZMIfjHuDtud6n" alt=""><figcaption></figcaption></figure>

### 1. Qué muestra la pantalla (tarjetas)

| Tarjeta en Trowel     | Qué representa en negocio                                                                                            |
| --------------------- | -------------------------------------------------------------------------------------------------------------------- |
| **Empresas**          | Sincronización de **empresas** de Trowel (clientes y proveedores) con los **clientes** y **proveedores** de Sage 50. |
| **Facturas de venta** | Envío de **facturas de venta** de Trowel hacia Sage para su registro contable.                                       |
| **Facturas de gasto** | Envío de **facturas de gasto** (coste) de Trowel hacia Sage.                                                         |

### 2. Empresas (clientes y proveedores)

#### 2.1. Dirección **Trowel → Sage 50**

Según el **tipo de empresa** en Trowel:

* **Cliente** → se da de alta o se actualiza en Sage como **cliente**.
* **Proveedor** → se da de alta o se actualiza en Sage como **proveedor**.

**Datos que suele enviar Trowel a Sage** (desde la ficha de la empresa):

| En Trowel                           | En Sage (concepto)                                                                                                                                   |
| ----------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| Código de empresa                   | Código en el maestro de cliente o proveedor; si Sage asigna código en el alta y en Trowel faltaba, puede completarse en Trowel tras crear el vínculo |
| Razón social y nombre comercial     | Nombre y nombre comercial en la ficha                                                                                                                |
| NIF / CIF                           | Identificador fiscal                                                                                                                                 |
| Dirección, población, código postal | Domicilio                                                                                                                                            |
| Provincia (según región en Trowel)  | Provincia                                                                                                                                            |
| País                                | Según **mapeo de países** configurado; si no hay equivalencia, puede usarse el nombre del país como recurso final                                    |
| IBAN                                | IBAN en la ficha, cuando el conector lo admite                                                                                                       |

**Actualizaciones en Sage:** se usa el **código que Sage ya conoce** para esa empresa (el identificador guardado al sincronizar). En clientes, si aún no existía código guardado, el sistema puede intentar localizar el registro en Sage por **CIF** entre los clientes.

#### 2.2. Dirección **Sage 50 → Trowel**

* Se parte del **código de empresa en Sage** indicado en la tarea de sincronización.
* Se busca primero en el **maestro de clientes** de Sage; si no aparece, en el **maestro de proveedores**.
* En Trowel se **crea una empresa nueva** o se **reutiliza** una ya vinculada al mismo código, según corresponda.
* El tipo en Trowel queda como **cliente** o **proveedor** según en qué maestro de Sage se haya encontrado el registro.

**Datos que suelen volcarse desde Sage a la empresa en Trowel:**

| En Sage (origen)                    | En Trowel (destino)                                        |
| ----------------------------------- | ---------------------------------------------------------- |
| Código                              | Código (sobre todo en altas)                               |
| Nombre / razón social               | Razón social; nombre comercial si procede                  |
| CIF                                 | NIF / CIF                                                  |
| Correos de contacto / factura       | Correo y correo de facturación                             |
| Dirección, población, código postal | Domicilio completo                                         |
| País (código en Sage)               | País en Trowel, resuelto mediante catálogo y equivalencias |

***

### 3. Facturas de venta (solo **Trowel → Sage**)

* La integración **crea la factura** en Sage a partir de la factura de venta en Trowel.
* **No** existe hoy un flujo de negocio soportado que **modifique** en Sage una factura ya creada desde Trowel cuando cambia la factura en Trowel; el alcance práctico es el **alta** vía conector.

#### 3.1. Cabecera de factura

| Uso en Sage / contabilidad                                  | Origen o regla en Trowel                                                                                                                                 |
| ----------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Número de factura                                           | Número de la factura en Trowel                                                                                                                           |
| Fechas (factura, operación, asiento, registro, vencimiento) | Fecha de factura; fecha de operación según normativa aplicable en ventas; resto según política de fechas contables y registro (p. ej. SII cuando aplica) |
| Empresa y datos fiscales del tercero en Sage                | Empresa de la factura en Trowel (CIF, nombre, etc.) y parámetros del **pack de integración** (empresa contable en Sage)                                  |
| Cuenta o clave de tercero en Sage                           | Vinculación con la empresa de la factura ya sincronizada en Sage                                                                                         |
| Texto descriptivo de cabecera                               | Descripción de la factura en Trowel                                                                                                                      |
| Precios con IVA incluido                                    | En el envío estándar se trata como **base + IVA** (no “todo incluido” en el mensaje al conector)                                                         |
| Tipo de operación contable                                  | Régimen general o **inversión del sujeto pasivo (ISP)** según la factura y lo definido en la **configuración eConnect**                                  |
| Documento PDF adjunto                                       | Documento original de la factura en Trowel, si existe                                                                                                    |
| Retención                                                   | Si hay líneas con retención mapeada, puede enviarse la cuenta de retención en Sage correspondiente                                                       |

#### 3.2. Líneas e impuestos

* Cada **línea del desglose** de la factura genera en Sage una **contrapartida de gasto/ingreso** con el **importe de la base imponible** de esa línea. Si en datos históricos la base figuraba en cero pero la línea tiene cantidad, precio o total coherentes, el cálculo puede **corregir la base** para no enviar importes erróneos.
* Los **tipos de IVA** de las líneas se traducen a **códigos de IVA en Sage** mediante el **mapeo de impuestos**; los importes se **agrupan por código** para el bloque de IVA del asiento (según el diseño actual del conector: importe asociado a la **base imponible** por tipo).
* La **cuenta contable** de la línea en Trowel (o del catálogo vinculado) se usa como contrapartida; si fuera una cuenta de IVA de balance típica del PGC español que no debe usarse así, se sustituye por la **cuenta de ventas por defecto** definida en la configuración eConnect.

#### 3.3. Cobros y pagos

Por ahora no es posible notificar los pagos y cobros via conector con Sage. A corto plazo será posible asignar de manera masiva via excel o acción en el listado de facturas de Trowel los pagos correspondientes a cada factura.

#### 3.4. Cambios y borrados de factura en Trowel

Para Sage 50, los **cambios** o **borrados** de facturas en Trowel **no** disparan por defecto el mismo volumen de reenvíos que en otras integraciones (el conector no ofrece un ciclo de vida de factura equivalente al de Trowel). El flujo principal sigue siendo: factura en estado contemplado en **configuración de estados** y **dirección** → **creación** en Sage.

***

### 4. Facturas de gasto (solo **Trowel → Sage**)

Comportamiento análogo al de **venta**, adaptado al documento de **gasto**:

* Fechas de **operación contable** y **asiento** propias del flujo de compras.
* Códigos de **operación** de compra (normal e ISP) según configuración eConnect.
* Cuenta por defecto de **compras** cuando aplica el mismo tipo de sustitución que en ventas pero para el lado gasto.

***

### 5. Facturas desde Sage hacia Trowel

* En la **configuración de dirección**, para facturas de **venta** y **gasto** **no** debe aparecer ni guardarse la opción de importar desde Sage hacia Trowel; la aplicación lo impide en pantalla y al guardar.
* **Importar facturas de compra** desde Sage hacia Trowel **no está implementado** dado que el conector de sage no permite obtenerlas y por tanto, tampoco insertarlas o actualizarlas en Trowel.

***

### 6. Resumen dirección × entidad

| Entidad          | Trowel → Sage                            | Sage → Trowel                                                                                   |
| ---------------- | ---------------------------------------- | ----------------------------------------------------------------------------------------------- |
| Empresas         | Sí (como cliente o proveedor según tipo) | Sí (lectura en maestros de cliente y proveedor; filtros opcionales en la sincronización manual) |
| Factura de venta | Sí (alta en Sage)                        | **No**                                                                                          |
| Factura de gasto | Sí (alta en Sage)                        | **No**                                                                                          |
