Skip to Content

Oil & Gas Joint Venture

by
Odoo
v 19.0 Third Party 10
Download for v 19.0 Deploy on Odoo.sh
Availability
Odoo Online
Odoo.sh
On Premise
Odoo Apps Dependencies • Discuss (mail)
• Invoicing (account)
• Purchase (purchase)
• Contacts (contacts)
• Inventory (stock)
• Project (project)
• Maintenance (maintenance)
Community Apps Dependencies
Lines of code 22063
Technical Name oil_erp_jv
LicenseLGPL-3
Websitehttps://www.cybrosys.com
You bought this module and need support? Click here!
Availability
Odoo Online
Odoo.sh
On Premise
Odoo Apps Dependencies • Discuss (mail)
• Invoicing (account)
• Purchase (purchase)
• Contacts (contacts)
• Inventory (stock)
• Project (project)
• Maintenance (maintenance)
Community Apps Dependencies
Lines of code 22063
Technical Name oil_erp_jv
LicenseLGPL-3
Websitehttps://www.cybrosys.com
Supports: Community
Availability: On Premise Odoo Online Odoo.sh
Oil & Gas Joint Venture

Joint Venture Pillars

Why Oil & Gas Joint Venture?

Joint Operating Agreements

Register the JOA, designate the operator, and add partners with Working Interest (WI%) and Net Revenue Interest (NRI%) — with hard validation that WI% sums to exactly 100%.

AFE Partner Voting

Authority for Expenditure runs a partner approval workflow that requires more than 50% of WI% to vote Approved before the AFE can move from Submitted to Approved.

Cash Call & JIB Invoicing

Monthly Cash Calls and Joint Interest Billing split costs by WI% and auto-generate Odoo customer invoices to every non-operator partner — with payment status tracked back on the call.

Revenue Distribution

Net production revenue splits by NRI% (or WI% as fallback), with a built-in lessor allocation for royalty deduction so the royalty bill flows through the same workflow as partner share bills.

Module Activation
Joint Venture Management settings and submenu

Enable Joint Venture Management and Open the Submenu

Tick Joint Venture Management in Oil ERP settings to expose the Joint Venture submenu — JOA, JV Partners, AFE Approvals, Cash Calls, JIB, and Revenue Distribution.

Joint Operating Agreement
Active Joint Operating Agreement with partners and WI/NRI splits

Set Up the JOA with Partners, Working Interest, and Operator

Create a JOA with Project / Block, Operator, dates, and Accounting Method. Add partners with WI % and NRI % — validation enforces total WI% equals 100% with exactly one operator.

AFE Draft
Authority for Expenditure in Draft state with cost lines

Draft the Authority for Expenditure with Cost Lines

Draft an AFE under a JOA with an AFE Type (CAPEX, OPEX, Workover, Exploration). Add cost categories on Cost Estimate — Estimated, Actual, and Variance totals roll up live.

AFE Partner Voting
AFE Partner Approvals tab with per-partner Approve/Reject buttons

Collect Partner Votes Weighted by Working Interest

The Partner Approvals tab gives every partner their own Approve / Reject buttons. The AFE moves to Approved only when partners voting Approved collectively hold more than 50% of WI%.

AFE In Progress
AFE In Progress with actuals filling in and live variance

Track Actuals and Variance Through the AFE Lifecycle

The AFE moves through Approved → In Progress → Closed. The Financial Summary shows live Estimated, Actual, and Variance as cost lines fill in actuals.

Cash Call Draft
Cash Call in Draft with auto-generated partner breakdown

Issue a Monthly Cash Call with Auto-Computed Partner Shares

Enter a Total Cash Call Amount for a JOA and the Partner Breakdown regenerates automatically — splitting by each partner’s WI % (e.g. $8,500 → $5,100 / $3,400 at 60/40).

Cash Call Invoicing
Confirmed Cash Call ready to generate invoices

Generate Customer Invoices for Every Non-Operator Partner

Generate Invoices creates an Odoo customer invoice per non-operator partner at their share. The operator and any already-invoiced partner are skipped, so re-clicking is safe.

Cash Call Invoiced
Invoiced Cash Call with payment status per partner

Track Invoice and Payment Status per Partner

The Invoices smart button surfaces all generated invoices, and each Partner Breakdown row gains a Payment Status badge — Not Paid, In Payment, or Paid.

JIB Draft
JIB in Draft with actual cost lines

Capture Actual Costs in the Joint Interest Billing

The Actual Costs tab records every line by date, category, vendor, and amount. Total Actual Costs rolls up live, then Compute Allocations splits it by each partner’s WI%.

JIB Partner Allocations
JIB Partner Allocations and Generate Invoices button

Split Costs by Working Interest and Bill Each Partner

The Partner Allocations tab shows each partner’s Allocated Amount (e.g. $4,770 → $2,862 / $1,908 at 60/40). Generate Invoices issues a customer invoice per non-operator partner.

Royalty & JV Integration
Royalty linked to JV Agreement with Create Revenue Distribution button

Route JV-Linked Royalties Through Revenue Distribution

When a Royalty has a JV Agreement, Create Bill is replaced by Create Revenue Distribution — preventing double-billing of the lessor.

Revenue Distribution
Revenue Distribution with NRI partner allocations and totals

Distribute Net Revenue by NRI% with a Lessor Allocation

Net revenue (gross − royalty − other deductions) splits by NRI % (e.g. $6,750 → $4,050 / $2,700). Generate Bills issues the lessor royalty bill plus a vendor bill per non-operator partner in one batch.

Cascading Expiry Crons

Three daily scheduled actions check leases, contracts, and JOAs for expiry — past-due records auto-move to Expired and post chatter notes; downstream records get warning banners.
The 100% Rule

Hard constraint: total Working Interest % across partners must equal 100% (tolerance 0.01%). Total Net Revenue Interest % cannot exceed 100%. Each partner unique per agreement; exactly one operator allowed.

Authority for Expenditure

AFEs with cost lines, CAPEX/OPEX/Workover/Exploration types, and live Estimated, Actual, and Variance tracking. State machine: Draft → Submitted → Approved → In Progress → Closed.
Majority-Vote AFE Approval

Each partner gets an approval line; the AFE-level Approve succeeds only when partners voting Approved collectively hold more than 50% of WI%.

Monthly Cash Calls

Cash Calls auto-split a total amount across partners by WI % and Generate Invoices issues an Odoo customer invoice (out_invoice) per non-operator partner — re-runnable without duplicates.
Joint Interest Billing

Capture actual costs by category, vendor, and date; Compute Allocations splits the total by WI%; Generate Invoices issues partner invoices and locks the JIB to Billed.

Revenue Distribution by NRI%

Net production revenue splits by NRI% (or WI% as fallback). Vendor bills (in_invoice) issued to each non-operator partner for their share, plus a separate lessor bill for the royalty deduction.
Royalty Double-Billing Prevention

A royalty linked to a JOA cannot use the standard Create Bill — the action is replaced by Create Revenue Distribution, ensuring the lessor bill is generated through the same workflow as partner share bills (only one distribution per royalty allowed).

Why can’t I activate my JOA?
Three conditions must hold: the JOA is in Draft state, at least one JV partner is added, and the total Working Interest % across all partners equals exactly 100% (tolerance 0.01%). The activation action checks all three.
Why won’t the AFE move to Approved?
Approval is a majority vote weighted by Working Interest. Partners who voted Approved must collectively hold more than 50% of total WI%. If approvers fall short, the top-level Approve action raises an error.
Why does the operator not get an invoice?
The operator already books the costs and revenues on its own books — invoicing the operator would double-count. Both Cash Call/JIB invoicing and Revenue Distribution bill-generation skip the operator partner. Already-invoiced partners are also skipped, so re-running is safe.
Why can’t I Create Bill on a royalty linked to a JOA?
To prevent double billing of the lessor. When a royalty has a JV Agreement set, the standard Create Bill is blocked and replaced by Create Revenue Distribution — the distribution’s Generate Bills action issues the lessor royalty bill alongside the partner share bills in one batch.

Release 19.0.1.0.0

1st April, 2026 - Add: Initial commit

Professional Support

Our Expert Services

Odoo Customization Odoo Implementation Odoo Support Odoo Migration
Odoo Integration Odoo Consultancy Odoo Licensing Hire Odoo Developer

Please log in to comment on this module

  • The author can leave a single reply to each comment.
  • This section is meant to ask simple questions or leave a rating. Every report of a problem experienced while using the module should be addressed to the author directly (refer to the following point).
  • If you want to start a discussion with the author, please use the developer contact information. They can usually be found in the description.