Интеграция WooCommerce и n8n: заказы, webhooks и синхронизация CRM ¶

Обновлено: 2026-05-30

Проблема: WooCommerce может отправлять webhook при создании и обновлении заказа. Если n8n воспринимает каждое событие как новый заказ, CRM и склад получают дубли.

Решение: Надёжная интеграция WooCommerce и n8n разделяет order.created и order.updated, собирает ключ по shop+topic+order_id, нормализует line items и обновляет CRM/склад по понятному статусу.

Проблема: почему простая интеграция создаёт дубли и ручной хаос ¶

WooCommerce часто используют в связке с WordPress, CRM, складом, Telegram-уведомлениями и email. На старте кажется, что достаточно создать webhook “Order created” и принять JSON в n8n. Но в реальной эксплуатации заказ может обновляться много раз: оплата, смена статуса, адрес доставки, комментарий менеджера, возврат или изменение состава товаров.

Если не различать события и не сохранять order_id как ключ, downstream-системы получают несколько одинаковых заказов. Особенно это опасно для склада: дубли line items могут привести к ошибочной отгрузке или неверному резервированию остатков.

Архитектура workflow для n8n ¶

Для WooCommerce лучше хранить внешний номер заказа отдельно: external_order_id и order_number могут отличаться. Не используйте только name или email покупателя как ключ.

Контракт входных данных ¶

{
  "id": 10492,
  "number": "10492",
  "status": "processing",
  "currency": "RUB",
  "date_created": "2026-05-30T10:00:00",
  "total": "15900.00",
  "payment_method": "card",
  "billing": {
    "first_name": "Ольга",
    "last_name": "Смирнова",
    "email": "olga@example.ru",
    "phone": "+7 916 222-33-44"
  },
  "shipping": {
    "city": "Москва",
    "address_1": "ул. Примерная, 15"
  },
  "line_items": [
    {
      "id": 731,
      "name": "Консультация n8n",
      "sku": "N8N-CONSULT",
      "quantity": 1,
      "total": "15900.00"
    }
  ]
}

В тестовом payload показан заказ WooCommerce. В production добавьте shop domain и topic из webhook-заголовков или параметров endpoint, чтобы ключ дедупликации был стабильным.

Code Node: нормализация, mapping и guard-условия ¶

const src = $json.body ?? $json;
const headers = $json.headers ?? {};
const topic = String(headers['x-wc-webhook-topic'] ?? src.topic ?? 'order.updated').trim();
const shop = String(src.shop_domain ?? headers.host ?? 'woocommerce').trim().toLowerCase();
const orderId = String(src.id ?? '').trim();
if (!orderId) throw new Error('No WooCommerce order id');
const email = String(src.billing?.email ?? '').trim().toLowerCase();
const phone = String(src.billing?.phone ?? '').trim();
const lines = Array.isArray(src.line_items) ? src.line_items.map(item => ({
  sku: String(item.sku ?? '').trim(),
  name: String(item.name ?? '').trim(),
  quantity: Number(item.quantity ?? 0),
  total: Number(item.total ?? 0)
})) : [];
return [{ json: {
  action: topic.includes('deleted') ? 'ignore' : 'sync_order',
  idempotency_key: `woocommerce:${shop}:${topic}:${orderId}`,
  external_order_id: `woocommerce:${shop}:${orderId}`,
  order_id: orderId,
  order_number: String(src.number ?? orderId),
  status: String(src.status ?? '').trim(),
  total: Number(src.total ?? 0),
  currency: String(src.currency ?? '').trim(),
  customer_email: email,
  customer_phone: phone,
  shipping_city: String(src.shipping?.city ?? '').trim(),
  line_items: lines,
  crm_comment: `WooCommerce order ${src.number ?? orderId}, status=${src.status ?? 'unknown'}`
}}];

Готовый workflow JSON: скачать и импортировать ¶

Скачать готовый workflow JSON Скачать тестовый payload

{
  "name": "Nodbot - WooCommerce orders to CRM with dedupe",
  "nodes": [
    {
      "name": "WooCommerce Webhook",
      "type": "n8n-nodes-base.webhook",
      "purpose": "Принять order event"
    },
    {
      "name": "Normalize WooCommerce order",
      "type": "n8n-nodes-base.code",
      "purpose": "Собрать order contract"
    },
    {
      "name": "Build idempotency key",
      "type": "n8n-nodes-base.code",
      "purpose": "Защититься от повторов"
    },
    {
      "name": "Find order in CRM",
      "type": "n8n-nodes-base.httpRequest",
      "purpose": "Найти external_order_id"
    },
    {
      "name": "Create or update order",
      "type": "n8n-nodes-base.httpRequest",
      "purpose": "Синхронизировать CRM/склад"
    },
    {
      "name": "Respond",
      "type": "n8n-nodes-base.respondToWebhook",
      "purpose": "Вернуть 2xx"
    }
  ],
  "connections": "WooCommerce Webhook → Normalize WooCommerce order → Build idempotency key → Find order in CRM → Create or update order → Respond"
}

Пошаговая настройка связки ¶

1. Создайте WooCommerce webhook для нужных order events.
2. Настройте секрет webhook и отдельный endpoint n8n для магазина.
3. Импортируйте workflow JSON и замените CRM/склад endpoint, credentials и поля.
4. Решите, какие статусы создают заказ, а какие только обновляют статус.
5. Прогоните тесты на повторный webhook и order.updated.

Тесты перед production ¶

curl -X POST "https://YOUR-N8N-DOMAIN/webhook/integration-woocommerce-n8n-order-sync" \
  -H "Content-Type: application/json" \
  --data @integration-woocommerce-n8n-order-sync-payload.json

1. Повторный payload не создаёт дубль и возвращает тот же output key.
2. Некорректный mapping останавливается до запроса к внешнему API.
3. Пустые необязательные поля не ломают workflow.
4. Ошибка API уходит в alert или DLQ с безопасным payload.
5. Execution data не содержит секретов, токенов и лишних персональных данных.

Production-риски ¶

• Order update создаёт новую запись. CRM и склад получают дубли.
• SKU потерян в комментарии. Склад не сможет обработать позиции структурно.
• Нет shop domain в ключе. Несколько магазинов конфликтуют по одинаковым order_id.
• Webhook secret не проверяется. Endpoint можно дергать извне.
• Статусы WooCommerce не сопоставлены с CRM. Processing, completed и cancelled попадают в один статус.

Полезные ссылки и смежные материалы ¶

• WooCommerce Webhooks
• WooCommerce REST API
• Working with webhooks in WooCommerce
• WordPress и n8n
• Webhook idempotency to Postgres
• Shopify и n8n

Критерии готовности ¶

1. Order id и shop domain входят в ключ дедупликации.
2. Line items передаются структурно: SKU, quantity, total.
3. Статусы WooCommerce сопоставлены с CRM/складом.
4. Повторный webhook не создаёт второй заказ.
5. Ошибки downstream-систем уходят в alert или DLQ.