erp-mecanicas-diesel/docs/02-definicion-modulos/MMD-006-cotizaciones/historias-usuario/US-MMD006-005-generar-pdf.md

6.1 KiB

US-MMD006-005: Generar PDF de Cotizacion

Metadata

Campo Valor
ID US-MMD006-005
Epica EPIC-MMD-006 - Cotizaciones
Modulo cotizaciones
Prioridad P0
Story Points 5
Sprint Sprint 5
Estado Backlog

Historia de Usuario

Como recepcionista, quiero generar un PDF profesional de la cotizacion, para enviarlo al cliente por email o WhatsApp.

Descripcion Detallada

El PDF debe tener formato profesional con logo del taller, datos del cliente y vehiculo, desglose de servicios y refacciones, totales, y espacio para firma de aprobacion.


Criterios de Aceptacion

Escenario 1: Generar PDF

DADO que tengo una cotizacion completa
CUANDO hago clic en "Generar PDF"
ENTONCES se genera PDF con formato profesional
Y se puede descargar o ver en navegador

Escenario 2: Contenido del PDF

DADO que genero el PDF
CUANDO reviso el contenido
ENTONCES incluye:
  - Logo y datos del taller
  - Folio y fecha de cotizacion
  - Datos del cliente
  - Datos del vehiculo
  - Desglose de servicios
  - Desglose de refacciones
  - Subtotales, IVA y total
  - Vigencia de la cotizacion
  - Espacio para firma

Escenario 3: Enviar por email

DADO que genero el PDF
CUANDO hago clic en "Enviar por email"
ENTONCES se abre dialogo con email del cliente precargado
Y puedo personalizar el mensaje
Y se envia con PDF adjunto

Escenario 4: Compartir por WhatsApp

DADO que genero el PDF
CUANDO hago clic en "Enviar por WhatsApp"
ENTONCES se abre WhatsApp Web
Y se adjunta el PDF
Y se precarga mensaje con resumen

Template del PDF

┌─────────────────────────────────────────────────┐
│  [LOGO]           TALLER DIESEL EXPRESS         │
│                   RFC: DME850101ABC             │
│                   Av. Principal 123, Monterrey  │
│                   Tel: 555-0100                 │
├─────────────────────────────────────────────────┤
│  COTIZACION: COT-2025-0001                      │
│  Fecha: 06/12/2025    Vigencia: 21/12/2025      │
├─────────────────────────────────────────────────┤
│  CLIENTE                                        │
│  Transportes del Norte SA de CV                 │
│  RFC: TNO920101XXX                              │
│  Tel: 555-0200                                  │
├─────────────────────────────────────────────────┤
│  VEHICULO                                       │
│  Kenworth T680 2020 - Placas: ABC-123           │
│  Motor: Cummins ISX15 - Serie: XXXXX            │
│  Km actual: 125,000                             │
├─────────────────────────────────────────────────┤
│  SERVICIOS                                      │
│  ─────────────────────────────────────────────  │
│  Cant  Descripcion                    Importe   │
│  1     Diagnostico computarizado      $500.00   │
│  5 hrs Reparacion bomba inyeccion   $2,250.00   │
│                                                 │
│  REFACCIONES                                    │
│  ─────────────────────────────────────────────  │
│  Cant  Descripcion                    Importe   │
│  1     Kit reparacion bomba         $3,500.00   │
│  2     Filtro diesel                  $450.00   │
│  20L   Aceite motor 15W40           $1,800.00   │
├─────────────────────────────────────────────────┤
│                       Subtotal:     $8,500.00   │
│                       IVA 16%:      $1,360.00   │
│                       TOTAL:        $9,860.00   │
├─────────────────────────────────────────────────┤
│  NOTAS:                                         │
│  - Tiempo estimado: 2 dias habiles              │
│  - Garantia: 30 dias en mano de obra            │
│  - Cotizacion valida por 15 dias                │
├─────────────────────────────────────────────────┤
│  AUTORIZACION                                   │
│                                                 │
│  ☐ APROBADO   ☐ RECHAZADO                       │
│                                                 │
│  Firma: ____________________  Fecha: ________   │
│  Nombre: _______________________________________│
└─────────────────────────────────────────────────┘

Tareas Tecnicas

Backend:

  • BE-104: Endpoint GET /api/quotes/:id/pdf
  • BE-105: Template PDF con pdfkit o puppeteer
  • BE-106: Endpoint POST /api/quotes/:id/send-email
  • BE-107: Integracion con servicio de email

Frontend:

  • FE-104: Boton "Generar PDF" en cotizacion
  • FE-105: Vista previa de PDF
  • FE-106: Dialogo de envio por email
  • FE-107: Boton compartir WhatsApp

Dependencias

Depende de:

  • US-MMD006-001: Cotizacion creada
  • US-MMD001-001: Datos del taller (logo, RFC)

Definition of Done (DoD)

  • Generar PDF con formato profesional
  • Vista previa antes de descargar
  • Envio por email
  • Compartir por WhatsApp
  • Tests pasando

Creada por: Requirements-Analyst Fecha: 2025-12-06