Published: 30-06-2025
25 min read
#Json

| Metric | Before | After |
| Order Cancellation | 50% | <5% |
| Cart abandonment | - | -35% |
| Revenue per flash sale | - | +$X |



| Entity | Purpose | Key Fields | Calculation |
| IP | Product + Location base | `onHand`, `productRef`, `locationRef` | `SUM(ACTIVE status IQ records)` |
| IQ | Transaction records | `type`, `quantity`, `status` | Individual stock events |
| VP | Channel availability | `channel`, `buffer`, `availableToSell` | `IP.onHand - buffer` |

`ACTIVE` status IQ records. When soft reservations convert to orders, the status changes maintain inventory accuracy.
`virtualPositions` and `fulfilmentOptions`. Choosing the right one depends on whether you're reading availability or actively managing reservations.
| Use Case | API to Use | Reason |
| Browse/search listings | `virtualPositions` | Lightweight read, no inventory impact |
| Add to Cart | `fulfilmentOptions` | Initiates soft reservation, prevents overselling |
| Begin Checkout | `fulfilmentOptions` | Ensures held inventory for this customer |
| Confirm Order | `fulfilmentOptions` | Converts soft reservation to firm allocation |
`virtualPositions` Query (Read-Only)
`fulfilmentOptions` Mutation (Transactional)



| Metric | Indicative Value |
| Inventory Accuracy | 99.0% |
| Fulfillment SLA | 99.5% |
| Uptime | 99.99% |
| API Response Time | <200ms |
| Cart Abandonment Drop | 35% |
| Support Ticket Reduction | 65% |
Girish Padmanabha
1{
2 "ref": "ACME_SNEAKER_BLK_US9:MAIN_DC:DEFAULT",
3 "productRef": "ACME_SNEAKER_BLK_US9",
4 "locationRef": "MAIN_DC",
5 "onHand": 45
6}1[
2 {
3 "ipRef": "ACME_SNEAKER_BLK_US9:MAIN_DC:DEFAULT",
4 "iqRef": "ACME_SNEAKER_BLK_US9:MAIN_DC:DEFAULT:LAST_ON_HAND",
5 "type": "LAST_ON_HAND",
6 "quantity": 50,
7 "status": "ACTIVE"
8 },
9 {
10 "ipRef": "ACME_SNEAKER_BLK_US9:MAIN_DC:DEFAULT",
11 "iqRef": "ACME_SNEAKER_BLK_US9:MAIN_DC:DEFAULT:SOFT_RESERVE:FO_1234",
12 "type": "SOFT_RESERVE",
13 "quantity": -2,
14 "status": "ACTIVE"
15 },
16 {
17 "ipRef": "ACME_SNEAKER_BLK_US9:MAIN_DC:DEFAULT",
18 "iqRef": "ACME_SNEAKER_BLK_US9:MAIN_DC:DEFAULT:RESERVED:FUL_456",
19 "type": "RESERVED",
20 "quantity": -3,
21 "status": "ACTIVE"
22 }
23]1{
2 "ref": "ACME_SNEAKER_BLK_US9:MAIN_DC:ECOMMERCE",
3 "productRef": "ACME_SNEAKER_BLK_US9",
4 "locationRef": "MAIN_DC",
5 "quantity": 40
6}