FSFunctional Specification
The Functional Specification (FS, sometimes FRS) describes WHAT the system will do to satisfy each User Requirement — the screens, fields, validation rules, calculations, signature workflows, integrations and reports — without yet specifying HOW it will be built. It is the bridge between URS and DS in the GAMP 5 V-model and the input to Design Qualification.
01What an FS is
The Functional Specification describes the system's functional behaviour from the user's perspective. For every URS line item it specifies the visible behaviour — what screens exist, what fields they contain, what validations fire, what calculations run, what records are written, what signatures are required, what reports are generated, what integrations are invoked, what permissions apply. It deliberately stops short of describing internal implementation: the database schema, indexes, code modules, infrastructure and APIs all belong to the Design Specification (DS).
02Where FS sits in the V-model
GAMP 5's V-model places FS between URS (the business-side requirements) and DS (the supplier's technical design). The right arm of the V mirrors this: OQ test scripts are written to verify FS behaviour, just as PQ is written to verify URS satisfaction in the live process. Each test on the right is traceable back to a spec on the left via the traceability matrix — and that is the artefact every Annex 11 / 21 CFR Part 11 inspector navigates the system through.
- URS → FS — "the system shall record every weighing event" becomes "the Weigh screen captures lot, vessel, gross, tare, net, target, tolerance, balance ID, operator, timestamp; commits to weighings table on signature".
- FS → DS — "commits to weighings table on signature" becomes the schema definition, the foreign-key constraints, the audit-trail trigger, and the RLS policy.
- DS → Code/Config — the actual implementation, ready for IQ.
03What an FS contains
- Document control header — version, status, supersedes, author, reviewer, approver, effective date.
- Scope statement — modules in scope, modules explicitly excluded, configurations covered.
- System overview — block diagram of major functions and their data flow.
- Functional descriptions — one numbered section per functional area (master data, workflow, calculations, integrations, reporting, administration, security).
- Screen / interaction specifications — wireframes or screen lists with fields, types, validations, default values, error messages.
- Business-rule catalogue — calculations, decision tables, state transitions, expiry rules, alarm thresholds.
- Electronic-record / e-signature behaviour — what gets written, who can sign, what reason codes apply, how challenge-on-print is handled (21 CFR 11.10 / 11.50 / 11.70 / 11.200).
- Audit-trail behaviour — what fields are audited, what before/after captured, retention.
- Integration interfaces — message types (e.g. EDI 856, IDoc, REST), payload structure, frequency, failure handling.
- Reports — list of regulated reports, the data they include, the snapshot/live behaviour.
- Security and roles — role catalogue with permissions per function.
- Performance / non-functional expectations — throughput, response time, concurrency.
- Open issues and assumptions.
- Traceability matrix — URS-ID → FS-section.
04Supplier-owned vs customer-tailored FS
Under GAMP 5 Category 4 (configured products like an MES, LIMS or eQMS — V5 sits here) the FS is owned by the supplier. The supplier publishes a baseline FS that describes the product's out-of-the-box behaviour; the customer layers a configuration spec on top that captures the deltas — industry profile choices, signature workflows enabled, integration endpoints, label templates, report headers.
For Category 5 bespoke development, the FS is fully customer-owned (often co-authored with the developer). For Category 3 non-configured products, a supplier datasheet plus a one-page customer addendum is usually enough. The right approach is set by the GAMP 5 risk classification, not by tradition.
05Rules for writing good FS lines
- Atomic — one behaviour per line. "The system shall calculate and display the corrected weight and alert the operator if out of tolerance" is three lines, not one.
- Testable — every line must be expressible as a Pass/Fail OQ check. "User-friendly screen" is not testable; "Field accepts 1–999.999 kg, rejects negatives with message E-014" is.
- Implementation-neutral — describe behaviour, not data structures. "Stored in the audit_logs table" belongs in DS.
- Cross-referenced — every line traces back to a URS ID.
- Versioned — change control covers every revision; rollback to any historical version must be possible.
- Reviewed by users, not only by engineers — the people who will use the system must have signed off on the workflow before code is cut.
06FS and Part 11 / Annex 11
An FS for any GMP-relevant system must explicitly describe electronic-record and electronic-signature behaviour. Inspectors expect to see:
- Which records are designated regulated records and therefore subject to Part 11.
- What audit-trail captures: who, what, when, why, before/after, with an unforgeable timestamp.
- Signature manifestation: name + date/time + meaning of the signature ("performed by", "reviewed by") on every record view and printout.
- Two-person signature flows where regulations require them (formula approval, batch release, deviation closure).
- How signatures are bound to records (signature cannot be transplanted to another record).
- Open-system controls where applicable (encryption, digital signatures, integrity verification).
07Common mistakes
- FS describes the database schema ("the weighings table shall have columns…") — that's DS.
- FS line written as "system shall do X — see code module Y" — implementation leakage.
- Calculations described as "as per Excel master" instead of being written out — auditors can't follow the spreadsheet.
- No version control on the FS — reviewers don't know which version they signed.
- FS authored by the developer alone — business-process gaps are baked in.
- FS does not describe audit-trail / signature behaviour — Annex 11 §9 finding.
08How V5 Ultimate handles FS
Frequently asked questions
Q.What's the difference between URS and FS?+
URS captures what the business needs ("users shall be able to approve formulas with two e-signatures"). FS captures how the system delivers that — screens, fields, validations, role permissions, signature manifestation. URS is owned by the customer; FS is usually owned by the supplier for Category 4 products.
Q.Do I need an FS for SaaS / cloud products?+
Yes. The supplier's baseline FS plus the customer's configuration addendum is the standard pattern. PIC/S PI 041 and FDA's 2025 CSA guidance both endorse this risk-based posture.
Q.How big should an FS be?+
Driven by GAMP category and risk. A Category 3 instrument FS is a few pages. A Category 4 MES baseline FS is hundreds of pages, but the customer addendum is usually one to two dozen pages capturing only the deltas.
Q.Can FS and DS be a single document?+
Not recommended. Merging them defeats the V-model traceability and makes change control much harder — every code change would force an FS revision. Keep them separated even when both sit in the same controlled-document set.
Q.What triggers an FS revision?+
Any change in user-visible behaviour: new screens, new fields, changed validation, changed signature flow, new integration. Pure implementation changes (refactor, performance tuning, technology stack swap that preserves behaviour) update DS only.
Primary sources
Further reading
- URSThe requirements FS turns into a functional design.
- DSThe technical implementation spec FS leads into.
- DQThe qualification that reviews FS for URS coverage.
- GAMP 5The risk-based CSV framework around FS.
- IQ / OQ / PQOQ test scripts trace back to FS.
- Traceability matrixThe matrix that links URS ↔ FS ↔ DS ↔ test.
Explore this topic
FS sits inside 2 overlapping topic clusters in our glossary. Every neighbour is one click away.
Electronic records, signatures, audit trail and ALCOA+ data-integrity principles.
URS-through-PQ lifecycle, GAMP 5 categorisation and CSA's modern alternative.
V5 Ultimate ships with the FS controls already wired in — audit trail, e-signatures, validation evidence. Free trial, no credit card, onboard in days, not months.
