feat: facturación primer pago, fixes SAT/MP, autocompletado RFCs/conceptos

Backend:
- Notificación email al admin cuando llega primer pago aprobado (sin factura auto)
- Endpoints GET /pagos-sin-factura y POST /emitir-factura-pago para admin global
- Fix vinculación org Facturapi Horux 360 (69f23a5a242e0af47a41fa0d)
- Fix webhook MP: validación defensiva de x-signature header
- Fix autocompleto RFCs: eliminado filtro por contribuyenteId
- Fix autocompleto conceptos: eliminado filtro por contribuyenteId
- SAT fixes: anti-bot CSF scraper, request reuse, date range fix, stale job thresholds
- SAT sync request reuse across jobs para evitar agotar cuota diaria
- Typo fix MP_ACCESS_TOKEN en .env
- Trial invitations system backend

Frontend:
- Nueva página /admin/facturas-pendientes con tabla y emisión manual
- Métrica 'Facturas pendientes' en /clientes (clickable)
- Navegación onboarding FIEL/CSD corregida
- Sidebar themes sincronizados
- Fix SAT portal migration scraper (NetIQ)
- Trial invitation acceptance pages

apps/web/components/cfdi/cfdi-invoice.tsx

@@ -177,8 +177,8 @@ export const CfdiInvoice = forwardRef<HTMLDivElement, CfdiInvoiceProps>(
             <div className="bg-gray-50 rounded-lg p-3 text-center">
               <p className="text-xs text-gray-500 uppercase tracking-wide">Moneda</p>
               <p className="text-sm font-semibold text-gray-800 mt-1">{cfdi.moneda || 'MXN'}</p>
-              {cfdi.typeCambio && cfdi.typeCambio !== 1 && (
-                <p className="text-xs text-gray-500">TC: {cfdi.typeCambio}</p>
+              {cfdi.tipoCambio && cfdi.tipoCambio !== 1 && (
+                <p className="text-xs text-gray-500">TC: {cfdi.tipoCambio}</p>
               )}
             </div>
             <div className="bg-gray-50 rounded-lg p-3 text-center">

apps/web/components/cfdi/cfdi-viewer-modal.tsx

@@ -121,7 +121,7 @@ export function CfdiViewerModal({ cfdi, open, onClose }: CfdiViewerModalProps) {
       let xml = xmlContent;
 
       if (!xml) {
-        xml = await getCfdiXml(cfdi.id);
+        xml = await getCfdiXml(String(cfdi.id));
       }
 
       if (!xml) {

apps/web/components/despachos/despacho-subnav.tsx

@@ -13,17 +13,21 @@ interface NavItem {
   roles: string[];
 }
 
+const PLATFORM_SUPERSET = new Set(['platform_admin', 'platform_ti']);
+
 const ITEMS: NavItem[] = [
-  { href: '/despachos/contribuyentes', label: 'Contribuyentes', icon: Building2, roles: ['owner', 'cfo'] },
-  { href: '/despachos/mis-asignados', label: 'Mis asignados', icon: UserCheck, roles: ['owner', 'cfo', 'supervisor', 'auxiliar'] },
+  { href: '/despachos/contribuyentes', label: 'Contribuyentes', icon: Building2, roles: ['owner', 'cfo', 'contador', 'visor', 'supervisor', 'auxiliar'] },
+  { href: '/despachos/mis-asignados', label: 'Mis asignados', icon: UserCheck, roles: ['owner', 'cfo', 'supervisor', 'auxiliar', 'contador', 'visor'] },
   { href: '/despachos/equipo', label: 'Equipo', icon: Users, roles: ['owner', 'cfo', 'supervisor'] },
 ];
 
 export function DespachoSubnav() {
   const pathname = usePathname();
   const role = useAuthStore(s => s.user?.role);
+  const platformRoles = useAuthStore(s => s.user?.platformRoles);
+  const isPlatformStaff = platformRoles?.some(r => PLATFORM_SUPERSET.has(r)) ?? false;
   if (!role) return null;
-  const visibles = ITEMS.filter(i => i.roles.includes(role));
+  const visibles = ITEMS.filter(i => isPlatformStaff || i.roles.includes(role));
   return (
     <div className="flex border-b mb-6">
       {visibles.map(item => {
@@ -50,8 +54,10 @@ export function DespachoSubnav() {
 }
 
 /** Resuelve la página default según rol al entrar a /despachos. */
-export function defaultDespachoPathForRole(role: string): string {
+export function defaultDespachoPathForRole(role: string, platformRoles?: string[]): string {
+  const isPlatformStaff = platformRoles?.some(r => PLATFORM_SUPERSET.has(r)) ?? false;
+  if (isPlatformStaff) return '/despachos/contribuyentes';
   if (role === 'owner' || role === 'cfo') return '/despachos/contribuyentes';
   if (role === 'supervisor' || role === 'auxiliar') return '/despachos/mis-asignados';
-  return '/despachos/mis-asignados';
+  return '/despachos/contribuyentes';
 }

apps/web/components/layouts/sidebar-compact.tsx

@@ -17,6 +17,15 @@ import {
   Building2,
   Scale,
   Send,
+  ListChecks,
+  FileCheck,
+  ClipboardList,
+  CreditCard,
+  Gift,
+  UserCog,
+  Shield,
+  FileWarning,
+  Receipt,
 } from 'lucide-react';
 import { useAuthStore } from '@/stores/auth-store';
 import { logout } from '@/lib/api/auth';
@@ -25,21 +34,38 @@ import { useRouter } from 'next/navigation';
 import { useState } from 'react';
 import { hasDespachoFeature, isGlobalAdminRfc, type DespachoPlan } from '@horux/shared';
 
-const navigation = [
-  { name: 'Dashboard', href: '/dashboard', icon: LayoutDashboard, roles: ['owner', 'contador'] },
+interface NavItem {
+  name: string;
+  href: string;
+  icon: any;
+  feature?: string;
+  roles?: string[];
+}
+
+const navigation: NavItem[] = [
+  { name: 'Despacho', href: '/despachos', icon: ListChecks, roles: ['owner', 'cfo', 'contador', 'auxiliar', 'supervisor'] },
+  { name: 'Dashboard', href: '/dashboard', icon: LayoutDashboard, roles: ['owner', 'cfo', 'contador', 'auxiliar', 'supervisor', 'cliente'] },
   { name: 'CFDI', href: '/cfdi', icon: FileText },
   { name: 'Impuestos', href: '/impuestos', icon: Calculator },
-  { name: 'Reportes', href: '/reportes', icon: BarChart3, feature: 'reportes', roles: ['owner'] },
+  { name: 'Reportes', href: '/reportes', icon: BarChart3, feature: 'reportes', roles: ['owner', 'cfo', 'supervisor', 'cliente'] },
   { name: 'Conciliacion', href: '/conciliacion', icon: Scale, feature: 'conciliacion' },
   { name: 'Calendario', href: '/calendario', icon: Calendar, feature: 'calendario' },
   { name: 'Alertas', href: '/alertas', icon: Bell, feature: 'alertas' },
-  { name: 'Facturación', href: '/facturacion', icon: Send, roles: ['owner', 'contador'] },
-  { name: 'Usuarios', href: '/usuarios', icon: Users, roles: ['owner'] },
-  { name: 'Configuración', href: '/configuracion', icon: Settings, roles: ['owner'] },
-] as const;
+  { name: 'Facturación', href: '/facturacion', icon: Send, roles: ['owner', 'cfo', 'contador', 'auxiliar', 'supervisor'] },
+  { name: 'Documentos', href: '/documentos', icon: FileCheck, feature: 'documentos' },
+  { name: 'Carteras', href: '/carteras', icon: ClipboardList, roles: ['supervisor', 'auxiliar'] },
+  { name: 'Contribuyentes', href: '/contribuyentes', icon: Building2, roles: ['owner', 'cfo'] },
+  { name: 'Usuarios', href: '/usuarios', icon: Users, roles: ['owner', 'cfo'] },
+  { name: 'Planes', href: '/configuracion/planes-despacho', icon: CreditCard, roles: ['owner', 'cfo'] },
+  { name: 'Configuracion', href: '/configuracion', icon: Settings, roles: ['owner', 'cfo'] },
+];
 
-const adminNavigation = [
+const adminNavigation: NavItem[] = [
   { name: 'Clientes', href: '/clientes', icon: Building2 },
+  { name: 'Admin Usuarios', href: '/admin/usuarios', icon: UserCog },
+  { name: 'Staff', href: '/admin/staff', icon: Shield },
+  { name: 'Invitaciones Trial', href: '/admin/invitaciones-trial', icon: Gift },
+  { name: 'Audit Log', href: '/admin/audit-log', icon: FileWarning },
 ];
 
 export function SidebarCompact() {
@@ -53,7 +79,7 @@ export function SidebarCompact() {
   const navGate = useNavGate();
   const filteredNav = navigation.filter((item) => {
     if ('feature' in item && item.feature && !hasDespachoFeature(plan, item.feature)) return false;
-    if ('roles' in item && item.roles && !item.roles.includes(role)) return false;
+    if ('roles' in item && item.roles && !item.roles.includes(role as string)) return false;
     if (!navGate.isAllowed(item.href)) return false;
     return true;
   });

apps/web/components/layouts/sidebar-floating.tsx

@@ -17,6 +17,15 @@ import {
   Building2,
   Scale,
   Send,
+  ListChecks,
+  FileCheck,
+  ClipboardList,
+  CreditCard,
+  Gift,
+  UserCog,
+  Shield,
+  FileWarning,
+  Receipt,
 } from 'lucide-react';
 import { useAuthStore } from '@/stores/auth-store';
 import { logout } from '@/lib/api/auth';
@@ -24,21 +33,38 @@ import { useNavGate } from '@/lib/hooks/use-nav-gate';
 import { useRouter } from 'next/navigation';
 import { hasDespachoFeature, isGlobalAdminRfc, type DespachoPlan } from '@horux/shared';
 
-const navigation = [
-  { name: 'Dashboard', href: '/dashboard', icon: LayoutDashboard, roles: ['owner', 'contador'] },
+interface NavItem {
+  name: string;
+  href: string;
+  icon: any;
+  feature?: string;
+  roles?: string[];
+}
+
+const navigation: NavItem[] = [
+  { name: 'Despacho', href: '/despachos', icon: ListChecks, roles: ['owner', 'cfo', 'contador', 'auxiliar', 'supervisor'] },
+  { name: 'Dashboard', href: '/dashboard', icon: LayoutDashboard, roles: ['owner', 'cfo', 'contador', 'auxiliar', 'supervisor', 'cliente'] },
   { name: 'CFDI', href: '/cfdi', icon: FileText },
   { name: 'Impuestos', href: '/impuestos', icon: Calculator },
-  { name: 'Reportes', href: '/reportes', icon: BarChart3, feature: 'reportes', roles: ['owner'] },
+  { name: 'Reportes', href: '/reportes', icon: BarChart3, feature: 'reportes', roles: ['owner', 'cfo', 'supervisor', 'cliente'] },
   { name: 'Conciliacion', href: '/conciliacion', icon: Scale, feature: 'conciliacion' },
   { name: 'Calendario', href: '/calendario', icon: Calendar, feature: 'calendario' },
   { name: 'Alertas', href: '/alertas', icon: Bell, feature: 'alertas' },
-  { name: 'Facturación', href: '/facturacion', icon: Send, roles: ['owner', 'contador'] },
-  { name: 'Usuarios', href: '/usuarios', icon: Users, roles: ['owner'] },
-  { name: 'Config', href: '/configuracion', icon: Settings, roles: ['owner'] },
-] as const;
+  { name: 'Facturación', href: '/facturacion', icon: Send, roles: ['owner', 'cfo', 'contador', 'auxiliar', 'supervisor'] },
+  { name: 'Documentos', href: '/documentos', icon: FileCheck, feature: 'documentos' },
+  { name: 'Carteras', href: '/carteras', icon: ClipboardList, roles: ['supervisor', 'auxiliar'] },
+  { name: 'Contribuyentes', href: '/contribuyentes', icon: Building2, roles: ['owner', 'cfo'] },
+  { name: 'Usuarios', href: '/usuarios', icon: Users, roles: ['owner', 'cfo'] },
+  { name: 'Planes', href: '/configuracion/planes-despacho', icon: CreditCard, roles: ['owner', 'cfo'] },
+  { name: 'Configuracion', href: '/configuracion', icon: Settings, roles: ['owner', 'cfo'] },
+];
 
-const adminNavigation = [
+const adminNavigation: NavItem[] = [
   { name: 'Clientes', href: '/clientes', icon: Building2 },
+  { name: 'Admin Usuarios', href: '/admin/usuarios', icon: UserCog },
+  { name: 'Staff', href: '/admin/staff', icon: Shield },
+  { name: 'Invitaciones Trial', href: '/admin/invitaciones-trial', icon: Gift },
+  { name: 'Audit Log', href: '/admin/audit-log', icon: FileWarning },
 ];
 
 export function SidebarFloating() {

apps/web/components/layouts/sidebar.tsx

@@ -21,10 +21,12 @@ import {
   Scale,
   FileCheck,
   FileWarning,
+  Receipt,
   Shield,
   Rocket,
   ClipboardList,
   ListChecks,
+  Gift,
 } from 'lucide-react';
 import { useAuthStore } from '@/stores/auth-store';
 import { logout } from '@/lib/api/auth';
@@ -65,6 +67,7 @@ const adminNavigation: NavItem[] = [
   { name: 'Clientes', href: '/clientes', icon: Building2 },
   { name: 'Admin Usuarios', href: '/admin/usuarios', icon: UserCog },
   { name: 'Staff', href: '/admin/staff', icon: Shield },
+  { name: 'Invitaciones Trial', href: '/admin/invitaciones-trial', icon: Gift },
   { name: 'Audit Log', href: '/admin/audit-log', icon: FileWarning },
 ];
 

apps/web/components/layouts/topnav.tsx

@@ -17,6 +17,15 @@ import {
   Building2,
   Scale,
   Send,
+  ListChecks,
+  FileCheck,
+  ClipboardList,
+  CreditCard,
+  Gift,
+  UserCog,
+  Shield,
+  FileWarning,
+  Receipt,
 } from 'lucide-react';
 import { useAuthStore } from '@/stores/auth-store';
 import { logout } from '@/lib/api/auth';
@@ -25,21 +34,38 @@ import { useRouter } from 'next/navigation';
 import { useState } from 'react';
 import { hasDespachoFeature, isGlobalAdminRfc, type DespachoPlan } from '@horux/shared';
 
-const navigation = [
-  { name: 'Dashboard', href: '/dashboard', icon: LayoutDashboard, roles: ['owner', 'contador'] },
+interface NavItem {
+  name: string;
+  href: string;
+  icon: any;
+  feature?: string;
+  roles?: string[];
+}
+
+const navigation: NavItem[] = [
+  { name: 'Despacho', href: '/despachos', icon: ListChecks, roles: ['owner', 'cfo', 'contador', 'auxiliar', 'supervisor'] },
+  { name: 'Dashboard', href: '/dashboard', icon: LayoutDashboard, roles: ['owner', 'cfo', 'contador', 'auxiliar', 'supervisor', 'cliente'] },
   { name: 'CFDI', href: '/cfdi', icon: FileText },
   { name: 'Impuestos', href: '/impuestos', icon: Calculator },
-  { name: 'Reportes', href: '/reportes', icon: BarChart3, feature: 'reportes', roles: ['owner'] },
+  { name: 'Reportes', href: '/reportes', icon: BarChart3, feature: 'reportes', roles: ['owner', 'cfo', 'supervisor', 'cliente'] },
   { name: 'Conciliacion', href: '/conciliacion', icon: Scale, feature: 'conciliacion' },
   { name: 'Calendario', href: '/calendario', icon: Calendar, feature: 'calendario' },
   { name: 'Alertas', href: '/alertas', icon: Bell, feature: 'alertas' },
-  { name: 'Facturación', href: '/facturacion', icon: Send, roles: ['owner', 'contador'] },
-  { name: 'Usuarios', href: '/usuarios', icon: Users, roles: ['owner'] },
-  { name: 'Config', href: '/configuracion', icon: Settings, roles: ['owner'] },
-] as const;
+  { name: 'Facturación', href: '/facturacion', icon: Send, roles: ['owner', 'cfo', 'contador', 'auxiliar', 'supervisor'] },
+  { name: 'Documentos', href: '/documentos', icon: FileCheck, feature: 'documentos' },
+  { name: 'Carteras', href: '/carteras', icon: ClipboardList, roles: ['supervisor', 'auxiliar'] },
+  { name: 'Contribuyentes', href: '/contribuyentes', icon: Building2, roles: ['owner', 'cfo'] },
+  { name: 'Usuarios', href: '/usuarios', icon: Users, roles: ['owner', 'cfo'] },
+  { name: 'Planes', href: '/configuracion/planes-despacho', icon: CreditCard, roles: ['owner', 'cfo'] },
+  { name: 'Configuracion', href: '/configuracion', icon: Settings, roles: ['owner', 'cfo'] },
+];
 
-const adminNavigation = [
+const adminNavigation: NavItem[] = [
   { name: 'Clientes', href: '/clientes', icon: Building2 },
+  { name: 'Admin Usuarios', href: '/admin/usuarios', icon: UserCog },
+  { name: 'Staff', href: '/admin/staff', icon: Shield },
+  { name: 'Invitaciones Trial', href: '/admin/invitaciones-trial', icon: Gift },
+  { name: 'Audit Log', href: '/admin/audit-log', icon: FileWarning },
 ];
 
 export function TopNav() {