Tutorials Microservices with .NET

Inventory Microservice — Complete Guide

Inventory Microservice — Complete Guide: free step-by-step lesson with examples, common mistakes, and interview tips — part of Microservices with .NET on Toolliyo Academy.

On this page

Microservices with .NET · Lesson 21 of 131

Inventory Microservice

Beginner ✓IntermediateAdvancedProfessional

Intermediate · 2 — Building services · ~6 min · Module 3: ShopNest Services and Integration

What is this?

Inventory Microservice tracks stock — how many units in warehouse, reserved for orders, available to sell.

Why should you care?

Stock changes constantly (sales, returns, warehouse sync). Splitting Inventory prevents catalog deploys from breaking stock counts.

See it live — copy this example

Create a Web API project (dotnet new webapi), paste the code, then run dotnet run.

app.MapGet("/inventory/{productId:int}", async (int productId, InventoryDbContext db) =>
{
    var row = await db.Stock.FindAsync(productId);
    return row is null ? Results.NotFound() : Results.Ok(new { productId, row.Available });
});

app.MapPost("/inventory/reserve", async (ReserveStockDto dto, InventoryDbContext db) =>
{
    var row = await db.Stock.FindAsync(dto.ProductId)
        ?? throw new InvalidOperationException("SKU not found");
    if (row.Available < dto.Qty) return Results.Conflict("Insufficient stock");
    row.Available -= dto.Qty;
    row.Reserved += dto.Qty;
    await db.SaveChangesAsync();
    return Results.Ok();
});

Run Example »

Edit the code and click Run — like W3Schools Try it Yourself.

Code
Result

What happened?

  • Reserve moves units from Available to Reserved when order starts.
  • Commit or release happens on payment success/failure — saga in module 4.

Try it yourself

  1. Create Inventory.Api with Stock table (ProductId, Available, Reserved).
  2. Seed stock for products from Product service ids.
  3. build GET and POST reserve.
  4. Change a string or route in the example and save — watch Swagger or the RabbitMQ Management UI update.
  5. Break the code on purpose (remove a semicolon), read the error message, then fix it.

Remember

Inventory owns stock counts and reserve/commit. Overselling is fought with reservations + saga compensation. Product catalog displays stock; Inventory enforces it.

Real-world: Flipkart oversell incident

Without reserve, two customers buy last TV simultaneously. Inventory service serializes reserve with transaction or optimistic concurrency.

Outcome: Only one checkout wins; other gets clear "out of stock" message.

Questions on this lesson 0

Sign in to ask a question or upvote helpful answers.

No questions yet — be the first to ask!

Microservices with .NET
Course syllabus

Microservices with .NET Tutorial

Module 1: Foundations and Fundamentals
Module 2: Building User Microservice
Module 3: ShopNest Services and Integration
Module 4: RabbitMQ and Messaging
Module 5: Saga and Distributed Transactions
Module 6: API Gateway
Module 7: gRPC, CQRS, and GraphQL
Module 8: Resiliency and Fault Tolerance
Module 9: DevOps and Cloud-Native
Module 10: Git and GitHub
Module 11: CI/CD Pipelines
Module 12: Observability and Testing
Module 13: Advanced Topics
Module 14: Real-World Enterprise Projects
Toolliyo Assistant
Ask about tutorials, ebooks, training, pricing, mentor services, and support. I use public site content only—not admin or internal tools.

care@toolliyo.com

Need callback? Share your details