Workflow: Yard Reception (Local Market)

Step-by-step guide — How to receive material at a yard or warehouse for local market operations in Jules.

When to use this workflow

Use this workflow when your organization operates a recycling yard or warehouse and receives material deliveries from local suppliers. This is the local market flow — domestic trade without maritime freight, where goods arrive by truck, rail, or barge directly to your facility.

Local market operations differ from export operations in several key ways:

Overview of the Reception Flow

Prerequisites

Before receiving material at a yard:

1. Supplier onboarded — Company, site, and contacts exist in Jules (see Onboarding a New Supplier)
2. Purchase operation created — A LOCAL market BUY operation exists for this supplier
3. Warehouse/yard site configured — Your receiving site is set up with stockpiles
4. Stockpiles created — At least one stockpile exists for the material quality at your yard

Step-by-Step

Step 1 — Create the Local Purchase Operation

If not already done, create a BUY operation for the local supplier:

Key: Setting isWarehouse = true changes how Jules handles this operation. Goods are received into a stockpile rather than shipped to a customer. Margin is calculated differently — as bulk margin from the stockpile, not per-container margin.

Step 2 — Truck Arrival and Weighing

When the truck arrives at your yard:

1. Weigh-in: Record the gross weight (truck + material) at the weighbridge
2. Unload: Direct the truck to the appropriate area for unloading
3. Quality inspection: Perform a visual check of the material
4. Weigh-out: Record the tare weight (empty truck)
5. Calculate net weight: Gross weight − Tare weight = Net weight of delivered material

Step 3 — Create the Reception in Jules

Navigate to the operation's Receptions tab and create a new reception:

Reception statuses

Step 4 — Assign Material to a Stockpile

After reception, the material is assigned to a stockpile — a named pile of material at your yard:

Stockpile statuses

Stockpile KPIs

Jules tracks aggregated stockpile metrics:

Step 5 — Selling from the Stockpile

When material is sold from the yard to a customer:

1. Create a SELL operation (LOCAL or EXPORT market)
2. Link the sell operation to the stockpile as the source
3. If export: containers are loaded from the stockpile and follow the standard export flow
4. If local: the customer sends trucks to collect material

The stockpile's outbound quantity tracks how much has been sold/shipped out.

Step 6 — Purchase Invoice

Generate the purchase invoice for the received material:

1. Create a BUY invoice referencing the operation
2. Use the net weight from the reception as the invoiced quantity
3. Apply the contracted price (spot or index-based)
4. Finalize the invoice (DRAFT → OPEN)

If the supplier delivers across multiple receptions, you can:

• Invoice each reception separately
• Or accumulate deliveries and invoice periodically (e.g., weekly or monthly)

Margin for Yard/Warehouse Operations

Warehouse operations use bulk margin rather than container margin:

Bulk margin = Sale revenue from stockpile − Total purchase cost into stockpile − Operating costs

Jules tracks:

• Average purchase cost per tonne in the stockpile
• Target purchase cost configured on the stockpile
• Inbound shipments and operations feeding the stockpile

The margin is calculated at the stockpile level, not per container, because material from different suppliers and receptions is commingled in the pile.

See Margin Calculations for details on bulk margin.

Reception vs Container: Key Differences

Verification Checklist

Common Issues

Related Documentation

• Operations & Lifecycle — warehouse operation flag and local market
• Companies, Sites & Contacts — site and warehouse setup
• Margin Calculations — bulk margin methodology
• Workflow: Onboarding a New Supplier — supplier setup
• Invoicing & Billing — purchase invoicing