vivo Mall Consignment Business: Heterogeneous System Integration Architecture and Practice

This article shares the integration experience and architectural approach for implementing consignment business in vivo's e-commerce mall, specifically the integration with NetEase Yanxuan platform.

Business Background: To address the limited variety of non-phone products, vivo mall adopted a consignment model where product ownership remains with the external platform (NetEase Yanxuan), using a "sales-driven procurement" approach. This differs from traditional purchasing where vivo buys and owns inventory.

Platform Selection Criteria: The team established key evaluation metrics: clear API documentation, complete interface coverage (full/incremental data sync, async notifications), structured product models, successful case studies, and robust communication mechanisms.

System Architecture: The solution follows an API gateway-like design with three main components: Platform Side → Consignment Platform → Internal Systems. Key design principles include "non-invasive, internally transparent, service-focused with business abstraction capabilities."

Core Modules:

Modular Design: Platform-specific modules are isolated for pluggability and business independence

Routing Layer: Routes requests between internal systems and platform modules

Adapter Layer: Handles field mapping between systems (e.g., vivoSpuId ↔ YxSpuId) and maintains primary key mappings

Service Exposure: Provides mapping queries, reconciliation info, and platform-specific product details

Unified Callback: Opens external interfaces for async notifications (product changes, inventory alerts, order status changes)

Unified Configuration: Uses configuration center for platform credentials, keys, and system monitoring thresholds

Internal System Integration:

Product Center: Added write interfaces with idempotency design and signature verification

Order Center: Adapted order flows - after user places order, consignment platform validates inventory with NetEase; after payment, creates order on NetEase. Includes automatic cancellation for creation failures

Future Outlook: The team aims to establish their own API standards, allowing external platforms to develop interfaces following vivo's specifications, reducing integration costs.