RETURNS — Возвраты и обмен

1. Оформить заявку на возврат
   └─ В личном кабинете или по телефону

2. Получить подтверждение
   └─ Email с инструкцией и адресом

3. Отправить товар
   └─ СДЭК / Почта / привезти в магазин

4. Дождаться проверки
   └─ 1-3 рабочих дня

5. Получить деньги
   └─ На карту в течение 10 дней

┌─────────────────────────────────────────────────────────────┐
│ Возврат товара из заказа #12345                             │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│ Выберите товары для возврата:                               │
│                                                             │
│ [✓] Салют "Большой праздник"    × 2     10 000 ₽           │
│     Причина: [Не понравился ▼]                              │
│                                                             │
│ [ ] Бенгальские огни            × 5        500 ₽           │
│                                                             │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│ Комментарий (необязательно):                                │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │                                                         │ │
│ └─────────────────────────────────────────────────────────┘ │
│                                                             │
│ Как вернуть:                                                │
│ ○ Отправить СДЭК (бесплатно)                                │
│ ● Привезти в магазин                                        │
│                                                             │
│                         [ОФОРМИТЬ ВОЗВРАТ]                  │
└─────────────────────────────────────────────────────────────┘

ЗАЯВКА СОЗДАНА
     │
     ▼
ОЖИДАЕТ ПОЛУЧЕНИЯ ─────► ТОВАР ПОЛУЧЕН
     │                         │
     ▼                         ▼
 [ОТМЕНЕНА]               ПРОВЕРКА
                               │
               ┌───────────────┼───────────────┐
               ▼               ▼               ▼
          ОДОБРЕН         ЧАСТИЧНО        ОТКЛОНЁН
               │           ОДОБРЕН              │
               ▼               │                ▼
        ВОЗВРАТ ДЕНЕГ          │          [ТОВАР
               │               │           ВОЗВРАЩЁН
               ▼               │           ПОКУПАТЕЛЮ]
          ЗАВЕРШЁН ◄───────────┘

┌─────────────────────────────────────────────────────────────┐
│ Обмен товара                                                │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│ Возвращаете:                                                │
│ [Фото] Салют "Большой праздник" 36 залпов     5 000 ₽      │
│                                                             │
│ Получаете:                                                  │
│ [Фото] Салют "Мега праздник" 49 залпов        7 000 ₽      │
│                                                             │
│ Доплата: 2 000 ₽                                            │
│                                                             │
│                              [ОФОРМИТЬ ОБМЕН]               │
└─────────────────────────────────────────────────────────────┘

Заказ #12345 — 10 850 ₽

Возврат:
- Салют "Большой праздник" × 1: 5 000 ₽
- Доставка: 0 ₽ (если не все товары)

Итого к возврату: 5 000 ₽
Остаётся заказ на: 5 850 ₽

Действия покупателя:
1. Осмотреть при получении
2. Если повреждён — акт с курьером/ПВЗ
3. Фото повреждений
4. Заявка на возврат с фото

Действия магазина:
1. Получить фото и акт
2. Запросить компенсацию у СДЭК
3. Вернуть деньги покупателю или отправить замену

Действия:
1. Покупатель отправляет фото
2. Сравнение с карточкой товара
3. Если расхождение — бесплатный возврат + извинения
4. Исправить описание на сайте

Действия:
1. Фото/видео брака
2. Бесплатный возврат
3. Варианты:
   - Возврат денег
   - Замена на новый
   - Ремонт (если возможно)

/returns

┌─────────────────────────────────────────────────────────────┐
│ Возврат и обмен                                             │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│ [Таблица: сроки, условия]                                   │
│                                                             │
│ ## Как оформить возврат                                     │
│ [Шаги 1-2-3 с иконками]                                     │
│                                                             │
│ ## Невозвратные товары                                      │
│ [Список]                                                    │
│                                                             │
│ ## FAQ                                                      │
│ [Аккордеон с вопросами]                                     │
│                                                             │
│ [ОФОРМИТЬ ВОЗВРАТ]                                          │
│                                                             │
│ Контакты для вопросов:                                      │
│ 📞 8-800-...  💬 Telegram                                   │
└─────────────────────────────────────────────────────────────┘

// Создание возврата
$return = Return::create([
  'type' => 'default',
  'order_id' => $order->id(),
  'state' => 'pending',
]);

// Добавление товаров
foreach ($items as $item) {
  $return_item = ReturnItem::create([
    'return_id' => $return->id(),
    'order_item_id' => $item['order_item_id'],
    'quantity' => $item['quantity'],
    'reason' => $item['reason'],
  ]);
  $return_item->save();
}

$return->save();

commerce_return.workflow:
  states:
    pending:
      label: 'Ожидает отправки'
    shipped:
      label: 'Отправлен'
    received:
      label: 'Получен'
    approved:
      label: 'Одобрен'
    partially_approved:
      label: 'Частично одобрен'
    rejected:
      label: 'Отклонён'
    refunded:
      label: 'Возвращены деньги'
    completed:
      label: 'Завершён'

Возвраты за декабрь 2025:

Всего заявок: 45
Одобрено: 42 (93%)
Отклонено: 3 (7%)

По причинам:
- Передумал: 20 (44%)
- Не подошёл: 12 (27%)
- Брак: 8 (18%)
- Повреждён при доставке: 5 (11%)

Сумма возвратов: 180 000 ₽
% от продаж: 3.2%