Proposito

Esta intervencion controla la entrega de vehiculos a los clientes una vez que la orden de servicio (OS) ha completado su ciclo de pago, o parcialmente con autorizacion. La recepcionista verifica el estado de cobro de la OS y, si la entregabilidad lo permite, registra la salida del vehiculo.

El objetivo es que ningun vehiculo salga del taller sin que su estatus de pago este verificado y registrado. Cada entrega queda documentada con la persona que recibe, la fecha de salida y, cuando aplica, los motivos de excepcion.

Vista: Entregas

La pestana vista_entregas es una vista de solo lectura (Capa 3a) que muestra las OS listas o casi listas para entrega de vehiculo. 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
Marca	Marca del vehiculo
Modelo	Modelo del vehiculo
Estado	Estado actual de la OS (`cobrada`, `en_credito` o `facturada`)
Fecha Ingreso	Fecha en que ingreso la unidad al taller
Dias en Taller	Numero de dias desde el ingreso hasta hoy (calculado)
Numero Factura	Numero de factura asignado a la OS
Monto Factura	Monto total facturado
Tipo Cobro	Tipo de cobro registrado (`contado` o `credito`)
Entregabilidad	Semaforo que indica si el vehiculo puede entregarse (ver abajo)

Semaforo de entregabilidad

El semaforo indica si el vehiculo puede entregarse segun el estado de pago de la OS:

Color	Etiqueta	Condicion	Significado
Verde	Entregar libremente	`estado_id = cobrada`	La OS esta cobrada en su totalidad. Se puede entregar sin restriccion.
Amarillo	Entregar con credito	`estado_id = en_credito`	La OS tiene cobro a credito aprobado. Se puede entregar; aplican terminos de credito.
Rojo	Requiere cobro o override	`estado_id = facturada`	La OS esta facturada pero no se ha registrado cobro. No entregar sin autorizacion de Direccion.

Importante: Priorizar siempre las entregas en verde (cobradas). Un vehiculo en rojo (solo facturada) no debe entregarse sin que Direccion lo autorice mediante override.

Filtros

Solo aparecen OS en los siguientes estados:

cobrada — la OS fue cobrada, lista para entrega libre
en_credito — la OS tiene cobro a credito, entrega con terminos
facturada — la OS fue facturada pero no cobrada, requiere accion

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

Ordenamiento

Las OS se muestran ordenadas por:

Semaforo de entregabilidad: verde primero, luego amarillo, luego rojo.
Fecha de ingreso de mas antigua a mas reciente, para priorizar las unidades que llevan mas tiempo en el taller.

Como Entregar un Vehiculo

La entrega se registra a traves de la pestana de captura stg_entrega. Cada fila representa una entrega de vehiculo.

Identificar la OS a entregar en vista_entregas. Verificar que la unidad, placas y cliente coincidan.
Revisar el semaforo de entregabilidad:
- Verde: Proceder directamente.
- Amarillo: Proceder, pero confirmar que el cliente tiene credito aprobado.
- Rojo: No proceder sin override de Direccion (ver seccion Excepciones).
Abrir la pestana stg_entrega (o el formulario en AppSheet).
Llenar los campos obligatorios:
- os_id: Seleccionar la OS por su ID (consultable en la vista).
- entregado_a: Nombre completo de la persona que recibe el vehiculo.
- fecha_entrega: Fecha en que se entrega la unidad.
Llenar los campos opcionales segun aplique:
- km_salida: Kilometraje de salida. Registrar si se tiene el dato.
- parentesco_o_relacion: Obligatorio cuando quien recibe no es el titular del cliente (ej: chofer, hijo, esposa, representante legal).
- observaciones: Notas adicionales sobre la entrega.
El sistema procesa la fila automaticamente:
- Establece fecha_salida en la OS.
- Transiciona el estado de la OS a cerrada.
Verificar en la vista que la OS ya no aparece (porque paso a cerrada).

Semaforo de Entregabilidad

El semaforo es el indicador central de esta intervencion. Define la accion permitida para cada vehiculo.

Verde — Cobrada

Estado: La OS tiene cobro registrado y liquidado.
Accion: Entregar libremente. No se requiere autorizacion adicional.
Flujo: Llenar stg_entrega con los campos obligatorios. El sistema cierra la OS.

Amarillo — En credito

Estado: La OS tiene cobro registrado como credito. El cliente tiene terminos de pago aprobados.
Accion: Se puede entregar. El vehiculo sale del taller, pero la deuda queda abierta en el sistema de cobranza.
Flujo: Llenar stg_entrega normalmente. El sistema cierra la OS. La cobranza sigue siendo responsabilidad de INT-3 (Cobranza).
Nota: Confirmar con el cliente que conoce los terminos de credito antes de entregar.

Rojo — Facturada (sin cobro)

Estado: La OS fue facturada pero no se ha registrado ningun cobro (ni contado ni credito).
Accion: No entregar sin autorizacion explicita de Direccion.
Flujo: Si Direccion autoriza, llenar los campos de override (ver seccion Excepciones) y luego completar la entrega en stg_entrega.
Escenarios comunes: Entrega nocturna pre-cierre, autorizacion verbal de Direccion.

Entrega con Credito

Cuando la OS esta en estado en_credito, el cliente tiene terminos de credito aprobados. La entrega procede con las siguientes consideraciones:

Verificar el tipo de cobro en la vista: debe mostrar credito.
Confirmar con el cliente que esta al tanto de los terminos de credito.
Registrar la entrega normalmente en stg_entrega.
La deuda permanece activa en vista_cobranza (INT-3) hasta que se registre el cobro final.
No se requiere override para entregas con credito aprobado.

Entrega Nocturna / Pre-Cierre

En algunas situaciones, el vehiculo debe entregarse antes de que se complete el ciclo de pago — por ejemplo, cuando el cliente recoge la unidad en la noche fuera de horario de caja. Este es el patron de entrega pre-cierre.

Cuando aplica

El cliente se presenta fuera de horario de caja o administracion.
La OS esta en estado facturada (semaforo rojo) porque el cobro no se ha procesado aun.
Direccion autoriza la salida del vehiculo con el compromiso de completar el cobro al dia siguiente.

Como registrar

Obtener autorizacion de Direccion (verbal o por mensaje).
En stg_entrega, llenar los campos obligatorios (os_id, entregado_a, fecha_entrega).
Llenar los campos de override:
- override_reason_code: pre_cierre_nocturno
- override_nota: Describir las circunstancias (ej: “Cliente recogio unidad a las 21:00, caja cerrada. Cobro pendiente para manana.”).
- override_por: Nombre de quien autorizo la entrega.
- override_fecha: Fecha de la autorizacion.
El sistema procesa la entrega y cierra la OS.

Importante: La entrega nocturna no elimina la obligacion de cobro. El area de cobranza (INT-3) debe dar seguimiento al pago pendiente.

Cuando Escalar

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

OS en semaforo rojo sin autorizacion de Direccion. No entregar. Contactar a Direccion para obtener override antes de proceder.
Entrega a tercero no identificado. Si la persona que recibe el vehiculo no es el titular del cliente y no puede identificarse su relacion, escalar a Direccion antes de entregar.
Discrepancia en monto de factura. Si el cliente cuestiona el monto facturado o hay inconsistencia entre lo facturado y lo cobrado, no entregar. Escalar al area de facturacion (INT-3).
Vehiculo con dano no documentado. Si al momento de la entrega se detecta un dano que no estaba registrado en la OS, documentar y escalar al jefe de taller antes de entregar.
OS no aparece en la vista. Si el cliente solicita su vehiculo pero la OS no aparece en vista_entregas, verificar el estado actual. La OS puede no haber llegado a facturada, en_credito o cobrada.

Excepciones

Cuando una situacion requiere desviarse del flujo normal, se utilizan los campos de override en stg_entrega:

Campos de override

Campo	Proposito
`override_reason_code`	Codigo del motivo de la excepcion
`override_nota`	Descripcion libre de las circunstancias
`override_por`	Nombre de quien autoriza la excepcion
`override_fecha`	Fecha de la autorizacion

Cuando usar override

Entrega con OS en estado facturada (rojo). El vehiculo sale sin cobro registrado. Requiere autorizacion de Direccion.
Entrega nocturna / pre-cierre. El vehiculo sale fuera de horario antes de completar el ciclo de pago.
Autorizacion verbal. Direccion autoriza por telefono o mensaje. Documentar en override_nota.

Codigos de motivo (override_reason_code)

Los codigos disponibles para entregas:

pre_cierre_nocturno — entrega fuera de horario, cobro pendiente para el siguiente dia habil
autorizacion_verbal — Direccion autorizo verbalmente la entrega sin cobro completo

Reglas Importantes

Revisar el semaforo de entregabilidad antes de cada entrega. Verde = entregar libremente. Amarillo = entregar con credito. Rojo = no entregar sin override.
Verificar identidad del receptor. El campo entregado_a es obligatorio. Confirmar que la persona es el titular o tiene relacion documentada.
Si quien recibe no es el titular, llenar obligatoriamente parentesco_o_relacion (ej: chofer, hijo, esposa, representante legal).
No entregar vehiculos en semaforo rojo sin autorizacion de Direccion. Llenar todos los campos de override si se autoriza.
Registrar km_salida siempre que sea posible. Si no se tiene el dato al momento de la entrega, dejarlo vacio.
Verificar que unidad, placas y cliente coincidan con la informacion de la OS antes de entregar.
Una vez procesada la entrega, la OS pasa a estado cerrada y desaparece de esta vista. Esta accion no es reversible desde esta interfaz.
No modificar datos de facturacion o cobro desde esta interfaz. Eso corresponde a INT-3 (Facturacion / Cobranza).
Las entregas nocturnas no eliminan la obligacion de cobro. El area de cobranza debe dar seguimiento al pago pendiente.
Esta vista es de solo lectura. Todas las entregas se registran en stg_entrega.

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 permite entrega”	La OS no esta en estado `cobrada`, `en_credito` o `facturada`	Solo se pueden entregar vehiculos con OS en esos tres estados
”entregado_a es obligatorio”	No se ingreso el nombre de quien recibe	Ingresar el nombre completo de la persona que recibe el vehiculo
”fecha_entrega es obligatorio”	No se ingreso la fecha de entrega	Ingresar la fecha en que se entrega la unidad
”OS facturada requiere override”	Se intento entregar con OS en estado `facturada` sin campos de override	Obtener autorizacion de Direccion y llenar los campos de override
”override_reason_code invalido”	El codigo de motivo no es reconocido	Usar `pre_cierre_nocturno` o `autorizacion_verbal`

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-6_entregas.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
Maquina de estados OS: docs/architecture/spec_arquitectura-de-proceso-global-del-taller.md (seccion 3.2)

Procedimiento: Entrega de Vehiculos