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+