Unavailable Product Scenarios

The system automatically handles products that become unavailable after being added to the basket:

Automatic Removal:

  • On basket retrieval (GET /basket/), unavailable products are automatically removed

  • Removed products are listed in unavailable_basket_products response field

  • Includes product details and quantity that was removed

Unavailability Reasons:

  • Product becomes inactive (is_active = false)

  • Product type changes to non-purchasable (product_meta, grouped)

  • Insufficient stock for requested quantity

  • Product deleted from system

  • Marketplace: Datasource becomes inactive or product mapping removed

Response Handling:

  • unavailable_basket_products array contains removed items

  • Each entry includes: pk, name, unavailable_quantity

  • Promotional offers are recalculated without removed items

  • Client should display notification about removed products

Was this helpful?