> ## Documentation Index
> Fetch the complete documentation index at: https://docs.filexpress.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuración de Sucursal

> Datos de la sucursal, apariencia de documentos, plantillas, comisiones, impresora térmica y báscula

La configuración de sucursal centraliza todos los ajustes operativos: desde los datos legales hasta el comportamiento de la impresora y la báscula. Los cambios aplican de inmediato a los documentos generados desde esa sucursal.

## Datos de la sucursal

| Campo                               | Requerido | Descripción                                                                          |
| ----------------------------------- | --------- | ------------------------------------------------------------------------------------ |
| **Nombre**                          | Sí        | Nombre de la sucursal — aparece en facturas y documentos                             |
| **Eslogan**                         | No        | Texto secundario bajo el nombre en documentos                                        |
| **Código**                          | Sí        | Código interno identificador de la sucursal                                          |
| **Tipo de sucursal**                | Sí        | Clasificación de la sede (casa matriz, sucursal, bodega, etc.)                       |
| **País / Departamento / Municipio** | No        | Ubicación geográfica — encadenados: al cambiar el país se recargan los departamentos |
| **Dirección**                       | No        | Dirección física completa                                                            |
| **Teléfono**                        | No        | Teléfono de contacto de la sucursal                                                  |
| **Correo**                          | Sí        | Correo de la sucursal (debe ser válido)                                              |

## Apariencia de documentos

Se pueden personalizar los colores de marca que aparecen en facturas y cotizaciones. El sistema valida que sean colores hexadecimales válidos (`#RRGGBB`).

| Documento    | Color primario (defecto) | Color secundario (defecto) |
| ------------ | ------------------------ | -------------------------- |
| Facturas     | `#3064FA` (azul)         | `#6c757d` (gris)           |
| Cotizaciones | `#28a745` (verde)        | `#6c757d` (gris)           |

El botón **Restablecer colores** devuelve todos los valores a los defaults.

## Plantillas de documentos

Cada tipo de documento tiene dos plantillas de texto enriquecido (editor con soporte para negritas, listas, encabezados y enlaces):

| Plantilla                                | Dónde aparece                              |
| ---------------------------------------- | ------------------------------------------ |
| **Términos y condiciones de cotización** | Al pie de cada cotización generada         |
| **Notas de cotización**                  | Sección de notas internas de la cotización |
| **Términos y condiciones de factura**    | Al pie de cada factura generada            |
| **Notas de factura**                     | Sección de notas internas de la factura    |

## Comisiones

| Campo                            | Descripción                                                                                                                                    |
| -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| **Tasa de comisión por defecto** | Porcentaje predeterminado de comisión para vendedores. Se usa cuando un vendedor no tiene tasa propia configurada. Dejar vacío para desactivar |

## Impresora térmica

Para el punto de venta con impresora de tickets ESC/POS en red:

<Steps>
  <Step title="Ingresar el host de la impresora">
    Dirección IP o nombre en red donde está expuesto el servidor de impresión (ej: `192.168.1.100:8080`).
  </Step>

  <Step title="Ingresar el nombre de la impresora">
    Nombre de la impresora en el servidor de impresión.
  </Step>

  <Step title="Probar Impresión">
    Envía un ticket de prueba. Confirma que la conexión funciona antes de usar en producción.
  </Step>

  <Step title="Probar Cajón (opcional)">
    Envía el comando ESC/POS de apertura del cajón de dinero.
  </Step>
</Steps>

<Note>
  La configuración de impresora se guarda por dispositivo (no en el servidor). Si se cambia de equipo, se debe reconfigurar el host y nombre de impresora.
</Note>

## Báscula (código de barras de peso)

Configura la lectura de códigos de barras emitidos por básculas electrónicas (formato EAN-13 con peso o precio embebido).

| Campo                             | Defecto | Descripción                                                            |
| --------------------------------- | ------- | ---------------------------------------------------------------------- |
| **Habilitada**                    | `false` | Activa el reconocimiento de barcodes de báscula                        |
| **Prefijo**                       | `01`    | Los primeros dígitos del barcode que identifican que es de báscula     |
| **Inicio del código de producto** | `2`     | Posición (0-indexed) donde empieza el código SKU dentro del barcode    |
| **Longitud del peso**             | `0`     | Cantidad de dígitos reservados para peso (0 = no hay peso, usa precio) |
| **Decimales del peso**            | `2`     | Cuántos decimales tiene el peso (ej: 2 para leer `0150` como 1.50kg)   |
| **Longitud del precio**           | `5`     | Cantidad de dígitos reservados para precio                             |
| **Decimales del precio**          | `2`     | Cuántos decimales tiene el precio                                      |
| **Dígito verificador**            | `true`  | Si el barcode incluye el dígito de verificación EAN                    |

**Ejemplo con formato de precio** (sin peso): barcode `0112345006750` con prefijo `01`, precio de 5 dígitos con 2 decimales = precio `$67.50`, código de producto = `12345`.

**Ejemplo con formato de peso**: barcode con `weight_length > 0` — el sistema extrae primero el peso, luego el precio, luego el código de producto según las posiciones configuradas.

<Warning>
  La configuración de báscula debe coincidir exactamente con el formato que emite la báscula específica. Consultar el manual del fabricante para los parámetros correctos.
</Warning>

***

Guardar los cambios con el botón **Guardar configuración** al final del formulario.