CaboHispania

Control económico

← Portal
← Volver al inicio

Guía tutorial

Manual del módulo naranja: expedientes por referencia CaboHispania, facturas, movimientos de caja, terceros y empresa.

Datos de prueba · Puerto 3003. Tras seed hay facturas F-2026-… y terceros de ejemplo. El token SUITE_INTEGRATION_TOKEN debe coincidir con inmobiliaria.

Básicos (1–7)

Flujo diario del módulo.

Avanzados (8–10)

Integraciones y configuración.

Parte A · Básicos

  1. Paso 1

    Empresa y logo PDF

    Configurar cabecera fiscal de las facturas.

    Ir →

    Qué hacer

    1. Empresa → nombre, NIF, dirección, IBAN, teléfono, email.
    2. Subir logo PNG/JPG y activar «Mostrar logo en PDF».
    3. Guardar.

    Qué debes ver

    • Logo en ficha Empresa
    • Datos en PDF de factura

  2. Paso 2

    Terceros

    Alta de clientes y proveedores.

    Ir →

    Qué hacer

    1. Clientes / Proveedores → nuevo.
    2. Tipo CLIENTE o PROVEEDOR, NIF y contacto.

    Qué debes ver

    • Tercero en listado

  3. Paso 3

    Factura emitida

    Crear factura de venta con IVA.

    Ir →

    Qué hacer

    1. Facturas → Nueva → tipo EMITIDA.
    2. Base, % IVA, concepto, módulo origen (Inmobiliaria/Obras/OT).
    3. Opcional: referencia externa (CH-…) para el expediente.
    4. Guardar y Descargar PDF.

    Qué debes ver

    • Factura en listado
    • PDF con logo y totales

  4. Paso 4

    Gastos a proveedor

    Registrar costes pagados (sin factura a proveedor).

    Ir →

    Qué hacer

    1. Movimientos → tipo GASTO, categoría PROVEEDOR.
    2. O desde Obras: al pagar un proveedor se sincroniza solo.
    3. Vincular referencia de obra/CH si aplica.

    Qué debes ver

    • Gasto en listado de movimientos
    • Coste en expediente

  5. Paso 5

    Movimientos de caja

    Ingresos y gastos sin factura formal.

    Ir →

    Qué hacer

    1. Movimientos → nuevo INGRESO o GASTO.
    2. Categoría (p. ej. COMISION / PROVEEDOR), importe, referencia externa.

    Qué debes ver

    • Movimiento en listado
    • Suma en expediente

  6. Paso 6

    Expediente por referencia

    Ver el coste/ingreso de un CH-… o obra.

    Ir →

    Qué hacer

    1. Inicio o Expedientes: buscar referencia (ej. CH-24001).
    2. Revisar facturas + movimientos + resultado.
    3. Descargar PDF de cada factura desde el expediente.

    Qué debes ver

    • Resumen ingresos/costes
    • Enlaces a otros módulos si hay URL

  7. Paso 7

    Estados de factura

    Marcar pagada / cobrada.

    Ir →

    Qué hacer

    1. En listado de facturas: Marcar pagada.
    2. Filtrar por estado.

    Qué debes ver

    • Estado PAGADA
    • KPI pendiente cobro baja

Parte B · Avanzados

  1. Paso 8

    Comisión desde Inmobiliaria

    Probar el puente automático con numeración correlativa.

    Ir →

    Qué hacer

    1. Arrancar Inmobiliaria (:3002) y Control (:3003).
    2. Cobrar una comisión con factura IVA.
    3. En Control: abrir Facturas — número F-YYYY-NNNN y expediente de la propiedad.

    Qué debes ver

    • Movimiento COMISION
    • Factura F-… correlativa
    • moduloOrigen INMOBILIARIA

  2. Paso 9

    Facturas desde Obras y OT

    Ver que todas las emisiones llegan al libro fiscal.

    Ir →

    Qué hacer

    1. En Obras: crear certificación con «generar factura» → aparece F-… en Control (filtro Obras).
    2. En OT: encargo → Emitir honorarios → filtro Oficina técnica.
    3. Filtrar por módulo en Facturas.

    Qué debes ver

    • Una sola serie F-YYYY-NNNN
    • Expedientes por referencia

  3. Paso 10

    API integración

    Endpoint unificado de facturas.

    Qué hacer

    1. POST /api/integracion/facturas con header x-suite-token.
    2. Body: idempotencyKey, moduloOrigen, concepto, base.
    3. Mismo SUITE_INTEGRATION_TOKEN en todos los .env.

    Qué debes ver

    • Respuesta ok + facturaId + numeroFactura