russian-services

n8n nodes for Russian business services

Package Information

Downloads: 1 weekly / 8 monthly
Latest Version: 1.0.3
Author: Your Name

Available Nodes

Wildberries
Интеграция с Wildberries API для управления товарами, заказами и аналитикой

Documentation

n8n Wildberries API Node

Полнофункциональная нода для интеграции с Wildberries API в n8n, поддерживающая все основные операции для работы с товарами, заказами, поставками и аналитикой.

🚀 Возможности

📦 Управление товарами

  • ✅ Создание карточек товаров
  • ✅ Обновление цен и скидок
  • ✅ Управление остатками
  • ✅ Получение списка товаров

📋 Работа с заказами

  • ✅ Получение новых заказов
  • ✅ Обновление статусов заказов
  • ✅ Работа со сборочными заданиями

🚚 Поставки

  • ✅ Создание поставок
  • ✅ Добавление товаров в поставку
  • ✅ Отправка на склад WB
  • ✅ Получение списка поставок

📊 Аналитика

  • ✅ Отчет по продажам
  • ✅ Остатки на складах
  • ✅ Воронка продаж

🔧 Технические особенности

Rate Limiting

  • Marketplace API: 300 запросов в минуту
  • Content API: 100 запросов в минуту
  • Analytics API: 100 запросов в минуту
  • Автоматическое отслеживание лимитов через заголовок X-Ratelimit-Remaining
  • Обработка ошибки 409 (считается как 5 запросов)

Sandbox поддержка

Полная поддержка sandbox окружения для тестирования:

  • https://sandbox-content-api.wildberries.ru
  • https://sandbox-marketplace-api.wildberries.ru
  • https://sandbox-analytics-api.wildberries.ru

Валидация данных

  • ✅ Валидация штрихкодов (EAN-13, EAN-8, UPC-A, UPC-E)
  • ✅ Проверка структуры данных товаров
  • ✅ Валидация цен и остатков
  • ✅ Обработка ошибок API

📁 Структура проекта

wildberries/
├── credentials/
│   └── WildberriesApi.credentials.ts    # Credentials для аутентификации
├── nodes/
│   └── wildberries/
│       ├── Wildberries.node.ts          # Основная нода
│       ├── types.ts                     # TypeScript типы
│       ├── utils.ts                     # Утилиты и валидация
│       ├── examples.json                # Примеры данных
│       ├── test.ts                      # Тесты валидации
│       ├── package.json                 # Конфигурация ноды
│       ├── wildberries.svg              # Иконка ноды
│       └── README.md                    # Документация ноды
├── package.json                         # Основной package.json
├── tsconfig.json                        # Конфигурация TypeScript
├── tslint.json                          # Правила линтера
└── README.md                            # Этот файл

🛠 Установка

  1. Клонируйте репозиторий:

    git clone <repository-url>
cd wildberries

  2. Установите зависимости:

    npm install

  3. Соберите проект:

    npm run build

  4. Установите в n8n:

    • Скопируйте папку dist в папку community nodes n8n
    • Или используйте как npm пакет

🔑 Настройка

Получение API токена

  1. Войдите в личный кабинет продавца Wildberries
  2. Перейдите в раздел "Настройки" → "Доступ к API"
  3. Создайте новый токен с необходимыми правами

Настройка credentials в n8n

  1. Создайте новые credentials типа "Wildberries API"
  2. Введите полученный токен
  3. Выберите окружение (Production/Sandbox)

📖 Примеры использования

Создание карточки товара

{
  "vendor": "ООО Производитель",
  "name": "Футболка хлопковая",
  "barcode": "1234567890123",
  "price": 1500,
  "sizes": [
    {
      "techSize": "S",
      "wbSize": "46", 
      "price": 1500,
      "skus": ["1234567890123"]
    }
  ]
}

Обновление цен

[
  {
    "nm": 123456789,
    "price": 1800
  },
  {
    "nm": 123456790,
    "price": 2000
  }
]

Обновление остатков

[
  {
    "sku": "1234567890123",
    "amount": 50
  },
  {
    "sku": "1234567890124", 
    "amount": 30
  }
]

🧪 Тестирование

Запустите тесты валидации:

npm run test

Или скомпилированные тесты:

node dist/nodes/wildberries/test.js

📚 API Endpoints

Content API

  • POST /content/v1/cards/create - Создание карточки товара
  • POST /content/v1/cards/list - Получение списка товаров

Marketplace API

  • POST /public/api/v1/prices - Обновление цен
  • POST /api/v3/stocks - Обновление остатков
  • POST /public/api/v1/updateDiscounts - Обновление скидок
  • GET /api/v3/orders - Получение заказов
  • PUT /api/v3/orders/{orderId}/status - Обновление статуса заказа
  • POST /api/v3/supplies - Создание поставки
  • POST /api/v3/supplies/{supplyId}/barcodes - Добавление товаров в поставку

Analytics API

  • GET /api/v1/supplier/sales - Отчет по продажам
  • GET /api/v1/supplier/stocks - Остатки на складах
  • GET /api/v1/supplier/sales-funnel - Воронка продаж

🐛 Обработка ошибок

Нода включает полную обработку ошибок:

  • Ошибки аутентификации
  • Ошибки валидации данных
  • Rate limit превышения
  • Ошибки API (409, 500, etc.)
  • Сетевые ошибки

🔒 Безопасность

  • ✅ Безопасное хранение токенов в credentials
  • ✅ Валидация всех входящих данных
  • ✅ Обработка чувствительной информации
  • ✅ Поддержка HTTPS для всех запросов

📝 Лицензия

MIT License

🤝 Поддержка

Если у вас есть вопросы или предложения:

  1. Создайте issue в репозитории
  2. Обратитесь к документации Wildberries API
  3. Проверьте логи n8n для диагностики

Версия: 1.0.0
Совместимость: n8n 1.0.0+
Node.js: 18.16.16+

Discussion