{"info":{"_postman_id":"b2f8c985-2640-4674-9868-9ba060d55b51","name":"StockMaster API Documentation","description":"

Import this collection into Postman for StockMaster API documentation and testing.

Usage flow:

Set baseUrl (default http://localhost:3000)
Run Auth -> Signup (optional)
Run Auth -> Verify OTP (if signup used)
Run Auth -> Login
Use other endpoints (session cookie from login should be reused by Postman cookie jar).

All POST/PUT endpoints include demo JSON objects.

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"39189509","collectionId":"b2f8c985-2640-4674-9868-9ba060d55b51","publishedId":"2sBXigMtds","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-03-16T04:45:45.000Z"},"item":[{"name":"Auth","item":[{"name":"Login","id":"616e88be-dc95-4624-b0a0-9581636a548b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"loginId\": \"manager01\",\n \"password\": \"StrongPass@123\"\n}"},"url":"http://localhost:3000/api/auth/login","description":"

\n","urlObject":{"path":["api","auth","login"],"host":["http://localhost:3000"],"query":[],"variable":[]}},"response":[],"_postman_id":"616e88be-dc95-4624-b0a0-9581636a548b"},{"name":"Signup","id":"e80f8928-51b3-44e1-83f8-100340972fa1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"loginId\": \"manager01\",\n \"fullName\": \"Inventory Manager\",\n \"email\": \"manager01@example.com\",\n \"phone\": \"9876543210\",\n \"password\": \"StrongPass@123\",\n \"confirmPassword\": \"StrongPass@123\",\n \"role\": \"inventory_manager\"\n}"},"url":"http://localhost:3000/api/auth/signup","description":"

Create new user account. OTP verification required before login.

\n","urlObject":{"path":["api","auth","signup"],"host":["http://localhost:3000"],"query":[],"variable":[]}},"response":[],"_postman_id":"e80f8928-51b3-44e1-83f8-100340972fa1"},{"name":"Verify OTP","id":"253b1351-c1a9-418c-97fd-d518d6049597","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"email\": \"manager01@example.com\",\n \"token\": \"123456\"\n}"},"url":"http://localhost:3000/api/auth/verify","description":"

Verify signup OTP sent on email.

\n","urlObject":{"path":["api","auth","verify"],"host":["http://localhost:3000"],"query":[],"variable":[]}},"response":[],"_postman_id":"253b1351-c1a9-418c-97fd-d518d6049597"},{"name":"Forgot Password","id":"4ba01df1-6fd3-4564-8c6a-8b19ca83771a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"email\": \"manager01@example.com\"\n}"},"url":"http://localhost:3000/api/auth/forgot","description":"

Request password reset OTP.

\n","urlObject":{"path":["api","auth","forgot"],"host":["http://localhost:3000"],"query":[],"variable":[]}},"response":[],"_postman_id":"4ba01df1-6fd3-4564-8c6a-8b19ca83771a"},{"name":"Reset Password","id":"2ebd5e61-f11c-4db9-9b23-9611b89c1687","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"email\": \"manager01@example.com\",\n \"token\": \"123456\",\n \"password\": \"NewStrong@123\",\n \"confirmPassword\": \"NewStrong@123\"\n}"},"url":"http://localhost:3000/api/auth/reset","description":"

Reset password using OTP token.

\n","urlObject":{"path":["api","auth","reset"],"host":["http://localhost:3000"],"query":[],"variable":[]}},"response":[],"_postman_id":"2ebd5e61-f11c-4db9-9b23-9611b89c1687"},{"name":"Logout","id":"b34f0fe2-d82c-4216-b116-e53f168d51f6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"url":"http://localhost:3000/api/auth/logout","description":"

Logout current session.

\n","urlObject":{"path":["api","auth","logout"],"host":["http://localhost:3000"],"query":[],"variable":[]}},"response":[],"_postman_id":"b34f0fe2-d82c-4216-b116-e53f168d51f6"}],"id":"68dcc8ec-4d47-47f7-a6bd-c4b9426e2c57","_postman_id":"68dcc8ec-4d47-47f7-a6bd-c4b9426e2c57","description":""},{"name":"Profile","item":[{"name":"Get Profile","id":"d59d733b-4c64-48f3-9106-afa7d1778792","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:3000/api/profile","description":"

Get current logged-in profile.

\n","urlObject":{"path":["api","profile"],"host":["http://localhost:3000"],"query":[],"variable":[]}},"response":[],"_postman_id":"d59d733b-4c64-48f3-9106-afa7d1778792"},{"name":"Update Profile","id":"94c736e7-92c3-43b8-bbc3-7a706dd2cb41","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"full_name\": \"Inventory Manager Updated\",\n \"phone\": \"9999999999\",\n \"default_warehouse_id\": \"22222222-2222-2222-2222-222222222222\"\n}"},"url":"http://localhost:3000/api/profile","description":"

Update profile fields for current user.

\n","urlObject":{"path":["api","profile"],"host":["http://localhost:3000"],"query":[],"variable":[]}},"response":[],"_postman_id":"94c736e7-92c3-43b8-bbc3-7a706dd2cb41"}],"id":"16735c03-5ec3-4dec-8093-a9fdbc5952a0","_postman_id":"16735c03-5ec3-4dec-8093-a9fdbc5952a0","description":""},{"name":"Categories","item":[{"name":"List Categories","id":"48b3dbf8-5eb7-49fd-9b20-a715dfc6d9c9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:3000/api/categories","description":"

Get all product categories (inventory manager).

\n","urlObject":{"path":["api","categories"],"host":["http://localhost:3000"],"query":[],"variable":[]}},"response":[],"_postman_id":"48b3dbf8-5eb7-49fd-9b20-a715dfc6d9c9"},{"name":"Create Category","id":"a7d910a7-11b2-467d-b62c-615da9600484","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"name\": \"Beverages\",\n \"description\": \"Drinks and related items\"\n}"},"url":"http://localhost:3000/api/categories","description":"

Create product category.

\n","urlObject":{"path":["api","categories"],"host":["http://localhost:3000"],"query":[],"variable":[]}},"response":[],"_postman_id":"a7d910a7-11b2-467d-b62c-615da9600484"},{"name":"Get Category By ID","id":"bd3884b0-6f78-40bc-bf61-7f724fe1d9f9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:3000/api/categories/11111111-1111-1111-1111-111111111111","description":"

Fetch one category by id.

\n","urlObject":{"path":["api","categories","11111111-1111-1111-1111-111111111111"],"host":["http://localhost:3000"],"query":[],"variable":[]}},"response":[],"_postman_id":"bd3884b0-6f78-40bc-bf61-7f724fe1d9f9"},{"name":"Update Category","id":"3954c6e9-a8dd-46e1-bea3-c5ad3c13efc9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"name\": \"Beverages Updated\",\n \"description\": \"Updated description\"\n}"},"url":"http://localhost:3000/api/categories/11111111-1111-1111-1111-111111111111","description":"

Update category name/description.

\n","urlObject":{"path":["api","categories","11111111-1111-1111-1111-111111111111"],"host":["http://localhost:3000"],"query":[],"variable":[]}},"response":[],"_postman_id":"3954c6e9-a8dd-46e1-bea3-c5ad3c13efc9"},{"name":"Delete Category","id":"216e290b-d7df-41f6-9e29-affbf2b3e1a6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"http://localhost:3000/api/categories/11111111-1111-1111-1111-111111111111","description":"

Delete category by id.

\n","urlObject":{"path":["api","categories","11111111-1111-1111-1111-111111111111"],"host":["http://localhost:3000"],"query":[],"variable":[]}},"response":[],"_postman_id":"216e290b-d7df-41f6-9e29-affbf2b3e1a6"}],"id":"d6944e6c-2367-4bd4-924e-26da9e4a4d44","_postman_id":"d6944e6c-2367-4bd4-924e-26da9e4a4d44","description":""},{"name":"Warehouses","item":[{"name":"List Warehouses","id":"15a79c1d-301b-4593-b6e3-810c406f5a96","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:3000/api/warehouses","description":"

Get all warehouses.

\n","urlObject":{"path":["api","warehouses"],"host":["http://localhost:3000"],"query":[],"variable":[]}},"response":[],"_postman_id":"15a79c1d-301b-4593-b6e3-810c406f5a96"},{"name":"Create Warehouse","id":"b1b256b5-b8bb-4425-9f8b-419c1fc1dcfc","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"name\": \"Main Warehouse\",\n \"code\": \"WH-MAIN\",\n \"address\": \"Industrial Area, Sector 12\"\n}"},"url":"http://localhost:3000/api/warehouses","description":"

Create warehouse (inventory manager).

\n","urlObject":{"path":["api","warehouses"],"host":["http://localhost:3000"],"query":[],"variable":[]}},"response":[],"_postman_id":"b1b256b5-b8bb-4425-9f8b-419c1fc1dcfc"},{"name":"Get Warehouse By ID","id":"647c99cd-688b-4d34-942e-233896679fb7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:3000/api/warehouses/22222222-2222-2222-2222-222222222222","description":"

Get single warehouse by id.

\n","urlObject":{"path":["api","warehouses","22222222-2222-2222-2222-222222222222"],"host":["http://localhost:3000"],"query":[],"variable":[]}},"response":[],"_postman_id":"647c99cd-688b-4d34-942e-233896679fb7"},{"name":"Update Warehouse","id":"4680d8dc-2d55-4dc0-bb3c-139fb54316f1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"name\": \"Main Warehouse Updated\",\n \"code\": \"WH-MAIN-01\",\n \"address\": \"New address line\"\n}"},"url":"http://localhost:3000/api/warehouses/22222222-2222-2222-2222-222222222222","description":"

Update warehouse details.

\n","urlObject":{"path":["api","warehouses","22222222-2222-2222-2222-222222222222"],"host":["http://localhost:3000"],"query":[],"variable":[]}},"response":[],"_postman_id":"4680d8dc-2d55-4dc0-bb3c-139fb54316f1"},{"name":"Delete Warehouse","id":"0be8e5b2-a9a2-4875-bd32-370da8439ed0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"http://localhost:3000/api/warehouses/22222222-2222-2222-2222-222222222222","description":"

Delete warehouse by id.

\n","urlObject":{"path":["api","warehouses","22222222-2222-2222-2222-222222222222"],"host":["http://localhost:3000"],"query":[],"variable":[]}},"response":[],"_postman_id":"0be8e5b2-a9a2-4875-bd32-370da8439ed0"}],"id":"bac09243-2e58-4f3e-81a9-3fea0e6d5945","_postman_id":"bac09243-2e58-4f3e-81a9-3fea0e6d5945","description":""},{"name":"Locations","item":[{"name":"List Locations","id":"eb8b04eb-3d1a-475a-a70e-72dc2ffae3e4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:3000/api/locations","description":"

Get all locations.

\n","urlObject":{"path":["api","locations"],"host":["http://localhost:3000"],"query":[],"variable":[]}},"response":[],"_postman_id":"eb8b04eb-3d1a-475a-a70e-72dc2ffae3e4"},{"name":"Create Location","id":"7c302087-ffb9-4fcb-90bf-cb12269c8f02","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"name\": \"Rack A1\",\n \"code\": \"A1\",\n \"warehouse_id\": \"22222222-2222-2222-2222-222222222222\",\n \"type\": \"storage\"\n}"},"url":"http://localhost:3000/api/locations","description":"

Create location under warehouse.

\n","urlObject":{"path":["api","locations"],"host":["http://localhost:3000"],"query":[],"variable":[]}},"response":[],"_postman_id":"7c302087-ffb9-4fcb-90bf-cb12269c8f02"},{"name":"Get Location By ID","id":"77e24362-c647-4136-bf22-c380720ce6db","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:3000/api/locations/33333333-3333-3333-3333-333333333333","description":"

Get single location by id.

\n","urlObject":{"path":["api","locations","33333333-3333-3333-3333-333333333333"],"host":["http://localhost:3000"],"query":[],"variable":[]}},"response":[],"_postman_id":"77e24362-c647-4136-bf22-c380720ce6db"},{"name":"Update Location","id":"fedea428-73dd-42e2-907e-7f3162b0f28e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"name\": \"Rack A1 Updated\",\n \"code\": \"A1-U\",\n \"warehouse_id\": \"22222222-2222-2222-2222-222222222222\",\n \"type\": \"storage\"\n}"},"url":"http://localhost:3000/api/locations/33333333-3333-3333-3333-333333333333","description":"

Update location details.

Delete location by id.

\n","urlObject":{"path":["api","locations","33333333-3333-3333-3333-333333333333"],"host":["http://localhost:3000"],"query":[],"variable":[]}},"response":[],"_postman_id":"49cc7fff-993c-4558-84ac-eb6d596adcb2"}],"id":"d2154e10-81bc-45da-9b7f-16ab1f609cb2","_postman_id":"d2154e10-81bc-45da-9b7f-16ab1f609cb2","description":""},{"name":"Products","item":[{"name":"List Products","id":"572b8c89-1b16-4aba-9af6-c7c7a493a657","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:3000/api/products?category=11111111-1111-1111-1111-111111111111&sku=COF","description":"

List products. Optional query: category, sku.

\n","urlObject":{"path":["api","products"],"host":["http://localhost:3000"],"query":[{"key":"category","value":"11111111-1111-1111-1111-111111111111"},{"key":"sku","value":"COF"}],"variable":[]}},"response":[],"_postman_id":"572b8c89-1b16-4aba-9af6-c7c7a493a657"},{"name":"Create Product","id":"f98df760-b9c0-4b0f-8242-8db1db0e8569","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"name\": \"Coffee Beans 1kg\",\n \"sku\": \"COF-1KG\",\n \"unit\": \"bag\",\n \"category_id\": \"11111111-1111-1111-1111-111111111111\",\n \"reorder_level\": 20\n}"},"url":"http://localhost:3000/api/products","description":"

Create new product.

\n","urlObject":{"path":["api","products"],"host":["http://localhost:3000"],"query":[],"variable":[]}},"response":[],"_postman_id":"f98df760-b9c0-4b0f-8242-8db1db0e8569"},{"name":"Get Product By ID","id":"4b1d7a52-979e-4815-a05e-2fe9efb4aa88","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:3000/api/products/44444444-4444-4444-4444-444444444444","description":"

Get single product.

\n","urlObject":{"path":["api","products","44444444-4444-4444-4444-444444444444"],"host":["http://localhost:3000"],"query":[],"variable":[]}},"response":[],"_postman_id":"4b1d7a52-979e-4815-a05e-2fe9efb4aa88"},{"name":"Update Product","id":"9d65e42d-094e-4711-992d-633f67a507fc","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"name\": \"Coffee Beans Premium 1kg\",\n \"sku\": \"COF-1KG-P\",\n \"unit\": \"bag\",\n \"category_id\": \"11111111-1111-1111-1111-111111111111\",\n \"reorder_level\": 25\n}"},"url":"http://localhost:3000/api/products/44444444-4444-4444-4444-444444444444","description":"

Update product fields.

\n","urlObject":{"path":["api","products","44444444-4444-4444-4444-444444444444"],"host":["http://localhost:3000"],"query":[],"variable":[]}},"response":[],"_postman_id":"9d65e42d-094e-4711-992d-633f67a507fc"}],"id":"6723486f-926b-40b6-854f-99552586f56e","_postman_id":"6723486f-926b-40b6-854f-99552586f56e","description":""},{"name":"Receipts","item":[{"name":"List Receipts","id":"b2bf90d2-e076-481e-bc2a-097df554d4b8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:3000/api/receipts?status=draft&warehouse_id=22222222-2222-2222-2222-222222222222","description":"

List receipts. Optional query: status, warehouse_id.

\n","urlObject":{"path":["api","receipts"],"host":["http://localhost:3000"],"query":[{"key":"status","value":"draft"},{"key":"warehouse_id","value":"22222222-2222-2222-2222-222222222222"}],"variable":[]}},"response":[],"_postman_id":"b2bf90d2-e076-481e-bc2a-097df554d4b8"},{"name":"Create Receipt","id":"5753c734-cfd3-4a72-a342-02233e5dc53d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"reference_no\": \"RCPT-2026-0001\",\n \"supplier_name\": \"ABC Supplier Pvt Ltd\",\n \"warehouse_id\": \"22222222-2222-2222-2222-222222222222\",\n \"status\": \"draft\",\n \"notes\": \"Expected morning delivery\",\n \"items\": [\n {\n \"product_id\": \"44444444-4444-4444-4444-444444444444\",\n \"quantity\": 50,\n \"unit_price\": 320\n }\n ]\n}"},"url":"http://localhost:3000/api/receipts","description":"

Create inbound receipt with line items.

\n","urlObject":{"path":["api","receipts"],"host":["http://localhost:3000"],"query":[],"variable":[]}},"response":[],"_postman_id":"5753c734-cfd3-4a72-a342-02233e5dc53d"},{"name":"Get Receipt By ID","id":"96e51aa5-8dfe-446d-9e7a-8ae5f6bfcefd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:3000/api/receipts/55555555-5555-5555-5555-555555555555","description":"

Get detailed receipt with items.

\n","urlObject":{"path":["api","receipts","55555555-5555-5555-5555-555555555555"],"host":["http://localhost:3000"],"query":[],"variable":[]}},"response":[],"_postman_id":"96e51aa5-8dfe-446d-9e7a-8ae5f6bfcefd"},{"name":"Update Receipt","id":"9226f665-ca3a-4624-8b9c-07e85290d3d6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"supplier_name\": \"ABC Supplier Pvt Ltd\",\n \"status\": \"received\",\n \"warehouse_id\": \"22222222-2222-2222-2222-222222222222\",\n \"notes\": \"All boxes received\",\n \"items\": [\n {\n \"product_id\": \"44444444-4444-4444-4444-444444444444\",\n \"quantity\": 48,\n \"unit_price\": 315\n }\n ]\n}"},"url":"http://localhost:3000/api/receipts/55555555-5555-5555-5555-555555555555","description":"

Update receipt and optionally replace items.

Validate and commit receipt into stock ledger.

\n","urlObject":{"path":["api","receipts","55555555-5555-5555-5555-555555555555","validate"],"host":["http://localhost:3000"],"query":[],"variable":[]}},"response":[],"_postman_id":"7894b5e6-b754-42a7-affd-4ec4f99b87d5"},{"name":"Export Receipt CSV","id":"8fb5d802-f841-4920-a058-348b604e20eb","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:3000/api/receipts/55555555-5555-5555-5555-555555555555/export","description":"

Export receipt as CSV file.

\n","urlObject":{"path":["api","receipts","55555555-5555-5555-5555-555555555555","export"],"host":["http://localhost:3000"],"query":[],"variable":[]}},"response":[],"_postman_id":"8fb5d802-f841-4920-a058-348b604e20eb"}],"id":"0e9b2588-d061-4637-8e70-06a674a6d5cb","_postman_id":"0e9b2588-d061-4637-8e70-06a674a6d5cb","description":""},{"name":"Deliveries","item":[{"name":"List Deliveries","id":"84da486a-8045-4575-a1de-4a1fb6a09532","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:3000/api/deliveries?status=draft&warehouse_id=22222222-2222-2222-2222-222222222222","description":"

List deliveries. Optional query: status, warehouse_id.

\n","urlObject":{"path":["api","deliveries"],"host":["http://localhost:3000"],"query":[{"key":"status","value":"draft"},{"key":"warehouse_id","value":"22222222-2222-2222-2222-222222222222"}],"variable":[]}},"response":[],"_postman_id":"84da486a-8045-4575-a1de-4a1fb6a09532"},{"name":"Create Delivery","id":"0f6a41bc-fece-42d2-aec0-21f9a6fe7248","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"reference_no\": \"DLV-2026-0001\",\n \"customer\": \"XYZ Retail\",\n \"warehouse_id\": \"22222222-2222-2222-2222-222222222222\",\n \"status\": \"draft\",\n \"notes\": \"Dispatch by evening\",\n \"items\": [\n {\n \"product_id\": \"44444444-4444-4444-4444-444444444444\",\n \"quantity\": 10\n }\n ]\n}"},"url":"http://localhost:3000/api/deliveries","description":"

Create outbound delivery with items.

\n","urlObject":{"path":["api","deliveries"],"host":["http://localhost:3000"],"query":[],"variable":[]}},"response":[],"_postman_id":"0f6a41bc-fece-42d2-aec0-21f9a6fe7248"},{"name":"Get Delivery By ID","id":"5a8536b1-2735-431b-a7ff-4aebfd4cc254","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:3000/api/deliveries/66666666-6666-6666-6666-666666666666","description":"

Get delivery details and items.

\n","urlObject":{"path":["api","deliveries","66666666-6666-6666-6666-666666666666"],"host":["http://localhost:3000"],"query":[],"variable":[]}},"response":[],"_postman_id":"5a8536b1-2735-431b-a7ff-4aebfd4cc254"},{"name":"Update Delivery","id":"4f6b303e-b058-4c2e-9bbb-547581c4d547","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"customer\": \"XYZ Retail Updated\",\n \"status\": \"ready\",\n \"warehouse_id\": \"22222222-2222-2222-2222-222222222222\",\n \"notes\": \"Packed and ready\",\n \"items\": [\n {\n \"product_id\": \"44444444-4444-4444-4444-444444444444\",\n \"quantity\": 9\n }\n ]\n}"},"url":"http://localhost:3000/api/deliveries/66666666-6666-6666-6666-666666666666","description":"

Update delivery details and item list.

\n","urlObject":{"path":["api","deliveries","66666666-6666-6666-6666-666666666666"],"host":["http://localhost:3000"],"query":[],"variable":[]}},"response":[],"_postman_id":"4f6b303e-b058-4c2e-9bbb-547581c4d547"},{"name":"Pick Delivery Item","id":"ab71a582-bbf4-41bc-a44d-03a8fbf4685a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"itemId\": \"88888888-8888-8888-8888-888888888888\",\n \"picked\": true\n}"},"url":"http://localhost:3000/api/deliveries/66666666-6666-6666-6666-666666666666/pick","description":"

Mark one delivery item as picked/unpicked.

\n","urlObject":{"path":["api","deliveries","66666666-6666-6666-6666-666666666666","pick"],"host":["http://localhost:3000"],"query":[],"variable":[]}},"response":[],"_postman_id":"ab71a582-bbf4-41bc-a44d-03a8fbf4685a"},{"name":"Pack Delivery Item","id":"9afccd5b-fede-42e0-9034-aea03e2c4181","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"itemId\": \"88888888-8888-8888-8888-888888888888\",\n \"packed\": true\n}"},"url":"http://localhost:3000/api/deliveries/66666666-6666-6666-6666-666666666666/pack","description":"

Mark one delivery item as packed/unpacked.

\n","urlObject":{"path":["api","deliveries","66666666-6666-6666-6666-666666666666","pack"],"host":["http://localhost:3000"],"query":[],"variable":[]}},"response":[],"_postman_id":"9afccd5b-fede-42e0-9034-aea03e2c4181"},{"name":"Validate Delivery","id":"ffc66d2c-0ac4-4921-a244-c40a54e191a3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"url":"http://localhost:3000/api/deliveries/66666666-6666-6666-6666-666666666666/validate","description":"

Validate delivery and commit stock movement.

\n","urlObject":{"path":["api","deliveries","66666666-6666-6666-6666-666666666666","validate"],"host":["http://localhost:3000"],"query":[],"variable":[]}},"response":[],"_postman_id":"ffc66d2c-0ac4-4921-a244-c40a54e191a3"}],"id":"c303c89e-ffa7-4f39-b722-d5490ebc5bce","_postman_id":"c303c89e-ffa7-4f39-b722-d5490ebc5bce","description":""},{"name":"Transfers","item":[{"name":"List Transfers","id":"72e22bc8-c4e3-4381-a7a7-7f3c7b3b654f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:3000/api/transfers?status=draft","description":"

List internal transfers. Optional query: status.

\n","urlObject":{"path":["api","transfers"],"host":["http://localhost:3000"],"query":[{"key":"status","value":"draft"}],"variable":[]}},"response":[],"_postman_id":"72e22bc8-c4e3-4381-a7a7-7f3c7b3b654f"},{"name":"Create Transfer","id":"2ce34e93-770f-4fa2-a68b-100f3fe47cc3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"reference_no\": \"TRN-2026-0001\",\n \"from_warehouse_id\": \"22222222-2222-2222-2222-222222222222\",\n \"to_warehouse_id\": \"22222222-2222-2222-2222-222222222222\",\n \"from_location_id\": \"33333333-3333-3333-3333-333333333333\",\n \"to_location_id\": \"33333333-3333-3333-3333-333333333333\",\n \"status\": \"draft\",\n \"notes\": \"Move to dispatch area\",\n \"items\": [\n {\n \"product_id\": \"44444444-4444-4444-4444-444444444444\",\n \"quantity\": 5\n }\n ]\n}"},"url":"http://localhost:3000/api/transfers","description":"

Create internal stock transfer.

\n","urlObject":{"path":["api","transfers"],"host":["http://localhost:3000"],"query":[],"variable":[]}},"response":[],"_postman_id":"2ce34e93-770f-4fa2-a68b-100f3fe47cc3"},{"name":"Get Transfer By ID","id":"57e315da-a4a4-43d1-a1b3-e6b7398191eb","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:3000/api/transfers/77777777-7777-7777-7777-777777777777","description":"

Get transfer details with item lines.

\n","urlObject":{"path":["api","transfers","77777777-7777-7777-7777-777777777777"],"host":["http://localhost:3000"],"query":[],"variable":[]}},"response":[],"_postman_id":"57e315da-a4a4-43d1-a1b3-e6b7398191eb"},{"name":"Update Transfer","id":"459d545f-aef9-4cad-b46c-1394496950bf","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"from_warehouse_id\": \"22222222-2222-2222-2222-222222222222\",\n \"to_warehouse_id\": \"22222222-2222-2222-2222-222222222222\",\n \"from_location_id\": \"33333333-3333-3333-3333-333333333333\",\n \"to_location_id\": \"33333333-3333-3333-3333-333333333333\",\n \"status\": \"in_transit\",\n \"notes\": \"Vehicle departed\",\n \"items\": [\n {\n \"product_id\": \"44444444-4444-4444-4444-444444444444\",\n \"quantity\": 4\n }\n ]\n}"},"url":"http://localhost:3000/api/transfers/77777777-7777-7777-7777-777777777777","description":"

Update transfer data and item list.

Validate transfer and commit movement.

\n","urlObject":{"path":["api","transfers","77777777-7777-7777-7777-777777777777","validate"],"host":["http://localhost:3000"],"query":[],"variable":[]}},"response":[],"_postman_id":"33ad8cb3-d50c-4543-b9ef-340b656a24e8"}],"id":"890b00ef-8f81-4b71-a070-ca22c530e191","_postman_id":"890b00ef-8f81-4b71-a070-ca22c530e191","description":""},{"name":"Adjustments","item":[{"name":"List Adjustments","id":"cf8a7272-ad25-4696-9772-862ac6ce9cd4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:3000/api/adjustments?product_id=44444444-4444-4444-4444-444444444444&warehouse_id=22222222-2222-2222-2222-222222222222","description":"

List stock adjustments. Optional query: product_id, warehouse_id.

\n","urlObject":{"path":["api","adjustments"],"host":["http://localhost:3000"],"query":[{"key":"product_id","value":"44444444-4444-4444-4444-444444444444"},{"key":"warehouse_id","value":"22222222-2222-2222-2222-222222222222"}],"variable":[]}},"response":[],"_postman_id":"cf8a7272-ad25-4696-9772-862ac6ce9cd4"},{"name":"Create Adjustment","id":"e37f5a35-1f4f-4391-b64b-ab17f6d44a81","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"product_id\": \"44444444-4444-4444-4444-444444444444\",\n \"warehouse_id\": \"22222222-2222-2222-2222-222222222222\",\n \"location_id\": \"33333333-3333-3333-3333-333333333333\",\n \"counted_quantity\": 93,\n \"system_quantity\": 100,\n \"difference\": -7,\n \"reason\": \"Physical recount variance\"\n}"},"url":"http://localhost:3000/api/adjustments","description":"

Create stock adjustment and trigger commit operation.

\n","urlObject":{"path":["api","adjustments"],"host":["http://localhost:3000"],"query":[],"variable":[]}},"response":[],"_postman_id":"e37f5a35-1f4f-4391-b64b-ab17f6d44a81"}],"id":"993dfe08-111e-4a5f-9937-4cec4a3557be","_postman_id":"993dfe08-111e-4a5f-9937-4cec4a3557be","description":""},{"name":"Ledger","item":[{"name":"Get Ledger","id":"6b87894e-4233-45f8-847a-1c165bb53097","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:3000/api/ledger?product_id=44444444-4444-4444-4444-444444444444&warehouse_id=22222222-2222-2222-2222-222222222222&operation_type=receipt&from=2026-01-01&to=2026-12-31","description":"

Fetch stock movement ledger. Optional query: product_id, warehouse_id, operation_type, from, to.

\n","urlObject":{"path":["api","ledger"],"host":["http://localhost:3000"],"query":[{"key":"product_id","value":"44444444-4444-4444-4444-444444444444"},{"key":"warehouse_id","value":"22222222-2222-2222-2222-222222222222"},{"key":"operation_type","value":"receipt"},{"key":"from","value":"2026-01-01"},{"key":"to","value":"2026-12-31"}],"variable":[]}},"response":[],"_postman_id":"6b87894e-4233-45f8-847a-1c165bb53097"}],"id":"1da18862-fb4d-4d59-a9e1-488424e358d5","_postman_id":"1da18862-fb4d-4d59-a9e1-488424e358d5","description":""}],"variable":[{"key":"baseUrl","value":"http://localhost:3000"},{"key":"loginId","value":"manager01"},{"key":"password","value":"StrongPass@123"},{"key":"email","value":"manager01@example.com"},{"key":"otp","value":"123456"},{"key":"categoryId","value":"11111111-1111-1111-1111-111111111111"},{"key":"warehouseId","value":"22222222-2222-2222-2222-222222222222"},{"key":"locationId","value":"33333333-3333-3333-3333-333333333333"},{"key":"productId","value":"44444444-4444-4444-4444-444444444444"},{"key":"receiptId","value":"55555555-5555-5555-5555-555555555555"},{"key":"deliveryId","value":"66666666-6666-6666-6666-666666666666"},{"key":"transferId","value":"77777777-7777-7777-7777-777777777777"},{"key":"itemId","value":"88888888-8888-8888-8888-888888888888"}]}