Обзор подготовил Антон Литвинов, основатель Lytvynov Production. Факты о KeyCRM взяты из их справки и OpenAPI-документации, о Новой почте из живых запросов к API, всё проверено 19.11.2026.

Сначала о том, что касается вашего времени. KeyCRM сама умеет создавать накладные Новой почты и подтягивать статусы доставки. Если ваши заказы устроены стандартно, интеграция уже работает, и n8n вам не нужен. Эта страница о другом: что делать, когда заказы нестандартные, когда после создания ТТН должно случиться что-то своё, и как собрать это в n8n или Make так, чтобы оно не ломалось.

В конце есть готовый сценарий для импорта в n8n. Мы импортировали его в n8n 2.47.7 и прогнали код узлов на тестовых данных, но с боевыми ключами не запускали, поэтому перед запуском прогоните его на тестовых заказах. Что именно проверено, а что нет, описано в разделе о проверке.

Что KeyCRM уже умеет сама

Справка KeyCRM описывает создание ТТН Новой почты прямо в заказе. Кнопка в один клик работает, когда выполнены три условия: адрес получателя сохранён как склад, у товара в каталоге заданы габариты, а администратор настроил автозаполнение поля «Описание отправления» в интеграции. Тогда KeyCRM сама берёт отправителя из настроек службы доставки, получателя и телефон из заказа, объявленную стоимость из суммы заказа, а наложенный платёж включает, если заказ не оплачен или оплачен частично. После создания в заказе появляется трек-код.

Статусы тоже приходят без вашего участия. В настройках доставки есть правила переключения статусов: вы сопоставляете статус доставки со статусом заказа, и заказ движется по воронке сам. Статус «Возвращено» от Новой почты KeyCRM тоже получает. По справке, есть два предела. Если у Новой почты включён контроль оплаты, статус «Доставлено, деньги получены» до KeyCRM не доходит, и заказ переходит сразу в «Доставлено». А статус оплаты наложенного платежа правилами доставки не меняется, для этого нужны триггеры автоматизации.

Поэтому прежде чем что-то строить, проверьте, действительно ли вам нужна своя автоматизация. Вот ситуации, в которых готовой интеграции уже не хватает:

  • заказы приходят с адресом «двери», а не со складом, или склад вообще не выбран;
  • в заказе несколько товаров: для одного товара габариты берутся из шаблона, для нескольких KeyCRM суммирует только вес, и габариты вводят руками;
  • ТТН нужно создавать по вашему правилу, например только для оплаченных заказов из определённого источника, или сразу пачкой вечером;
  • клиенту и менеджерам нужно слать сообщения в Telegram или Viber на определённых статусах доставки, а не только менять статус в CRM;
  • в процессе есть что-то ещё: списание со склада в другой системе, запись в таблицу бухгалтера, вызов курьера;
  • вам нужен контроль сбоев: кто-то должен узнать, что накладная не создана, раньше клиента.

Если узнали себя хотя бы в одном пункте, читайте дальше. Если ни в одном, настройте интеграцию KeyCRM и сэкономьте деньги. Мы так и советуем клиентам, и об этом же в нашем сравнении CRM на заказ или готовая CRM.

Схема потока

Сценарий состоит из двух частей. Первая создаёт накладную, когда заказ переходит в нужный статус. Вторая раз в полчаса проверяет, что с отправлениями.

Text
Заказ в KeyCRM переходит в статус «Готов к отправке»
        |
        v  триггер автоматизации KeyCRM: «Отправить HTTP запрос» (POST)
n8n: вебхук отвечает 200 сразу
        |
        v
Фильтр статуса  ->  GET заказа из KeyCRM (include=buyer,products.offer,shipping,payments)
        |
        v
ТТН уже есть?  ->  да: остановка (защита от дубля при повторе вебхука)
        |  нет
        v
Нова пошта: Address/getWarehouses  ->  город склада (CityRef)
Нова пошта: Counterparty/save      ->  получатель и контактное лицо
Нова пошта: InternetDocument/save  ->  ТТН (IntDocNumber)
        |                      \
        v                       v ошибка
PUT заказа в KeyCRM:            Telegram менеджерам: что отклонила Нова пошта
shipping.tracking_code
        |
        v
Telegram менеджерам: ТТН создана

Отдельный сценарий, каждые 30 минут:
GET заказов со статусом «Отправлено» -> пачки по 100 ТТН
 -> Нова пошта: TrackingDocument/getStatusDocuments -> что изменилось -> Telegram

Схема статичная: нужны сами шаги, а не анимация.

Шаг 1: вебхук из KeyCRM

KeyCRM не принимает входящие вебхуки, она только отправляет исходящие запросы через триггеры автоматизации. Триггер создают для заказов или воронки: событие смены статуса заказа, создания, оплаты, резерва или списания товара. Действие называется «Отправить HTTP запрос». Выбираете метод (по умолчанию POST), указываете URL вебхука из n8n и при желании добавляете до 20 собственных заголовков. Адреса localhost и приватных сетей KeyCRM блокирует, поэтому n8n должен быть доступен снаружи по https.

Без собственных параметров KeyCRM отправляет JSON из двух полей: event (например order.change_order_status) и context с данными заказа. Нам этого достаточно: из context.id мы возьмём номер заказа, а остальное догрузим запросом, потому что вебхук не отдаёт ни габаритов, ни данных склада доставки полностью.

Три правила от самой KeyCRM, на которых держится надёжность:

  1. Сервер-получатель должен ответить за 10 секунд кодом 2xx. Поэтому вебхук-нода n8n работает в режиме «ответить сразу», а весь сценарий выполняется после ответа.
  2. На 5xx и таймауты KeyCRM повторяет запрос трижды: через 1, 5 и 15 минут. На 3xx и 4xx повторов нет, а менеджер и администраторы получают системное уведомление.
  3. Повтор отправляет снимок данных из первой попытки. Значит, сценарий должен быть идемпотентным: один и тот же вебхук дважды не должен создать две накладные.

Защитите вебхук: в ноде Webhook есть авторизация заголовком (Header auth), а KeyCRM позволяет добавить собственный заголовок с секретом. Без этого ваш URL может вызвать кто угодно. В сценарии ниже это уже сделано.

Шаг 2: обращение к API KeyCRM

База API: https://openapi.keycrm.app/v1, авторизация заголовком Authorization: Bearer ВАШ_КЛЮЧ. Ключ создают в KeyCRM, инструкция в справке называется «Где взять API-ключ». Важные границы из документации OpenAPI:

  • до 20 запросов в минуту на один ключ;
  • в списках максимум 50 записей на страницу;
  • все даты в UTC;
  • фильтры передаются как filter[поле]=значение, например GET /order?filter[status_id]=1,4.

Двадцать запросов в минуту мало, если не считать. Наш основной сценарий делает два запроса к KeyCRM на заказ: прочитать и записать ТТН. Это около десяти заказов в минуту. Для магазина, который отправляет несколько сотен посылок в день, этого хватает, но если вы переведёте сто заказов в статус одновременно, часть запросов получит отказ. Есть два способа. Первый: поставить в сценарий узел Wait и обрабатывать заказы очередью. Второй: в n8n включить на HTTP-узле «Retry On Fail», что мы и сделали. Для больших объёмов перенесите создание накладных в ночную пачку.

Заказ читаем с параметром include: без него возвращается только базовая сущность. Нам нужны buyer, products.offer, shipping и payments. В объекте shipping KeyCRM хранит delivery_service_id, tracking_code, warehouse_ref (UUID склада Новой почты, обязателен вместе с идентификатором службы доставки в CRM), а также данные получателя, если он отличается от покупателя.

Записать ТТН обратно можно через PUT /order/{id} с объектом shipping: {"shipping": {"delivery_service_id": 1, "tracking_code": "20450000000000"}}. Номер службы доставки в вашей KeyCRM узнаете запросом GET /order/delivery-service. После этого KeyCRM сама подхватывает отслеживание по этому номеру, а правила переключения статусов работают как обычно.

Шаг 3: создание ТТН через API Новой почты

API Новой почты 2.0 принимает один тип запроса: POST на https://api.novaposhta.ua/v2.0/json/ с телом из четырёх полей: apiKey, modelName, calledMethod и methodProperties. Ключ API создаётся в личном кабинете Новой почты на странице настроек API 2.0. Все вызовы в этой инструкции выглядят одинаково, меняются только модель, метод и свойства.

Создание накладной требует больше, чем кажется. Методу InternetDocument/save нужны ссылки (Ref) на отправителя, его адрес и контакт, а также на получателя, его город, склад и контактное лицо. Данные отправителя вы достаёте один раз и кладёте в переменные окружения. Получателя сценарий создаёт для каждого заказа. Склад в заказе KeyCRM хранит как UUID, город склада подтягивается запросом.

Последовательность вызовов такая.

  1. Address/getWarehouses с Ref склада из заказа возвращает CityRef, нужный для поля CityRecipient. Этот запрос работает без ключа, мы проверили его 19.11.2026 на складе №1 в Киеве.
  2. Counterparty/save создаёт получателя: FirstName, LastName, Phone, CounterpartyType со значением PrivatePerson и CounterpartyProperty со значением Recipient. Ответ содержит Ref получателя и Ref его контактного лица.
  3. InternetDocument/save создаёт ТТН. Набор полей, который работает в реальных интеграциях: Sender, CitySender, SenderAddress, ContactSender, SendersPhone, Recipient, CityRecipient, RecipientAddress, ContactRecipient, RecipientsPhone, DateTime в формате дд.мм.гггг, CargoType, Weight, SeatsAmount, ServiceType, PayerType, PaymentMethod, Description. Дополнительно передаём Cost (объявленная стоимость) и, если заказ не оплачен, BackwardDeliveryData с суммой наложенного платежа. В ответе data[0].IntDocNumber это номер ТТН, а data[0].Ref идентификатор документа.

Важно честно сказать, что мы видели. Официальную документацию developers.novaposhta.ua наш автоматический инструмент открыть не смог (сервер ответил 403), поэтому состав полей InternetDocument/save мы сверяли с рабочим интеграционным тестом открытой PHP-библиотеки для API Новой почты (проект sergeynezbritskiy/nova-poshta-api на GitHub) и с нашим опытом. Метод Counterparty/save мы описываем по документации, которую знаем, но с боевым ключом его не запускали. Перед запуском сверьте поля с актуальной документацией и прогоните один тестовый документ с ключом вашего кабинета.

Шаг 4: ошибки, повторы, дубликаты

Вот что ломает такие сценарии на практике и что в нашем JSON уже учтено.

Дубликат ТТН. KeyCRM может повторить вебхук. Сценарий после чтения заказа смотрит на shipping.tracking_code: если номер есть, он останавливается. Это ключевая проверка, её нельзя выбрасывать.

Нова пошта отклонила документ. В ответе API есть поле success. Если оно false, массив errors содержит текст: не найден склад, телефон не в том формате, не заполнено обязательное поле. Сценарий ничего не пишет в заказ, а отправляет этот текст менеджерам в Telegram с номером заказа. Молчаливые сбои хуже громких.

Сбои API. На HTTP-узлах KeyCRM включён повтор при ошибке: три попытки с паузой. Для Новой почты повторов только два, потому что повторный InternetDocument/save после таймаута тоже может создать дубль, если первый ответ просто не дошёл. Если ваш поток обрабатывает тысячи заказов в сутки, добавьте перед созданием проверку, нет ли уже документа с таким же номером заказа в InternetDocument/getDocumentList.

Падение самого n8n. Задайте отдельный сценарий ошибок: в настройках сценария указывается error workflow, который начинается с узла Error Trigger и получает идентификатор выполнения, текст ошибки и последний выполненный узел. Туда же кладите уведомление в Telegram.

Вес. В нашем сценарии вес берётся из поля weight товара, а если его нет, ставится 0,5 кг на единицу. Подстройте это число под ваш ассортимент, иначе Нова пошта пересчитает тариф после сверки.

Статусы доставки

Второй сценарий спрашивает Новую почту о статусах отправлений пачками. Метод TrackingDocument/getStatusDocuments принимает массив документов {DocumentNumber, Phone} и возвращает StatusCode и текст статуса Status. Лимит на один запрос сто документов: на сто первом API отвечает ошибкой о максимуме 100 элементов. Мы проверили это живым запросом. Поэтому сценарий группирует ТТН по сто.

Чтобы не слать менеджерам один и тот же статус каждый раз, сценарий хранит последний код для каждой ТТН в статических данных сценария и сообщает только об изменении. В сценарии стоят коды 7 («прибыл в отделение») и 9 («получено»), но по таблице статусов документации мы их не сверяли, потому что документация для нашего инструмента закрыта. Проверьте значения на тестовой посылке: в коде они лежат в одном массиве, его легко изменить.

Для самой KeyCRM этот сценарий не обязателен: она и так обновляет статусы, а смена статуса заказа по статусу доставки настраивается в правилах. Второй сценарий нужен для уведомлений: Telegram менеджеру, Telegram или Viber клиенту, вызов ИИ-шага, который напишет клиенту сообщение в вашей манере.

Готовый сценарий для n8n

Ниже основной сценарий в формате JSON. Скопируйте его в файл и импортируйте: в n8n меню сценария, «Import from file». Ключи и пароли в нём не хранятся: всё берётся из переменных окружения ($env) и учётных данных, которые вы создаёте сами. Какие замены нужно сделать, перечислено сразу после кода.

JSON
{
 "name": "KeyCRM order -> Nova Poshta TTN -> tracking code + Telegram",
 "nodes": [
  {
   "id": "w1",
   "name": "KeyCRM webhook",
   "type": "n8n-nodes-base.webhook",
   "typeVersion": 2,
   "position": [
    0,
    0
   ],
   "webhookId": "keycrm-order-status",
   "parameters": {
    "httpMethod": "POST",
    "path": "keycrm-order-status",
    "authentication": "headerAuth",
    "responseMode": "onReceived",
    "options": {}
   },
   "credentials": {
    "httpHeaderAuth": {
     "id": "REPLACE_ME",
     "name": "KeyCRM webhook secret"
    }
   }
  },
  {
   "id": "w2",
   "name": "Right status only",
   "type": "n8n-nodes-base.code",
   "typeVersion": 2,
   "position": [
    220,
    0
   ],
   "parameters": {
    "jsCode": "// Keep only orders in the status that must get a TTN.\nconst body = $input.first().json.body || {};\nconst ctx = body.context || {};\nconst target = Number($env.KEYCRM_STATUS_READY_TO_SHIP || 0);\nif (body.event !== 'order.change_order_status' || Number(ctx.status_id) !== target) return [];\nreturn [{ json: { orderId: ctx.id } }];\n"
   }
  },
  {
   "id": "w3",
   "name": "Get order from KeyCRM",
   "type": "n8n-nodes-base.httpRequest",
   "typeVersion": 4.2,
   "position": [
    440,
    0
   ],
   "parameters": {
    "method": "GET",
    "url": "=https://openapi.keycrm.app/v1/order/{{ $json.orderId }}",
    "sendQuery": true,
    "queryParameters": {
     "parameters": [
      {
       "name": "include",
       "value": "buyer,products.offer,shipping,payments"
      }
     ]
    },
    "authentication": "genericCredentialType",
    "genericAuthType": "httpHeaderAuth",
    "options": {}
   },
   "credentials": {
    "httpHeaderAuth": {
     "id": "REPLACE_ME",
     "name": "KeyCRM API (Bearer)"
    }
   },
   "retryOnFail": true,
   "maxTries": 3,
   "waitBetweenTries": 5000
  },
  {
   "id": "w4",
   "name": "Build TTN payload",
   "type": "n8n-nodes-base.code",
   "typeVersion": 2,
   "position": [
    660,
    0
   ],
   "parameters": {
    "jsCode": "// Build the Nova Poshta InternetDocument/save payload from a KeyCRM order.\nconst order = $input.first().json;\nconst buyer = order.buyer || {};\nconst ship = order.shipping || {};\nconst items = order.products || [];\nconst total = Number(order.grand_total || 0);\nconst cod = order.payment_status === 'paid' ? 0 : Math.max(total - Number(order.total_paid || 0), 0);\n\nif (ship.tracking_code) {\n  return [{ json: { skip: true, reason: 'TTN already exists', orderId: order.id } }];\n}\nif (!ship.shipping_receive_point && !ship.warehouse_ref) {\n  throw new Error('Order ' + order.id + ': no Nova Poshta warehouse in the order');\n}\nconst d = new Date();\nconst props = {\n  PayerType: 'Recipient',\n  PaymentMethod: 'Cash',\n  CargoType: 'Cargo',\n  ServiceType: 'WarehouseWarehouse',\n  SeatsAmount: String(Math.max(items.length, 1)),\n  Weight: String(Math.max(items.reduce((s, p) => s + Number(p.weight || 0.5) * Number(p.quantity || 1), 0), 0.1)),\n  Description: items.map(p => p.name).join(', ').slice(0, 100) || 'Замовлення',\n  Cost: String(Math.round(total)),\n  RecipientsPhone: (ship.recipient_phone || buyer.phone || '').replace(/\\D/g, ''),\n  RecipientAddress: ship.warehouse_ref,\n  DateTime: [String(d.getDate()).padStart(2, '0'), String(d.getMonth() + 1).padStart(2, '0'), d.getFullYear()].join('.')\n};\nif (cod > 0) props.BackwardDeliveryData = [{ PayerType: 'Recipient', CargoType: 'Money', RedeliveryString: String(Math.round(cod)) }];\nconst parts = String(ship.recipient_full_name || buyer.full_name || '').trim().split(/\\s+/);\nreturn [{ json: { orderId: order.id, firstName: parts[0] || '-', lastName: parts.slice(1).join(' ') || '-', phone: props.RecipientsPhone, warehouseRef: ship.warehouse_ref, np: props } }];\n"
   }
  },
  {
   "id": "w5",
   "name": "Skip if TTN exists",
   "type": "n8n-nodes-base.if",
   "typeVersion": 2,
   "position": [
    880,
    0
   ],
   "parameters": {
    "conditions": {
     "options": {
      "caseSensitive": true,
      "typeValidation": "loose"
     },
     "combinator": "and",
     "conditions": [
      {
       "id": "c1",
       "leftValue": "={{ $json.skip }}",
       "rightValue": true,
       "operator": {
        "type": "boolean",
        "operation": "notEquals"
       }
      }
     ]
    },
    "options": {}
   }
  },
  {
   "id": "w5a",
   "name": "Nova Poshta: warehouse -> city",
   "type": "n8n-nodes-base.httpRequest",
   "typeVersion": 4.2,
   "position": [
    1100,
    -100
   ],
   "parameters": {
    "method": "POST",
    "url": "https://api.novaposhta.ua/v2.0/json/",
    "sendBody": true,
    "specifyBody": "json",
    "jsonBody": "={{ JSON.stringify({ apiKey: $env.NOVA_POSHTA_API_KEY, modelName: 'Address', calledMethod: 'getWarehouses', methodProperties: { Ref: $json.warehouseRef, Language: 'UA' } }) }}",
    "options": {}
   },
   "retryOnFail": true,
   "maxTries": 2,
   "waitBetweenTries": 3000
  },
  {
   "id": "w5b",
   "name": "Nova Poshta: create recipient",
   "type": "n8n-nodes-base.httpRequest",
   "typeVersion": 4.2,
   "position": [
    1320,
    -100
   ],
   "parameters": {
    "method": "POST",
    "url": "https://api.novaposhta.ua/v2.0/json/",
    "sendBody": true,
    "specifyBody": "json",
    "jsonBody": "={{ JSON.stringify({ apiKey: $env.NOVA_POSHTA_API_KEY, modelName: 'Counterparty', calledMethod: 'save', methodProperties: { FirstName: $('Build TTN payload').first().json.firstName, LastName: $('Build TTN payload').first().json.lastName, Phone: $('Build TTN payload').first().json.phone, CounterpartyType: 'PrivatePerson', CounterpartyProperty: 'Recipient' } }) }}",
    "options": {}
   },
   "retryOnFail": true,
   "maxTries": 2,
   "waitBetweenTries": 3000
  },
  {
   "id": "w6",
   "name": "Nova Poshta: create TTN",
   "type": "n8n-nodes-base.httpRequest",
   "typeVersion": 4.2,
   "position": [
    1540,
    -100
   ],
   "parameters": {
    "method": "POST",
    "url": "https://api.novaposhta.ua/v2.0/json/",
    "sendBody": true,
    "specifyBody": "json",
    "jsonBody": "={{ JSON.stringify({ apiKey: $env.NOVA_POSHTA_API_KEY, modelName: 'InternetDocument', calledMethod: 'save', methodProperties: Object.assign({ Sender: $env.NP_SENDER_REF, CitySender: $env.NP_CITY_SENDER_REF, SenderAddress: $env.NP_SENDER_WAREHOUSE_REF, ContactSender: $env.NP_CONTACT_SENDER_REF, SendersPhone: $env.NP_SENDER_PHONE, CityRecipient: $('Nova Poshta: warehouse -> city').first().json.data[0].CityRef, Recipient: $json.data[0].Ref, ContactRecipient: $json.data[0].ContactPerson.data[0].Ref }, $('Build TTN payload').first().json.np) }) }}",
    "options": {}
   },
   "retryOnFail": true,
   "maxTries": 2,
   "waitBetweenTries": 3000
  },
  {
   "id": "w7",
   "name": "TTN created?",
   "type": "n8n-nodes-base.if",
   "typeVersion": 2,
   "position": [
    1760,
    -100
   ],
   "parameters": {
    "conditions": {
     "options": {
      "caseSensitive": true,
      "typeValidation": "loose"
     },
     "combinator": "and",
     "conditions": [
      {
       "id": "c2",
       "leftValue": "={{ $json.success }}",
       "rightValue": true,
       "operator": {
        "type": "boolean",
        "operation": "true"
       }
      }
     ]
    },
    "options": {}
   }
  },
  {
   "id": "w8",
   "name": "Write TTN number to KeyCRM",
   "type": "n8n-nodes-base.httpRequest",
   "typeVersion": 4.2,
   "position": [
    1980,
    -200
   ],
   "parameters": {
    "method": "PUT",
    "url": "=https://openapi.keycrm.app/v1/order/{{ $('Right status only').first().json.orderId }}",
    "sendBody": true,
    "specifyBody": "json",
    "jsonBody": "={{ JSON.stringify({ shipping: { delivery_service_id: Number($env.KEYCRM_NP_DELIVERY_SERVICE_ID), tracking_code: $json.data[0].IntDocNumber } }) }}",
    "authentication": "genericCredentialType",
    "genericAuthType": "httpHeaderAuth",
    "options": {}
   },
   "credentials": {
    "httpHeaderAuth": {
     "id": "REPLACE_ME",
     "name": "KeyCRM API (Bearer)"
    }
   },
   "retryOnFail": true,
   "maxTries": 3,
   "waitBetweenTries": 5000
  },
  {
   "id": "w9",
   "name": "Telegram: TTN ready",
   "type": "n8n-nodes-base.telegram",
   "typeVersion": 1.2,
   "position": [
    2200,
    -200
   ],
   "parameters": {
    "chatId": "={{ $env.TELEGRAM_MANAGERS_CHAT_ID }}",
    "text": "=TTN {{ $('Nova Poshta: create TTN').first().json.data[0].IntDocNumber }} created for order #{{ $('Right status only').first().json.orderId }}",
    "additionalFields": {
     "appendAttribution": false
    }
   },
   "credentials": {
    "telegramApi": {
     "id": "REPLACE_ME",
     "name": "Telegram bot"
    }
   }
  },
  {
   "id": "w10",
   "name": "Telegram: problem",
   "type": "n8n-nodes-base.telegram",
   "typeVersion": 1.2,
   "position": [
    1980,
    0
   ],
   "parameters": {
    "chatId": "={{ $env.TELEGRAM_MANAGERS_CHAT_ID }}",
    "text": "=Nova Poshta rejected the TTN for order #{{ $('Right status only').first().json.orderId }}: {{ ($json.errors || []).join('; ') }}",
    "additionalFields": {
     "appendAttribution": false
    }
   },
   "credentials": {
    "telegramApi": {
     "id": "REPLACE_ME",
     "name": "Telegram bot"
    }
   }
  }
 ],
 "connections": {
  "KeyCRM webhook": {
   "main": [
    [
     {
      "node": "Right status only",
      "type": "main",
      "index": 0
     }
    ]
   ]
  },
  "Right status only": {
   "main": [
    [
     {
      "node": "Get order from KeyCRM",
      "type": "main",
      "index": 0
     }
    ]
   ]
  },
  "Get order from KeyCRM": {
   "main": [
    [
     {
      "node": "Build TTN payload",
      "type": "main",
      "index": 0
     }
    ]
   ]
  },
  "Build TTN payload": {
   "main": [
    [
     {
      "node": "Skip if TTN exists",
      "type": "main",
      "index": 0
     }
    ]
   ]
  },
  "Skip if TTN exists": {
   "main": [
    [
     {
      "node": "Nova Poshta: warehouse -> city",
      "type": "main",
      "index": 0
     }
    ],
    []
   ]
  },
  "Nova Poshta: warehouse -> city": {
   "main": [
    [
     {
      "node": "Nova Poshta: create recipient",
      "type": "main",
      "index": 0
     }
    ]
   ]
  },
  "Nova Poshta: create recipient": {
   "main": [
    [
     {
      "node": "Nova Poshta: create TTN",
      "type": "main",
      "index": 0
     }
    ]
   ]
  },
  "Nova Poshta: create TTN": {
   "main": [
    [
     {
      "node": "TTN created?",
      "type": "main",
      "index": 0
     }
    ]
   ]
  },
  "TTN created?": {
   "main": [
    [
     {
      "node": "Write TTN number to KeyCRM",
      "type": "main",
      "index": 0
     }
    ],
    [
     {
      "node": "Telegram: problem",
      "type": "main",
      "index": 0
     }
    ]
   ]
  },
  "Write TTN number to KeyCRM": {
   "main": [
    [
     {
      "node": "Telegram: TTN ready",
      "type": "main",
      "index": 0
     }
    ]
   ]
  }
 },
 "settings": {
  "executionOrder": "v1"
 }
}

Что нужно настроить перед запуском:

  • учётные данные «KeyCRM API (Bearer)»: тип Header Auth, имя Authorization, значение Bearer ВАШ_КЛЮЧ;
  • учётные данные «KeyCRM webhook secret»: Header Auth с любым собственным заголовком, его же добавьте в триггер KeyCRM;
  • учётные данные «Telegram bot»: токен бота от BotFather;
  • переменные окружения: NOVA_POSHTA_API_KEY, NP_SENDER_REF, NP_CITY_SENDER_REF, NP_SENDER_WAREHOUSE_REF, NP_CONTACT_SENDER_REF, NP_SENDER_PHONE, KEYCRM_STATUS_READY_TO_SHIP (номер статуса «Готов к отправке»), KEYCRM_NP_DELIVERY_SERVICE_ID и TELEGRAM_MANAGERS_CHAT_ID;
  • в n8n доступ к $env может быть закрыт настройками экземпляра. Если в выражениях пусто, проверьте параметр N8N_BLOCK_ENV_ACCESS_IN_NODE: он может запрещать узлам читать переменные окружения.

Данные отправителя (Sender, адрес, контакт) достаньте из уже созданного в кабинете документа: такой совет есть и в тестах открытой библиотеки, потому что создавать их с нуля неудобно.

Второй сценарий, который следит за статусами, мы дали в том же формате.

JSON
{
 "name": "Nova Poshta tracking -> Telegram to manager",
 "nodes": [
  {
   "id": "t1",
   "name": "Every 30 minutes",
   "type": "n8n-nodes-base.scheduleTrigger",
   "typeVersion": 1.2,
   "position": [
    0,
    0
   ],
   "parameters": {
    "rule": {
     "interval": [
      {
       "field": "minutes",
       "minutesInterval": 30
      }
     ]
    }
   }
  },
  {
   "id": "t2",
   "name": "KeyCRM: shipped orders",
   "type": "n8n-nodes-base.httpRequest",
   "typeVersion": 4.2,
   "position": [
    220,
    0
   ],
   "parameters": {
    "method": "GET",
    "url": "https://openapi.keycrm.app/v1/order",
    "sendQuery": true,
    "queryParameters": {
     "parameters": [
      {
       "name": "include",
       "value": "buyer,shipping"
      },
      {
       "name": "limit",
       "value": "50"
      },
      {
       "name": "filter[status_id]",
       "value": "={{ $env.KEYCRM_STATUS_SHIPPED }}"
      }
     ]
    },
    "authentication": "genericCredentialType",
    "genericAuthType": "httpHeaderAuth",
    "options": {}
   },
   "credentials": {
    "httpHeaderAuth": {
     "id": "REPLACE_ME",
     "name": "KeyCRM API (Bearer)"
    }
   },
   "retryOnFail": true,
   "maxTries": 3,
   "waitBetweenTries": 5000
  },
  {
   "id": "t3",
   "name": "Group TTNs",
   "type": "n8n-nodes-base.code",
   "typeVersion": 2,
   "position": [
    440,
    0
   ],
   "parameters": {
    "jsCode": "// Collect TTNs of orders in 'shipped' status; keep batches of up to 100 (Nova Poshta limit).\nconst orders = $input.all().flatMap(i => i.json.data || []);\nconst docs = orders.filter(o => o.shipping && o.shipping.tracking_code)\n  .map(o => ({ DocumentNumber: o.shipping.tracking_code, Phone: '', orderId: o.id, buyer: o.buyer && o.buyer.full_name }));\nconst out = [];\nfor (let i = 0; i < docs.length; i += 100) out.push({ json: { batch: docs.slice(i, i + 100) } });\nreturn out;\n"
   }
  },
  {
   "id": "t4",
   "name": "Nova Poshta: statuses",
   "type": "n8n-nodes-base.httpRequest",
   "typeVersion": 4.2,
   "position": [
    660,
    0
   ],
   "parameters": {
    "method": "POST",
    "url": "https://api.novaposhta.ua/v2.0/json/",
    "sendBody": true,
    "specifyBody": "json",
    "jsonBody": "={{ JSON.stringify({ apiKey: $env.NOVA_POSHTA_API_KEY, modelName: 'TrackingDocument', calledMethod: 'getStatusDocuments', methodProperties: { Documents: $json.batch.map(d => ({ DocumentNumber: d.DocumentNumber, Phone: d.Phone })) } }) }}",
    "options": {}
   },
   "retryOnFail": true,
   "maxTries": 3,
   "waitBetweenTries": 5000
  },
  {
   "id": "t5",
   "name": "What changed",
   "type": "n8n-nodes-base.code",
   "typeVersion": 2,
   "position": [
    880,
    0
   ],
   "parameters": {
    "jsCode": "// Notify only when the status code is new for this TTN (state kept in workflow static data).\nconst sd = $getWorkflowStaticData('global');\nsd.seen = sd.seen || {};\nconst batch = $('Group TTNs').first().json.batch;\nconst res = $input.first().json.data || [];\nconst out = [];\nfor (const r of res) {\n  const prev = sd.seen[r.Number];\n  if (prev === r.StatusCode) continue;\n  sd.seen[r.Number] = r.StatusCode;\n  if (prev === undefined && r.StatusCode !== '7') continue; // first sight: remember silently\n  if (['7', '9'].includes(r.StatusCode)) {\n    const o = batch.find(b => b.DocumentNumber === r.Number) || {};\n    out.push({ json: { orderId: o.orderId, ttn: r.Number, code: r.StatusCode, status: r.Status } });\n  }\n}\nreturn out;\n"
   }
  },
  {
   "id": "t6",
   "name": "Telegram: delivery update",
   "type": "n8n-nodes-base.telegram",
   "typeVersion": 1.2,
   "position": [
    1100,
    0
   ],
   "parameters": {
    "chatId": "={{ $env.TELEGRAM_MANAGERS_CHAT_ID }}",
    "text": "=Order #{{ $json.orderId }}: {{ $json.status }} (TTN {{ $json.ttn }})",
    "additionalFields": {
     "appendAttribution": false
    }
   },
   "credentials": {
    "telegramApi": {
     "id": "REPLACE_ME",
     "name": "Telegram bot"
    }
   }
  }
 ],
 "connections": {
  "Every 30 minutes": {
   "main": [
    [
     {
      "node": "KeyCRM: shipped orders",
      "type": "main",
      "index": 0
     }
    ]
   ]
  },
  "KeyCRM: shipped orders": {
   "main": [
    [
     {
      "node": "Group TTNs",
      "type": "main",
      "index": 0
     }
    ]
   ]
  },
  "Group TTNs": {
   "main": [
    [
     {
      "node": "Nova Poshta: statuses",
      "type": "main",
      "index": 0
     }
    ]
   ]
  },
  "Nova Poshta: statuses": {
   "main": [
    [
     {
      "node": "What changed",
      "type": "main",
      "index": 0
     }
    ]
   ]
  },
  "What changed": {
   "main": [
    [
     {
      "node": "Telegram: delivery update",
      "type": "main",
      "index": 0
     }
    ]
   ]
  }
 },
 "settings": {
  "executionOrder": "v1"
 }
}

Ему нужны те же учётные данные и переменные, плюс KEYCRM_STATUS_SHIPPED (номер статуса «Отправлено»).

То же в Make

В Make схема та же, отличаются узлы. Вебхук принимает модуль Webhooks (Custom webhook), запросы к KeyCRM и Новой почте делает модуль HTTP «Make a request», ветвление на «статус нужный» и «ТТН уже есть» делает Router с фильтрами, а ошибки обрабатывают модули Break, Resume, Rollback и Ignore. Отдельный сценарий для статусов запускается по расписанию.

Разница в трёх местах. Первая: Make считает кредиты за каждое действие, поэтому основной сценарий с десятью модулями на заказ тратит около десяти кредитов, а n8n считает весь запуск как один. Для отправлений на сотни заказов в день разница в счёте заметна, подробный расчёт на трёх типовых сценариях есть в нашем сравнении n8n или Make. Вторая: в Make вебхук и ответ настраиваются модулем «Webhook response», а ответ 2xx за 10 секунд тоже обязателен. Третья: готового экспорта Make-сценария для этой страницы мы не публикуем, потому что не запускали его на живом аккаунте Make, а чужие неразобранные блюпринты для процесса с деньгами брать не советуем.

Проверка: что мы действительно запускали

Для честности разложим, что проверено, а что нет.

Проверено: оба JSON импортируются в n8n 2.47.7 без ошибок; код в узлах Code мы прогнали на тестовых данных (фильтр статуса, построение ТТН, пачки по 100); живые запросы к API Новой почты без ключа подтвердили формат запроса, лимит 100 документов в getStatusDocuments и ответ getWarehouses с CityRef; форматы KeyCRM сверены с её OpenAPI-документацией и справкой о вебхуках.

Не проверено: создание реальной ТТН (нужен ключ вашего кабинета и настоящий отправитель) и запись в реальную KeyCRM (нужен ваш ключ). Поэтому сценарий нужно сначала прогнать на одном тестовом заказе.

Сколько это стоит

Есть три пути. Первый: сделать самому по этой странице. Нужен n8n Cloud по подписке или собственный сервер, ключи API и человек, который умеет читать ответы HTTP API. По публичной странице цен n8n на 19.11.2026 план Starter стоит 20 EUR в месяц при оплате за год и даёт 2 500 запусков, Pro 50 EUR в месяц и 10 000 запусков; собственный сервер без лицензионной платы, но с вашим временем на обновления и резервные копии.

Второй: поручить нам. Минимальный проект в Lytvynov Production составляет 10 000 USD, и отдельно сценарий на несколько узлов мы не продаём. Честно: если вам нужен только этот один сценарий, дешевле отдать эту страницу своему разработчику или фрилансеру. Если же доставка является частью большей автоматизации, где есть ещё заказы, оплаты, ИИ-ответы клиентам или собственные ноды, мы беремся за весь объём на n8n по фиксированной цене.

Третий: собственный сервис вместо сценариев. Когда заказов тысячи в день, а ошибки в накладных стоят дорого, мы строим небольшой сервис с очередью и экраном ручной проверки. Пример такого подхода в нашей работе: сервис цветочных подписок с вызовом курьера Uklon Delivery, где статусы курьера двигают заказы без участия человека. О выборе между no-code и кодом есть отдельный раздел в сравнении n8n и Make.

Источники, проверенные 19.11.2026: KeyCRM OpenAPI, настройка вебхуков KeyCRM, создание ТТН в KeyCRM, автосмена статуса по статусу доставки, API Новой почты, вебхук-нода n8n, обработка ошибок в n8n.

Наши гайды об ИИ и разработке вверху вашего Google?

Добавьте Lytvynov Production как предпочтительный источник, и Google будет показывать наши новые гайды об ИИ-агентах, стоимости MVP и заказной разработке выше в выдаче.

Кейсы

Частые вопросы

Да, и большинству магазинов этого достаточно. Справка KeyCRM описывает создание ТТН в один клик, если адрес получателя в заказе сохранён как склад, у товара заполнены габариты, а в настройках интеграции включено автозаполнение описания отправления. Статусы доставки KeyCRM тоже подтягивает сама и может менять по ним статус заказа. n8n или Make нужны, когда эти условия не выполняются или после отправки должно случиться что-то своё.

По документации KeyCRM OpenAPI разрешено до 20 запросов в минуту на один ключ, а в списках не больше 50 записей на страницу. Сценарий, который на каждый заказ делает два запроса к KeyCRM, обработает около десяти заказов в минуту. Поэтому массовые действия растягивают во времени, а проверку статусов делают пачкой, а не по одному заказу.

В методе getStatusDocuments до 100 документов за запрос: на 101-й документ API отвечает ошибкой о максимуме 100 элементов. Мы проверили это живым запросом 19.11.2026. Поэтому сценарий группирует номера ТТН пачками по сто и спрашивает статусы раз в полчаса, а не по каждому заказу отдельно.

KeyCRM ждёт ответа до 10 секунд и считает успехом только код 2xx. На ошибки 5xx и таймауты она повторяет запрос трижды: через 1, 5 и 15 минут. На 3xx и 4xx повторов нет, а ответственный менеджер получает системное уведомление. Поэтому вебхук в n8n отвечает сразу, а сценарий проверяет, есть ли в заказе уже ТТН, чтобы повтор не создал дубль накладной.

Отдельный небольшой сценарий мы не продаём: минимальный проект в Lytvynov Production составляет 10 000 USD. Мелкие сценарии, как этот, делаем в рамках более крупного проекта, например вместе с другими автоматизациями на n8n, ИИ-шагами или собственной CRM. Самостоятельно сценарий с этой страницы разворачивается на n8n Cloud по подписке или на собственном сервере, а разработчик с опытом HTTP API настроит его сам.

В каталоге n8n 19.11.2026 мы не нашли встроенной ноды Новой почты, есть только пакеты сообщества, которые мы не рекомендуем ставить в процесс с деньгами без проверки автора и обновлений. В Make каталог приложений меняется, поэтому его проверяют в начале проекта. В обоих инструментах надёжно работает прямой HTTP-запрос к API Новой почты, как в сценарии ниже.

Давайте начнем ваш проект
Записаться на звонок