📖 What MooRules Is
MooRules is Milk Moovement's generalized payment matrix. It's a single configurable engine that defines, for every charge that flows through the platform: who pays whom, how much, when, for what, and how it affects gross pay.
If you've ever wondered where hauling charges, producer deductions like Tire Charge or Marketing Fee, premiums like SCC Quality, and hauler dues all "live" — they live here, in one place, instead of being scattered across separate one-off rules.
🎯 What MooRules Helps You Do
A MooRule answers five questions about a charge:
WHO pays WHO — Producer→Hauler, Producer→Vendor, or Hauler→Vendor.
HOW MUCH — the rate (basis and amount), pulled from your reusable rate library.
WHEN — Monthly (MO) or Semi-Monthly (SM) payment frequency.
FOR WHAT — the line item type: Base Hauling, Production Payment, Premium, Assignment, Fuel Surcharge, Stop Charge, or Deduction.
HOW IT FITS GROSS PAY — Above Gross Pay (added to the producer's gross) or Below Gross Pay (subtracted).
🧭 Where To Find It
MooRules lives at /#/moo-rules in the Co-op Admin view. The page has three tabs that work together: MooRules (rule definitions), Charges (line items generated when rules are evaluated), and MooRule Rates (the reusable rate library).
[SCREENSHOT: MooRules page showing the three-tab layout]
🗂️ Tab 1: MooRules (rule definitions)
The MooRules tab lists every active rule with seven columns: Type, Description, Start Date, End Date, Payment Frequency, Payers, and Payees. Top controls let you add a single rule (+ ADD RULE) or bulk-import via UPLOAD RULES.
Three rule types you'll see:
Producer - Hauler — Producer pays Hauler. Examples: Cross Country Hauling Rates, Hauling Contract for a specific producer.
Producer - Vendor — Producer pays a vendor-style accounting bucket. Examples: Discount, Tire Charge, SCC Quality Premium, Milk Marketing Fee.
Hauler - Vendor — Hauler pays a vendor-style bucket. Example: Hauling Contract Test (Dues), Tire Charge.
Payers and Payees can be set with wildcards ("All: PRODUCERS", "All: TRANSPORTS") for cooperative-wide rules, or scoped to specific producers, hauling companies, or vendor buckets when a rule should only apply to one entity.
💰 Tab 2: Charges (generated line items)
The Charges tab is the output of MooRules. Once pay is calculated for a milk month, every rule produces one row per applicable producer × rule combination, with the calculated rate. Columns include Milk Month, Name, Type, Payee, Payer, Payment Frequency, Basis, and Rate.
If a milk month is empty here, it means pay calculation hasn't been run for that period yet.
📚 Tab 3: MooRule Rates (reusable rate library)
A Rate is reusable. You define it once and reference it across multiple MooRules. The library shows: Name, Description, Type, Paid By Payer, Paid To Payee, Payer Category, Payee Category, Line Item Group, GL Number, Account, and Reference.
Seven rate types:
Base Hauling — Below Gross Pay. The core hauling charge.
Production Payment — Above Gross Pay. Component-based pay (Butterfat, Protein, Other Solids, Fat Recovery).
Premium — typically Above Gross Pay. Quality bonuses (e.g., SCC Premium Program).
Assignment — Below Gross Pay. Equipment/service deductions like Tire Charge.
Fuel Surcharge — Below Gross Pay. Can be hauler-specific (e.g., "Fuel Surcharge - Hauler 3002").
Stop Charge — Below or Above depending on configuration.
Deduction — Below Gross Pay. Marketing Fee and similar.
Some rates carry a GL Number for general-ledger integration with your accounting system.
[SCREENSHOT: MooRule Rates tab showing the rate library with GL numbers]
⚖️ The Critical Concept: Above Gross Pay vs. Below Gross Pay
Every rate is categorized as either Above Gross Pay (added to the producer's gross — e.g., Production Payments, Premiums) or Below Gross Pay (subtracted — e.g., Hauling, Fuel Surcharges, Deductions). Getting this right is what makes a producer's pay statement add up correctly.
⚠️ Things to Know
MooRules is replacing legacy Hauling Contracts as the unified pay-logic mechanism. If your co-op still uses Hauling Contracts for some flows, ask your CSM about the migration plan.
[REVIEW NEEDED: source Moovipedia page flags several open questions about the rule edit/add drilldown view, the EVALUATE RATES button behavior, and the UPLOAD RULES file schema. CS team should confirm with Jacob Howard before publishing customer-facing detail on these.]
🔗 Related Articles
Producer Pay vs Invoicing Comparison (report)
Amount Owing Dashboard
Web Releases (release notes)
Drafted on 2026-05-08 from Moovipedia source page "MooRules Engine" (Confluence MMAM, page id 4028432431). Pending CS review before publishing. SME: Jacob Howard.
]]>