Skip to content

Derive

Derive is the NGB platform concept for creating the next business document from an existing one without losing business lineage.

Typical examples include:

  • Sales Order to Sales Invoice;
  • Sales Invoice to Credit Memo;
  • Maintenance Request to Work Order;
  • lease charge to downstream settlement document.

Why derive exists

Derive is not a copy-and-paste shortcut.

It exists so the platform can preserve:

  • source document identity;
  • workflow intent;
  • allowed transition rules;
  • prefilled business data;
  • durable provenance for later explainability.

That distinction matters because a follow-up document should carry more meaning than “someone created a similar record by hand.”

What a good derive flow should guarantee

A production-ready derive flow should define:

  • which source document types are allowed;
  • which target document types can be created;
  • which source statuses permit the action;
  • which fields and parts are prefilled;
  • which business relationships are recorded.

If those rules are not explicit, derive becomes opaque and unreliable.

Derive and workflow continuity

Derive belongs to the business workflow layer.

It should help a user move through a chain such as:

  • order to invoice;
  • invoice to correction;
  • request to execution document;
  • source commercial document to settlement document.

That is why derive should be visible in document actions and later visible in Document Flow.

Derive and provenance

When one document is derived from another, the system should preserve:

  • the source reference;
  • the relationship type;
  • the fact that the target is a follow-up artifact rather than an unrelated record.

Without that provenance, downstream audit and support work become much harder.

Design checklist

When defining a derive flow, confirm all of the following:

  • the source document has a stable business meaning;
  • the target document is a real downstream artifact, not a convenience duplicate;
  • status rules prevent invalid derivation;
  • the prefill logic is deterministic and explainable;
  • resulting document relationships remain visible to users.

Released under the Apache License 2.0.