ERP: Odoo and Dolibarr 4 min

ERP requirements document: the short template that works

A good ERP requirements document describes the company flows (from quote to payment), the non-negotiable business rules, the data to migrate, the tools to connect, the volumes and the acceptance criteria. It fits in about fifteen pages and leaves the choice of modules to the provider.

Contents11
  1. 01The outline in seven sections
  2. 021. Context
  3. 032. Flows
  4. 043. Business rules
  5. 054. Data
  6. 065. Integrations
  7. 076. Volumes
  8. 087. Acceptance
  9. 09What to add: the out of scope
  10. 10Getting it validated
  11. 11Frequently asked questions

Many ERP requirements documents are lists of features copied from vendor brochures: “multi-warehouse stock management”, “customisable dashboards”. Every ERP ticks those boxes. The document says nothing about what makes your company specific, and that is exactly where projects are won or lost.

In short

  • Describe flows and rules, not features.

  • Aim for about fifteen pages, readable by leadership and by teams.

  • List what stays out of scope: that is what protects the budget.

  • Give real volumes and testable acceptance criteria.

The outline in seven sections

  1. Context

    Business, headcount, companies, sites, tools in place.

  2. Flows

    From first contact to payment, and from purchase order to receipt.

  3. Business rules

    What is not negotiable.

  4. Data

    What is migrated, from where, and in what state.

  5. Integrations

    The tools that stay and what they exchange.

  6. Volumes

    Users, documents per month, items, warehouses.

  7. Acceptance

    The scenarios that prove it is finished.

1. Context

One page is enough. Who are you, how many people will log in, in how many companies and countries, with which tools today? Add the reason for the project, in one measurable sentence: “cut the month-end close from five days to two”, “stop re-keying between the CRM and invoicing”. The measurements from When to move to an ERP are used here.

2. Flows

This is the section that matters most. For each flow, write the steps, who does them and which document comes out. For example: the sales rep makes the quote, sales administration turns it into an order after the deposit, the warehouse picks, delivery triggers the invoice. A simple diagram beats a long text.

Describe the flow as it should be, not as it is with its workarounds. The ERP project is the right moment to remove a useless step.

3. Business rules

Discounts allowed by level, payment terms by customer type, lot or serial number tracking, mandatory approvals above an amount. These rules are what separate configuration from development. Note for each whether it is legal, contractual or simply a habit: only the first two are truly non-negotiable.

4. Data

List the data to migrate (customers, suppliers, items, price lists, stock, open invoices, history) and its source. Be honest about its state: duplicates, empty fields, inconsistent codes. Data migration is often the most underestimated item.

5. Integrations

Which tools stay? The accountant’s software, the online shop, payroll, the bank. For each, say what must flow, in which direction and how often. See Connecting your business tools.

6. Volumes

Number of users per role, of quotes, orders and invoices per month, of item references, of warehouses. These figures size the hosting and the licence cost. They also avoid bad surprises: an import of 50,000 references is not handled like an import of 500.

7. Acceptance

Write five to ten end-to-end scenarios: “a key account orders 200 units, 50 of which are out of stock; the order is partly delivered; the invoice covers only what was delivered”. The project is finished when these scenarios pass. It is the best protection against a project that never ends.

What to add: the out of scope

An explicit list of what the project does not do: payroll, manufacturing, the online shop, a second company. It protects the budget and the date. A scope that grows along the way is the first cause of failure, detailed in Why ERP projects fail.

For inspiration on an ERP’s standard processes, Odoo’s documentation describes, flow by flow, what the apps do.

Getting it validated

A requirements document is only worth something if it is validated by those who live the flows. Have each section reviewed by the head of the department concerned, then the whole by leadership, and note disagreements rather than smoothing them over: those are what scoping must settle. The complete ERP guide places this document within the whole project. The scoping of our CRM and ERP offer produces it with you, in a few workshops, before proposing a tool and a fixed price.

Frequently asked questions

Do you need a consultant to write the requirements?

Not necessarily. The people who live the flows are best placed to describe them. An outside view mostly helps separate real business rules from habits and ask the right questions about volumes and integrations. That is exactly what the scoping in our offer is for.

Should you choose the software before writing the requirements?

No, it is the other way round. The requirements are used to compare software against your reality. Choosing the tool first means adapting the company to a demo, and discovering the gaps during the project, when they cost the most.

What length should you aim for?

About fifteen pages, diagrams included. Beyond that, nobody rereads the whole document, and contradictions go unnoticed. A short document that leadership and teams have really validated is better than an exhaustive one nobody has read.

Sources

  1. Odoo applications documentation (new tab)odoo.com
Source 1

Odoo applications documentation

Read on odoo.com(new tab)

Jim · founder of Brain Plus AI

Also in erp: odoo and dolibarr

  • Practical guide5 min The topic guide

    ERP for a company of 20 to 500 people: the guide

    An ERP brings sales, purchasing, stock and invoicing into one database. This guide explains when it becomes useful, how to choose between Odoo and Dolibarr, and what makes the project succeed or fail.

  • Understand4 min

    Why ERP projects fail, and how to avoid it

    ERP projects that go off the rails almost never stumble on the software, but on scope, data, customisation and adoption. Six causes, and the counter to each.

  • Understand4 min

    AI in an ERP: what really helps, what can wait

    Reading supplier invoices, bank reconciliation, answering questions about the data: AI has solid uses in an ERP, others are still demos. The sorting, use by use.

WhatsApp