Overview 1 мин. чтения

Интеграции в PaperOffice AI: полное руководство

Обзор: какое подключение подходит

  • Платформы автоматизации, такие как n8n, Make и Zapier: через REST API с ключом API и через вебхуки. n8n также может использовать сервер MCP PaperOffice.
  • ERP-системы и системы бухгалтерского учета: готовые подключения для Holded и JTL-Wawi дублируют заказы, счета-фактуры и цены как операционный источник.
  • Перевозчики: готовые подключения для GLS, DB Schenker и DHL получают статус отправления.
  • Сервисы данных: проверка НДС-идентификатора, курсы валют, геокодирование и карты, в приложении и через API.

Операционные источники являются частью Knowledge Base AI, которая доступна с плана Plus. Ваш чат или телефонный агент передает данные клиента, такие как статус заказа, только после того, как клиент подтвердил свою личность.

n8n, Make и Zapier

Вы используете стандартные блоки этих инструментов: HTTP-запросы к REST API и вебхуки.

  1. Создайте ключ на странице API-ключи и введите его в узел HTTP как токен Bearer.
  2. Вызовите REST API, например, для загрузки или поиска. Конечные точки находятся в Документация API.
  3. Чтобы получить результаты, откройте Workflow AI → Workflow Agents, отредактируйте сохраненного агента и выберите вкладку Вебхуки.
  4. Нажмите Добавить цель вебхука и введите адрес вебхука из n8n, Make или Zapier в качестве Целевой URL.
  5. В разделе Отправлять при выберите Запуск успешно завершен, Запуск завершился ошибкой или оба варианта.
  • Для проверки человеком ваш поток создает задачу на проверку и ожидает вебхук. Событие task.completed сообщает о решении.
  • Вебхуки из PaperOffice подписываются в заголовке X-PaperOffice-Signature. Проверьте подпись в вашем потоке.
  • Плейсхолдеры, такие как {trigger.pofid}, разрешены в пути, запросе и заголовках, но не в имени хоста.
  • Цели вебхуков в агентах рабочего процесса доступны с плана Professional. Каждая успешная доставка вебхука оплачивается, и вызовы API также оплачиваются.

Holded

PaperOffice считывает заказы на продажу с контактными данными, счета-фактуры, кредит-ноты и товары из Holded и дублирует их как операционный источник. Эта копия доступна только для чтения. В Holded отправляются только вложения, с отдельным согласием и отдельным ключом с правами на запись.

  1. Откройте Knowledge Base AI → Операционные источники и нажмите Добавить источник. Выберите Holded в качестве подключения.
  2. На вкладке Подключение введите ваш ключ API Holded.
  3. Необязательно: выберите рабочее пространство для документов и отметьте счета-фактуры, кредит-ноты или заказы на продажу. Архивирование PDF охватывает только новые документы после сохранения.
  4. Необязательно: включите отправку вложений в Holded (платно) и введите ключ API Holded с правами на запись.
  5. На вкладке Доказательство выберите, как клиенты подтверждают свою личность, и сохраните.

Чтобы прикрепить документ, откройте его, нажмите Прикрепить в Holded и подтвердите цель. PaperOffice находит цель по номеру документа; при нескольких совпадениях или их отсутствии ничего не отправляется. Файлы могут быть размером до 10 МБ, и прикрепленные документы не отправляются повторно. Считывание, архивирование и прикрепление являются платными.

JTL-Wawi

PaperOffice считывает заказы, накладные с номерами отслеживания и товары с ценами из JTL-Wawi через официальный API JTL. Подключение доступно только для чтения; в JTL-Wawi ничего не изменяется.

  1. Откройте Knowledge Base AI → Операционные источники, нажмите Добавить источник и выберите JTL-Wawi в качестве подключения.
  2. На вкладке Подключение выберите JTL Cloud или JTL-Wawi, установленную локально. Для JTL Cloud введите идентификатор арендатора; для локальной установки — адрес HTTPS и ключ API из регистрации приложения.
  3. Введите реальный номер заказа для предварительного просмотра и выберите способ подтверждения на вкладке Доказательство.
  4. На вкладке Предпросмотр нажмите Предварительный просмотр без сохранения, затем сохраните и запустите первую синхронизацию с помощью кнопки Синхронизировать сейчас.

Для локальной установки JTL-Wawi требуется публичный адрес HTTPS на стандартном порту 443; внутренние адреса и HTTP заблокированы. Пожалуйста, проверьте у службы поддержки, включена ли уже JTL Cloud для вашего аккаунта. После трех неудачных попыток получения данных подряд источник автоматически приостанавливается. Получение данных является платной услугой.

Отслеживание отправлений с помощью GLS, DB Schenker и DHL

Когда клиенты спрашивают «Где моя посылка?», PaperOffice получает статус отправления из GLS, DB Schenker или DHL. Вам потребуются ваши собственные учетные данные у перевозчика.

  1. Откройте Knowledge Base AI → Операционные источники, нажмите Добавить источник и выберите тип GLS (фаза 2), Schenker (фаза 2) или DHL.
  2. На вкладке Подключение введите свои учетные данные: для GLS — адрес ShipIT, имя пользователя и пароль; для DB Schenker — ключ доступа; для DHL — ключ API.
  3. Введите реальный номер отслеживания для предварительного просмотра, выберите способ подтверждения, проверьте предварительный просмотр и сохраните.
  4. На вкладке Синхронизация нажмите Синхронизировать сейчас.

Последующие синхронизации самостоятельно считывают существующие номера отслеживания. Сообщения о статусе клиентам по SMS или электронной почте отправляются только при реальном изменении статуса и только если вы включите их на вкладке Сообщения; по умолчанию эта функция отключена. Отправка SMS является платной услугой.

Сервисы данных: идентификационный номер НДС, курсы валют, геокодирование и карты

PaperOffice предлагает четыре сервиса данных: проверка идентификационных номеров НДС против системы VIES ЕС, курсы валют с конвертацией, геокодирование и карты. Вы можете попробовать их в приложении в разделе Data AI Playground, который доступен во всех тарифных планах, и использовать их в своих системах через REST API или MCP-коннектор. Запросы к API являются платными.

  • Идентификационный номер НДС: проверка выполняется против VIES, а через API также партиями до 100 номеров. Также доступны ставки НДС для 27 стран ЕС.
  • С AI-DMS Ultra PaperOffice автоматически проверяет идентификационный номер НДС поставщика против VIES для каждого документа. Эта функция является платной.
  • Геокодирование: адрес в координаты, координаты в адрес и подсказки по адресам; через API также партиями до 1000 адресов.
  • Карты: в разделе Analytics AI → Карта отправителей вы видите отправителей ваших документов на карте после того, как AI-DMS обработает их. Analytics AI доступен в тарифном плане Corporate.

Часто задаваемые вопросы

  • Есть ли готовый узел для n8n? Вы подключаете n8n через HTTP-запросы, вебхуки или его MCP-клиент.
  • Изменяет ли PaperOffice данные в Holded или JTL-Wawi? JTL-Wawi работает только для чтения. В Holded отправляются только вложения, и только если вы включите эту функцию с помощью отдельного ключа.
  • Видят ли мои клиенты статус своего заказа без подтверждения? Нет. Агент передает данные клиента только после подтверждения личности.
  • Какие перевозчики поддерживаются? Готовые подключения в настоящее время существуют для GLS, DB Schenker и DHL.
  • Могу ли я проверить много идентификационных номеров НДС одновременно? Да, через API партиями до 100 номеров.