Skip to content

Warehouse Job Record

A Warehouse Job Record is the central umbrella document for every client engagement. Think of it as a "project folder" — every ASN, Receiving, Client Order, Pick Task, and Billing charge links back to one Job Record. It gives you a single place to see everything about a particular job: what came in, what went out, how much you earned.

When to Create a Job Record

Create a new Job Record when:

  • A new client engagement begins (e.g., "Store and ship 1000 units for TechGear")
  • A new shipment campaign starts (e.g., "Black Friday fulfillment batch")
  • A container or large consignment arrives requiring end-to-end tracking
  • You need to track P&L for a specific project

TIP

You don't have to create a Job Record for every small transaction. It's most useful for larger engagements where you want to track the full lifecycle and profitability in one place.

How to Create

  1. Go to Warehouse 3PL → Warehouse Job Record → New
  2. Fill in the basic details:
FieldRequiredDescription
DateYesJob start date
ClientYesThe 3PL client (must have "Is 3PL Client" checked)
Job StatusAutoStarts as "Created", updates as work progresses
Job TypeNoGeneral / Import / Export / Transfer / VAS
Client ReferenceNoClient's own reference number for this job
RemarksNoAny notes about this job
  1. Click Save

The Overview Dashboard

Once a Job Record has linked documents, the Overview tab shows a live dashboard with colored KPI cards, linked document badges, and a warehouse balance bar:

The dashboard shows:

┌─────────────────────────────────────────────────────────┐
│  TechGear Inc                              [In Progress] │
│  WH/26/04/0001 · 2026-04-03                             │
├──────────────┬──────────┬──────────┬────────────────────┤
│    680       │    0     │ $ 435.00 │    $ 435.00        │
│   Stock In   │ Stock Out│ Revenue  │ Gross Profit (100%)│
├──────────────┴──────────┴──────────┴────────────────────┤
│ [1 ASN] [1 Receiving] [1 Orders] [4 Billing] [0 DN]    │
├─────────────────────────────────────────────────────────┤
│ Balance in Warehouse:                        680 units  │
└─────────────────────────────────────────────────────────┘
  • Four colored KPI cards at the top: Stock In (blue), Stock Out (orange), Revenue (green), Gross Profit (green/red)
  • Clickable badge links for each document type — click to jump to the filtered list
  • A balance bar at the bottom showing current warehouse stock for this job

What the cards show

CardWhat it means
Stock InTotal units received into the warehouse for this job
Stock OutTotal units shipped out (via Delivery Notes)
RevenueTotal billing charges from all Billing Transactions
Gross ProfitRevenue minus costs (Purchase Invoices linked to this job)

Linked document badges

Click any badge to jump to the filtered list:

  • ASN — All Advance Shipment Notices for this job
  • Receiving — All Receiving documents
  • Orders — All Client Orders
  • Billing — All Billing Transactions
  • Delivery Notes — All Delivery Notes

The Five Tabs

Tab 1: Overview

The dashboard described above. Updated every time you open the form.

Tab 2: Details

Full job configuration:

  • General: Date, Client, Status, Remarks, Branch, Contact Person, Sales Executive
  • Job Configuration: Job Type, Preceding/Succeeding Job, Reference Type, Storage Terms, Cargo Type, Billing Criteria, Container Number
  • Place: Place of Receipt, Place of Delivery, ETA, ETD

Tab 3: Operations

Three child tables for operational tracking:

  • Storage Information — Warehouse locations, temperature zones, storage conditions
  • Vehicle Information — Truck/container details, driver info, arrival times
  • Operational Log — Free-text log entries for any operational notes

Tab 4: Stock Movement

Shows all stock movements linked to this job:

  • Click Fetch Stock Movements to pull data from Receivings and Delivery Notes
  • The table shows: Item, Qty In, Qty Out, Warehouse, Batch, Date
  • Summary fields below: Total In Qty, Total Out Qty, Balance Qty

Tab 5: Financials

Shows all financial documents linked to this job:

  • Click Fetch Linked Vouchers to pull Billing Transactions, Sales Invoices, and Purchase Invoices
  • The voucher table shows: Voucher Type, Voucher No, Date, Amount, Party
  • P&L summary: Total Revenue, Total Cost, Gross Profit

INFO

The P&L section colors profit green and losses red, making it easy to spot unprofitable jobs at a glance.

Creating Linked Documents from a Job

From the Job Record, you can create downstream documents directly:

ButtonWhat it does
Create → Create ASNOpens a new ASN pre-filled with the job's client and job reference
Create → Create Client OrderOpens a new Client Order pre-filled with the job's client and job reference

These buttons appear in the top toolbar when the job status is not Completed, Closed, or Cancelled.

Linking Existing Documents

When creating an ASN, Receiving, Client Order, or Billing Transaction, you'll see a Warehouse Job field. Set this to the Job Record name (e.g., WH/26/04/0001) to link the document.

Stock Entries and Delivery Notes also have a Warehouse Job custom field for the same purpose.

Job Status Lifecycle

StatusMeaning
CreatedNew job, no activity yet
ConfirmedClient confirmed, ready to begin
In ProgressGoods are being received, stored, or shipped
InvoicedAll billing transactions generated, invoice sent
CompletedWork finished, payment received
ClosedJob archived
CancelledJob cancelled

Example: Full Job Lifecycle

Here's how a typical job flows from start to finish:

  1. Client calls: "I'm sending 500 units of Widget-A and 180 units of Gadget-B"
  2. You create a Job Record: Client = TechGear Inc, Job Type = General
  3. You create an ASN from the job (Create → Create ASN), add the two items
  4. Truck arrives: You create a Receiving from the ASN, count the goods, submit
  5. System auto-creates: Stock Entry (680 units at $0), Putaway Tasks, Billing charge
  6. Operators put away goods to bins (Complete Putaway Tasks)
  7. Client sends an order: You create a Client Order from the job, add items
  8. You create a Wave, release it — Pick Tasks appear for operators
  9. Operators pick and pack — Pack Task creates Delivery Note automatically
  10. Check the Job's Overview tab: Stock In = 680, Stock Out = 150, Revenue = $435, GP = $435

All of this is visible from a single Job Record.

Tips

Track profitability

Use the Financials tab to monitor whether a job is profitable. If Gross Profit is negative (red), the rate card pricing may need adjustment for that client.

Use for container-level tracking

For import jobs, use the Container Number field and Vehicle Information table to track the container from port to warehouse.

Status doesn't auto-update

The Job Status field is manually set. The system doesn't automatically change it (unlike ASN or Client Order status). Update it as work progresses to keep your team informed.

Built on Frappe/ERPNext