Обзор подготовил Антон Литвинов, основатель 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.
Схема потока
Сценарий состоит из двух частей. Первая создаёт накладную, когда заказ переходит в нужный статус. Вторая раз в полчаса проверяет, что с отправлениями.
Заказ в 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, на которых держится надёжность:
- Сервер-получатель должен ответить за 10 секунд кодом 2xx. Поэтому вебхук-нода n8n работает в режиме «ответить сразу», а весь сценарий выполняется после ответа.
- На 5xx и таймауты KeyCRM повторяет запрос трижды: через 1, 5 и 15 минут. На 3xx и 4xx повторов нет, а менеджер и администраторы получают системное уведомление.
- Повтор отправляет снимок данных из первой попытки. Значит, сценарий должен быть идемпотентным: один и тот же вебхук дважды не должен создать две накладные.
Защитите вебхук: в ноде 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, город склада подтягивается запросом.
Последовательность вызовов такая.
Address/getWarehousesсRefсклада из заказа возвращаетCityRef, нужный для поляCityRecipient. Этот запрос работает без ключа, мы проверили его 19.11.2026 на складе №1 в Киеве.Counterparty/saveсоздаёт получателя:FirstName,LastName,Phone,CounterpartyTypeсо значениемPrivatePersonиCounterpartyPropertyсо значениемRecipient. Ответ содержитRefполучателя иRefего контактного лица.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) и учётных данных, которые вы создаёте сами. Какие замены нужно сделать, перечислено сразу после кода.
{
"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, адрес, контакт) достаньте из уже созданного в кабинете документа: такой совет есть и в тестах открытой библиотеки, потому что создавать их с нуля неудобно.
Второй сценарий, который следит за статусами, мы дали в том же формате.
{
"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.