Коды ошибок истории вызовов (mpbx-cdr)
Коды, которые возвращают mpbx_cdr и маршруты истории вызовов (W2-CDR-01). Типы переводятся в
HTTP-статусы на уровне API, как для общих кодов; ниже указано, где нужен другой статус.
Сообщения никогда не содержат данных о вызовах. Проектор и читатель также возвращают коды MPBX-CH-*
из storage.md. Руководство: docs/guides/cdr.md.
| Код | HTTP | Значение | Что делать |
|---|---|---|---|
MPBX-CDR-UNREADABLE | 500 | ClickHouse вернул строку cdr_calls или cdr_legs с неожиданной структурой (нет столбца, не разбирается идентификатор или время). По этому запросу ничего не возвращено. | Выполните mpbx migrate --ch: обычная причина — не применённая миграция (20261004220000_cdr_projection). |
MPBX-CDR-SCOPE-TOO-LARGE | 422 | Только Scope::users (для вызывающих библиотеку): более 2 000 пользователей в одной области пользователей. API истории вызовов больше не возвращает этот код с GAP-B07 (FU-CDR01-L1): область отдела свыше 2 000 пользователей фильтрует по отделам, проставленным в каждой строке. | Используйте Scope::departments. |
MPBX-CDR-PDF-FONT | config | Файл cdr.pdf_fonts нельзя прочитать, он не является шрифтом TrueType или имеет контуры CFF (.otf), которые экспорт PDF не может встроить. Сообщение называет файл. mpbx run отказывается запускаться. | Укажите в cdr.pdf_fonts файлы .ttf или .ttc (например, Noto Sans, DejaVu Sans, WenQuanYi Micro Hei) или оставьте поле пустым, чтобы использовать системные шрифты. |
MPBX-CDR-EXPORT-UNAVAILABLE | 501 | Для формата экспорта не установлен кодировщик (CSV, XLSX и PDF встроены с W4-RPT-01; этот ответ дают только сборки, в которых установлено меньше). | Используйте format=csv. |
MPBX-CDR-EXPORT-TOO-LARGE | 413 | Экспорт содержал бы больше строк, чем cdr.export_max_rows (по умолчанию 100 000), а для PDF — больше 20 000 строк. | Сузьте фильтры (диапазон дат), используйте CSV или XLSX либо увеличьте cdr.export_max_rows. |
MPBX-CDR-BAD-RETENTION | config | cdr.retention_days вне диапазона от 1 до 36500. mpbx run отказывается запускаться. | Исправьте раздел [cdr] в mpbx.toml. |
MPBX-API-NOT-CONFIGURED | 503 | Маршруты истории вызовов отвечают этим кодом, когда сервер запущен без clickhouse.url. События вызовов больше нигде не сохраняются, поэтому вызовы, совершённые в это время, не имеют записи. | Укажите [clickhouse] url и перезапустите сервер. |