Warehouses & Carriers

Where AIR's stock physically lives, and who moves it to customers. This page covers the Warehouse record — including its stock locations, its linked carriers and the regions it serves — and the standalone Delivery Carrier master list.

Warehouses Built

Warehouses live under Warehouses → Warehouses. A warehouse is where AIR holds stock — the head-office godown, a branch, or a purely notional location used for accounting. Full create/edit/delete is available.

Warehouse list

Filters: Warehouse Type, Warehouse Purpose (both drop-downs), and Default (yes/no/either).

Create / edit a Warehouse

The form has three sections. "Warehouse Details" is expanded by default; "Address" and "Operations" are collapsible and start collapsed.

Warehouse Details

Address (collapsible, starts collapsed)

Operations (collapsible, starts collapsed)

Actions on the list/edit page are the standard Edit and Delete — plain CRUD, no service logic and no delete guard (unlike Regions, deleting a warehouse that still has stock locations or stock is not blocked at this level).

Stock Locations tab

Open a Warehouse and switch to Stock Locations to manage the individual bins/areas inside it that stock actually sits in.

1. Open a Warehouse's edit page and select the Stock Locations tab

   You'll see every location currently defined under this warehouse.

2. Select New stock location (header) to add one

   Fill in location_name (required, max 255), stock_location_number (optional, max 50), and choose a location_type (required).

3. Choose the correct Location Type

   See the table below — pick a "physical" type for a real shelf/bin that will hold countable stock, or one of the logical types for accounting-only movement points.

4. Set In Use, Wave and Auto-gen closing stock record as needed

   All three are toggles on the same form.

5. Save, or use row Edit/Delete later

   This is plain CRUD — no service calls, no guard on delete.

The 11 LocationType options, in the order they appear in the Select:

"Physical" here means the location represents a real, countable shelf/bin that closing-stock counts and stock-on-hand figures meaningfully apply to; the "Logical" types are accounting/organisational points that stock passes through without being physically shelved there.

Delivery Carriers tab

Open a Warehouse and switch to Delivery Carriers to see and manage which carriers this warehouse can despatch through. This is a many-to-many link — there is no create/edit here, only attach/detach.

1. Select Add carrier (header)

   Opens a dialog titled "Add a delivery carrier" with a pre-loaded searchable Carrier select listing every carrier already defined in the Delivery Carrier master list below.

2. Choose the carrier and confirm

   The link is created immediately — no separate save step.

3. To remove a link, select row Remove

   Or select several rows and use the bulk Remove selected action. Removing never deletes the carrier itself, only the link to this warehouse.

Regions tab

Open a Warehouse and switch to Regions to record which Regions this warehouse serves. Also a many-to-many, attach/detach only.

Same pattern as Delivery Carriers: header Assign region (a "Assign a coverage region" dialog with a pre-loaded searchable Region select over every Region), row Remove, bulk Remove selected. This is a separate link from the single region_id field on the Warehouse's own "Warehouse Details" section — that field says where the warehouse physically is; this tab says which regions it serves, and a warehouse can serve many regions beyond its own.

Hand-delivery beats are now defined separately, on their own Delivery Routes page — each route is owned by one warehouse and lists the ordered pincode stops the beat walks.

Delivery Carriers Partial

Delivery Carriers live under Warehouses → Delivery Carriers — the master list of every courier, postal or transport service AIR despatches through. Unlike the resources on the Geography page, this is a straightforward, flat, full-CRUD master list with no tree and no relation managers of its own (carriers are linked to warehouses and regions from the warehouse side, and to pincode serviceability from the pincode side — see Zones, Regions & Pincodes).

Delivery Carrier list

Filters: Carrier Type (Courier/Post/Hand Delivery/Transport) and Active Status (yes/no/either).

Create / edit a Delivery Carrier

Select New delivery carrier or row Edit. Single section, "Carrier Details":

Actions are the standard Edit and Delete — plain CRUD, no service logic, no bulk actions, no guard on delete.

Delivery-date estimate Built

A read-only API endpoint that answers "if we ship from this warehouse today (or on a given date), when should the customer expect delivery?" — used by the SE field app and the HO console wherever an expected delivery date needs showing without duplicating the day-count logic client-side.

API

Response shape:

User↔location assignment & warehouse context Built

Two related pieces of API-only plumbing (no console screen yet) that let a field operator's app learn "which warehouse(s) am I working in, and which specific stock location am I assigned to?" — used by the SE field app and any HO tooling that needs to default a stock location for the acting user.

Assigning a user to a stock location

A user_stock_locations row links one user to one Stock Location, with an is_primary flag.

Reading your own warehouse context

Response shape:

Related pages

• Zones, Regions & Pincodes — the Region/Pincode records a Warehouse links to, and where carrier-pincode serviceability is recorded.
• Schedulers — the daily automated jobs that read allow_autoreservation (on both warehouses and carriers) and allow_in_wave_scheduler (on stock locations).
• Stock on Hand — live quantities per stock location.
• Closing Stock — the physical counting workflow that autogen_closing_stock_record feeds into.
• Picking Waves — what happens once the wave scheduler has pulled eligible stock locations into a wave.