Resumen de módulos
Vista general de los módulos de Embarque. Cada módulo tiene su propia página con detalle a profundidad.
Estructura del sistema
Embarque está organizado en módulos funcionales accesibles desde el menú lateral. El acceso a cada módulo depende de los permisos del rol del usuario.
Embarques
Núcleo operativo: ciclo de vida del embarque, paradas, documentos, gastos adicionales y BOL.
Facturación CFDI
Timbrado CFDI 4.0 con Carta Porte 3.1, multi-RFC emisor, validación previa y manejo de errores SAT.
Cuentas por Cobrar
Pagos individuales y múltiples, complementos de pago, aging y notas de crédito.
Cuentas por Pagar
Facturas de proveedores, pagos, retenciones y comprobantes de pago.
Factoraje
Operaciones con empresas de factoraje, comisiones, días de crédito y portal externo.
Reportes
11 reportes operativos y financieros con exportación a Excel.
Configuración
Razones sociales emisoras, tipos de cambio, penalizaciones y bitácoras del sistema.
Portales externos
Acceso para proveedores y empresas de factoraje con guards independientes.
Cómo se relacionan los módulos
Capacidades transversales
Embarques, facturas y pagos pueden expresarse en MXN o USD. El tipo de cambio se obtiene de la API de Banxico y se almacena en la tabla tipos_cambio. La cobranza calcula totales y aging por moneda de forma separada.
El sistema soporta varias razones sociales emisoras (modelo RazonSocialEmisora) cada una con sus propias credenciales de FacturAPI o Facturama, encriptadas en base de datos.
Toda acción crítica queda registrada en activity_log (Spatie Activity Log): cambios de estado, edición de datos sensibles, cancelaciones, autorizaciones de costos y aprobaciones.
Más de 50 permisos individuales (Spatie Permission) controlan qué puede hacer cada rol. Ejemplos: embarques.aprobarCostos, cxc.exportar, facturas.notaCredito, clientes.view-all.
Combinación de teclas Ctrl+K (Windows/Linux) o ⌘+K (macOS) abre el buscador global. Encuentra embarques, clientes, proveedores y facturas respetando los permisos del usuario.
Las notificaciones del sistema se acumulan en el centro de notificaciones (campana en el header). Avisan de aprobaciones pendientes, vencimientos y cambios de estado.
Procesos en segundo plano
El sistema corre tareas asíncronas en cola para no bloquear la interfaz:
| Job | Cuándo se dispara |
|---|---|
EnviarComplementoPagoEmailJob | Tras generar un complemento de pago, lo envía al cliente con PDF y XML adjuntos |
ConsultarEstatusSatJob | Verifica el estatus de cancelación de una factura ante el SAT |
EnviarBOLProveedorJob | Envía el Bill of Lading firmado al proveedor por correo |
La cola usa el driver database. En producción debe ejecutarse php artisan queue:work como proceso supervisado.
Comandos programados
Se ejecutan vía php artisan schedule:run (cron del servidor):
| Comando | Propósito |
|---|---|
cxc:actualizar-dias-vencidos | Recalcula días vencidos en cuentas por cobrar |
cxp:actualizar-dias-vencidos | Recalcula días vencidos en cuentas por pagar |
facturas:notificar-vencidas | Envía correos de aviso por facturas vencidas |
facturas:descargar-faltantes | Descarga PDF/XML faltantes de FacturAPI |
complementos:generar-automaticos | Genera complementos de pago pendientes |
cancelaciones:verificar-pendientes | Consulta el SAT por cancelaciones en proceso |
factoraje:sincronizar-pagos | Sincroniza pagos del módulo de factoraje |
uploads:clean-temp | Limpia archivos temporales subidos |
Last updated today
Built with Documentation.AI