Códigos de error del historial de llamadas (mpbx-cdr)
Códigos que genera mpbx_cdr y las rutas del historial de llamadas (W2-CDR-01). Los tipos se asignan a
estados HTTP en la capa de la API como en los códigos comunes; los de abajo que necesitan
otro estado lo indican. Los mensajes nunca contienen datos de llamadas. El proyector y el lector también
generan los códigos MPBX-CH-* de storage.md. Guía: docs/guides/cdr.md.
| Código | HTTP | Significado | Qué hacer |
|---|---|---|---|
MPBX-CDR-UNREADABLE | 500 | ClickHouse devolvió una fila de cdr_calls o cdr_legs que no tiene la forma esperada (columna faltante, id o hora no analizable). No se devolvió nada para esa solicitud. | Ejecute mpbx migrate --ch: una migración no aplicada (20261004220000_cdr_projection) es la causa habitual. |
MPBX-CDR-SCOPE-TOO-LARGE | 422 | Solo Scope::users (llamadores de la biblioteca): más de 2,000 usuarios en un mismo ámbito de usuarios. La API del historial de llamadas ya no lo genera desde GAP-B07 (FU-CDR01-L1): un ámbito de departamento por encima de 2,000 usuarios filtra por los departamentos registrados en cada fila. | Use Scope::departments. |
MPBX-CDR-PDF-FONT | config | Un archivo de cdr.pdf_fonts no se puede leer, no es una fuente TrueType o tiene contornos CFF (.otf), que la exportación a PDF no puede incrustar. El mensaje indica el archivo. mpbx run se niega a iniciar. | Apunte cdr.pdf_fonts a archivos .ttf o .ttc (por ejemplo Noto Sans, DejaVu Sans, WenQuanYi Micro Hei), o déjelo vacío para usar las fuentes del sistema que existan. |
MPBX-CDR-EXPORT-UNAVAILABLE | 501 | El formato de exportación no tiene codificador instalado (CSV, XLSX y PDF vienen integrados desde W4-RPT-01; solo una compilación que instale menos responde esto). | Use format=csv. |
MPBX-CDR-EXPORT-TOO-LARGE | 413 | La exportación tendría más filas que cdr.export_max_rows (por omisión 100,000), o, para un PDF, más de 20,000 filas. | Reduzca los filtros (un rango de fechas), use CSV o XLSX, o aumente cdr.export_max_rows. |
MPBX-CDR-BAD-RETENTION | config | cdr.retention_days está fuera de 1 a 36500. mpbx run se niega a iniciar. | Corrija [cdr] en mpbx.toml. |
MPBX-API-NOT-CONFIGURED | 503 | Las rutas del historial de llamadas responden esto cuando el servidor se ejecuta sin clickhouse.url. Los eventos de llamadas no se guardan en ningún otro lugar, así que las llamadas hechas mientras tanto no tienen registro. | Configure [clickhouse] url y reinicie. |