ModulesBudget
Modules

Budgets & Goals in Jules

How Jules supports commercial planning through purchase goals, target prices, and deal-level budgets with cashflow projections.

Budgets & Goals in Jules

Product documentation — How Jules supports commercial planning through purchase goals, target prices, and deal-level budgets with cost breakdowns and cashflow projections.


Table of Contents

  1. Overview
  2. Goals & Target Prices
  3. Budgets
  4. Budget Templates
  5. Cashflow Projections
  6. Approval Workflow
  7. Key Business Rules
  8. Glossary

Overview

Jules provides two complementary planning tools:

ToolPurposeGranularity
GoalsSet volume and price targets for purchasingPer quality, per destination, per period
BudgetsModel the full economics of a deal before executingPer operation quality, with detailed cost breakdown

Goals & Target Prices

Goals

A goal is a purchasing or selling target — a commitment to buy or sell a certain quantity of a specific material within a given timeframe.

Goal Fields

FieldDescription
QualityThe material grade targeted
QuantityVolume to purchase or sell
Target priceThe price the trader aims to achieve
Price typeWhether this is a BUY or SELL target
IncotermDelivery terms
Market typeExport or Local
Start date / Due dateTime window for achieving the goal
Assigned toTraders responsible for the goal
DestinationTarget destination site
Port of loading / destinationLogistics routing
Region / AreaGeographic targeting
Pre-carriage areaInland transport zone
Is margin includedWhether the target price includes margin

Fulfillment Tracking

Goals track fulfilled quantity — how much has been achieved through actual operations. This allows real-time monitoring of progress vs target.

Target Prices

A target price is a simpler variant of a goal — it sets a price target without a volume commitment. It includes:

FieldDescription
QualityMaterial grade
Target pricePrice objective
Price typeBUY or SELL direction
Due dateDeadline
Price variationAcceptable price fluctuation range

Grouping & Sorting

Goals can be:

  • Grouped by destination — to see targets by delivery location
  • Sorted by creation date — ascending or descending

Budgets

A budget models the complete economics of a deal, breaking down all costs and revenues to project profitability before committing to the trade.

Budget Structure

Budget Fields

FieldDescription
NameBudget identifier
TemplateThe budget template defining available cost elements
Operation qualitiesThe deals being budgeted (with prices, quantities, incoterms)
ElementsIndividual cost lines (see below)
CashflowsProjected payment timing
Overdraft periodDays of negative cashflow the deal may generate
ApprovalsApproval chain for the budget
Created byUser who created the budget

Budget Operation Qualities

Each budget links to one or more operation qualities, capturing:

FieldDescription
Operation qualityThe deal line being budgeted
PriceBudgeted price (may differ from the operation's actual price)
QuantityBudgeted volume
IncotermDelivery terms for the budget scenario
Payment termsPayment conditions
Port of loading / destinationLogistics routing

Budget Elements (Cost Lines)

Each cost line in a budget specifies:

FieldDescription
ElementThe cost item (e.g., freight, inspection, customs)
CategoryClassification of the cost (see below)
Cost typeHow the cost is calculated
Price / QuantityThe budgeted amount
Cost percentageFor percentage-based costs
Percentage ofWhat the percentage is applied to (Purchase, Sale, or Turnover)

Cost Types

TypeDescription
FLATFixed amount per unit
PERCENTAGEPercentage of another value
LOGISTICS_RATEUses the logistics rate card

Element Categories

CategoryExamples
LOGISTICS_DOCUMENTATIONFreight, pre-carriage, BL fees, customs
FINANCE_INSURANCE_PAYMENTInterest, insurance, payment term fees
WAREHOUSINGStorage, handling
OTHERAny other cost

Budget Templates

Budget templates define the structure of a budget — which cost elements are available and their default values. They are configured per organization.

Template Fields

FieldDescription
NameTemplate name
Shipment modeCONTAINER, BULK_CARGO, or TRUCK_RAIL_BARGE
Default currencyThe currency for the template
Default volumeThe unit of measure (e.g., T for tonne)
ElementsList of pre-configured cost elements with defaults

Templates ensure consistency across budgets and reduce setup time for new deals.


Cashflow Projections

Each budget can include cashflow projections that model when money flows in and out:

Cashflow Types

TypeDescription
BUYCash outflow — when the supplier is paid
SELLCash inflow — when the customer pays
INVENTORYCash tied up in inventory

Cashflow Fields

FieldDescription
Cashflow typeBUY, SELL, or INVENTORY
Number of daysDays from reference date to payment
Value typePERCENTAGE or ABSOLUTE
Absolute valueFixed amount (if absolute)
Percentage valuePercentage of the deal value (if percentage)

Overdraft Period

The overdraft period indicates how many days the deal may require financing (negative cash position). This is critical for assessing working capital needs.


Approval Workflow

Budgets are subject to an approval workflow before a deal can proceed:

The approval system uses the generic Approval entity with:

  • Multiple reviewers — Several users can be assigned as approvers
  • Review status — PENDING, APPROVED, or REJECTED per reviewer
  • Request comment — Context provided by the budget creator
  • Reject comment — Reason for rejection

Key Business Rules

1. Goals drive purchasing behavior

Goals create visibility on what the organization needs to buy or sell. When creating operations, traders can link them to goals, and the fulfilled quantity is automatically tracked.

2. Budgets precede execution

In organizations that require approval workflows, a budget must be approved before operations are created. The budget proves the deal is profitable after accounting for all costs.

3. Templates standardize budgeting

Budget templates ensure all teams use the same cost structure, making budgets comparable across deals and time periods.

4. Cashflow projections inform treasury

By modeling payment timing, cashflow projections help the finance team anticipate working capital needs and arrange financing if needed.

5. Cost percentage flexibility

Budget elements can be calculated as a percentage of the purchase price, sale price, or total turnover — providing flexibility for different cost types (e.g., agent commission as % of sale, insurance as % of turnover).

6. Multi-quality budgets

A single budget can cover multiple operation qualities, modeling the economics of a complex deal involving several material grades.


Glossary

TermDefinition
BudgetA detailed financial model of a deal's costs and revenues
Budget elementA single cost line in a budget (e.g., freight, customs)
Budget templatePre-configured cost structure used to create consistent budgets
Cashflow projectionModel of when money flows in and out of a deal
Fulfilled quantityVolume achieved against a goal through actual operations
GoalA volume and price target for purchasing or selling a material
Overdraft periodDays of negative cash position during deal execution
Target priceA price objective without a volume commitment