# Обзор платформы Plaia Plaia (app.plaia.ru) — платформа перевода для языковых сервисов, компаний и команд: она объединяет управление проектами, CAT-редактор, переводческие памяти и глоссарии, машинный перевод и расчёты с исполнителями в одном рабочем пространстве. ## Ключевые возможности - **Проекты и workflow** — загрузка файлов, настройка этапов перевода (например, перевод → ревью → финальная вычитка), распределение работ между исполнителями и вендорами. - **CAT-редактор** — сегментный редактор с совпадениями TM, машинным переводом, глоссарием, комментариями и контролем качества. - **Лингвистические активы** — переводческие памяти (Translation Memories), глоссарии (Glossaries), TM Editor и глобальный поиск по всем активам. - **Машинный перевод** — подключение MT-движков и профилей умного перевода, учёт расхода Smartwords. - **Команда и клиенты** — участники с разными уровнями доступа, MyTeam, вендоры, клиенты с нет-рейтами. - **Платежи** — счета, платежи исполнителям и клиентам, баланс аккаунта. - **API** — интеграционный REST API, полный аналог интерфейса. ## Разделы интерфейса Левое меню рабочего пространства: | Раздел | Назначение | | --- | --- | | **Projects** | Список проектов: создание, фильтры, архив | | **Linguistic assets** | Glossaries, Translation Memories, Global Search, TM Editor | | **Team** | Участники аккаунта | | **Clients** | Клиенты и их настройки | | **Payments** | Supplier payments, Invoices, Client payments, Balance, настройки биллинга | | **Productivity services** | Баланс Smartwords для TM и машинного перевода | | **Reports** | Отчёты по работам и оплатам | | **Settings** | Настройки аккаунта: уведомления, плейсхолдеры, API-ключи, форматы файлов и другое | ## Кто работает с платформой - **Менеджеры (LSP/PM)** — создают проекты, управляют этапами, назначают исполнителей, контролируют сроки и бюджеты. - **Лингвисты и ревьюеры** — работают в CAT-редакторе над назначенными им задачами. - **Клиенты** — получают квоты и результаты, отслеживают статус заказов. - **Разработчики** — интегрируют платформу с внешними системами через REST API. Дальше: [Первый проект: за пять минут](/article/first-project) или [Словарь терминов](/article/glossary-of-terms). --- # Словарь терминов платформы **Проект (Project)** — единица работы в платформе: содержит исходные файлы, целевые языки, настройки и этапы перевода. **Документ (Document)** — файл внутри проекта. Разбивается на сегменты при загрузке. **Сегмент (Segment)** — минимальная единица перевода в редакторе: обычно одно предложение или его часть. **Workflow (этапы перевода)** — последовательность стадий обработки документа: например, 1) Translation, 2) Editor review, 3) Final review. У каждого этапа свои исполнители и статус. **Translation Memory (TM, переводческая память)** — база ранее выполненных переводов. При совпадении исходного сегмента с сохранённым TM предлагает готовый перевод: 100% (context match), 100%, fuzzy (частичное совпадение). **Glossary (глоссарий)** — словарь утверждённых терминов и их переводов. Используется редактором и машинным переводом для единообразия терминологии. **Concordance (конкорданс)** — поиск по содержимому переводческих памятей. **Net rate (нет-рейт)** — процент от полной цены за совпадения TM: например, 100% совпадения считаются за 25% цены. **MT (Machine Translation)** — машинный перевод. Движки подключаются на уровне аккаунта и проекта; расход учитывается в Smartwords. **Smartwords** — условная единица объёма, списываемая за использование переводческих памятей и машинного перевода. Баланс виден в разделе **Productivity services**. **MyTeam** — раздел для управления штатными лингвистами и приглашения их на задачи. **Vendor (вендор)** — внешний подрядчик (компания или команда), которому можно назначать этапы проектов целиком. **Quote (квота)** — расчёт стоимости проекта для клиента, который можно отправить на согласование. **Callback (вебхук)** — уведомление платформы о событиях (изменение статуса, экспорт и т.д.), отправляемое на ваш URL. **XLIFF / TMX** — стандартные форматы обмена: XLIFF — для переводов, TMX — для импорта/экспорта переводческих памятей. --- # Регистрация и вход ## Вход в платформу Рабочее пространство находится по адресу **app.plaia.ru**. Вход выполняется по логину (email) и паролю, выданным администратором аккаунта, либо через страницу регистрации на plaia.ru. Если у вас нет доступа: 1. Обратитесь к администратору вашего аккаунта — участника приглашают в разделе **Team**. 2. Для нового аккаунта компании напишите на support@plaia.ru. ## Проблемы со входом **Не приходит письмо подтверждения/приглашения** — проверьте папку «Спам»; добавьте адрес отправителя в белый список; убедитесь, что email указан без опечаток. Если письмо не приходит больше часа — напишите в поддержку. **Забыт пароль** — используйте восстановление пароля на странице входа. Письмо со ссылкой придёт на адрес, указанный при регистрации. **Аккаунт заблокирован** — после нескольких неудачных попыток входа может включиться временная блокировка: подождите 15–30 минут и попробуйте снова или восстановите пароль. ## Язык интерфейса Язык интерфейса переключается в правом нижнем углу рабочего пространства (значок **EN**). Доступны русский и английский. ## Два типа рабочих пространств - **Аккаунт заказчика (client account)** — работа с заказами, квотами и результатами. - **Аккаунт LSP/агентства** — полный доступ к проектам, команде, биллингу и настройкам. --- # Интерфейс платформы ## Левое меню Основная навигация по платформе — вертикальное меню слева: - **Projects** — список проектов с вкладками **Current** и **Archived**, кнопкой **Create project** и **Post as job**. - **Linguistic assets** — раскрывающийся раздел: **Glossaries**, **Translation Memories**, **Global Search**, **TM Editor**. - **Team** — участники аккаунта: **Team members**. - **Clients** — список клиентов. - **Payments** — раскрывающийся раздел: **Supplier payments**, **Invoices**, **Client payments**, **Balance**, **Settings** (реквизиты биллинга). - **Productivity services** — баланс Smartwords. - **Reports** — отчёты по работам и оплатам. - **Settings** — настройки аккаунта (см. раздел [Настройки аккаунта](/cat/settings)). ## Верхняя панель - Название текущего раздела и вкладки. - Справа — **баланс Smartwords** и значок языка интерфейса. - В списке проектов: переключатель **Current / Archived**, кнопки **Create project** и **Post as job**, фильтры по колонкам. ## Список проектов Колонки таблицы: **Name**, **Progress** (прогресс-бар), **Status** (Created, Pretranslated, In progress, Manager review и др.), **Created by**, **Source** (языковые пары), **Client**, **Vendor**, **Deadline**, **Cost**. - Фильтр включается значком воронки справа от заголовков. - Чекбоксами выделяются проекты для массовых действий (архивация, удаление). ## Быстрые ссылки - Внизу слева — логотип «Платформа перевода», значок справки (❓) и чат поддержки. - Ссылка support@plaia.ru — на почту поддержки. --- # Первый проект: за пять минут ## 1. Создайте проект В разделе **Projects** нажмите **Create project**. Откроется мастер из трёх шагов: **1. Files → 2. Settings → 3. Workflow stages**. ## 2. Загрузите файлы На шаге **Files** перетащите файлы в область загрузки или нажмите **Add** и выберите файлы на компьютере. Поддерживаются документы (docx, pdf, xlsx, pptx), локализационные форматы (json, xml, po, xliff, csv и др.), субтитры (srt, vtt) и другие — см. [Поддерживаемые форматы файлов](/article/supported-formats). Если файлов пока нет, нажмите **Skip** — файлы можно добавить позже. ## 3. Настройте языки и активы На шаге **Settings** задайте: - **Название проекта** — понятное имя, например «Инструкция v2 en→ru». - **Исходный язык** — язык оригинала. - **Целевые языки** — один или несколько языков перевода. - Переводческие памяти и глоссарии для проекта (если есть). - Машинный перевод (если нужно). ## 4. Настройте этапы На шаге **Workflow stages** выберите этапы перевода. Для быстрого старта достаточно одного этапа (перевод); добавляйте ревью, если нужен второй круг проверки. ## 5. Дождитесь претранслейта После создания проект получит статус **Pretranslated**: платформа посчитает статистику, применит TM и выполнит машинный перевод (если подключён). Прогресс виден в списке проектов. ## 6. Переводите и экспортируйте Откройте документ и работайте в CAT-редакторе (см. [Редактор переводов: обзор](/article/editor-overview)). Когда перевод готов, экспортируйте результат: кнопка экспорта на странице документа или через контекстное меню проекта — файл вернётся в исходном формате. --- # Языки и языковые пары ## Исходный и целевые языки Каждый проект имеет **один исходный язык** (язык исходных файлов) и один или несколько **целевых языков**. Для каждого целевого языка создаётся свой набор документов и своя статистика. ## Диалекты и локали Платформа различает региональные варианты: например, `en-US` и `en-GB` или `zh-Hans` и `zh-Hant`. Выбирайте локаль, которая нужна клиенту, — совпадения TM и MT подбираются с учётом выбранного языка. Если конкретный вариант не важен, используйте базовый код (`ru`, `en`, `de`). ## Добавление языка в проект В карточке проекта доступно добавление целевого языка: файлы будут разбиты заново под новый язык, статистика посчитается отдельно. Также язык добавляется через API-метод `/api/integration/v1/project/language`. ## Языковая пара и цены Цены услуг и нет-рейты привязываются к языковым парам (см. [Как считается стоимость перевода](/article/pricing-model)). Убедитесь, что для нужной пары заданы цены исполнителей, чтобы расчёты и платежи формировались корректно. ## Изменить исходный язык Исходный язык задаётся при создании проекта. Если он был выбран неверно, проще создать проект заново: смена исходного языка «на лету» не поддерживается, так как сегментация и совпадения TM привязаны к исходному языку. --- # Роли пользователей ## Роли в аккаунте | Роль | Основные права | | --- | --- | | **Account owner / Администратор** | Полный доступ: настройки, биллинг, API-ключи, все проекты | | **Менеджер (PM)** | Создание и ведение проектов, назначение исполнителей, экспорт, статистика | | **Лингвист** | Работа в редакторе только с назначенными документами | | **Ревьюер** | Редактирование и финальное подтверждение сегментов на этапе ревью | | **Типограф (DTP)** | Работа с вёрсткой и файлами без доступа к текстам других этапов | | **Клиент** | Доступ к квотам и результатам своих заказов | ## Управление ролями Точные уровни доступа настраиваются администратором в **Settings → User access levels** (см. [Уровни доступа](/article/access-levels)). Роль назначается при приглашении участника и может быть изменена позже в карточке участника **Team**. ## Принципы - Лингвист видит только те документы, на которые назначен. - Менеджер проекта назначается на конкретный проект в разделе менеджеров проекта. - Настройки аккаунта и биллинг доступны только административным ролям. Если пользователю не хватает прав для действия — обратитесь к администратору аккаунта (см. также [FAQ: нет доступа к разделу](/article/faq-access)). --- # Что такое Smartwords **Smartwords** — условные «умные слова», которые списываются за использование платных сервисов перевода: переводческих памятей и машинного перевода. Баланс отображается в правом верхнем углу платформы и в разделе **Productivity services**. ## Что списывается - **Машинный перевод** — за каждое слово, переведённое MT-движком в претранслейте или редакторе. - **Переводческие памяти (TM)** — за использование платных функций памяти (проприетарная TM-инфраструктура). Функции, не требующие Smartwords, работают без списаний. ## Что не списывается - Загрузка и сегментация файлов. - Ручной перевод в редакторе без MT. - Экспорт документов. - Работа с глоссариями. ## Где смотреть и пополнять Раздел **Productivity services** показывает карточку **Smartwords**: текущий **Balance** и кнопку покупки дополнительных слов. Пополнение доступно через поддержку или биллинг — см. [Smartwords: баланс и пополнение](/article/smartwords). Если баланс исчерпан, машинный перевод и платные функции TM приостанавливаются до пополнения; ручной перевод и экспорт продолжают работать. ## Экономия Smartwords - Подключайте MT только к тем проектам, где он действительно нужен. - Используйте TM: совпадения 100% и fuzzy уменьшают объём машинного перевода. - Настройте [профили умного перевода](/article/smart-translation-profiles), чтобы MT применялся только к подходящим сегментам. --- # Как связаться с поддержкой ## Каналы - **Почта:** support@plaia.ru — основной канал, письма регистрируются в системе поддержки. - **Чат поддержки** — значок чата в левом нижнем углу платформы. - **MCP-ассистент справки** — если вы работаете с AI-ассистентом, он может ответить по контенту справки: см. [MCP-эндпоинт хэлпцентра](/article/mcp-endpoint). ## Что указать в обращении 1. **Аккаунт** — название аккаунта или URL (app.plaia.ru). 2. **Что делали** — последовательность действий или сценарий. 3. **Что ожидали и что произошло** — расхождение с ожидаемым поведением. 4. **Детали** — название проекта/документа, языковая пара, время события, скриншоты. 5. **Для проблем с API** — accountId, метод (путь), код ответа, тело запроса и `requestId` из заголовка ответа. ## Время ответа Поддержка отвечает в рабочие часы. Для инцидентов, блокирующих работу (нельзя экспортировать проект, не грузятся файлы), укажите срочность в теме письма — такие обращения берутся в работу в первую очередь. См. также: [Как правильно обратиться в поддержку](/article/faq-contact-support). --- # Создание проекта ## Шаг 1. Files В разделе **Projects** нажмите **Create project**: - Перетащите файлы в круг загрузки или нажмите **Add**. Можно загрузить несколько файлов одного формата или разных. - Если файлов пока нет — **Skip**: файлы добавляются позже на странице проекта (или через API). - Под формой есть быстрые пресеты для автоматической локализации приложений: **iOS**, **Android**, **HTML5**, **Other**. Файлы автоматически распределяются по папкам и переименовываются, если включены соответствующие правила. ## Шаг 2. Settings - **Name** — название проекта (видно всем участникам; используйте осмысленные имена с датой или версией). - **Source language** — исходный язык. - **Target languages** — целевые языки (несколько — по одному набору документов на каждый). - **Assign to** — выбор исполнителей/вендоров (можно оставить на потом). - Подключение TM, глоссариев и MT-движка, если активы уже созданы. ## Шаг 3. Workflow stages Соберите цепочку этапов: **Translation**, **Editor review**, **Final review** и другие. Для каждого этапа задаётся исполнитель (команда, вендор, конкретный лингвист). Один этап — минимальный workflow. ## После создания Проект появляется в списке **Projects** со статусом **Created**, затем переходит в **Pretranslated** — платформа сегментирует файлы, считает статистику, применяет TM и выполняет машинный перевод. Прогресс отражается в колонке **Progress**. Создание проекта через API: см. [Проекты через API](/article/api-projects). --- # Загрузка файлов для перевода ## При создании проекта Файлы загружаются на шаге **Files** мастера создания проекта: drag-and-drop в область загрузки или кнопка **Add**. Мультизагрузка поддерживается — загрузите сразу все документы на все целевые языки. ## В существующий проект - Откройте проект и добавьте документ через страницу документов проекта (кнопка добавления файла). - Через API: `/api/integration/v1/project/document` (см. [Документы через API](/article/api-documents)). ## Правила именования и папки Файлы можно группировать в папки — в списке проекта документы отображаются в древовидном виде (значок папки слева от имени). Это удобно для многофайловых заказов (например, chapters/chapter-01.docx). Переименование документа: **Document → Rename** на странице документа или через API `/api/integration/v1/document/rename`. ## Что происходит после загрузки 1. Платформа распознаёт формат и разбирает файл на сегменты. 2. Считается статистика (слова, совпадения TM, MT-слова). 3. Применяются совпадения TM и машинный перевод (если подключены) — статус проекта меняется на **Pretranslated**. ## Ограничения - Разбитые на сегменты файлы нельзя перезагрузить «поверх» без потери переводов — для замены содержимого см. [Обновление документа](/article/faq-file-upload). - Пароль-защищённые документы разблокируйте заранее. --- # Поддерживаемые форматы файлов ## Офисные документы - Microsoft Word: `.docx` (`.doc` — конвертируйте в docx) - Microsoft Excel: `.xlsx` (текст из ячеек) - Microsoft PowerPoint: `.pptx` - PDF: `.pdf` (разбирается с распознаванием; для сложной вёрстки возможны ограничения) - OpenOffice/LibreOffice: `.odt`, `.ods`, `.odp` - RTF, TXT, Markdown ## Локализационные форматы - JSON (включая вложенные структуры и arrays), XML/XHTML/HTML5 - gettext: `.po`, `.pot` - XLIFF 1.2 / 2.0 - CSV/TSV (с настройкой колонок) - iOS: `.strings`, `.stringsdict`; Android: `.xml` (strings) - YAML (включая Rails-структуры), INI, PROPERTIES - SRT/VTT-подобные ключевые форматы для приложений (`.arb` и др. — уточняйте в поддержке) ## Субтитры и видео-текст - SubRip: `.srt`, WebVTT: `.vtt`, SAMI: `.smi`, `.sub` ## Вёрстка и графика - InDesign: `.idml` - XML на основе стандартов (DITA и др.) ## Двусторонний формат платформы XLIFF — основной формат обмена: экспортируйте документ в XLIFF, переведите в стороннем инструменте и импортируйте обратно методом `/api/integration/v1/document/translateWithXliff`. ## Проверка перед загрузкой Форматы и правила разбора настраиваются в **Settings → File formats** (см. [Форматы файлов и правила разбора](/article/file-formats)). Если формат не распознан или текст «рассыпался» на сегменты неправильно — создайте пресет разбора или обратитесь в поддержку. --- # Настройки проекта ## Где находятся Откройте проект из списка **Projects** — на странице проекта доступно редактирование параметров. Многие настройки меняются и через API (`PUT /api/integration/v1/project/{projectId}`). ## Основные параметры - **Название** — меняется в любой момент. - **Deadline** — срок проекта, отображается в списке проектов (колонка **Deadline**). - **Client** — привязка клиента: проект попадёт в его заказы, а стоимость — в квоты и счета (см. [Клиенты](/article/clients-overview)). - **Vendor** — внешний подрядчик для этапов проекта. - **Managers** — менеджеры проекта: добавляются/удаляются на странице проекта (см. также `/api/integration/v1/project/{projectId}/managers`). ## Лингвистические активы - **Translation Memories** — набор TM проекта; по умолчанию один набор для всех целевых языков, можно разделить по языкам (см. [Подключение TM к проекту](/article/tm-in-project)). - **Glossaries** — подключённые глоссарии (см. [Подключение глоссария к проекту](/article/glossary-in-project)). - **MT configuration** — MT-движок/профиль проекта (см. [Подключение MT к проекту](/article/mt-in-project)). ## Кастомные поля Если администратор создал кастомные поля в **Settings → Custom fields**, они отображаются в карточке проекта: удобно для внутренних ID CRM, типов заказов и т.п. (см. [Кастомные поля](/article/custom-fields)). ## Управление состоянием - **Cancel project** — отмена проекта (статус Cancelled). - **Restore** — восстановление отменённого проекта. - **Complete** — завершение workflow всех документов проекта. - **Archive** — архивация из списка проектов (вкладка **Archived**). --- # Этапы перевода (workflow) ## Что такое этап **Workflow** — последовательность стадий обработки документа. Типовая цепочка: 1. **Translation** — первичный перевод (лингвист или MT + постредактирование). 2. **Editor review** — редактирование и проверка терминологии. 3. **Final review** — финальная вычитка перед сдачей. Этапы настраиваются на шаге **Workflow stages** мастера создания проекта и могут корректироваться в существующем проекте, пока документы не прошли соответствующую стадию. ## Исполнители этапов Для каждого этапа назначается исполнитель: - **Конкретный участник команды** — из **Team members**. - **Вендор** — внешний подрядчик целиком берёт этап на себя (см. [Работа с вендорами в проекте](/article/assign-vendors)). - **Автоназначение** — документы/сегменты автоматически распределяются по текущим лингвистам (метод `POST /api/integration/v1/project/{projectId}/assign`). Количество единиц на этап (например, сколько слов отдать на перевод) задаётся на уровне документа — метод `setStageUnitCount`. ## Статусы этапов Документ проходит статусы по мере продвижения: **Pretranslated → In progress → Manager review → Completed** (см. [Статусы проекта и документов](/article/project-statuses)). Этап с выполненными задачами помечается как завершённый, и документ переходит на следующий. ## Изменение workflow - Добавить этап можно до начала работ на следующей стадии. - Удалить/перестроить этапы после начала работы рискованно: подтверждённые сегменты перераспределяются. Для сложных случаев напишите в поддержку. --- # Статусы проекта и документов ## Статусы проекта | Статус | Значение | | --- | --- | | **Created** | Проект создан, файлы ещё разбираются | | **Pretranslated** | Сегментация и претранслейт (TM/MT) завершены; работы не начаты или только начаты | | **In progress** | Идёт активная работа над документами | | **Manager review** | Документы на проверке менеджера (этап Manager review) | | **Completed** | Все документы завершены (workflow пройден) | | **Cancelled** | Проект отменён (можно восстановить) | ## Статусы документов Документы проходят те же стадии по этапам workflow. Прогресс-бар в списке проектов показывает долю подтверждённых сегментов. ## Как продвигать статусы - Документ автоматически переходит между этапами, когда исполнители подтверждают сегменты и завершают задачи. - Принудительно завершить документ: **Document → Complete** (или API `POST /api/integration/v1/document/complete`). - Завершить весь проект: **Project → Complete** (API `POST /api/integration/v1/project/complete`). ## Почему проект «застрял» в Pretranslated - Файл ещё сегментируется (большие PDF/IDML могут обрабатываться долго). - Не назначен исполнитель на первый этап, и Prettranslated ждёт начала работ. - Претранслейт TM/MT не может завершиться (проверьте [MT-движки](/article/mt-engines) и баланс Smartwords). Если статус не меняется дольше ожидаемого — см. [FAQ: экспорт завис или отдаёт ошибку](/article/faq-export-stuck) и напишите в поддержку. --- # Назначение исполнителей ## Способы назначения 1. **Вручную на проект** — на странице проекта выберите документ и укажите исполнителя для этапа. 2. **Из команды (MyTeam)** — отправка приглашений штатным лингвистам: первый принявший задачу берёт её на себя (см. [MyTeam](/article/myteam)). 3. **Автоматически** — автоназначение новых документов/сегментов текущим лингвистам проекта (см. ниже). ## Распределение сегментов между несколькими лингвистами Метод `POST /api/integration/v1/document/assignFreelancers` делит документ на равные блоки по количеству слов и назначает по одному блоку каждому указанному исполнителю — удобно для больших объёмов. Модель назначения и распределения сегментов задаётся методом `POST /api/integration/v1/document/assign`: можно указать, кто переводит, а кто ревьюит. ## Снятие назначения `POST /api/integration/v1/document/unassign` снимает исполнителя с документа (в интерфейсе — то же действие в карточке назначения). Сегменты возвращаются в пул нераспределённых. ## Рекомендации - Назначайте с учётом специализации участника (услуги профиля: технический перевод, маркетинг и т.д.). - Для вендоров используйте отдельный механизм: [Работа с вендорами в проекте](/article/assign-vendors). - Контролируйте нагрузку: статистика проекта показывает объёмы по исполнителям (см. [Статистика проекта](/article/project-statistics)). --- # Работа с вендорами в проекте ## Кто такие вендоры **Vendor** — внешний подрядчик (другое агентство или команда), которому можно передавать этапы проектов. Список вендоров аккаунта: `/api/integration/v1/vendor/list`. ## Назначение вендора - В интерфейсе: на странице документа выберите этап workflow и укажите вендора вместо внутреннего исполнителя. - Через API: `POST /api/integration/v1/document/assignVendors` — назначает вендора на этап workflow документа. Для квоты вендора по проекту используется метод `/api/integration/v1/Quote/ByVendor/{projectId}`. ## Как это выглядит у вендора Вендор работает со своими проектами в собственном рабочем пространстве и назначает внутренних исполнителей сам. Вам доступны агрегированные статусы и прогресс этапа. ## Оплата Работа вендора оплачивается по его ценам (см. [Как считается стоимость перевода](/article/pricing-model)). Платежи фиксируются в **Payments → Supplier payments**. ## Рекомендации - Чётко фиксируйте сроки (deadline проекта) и объёмы (setStageUnitCount). - Передавайте вендору TM и глоссарии проекта, если требуется единообразие. - Для критичных заказов добавляйте внутренний этап ревью после вендорского. --- # Размещение задачи на бирже (Post as job) ## Что делает Post as job Кнопка **Post as job** в списке проектов публикует задачу (проект или отдельные документы) на биржу переводов — исполнители из внешнего пула могут откликнуться и взять работу. ## Когда использовать - Нет свободных внутренних исполнителей, а сроки поджимают. - Разовый заказ на редкую языковую пару или специализацию. - Хотите сравнить отклики и цены нескольких фрилансеров. ## Как это работает 1. Выберите проект в списке и нажмите **Post as job** (или используйте метод создания job — задачи проекта доступны через API `/api/integration/v3/job/verifiedForProject`). 2. Опубликуйте задачу: исполнители видят объём, языковую пару, срок и цену. 3. Первый принявший (или выбранный из откликов) исполнитель берёт задачу и работает в редакторе. ## Контроль - Прогресс задачи виден в проекте как обычный этап перевода. - Оплата исполнителю формируется автоматически после подтверждения задачи — см. [Оплата исполнителей](/article/supplier-payments). ## Альтернатива Если хотите делить документ между несколькими фрилансерами поровну по словам — используйте назначение блоков: см. [Назначение исполнителей](/article/assign-linguists). --- # Список проектов: фильтры и массовые действия ## Вкладки - **Current** — активные проекты. - **Archived** — архивные проекты (не отображаются в основной работе, но доступны для чтения и экспорта). ## Фильтры Значок фильтра справа от заголовков таблицы открывает панель фильтрации по колонкам: - **Name** — поиск по названию; - **Status** — Created / Pretranslated / In progress / Manager review и др.; - **Created by** — автор проекта; - **Source** — языковая пара; - **Client**, **Vendor** — заказчик и подрядчик; - **Deadline** — срок (просроченные подсвечиваются); - **Cost** — стоимость. ## Массовые действия Выделите чекбоксы нескольких проектов, затем: - **Архивировать** — убрать из активных (см. [Архивация и восстановление проектов](/article/archive-restore)); - **Экспортировать** — выгрузка результатов; - **Удалить** — безвозвратное удаление (внимательно: восстановление невозможно). ## Колонки Name · Progress · Status · Created by · Source (языковые пары) · Client · Vendor · Deadline · Cost. Ширина колонок настраивается перетаскиванием. --- # Группы проектов ## Зачем нужны группы **Группы проектов** помогают структурировать список заказов: по клиентам, продуктам, типам контента (маркетинг, документация, софт) или годам. Группы управляются в **Settings → Project groups** и создаются администратором аккаунта (см. также справочник отраслей клиентов — [Справочники](/article/directory)). ## Как использовать 1. Создайте группу в **Settings → Project groups** (например, «Продукт X — локализация»). 2. Привяжите проекты к группе в настройках проекта. 3. Фильтруйте список проектов по группе — удобно для отчётности по направлению. ## Группа и клиент — в чём разница - **Client** — юридический заказчик: влияет на квоты, счета, нет-рейты. - **Группа проектов** — внутренняя классификация: ни на что в биллинге не влияет, служит только для навигации и отчётов. Комбинация «клиент + группы» покрывает большинство схем: клиенту — свои квоты и рейт, группе — свои проекты по продуктам. См. также: [Настройки аккаунта: обзор](/article/settings-overview). --- # Статистика проекта ## Где смотреть - **Колонка Progress** в списке проектов — доля подтверждённых сегментов. - **Статистика проекта** на странице проекта — детальный разбор по документам и языкам. - Отчёты по завершённым работам — в **Reports** (см. также API `/api/integration/v1/project/{projectId}/completedWorkStatistics`). ## Что входит в статистику - **Слова (words)** — исходный объём по каждому документу. - **Совпадения TM** — 100% (context match), 100%, fuzzy — по уровням. - **MT-слова** — объём, переведённый машинным переводом. - **Подтверждённые сегменты** — прогресс по этапам workflow. Статистика по документу: `GET /api/integration/v1/document/statistics`; по проекту: `GET /api/integration/v2/project/{projectId}/statistics`. ## Пересчёт статистики Если статистика выглядит неактуально (после массового импорта TM, замены файлов), запустите пересчёт: `POST /api/integration/v1/project/{projectId}/statistics/build` или в интерфейсе на странице проекта. ## Статистика подтверждения сегментов Скорость подтверждения сегментов (продуктивность команды) — `GET /api/integration/v1/segment-confirmation-statistics/{projectId}`: полезно для оценки темпа работ и планирования дедлайнов. --- # Экспорт результатов перевода ## Экспорт одного документа Откройте документ и нажмите экспорт — файл соберётся с переводами и вернётся в исходном формате (docx → docx, json → json и т.д.). ## Экспорт нескольких документов - В интерфейсе: на странице проекта выберите документы и запросите экспорт. - Через API: `POST /api/integration/v1/document/export` создаёт задачу экспорта; `GET /api/integration/v1/document/export/{taskId}` отдаёт готовый файл. Экспорт — асинхронная операция: сначала создаётся задача (taskId), затем по её готовности скачивается архив/файл. Статус задачи проверяйте повторными запросами. ## XLIFF и обмен с внешними инструментами Если перевод делается вне платформы: экспортируйте XLIFF, переведите, верните через `PUT /api/integration/v1/document/translateWithXliff` или `PUT /api/integration/v1/document/translate` (перевод из файла формата перевода). См. [Документы через API](/article/api-documents). ## Что выгружается - Переводы сегментов (подтверждённые и неподтверждённые — по настройке экспорта). - Комментарии и статусы — если формат поддерживает (например, XLIFF). - Вёрстка исходного документа сохраняется. ## Проблемы Экспорт «висит» или отдаёт ошибку — см. [FAQ: экспорт завис или отдаёт ошибку](/article/faq-export-stuck). --- # Архивация и восстановление проектов ## Архивация Выделите проект(-ы) в списке **Projects → Current** и выберите архивацию. Проект перемещается во вкладку **Archived**: он исключается из активной работы, но остаётся доступным для просмотра, статистики и экспорта. ## Что происходит с проектом в архиве - Участники не могут редактировать документы. - TM и глоссарии проекта остаются на месте (активы — отдельные сущности). - Прогресс и статистика сохраняются. ## Восстановление Откройте вкладку **Archived**, выберите проект и восстановите его — проект вернётся в **Current** с прежним статусом. Альтернативы через API: `POST /api/integration/v1/project/restore` восстанавливает отменённый проект; `POST /api/integration/v1/project/cancel` отменяет проект (статус Cancelled). ## Удаление Удаление проекта (`DELETE /api/integration/v1/project/{projectId}` или массовое удаление в списке) необратимо: вместе с проектом теряется его статистика и связи. Если данные нужны «на всякий случай» — перед удалением сделайте [резервную копию проекта](/article/project-backups). ## Архивация vs Cancel vs Archive - **Архивация** — «прочитал, спрятал»: для завершённых заказов. - **Cancel** — «работа остановлена»: заказ отменён до завершения. - **Удаление** — только для ошибочных/тестовых проектов. --- # Резервные копии проектов ## Когда нужны бэкапы - Перед рискованными операциями (замена файлов, массовый импорт переводов). - Перед удалением проекта. - Для переноса проекта между аккаунтами. ## Как создать копию Создание бэкапа — асинхронная задача: 1. Запустите задачу: `POST /api/integration/v1/backup/project/{projectId}`. 2. Дождитесь готовности: `GET /api/integration/v1/backup/project/tasks/create`. 3. Скачайте файл: `GET /api/integration/v1/backup/project/tasks/create/{taskId}/download`. Задачу можно отменить: `DELETE /api/integration/v1/backup/project/tasks/create/{taskId}`. ## Что внутри бэкапа Архив содержит документы проекта, переводы сегментов, настройки проекта и подключения активов. TM и глоссарии как отдельные сущности не переносятся — их экспортируйте отдельно (TMX для TM, см. [Импорт и экспорт TMX](/article/tm-import-export)). ## Восстановление из бэкапа 1. Загрузите файл бэкапа: `POST /api/integration/v1/backup/project/upload`. 2. Отследите задачу восстановления: `GET /api/integration/v1/backup/project/tasks/restore`. 3. Отмена: `DELETE /api/integration/v1/backup/project/tasks/restore/{taskId}`. Восстановление создаёт проект заново с сохранённым содержимым. Если восстановление нужно в другой аккаунт — обратитесь в поддержку: support@plaia.ru. --- # Редактор переводов: обзор ## Как открыть редактор Откройте проект → выберите документ и целевой язык → откроется таблица сегментов. Редактор доступен исполнителям, назначенным на документ, и менеджерам аккаунта. ## Устройство редактора - **Таблица сегментов**: слева исходный сегмент, справа — перевод; статусы сегментов (не начат, переведён, подтверждён). - **Панель ресурсов** (справа/снизу): совпадения **TM**, машинный перевод (**MT**), термины **глоссария**, конкорданс. - **Панель инструментов**: фильтры, поиск, отображение тегов, комментарии. - **Контекст документа** — смежные сегменты видны, чтобы переводить с учётом контекста. ## Базовый цикл работы 1. Выберите сегмент — платформа подставит лучшее совпадение TM или перевод MT. 2. Отредактируйте перевод. 3. Подтвердите сегмент (Ctrl+Enter / значок подтверждения) — он сохранится в TM проекта (если TM подключена на запись). 4. Повторите для всех сегментов; прогресс-бар отражает долю подтверждённых. ## Важные возможности - **Совпадения TM** и их ранжирование (см. [Совпадения TM в редакторе](/article/tm-matches)). - **MT-предложения** и постредактирование (см. [Машинный перевод в редакторе](/article/mt-suggestions)). - **Глоссарий** — подсветка терминов в исходнике (см. [Глоссарий в редакторе](/article/glossary-in-editor)). - **Конкорданс** — поиск по памятям (см. [Поиск по конкордансу](/article/concordance)). - **Фильтры** — показывать только непереведённые/с ошибками и т.д. (см. [Фильтрация сегментов](/article/filters)). - **Комментарии** — переписка по сегментам (см. [Комментарии к сегментам](/article/comments)). - **Ревью и LQA** — оценка качества (см. [Ревью и контроль качества](/article/review-lqa)). ## Горячие клавиши Полный список — в статье [Горячие клавиши](/article/hotkeys); главная — **Ctrl+Enter** (подтвердить сегмент и перейти к следующему). --- # Сегменты: подтверждение и статусы ## Статусы сегментов | Статус | Значение | | --- | --- | | **Не переведён** | Перевод пуст | | **Переведён** | Есть перевод, не подтверждён | | **Подтверждён** | Перевод подтверждён исполнителем | | **Заблокирован / locked** | Сегмент изменять нельзя (например, защищённый) | ## Подтверждение - Клавиши **Ctrl+Enter** — подтвердить текущий и перейти к следующему. - Значок подтверждения в строке сегмента. - Снятие подтверждения — повторное нажатие или команда «снять статус». ## Что происходит при подтверждении 1. Перевод сохраняется в документе. 2. Если к проекту подключена **пишущая TM**, пара «исходник → перевод» попадает в память (см. [Как считаются совпадения TM](/article/tm-matching)). 3. Прогресс документа обновляется; когда все сегменты этапа подтверждены, документ готов к переходу на следующий этап. ## Объединение и разбиение сегментов Сегменты можно объединять (join) и разбивать (split) — команды в контекстном меню сегмента или горячими клавишами. Разбиение доступно там, где формат позволяет: HTML и «жёсткие» форматы ограничивают свободу разбиения. ## Замечания - Подтверждённые сегменты ревьюер может редактировать на этапе ревью — тогда статус обновится ревью-отметкой. - Не подтверждённые сегменты при экспорте выгружаются с текущими переводами (по настройкам экспорта) — проверяйте перед сдачей. --- # Совпадения TM в редакторе ## Что такое совпадение Когда вы открываете сегмент, платформа ищет в подключённых TM похожие ранее переведённые сегменты. Степень похожести — **match**: | Совпадение | Описание | | --- | --- | | **Context match (CM)** | 100% совпадение + совпадает окружение (предыдущий и следующий сегменты) | | **100%** | Исходный сегмент совпадает дословно | | **Fuzzy (50–99%)** | Частичное совпадение, например «99%» или «75%» | | **No match** | Совпадений нет — предлагается MT | ## Как использовать совпадение - Лучшее совпадение подставляется в поле перевода автоматически. - Панель TM показывает все альтернативы — клик по совпадению вставляет его в перевод. - Изменённое совпадение отредактируйте и подтвердите — обновлённый перевод сохранится в TM. ## Откуда берутся совпадения - TM, подключённые к проекту (см. [Подключение TM к проекту](/article/tm-in-project)). - Подтверждённые сегменты текущего документа (внутрипроектная память). ## Управление совпадениями - Ранжирование учитывает статус подтверждения и свежесть перевода. - Совпадения ниже порога (например, <50%) не подставляются. - Для точного контроля порогов используйте настройки разбора/претранслейта проекта. ## Совпадения и цена Нет-рейт клиента привязан к уровням совпадений: 100% и fuzzy считаются по скидке (см. [Нет-рейты](/article/net-rates)). Так платформа считает справедливую стоимость работ. --- # Машинный перевод в редакторе ## Как работает MT в редакторе Если к проекту подключён MT-движок, для сегментов без достаточного совпадения TM платформа запрашивает машинный перевод и показывает его в панели MT (или сразу подставляет в претранслейте). ## Постредактирование (MTPE) 1. Возьмите MT-перевод как черновик. 2. Исправьте ошибки, выровняйте стиль, проверьте термины по глоссарию. 3. Подтвердите сегмент — постредактированный перевод сохраняется в TM. Экономия Smartwords: сегменты, покрытые TM, MT не обрабатываются (см. [Что такое Smartwords](/article/smartwords-intro)). ## Повторная генерация Если MT-перевод плохой, можно запросить повторный перевод сегмента (команда в панели MT) — платформа повторно обратится к движку. Каждый запрос списывает Smartwords за слова сегмента. ## Сменить движок для сегмента Движок задаётся на уровне проекта ([Подключение MT к проекту](/article/mt-in-project)). Быстро «перевести сегмент другим движком» в редакторе нельзя — движок меняется для проекта целиком. ## Качество MT - Настраивайте [профили умного перевода](/article/smart-translation-profiles) — они подбирают движок и параметры под тип контента. - Проверяйте термины: MT может не знать ваших утверждённых терминов — подключённый глоссарий подсвечивает отклонения. - Типовые проблемы и решения — в статье [Как улучшить качество машинного перевода](/article/ai-translation-tips). --- # Глоссарий в редакторе ## Что делает глоссарий в редакторе Термины подключённых глоссариев подсвечиваются в исходном сегменте. Для каждого термина показывается утверждённый перевод — один клик вставляет его в поле перевода. ## Работа с терминами 1. Откройте сегмент — термины подсвечены. 2. Кликните по подсветке — откроется карточка термина (исходный термин, перевод, часть речи, примечание). 3. Вставьте утверждённый перевод кнопкой или наберите вручную. ## Отклонения от глоссария Если перевод сегмента не содержит утверждённого термина, платформа помечает потенциальное отклонение — ревьюер на этапе проверки увидит подсказку. Обязательность терминов зависит от настроек глоссария (см. [Создание глоссария и добавление терминов](/article/glossary-create)). ## MT и глоссарий Машинный перевод с подключённым глоссарием старается использовать утверждённые термины — но MT-черновик всё равно нужно проверять: терминология — ключевая зона постредактирования. ## Не видите подсветку терминов? - Проверьте, подключён ли глоссарий к проекту ([Подключение глоссария к проекту](/article/glossary-in-project)). - Проверьте совпадение морфологии: точные формы термина подсвечиваются надёжнее. - Добавьте недостающие термины в глоссарий — они сразу начнут подсвечиваться. --- # Поиск по конкордансу ## Зачем нужен конкорданс Конкорданс — поиск по содержимому подключённых переводческих памятей. Он помогает найти, как раньше переводились конкретные слова, фразы и обороты, даже если полного совпадения сегмента нет. ## Как искать 1. Выделите слово/фразу в исходном сегменте или введите запрос в панель конкорданса. 2. Платформа покажет найденные пары «исходник → перевод» с указанием процента совпадения и TM-источника. 3. Клик по результату вставляет перевод в поле редактирования. ## Синтаксис и подсказки - Поиск ведётся и по исходному, и по переводу (в зависимости от настроек панели). - Короткие запросы (1–2 слова) дают больше шума — уточняйте фразой. - Результаты зависят от подключённых к проекту TM. ## Вне проекта Памяти всего аккаунта searchable из **Linguistic assets → Global Search** (см. [Глобальный поиск по активам](/article/global-search)) — там же ищутся термины глоссариев. ## Программный доступ Получить совпадения из конкретной TM: `POST /api/integration/v1/translationmemory/matches` (см. [TM и глоссарии через API](/article/api-tm-glossaries)). --- # Теги и плейсхолдеры ## Что такое теги При разборе файлов платформа выносит элементы форматирования (жирный, курсив, ссылки, переносы) и служебные конструкции в **теги** — они отображаются значками внутри сегмента. В переводе теги нужно расставить так же, как в исходнике (по смыслу форматирования). ## Плейсхолдеры **Плейсхолдеры** — подставляемые значения: `{user_name}`, `%s`, `{{count}}`. Их нельзя переводить или терять — только переставлять внутри предложения под грамматику целевого языка. Форматы плейсхолдеров настраиваются в **Settings → Placeholders** (см. [Плейсхолдеры: форматы и валидация](/article/placeholders)). ## Правила работы - Переносите все теги: незакрытый/лишний тег считается ошибкой. - Порядок тегов может отличаться от исходника, если грамматика языка этого требует (для переставляемых пар существуют правила валидации). - Не вводите плейсхолдеры вручную — используйте вставку из панели (значок тега/плейсхолдера в сегменте), чтобы избежать опечаток. ## Валидация Перед экспортом платформа проверяет целостность тегов и плейсхолдеров. Ошибки подсвечиваются в редакторе и в отчёте экспорта. Невалидный документ лучше исправить до завершения — иначе результат может «сломаться» при открытии. Если тегов очень много (например, «испорченный» HTML) — проверьте правила разбора файла ([Форматы файлов и правила разбора](/article/file-formats)) или создайте пресет разбора ([Пресеты разбора файлов](/article/disassembly-presets)). --- # Фильтрация сегментов ## Зачем фильтровать Фильтры сокращают таблицу сегментов до нужного подмножества — так быстрее проверять и дорабатывать переводы. ## Типовые фильтры - **Статус сегмента** — только непереведённые, только неподтверждённые, только подтверждённые. - **Содержимое** — поиск текста в исходнике или переводе. - **Теги/плейсхолдеры** — сегменты с тегами, с потенциальными ошибками тегов. - **Совпадения** — сегменты с 100% совпадением (проверить «безопасные»), с fuzzy, с MT. - **Комментарии** — сегменты с комментариями ревьюера. - **Изменённые** — сегменты, изменённые ревьюером (для повторной проверки переводчиком). ## Как применять Панель фильтров в редакторе (значок воронки) включает/выключает условия; активные фильтры видны всегда, чтобы случайно не оставить «скрытые» сегменты. ## Типовые сценарии - Постредактирование MT: фильтр «с MT-переводом, неподтверждённые». - Работа ревьюера: фильтр «подтверждённые, изменённые». - Финальная проверка перед экспортом: фильтр «неподтверждённые» = 0. Фильтры не меняют данные — только отображение. Подтверждение сегмента при активном фильтре работает как обычно. --- # Комментарии к сегментам ## Зачем комментарии Комментарии фиксируют вопросы и решения по конкретному сегменту: «здесь термин по глоссарию?», «в оригинале опечатка», «договорились писать кратко». Они сохраняются с документом и видны всем участникам проекта. ## Как работать 1. Выберите сегмент и откройте панель комментариев (значок комментария). 2. Напишите текст и отправьте — участники проекта получат уведомление (если включены уведомления, см. [Уведомления](/article/notifications-settings)). 3. Ответы образуют ветку обсуждения. 4. Когда вопрос решён, отметьте комментарий как разрешённый. ## Комментарии и этапы - Переводчик задаёт вопрос — ревьюер/менеджер отвечает. - Ревьюер оставляет замечания — переводчик исправляет и помечает разрешённым. - Комментарии экспортируются с XLIFF и видны в отчётах по документу. ## Правила хорошего тона - Пишите конкретно: ссылка на термин, сегмент, источник. - Разрешайте комментарии после решения — иначе фильтр «с комментариями» будет шуметь. - Критичные вопросы дублируйте в поддержку: support@plaia.ru. --- # Ревью и контроль качества (LQA) ## Два уровня проверки 1. **Editor review** — правка переводов ревьюером: стиль, терминология, грамматика. 2. **Final review / Manager review** — финальная проверка менеджером перед сдачей. ## Как ревьюер работает - Фильтр «подтверждённые» — просмотр готовых переводов. - Правки фиксируются: сегмент получает отметку «изменён ревьюером». - Замечания — в комментариях сегмента (см. [Комментарии к сегментам](/article/comments)). ## Оценка качества (LQA) Ошибки классифицируются по категориям (точность, терминология, стиль, грамматика, теги/плейсхолдеры) с весами — формируется оценка качества перевода. Так объективно сравниваются исполнители и принимаются решения о допуске к проектам. ## Цикл исправлений 1. Ревьюер оставляет замечания. 2. Переводчик фильтрует «изменённые/с замечаниями» сегменты и исправляет. 3. Ревьюер перепроверяет и подтверждает. ## Полезное - Не удаляйте правки ревьюера без обсуждения. - Для типовых ошибок заводите правила в глоссарий и [плейсхолдеры](/article/placeholders). - Итоги по этапам видны в статистике проекта (см. [Статистика проекта](/article/project-statistics)). --- # Горячие клавиши ## Основные | Действие | Windows/Linux | macOS | | --- | --- | --- | | Подтвердить сегмент, перейти к следующему | Ctrl+Enter | ⌘+Enter | | Перейти к следующему сегменту | Ctrl+↓ / Tab | ⌘+↓ | | Перейти к предыдущему | Ctrl+↑ | ⌘+↑ | | Сохранить перевод без подтверждения | Ctrl+S | ⌘+S | | Найти по документу | Ctrl+F | ⌘+F | ## Работа с ресурсами | Действие | Сочетание | | --- | --- | | Вставить лучшее TM-совпадение заново | Alt+1 | | Вставить MT-перевод | Alt+M (или из панели MT) | | Вставить термин глоссария | клик по подсветке / панели глоссария | | Открыть конкорданс | Ctrl+Shift+C | ## Сегменты | Действие | Сочетание | | --- | --- | | Объединить сегменты | Ctrl+J | | Разбить сегмент | Ctrl+Shift+S | ## Советы - **Ctrl+Enter** — главный ритм работы: перевёл → подтвердил → следующий. - Список всех сочетаний доступен в редакторе (значок клавиатуры/справки). - Если сочетание не работает — проверьте, что фокус в поле перевода, и что браузер не перехватывает клавиши. --- # Настройки редактора и визуальный контекст ## Настройки отображения - **Теги** — полный/сокращённый вид; выделение тегов цветом. - **Шрифт и размер** — подбираются под ваши глаза; изменения применяются сразу. - **Показ смежных сегментов** — контекст вокруг текущего сегмента. - **Панели ресурсов** — TM, MT, глоссарий, конкорданс можно сворачивать и перестраивать. ## Визуальный контекст Для документов с вёрсткой (PDF, IDML, HTML) редактор может показывать визуальный контекст — как сегмент выглядит в документе. Это помогает переводить интерфейсные строки и подписи с пониманием места. ## Мультидокументный режим Работа с несколькими документами проекта в одной сессии: переключение вкладками без возврата в список проектов. Удобно для пакетов однотипных файлов. ## Проверьте перед большой работой 1. Фильтры сброшены (нет «скрытых» сегментов). 2. Подключены нужные TM/глоссарий (см. [Подключение TM к проекту](/article/tm-in-project), [Подключение глоссария](/article/glossary-in-project)). 3. MT-профиль соответствует типу контента ([Профили умного перевода](/article/smart-translation-profiles)). --- # Лингвистические активы: обзор **Лингвистические активы** — накопленные знания аккаунта, которые делают переводы быстрее и единообразнее. Раздел **Linguistic assets** в меню платформы содержит: | Раздел | Назначение | | --- | --- | | **Translation Memories** | Переводческие памяти: базы пар «исходник → перевод» | | **Glossaries** | Глоссарии: утверждённые термины и их переводы | | **Global Search** | Поиск по всем активам аккаунта | | **TM Editor** | Просмотр и правка содержимого TM | ## Как активы работают в проекте 1. К проекту подключаются TM и глоссарии ([Подключение TM к проекту](/article/tm-in-project), [Подключение глоссария к проекту](/article/glossary-in-project)). 2. При претранслейте TM подставляет совпадения, MT переводит остальное. 3. Подтверждённые сегменты попадают в TM (если она пишущая). 4. Термины глоссария подсвечиваются в редакторе и учитываются MT. ## Экономика Использование TM и MT расходует **Smartwords** (см. [Что такое Smartwords](/article/smartwords-intro)). Чем больше покрытие TM, тем меньше объём MT и тем дешевле проект. ## Начало работы - Есть готовые TMX-файлы прошлых проектов? Импортируйте: [Импорт и экспорт TMX](/article/tm-import-export). - Есть терминология? Создайте глоссарий: [Создание глоссария и добавление терминов](/article/glossary-create). - Ничего нет? Начните с пустых активов — TM наполнится из ваших первых проектов. --- # Создание и настройка TM ## Создание TM 1. Откройте **Linguistic assets → Translation Memories**. 2. Нажмите создание новой TM. 3. Задайте **название** и **языковые направления**: исходный язык и целевые языки памяти (их можно добавить позже — `PUT /api/integration/v1/translationmemory/{tmId}/targets`). 4. Сохраните — пустая TM готова к использованию. Через API: `POST /api/integration/v1/translationmemory` — создаёт пустую TM (см. [TM и глоссарии через API](/article/api-tm-glossaries)). ## Языки TM TM хранит пары для конкретных направлений. Совпадения находятся только между одинаковыми (или совместимыми) языками: пара `en → ru` не даст совпадений для `en → ru-RU`, если язык не добавлен в TM. Добавляйте нужные локали заранее. ## Чтение и запись - **Чтение** — TM участвует в подборе совпадений в редакторе и претранслейте. - **Запись** — подтверждённые сегменты проектов сохраняются в TM. Рекомендация: для проектных TM включайте запись; для «эталонных» сборок (например, импортированная база заказчика) запись можно отключить, чтобы не «засорять» память. ## Настройки проекта См. [Подключение TM к проекту](/article/tm-in-project): один набор TM на все языки проекта или отдельный набор по языкам. --- # Импорт и экспорт TMX ## TMX — стандарт обмена **TMX** (Translation Memory eXchange) — XML-формат обмена переводческими памятьми, поддерживается всеми CAT-инструментами. Платформа принимает и отдаёт TMX. ## Импорт TMX 1. Откройте TM в **Linguistic assets → Translation Memories**. 2. Выберите импорт и загрузите TMX-файл. 3. Импорт идёт как фоновая задача — проверьте статус в списке задач импорта. 4. После завершения совпадения появляются в редакторе проектов с подключённой TM. Через API: `POST /api/integration/v1/translationmemory/{tmId}` запускает импорт TMX; статус — `GET /api/integration/v1/translationmemory/task`; отмена — `DELETE /api/integration/v1/translationmemory/task/{taskId}`. ## Требования к файлу - Языки в TMX должны соответствовать (или быть совместимы с) направлениям TM. - Большие файлы (сотни тысяч единиц) обрабатываются дольше — следите за статусом задачи. ## Экспорт TMX - В интерфейсе TM — команда экспорта. - Через API: `GET /api/integration/v1/translationmemory/{tmId}/file` — выгрузка TMX из базы памяти. ## Рекомендации - Импортируйте TMX в «эталонную» TM без записи, чтобы сохранить исходное качество базы. - Перед импортом больших баз сделайте пробную загрузку на копии TM. - Экспортируйте TM регулярно — это резервная копия накопленных знаний. --- # Как считаются совпадения TM ## Уровни совпадений - **Context match (CM)** — сегмент совпадает на 100% и совпадает его окружение (соседние сегменты). Самое надёжное совпадение. - **100%** — дословное совпадение исходного сегмента. - **Fuzzy** — частичное совпадение (обычно от 50% до 99%). ## Что влияет на процент - **Морфология и числа** — «загрузите файл» vs «загрузка файла» понижают процент. - **Плейсхолдеры и теги** — разные конструкции снижают совпадение даже при одинаковом тексте. - **Пробелы и пунктуация** — двойные пробелы, кавычки, неразрывные пробелы. - **Язык** — совпадения ищутся строго по совпадающим направлениям языков. ## Как повысить качество базы 1. Подтверждайте сегменты после финальной правки — в TM попадёт лучший вариант. 2. Не подключайте к проекту конфликтующие TM с разными переводами одного сегмента. 3. Регулярно чистите «эталонные» TM от ошибочных пар (через [TM Editor](/article/tm-editor)). 4. Держите единый стиль исходников (шаблоны писем, стандартные фразы) — тогда TM покрывает больше сегментов. ## Совпадения и стоимость Нет-рейт ([Нет-рейты](/article/net-rates)) назначает скидку каждому уровню совпадений — платформа считает стоимость проекта с учётом TM автоматически. --- # TM Editor ## Что такое TM Editor **TM Editor** — инструмент для работы с содержимым TM: поиск единиц памяти, просмотр пар, правка переводов, удаление мусорных записей. ## Когда нужен - В базе накопились ошибочные пары (опечатки, старые переводы) — их нужно удалить. - Нужно массово заменить перевод («бренд» сменил написание). - Требуется проверить, как переведён конкретный сегмент. ## Как работать 1. Откройте **Linguistic assets → TM Editor**. 2. Выберите TM и языковое направление. 3. Ищите по тексту исходника или перевода. 4. Правьте или удаляйте найденные единицы. ## Правила осторожности - Правки в TM влияют на все будущие проекты с этой TM — двойная проверка не помешает. - Массовые операции (замена/удаление по условию) делайте по образцу: сначала поиск, потом действие. - Для больших перетрясок удобнее экспортировать TMX, обработать файл и импортировать заново ([Импорт и экспорт TMX](/article/tm-import-export)). ## Программный доступ Совпадения из TM: `POST /api/integration/v1/translationmemory/matches`. Полный список методов TM — в [Справочнике API](/api). --- # Создание глоссария и добавление терминов ## Создание глоссария 1. Откройте **Linguistic assets → Glossaries**. 2. Создайте глоссарий: название и языки. 3. Добавляйте термины. ## Добавление термина Для каждого термина задаются: - **Исходный термин** — как он встречается в текстах (например, «выгрузка»). - **Перевод** — утверждённый вариант (например, «export»). - **Часть речи** — по желанию: помогает MT и редактору различать «ключ» (сущ.) и «ключевой» (прил.). - **Примечание** — контекст использования: «в UI не переводить», «только для модуля оплаты». - **Синонимы** — дополнительные формы термина. ## Обязательность терминов Термин можно пометить как обязательный: ревью и валидация будут обращать внимание на отклонения от него. Не делайте обязательными всё подряд — большая жёсткая терминология замедляет работу. ## Поддержка актуальности - Назначьте владельца глоссария (кто утверждает новые термины). - Добавляйте термины по ходу проектов: вопрос в комментарии сегмента → решение → новый термин. - Регулярно синхронизируйте глоссарий с клиентом, если работаете по его терминологии. Импорт готовых списков терминов: [Импорт глоссария](/article/glossary-import). --- # Импорт глоссария ## Что можно импортировать Списки терминов из прошлых проектов, терминология заказчика, отраслевые словари. Формат — табличный (CSV/XLSX-подобный) с колонками: исходный термин, перевод, часть речи, примечание, синонимы. Подготовьте файл по шаблону: одна строка — один термин; заголовки колонок — на английском (source, target, POS, note). ## Как импортировать 1. Откройте глоссарий в **Linguistic assets → Glossaries**. 2. Запустите импорт и загрузите файл. 3. Импорт выполняется как фоновая задача — статус задачи доступен в интерфейсе и через API: - запуск: `POST /api/integration/v1/glossary/import`; - статус: `GET /api/integration/v1/glossary/importTaskState/{taskId}`. ## Проверка после импорта - Проверьте количество терминов — совпадает ли с файлом. - Протестируйте подсветку в редакторе: откройте проект с подключённым глоссарием. - Ошибочные строки (пустые переводы, дубли) платформа пропускает с предупреждением — просмотрите отчёт задачи. ## Конфликты и дубли Повторный импорт тех же терминов не создаёт дубликаты — существующие термины обновляются. Если в файле два разных перевода одного термина, в глоссарий попадёт последний — проверяйте такие строки заранее. --- # Подключение глоссария к проекту ## Подключение В настройках проекта укажите глоссарии проекта (шаг Settings мастера создания или страница проекта позже). Через API: - `GET /api/integration/v1/project/{projectId}/glossaries` — текущий список; - `PUT /api/integration/v1/project/{projectId}/glossaries` — задать набор глоссариев. ## Несколько глоссариев К проекту можно подключить несколько глоссариев: например, «общая терминология» + «термины клиента X». При конфликте (один термин с разными переводами в разных глоссариях) приоритет определяется порядком подключения — следите, чтобы глоссарии не противоречили друг другу. ## Что даёт подключение - Подсветка терминов в редакторе ([Глоссарий в редакторе](/article/glossary-in-editor)). - Учёт терминов машинным переводом. - Валидация терминологии на ревью. ## Отключение Уберите глоссарий из настроек проекта — подсветка и валидация прекратятся, история подтверждённых сегментов не изменится. Совет: для каждого клиента держите свой глоссарий и подключайте только его — терминология клиентов часто различается. --- # Подключение TM к проекту ## Как подключить В настройках проекта (шаг Settings мастера создания или страница проекта) выберите TM для проекта. Через API: - `GET /api/integration/v1/project/{projectId}/translationmemories` — список подключённых TM; - `POST /api/integration/v1/project/{projectId}/translationmemories` — пересоздать единый набор TM для всех целевых языков; - `POST /api/integration/v1/project/{projectId}/translationmemories/bylanguages` — пересоздать набор TM раздельно по каждому целевому языку. ## Единый набор vs по языкам - **Единый набор** — все подключённые TM используются для всех целевых языков проекта. Проще в поддержке. - **По языкам** — для каждого целевого языка свой список TM. Нужно, если языки сильно различаются (например, отдельные TM для ru-RU и ru-KZ) или объём баз велик. ## Сколько TM подключать - 1–3 проектных TM + при необходимости эталонная база заказчика. - Чем больше TM, тем больше время подбора совпадений и выше риск противоречивых переводов. ## Пишущая TM Совпадения подставляются из всех подключённых TM; запись подтверждённых сегментов — в пишущие TM (см. [Создание и настройка TM](/article/tm-create)). Если в проекте несколько пишущих TM — пары сохраняются в каждую (уточните поведение в поддержке для вашей схемы). --- # Глобальный поиск по активам ## Что это **Global Search** (Linguistic assets → Global Search) ищет по всем лингвистическим активам аккаунта: переводческим памятям и глоссариям. В отличие от конкорданса проекта, здесь не нужно ничего подключать — ищется всё. ## Когда использовать - «Как мы раньше переводили X?» — до создания нового проекта. - Проверка терминологии перед ответом клиенту. - Поиск «сиротских» сегментов для чистки баз. ## Как искать 1. Откройте **Global Search**. 2. Введите фразу или термин. 3. Результаты группируются по источнику (конкретная TM, глоссарий) с процентом совпадения. ## Отличия от конкорданса проекта | | Конкорданс проекта | Global Search | | --- | --- | --- | | Область | TM, подключённые к проекту | Все активы аккаунта | | Доступ | Участники проекта | Все с доступом к активам | | Скорость | Быстрее (меньше объём) | Медленнее на больших базах | ## Программный доступ Совпадения из конкретной TM: `POST /api/integration/v1/translationmemory/matches`. Список TM аккаунта: `GET /api/integration/v1/translationmemory`. --- # Команда: обзор Раздел **Team → Team members** — список всех участников аккаунта: менеджеры, лингвисты, ревьюеры, типографы. Здесь участники приглашаются, редактируются и отключаются. ## Карточка участника - **Имя и email** — идентификация и вход. - **Роль / уровень доступа** — что участнику можно (см. [Уровни доступа](/article/access-levels)). - **Услуги** — специализации и языковые пары участника: используются при подборе исполнителей (см. [Услуги и специализации участников](/article/team-services)). - **Комментарий** — служебное поле для менеджеров (API: `PUT /api/integration/v1/account/myTeam/{userId}/comment`). - **Телефон** — контакт (API: `PUT /api/integration/v1/account/myTeam/{userId}/phone`). ## Команда и проекты - Менеджеры назначаются на проекты и управляют исполнителями. - Лингвисты работают только с назначенными им документами. - Список участников MyTeam доступен и через API: `GET /api/integration/v1/account/myTeam`. ## Чек-лист новых участников 1. Пригласить участника (см. [Добавление участников](/article/invite-members)). 2. Назначить роль и уровень доступа. 3. Заполнить услуги и языковые пары. 4. Проверить, что участник вошёл и видит нужные проекты. Отключение участника — с передачей его работ: см. [Отключение участника и передача работ](/article/remove-member). --- # Добавление участников ## Как пригласить 1. Откройте **Team → Team members** и нажмите добавление участника (значок +). 2. Укажите **email** и **имя**. 3. Выберите **роль/уровень доступа** (см. [Уровни доступа](/article/access-levels)). 4. Отправьте приглашение. ## Что получает приглашённый - Письмо с ссылкой для входа/завершения регистрации (если письма нет — проверьте спам; см. [FAQ: не приходят уведомления](/article/faq-email-notifications)). - Доступ к разделам согласно роли: лингвист видит только назначенные ему документы. ## Массовое добавление через API Добавление штатного лингвиста в MyTeam: `POST /api/integration/v1/account/myTeam`. Поиск участника по внешнему ID: `GET /api/integration/v1/account/myTeam` (по параметрам запроса). ## Если приглашение устарело Приглашение можно отправить повторно. Приглашённый, не завершивший регистрацию, не отображается как активный участник и не может быть назначен на проекты. ## Роли при приглашении Роль можно изменить позже в карточке участника. Безопасный старт — минимальная роль с последующим расширением прав по мере необходимости. --- # Уровни доступа ## Где настраиваются **Settings → User access levels** — конструктор уровней доступа аккаунта. Администратор создаёт уровни и назначает их участникам (см. [Настройки аккаунта: обзор](/article/settings-overview)). ## Что регулируют уровни - Доступ к разделам (Projects, Linguistic assets, Team, Clients, Payments, Reports, Settings). - Действия в проектах: создание, редактирование, экспорт, удаление. - Доступ к активам: чтение/запись TM и глоссариев. - Биллинг: счета, платежи, баланс. ## Принцип наименьших прав 1. Лингвисту — только редактор назначенных документов. 2. Ревьюеру — редактор + ревью-действия. 3. Менеджеру — проекты, команда, отчёты; без биллинга, если не нужно. 4. Биллинг и настройки — администраторам. ## Изменение уровня участника Права меняются в карточке участника (Team) — изменения применяются сразу; перезаход в платформу обычно не требуется. ## Проверка доступа Если пользователь «не видит» раздел — проверьте его уровень (см. [FAQ: нет доступа к разделу](/article/faq-access)). API-доступ отдельным уровнем не настраивается: он управляется через API-ключи (см. [API-ключи](/article/api-keys)). --- # MyTeam: штатные лингвисты ## Что такое MyTeam **MyTeam** — механизм управления штатными лингвистами: у каждого участника есть профиль (услуги, языковые пары, специализации), и на задачи можно приглашать участников автоматически. ## Профиль участника - **Услуги и языковые пары** — что участник может делать (перевод, ревью; en→ru, ru→en...). - **Контактные данные** — телефон и комментарий (API: `PUT .../myTeam/{userId}/phone`, `PUT .../myTeam/{userId}/comment`). - **Замена услуг** — обновить весь набор услуг: `POST /api/integration/v1/account/myTeam/{userId}/services/replace`. ## Приглашения на задачи Отправка приглашений штатным лингвистам на нераспределённые сегменты: `POST /api/integration/v1/document/assignFromMyTeam` — приглашения уходят всем подходящим, первый принявший получает задачу (см. [Назначение исполнителей](/article/assign-linguists)). ## Поиск лингвистов Подбор по услугам и языкам: `POST /api/integration/v1/account/searchMyTeam` — вернёт подходящих участников для услуги/языковой пары. ## MyTeam vs вендоры vs биржа | Способ | Когда | | --- | --- | | **MyTeam** | Штатная команда, стабильные объёмы | | **Вендор** | Передача этапа целиком подрядчику | | **Post as job** | Поиск свободного исполнителя на разовый объём | См. также: [Работа с вендорами в проекте](/article/assign-vendors), [Размещение задачи на бирже](/article/post-as-job). --- # Вендоры и субподряд ## Роль вендора **Вендор** — внешний подрядчик, которому передаются этапы проектов целиком. Вендор назначает своих исполнителей сам и отвечает за качество этапа. ## Подключение вендора Вендор должен иметь аккаунт на платформе. Свяжитесь с ним и с поддержкой (support@plaia.ru), чтобы привязать аккаунты. Список вендоров: `GET /api/integration/v1/vendor/list`. ## Передача работ 1. В проекте выберите этап workflow и назначьте вендора (или API `POST /api/integration/v1/document/assignVendors`). 2. Задайте объём этапа (setStageUnitCount) и deadline. 3. Вендор принимает работу и распределяет её внутри своей команды. ## Что видит вендор - Своё рабочее пространство с назначенными ему проектами/этапами. - Статистику и прогресс по своим задачам. - Квоту вендора: `GET /api/integration/v1/Quote/ByVendor/{projectId}`. ## Расчёты Оплата вендора идёт по его услугам и ценам — фиксируется в **Payments → Supplier payments**. Для клиента-заказчика стоимость вендорского этапа входит в стоимость проекта (см. [Как считается стоимость перевода](/article/pricing-model)). ## Контроль качества Даже при передаче вендору рекомендуется внутренний этап ревью — особенно для новых подрядчиков ([Ревью и контроль качества](/article/review-lqa)). --- # Услуги и специализации участников ## Что такое услуга **Услуга (service)** — что участник может делать: перевод, редактирование, ревью, вёрстка (DTP), работа с субтитрами и т.д. Услуга привязывается к языковой паре и области (технический перевод, маркетинг, юридический, медицинский...). ## Где задаются - В карточке участника **Team** (или в профиле MyTeam). - Массово через API: `POST /api/integration/v1/account/myTeam/{userId}/services/replace` — замена всех услуг профиля. ## Как услуги используются - **Подбор исполнителей**: поиск MyTeam по услуге (`POST /api/integration/v1/account/searchMyTeam`) возвращает только подходящих. - **Цены**: услуги LSP (цены услуг — `/api/integration/v2/lsp/services` и `/api/integration/v2/lsp/prices`) связывают услугу, языковую пару и стоимость — по ним считаются работы и платежи (см. [Как считается стоимость перевода](/article/pricing-model)). - **Назначение на этапы**: этап Translation требует услугу перевода, этап ревью — услугу ревью. ## Рекомендации - Заполняйте услуги всем участникам — иначе автоподбор и расчёты будут неполными. - Обновляйте специализации при смене направлений работы. - Для узких областей (медицина, право) создавайте отдельные услуги — так проще фильтровать. --- # Приглашения фрилансеров на задачи ## Механика приглашений При назначении «из команды» платформа отправляет приглашения подходящим исполнителям: уведомление в платформе и по почте (если включены уведомления — см. [Уведомления](/article/notifications-settings)). - **AssignFromMyTeam** — приглашения всем подходящим штатным лингвистам; задача закрепляется за первым принявшим. - **Post as job** — публикация на биржу; исполнители откликаются сами (см. [Размещение задачи на бирже](/article/post-as-job)). ## Что видит исполнитель - Объём задачи (слова), языковую пару, срок и цену. - Документ в редакторе — после приёма задачи. ## Если приглашение не принято - Проверьте, совпадает ли услуга/языковая пара исполнителя с задачей ([Услуги и специализации](/article/team-services)). - Напомните участнику о задаче — уведомление могло потеряться. - Переназначьте задачу другому исполнителю или распределите вручную ([Назначение исполнителей](/article/assign-linguists)). ## Оплата После выполнения и подтверждения задачи формируется платёж исполнителю: `POST /api/integration/v1/invoice/job` (v2) — см. [Оплата исполнителей](/article/supplier-payments). --- # Отключение участника и передача работ ## Подготовка 1. Проверьте активные задачи участника: назначенные документы и этапы. 2. Договоритесь о передаче: завершить начатое или переназначить коллеге. ## Переназначение задач - Снимите назначение с документов (`POST /api/integration/v1/document/unassign`) и назначьте нового исполнителя ([Назначение исполнителей](/article/assign-linguists)). - Переводы уже сделанных сегментов сохраняются в документе — новый исполнитель продолжает с того же места. ## Отключение доступа 1. В **Team → Team members** откройте карточку участника. 2. Отключите участника (деактивация) — вход в платформу блокируется. 3. Удаление из MyTeam: `DELETE /api/integration/v1/account/myTeam/{userId}`. ## Что остаётся - История работ и подтверждённые переводы сохраняются (имя автора остаётся в истории). - Участник в списке становится неактивным (для аудита), либо удаляется. ## Чек-лист - [ ] Активные задачи переназначены - [ ] Незавершённые документы не «застряли» (проверьте статусы) - [ ] Доступ отключён - [ ] API-ключи, выпущенные участнику, отозваны (см. [API-ключи](/article/api-keys)) --- # Клиенты: обзор Раздел **Clients** содержит всех заказчиков аккаунта. Привязка проекта к клиенту включает автоматический расчёт стоимости, квоты и счета для заказов этого клиента. ## Возможности - **Создание клиента** (см. [Создание клиента](/article/client-create)) — по имени; повторное создание с тем же именем возвращает существующего. - **Контакты клиента** — ФИО, email, телефон: `PUT /api/integration/v1/client/{clientId}/contact` (см. [Контакты клиента](/article/client-contacts)). - **Нет-рейты** — скидки по совпадениям TM для клиента: `PUT /api/integration/v1/client/{clientId}/set` (см. [Нет-рейты](/article/net-rates)). - **Отрасль клиента** — из справочника отраслей (см. [Справочники](/article/directory)). ## Клиент и проект В настройках проекта выберите клиента — колонка **Client** в списке проектов и расчёты по квотам начнут учитывать заказчика. Клиент получает доступ к своим квотам и результатам (по настройке доступа). ## Клиент и платежи - Расчёты заказов клиента формируются в квотах ([Квоты](/article/quotes)). - Оплаты клиента отражаются в **Payments → Client payments** ([Платежи клиентов](/article/client-payments)). - Счета для клиента — в **Payments → Invoices** ([Счета](/article/invoices)). --- # Создание клиента ## В интерфейсе 1. Откройте **Clients** и нажмите создание клиента. 2. Укажите **имя** (компания или физлицо). 3. При необходимости выберите **отрасль** из справочника (см. [Справочники](/article/directory)). 4. Сохраните — клиент появится в списке. ## Через API `POST /api/integration/v1/client/create` — создаёт клиента и возвращает его **ID**. Если клиент с таким именем уже существует, метод вернёт ID существующего (дубль не создаётся) — удобно для синхронизации с CRM. ## После создания 1. **Контакты** — задайте контактные данные ([Контакты клиента](/article/client-contacts)). 2. **Нет-рейт** — если клиент получает скидки по совпадениям ([Нет-рейты](/article/net-rates)). 3. **Проекты** — привяжите проекты к клиенту в настройках проекта. 4. **Шаблоны** — для счетов и квот клиента используются шаблоны аккаунта ([Шаблоны](/article/templates)). ## Переименование и обновление Данные клиента обновляются: `PUT /api/integration/v2/client/{clientId}` (v2) или `PUT /api/integration/v1/client/{clientId}` (v1). Информация о клиенте: `GET /api/integration/v2/client/{clientId}`. --- # Контакты клиента ## Зачем контакты Контактные данные клиента попадают в квоты, счета и уведомления: корректные контакты — условие аккуратных документов и коммуникации. ## Что задать - **Контактное лицо** — ФИО. - **Email** — для отправки квот и счетов. - **Телефон** — для оперативной связи. ## Через API `PUT /api/integration/v1/client/{clientId}/contact` — устанавливает контактные данные клиента. Данные клиента в целом обновляются `PUT /api/integration/v2/client/{clientId}`. ## Где контакты используются - **Квоты** — письмо клиенту с расчётом ([Квоты](/article/quotes)). - **Счета** — получатель платежа ([Счета](/article/invoices)). - **Клиентские платежи** — привязка оплаты к заказчику ([Платежи клиентов](/article/client-payments)). ## Реквизиты vs контакты Не путайте: **реквизиты биллинга** (юридические данные вашей компании для счетов) настраиваются в **Payments → Settings** ([Настройки биллинга](/article/billing-settings)), а контакты клиента — в карточке клиента. --- # Нет-рейты (скидки по совпадениям) ## Что такое нет-рейт **Net rate** — таблица скидок по уровням совпадений TM: сколько процентов полной цены считается за каждое совпадение. Например: | Совпадение | Нет-рейт (пример) | | --- | --- | | Context match / 100% | 25% | | Fuzzy 75–99% | 50% | | Fuzzy 50–74% | 75% | | Без совпадений / MT | 100% | ## Настройка для клиента 1. Откройте карточку клиента. 2. Задайте нет-рейт по уровням совпадений (или примените готовый профиль). 3. Через API: `PUT /api/integration/v1/client/{clientId}/set` — применяет указанный нет-рейт к клиенту. ## Как считается стоимость Статистика проекта разбивает слова по уровням совпадений; для каждого уровня применяется нет-рейт клиента; итог — стоимость заказа (см. [Как считается стоимость перевода](/article/pricing-model)). Нет-рейт действует на все проекты этого клиента. ## Стандартные схемы - **Схема «немецкая» (типовая LSP)**: 100% — 25%, fuzzy 99–75% — 50%, fuzzy 74–50% — 75%. - **Полная цена (нет скидок)**: все уровни — 100%. - Свою схему согласуйте с клиентом и заведите как отдельный нет-рейт. ## Проверка Стоимость проекта в квоте должна соответствовать согласованной схеме — проверьте на первом заказе клиента ([Квоты](/article/quotes)). --- # Квоты (расчёты стоимости) ## Что такое квота **Quote** — расчёт стоимости проекта, который отправляется клиенту на согласование. Квота создаётся на основе статистики проекта (слова × цены − скидки нет-рейта). ## Жизненный цикл 1. **Создание** — квота формируется для проекта (с привязанным клиентом). 2. **Загрузка файла** — при желании к квоте прикладывается файл расчёта (`POST /api/integration/v1/Quote/{id}/Upload`). 3. **Отправка клиенту** — на согласование. 4. **Approve** — клиент согласовал (`POST /api/integration/v1/Quote/{id}/Approve`). 5. **MarkAsPaid** — оплата зафиксирована (`POST /api/integration/v1/Quote/{id}/MarkAsPaid`). ## API-методы квот - `GET /api/integration/v1/Quote/{projectId}` — квота проекта; - `GET /api/integration/v1/Quote/List` — все квоты аккаунта; - `GET /api/integration/v1/Quote/ListByProjectIds` — квоты по списку проектов; - `PUT /api/integration/v1/Quote/Update` — обновление квоты; - `GET /api/integration/v1/Quote/{id}/File` — скачать файл расчёта. ## Шаблоны Внешний вид и содержание квоты настраиваются в **Settings → Templates** (см. [Шаблоны](/article/templates)). ## Квоты вендора Для проектов с вендором доступна отдельная квота вендора: `GET /api/integration/v1/Quote/ByVendor/{projectId}` ([Работа с вендорами](/article/assign-vendors)). --- # Платежи клиентов ## Что здесь **Payments → Client payments** — учёт поступлений от клиентов: какие суммы, за какие проекты и когда пришли. ## Как фиксируются платежи 1. Завершите заказ: проект Completed, квота согласована ([Квоты](/article/quotes)). 2. Получите оплату по счёту ([Счета](/article/invoices)). 3. Зафиксируйте платёж в Client payments, привязав к клиенту/проекту. ## API - Список счетов за период: `GET /api/integration/v2/invoice/list` ([Счета](/article/invoices)); - Агентские счета: `GET /api/integration/v2/client-agent-invoice/list`. ## Анализ Сопоставьте платежи с квотами — так вы видите задолженности и подтверждаёте оплату (`MarkAsPaid`). Для регулярных клиентов удобно сверяться по месяцам: фильтр по дате и клиенту. ## Проблемы Платёж не отражается или суммы расходятся со счётом — проверьте привязку проекта к клиенту и нет-рейт (см. [FAQ: проблемы с платежами](/article/faq-payment-issues)). --- # Счета (Invoices) ## Что здесь **Payments → Invoices** — выставленные счета: для клиентов (продажа переводов) и для исполнителей/платформы (услуги и Smartwords). ## Счёт клиенту 1. Убедитесь, что у проекта заполнен клиент и стоимость рассчитана ([Квоты](/article/quotes)). 2. Создайте счёт на основе квоты или вручную. 3. Отправьте клиенту (email из контактов клиента — [Контакты клиента](/article/client-contacts)). 4. Отметьте оплату после поступления денег. ## Счёт исполнителю (пей-ролл) Платежи исполнителям формируются автоматически по завершении задач (`POST /api/integration/v2/invoice/job`) — см. [Оплата исполнителей](/article/supplier-payments). ## API-методы | Метод | Назначение | | --- | --- | | `GET /api/integration/v2/invoice/list` | Список счетов за период | | `POST /api/integration/v1/invoice/job` / `v2` | Создать платёж исполнителю | | `POST /api/integration/v1/invoice/jobs` / `v2` | Массовые платежи | | `GET /api/integration/v1/invoice/job/list` | Список платежей исполнителям | | `GET /api/integration/v2/invoice/job/listByExternalId` | Платежи по внешнему ID | | `GET /api/integration/v2/invoice/job/listByCreatedDate` | Платежи по дате | ## Шаблоны Внешний вид счетов — **Settings → Templates** (см. [Шаблоны](/article/templates)); реквизиты компании — **Payments → Settings** ([Настройки биллинга](/article/billing-settings)). --- # Оплата исполнителей (Supplier payments) ## Как формируются платежи Платёж исполнителю создаётся по выполненной задаче: 1. Исполнитель подтверждает свою часть работы (сегменты/блок). 2. Платформа или менеджер формирует платёж по цене услуги ([Как считается стоимость](/article/pricing-model)). 3. Платёж отображается в **Payments → Supplier payments**. ## Через API | Метод | Назначение | | --- | --- | | `POST /api/integration/v2/invoice/job` | Создать платёж (рекомендуемый) | | `POST /api/integration/v1/invoice/job` | Создать платёж (v1) | | `POST /api/integration/v2/invoice/jobs` | Массив платежей | | `GET /api/integration/v1/invoice/job/list` | Список платежей | | `GET /api/integration/v2/invoice/job/listByExternalId` | Поиск по внешнему ID | | `GET /api/integration/v2/invoice/job/listByCreatedDate` | По дате создания | Внешний ID (externalId) полезен при синхронизации с вашей бухгалтерией: задавайте его при создании платежа, чтобы идемпотентно находить платежи позже. ## Вендоры Для вендоров платеж агрегируется по этапу/квоте вендора (см. [Работа с вендорами](/article/assign-vendors)). ## Порядок и сроки Согласуйте с исполнителями: когда подтверждение = «работа принята», и когда происходит оплата. Подтверждение задачи без проверки = риск оплаты за некачественную работу — используйте этап ревью ([Ревью и контроль качества](/article/review-lqa)). --- # Баланс аккаунта ## Что здесь **Payments → Balance** показывает текущее состояние баланса аккаунта: пополнения, списания за услуги платформы (Smartwords, работы исполнителей) и доступный остаток. ## Как работает баланс - **Пополнение** — оплата пакета Smartwords или аванс ([Smartwords: баланс и пополнение](/article/smartwords)). - **Списание** — MT/TM-слова по мере перевода, платежи исполнителям по подтверждённым задачам. - **Отрицательный баланс** — работы, требующие списаний, приостанавливаются до пополнения. ## Связанные разделы - **Productivity services** — баланс именно Smartwords с кнопкой покупки ([Что такое Smartwords](/article/smartwords-intro)). - **Reports** — детализация расхода по проектам и периодам. ## Контроль расхода 1. Подключайте MT не ко всем проектам подряд ([Подключение MT к проекту](/article/mt-in-project)). 2. Используйте TM — совпадения дешевле MT. 3. Настройте профили умного перевода — MT только там, где он полезен ([Профили умного перевода](/article/smart-translation-profiles)). ## Вопросы по списаниям Расхождение ожиданий и фактических списаний — напишите в support@plaia.ru с указанием проекта и периода; приложите статистику проекта ([Статистика проекта](/article/project-statistics)). --- # Настройки биллинга (реквизиты) ## Где настраиваются **Payments → Settings** (billing details) — реквизиты вашего юрлица/ИП, которые попадают в счета и документы: - **Название компании** — как в документах. - **Юридический адрес**. - **ИНН/налоговые данные** — по требованиям вашей юрисдикции. - **Банковские реквизиты** — для входящих платежей клиентов. - **Контакты для биллинга** — email/телефон финансового контакта. ## Зачем заполнять - Счета клиентам формируются с вашими реквизитами — без них документы выглядят неполно. - Платежи исполнителям и вендорам требуют корректного плательщика. - Валюта расчётов — задаётся здесь и используется в квотах и счетах (см. [Квоты](/article/quotes)). ## Через API Счета и платежи доступны через API (см. [Счета и платежи через API](/article/api-invoices)) — реквизиты задаются в интерфейсе; для сложных схем (агентские счета) используется `GET /api/integration/v2/client-agent-invoice/list`. ## Изменение реквизитов Обновляйте реквизиты при смене юрлица или банка заранее — иначе счета придётся перевыставлять. Прошлые счета не пересчитываются автоматически. --- # Как считается стоимость перевода ## Компоненты расчёта 1. **Объём** — слова исходного текста (статистика проекта). 2. **Совпадения TM** — слова распределяются по уровням: CM/100%, fuzzy, без совпадений ([Как считаются совпадения TM](/article/tm-matching)). 3. **Нет-рейт клиента** — для каждого уровня совпадений применяется процент ([Нет-рейты](/article/net-rates)). 4. **Цены услуг** — цена за слово/страницу для услуги и языковой пары (услуги LSP: `/api/integration/v2/lsp/services`, цены: `/api/integration/v2/lsp/prices`). 5. **Валюта** — задаётся в биллинг-настройках. ## Формула (упрощённо) ``` Стоимость = Σ (слова уровня i × нет-рейт i × цена услуги) ``` MT-слова считаются по полной цене услуги (если нет-рейт не предусматривает скидку для MT-черновика). ## Что ещё влияет - **Этапы workflow** — ревью оплачивается как отдельная услуга, если услуга заведена. - **Минимальная стоимость заказа** — если заведена в ценах. - **Срочность** — если вы используете повышенные цены для срочных заказов (отдельная услуга). ## Проверка расчёта Сверьте квоту проекта с ожиданиями клиента на первом заказе: статистика → уровни совпадений → нет-рейт → сумма ([Квоты](/article/quotes)). Расхождение — проверьте подключённые TM и нет-рейт клиента. ## API Прайсы LSP: `GET/POST /api/integration/v2/lsp/prices` (+batch), услуги: `/api/integration/v2/lsp/services` — см. [Справочник API](/api). --- # Машинный перевод в Plaia ## Где MT работает - **Претранслейт проекта** — при создании/добавлении файлов MT переводит сегменты, не покрытые TM. - **Редактор** — MT-предложения в панели ресурсов для каждого сегмента ([Машинный перевод в редакторе](/article/mt-suggestions)). - **Smart Translation API** — получить перевод вне проекта: `POST /api/integration/v1/smartTranslation/translate` ([Справочник API](/api)). ## Порядок приоритета при претранслейте 1. TM: context match и 100% подставляются в первую очередь. 2. Fuzzy — как черновик для редактирования. 3. MT — для сегментов без достаточного совпадения TM. ## Движки Доступные аккаунту MT-сервисы: `GET /api/integration/v1/account/mtengines`. Для проекта выбирается движок или профиль умного перевода ([Профили умного перевода](/article/smart-translation-profiles)). ## Качество и постредактирование MT — черновик, а не финальный перевод. Обязательный этап — постредактирование лингвистом (MTPE): выравнивание стиля, проверка терминов по глоссарию, правка грамматики. Рекомендуемая цепочка: **MT → лингвист → ревью**. ## Стоимость Каждое MT-слово списывает Smartwords ([Что такое Smartwords](/article/smartwords-intro)). Оптимизации: подключённая TM (совпадения не уходят в MT), профили умного перевода (MT только по назначению), отключение MT для проектов, где он не нужен ([Подключение MT к проекту](/article/mt-in-project)). --- # Доступные MT-движки ## Список движков аккаунта `GET /api/integration/v1/account/mtengines` возвращает MT-сервисы, доступные аккаунту. В интерфейсе список виден при настройке MT проекта и в **Settings → MT engine presets** ([Пресеты MT-движков](/article/mt-engine-presets)). ## Типы движков - **Универсальные нейросетевые** — общий корпус, быстрые, для большинства контентов. - **Профилированные** — варианты под тип контента (техническая документация, маркетинг, разговорный). - **Кастомные/дообученные** — движки, адаптированные под вашу терминологию и стиль (по договорённости с платформой). ## Как выбрать 1. Попробуйте 2–3 движка на тестовом проекте с типовым контентом. 2. Сравните: читаемость, соблюдение терминов, объём постредактирования. 3. Зафиксируйте выбор через [профиль умного перевода](/article/smart-translation-profiles) — он позволяет привязывать движок к типам контента. ## Изменение движка Движок задаётся на уровне проекта ([Подключение MT к проекту](/article/mt-in-project)). Смена движка в проекте применяется к новым сегментам; уже переведённые сегменты не перезаписываются. ## Расход Все платные движки списывают Smartwords. Бесплатных MT в платформе нет — если MT не подключён, сегменты остаются на ручной перевод. --- # Пресеты MT-движков ## Что такое пресет **MT engine preset** — сохранённая конфигурация MT-движка: сам движок + параметры (например, глоссарий, порог подстановки, тон перевода). Пресеты удобно переиспользовать между проектами. ## Где создаются **Settings → MT engine presets**. Нажмите создание пресета, выберите движок из доступных аккаунту ([Доступные MT-движки](/article/mt-engines)) и задайте параметры. ## Типовые пресеты | Пресет | Содержимое | | --- | --- | | **Техдокументация** | Движок X + глоссарий продукта + строгий формальный тон | | **Маркетинг** | Движок Y + креативный тон + без жёсткой терминологии | | **Черновик для внутренних нужд** | Движок Z + минимальные проверки (быстро и дёшево) | ## Использование - Пресет выбирается в MT-конфигурации проекта ([Подключение MT к проекту](/article/mt-in-project)). - Профили умного перевода могут сочетать пресеты с правилами подбора ([Профили умного перевода](/article/smart-translation-profiles)). ## Расход Пресет сам по себе ничего не списывает — Smartwords тратятся только на фактически переведённые MT-слова ([Что такое Smartwords](/article/smartwords-intro)). --- # Профили умного перевода (Smart translation profiles) ## Что такое профиль **Smart translation profile** — набор правил, по которым платформа выполняет «умный перевод»: выбор MT-движка и параметров под конкретный тип контента или сегменты. Профили создаются в **Settings → Smart translation profiles**. ## Что настраивается - **Тип контента** — техдокументация, маркетинг, юридический, разговорный. - **MT-движок/пресет** для этого типа ([Пресеты MT-движков](/article/mt-engine-presets)). - **Глоссарий/терминология**, учитываемая переводом. - **Правила применения** — например, не использовать MT для заголовков или строк UI. ## Как использовать 1. Создайте профиль(ы) под ваши типовые контенты. 2. При создании проекта или в MT-конфигурации выберите профиль ([Подключение MT к проекту](/article/mt-in-project)). 3. Платформа применит правила профиля при претранслейте и MT-запросах. ## API Прямой вызов умного перевода: `POST /api/integration/v1/smartTranslation/translate` — передайте текст и параметры, получите перевод (см. [Справочник API](/api)). ## Результат Правильные профили дают: меньше правок в постредактировании, единый тон по продуктам, управляемый расход Smartwords ([Как улучшить качество MT](/article/ai-translation-tips)). --- # Подключение MT к проекту ## Включение MT 1. Откройте настройки проекта (или шаг Settings мастера создания). 2. В секции MT выберите **движок**, **пресет** или **профиль умного перевода**. 3. Сохраните — MT начнёт применяться к новым сегментам и претранслейту. ## Через API - `GET /api/integration/v1/project/{projectId}/mt` — текущая MT-конфигурация проекта; - `POST /api/integration/v1/project/{projectId}/mt` — задать MT-конфигурацию; - `GET /api/integration/v1/project/{projectId}/mt/available` — все движки и профили, доступные проекту. ## MT + TM вместе Порядок при претранслейте: сначала TM (100%/CM подставляются без MT), затем MT для остального — так не тратятся Smartwords на сегменты, уже закрытые TM ([Что такое Smartwords](/article/smartwords-intro)). ## Отключение MT Уберите MT-конфигурацию из проекта — новые сегменты будут без MT-черновиков. Ручной перевод и TM продолжают работать. ## Проверка После первого претранслейта посмотрите статистику: сколько слов ушло в MT (расход Smartwords) и сколько покрыла TM ([Статистика проекта](/article/project-statistics)). --- # Smartwords: баланс и пополнение ## Баланс Баланс Smartwords виден: - в правом верхнем углу платформы (рядом с языком интерфейса); - в разделе **Productivity services** — карточка **Smartwords** с кнопкой покупки ([Что такое Smartwords](/article/smartwords-intro)). ## Как списываются | Действие | Списание | | --- | --- | | MT-перевод сегмента (претранслейт или редактор) | По числу слов сегмента | | Повторный MT-запрос того же сегмента | Снова по числу слов | | TM-совпадения (проприетарные функции TM) | По тарифу платных функций TM | | Ручной перевод, экспорт, глоссарии | Не списывается | ## Пополнение 1. В **Productivity services** нажмите покупку дополнительных Smartwords. 2. Выберите объём пакета. 3. Подтвердите — баланс обновится; счёт появится в **Payments → Invoices** ([Счета](/article/invoices)). Корпоративные схемы закупки (договор, безнал) — через поддержку: support@plaia.ru. ## Если баланс на нуле - MT-перевод и платные функции TM приостанавливаются. - Ручной перевод, редактор, экспорт и остальные функции работают. - Пополните баланс — перевод продолжится. ## Контроль расхода Регулярно проверяйте статистику проектов: объём MT-слов по проектам виден в отчётах ([Статистика проекта](/article/project-statistics)). --- # Постредактирование машинного перевода ## Что такое MTPE **Post-editing (постредактирование)** — доработка машинного перевода лингвистом до требуемого качества. Лёгкая правка (light post-editing) — убрать грубые ошибки; полная (full post-editing) — довести до качества ручного перевода. ## Организация workflow 1. Проект с MT: сегменты без TM-совпадений получают MT-черновики ([Подключение MT к проекту](/article/mt-in-project)). 2. Лингвист фильтрует «с MT, неподтверждённые» ([Фильтрация сегментов](/article/filters)). 3. Правка + подтверждение: постредактированный текст сохраняется в TM ([Совпадения TM](/article/tm-matches)). 4. Ревью проверяет результат ([Ревью и контроль качества](/article/review-lqa)). ## Оплата MTPE MTPE — отдельная услуга с собственной ценой (обычно ниже полного перевода): заведите услугу в прайсе ([Как считается стоимость](/article/pricing-model)) и включайте её в расчёты. Подтверждённые сегменты формируют платежи исполнителям ([Оплата исполнителей](/article/supplier-payments)). ## Метрики - **Скорость** — статистика подтверждения сегментов: `GET /api/integration/v1/segment-confirmation-statistics/{projectId}`. - **Качество** — оценки LQA на ревью. - **Объём MT** — MT-слова в статистике проекта (расход Smartwords). ## Ожидания MTPE быстрее полного перевода обычно в 1.5–3 раза в зависимости от контента и движка. Оценивайте на пилотном проекте, а не «в среднем по больнице». --- # Как улучшить качество машинного перевода ## 1. Подключите глоссарий MT уважает утверждённые термины подключённого глоссария ([Глоссарий в редакторе](/article/glossary-in-editor)). Держите термины актуальными: помечайте обязательные, убирайте конфликты. ## 2. Чистите исходный текст - Короткие и однозначные предложения переводятся лучше. - Уберите опечатки и непарные кавычки — они «ломают» сегменты. - Плейсхолдеры по правилам ([Плейсхолдеры](/article/placeholders)) не должны попадать в текст как «мусор». ## 3. Настройте профиль умного перевода Привяжите движок и параметры к типу контента ([Профили умного перевода](/article/smart-translation-profiles)): формальный тон для документации, свободный для маркетинга. ## 4. Тестируйте движки на своём контенте Возьмите 100–200 типовых сегментов, прогоните через 2–3 движка, посчитайте долю правок. Выберите движок с минимальным объёмом постредактирования ([Доступные MT-движки](/article/mt-engines)). ## 5. Используйте TM-наполнение Каждый подтверждённый после MT сегмент попадает в TM — следующий раз этот текст будет закрыт TM без расхода MT ([Совпадения TM](/article/tm-matching)). MT в платформе «умнеет» вместе с вашей базой. ## 6. Не просите MT невозможного - Сложная креативная локализация — работа лингвиста. - Очень короткие сегменты (кнопки «OK», «Cancel») часто лучше решать списком утверждённых переводов в глоссарии. --- # Настройки аккаунта: обзор Раздел **Settings** — настройки всего аккаунта. Доступен административным ролям (см. [Уровни доступа](/article/access-levels)). ## Подразделы | Подраздел | Назначение | Статья | | --- | --- | --- | | **Notifications** | Email-уведомления о событиях | [Уведомления](/article/notifications-settings) | | **Project groups** | Группы проектов для навигации | [Группы проектов](/article/project-groups) | | **Placeholders** | Форматы плейсхолдеров и их валидация | [Плейсхолдеры](/article/placeholders) | | **API** | API-ключи (accountId + токен) | [API-ключи](/article/api-keys) | | **Credentials** | Сохранённые креды интеграций | [API-ключи](/article/api-keys) | | **MT engine presets** | Пресеты MT-движков | [Пресеты MT-движков](/article/mt-engine-presets) | | **Smart translation profiles** | Профили умного перевода | [Профили умного перевода](/article/smart-translation-profiles) | | **User access levels** | Уровни доступа участников | [Уровни доступа](/article/access-levels) | | **File formats** | Правила разбора форматов файлов | [Форматы файлов](/article/file-formats) | | **Templates** | Шаблоны квот и счетов | [Шаблоны](/article/templates) | | **Custom fields** | Кастомные поля проектов/клиентов | [Кастомные поля](/article/custom-fields) | ## Права на изменения Изменения в Settings влияют на весь аккаунт: будьте аккуратны, особенно с форматами файлов и плейсхолдерами — они применяются к будущим загрузкам. ## Смежные настройки - **Реквизиты биллинга** — не в Settings, а в **Payments → Settings** ([Настройки биллинга](/article/billing-settings)). - **Справочники (directory)** — отрасли клиентов и прочие списки: [Справочники](/article/directory). --- # Уведомления ## Что настраивается **Settings → Notifications** — события аккаунта, о которых участники получают письма: - Назначение на задачу/документ. - Комментарии в редакторе ([Комментарии к сегментам](/article/comments)). - Изменение статуса проекта/документа (завершение, ревью). - Запросы на подтверждение задач (MyTeam-приглашения). - Готовность экспорта. ## Где менять 1. Откройте **Settings → Notifications**. 2. Включите/выключите нужные события. 3. Сохраните. Индивидуальные предпочтения участника также могут регулироваться в его профиле — аккаунтные настройки задают «базу». ## Callback vs email-уведомления Email — для людей. Для системных интеграций используются **Callback (вебхуки)**: платформа отправляет события на ваш URL (см. [Callback (вебхуки)](article/api-callbacks)). Настройки вебхуков через API: `GET/POST/DELETE /api/integration/v1/callback`, ошибки доставки — `GET /api/integration/v1/callback/lastErrors`. ## Не приходят письма Проверьте спам, добавьте домен отправителя в белый список, убедитесь, что событие включено в настройках. Подробнее — [FAQ: не приходят уведомления](/article/faq-email-notifications). --- # Плейсхолдеры: форматы и валидация ## Что такое плейсхолдер **Плейсхолдер** — подставляемое значение в тексте, которое нельзя переводить: `{username}`, `{{count}}`, `%s`, `bold` — в зависимости от вашего контента. ## Настройка форматов **Settings → Placeholders** определяет, какие конструкции платформа считает плейсхолдерами: 1. Посмотрите текущий набор форматов: `GET /api/integration/v1/placeholders`. 2. Добавьте/измените формат: `PUT /api/integration/v1/placeholders`. 3. Проверьте формат валидатором: `GET /api/integration/v1/placeholders/validate`. В интерфейсе то же самое: откройте **Settings → Placeholders**, добавьте правило (например, регулярное выражение для `{{...}}`), сохраните. ## Как это работает в редакторе - Распознанные плейсхолдеры выделяются значками и вставляются из панели — вручную набирать не нужно ([Теги и плейсхолдеры](/article/tags-placeholders)). - Валидация проверяет, что все плейсхолдеры исходника присутствуют в переводе. ## Рекомендации - Заведите все форматы, которые реально встречаются в ваших файлах (UI-строки, письма, шаблоны). - Не добавляйте слишком «широкие» правила — они могут захватить обычный текст как плейсхолдер. - После изменения форматов проверьте на тестовом файле. --- # Форматы файлов и правила разбора ## Что настраивается **Settings → File formats** — правила разбора поддерживаемых форматов: какие элементы файла считаются переводимым текстом, какие — нет. Типовые настройки: - **JSON** — какие ключи/пути переводить, какие пропускаются (например, `id`, `version`). - **XML/HTML** — какие элементы и атрибуты переводимые. - **CSV** — какая колонка исходная, какая целевая, разделитель, кодировка. - **Office** — обработка текстовых полей, колонтитулов, примечаний. Список поддерживаемых форматов аккаунта: `GET /api/integration/v1/directory/formats`; указанный справочник — `GET /api/integration/v1/directory`. ## Пресеты разбора Для нестандартных файлов создаются **пресеты алгоритма разбора** (см. [Пресеты разбора файлов](/article/disassembly-presets)): полный список методов — `FileDisassemblingAlgorithmPresets` в [Справочнике API](/api). ## Как проверить 1. Создайте тестовый проект с одним файлом нового формата. 2. Откройте редактор и проверьте сегментацию: ничего лишнего, ничего потерянного. 3. Подстройте правила и повторите. ## Важно Изменение правил разбора влияет на **новые** загрузки; уже разобранные документы не переразбираются. Для смены разбора существующего документа используйте замену файла или обратитесь в поддержку. --- # Пресеты разбора файлов ## Что такое пресет разбора **Пресет алгоритма разбора** (file disassembling algorithm preset) — сохранённый набор правил, по которым файл разбивается на сегменты: переводимые элементы, игнорируемые части, обработка форматирования. ## Когда нужен - Нестандартная структура JSON/XML (например, переводить только значения по определённым путям). - Специфические файлы с большим количеством «служебного» текста. - Требуется особая сегментация (разбиение по абзацам, а не предложениям). ## Управление пресетами | Действие | API | | --- | --- | | Список пресетов аккаунта | `GET /api/integration/v1/fileDisassemblingAlgorithmPresets` | | Создать пресет | `POST /api/integration/v1/fileDisassemblingAlgorithmPresets` | | Получить пресет | `GET /api/integration/v1/fileDisassemblingAlgorithmPresets/{id}` | | Обновить | `PUT /api/integration/v1/fileDisassemblingAlgorithmPresets/{id}` | | Удалить | `DELETE /api/integration/v1/fileDisassemblingAlgorithmPresets/{id}` | В интерфейсе пресеты доступны через **Settings → File formats** (см. [Форматы файлов и правила разбора](/article/file-formats)). ## Процесс создания 1. Прототип: создайте пресет на тестовом файле, добейтесь правильной сегментации. 2. Фиксация: назовите пресет понятно («Каталог товаров — xlsx, только колонка B»). 3. Применение: выбирайте пресет при загрузке файлов этого типа. --- # Шаблоны (квоты и счета) ## Что настраивается **Settings → Templates** (начиная с вкладки квот) — шаблоны исходящих документов: - **Шаблон квоты** — расчёт стоимости для клиента ([Квоты](/article/quotes)). - **Шаблон счёта** — счёт на оплату ([Счета](/article/invoices)). ## Что входит в шаблон - **Логотип и фирменный стиль**. - **Поля документа** — номер, дата, срок действия. - **Реквизиты** — берутся из биллинг-настроек ([Настройки биллинга](/article/billing-settings)). - **Формат расчёта** — как показываются услуги, уровни совпадений, скидки нет-рейтов ([Нет-рейты](/article/net-rates)). - **Текст письма** — сопроводительный текст при отправке клиенту. ## Как использовать 1. Настройте шаблон один раз для аккаунта. 2. Квоты и счета формируются по шаблону автоматически. 3. Файл квоты/расчёта скачивается клиенту (`GET /api/integration/v1/Quote/{id}/File`). ## Рекомендации - Покажите шаблон клиенту до первого отправления — формат расчётов должен быть понятен заказчику. - Разные схемы расчёта (по клиентам) решаются нет-рейтами, а не отдельными шаблонами. --- # Кастомные поля ## Зачем кастомные поля **Кастомные поля** — дополнительные атрибуты, которых нет в платформе «из коробки»: внутренний номер заказа в CRM, тип контента, канал поставки, ответственный отдел. ## Создание поля 1. Откройте **Settings → Custom fields**. 2. Создайте поле: название, тип (строка/число/список), к какой сущности относится (проект, клиент). 3. Сохраните — поле появится в карточках соответствующих сущностей. ## Где отображаются - **Карточка проекта** — заполняется менеджером ([Настройки проекта](/article/project-settings)). - **Карточка клиента** — дополнительные атрибуты заказчика ([Создание клиента](/article/client-create)). - Отчёты и фильтры — поля доступны для группировки данных (см. **Reports**). ## Типовые схемы | Поле | Тип | Назначение | | --- | --- | --- | | `CRM ID` | строка | Связь проекта с сделкой в CRM | | `Тип контента` | список | Маркетинг/документация/софт — для отчётности | | `Канал поставки` | список | Как получен материал (email, FTP, интеграция) | ## Рекомендации - Не плодите поля: каждое должно использоваться в процессах и отчётах. - Поля с фиксированным набором значений (список) надёжнее свободного текста. --- # API-ключи (Credentials) ## Что нужно для API Интеграционный API платформы авторизуется парой: - **accountId** — идентификатор аккаунта; - **API-токен** — секретный ключ доступа. ## Где получить 1. Откройте **Settings → API**. 2. Создайте API-ключ — платформа выдаст токен. 3. Скопируйте токен сразу: он показывается один раз. Аккаунт и токен хранятся также в **Settings → Credentials** — разделе сохранённых кредов для интеграций. ## Как использовать Заголовки запросов к API (см. [Аутентификация в API](/article/api-auth)): ```http Authorization: Basic base64(accountId:token) ``` Пример первого запроса — в статье [Первый запрос к API](/article/api-first-request). ## Безопасность - Токен — как пароль: не публикуйте в репозиториях, передавайте через секрет-хранилища. - **Отдельный токен на интеграцию** — так проще отозвать доступ одному сервису, не ломая остальные. - Отзыв ключа: удалите его в **Settings → API** — интеграция с этим ключом перестанет работать немедленно. ## При смене ключа Сначала создайте новый ключ и обновите интеграцию, затем отзывайте старый — иначе будет простой. Список всех методов — в [Справочнике API](/api); полный Swagger с моделями — app.plaia.ru/api/methods. --- # Профиль аккаунта и язык интерфейса ## Профиль аккаунта Данные аккаунта (название, тип) отражаются в рабочем пространстве: левое меню показывает имя аккаунта (например, LSP). Данные аккаунта доступны и через API: `GET /api/integration/v1/account` (см. [Первый запрос к API](/article/api-first-request)). ## Язык интерфейса Переключатель языка интерфейса — в правом нижнем углу платформы (значок **EN**). Интерфейс доступен на русском и английском. Выбор применяется к вашему пользователю, а не ко всему аккаунту. ## Личные настройки - **Уведомления** — частота писем по событиям ([Уведомления](/article/notifications-settings)). - **Горячие клавиши редактора** — раскладка не влияет на сочетания; список в редакторе ([Горячие клавиши](/article/hotkeys)). ## Разделение ролей аккаунта Не смешивайте личный доступ и API-ключи: API-ключ выдаётся на интеграцию и не должен использоваться как «личный логин» (см. [API-ключи](/article/api-keys)). ## Смена владельца аккаунта Передача владения (owner) — через поддержку: support@plaia.ru, с подтверждением от текущего и нового владельца. --- # Справочники (Client industries и другие) ## Что такое справочники **Справочники (directories)** — управляемые списки значений, используемые в карточках сущностей: отрасли клиентов (client industries), поддерживаемые форматы файлов и другие системные списки. ## Отрасли клиентов Отрасль клиента (retail, IT, медицина...) помогает группировать заказчиков и настраивать специализации исполнителей ([Услуги и специализации](/article/team-services)). Управление отраслями через API: | Действие | Метод | | --- | --- | | Все отрасли | `GET /api/integration/v1/clientIndustry` | | Одна отрасль | `GET /api/integration/v1/clientIndustry/{id}` | | Добавить | `POST /api/integration/v1/clientIndustry/{name}` | | Переименовать | `PUT /api/integration/v1/clientIndustry/{id}` | | Удалить | `DELETE /api/integration/v1/clientIndustry/{id}` | ## Форматы файлов `GET /api/integration/v1/directory/formats` — форматы разбора, поддерживаемые аккаунтом (см. [Форматы файлов](/article/file-formats)). ## Прочие справочники `GET /api/integration/v1/directory` — получение указанного справочника по имени. Доступные имена уточняйте в [Справочнике API](/api) или Swagger: app.plaia.ru/api/methods. ## Практика Справочники лучше задать до массового заведения клиентов и проектов: заполненные отрасли упростят фильтрацию и отчёты. --- # Обзор API платформы ## Что такое интеграционный API Интеграционный API платформы — REST-интерфейс, который позволяет автоматизировать все основные процессы: создание проектов и загрузку файлов, экспорт результатов, управление TM и глоссариями, клиентами, счетами и платежами. API спроектирован как полноценный аналог интерфейса — через него можно построить автоматическую локализацию «под ключ». ## Базовые сведения | Параметр | Значение | | --- | --- | | Базовый URL | `https://app.plaia.ru/api/integration/v1` (есть v2 и v3 для части методов) | | Формат | REST, JSON | | Авторизация | HTTP Basic: accountId + API-токен ([Аутентификация](/article/api-auth)) | | Swagger | [app.plaia.ru/api/methods](https://app.plaia.ru/api/methods/) | | Справочник на русском | [/api](/api) (эта справка) | ## Группы методов - **Account** — данные аккаунта, MT-движки. - **Project / Document / DocumentExport** — проекты, документы, экспорт. - **TranslationMemories / Glossary** — лингвистические активы. - **Client / ClientIndustry / Vendor / MyTeam** — заказчики, подрядчики, команда. - **Invoice / Quote / LspPrices / LspService** — биллинг. - **Callback** — вебхуки о событиях. - **Placeholders / Directories / FileDisassemblingAlgorithmPresets** — настройки. - **SmartTranslation** — прямой умный перевод. ## Версии Методы существуют в v1 и v2/v3: v2/v3 — обновлённые контракты (например, `project/list` v2 с пагинацией). Устаревшие (obsolete) методы помечены в Swagger — используйте новые версии. ## Что дальше - [Аутентификация в API](/article/api-auth) — как подписывать запросы. - [Первый запрос к API](/article/api-first-request) — hello-world за минуту. - [Проекты через API](/article/api-projects) — типовой сценарий автоматизации. --- # Аутентификация в API ## Учётные данные API использует **HTTP Basic Auth** с парой `accountId:API-токен`: - **accountId** — идентификатор аккаунта; - **API-токен** — ключ, созданный в **Settings → API** ([API-ключи](/article/api-keys)). ## Формат заголовка ```http Authorization: Basic ``` Пример: ```bash # login и password = accountId и API-токен соответственно curl -u "$ACCOUNT_ID:$API_TOKEN" \ https://app.plaia.ru/api/integration/v1/account ``` ## Проверка доступа Запрос `GET /api/integration/v1/account` возвращает данные аккаунта — если авторизация работает, вы получите JSON с параметрами аккаунта. ## Коды ответов | Код | Причина | | --- | --- | | 200/201 | Успех | | 401 | Неверные accountId/token | | 403 | Нет прав на действие | | 429 | Слишком много запросов (см. [Коды ошибок и ретраи](/article/api-errors)) | ## Безопасность 1. Не встраивайте токен в клиентский код — только серверная сторона. 2. Отдельный токен на интеграцию — легко отозвать ([API-ключи](/article/api-keys)). 3. HTTPS только; plaintext-передача токена запрещена. 4. Храните в секрет-хранилище (env-переменные, vault), не в репозитории. --- # Первый запрос к API ## Шаг 1. Получите ключи **Settings → API** → создайте ключ ([API-ключи](/article/api-keys)). У вас появятся `accountId` и `token`. ## Шаг 2. Запрос данных аккаунта ```bash curl -u "$ACCOUNT_ID:$API_TOKEN" \ https://app.plaia.ru/api/integration/v1/account ``` Успешный ответ — JSON с данными аккаунта (имя, параметры): ```json { "id": "a1b2c3d4-...", "name": "Моё агентство", "...": "..." } ``` ## Шаг 3. Список проектов ```bash curl -u "$ACCOUNT_ID:$API_TOKEN" \ "https://app.plaia.ru/api/integration/v2/project/list" ``` ## Другие языки - **Python**: `requests.get(url, auth=(account_id, token))` - **Node.js**: `fetch(url, { headers: { Authorization: 'Basic ' + Buffer.from(id+':'+token).toString('base64') } })` - **Go**: `req.SetBasicAuth(accountId, token)` ## Что читать дальше - Полный список методов: [/api](/api) или [Swagger](https://app.plaia.ru/api/methods/). - Типовой сценарий автоматизации: [Проекты через API](/article/api-projects). - Обработка ошибок: [Коды ошибок и ретраи](/article/api-errors). --- # Проекты через API ## Сценарий Автоматизация «получили файлы → запустили перевод → получили результат»: ### 1. Создать проект ```bash curl -u "$ACCOUNT_ID:$API_TOKEN" \ -H "Content-Type: application/json" \ -d '{"name":"Инструкция v2","sourceLanguage":"en","targetLanguages":["ru"]}' \ https://app.plaia.ru/api/integration/v1/project/create ``` Модель запроса (обязательные поля, опции) — в Swagger: `POST /api/integration/v1/project/create`. ### 2. Добавить документ ```bash curl -u "$ACCOUNT_ID:$API_TOKEN" \ -F "file=@document.docx" \ https://app.plaia.ru/api/integration/v1/project/document?projectId= ``` ### 3. Подключить активы (если нужно) - TM: `POST /api/integration/v1/project/{projectId}/translationmemories` - Глоссарии: `PUT /api/integration/v1/project/{projectId}/glossaries` - MT: `POST /api/integration/v1/project/{projectId}/mt` ### 4. Назначить исполнителей - Ручное: `POST /api/integration/v1/document/assign` - Автоматическое: `POST /api/integration/v1/project/{projectId}/assign` - Блоки по словам: `POST /api/integration/v1/document/assignFreelancers` ### 5. Отследить готовность - Статистика: `GET /api/integration/v2/project/{projectId}/statistics` - Статус проекта: `GET /api/integration/v1/project/{projectId}` ### 6. Экспортировать ```bash # Создать задачу экспорта curl -u "$ACCOUNT_ID:$API_TOKEN" \ -H "Content-Type: application/json" \ -d '{"documentIds":[""]}' \ https://app.plaia.ru/api/integration/v1/document/export # Скачать по taskId curl -u "$ACCOUNT_ID:$API_TOKEN" \ https://app.plaia.ru/api/integration/v1/document/export/ ``` ## Вебхуки Чтобы не опрашивать статусы, подключите callback ([Callback (вебхуки)](/article/api-callbacks)) — платформа сама уведомит о событиях. --- # Документы и экспорт через API ## Методы документов | Метод | Назначение | | --- | --- | | `GET /api/integration/v1/document` | Данные документа | | `PUT /api/integration/v1/document/update` | Обновить документ | | `PUT /api/integration/v1/document/rename` | Переименовать | | `DELETE /api/integration/v1/document` | Удалить документ(ы) | | `GET /api/integration/v1/document/statistics` | Статистика документа | | `POST /api/integration/v1/document/complete` | Завершить документ | ## Импорт переводов - `PUT /api/integration/v1/document/translate` — импортировать переводы из файла перевода. - `PUT /api/integration/v1/document/translateWithXliff` — импорт из XLIFF (перевод делался вне платформы). - Статус импорта: `GET /api/integration/v1/document/translate/status`; детальный отчёт: `GET /api/integration/v1/document/translate/result`. Такие методы нужны при гибридных процессах: XLIFF уходит во внешний инструмент, возвращается с переводами. ## Экспорт 1. `POST /api/integration/v1/document/export` — создать задачу экспорта (указать документы и параметры). 2. `GET /api/integration/v1/document/export/{taskId}` — скачать результат по готовности. Экспорт асинхронный:taskId проверяется повторно до готовности. При 409/202 — задача ещё выполняется ([Коды ошибок](/article/api-errors)). ## Назначения и этапы - `POST /api/integration/v1/document/assign` — модель назначения лингвистов. - `POST /api/integration/v1/document/assignVendors` — вендор на этап. - `POST /api/integration/v1/document/setStageUnitCount` — объём этапа. - `POST /api/integration/v1/document/assignFromMyTeam` — приглашения MyTeam. Полный список — [/api](/api). --- # TM и глоссарии через API ## Translation Memories | Метод | Назначение | | --- | --- | | `POST /api/integration/v1/translationmemory` | Создать пустую TM | | `GET /api/integration/v1/translationmemory` | Список TM (с фильтрами) | | `GET /api/integration/v1/translationmemory/{tmId}` | Информация о TM | | `PUT /api/integration/v1/translationmemory/{tmId}/targets` | Добавить целевые языки | | `POST /api/integration/v1/translationmemory/{tmId}` | Импорт TMX-файлов | | `GET /api/integration/v1/translationmemory/task` | Статус задач импорта | | `DELETE /api/integration/v1/translationmemory/task/{taskId}` | Отменить задачу | | `GET /api/integration/v1/translationmemory/{tmId}/file` | Экспорт TMX | | `POST /api/integration/v1/translationmemory/matches` | Получить совпадения | | `DELETE /api/integration/v1/translationmemory/{tmId}` | Удалить TM | Импорт TMX — фоновая задача: отправьте файлы, затем опрашивайте `task` до завершения. ## Глоссарии | Метод | Назначение | | --- | --- | | `GET /api/integration/v1/glossaries` | Список глоссариев аккаунта | | `POST /api/integration/v1/glossary/import` | Задача импорта концептов | | `GET /api/integration/v1/glossary/importTaskState/{taskId}` | Статус импорта | Подключение к проекту: - `GET/POST /api/integration/v1/project/{projectId}/translationmemories` — TM проекта; - `GET/PUT /api/integration/v1/project/{projectId}/glossaries` — глоссарии проекта; - `GET/POST /api/integration/v1/project/{projectId}/mt` — MT-конфигурация. Сценарии интеграции с TM — в статье [Проекты через API](/article/api-projects). --- # Счета и платежи через API ## Платежи исполнителям ```bash curl -u "$ACCOUNT_ID:$API_TOKEN" \ -H "Content-Type: application/json" \ -d '{"jobId":"","units":{"words":1500},"price":18.5}' \ https://app.plaia.ru/api/integration/v2/invoice/job ``` Точная модель запроса — в Swagger (`POST /api/integration/v2/invoice/job`). Массовые платежи: `POST /api/integration/v2/invoice/jobs`. ## Поиск платежей | Метод | Фильтр | | --- | --- | | `GET /api/integration/v1/invoice/job/list` | По ID | | `GET /api/integration/v2/invoice/job/listByExternalId` | По внешнему ID | | `GET /api/integration/v2/invoice/job/listByCreatedDate` | По дате создания | | `GET /api/integration/v2/invoice/list` | Счета за период | | `GET /api/integration/v2/client-agent-invoice/list` | Агентские счета | **externalId** — ваш ключ идемпотентности: передавайте его при создании платежа и находите платежи позже без дублирования. ## Квоты | Метод | Назначение | | --- | --- | | `GET /api/integration/v1/Quote/{projectId}` | Квота проекта | | `GET /api/integration/v1/Quote/List` | Все квоты аккаунта | | `GET /api/integration/v1/Quote/ByVendor/{projectId}` | Квота вендора | | `PUT /api/integration/v1/Quote/Update` | Обновить квоту | | `POST /api/integration/v1/Quote/{id}/Approve` | Согласовать | | `POST /api/integration/v1/Quote/{id}/MarkAsPaid` | Отметить оплату | ## Прайсы и услуги Цены услуг LSP: `/api/integration/v2/lsp/prices` (+ `/batch`), услуги: `/api/integration/v2/lsp/services` (+ `/batch`) — см. [Как считается стоимость](/article/pricing-model). --- # Callback (вебхуки) ## Что такое callback **Callback** — URL вашей системы, на который платформа отправляет уведомления о событиях: изменение статуса проекта/документа, готовность экспорта, завершение задач. Так вы не опрашиваете API, а реагируете на события. ## Настройка | Метод | Назначение | | --- | --- | | `POST /api/integration/v1/callback` | Создать/обновить настройки уведомлений | | `GET /api/integration/v1/callback` | Посмотреть текущие настройки | | `DELETE /api/integration/v1/callback` | Удалить настройки | | `GET /api/integration/v1/callback/lastErrors` | Последние ошибки доставки | В настройках указывается URL обработчика и набор событий. Обработчик должен отвечать 2xx быстро; при ошибках доставки платформа накапливает их в `lastErrors`. ## Рекомендации обработчику 1. **Идемпотентность** — событие может прийти повторно; различайте по ID события/объекта. 2. **Быстрый ответ** — возвращайте 200 сразу, тяжёлую обработку делайте асинхронно (очередь). 3. **Логирование** — сохраняйте тела событий для отладки. 4. **Валидация** — проверяйте подпись/источник, если используется. ## Типовой сценарий «Экспорт готов» → ваш обработчик скачивает файл (`GET /api/integration/v1/document/export/{taskId}`) и кладёт в ваше хранилище. Список поддерживаемых событий — в Swagger-модели настроек callback ([app.plaia.ru/api/methods](https://app.plaia.ru/api/methods/)). --- # Коды ошибок и ретраи ## HTTP-коды | Код | Значение | Что делать | | --- | --- | --- | | 200/201 | Успех | — | | 400 | Некорректный запрос | Проверить тело/параметры по Swagger | | 401 | Ошибка авторизации | Проверить accountId/token ([Аутентификация](/article/api-auth)) | | 403 | Нет прав | Проверить ключ и роль | | 404 | Объект не найден | Проверить ID | | 409/202 | Асинхронная задача ещё выполняется | Повторить запрос позже | | 429 | Rate limit | Экспоненциальный бэкофф | | 500/502/503/504 | Сбой платформы | Ретрай с бэкоффом | ## Ретраи Ретраить безопасно: **GET**, а также POST, если вы используете идемпотентный внешний ID (например, `externalId` в платежах). Рекомендуемая схема: - задержки 3с → 10с → 30с → 60с (до 5–7 попыток); - ретраить 429, 500, 502, 503, 504 и таймауты; - не ретраить 400/401/403/404 — это ошибки интеграции. ```js const delays = [3000, 10000, 30000, 60000]; ``` Платформа периодически отвечает 500 «Error processing request» короткими «плохими фазами» — ретраи с бэкоффом переживают большинство из них. ## requestId При обращении в поддержку по проблеме API прикладывайте accountId, метод, код ответа и requestId из заголовков ответа — так инженеры найдут запрос в логах. ## Rate limits При 429 снижайте параллелизм запросов. Массовые операции (много документов) делайте последовательно или используйте batch-методы (lsp/prices/batch, lsp/services/batch). --- # Полный справочник методов API ## Два справочника 1. **[/api](/api) в этой справке** — все методы на русском: HTTP-метод, путь, описание. Лучший вход для быстрого поиска «как называется метод для…». 2. **[Swagger app.plaia.ru/api/methods](https://app.plaia.ru/api/methods/)** — оригинальный OpenAPI-справочник: модели запросов/ответов, параметры, «Try it out» прямо в браузере. ## Как искать метод - По объекту: проект → `Project`, документ → `Document`, память → `TranslationMemories`. - По действию: экспорт → `DocumentExport`, платежи → `Invoice`, уведомления → `Callback`. - На русском: страница [/api](/api) сгруппирована по тем же именам групп, что в Swagger. ## Версии и устаревшие методы - Методы v1 стабильны; v2/v3 — обновлённые контракты. - Помеченные «obsolete» (например, `v1/project/list`) заменены новыми версиями — используйте актуальные (`v2/project/list`). ## MCP Если вы AI-ассистент: справочник API доступен инструментом `get_api_reference` MCP-сервера справки ([MCP-эндпоинт хэлпцентра](/article/mcp-endpoint)). --- # MCP-эндпоинт хэлпцентра ## Что это Справочный центр опубликован как **MCP-сервер** (Model Context Protocol, Streamable HTTP): AI-ассистенты — Claude, ZCode и совместимые клиенты — могут отвечать на вопросы о платформе по официальной документации. ## Подключение ```text URL: https://help.mcp.plaia.ru/mcp Транспорт: Streamable HTTP (JSON-RPC POST) Авторизация: Basic Auth (логин и пароль выдаёт администратор) ``` Пример конфигурации клиента: ```json { "mcpServers": { "plaia-help": { "url": "https://help.mcp.plaia.ru/mcp", "headers": { "Authorization": "Basic " } } } } ``` ## Инструменты | Инструмент | Назначение | | --- | --- | | `search_help` | Поиск по всем статьям справки | | `list_categories` | Разделы справки | | `list_articles` | Статьи раздела или все | | `get_article` | Полный текст статьи (Markdown) | | `get_api_reference` | Справочник методов API платформы | | `get_support_info` | Контакты поддержки | Ресурсы: `help://article/{slug}`, `help://category/{id}`. ## Для кого это полезно - **Поддержка и PM** — ассистент мгновенно находит нужную статью и ссылку. - **Разработчики** — ассистент отвечает по API-справочнику с путями методов. - **Новые сотрудники** — «как сделать X» по официальной документации. ## Альтернативы без MCP - [llms.txt](/llms.txt) и [llms-full.txt](/llms-full.txt) — для LLM-краулеров. - Markdown каждой статьи: `/md/{slug}.md` (см. [Справка для AI-ассистентов](/help-for-ai)). Логин/пароль Basic Auth для /mcp — у администратора платформы. --- # Интеграции: обзор ## Варианты интеграции 1. **REST API** — любые сценарии: автоматическая загрузка контента, экспорт, синхронизация статусов (см. [Обзор API](/article/api-overview)). 2. **Callback (вебхуки)** — события платформы в вашу систему ([Callback](/article/api-callbacks)). 3. **XLIFF-обмен** — работа с внешними CAT-инструментами ([Документы через API](/article/api-documents)). 4. **Готовые сервисы** — например, автоматический перевод Git-репозиториев (git-pt) — уточняйте доступные коннекторы у поддержки. ## Типовые схемы ### Автолокализация контент-проекта ``` CMS/Git → API: project/create + document upload → Prettranslate (TM + MT) → Команда работает в редакторе → callback: экспорт готов → API: download export → обратно в CMS/Git ``` ### Синхронизация клиентов и платежей ``` CRM → client/create (идемпотентно по имени) → project с привязкой клиента → quote → invoice → платежи (externalId) ``` ### Внутренний сервис перевода Сервис на вашем бэкенде использует API от лица аккаунта: проверка доступных MT-движков (`account/mtengines`), умный перевод (`smartTranslation/translate`), ведение проектов. ## Рекомендации - Отдельный API-ключ на каждую интеграцию ([API-ключи](/article/api-keys)). - Идемпотентность внешними ID и ретраи с бэкоффом ([Коды ошибок и ретраи](/article/api-errors)). - Логи всех запросов/ответов — упростят отладку и обращения в поддержку. Нужен коннектор под вашу систему — напишите в support@plaia.ru, опишите систему и желаемый сценарий. --- # FAQ: файл не загружается ## Файл не выбирается/не загружается - **Формат не поддерживается** — проверьте список ([Поддерживаемые форматы](/article/supported-formats)); неподдерживаемые конвертируйте в docx/xlsx/TXT. - **Размер файла** — очень большие файлы (сотни МБ) лучше разбить на части или упаковать содержимое. - **Защита паролем** — снимите пароль/шифрование с документа перед загрузкой. - **Повреждённый файл** — откройте локально и пересохраните (docx → docx), затем загрузите заново. ## Файл загрузился, но «пустой» в редакторе - Весь текст оказался в непереводимых элементах — настройте правила разбора ([Форматы файлов](/article/file-formats)). - Текст внутри картинок не извлекается: OCR для PDF не всегда решает — распознайте PDF заранее или обратитесь в поддержку. ## Текст разбился на неправильные сегменты - Подстройте правила/создайте пресет разбора ([Пресеты разбора](/article/disassembly-presets)). - Проверьте плейсхолдеры: «мусорные» конструкции размывают сегментацию ([Плейсхолдеры](/article/placeholders)). ## Замена файла без потери переводов Перезагрузка файла поверх документа не поддерживается напрямую. Варианты: 1. Добавьте новый документ в проект и переведите через TM — совпадения закроют повторяющийся текст. 2. Импортируйте готовый перевод: `PUT /api/integration/v1/document/translate` (см. [Документы через API](/article/api-documents)). ## Если ничего не помогло Напишите в support@plaia.ru: приложите файл (или аналогичный по структуре), проект, языковую пару и скриншот ошибки ([Как обратиться в поддержку](/article/faq-contact-support)). --- # FAQ: MT не выдаёт перевод ## Чек-лист 1. **MT подключён к проекту?** Проверьте MT-конфигурацию проекта ([Подключение MT к проекту](/article/mt-in-project)); через API — `GET /api/integration/v1/project/{projectId}/mt`. 2. **Движок доступен аккаунту?** `GET /api/integration/v1/account/mtengines` ([Доступные движки](/article/mt-engines)). 3. **Баланс Smartwords положительный?** Проверьте **Productivity services** ([Smartwords](/article/smartwords)); при нуле MT приостанавливается. 4. **Сегмент уже покрыт TM?** 100% совпадения подставляются без MT — MT появится только для остальных ([Порядок приоритета](/article/mt-overview)). 5. **Претранслейт ещё идёт?** Статус проекта Pretranslated = обработка в процессе; подождите и обновите страницу ([Статусы](/article/project-statuses)). ## MT был, но перестал появляться - Баланс исчерпан ([Smartwords: баланс и пополнение](/article/smartwords)). - Движок/пресет удалён из конфигурации проекта. - Профиль умного перевода исключает такие сегменты ([Профили умного перевода](/article/smart-translation-profiles)). ## MT-перевод плохого качества - Подключите глоссарий и профиль умного перевода ([Как улучшить качество MT](/article/ai-translation-tips)). - Смените движок на более подходящий для контента. ## Ошибки API при MT Ошибка 500 при `smartTranslation/translate` или `project/mt` — ретрай с бэкоффом ([Коды ошибок и ретраи](/article/api-errors)); при повторении — в поддержку с requestId. --- # FAQ: не приходят уведомления ## Быстрые проверки 1. **Спам/карантин** — посмотрите в спаме и добавьте домен отправителя в белый список. 2. **Событие включено?** **Settings → Notifications** — проверьте, что событие включено ([Уведомления](/article/notifications-settings)). 3. **Email правильный?** Проверьте адрес в профиле участника. 4. **Присходит ли событие?** Например, комментарий должен быть отправлен, а не просто набран. ## Приглашение в аккаунт не пришло - Отправьте повторно ([Добавление участников](/article/invite-members)). - Убедитесь, что email без опечаток и домен получателя принимает письма (проверьте у администратора почты). ## Уведомления приходят слишком часто/редко Настройте набор событий в **Settings → Notifications**; часть событий может регулироваться индивидуально в профиле. ## Вебхуки вместо email Если уведомления нужны системе (не человеку) — используйте callback ([Callback (вебхуки)](/article/api-callbacks)) и проверьте ошибки доставки: `GET /api/integration/v1/callback/lastErrors`. ## Всё включено, но писем нет больше часа Напишите в support@plaia.ru: укажите аккаунт, событие, точное время ожидаемого письма — инженеры проверят журнал отправки ([Как обратиться в поддержку](/article/faq-contact-support)). --- # FAQ: экспорт завис или отдаёт ошибку ## В интерфейсе 1. Обновите страницу — статус задачи мог уже смениться. 2. Проверьте размер: экспорт сотен больших файлов занимает время; экспортируйте пакетами. 3. Проверьте документ: неподтверждённые сегменты не блокируют экспорт, но ошибка валидации тегов может ([Теги и плейсхолдеры](/article/tags-placeholders)). ## Через API 1. `POST /api/integration/v1/document/export` вернул taskId — скачивайте `GET /api/integration/v1/document/export/{taskId}`. 2. Ответ 409/202 — задача ещё выполняется, повторите позже (пауза 5–10 секунд). 3. Ответ 404 на taskId — задача устарела/отменена; создайте экспорт заново. 4. 500 — ретрай с бэкоффом ([Коды ошибок и ретраи](/article/api-errors)). ## Документ «застрял» в статусе Если документ висит в In progress/Manager review, а экспорт нужен срочно — завершите документ: **Document → Complete** или `POST /api/integration/v1/document/complete` ([Статусы](/article/project-statuses)). ## Пустой файл в результате - Проверьте целевой язык документа: экспорт по правильному языку? - В настройках экспорта могут быть фильтры (только подтверждённые) — проверьте параметры задачи. ## Поддержка Приложите: projectName, taskId, время, requestId из заголовков. Скриншот статуса задачи помогает ([Как обратиться в поддержку](/article/faq-contact-support)). --- # FAQ: проблемы с платежами ## Платёж исполнителю не формируется 1. Задача подтверждена исполнителем? Платёж создаётся по подтверждённой работе ([Оплата исполнителей](/article/supplier-payments)). 2. Цена услуги задана для языковой пары? Проверьте прайсы ([Как считается стоимость](/article/pricing-model)). 3. Через API: используйте `externalId`, чтобы избежать дублей, и ищите платежи `listByExternalId` ([Счета и платежи через API](/article/api-invoices)). ## Суммы расходятся с ожиданиями - Сверьте статистику: слова по уровням совпадений ([Статистика проекта](/article/project-statistics)). - Проверьте нет-рейт клиента: скидки меняют суммы ([Нет-рейты](/article/net-rates)). - Проверьте валюту и минимальную стоимость в ценах. ## Smartwords списываются «слишком быстро» - MT обрабатывает сегменты без TM — подключите/наполните TM ([Совпадения TM](/article/tm-matching)). - Повторные MT-запросы одного сегмента списывают снова ([MT в редакторе](/article/mt-suggestions)). - Проверьте, какие проекты используют MT ([Подключение MT к проекту](/article/mt-in-project)). - Детализация — в **Reports** и у поддержки по запросу. ## Баланс отрицательный Пополните Smartwords ([Smartwords: баланс и пополнение](/article/smartwords)); до пополнения MT приостановлен. ## Возврат/спор Напишите в support@plaia.ru: период, проект, суммы и основание — обращения по биллингу рассматриваются в приоритете. --- # FAQ: TM не находит совпадения ## Чек-лист 1. **TM подключена к проекту?** Проверьте список TM проекта ([Подключение TM к проекту](/article/tm-in-project)). 2. **Языки совпадают?** Направление TM должно включать целевой язык проекта (`en → ru` ≠ `en → ru-RU` без добавления локали) ([Создание и настройка TM](/article/tm-create)). 3. **TM не пустая?** Проверьте содержимое в [TM Editor](/article/tm-editor) или Global Search ([Глобальный поиск](/article/global-search)). 4. **Импорт завершён?** Задача импорта TMX должна завершиться ([Импорт и экспорт TMX](/article/tm-import-export)). 5. **Совпадение ниже порога подстановки?** Низкие fuzzy не подставляются — это нормально. ## Совпадения есть, но не подставляются - Порог подстановки/претранслейта исключает слабые совпадения — подставьте вручную из панели TM. - Сегмент с тегами: различия в тегах снижают процент ([Как считаются совпадения](/article/tm-matching)). ## Переводы не сохраняются в TM - TM должна быть **пишущей** ([Создание и настройка TM](/article/tm-create)). - Сегмент должен быть **подтверждён** ([Сегменты](/article/segments)). ## Двойные/конфликтующие совпадения В проекте несколько TM с разными переводами одного сегмента — платформа ранжирует, но шум остаётся. Оставьте одну эталонную TM или почистите базы ([TM Editor](/article/tm-editor)). --- # FAQ: нет доступа к разделу ## Диагностика 1. **Какая роль у пользователя?** Проверьте в **Team → Team members** карточку участника ([Уровни доступа](/article/access-levels)). 2. **Уровень доступа включает раздел?** Например, Payments виден только биллинговым ролям ([Роли](/article/roles)). 3. **Документ назначен пользователю?** Лингвист видит только назначенные документы ([Назначение исполнителей](/article/assign-linguists)). 4. **Проект приватный?** Если используется ограничение по менеджерам проекта, пользователь должен быть в списке менеджеров. ## Пользователь — клиент Клиентские аккаунты видят только свои заказы: квоты и результаты. Если клиенту нужно больше — обсудите расширение доступа с администратором. ## API 403 Ошибка 403 через API — ключ существует, но не имеет прав на действие, либо аккаунт не позволяет операцию. Проверьте ключ и роль, от которой он выдан ([API-ключи](/article/api-keys)). ## Кто может менять права Только административные роли: запросите изменение у администратора аккаунта. Изменение применяется сразу ([Уровни доступа](/article/access-levels)). ## Доступ всё равно не появился Перезаходите в платформу (перелогин). Не помогло — в поддержку: аккаунт, пользователь, раздел, скриншот. --- # FAQ: как правильно обратиться в поддержку ## Куда писать - **support@plaia.ru** — основной канал; письмо автоматически регистрируется в системе поддержки. - **Чат поддержки** — значок в левом нижнем углу платформы, для быстрых вопросов. ## Шаблон обращения ```text Тема: [Краткое описание проблемы] — [аккаунт] Аккаунт: <название аккаунта / app.plaia.ru> Пользователь: Дата и время: <с указанием часового пояса> Что делали: 1. ... 2. ... Ожидали: ... Получили: ... Детали: - проект: <название/ID> - документ: <имя> - языковая пара: - скриншоты: <приложены> Для API: accountId, метод , код ответа <...>, requestId <из заголовков> ``` ## Что ускоряет решение - **Скриншот ошибки** целиком (с URL, если это браузер). - **requestId** для проблем API ([Коды ошибок](/article/api-errors)). - **Файл-пример** для проблем разбора (аналогичный по структуре, без конфиденциального содержимого). - **Последовательность шагов** — воспроизводимая проблема решается быстрее. ## Приоритеты Срочные инциденты (нельзя работать, блокирует команду) помечайте в теме словами «срочно»/«блокирующая» — обращение попадёт в приоритетную очередь. Не дублируйте обращения в разных каналах — берите один и ведите переписку в нём.