Pre-Order-Declare-Stock
Pre-Order Declare Stock - Seller Documentation
Overview
Declared stock is now available for pre-order products, allowing sellers to take more orders than they currently have in physical inventory by leveraging external stock providers.
How It Works
Key Concepts
auctionedKeys
: Maximum number of orders you can accept for a productdeclaredStock
: Number of items you actually have ready for immediate deliveryavailable
: Total available inventory (regular inventory + declared stock)
Example Scenario
{
"yourPrice": 1,
"product": {
"productId": 113538
},
"declaredStock": 20,
"auctionedKeys": 100
}
What this means:
✅ You can accept 100 orders (auctionedKeys)
✅ You have 20 items ready for immediate delivery (declaredStock)
✅ 20 orders will be fulfilled immediately
⏳ 80 orders will wait until more stock becomes available
Order Processing Flow
1. Immediate Fulfillment
Orders are fulfilled using available inventory first
If declared stock is available, orders are processed through external providers
Successful orders are marked as fulfilled and customers receive their items
2. Declare Stock Processing
When regular inventory is insufficient, the system attempts to fulfill orders using declared stock:
Reservation: Items are reserved from the declared stock provider
Provision: Keys are requested from the provider
Validation: Keys are validated (text/image format, content quality)
Allocation: Valid keys are allocated to customers
Email Notification: Customers receive delivery emails
Service fees are charged in the following scenarios:
1. Provision Failures
When: External provider fails to deliver valid keys
Charged To: Seller's account
Purpose: Covers platform costs for failed provision attempts
2. Key Validation Failures
When: Provider delivers invalid keys (empty, malformed, or low-quality)
Examples of Invalid Keys:
Empty or null values
Keys with incorrect format
Important Rules & Limitations
2. Order Priority
Driffle Plus Members: Get priority in the fulfillment queue
FIFO: Within the same tier, orders are processed first-come-first-served
Early Access: Orders placed 14+ hours before release get early access emails
Conclusion
Pre-order declare stock is a powerful feature that allows you to scale beyond your immediate inventory while maintaining customer satisfaction. Success depends on:
Reliable Providers: Choose providers with high success rates
Proper Pricing: Ensure margins can cover service fees
Active Monitoring: Track metrics and respond to issues quickly
Customer Communication: Set clear expectations and provide updates
By following these guidelines and best practices, you can maximize the benefits of the declare stock system while minimizing risks and service fee charges.
Last updated