Синхронізація замовлень між сайтом та маркетплейсами

Синхронізація замовлень між сайтом та маркетплейсами

Замовлення з маркетплейсів і з сайту обробляються в єдиній системі: єдиний склад, єдина CRM, єдина логіка статусів. Маркетплейс бачить оновлення статусу; менеджер бачить всі замовлення в одному інтерфейсі.

Паттерн единої черги замовлень

Ozon Order    ─────┐
WB Order      ──────┼──→ Order Normalizer ──→ Unified Orders DB ──→ Processing
YM Order      ─────┘                                ↓
Site Order    ─────────────────────────────→        WMS / ERP / 1С

Нормалізована структура замовлення

// Єдина схема незалежно від джерела
class UnifiedOrder
{
    public string   $id;
    public string   $source;          // 'site', 'ozon', 'wb', 'yandex_market'
    public string   $sourceOrderId;   // ID замовлення в системі джерела
    public string   $status;          // mapped to unified statuses
    public Customer $customer;
    public array    $items;           // [{product_id, sku, quantity, price}]
    public Shipping $shipping;
    public float    $total;
    public string   $createdAt;
}

Адаптери для кожного маркетплейсу

interface MarketplaceAdapter
{
    public function getNewOrders(): array;
    public function toUnifiedOrder(array $raw): UnifiedOrder;
    public function updateStatus(string $orderId, string $status): void;
}

class OzonAdapter implements MarketplaceAdapter
{
    public function toUnifiedOrder(array $raw): UnifiedOrder
    {
        return new UnifiedOrder(
            source:        'ozon',
            sourceOrderId: $raw['posting_number'],
            status:        $this->mapStatus($raw['status']),
            customer: new Customer(
                name:  $raw['customer']['name'],
                phone: $raw['customer']['phone'] ?? null,
            ),
            items: array_map(fn($item) => [
                'sku'      => $item['offer_id'],
                'quantity' => $item['quantity'],
                'price'    => $item['price'],
                'name'     => $item['name'],
            ], $raw['products']),
            shipping: new Shipping(
                address:  $raw['delivery_method']['warehouse'] ?? null,
                method:   $raw['delivery_method']['name'],
            ),
            total:     $raw['financial_data']['total_amount'],
            createdAt: $raw['created_at'],
        );
    }

    public function updateStatus(string $orderId, string $unifiedStatus): void
    {
        $ozonStatus = $this->reverseMapStatus($unifiedStatus);
        $this->ozon->updatePostingStatus($orderId, $ozonStatus);
    }
}

Машина станів

class OrderStatusMachine
{
    private array $statusMap = [
        // unified → специфічні маркетплейсу
        'confirmed' => [
            'ozon' => 'awaiting_deliver',
            'wb'   => 'confirm',
            'ym'   => 'PROCESSING',
        ],
        'shipped' => [
            'ozon' => 'delivering',
            'wb'   => 'complete',
            'ym'   => 'DELIVERY',
        ],
    ];

    public function syncStatus(Order $order, string $newStatus): void
    {
        $order->update(['status' => $newStatus]);

        if ($order->source !== 'site') {
            $adapter = $this->getAdapter($order->source);
            $adapter->updateStatus($order->source_order_id, $newStatus);
        }
    }
}

Обробка повернень

class ReturnProcessor
{
    public function processMarketplaceReturn(array $returnData, string $source): void
    {
        $order = Order::where('source', $source)
                      ->where('source_order_id', $returnData['order_id'])
                      ->firstOrFail();

        Return::create([
            'order_id' => $order->id,
            'items'    => $returnData['items'],
            'reason'   => $returnData['reason'],
            'source'   => $source,
        ]);

        // Відновлюємо залишок
        foreach ($returnData['items'] as $item) {
            Product::find($item['product_id'])?->increment('stock', $item['quantity']);
        }

        // Сповіщаємо менеджера
        app(TelegramNotifier::class)->notifyReturn($order);
    }
}

Строки

Синхронізація замовлень для 2–3 маркетплейсів з єдиною панеллю управління: 16–24 робочих дні.