# SERVICES-CATALOG.md - ERP Transportistas

**Version:** 1.0.0
**Fecha:** 2026-01-26
**Total Services:** ~80 (50 heredados + 30 propios)

---

## Resumen

| Categoria | Services | Estado |
|-----------|----------|--------|
| Heredados erp-core | ~50 | 100% disponibles |
| Propios transporte | ~30 | 40% implementados |

---

## Services Heredados (erp-core)

### Auth & Users
- AuthService
- UsersService
- RolesService
- PermissionsService
- SessionsService

### Tenancy
- TenantsService
- CompaniesService
- BranchesService

### Core
- CatalogsService
- SettingsService
- AuditService
- NotificationsService

### Financial
- FinancialService
- InvoicesService
- PaymentsService
- AccountingService

### Partners
- PartnersService
- CustomersService
- SuppliersService

### AI/Intelligence
- AIService
- WhatsAppService
- MCPService

---

## Services Propios - Transporte

### OrdenesTransporteService (MAI-003)
- **Path:** `backend/src/modules/ordenes-transporte/services/`
- **Estado:** 40% implementado
- **Metodos:**
  - `create(dto)` - Crear OT
  - `findAll(filters)` - Listar OTs
  - `findById(id)` - Obtener OT
  - `update(id, dto)` - Actualizar OT
  - `delete(id)` - Eliminar OT
  - `changeStatus(id, status)` - Cambiar estado
  - `assignToViaje(otId, viajeId)` - Asignar a viaje

### ViajesService (MAI-004, MAI-005)
- **Path:** `backend/src/modules/viajes/services/`
- **Estado:** Pendiente
- **Metodos:**
  - `create(dto)` - Crear viaje
  - `planificar(viajeId, recursos)` - Planificar recursos
  - `despachar(viajeId, checklist)` - Liberar viaje
  - `cerrar(viajeId, pod)` - Cerrar con POD

### TrackingService (MAI-006)
- **Path:** `backend/src/modules/tracking/services/`
- **Estado:** 20% implementado
- **Metodos:**
  - `registrarEvento(dto)` - Registrar posicion GPS
  - `getUltimaPosicion(unidadId)` - Ultima ubicacion
  - `getHistorial(viajeId)` - Historial de eventos
  - `calcularETA(viajeId)` - ETA dinamico
  - `verificarGeocercas(lat, lng)` - Check geocercas
  - `generarAlerta(tipo, datos)` - Crear alerta

### FlotaService (MAI-011)
- **Path:** `backend/src/modules/gestion-flota/services/`
- **Estado:** 40% implementado
- **Metodos:**
  - `getUnidades(filters)` - Listar unidades
  - `getOperadores(filters)` - Listar operadores
  - `getDisponibilidad(fecha)` - Recursos disponibles
  - `asignarOperador(unidadId, operadorId)` - Asignar
  - `verificarDocumentos(recursoId)` - Validar vigencia

### CombustibleService (MAI-012)
- **Path:** `backend/src/modules/combustible-gastos/services/`
- **Estado:** 50% implementado
- **Metodos:**
  - `registrarCarga(dto)` - Registrar carga combustible
  - `registrarPeaje(dto)` - Registrar cruce peaje
  - `registrarGasto(dto)` - Registrar gasto
  - `generarAnticipo(operadorId, monto)` - Crear anticipo
  - `calcularRendimiento(unidadId, periodo)` - km/litro
  - `detectarAnomalias(viajeId)` - Alertas fraude

### FacturacionTransporteService (MAI-009)
- **Path:** `backend/src/modules/facturacion-transporte/services/`
- **Estado:** 30% implementado
- **Metodos:**
  - `calcularTarifa(lane, peso, volumen)` - Calcular precio
  - `aplicarRecargos(facturaId, recargos)` - Agregar recargos
  - `generarFactura(viajeId)` - Crear factura
  - `calcularFuelSurcharge(fecha)` - Recargo combustible

### CartaPorteService (MAE-016)
- **Path:** `backend/src/modules/carta-porte/services/`
- **Estado:** Pendiente
- **Metodos:**
  - `generarComplemento(viajeId)` - Crear XML
  - `validarDatos(dto)` - Validar requeridos
  - `timbrar(cartaPorteId)` - Enviar a PAC
  - `generarPDF(cartaPorteId)` - PDF para impresion
  - `cancelar(cartaPorteId, motivo)` - Cancelar CFDI

### MantenimientoService (MAI-013)
- **Path:** `backend/src/modules/mantenimiento/services/`
- **Estado:** Pendiente
- **Metodos:**
  - `crearOrdenTrabajo(dto)` - Crear OT manto
  - `programarPreventivo(unidadId)` - Programar
  - `registrarRefaccion(otId, refaccion)` - Agregar parte
  - `getProximosMantenimientos()` - Alertas vencimiento

### CarriersService (MAI-014)
- **Path:** `backend/src/modules/carriers/services/`
- **Estado:** Pendiente
- **Metodos:**
  - `registrarCarrier(dto)` - Alta tercero
  - `validarDocumentos(carrierId)` - Verificar vigencia
  - `calcularScorecard(carrierId)` - Evaluar desempeno
  - `asignarViaje(carrierId, viajeId)` - Subcontratar

---

## Integraciones Externas

### GPSIntegrationService
- **Estado:** Planificado
- **Proveedores:**
  - Geotab
  - Samsara
  - Omnitracs
- **Metodos:**
  - `conectar(proveedor, credentials)`
  - `getPosicion(deviceId)`
  - `getEventos(desde, hasta)`

### PACIntegrationService
- **Estado:** Planificado
- **Proveedores:**
  - Finkok
  - Facturama
  - SW Sapien
- **Metodos:**
  - `timbrar(xml)`
  - `cancelar(uuid, motivo)`
  - `getStatus(uuid)`

### MapasService
- **Estado:** Planificado
- **Proveedores:**
  - Google Maps
  - HERE
  - Mapbox
- **Metodos:**
  - `geocodificar(direccion)`
  - `calcularRuta(origen, destino)`
  - `getDistanciaTiempo(puntos)`

---

## Referencias

- Backend: `backend/src/modules/`
- Entities: `ENTITIES-CATALOG.md`
- API: `_quick/QUICK-API.yml`

---

*Ultima actualizacion: 2026-01-26*