Proposito

Esta vista permite dar seguimiento a las ordenes de servicio (OS) que ya fueron facturadas y estan pendientes de cobro. Muestra indicadores de envejecimiento (dias transcurridos desde la facturacion) para priorizar el seguimiento de cuentas vencidas. La administradora utiliza esta vista para identificar facturas atrasadas y gestionar el flujo de cobranza del taller.

Vista: Cobranza

La pestana vista_cobranza es una vista de solo lectura (Capa 3a) que muestra las OS en estado facturada o en_credito. Se actualiza automaticamente cada vez que se procesan cambios en las ordenes de servicio.

Columnas de la vista

Columna	Descripcion
Folio OS	Identificador unico de la orden de servicio
Cliente	Nombre del cliente asociado
Placas	Placas de la unidad
Estado	Estado actual de la OS (`facturada` o `en_credito`)
Fecha Facturacion	Fecha en que se facturo la OS
Total OS	Suma de subtotales de todas las lineas de la OS
Dias Transcurridos	Numero de dias desde la fecha de facturacion hasta hoy
Envejecimiento	Semaforo que indica la antiguedad de la factura (ver abajo)

Semaforo de envejecimiento

El semaforo indica la antiguedad de cada factura pendiente de cobro:

Color	Etiqueta	Condicion
Verde	Al corriente	`dias_transcurridos` < 7 dias
Amarillo	Por vencer	`dias_transcurridos` >= 7 dias y <= 30 dias
Rojo	Vencida	`dias_transcurridos` > 30 dias

Importante: Las OS con semaforo en rojo (Vencida) requieren atencion inmediata y seguimiento prioritario.

Filtros

Solo aparecen OS en los siguientes estados:

facturada — la OS fue facturada y esta pendiente de cobro
en_credito — se registro un cobro a credito, pendiente de liquidar

Las OS en otros estados (registrada, en_proceso, cobrada, cerrada, etc.) no aparecen en esta vista.

Ordenamiento

Las OS se muestran ordenadas por dias transcurridos de mayor a menor, para que las facturas mas antiguas y con mayor riesgo de atraso aparezcan primero.

Como Registrar Cobro

El registro de cobro se realiza a traves de la pestana de captura stg_cierre_os con la accion registrar_cobro.

Identificar la OS a cobrar en vista_cobranza.
Abrir la pestana stg_cierre_os (o el formulario en AppSheet).
Llenar los campos:
- os_id: Seleccionar la OS por su ID (consultable en la vista).
- accion: Seleccionar registrar_cobro.
- monto_cobro: Monto recibido del cliente.
- fecha_cobro: Fecha en que se recibio el pago.
- tipo_cobro: Seleccionar contado o credito.
El sistema procesa la fila automaticamente:
- Si tipo_cobro = contado -> la OS pasa a estado cobrada y desaparece de esta vista.
- Si tipo_cobro = credito -> la OS pasa a estado en_credito y permanece visible en la vista para seguimiento.
Verificar en la vista que el estado de la OS se actualizo correctamente.

Seguimiento de Creditos

Las OS con tipo_cobro = credito permanecen en estado en_credito y siguen visibles en vista_cobranza. El flujo de seguimiento es:

Monitorear el semaforo de envejecimiento. Las OS en credito acumulan dias transcurridos desde su fecha de facturacion. Revisar periodicamente que no pasen a amarillo o rojo.
Contactar al cliente. Cuando una OS en credito se acerca al limite de 30 dias, coordinar con el cliente para gestionar el pago.
Registrar el cobro final. Cuando se recibe el pago de una OS en credito:
- Abrir stg_cierre_os.
- Seleccionar la OS, accion registrar_cobro.
- Llenar monto_cobro, fecha_cobro, tipo_cobro = contado.
- La OS pasa a estado cobrada y desaparece de la vista.

Cuando Escalar

Las siguientes situaciones requieren accion adicional y no pueden resolverse directamente en el flujo normal de cobranza:

Factura vencida (mas de 30 dias en rojo). Reportar al supervisor para definir accion de recuperacion. Documentar en las observaciones de la OS.
Monto de cobro no coincide con monto de factura. Si el monto recibido difiere del monto facturado, no proceder sin autorizacion. Escalar al supervisor antes de registrar el cobro.
Cliente disputa la factura. Si el cliente no reconoce el monto o el servicio, escalar al responsable del taller para revision de la OS.

Reglas Importantes

Esta vista es de solo lectura. No se pueden modificar datos directamente en vista_cobranza. Todos los cobros se registran en stg_cierre_os.
Solo OS facturadas o en credito aparecen aqui. Si una OS no aparece, verificar su estado actual en la vista de facturacion.
El monto de cobro debe coincidir con el monto de factura. Si difiere, se requiere autorizacion del supervisor.
Contado cierra el ciclo de cobro. Una OS cobrada de contado pasa a cobrada y sale de esta vista.
Credito mantiene la OS visible. Una OS en credito sigue en esta vista hasta que se registre el cobro final.
Priorizar facturas en rojo. Las facturas con mas de 30 dias deben tener seguimiento activo y, si es necesario, escalarse.
No cerrar OS desde esta interfaz. El cierre definitivo de la OS es un paso posterior al cobro.

Errores Comunes

Cuando una fila de staging se procesa incorrectamente, el sistema escribe el resultado en los campos de sistema:

Campo	Valor
`status_procesamiento`	`ok` (exito) o `error` (fallo)
`error_code`	Codigo del error
`error_detail`	Descripcion detallada del problema
`procesado_at`	Fecha y hora del procesamiento

Errores frecuentes y solucion

Error	Causa	Solucion
”os_id es obligatorio”	No se selecciono la OS	Verificar que el campo os_id tenga un valor valido
”OS con id=X no encontrada”	El os_id no existe en `_ordenes_servicio`	Verificar el ID correcto en la vista
”OS en estado X no acepta cobro”	La OS no esta en estado `facturada`	Solo se puede registrar cobro en OS con estado `facturada`
”monto_cobro es obligatorio”	No se ingreso el monto del cobro	Ingresar el monto recibido del cliente
”fecha_cobro es obligatorio”	No se ingreso la fecha del cobro	Ingresar la fecha en que se recibio el pago
”tipo_cobro debe ser: contado o credito”	Tipo de cobro invalido	Usar unicamente `contado` o `credito`
”monto_cobro difiere de monto_factura”	El monto cobrado no coincide con la factura	Verificar el monto correcto o escalar al supervisor

Que hacer si una fila tiene error

Revisar los campos error_code y error_detail en la fila de staging.
Corregir el dato incorrecto.
Limpiar el campo status_procesamiento (dejarlo vacio) para que el sistema vuelva a procesar la fila.
Esperar el siguiente ciclo de procesamiento o ejecutar manualmente.

Referencias

Especificacion tecnica: docs/views/int-3_facturacion.yaml
Arquitectura de datos: docs/architecture/dec_001_modelo-de-datos-canonico.md
Capas de datos: docs/architecture/dec_002_capa-canonica-y-vistas-operativas.md
Vistas por rol: docs/architecture/dec_003_vistas-decision-support-por-rol.md
Ruta de intervencion: docs/architecture/spec_ruta-de-intervencion.md