Demand Overrides

The demand_override object

An adjustment to the demand a production schedule plans against.

Sales history cannot see a large customer that is about to order, a promotion, or a line that is being discontinued. An override is how management tells the planner about it. The period names the months the demand will occur in — months of the coming planning year; a period entirely in the past adjusts nothing, because the plan is solved for the year ahead. effective_from and expires_at bound when the override is consulted at all, which is a different question — an override for next quarter typically stops applying once the real orders arrive.

A product-line override applies to each of the line's items; an account-wide override applies to every planned item, which is how a global growth assumption (e.g. "plan for double demand") is expressed.

idstring

Demand override ID.

objectstringenumValues:demand_override

Resource type identifier.

scope_typestringenumValues:itemproduct_lineaccount

What kind of resource the override targets. Mirrors scope.type, which is only present when the scope is expanded.

scopeentitynullable

The item or product line the override targets. Expandable. Null for an account-wide override, which targets everything.

This is a single reference rather than one field per scope because a given override targets exactly one of them; scope.type names which.

idstring

Unique identifier for the entity.

objectstringenumValues:entity

Resource type identifier.

typestringenumValues:accountactorentity

The resource kind that this entity references, as an object-type value (e.g. user, account).

Unlike object — which is always entity — this names the underlying resource the id points to.

namestringnullable

Human-readable display name for the entity (e.g. a user's full name, a sales order number).

handlestringnullable

Secondary human-readable identifier (e.g. email address, username, redacted API key value).

period_starts_atstring (date-time)

First day of the demand period the override applies to.

period_ends_atstring (date-time)

Last day of the demand period the override applies to.

adjustmentstringenumValues:absolutedelta_unitsdelta_percent

How the value adjusts the forecast.

valuenumber

The adjustment, interpreted according to adjustment.

unitunitnullable

The unit the value is expressed in. Expandable.

reasonstringnullableenumValues:new_customerlost_accountpromotion

Why the adjustment was made.

notestringnullable

Free-form notes about the adjustment.

created_byactornullable

The actor that created the override. This may be a user, an API key, or an agent. Expandable.

effective_atstring (date-time)

When the override starts being applied to solves.

expires_atstring (date-time)nullable

When the override stops being applied to solves.

statusstringenumValues:activeinactive

Whether the override is applied to solves at all.

created_atstring (date-time)

Creation timestamp.

updated_atstring (date-time)

Last updated timestamp.

Used by

POSTCreate Demand OverrideDemand OverridesPATCHUpdate Demand OverrideDemand OverridesGETList Demand Override TypesDemand OverridesGETList Demand OverridesDemand OverridesGETRetrieve Demand OverrideDemand OverridesDELETEDelete Demand OverrideDemand Overrides