Интеграция доставки DHL в Tilda на N8N

1. ОБЩАЯ ИНФОРМАЦИЯ О ПРОЕКТЕ

Требуется разработать интеграцию между интернет-магазином на CMS Tilda и логистической службой DHL Express. 

Расчет стоимости и обработка заказов для службы СДЭК (доступные СДЭК страны: Россия, Казахстан, Узбекистан и т.д) и метода "Самовывоз" полностью осуществляются стандартными встроенными модулями Tilda и ее штатным функционалом. Платформа n8n не должна принимать участия в обработке заказов, оформленных через СДЭК или Самовывоз.

Логика работы с DHL Express должна быть реализована в виде двух независимых потоков (Workflows) на уже существующем и настроенном сервере автоматизации n8n (Self-Hosted) заказчика. Прием платежей на сайте реализован через платежные шлюзы Stripe и МИР.

2. ОБЩАЯ ПОСЛЕДОВАТЕЛЬНОСТЬ ОБРАБОТКИ ЗАКАЗА (КТО И ЧТО ДЕЛАЕТ)

* Выбор адреса в корзине (Покупатель и Tilda): Покупатель вводит адрес доставки. Если покупатель выбирает "Самовывоз", расчеты не требуются, Tilda оформляет заказ штатно. Если выбирается доставка по адресу, Tilda параллельно запускает расчет тарифа через свой штатный модуль СДЭК и отправляет Webhook в кастомный модуль доставки n8n.

* Автоматическая проверка доступности СДЭК (n8n): Сценарий Номер 1 в n8n принимает Webhook от Tilda и первым шагом отправляет тестовый запрос к API СДЭК для проверки возможности доставки по указанному адресу.
  — Если СДЭК доступен: n8n прекращает работу и возвращает в Tilda пустой ответ. В корзине покупателя отображается только стандартный тариф СДЭК от самой Tilda. Логи для модератора на этом этапе не создаются.
  — Если СДЭК недоступен (ошибка API): n8n автоматически переключает логику на расчет стоимости DHL.

* Расчет тарифа DHL (n8n и Google Таблицы): n8n проверяет лимит количества товаров по внешней Google Таблице. Если лимит превышен, пользователю выдается ошибка. Если в норме – n8n определяет размер нужной коробки, запрашивает тариф у DHL API (метод Rates) и возвращает стоимость в Tilda. Результат расчета (успех или ошибка лимита) автоматически записывается во вкладку "Логи" Google Таблицы.

* Оплата (Покупатель): Покупатель оплачивает заказ (через Stripe или МИР) с выбранным типом доставки.

* Пост-оплата и фильтрация (Tilda и n8n): Tilda отправляет Webhook об успешной оплате в Сценарий Номер 2 в n8n.
  — Если оплачен СДЭК или Самовывоз: n8n фиксирует этот тип доставки в вебхуке и завершает работу без выполнения каких-либо действий. Вся дальнейшая обработка происходит внутри Tilda стандартными средствами. Запись в логи модератора не вносится.
  — Если оплачен DHL: n8n запрашивает габариты коробки из Google Таблицы, отправляет запрос в DHL API (метод Shipments) с данными PLT (HS-code, Name EN, вес, стоимость) для электронной таможни, оформляет вызов курьера на склад, отправляет готовую PDF-этикетку на email администратора и делает финальную запись во вкладку "Логи".

* Физическая отгрузка (Администратор и Курьер DHL): Администратор открывает почту, распечатывает PDF-файл этикетки, упаковывает товары в коробку и передает ее курьеру DHL, который приезжает в 10 часов утра дня следующего за заказом.

3. ПОДГОТОВКА НА СТОРОНЕ TILDA

Все товары в магазине имеют стандартный размер, поэтому хранить габариты в каталоге не требуется. Для работы таможенного API DHL в каталог Tilda необходимо добавить следующие дополнительные поля строго в алфавитном порядке для стандартизации:
* HS-code (код ТН ВЭД)
* Name EN (наименование товара на английском языке)
* Вес (кг)

Настройки корзины:
* Для способа "Самовывоз" используется штатный модуль Tilda.
* Все доступные страны мира в корзине переводятся на единый кастомный модуль "Пользовательский способ доставки", который отправляет Webhook на сервер n8n для первоначальной проверки СДЭК и распределения.

4. УПРАВЛЕНИЕ ЛОГИСТИКОЙ ЧЕРЕЗ GOOGLE ТАБЛИЦЫ (ДОСТУП ДЛЯ МОДЕРАТОРА)

Вся бизнес-логика и отчетность выносятся во внешнюю Google Таблицу, состоящую из двух вкладок:
* Вкладка 1 (Размеры упаковок): Матрица соответствия количества товаров в заказе и габаритов коробок (ДхШхВ) для зоны DHL. Модератор управляет лимитами и размерами тары.
* Вкладка 2 (Логи): Журнал работы системы, заполняемый платформой n8n автоматически ТОЛЬКО для операций, переключенных на DHL. Строка лога должна содержать: дата и время, состав заказа (количество и вес), статус (Успешно / Ошибка лимита / Ошибка API) и итоговый рассчитанный тариф DHL. Заказы СДЭК и Самовывоза в эту вкладку не не заносятся.

5. ИСКЛЮЧЕНИЯ

* Разработка механизмов отслеживания (Tracking) внутри n8n не требуется. Статус доставки проверяется на стороне платформ СДЭК и DHL соответственно.
* Сложные алгоритмы 3D-упаковки (Bin Packing) не требуются.

! В предложениях, пожалуйста, указывайте стоимость и сроки.