# Проблемы печати

# Задание не появляется в очереди печати

## Симптом

Пользователь отправил документ на печать, но задание не появляется в разделе **Управление → Задания** и на МФУ.

## Условия возникновения

- Используется клиент ПринтМенеджер на Windows или Linux
- Печать выполняется через принтер Printum

## Диагностика

### Шаг 1. Проверить статус службы клиента ПМ

**Windows:** Win+R → `eventvwr` → Журналы Windows → Приложение → источник _Print Manager Client_. Найти ошибки (красные/жёлтые записи).

**Linux:**

```
sudo systemctl status printum-printmanager-client.service
sudo journalctl -u printum-printmanager-client.service
```

### Шаг 2. Типовые ошибки в логах

- **No user {'i.sokolov'} is authorized, removing all printers.**

Эта ошибка означает, что сотрудник с именем i.sokolov, авторизованный в операционной системе Windows, не авторизован в системе управления печатью. 

Откройте раздел “Сотрудники” на сервере, убедитесь, что сотрудник с именем i.sokolov существует и имеет правильный SID. Также проверьте, что токен доступа `access_token` введен правильно.

- **Error in VirtualPrintersUpdater: HTTPSConnectionPool(host='192.168.1.1, port=8080): Max retries exceeded with url: /direct_printers/**

Ошибка означает, что программа не смогла подключиться к серверу c адресом 192.168.1.1 и портом 8080. Проверьте, что сервер доступен по этому адресу с этого компьютера.

- **Error in VirtualPrintersUpdater: (1789, 'LookupAccountName', 'Не удалось установить доверительные отношения между этой рабочей станцией и основным доменом.')**

  

Ошибка означает, что программа не смогла подключиться к домену, для получения необходимых данных. Проверьте соединение с доменом.

Если ошибка возникает при отправке документа от локальной учётной записи пользователя, убедитесь, что этот пользователь входит в рабочую группу WORKGROUP, а не в какую-либо другую.

- **Job 00021 for VersaLink_B405_XXXXXXXXX failed: Error: 401**

Ошибка означает, что программа не смогла подключиться к CUPS из-за неправильных логина-пароля или настроек шифрования. Проверьте настройки Сервера печати, куда добавлен принтер для прямой печати. Так же проверьте, что включена настройка ALLOW_BYPASS_PRINTING в Настройках печати.

- **AssertionError: Adding printer Printum means critical error. Reinstall this printer manually or application entirely.**

Ошибка означает, что при старте службы, программа не нашла принтер Printum с драйвером Printum XPS. Т.е. либо самого принтера с таким именем нет, либо у него установлен неверный драйвер. Удалите такой принтер вручную, и переустановите программу.

- **http.client.RemoteDisconnected: Remote end closed connection without response**

Ошибка встречается в отказоустойчивой конфигурации. Происходит, если в конфигурационном файле клиента ПМ стоит флаг `use_cups_ssl: false`  
  
Для исправления ошибки поменяйте значение.

### Шаг 3. Проверить наличие принтера

Убедитесь, что в системе присутствует виртуальный принтер с именем **Printum** и он использует драйвер Printum XPS.

## Что проверить перед эскалацией

- Логи клиента ПринтМенеджер без ошибок
- Служба клиента запущена
- Принтер Printum присутствует на АРМ
- Пользователь существует в Printum

## Логи и диагностические данные

### Где смотреть логи

- **Клиент ПМ Windows** — Отправка заданий на печать на ОС Windows  
    Откройте `eventvwr` → Журналы Windows → Приложение → источник _Print Manager Client_
- **Клиент ПМ Linux** — Отправка заданий на печать на ОС Linux  
    `sudo journalctl -u printum-printmanager-client.service`
- **printmanager-app** — Основной контейнер ПМ — обработка HTTP-запросов, приём заданий от клиентов  
    `sudo docker logs printmanager-app`

### Что искать в логах

- Выявить ошибки запуска сервиса клиента ПМ.
- Выявить ошибки передачи данных от клиента на сервер.
- Выявить ошибки обработки API-запросов в printmanager-app.
- Определить причины возврата кодов 4xx/5xx.

### Что приложить к обращению в поддержку

- Логи клиента ПМ: Windows — Просмотр событий (`eventvwr`) → Журналы Windows → Приложение → источник _Print Manager Client_; Linux — `sudo journalctl -u printum-printmanager-client.service`
- Версию ПринтМенеджера: `cat /opt/printmanager/.version`
- Описание сценария и шагов воспроизведения
- ОС рабочей станции и сервера

## Связанные страницы

- [Задание не распечатывается на принтере](http://wiki.printum.io/books/7-ustranenie-neispravnostei/page/zadanie-ne-raspecatyvaetsia-na-printere)
- [Принтеры не появляются на рабочей станции](http://wiki.printum.io/books/7-ustranenie-neispravnostei/page/printery-ne-poiavliaiutsia-na-rabocei-stancii)

# Документы печатаются с обрезанными краями

## Симптом

При печати или копировании края документа обрезаются.

## Причина

Поскольку принтеры имеют непечатаемые поля, то стандартным поведением при копировании является печать с обрезанием краев.

## Решение

1. Откройте панель ПринтМененджера и перейдите в “Настройки”.
2. Откройте подраздел “Настройки печати” и установите галочку у переменной FIT_TO_PAGE.

Теперь изображения будут масштабироваться по размерам печатаемого листа.

# Медленная печать или долгая обработка документов

## Симптом

Большие документы долго обрабатываются системой, отправка задания на устройство занимает значительное время.

## Диагностика и решение

### Шаг 1. Переключить формат на PostScript (для печати без клиента ПМ)

В панели администратора ПМ: **Системные настройки → Настройки → Настройки печати**  включить параметр `USE_PS_PRINTING`.

**Ограничения PostScript-режима:** не применяется при правилах по количеству страниц/цветности и при автоудалении документа. На Konica Minolta и Kyocera может печататься дополнительная техническая страница.

### Шаг 2. Заменить драйвер в CUPS

Если переключение на PostScript не помогло — замените драйвер Generic PostScript на родной драйвер модели или Generic PCL.

### Шаг 3. Проверить нагрузку на сервер

- Проверьте загрузку CPU и памяти на сервере ПМ.
- В кластерной конфигурации — добавьте серверы ПринтМенеджер (1 сервер до 100 заданий/мин).

## Связанные страницы

- [Задание не распечатывается на принтере](http://wiki.printum.io/books/7-ustranenie-neispravnostei/page/zadanie-ne-raspecatyvaetsia-na-printere)
- [Управление драйверами и протоколами](http://wiki.printum.io/books/5-upravlenie-sistemoi/page/upravlenie-draiverami-i-protokolami)

# Не печатаются схемы в PDF при отложенной печати

## Симптом

PDF-документы со схемами или чертежами не печатаются или отображаются некорректно при отложенной печати без клиента ПМ.

## Решения

### Шаг 1. Попробовать другой браузер/приложение

Если печать идёт из Chrome или Yandex Browser — попробуйте Firefox. Разные приложения по-разному растеризуют PDF.

### Шаг 2. Отключить пересылку PostScript в драйвере (Windows 10)

1. Пуск → Параметры → Устройства → Принтеры и сканеры.
2. Выберите принтер Printum → Управление → Настройки печати → вкладка **«Дополнительно»**.
3. Откройте **Драйвер** (+) → **Пересылка PostScript** → **Выключено** → ОК.

**Предупреждение:** это может ухудшить качество печати других документов.

## Связанные страницы

- [Медленная печать или долгая обработка документов](http://wiki.printum.io/books/7-ustranenie-neispravnostei/page/medlennaia-pecat-ili-dolgaia-obrabotka-dokumentov)
- [Задание не распечатывается на принтере](http://wiki.printum.io/books/7-ustranenie-neispravnostei/page/zadanie-ne-raspecatyvaetsia-na-printere)

# Ошибка printer.py при обработке задания

## Описание

Консольное приложение `printer_scan.py` используется для диагностики обнаружения устройств в сети — проверяет доступность принтеров и наличие SNMP. Это инструмент диагностики, а не компонент основного потока печати.

---

## Симптомы

- Скрипт `printer_scan.py` завершается с ошибкой или не выводит ожидаемых результатов.
- Устройства не обнаруживаются при сканировании.

---

## Возможные причины

- Не установлены зависимости: библиотеки **nmap** и **pandas**.
- Файл `Devices.xlsx` отсутствует или назван некорректно.
- Указан некорректный диапазон IP-адресов.
- Файл `printer_scan.py` не был получен от службы технической поддержки.

---

## Диагностика и решение

1. Убедитесь, что установлены необходимые библиотеки (`nmap` и `pandas`).
2. Убедитесь, что файл корректно перенесён на сервер и запускается из своей папки: 

       python3 printer_scan.py
   
4. Убедитесь, что файл `Devices.xlsx` (экспорт из ЛК → раздел «Устройства» → кнопка «Excel») переименован корректно и находится в доступном месте.
5. При запросе IP-адресов убедитесь в корректности диапазона (формат: подсеть или диапазон).
6. Если файл `printer_scan.py` отсутствует — запросите его у службы технической поддержки.

---

## Что проверить перед эскалацией

- Зависимости установлены.
- Файл `Devices.xlsx` получен из ЛК текущей установки и переименован в `Devices.xlsx`.
- Диапазон IP-адресов корректен и соответствует сети с принтерами.

# Постоянный запрос токена на МФУ Ricoh

## Симптомы

Встроенное приложение на МФУ Ricoh постоянно запрашивает получение токена. Авторизация пользователей не завершается.

---

## Возможная причина

Проблема может быть вызвана сторонними приложениями, установленными на принтере, которые взаимодействуют с устройством и конфликтуют с системой Принтум. Например, это могут быть утилиты управления, такие как **Device Software Manager**.

---

## Решение

1. **Проверьте установленные приложения:**
    - Откройте интерфейс управления принтером.
    - Войдите в систему под логином и паролем администратора.
    - Перейдите в раздел, где перечислены все установленные приложения.
2. **Удалите сторонние приложения:**
    - Найдите приложения, не связанные с системой Принтум, но имеющие доступ к принтеру.
    - Удалите их. Особое внимание уделите утилитам, которые могут управлять настройками устройства.
3. **Перезагрузите принтер:** после внесённых изменений выполните перезагрузку устройства, чтобы убедиться в устранении проблемы.

Если проблема сохраняется, обратитесь в службу поддержки с указанием модели устройства и подробным описанием возникшей ситуации.

---

## Логи и диагностические данные

### Где смотреть логи

- **printmanager-app** — Основной контейнер ПМ — обработка запросов авторизации от встроенного приложения  
    `cd /opt/printmanager && docker-compose logs -f --tail=200 printmanager-app`
- **printmanager-converter-server** — TCP-конвертер — приём запросов авторизации по TCP от устройства  
    `cd /opt/printmanager && docker-compose logs -f --tail=200 printmanager-converter-server`

### Что искать в логах

- Выявить, приходит ли сообщение от конвертера.
- Выявить ошибки авторизации по TCP.
- Выявить ошибки обработки API-запросов от встроенного приложения МФУ.

### Что приложить к обращению в поддержку

- Вывод команды `bash /opt/printmanager/logs.sh`
- Версию: `cat /opt/printmanager/.version`
- Описание сценария и шагов воспроизведения
- ОС сервера

## Что проверить перед эскалацией

- Все сторонние приложения удалены.
- Принтер перезагружен после удаления приложений.
- В обращении указана модель устройства и подробное описание ситуации.

# Проблемы с печатью из Office 2010

## Симптомы

Цветные документы, распечатанные из Microsoft Office 2010 через Клиент ПМ, выходят в чёрно-белом виде.

---

## Решение

1. Перейдите в папку с установленным Клиентом ПМ:

```
C:\Program Files\printum\printmanager_client
```

2. Откройте файл `settings.yml`.
3. Измените следующие строки:

```
use_gs_conversion: true
use_pdf_color_analysis: true
```

4. Сохраните файл и перезапустите службу **Printum Optimize Service** (через компонент `services`).

---

## Что проверить перед эскалацией

- Параметры `use_gs_conversion` и `use_pdf_color_analysis` установлены в `true`.
- Служба Printum Optimize Service перезапущена.
- Проверена печать цветного документа после изменений.

# Проблемы с печатью из LibreOffice

## Симптомы

При отправке задания печати из LibreOffice через Клиент ПМ в очереди печати появляется дополнительная копия задания (задание отправляется дважды).

---

## Решение

1. Откройте LibreOffice и перейдите в настройки (Alt+F12).
2. В разделе **«LibreOffice»** откройте подраздел **«Печать»**.
3. Включите галочку **«Задания печати в формате PDF»**.

[![image232.png](https://wiki.printum.io/uploads/images/gallery/2026-05/scaled-1680-/image232.png)](https://wiki.printum.io/uploads/images/gallery/2026-05/image232.png)

---

## Что проверить перед эскалацией

- Галочка «Задания печати в формате PDF» установлена в настройках LibreOffice.
- Проверена печать после изменения настройки.

# Встала печать после обновления — Bad response from monitoring 500

---
title: Встала печать после обновления — Bad response from monitoring 500
slug: ts-bad-response-500-posle-obnovleniya
tags: [обновление, bad response, 500, синхронизация, печать]
domain: Troubleshooting
type: Troubleshooting
audience: partner-engineer
product_versions: "4.x"
status: ready
related_components: [Мониторинг, ПринтМенеджер]
related_pages:
  - kak-obnovit-printum
  - kak-rabotaet-sinhronizaciya-monitoring-i-printmanager
---

# Встала печать после обновления — Bad response from monitoring 500

## Симптомы

- После обновления М или ПринтМенеджер печать перестала работать на всех или части устройств.
- В логах ПринтМенеджер или на почту администраторов приходят ошибки вида:
  ```
  Bad response from monitoring 500
  ```
- Синхронизация Мониторинг–ПринтМенеджер завершается с ошибкой.

---

## Причина

После обновления М изменился адрес, порт или протокол синхронизации. ПринтМенеджер продолжает обращаться по старым параметрам — получает 500 вместо корректного ответа.

---

## Диагностика

Проверить логи ПринтМенеджер:

```bash
cd /opt/printmanager
sudo docker-compose logs printum_worker-high --tail=100 | grep -i "bad response\|monitoring"
```

Проверить доступность М с сервера ПринтМенеджер:

```bash
curl -k https://<адрес_М>:8001/api/health/
```

Норма: ответ 200.
Ошибка: connection refused, timeout, 500.

---

## Решение

**1. Проверить настройки синхронизации в ЛК**

ЛК → Настройки → Интеграции → ПринтМенеджеры: убедиться, что адрес М и порт указаны корректно.

**2. Проверить `.env` ПринтМенеджер**

```bash
grep MONITORING_ADDRESS /opt/printmanager/.env
```

Адрес должен совпадать с актуальным адресом сервера М.

**3. Перезапустить ПринтМенеджер**

```bash
cd /opt/printmanager
sudo docker-compose down && sudo docker-compose up -d
```

**4. Запустить синхронизацию вручную**

В панели администратора М → ПринтМенеджеры → кнопка «Синхронизировать».

---

## Как проверить результат

- Синхронизация завершается без ошибок.
- Задания уходят на МФУ.
- Логи не содержат `Bad response from monitoring`.

---

## Когда эскалировать

- После всех шагов ошибка сохраняется.
- Адрес М в `.env` корректный, но ответ всё равно 500.
- М недоступен с сервера ПринтМенеджер — сетевая проблема.

Приложить к заявке: версии М и ПринтМенеджер, вывод `docker-compose ps`, логи `printum_worker-high`.

---

## Связанные страницы

- [Как обновить Printum](kak-obnovit-printum)
- [Как работает синхронизация Мониторинга и ПринтМенеджера](kak-rabotaet-sinhronizaciya-monitoring-i-printmanager)

# Пользователь авторизовался, но задания не отображаются

<!---
title: Пользователь авторизовался, но задания не отображаются
slug: ts-zadaniya-ne-otobrazhaetsya-v-prilozhenii
tags: [встроенное приложение, задания, очередь, синхронизация, лицензия, пользователь]
domain: Troubleshooting
type: Troubleshooting
audience: partner-engineer
product_versions: "4.x"
status: ready
related_components: [Встроенное приложение, ПринтМенеджер, Мониторинг]
related_pages:
  - kak-diagnostirovat-problemy-vstroennogo-prilozheniya
  - kak-diagnostirovat-problemy-pechati-po-etapam-puti-zadaniya
--->

### Симптомы

- Авторизация на МФУ прошла успешно.
- Экран очереди пуст — нет ни одного задания.
- Задания были отправлены с АРМ, но до МФУ не дошли.

---

### Диагностика

**Шаг 1. Проверить, есть ли задание в очереди ПринтМенеджер**

Панель администратора ПринтМенеджер → Администрирование → Очередь. Задание должно быть там.\
**Если задания нет** в ПринтМенеджер — проблема на стороне формирования задания или обработки задания в ПринтМенеджере. См. [Как диагностировать проблемы печати](https://wiki.printum.io/books/7-ustranenie-neispravnostei/page/kak-diagnostirovat-problemy-pecati-po-etapam).\
**Если задание есть** в ПринтМенеджер, но не отображается на МФУ — идём дальше.

**Шаг 2. Проверить, кому принадлежит задание**

Задание должно принадлежать тому же пользователю, под которым выполнена авторизация. Логин пользователя на АРМ и логин пользователя в Printum должны совпадать вплоть до регистра. Более подробно см. [Задание отправлено но не появилось на сервере](https://wiki.printum.io/books/7-ustranenie-neispravnostei/page/zadanie-otpravleno-no-ne-poiavilos-na-servere)

**Шаг 3. Проверить синхронизацию Мониторинг–ПринтМенеджер**

Настройки пользователя (в том числе привязка карты, PIN-код) передаются из М в ПринтМенеджер при синхронизации. Если пользователь был добавлен или изменён недавно — синхронизация могла не выполниться.

Запустить синхронизацию вручную: Личный кабинет → Настройка → Интеграции → ПМ → «Синхронизировать».

**Шаг 4. Проверить лицензии устройства**

Личный кабинет → Управление → Устройства → колонка «Лицензии». Должны быть активны M, PM, EMB.

**Шаг 5. Проверить правила печати**

Если у пользователя есть правило «Запретить печать» или «Запретить авторизацию в приложении» — задания будут заблокированы.

Личный кабинет → Управление → Пользователи → карточка пользователя → Принтеры и правила.

---

### Решение

По результатам диагностики:

- Нет задания в ПринтМенеджер → диагностировать путь задания от АРМ.
- Задание принадлежит другому пользователю → проверить УЗ на АРМ и в Printum.
- Не прошла синхронизация → запустить вручную.
- Нет лицензии EMB → активировать.
- Правило запрещает → изменить правило или проконсультировать пользователя.

---

### Как проверить результат

Отправить тестовое задание от пользователя. Авторизоваться на МФУ — задание отображается и уходит на печать.

---

### Когда эскалировать

- Задание есть в ПринтМенеджер, принадлежит правильному пользователю, лицензии активны, правил нет — задание не отображается.
- После синхронизации ситуация не изменилась.

Приложить к заявке: вендор, модель МФУ, версии Мониторинга и ПринтМенеджера, логи системы Printum, скриншот карточки задания в ПринтМенеджер.

---

### Связанные страницы

- [Встроенное приложение — диагностика проблем](https://wiki.printum.io/books/7-ustranenie-neispravnostei/page/vstroennoe-prilozenie-diagnostika-problem)
- [Как диагностировать проблемы печати по этапам пути задания](https://wiki.printum.io/books/7-ustranenie-neispravnostei/page/kak-diagnostirovat-problemy-pecati-po-etapam)