View a markdown version of this page

Data Entities for Supply Planning - Amazon Connect Decisions

Data Entities for Supply Planning

The following table lists the data entities and columns used by Supply Planning.

How to read the table:

  • Required – The entity or columns in the data entity are mandatory for the supply planning engine to function correctly.

  • Conditionally required – The entity or columns in the data entity are required depending on the specific major functional requirements, policy type, order type, or sourcing rule type selected.

  • Optional – The entity or columns in the data entity is optional. For enhanced planning accuracy and feature output, it is recommended to add the column with values.

site (required)

How is this data entity used? Supply Planning uses the site data to define the physical locations (plants, warehouses, and distribution centers) within the supply chain network. Sites serve as the origin and destination nodes for transportation lanes, sourcing rules, and inventory policies.

Column Is the column required? How is this column used in Supply Planning?

id

Required

Unique identifier for the physical site (plant, warehouse, or distribution center) within the supply chain network. Make sure the column values do not have invalid characters such as asterisk and double-quotes.

description

Optional

Human-readable name or label for the site.

geo_id

Optional

Foreign key linking this site to its geographic location in the Geography table.

is_active

Optional

Boolean flag indicating whether the site is currently operational and available for planning. By default, the site is considered as Active.

open_date

Optional

Calendar date on which the site became or will become operationally active. Used by the planning engine to exclude future sites from current plans while incorporating them into forward-looking network scenarios.

end_date

Optional

Calendar date on which the site was or will be decommissioned and removed from active planning. After this date, the planning engine will no longer route demand to or hold inventory at this site.

site_level_1

Optional

The highest level in the site hierarchy, typically representing the broadest geographic or organizational grouping. This denormalized field enables efficient filtering and sorting across the site hierarchy.

site_level_2

Optional

The second level in the site hierarchy, representing a regional subdivision within the top-level site grouping. Leave blank if your site hierarchy has fewer than 2 levels.

site_level_3

Optional

The third level in the site hierarchy, representing a more granular geographic or organizational classification within level 2. Leave blank if your site hierarchy has fewer than 3 levels.

site_level_4

Optional

The fourth level in the site hierarchy, representing a specific site cluster or sub-region within level 3. Leave blank if your site hierarchy has fewer than 4 levels.

site_level_5

Optional

The fifth and most granular level in the site hierarchy. Leave blank if your site hierarchy has fewer than 5 levels.

product (required)

How is this data entity used? Supply Planning uses the product data to identify and classify all items being planned. Product attributes are used to establish hierarchy filters for supply plan review, link products to inventory policies and sourcing rules, and support multi-level product segmentation.

Column Is the column required? How is this column used in Supply Planning?

id

Required

Unique identifier for the product/material (SKU-level). Make sure the column values do not have duplicate IDs and special characters such as asterisk and double-quotes.

description

Required

Human-readable name or description of the product.

product_group_id

Optional

Foreign key linking the product to its category in the Product Hierarchy table.

unit_cost

Optional

Standard cost per unit used for inventory valuation and cost planning.

unit_price

Optional

Unit Price or standard price or MSRP of product.

base_uom

Optional

Unit of measure for product. Default to Eaches. Currently supply planning only supports Eaches.

volume_uom

Optional

Product volume. Currently volume_uom has be the same across all products.

unit_volume

Optional

Volume of product per volum_uom defined at the warehouse level.

is_deleted

Optional

Boolean flag indicating whether the product has been discontinued or marked inactive. By default, the product is considered as Active or Not deleted.

product_level_1

Optional

The highest level in the product hierarchy, typically representing the broadest product category or division. This denormalized field enables efficient filtering and sorting across the product hierarchy.

product_level_2

Optional

The second level in the product hierarchy, representing a subcategory within the top-level product category. Leave blank if your product hierarchy has fewer than 2 levels.

product_level_3

Optional

The third level in the product hierarchy, representing a more granular product classification within level 2. Leave blank if your product hierarchy has fewer than 3 levels.

product_level_4

Optional

The fourth level in the product hierarchy, representing a specific product family or sub-classification within level 3. Leave blank if your product hierarchy has fewer than 4 levels.

product_level_5

Optional

The fifth and most granular level in the product hierarchy. Leave blank if your product hierarchy has fewer than 5 levels.

product_hierarchy (optional)

How is this data entity used? Supply Planning uses product hierarchy data to organize products into structured category trees. This enables multi-level filtering and aggregated analysis of supply plans, and allows sourcing rules and inventory policies to be applied at a group level rather than individual SKU level.

Column Is the column required? How is this column used in Supply Planning?

id

Required

Unique identifier for the product group/category level.

description

Optional

Name or label of the product group/category.

parent_product_group_id

Optional

Foreign key to the parent category, forming the hierarchical tree structure for product classification.

geography (optional)

How is this data entity used? Supply Planning uses geography data to establish hierarchical location classifications for sites. Geographic entities enable regional rollup analysis and allow lead times and inventory policies to be defined at geographic region granularity.

Column Is the column required? How is this column used in Supply Planning?

id

Required

Unique identifier for the geographic entity (city, state, country, region).

description

Optional

Name of the geographic location (e.g., city name, region name).

parent_geo_id

Optional

Foreign key to the parent geography, enabling hierarchical rollups (e.g., city to state to country).

transportation_lane (conditional required)

How is this data entity used? Supply Planning uses transportation lane data to model the physical routes between origin and destination sites in the network. This data defines transit times and validity windows that the planning engine uses to schedule inbound and outbound shipments accurately.

Column Is the column required? How is this column used in Supply Planning?

id

Required

Unique identifier for the transportation lane, typically a composite of origin, destination, product group, and vendor.

from_site_id

Required

Origin site (supplier warehouse or manufacturing plant) from which goods are shipped.

to_site_id

Required

Destination site (receiving warehouse or plant) where goods are delivered.

product_group_id

Optional

Product category this lane applies to, enabling lane-level filtering by product group.

product_id

Optional

Specific product this lane applies to, for product-level lane definitions.

transit_time

Required

Number of days required to transport goods from origin to destination. Default is 0.

eff_start_date

Required

Date from which this transportation lane becomes active/valid.

eff_end_date

Required

Date after which this transportation lane is no longer valid.

trading_partner (conditional required)

How is this data entity used? Supply Planning uses trading partner data to identify vendors, suppliers, customers, and carriers in the supply chain. Trading partners are referenced by sourcing rules, inbound order lines, and vendor lead times to associate supply activities with external business entities.

Column Is the column required? How is this column used in Supply Planning?

id

Required

Unique identifier for the trading partner (vendor, customer, carrier, or other external entity).

description

Optional

Name of the trading partner organization.

eff_start_date

Optional

Date from which the trading partner relationship is valid. Default 1900-01-01 00:00:00.

eff_end_date

Optional

Date after which the trading partner relationship expires. Default 9999-12-31 23:59:59.

vendor_product (conditional required)

How is this data entity used? Supply Planning uses vendor product data to define which vendors are authorized to supply specific products. This data enables the planning engine to validate sourcing rules and generate purchase orders only to approved vendor-product combinations within their effective date ranges.

Column Is the column required? How is this column used in Supply Planning?

vendor_tpartner_id

Required

Vendor/supplier who can provide this product.

product_id

Required

Product that the vendor is authorized/capable of supplying.

eff_start_date

Required

Date from which the vendor is authorized to supply this product.

eff_end_date

Required

Date after which the vendor is no longer authorized for this product.

vendor_lead_time (conditional required)

How is this data entity used? Supply Planning uses vendor lead time data to determine the expected duration between placing a purchase order and receiving the goods at the destination site. Accurate lead times are critical for the planning engine to recommend orders with the correct timing to meet demand without creating unnecessary stockouts or excess inventory.

Column Is the column required? How is this column used in Supply Planning?

vendor_tpartner_id

Required

Vendor/supplier whose lead time is being defined.

product_id

Optional

Specific product the lead time applies to (if product-level granularity).

product_group_id

Optional

Product group the lead time applies to (if group-level granularity).

site_id

Required

Destination site for delivery, since lead times may vary by receiving location.

planned_lead_time

Required

Expected number of days from order placement to delivery receipt.

eff_start_date

Optional

Date from which this lead time definition is valid. Default is 1900-01-01 00:00:00.

eff_end_date

Optional

Date after which this lead time definition expires. Default is 9999-12-31 23:59:59.

region_id

Optional

Geographic region for region-specific lead time definitions.

company (optional)

How is this data entity used? Supply Planning uses company data to support multi-entity planning environments where different legal entities or business units operate within a shared supply chain instance.

Column Is the column required? How is this column used in Supply Planning?

id

Required

Unique identifier for the company/legal entity.

description

Optional

Name or label of the company.

address_line_1

Optional

Primary street address line for the company.

address_line_2

Optional

Secondary address line (suite, building, floor).

city

Optional

City where the company is located.

state_prov

Optional

State or province where the company is located.

postal_code

Optional

Postal or ZIP code for the company address.

country

Optional

Country where the company is registered or operating.

phone

Optional

Primary contact phone number for the company.

email

Optional

Primary contact email address for the company.

sourcing_rules (required)

How is this data entity used? Supply Planning uses sourcing rules to determine how each product at each destination site is replenished. Rules specify whether supply comes from an external buy (purchase order), internal transfer (transfer order), or manufacturing (production order), and define the sourcing priority and allocation ratios when multiple supply options exist.

Column Is the column required? How is this column used in Supply Planning?

sourcing_rule_id

Required

Unique identifier for the sourcing rule.

product_id

Optional

Specific product governed by this sourcing rule.

product_group_id

Optional

Product group governed by this sourcing rule.

to_site_id

Required

Destination site that will receive supply under this rule.

sourcing_rule_type

Required

Nature of the sourcing: buy (external procurement), manufacture (internal production), or transfer (inter-plant).

from_site_id

Conditionally required

Source/origin site for the supply (internal plant or warehouse). Required when sourcing_rule_type is "transfer".

tpartner_id

Conditionally required

Vendor/supplier ID; required when sourcing_rule_type is "buy".

transportation_lane_id

Optional

Link to the transportation lane used for this sourcing path.

sourcing_priority

Optional

Priority ranking used when multiple sourcing options exist for the same product/site.

sourcing_ratio

Optional

Percentage allocation (0-100) defining what proportion of total demand this sourcing rule fulfills when multiple active sourcing rules exist for the same product-site-period combination.

min_qty

Optional

Minimum order quantity constraint for this sourcing rule.

qty_multiple

Optional

Order quantity must be a multiple of this value (lot sizing).

production_process_id

Optional

Manufacturing process/route used when sourcing_rule_type is "manufacture".

eff_start_date

Optional

Date from which this sourcing rule is active. Default is 1900-01-01 00:00:00.

eff_end_date

Optional

Date after which this sourcing rule expires. Default is 9999-12-31 23:59:59.

inventory_policy (required)

How is this data entity used? Supply Planning uses inventory policy data to determine the safety stock calculation method and replenishment thresholds for each product-site combination. The policy type (absolute level, days-of-cover demand, or days-of-cover forecast) governs how the planning engine computes minimum inventory buffers and generates replenishment recommendations.

Column Is the column required? How is this column used in Supply Planning?

id

Required

Unique identifier for the inventory policy record.

site_id

Optional

The site/warehouse to which this inventory policy applies.

dest_geo_id

Optional

Geographic region this policy targets, enabling region-specific stocking strategies.

product_id

Optional

Specific product this policy applies to (if product-level policy).

product_group_id

Optional

Product group this policy applies to (if group-level policy).

ss_policy

Required

Safety stock policy type governing how safety stock is calculated: Abs_level, DOC_dem, or DOC_fcst. Currently sl (service level) is not supported. 1. Abs_level: Uses units specified in min/max inventory qty. Ordering will be suggested whenever inventory falls below min. 2. DOC_dem: Uses days of cover computed from historical demand as target level of inventory. 3. DOC_fcst: Uses days of cover computed from forecast as target level of inventory.

min_safety_stock

Optional

Absolute minimum safety stock quantity floor that overrides any policy-calculated value. Expressed in the product's base unit of measure.

min_inventory_qty

Conditionally required

Either min_inventory_qty/max_inventory_qty or target_inventory_qty is required when ss_policy is abs_level. Minimum inventory level (reorder point) that triggers a replenishment signal when on-hand quantity drops below this threshold.

max_inventory_qty

Conditionally required

Either min_inventory_qty/max_inventory_qty or target_inventory_qty is required when ss_policy is abs_level. Maximum allowable inventory quantity (order-up-to level) defining the upper cap for replenishment orders. Prevents overstocking by limiting the total inventory a site should hold for this product.

target_inventory_qty

Conditionally required

Either min_inventory_qty/max_inventory_qty or target_inventory_qty is required when ss_policy is abs_level. This is the target inventory quantity that the system will maintain.

min_doc_limit

Conditionally required

Either (min_doc_limit and max_doc_limit pair) or target_doc_limit is required when ss_policy is doc_dem or doc_fcst. Minimum days of cover floor ensuring that inventory always covers at least this many days of forward demand.

max_doc_limit

Conditionally required

Either (min_doc_limit and max_doc_limit pair) or target_doc_limit is required when ss_policy is doc_dem or doc_fcst. Maximum days of cover limit representing the upper boundary on inventory coverage.

target_doc_limit

Conditionally required

Either (min_doc_limit and max_doc_limit pair) or target_doc_limit is required when ss_policy is doc_dem or doc_fcst. Target days of cover (historical demand or forecast based).

eff_start_date

Optional

Date from which the inventory policy is effective. Default is 1900-01-01 00:00:00.

eff_end_date

Optional

Date after which the inventory policy expires. Default is 9999-12-31 23:59:59.

inventory_level (required)

How is this data entity used? Supply Planning uses inventory level snapshots to establish the current on-hand stock position at each site for each product. This data is the starting point for replenishment calculations, enabling the planning engine to determine the gap between current inventory and the target level defined by the inventory policy.

Column Is the column required? How is this column used in Supply Planning?

snapshot_date

Required

Date/time when the inventory snapshot was taken.

site_id

Required

Site/warehouse where this inventory is physically located.

product_id

Required

Product/material whose inventory is being reported.

on_hand_inventory

Required

Quantity of unrestricted, available-for-use stock on hand.

inv_condition

Optional

Condition or quality classification of the inventory (e.g., available, blocked, in-quality-hold).

forecast (conditionally required)

How is this data entity used? Supply Planning uses forecast data as the primary demand signal for replenishment calculations. The planning engine uses the forecasted demand quantities by product and site to determine how much inventory needs to be replenished and when, driving purchase, transfer, and production order recommendations across the planning horizon. This data is not required if forecast is generated by Amazon Connect Decisions Demand Intelligence.

Column Is the column required? How is this column used in Supply Planning?

snapshot_date

Required

Date when this forecast was generated or last updated.

site_id

Required

Site for which demand is being forecasted.

product_id

Required

Product for which demand is being forecasted.

mean

Conditionally required

Either mean or p50 needs to be provided. Arithmetic mean of the demand forecast distribution for this product-site-period combination. Serves as the primary demand signal.

p50

Conditionally required

Either mean or p50 needs to be provided. Median (50th percentile) forecast quantity representing the most likely demand scenario.

p10/20/30/40/50/60/70/80/90

Optional

Probabilistic forecast values at 10th, 50th, and 90th percentiles for demand variability analysis.

forecast_start_dttm

Required

Start date/time of the forecast bucket period.

forecast_end_dttm

Required

End date/time of the forecast bucket period.

outbound_order_line (conditionally required)

How is this data entity used? Supply Planning uses outbound order line data to track customer orders and demand commitments. This data provides visibility into confirmed demand, allowing the planning engine to reserve inventory for committed customer orders and factor fulfillment obligations into replenishment recommendations.

Column Is the column required? How is this column used in Supply Planning?

id

Required

Unique identifier for the outbound order line (delivery line item).

product_id

Required

Product being shipped to the customer.

cust_order_id

Required

Customer's sales order number this line belongs to.

status

Optional

Current fulfillment status of the line (e.g., Open, Cancelled, Closed).

order_date

Optional

Date the order was placed.

init_quantity_requested

Optional

Original quantity the customer initially ordered.

final_quantity_requested

Required

Current/adjusted quantity still to be fulfilled (accounts for partial shipments and order changes).

requested_delivery_date

Required

Date the customer originally requested delivery.

promised_delivery_date

Optional

Date committed to the customer after availability check.

actual_delivery_date

Optional

Date the goods were actually received by the customer.

ship_from_site_id

Required

Warehouse or plant from which the product will be shipped.

quantity_promised

Optional

Quantity confirmed/committed to the customer.

quantity_delivered

Optional

Quantity that has been physically shipped/delivered.

inbound_order_line (conditionally required)

How is this data entity used? Supply Planning uses inbound order line data to track open purchase orders, transfer orders, and manufacturing orders. This data provides visibility into planned supply receipts, enabling the planning engine to account for in-transit and confirmed inventory when generating replenishment recommendations.

Column Is the column required? How is this column used in Supply Planning?

id

Required

Unique identifier for the order line item (typically a composite of order ID and line number).

order_id

Required

Inbound order header number.

tpartner_id

Conditionally required

Mandatory for PO (Purchase Orders). Links the order line to the vendor/supplier. Default SCN_RESERVED_NO_VALUE_PROVIDED.

product_id

Required

The product/material being ordered on this line.

order_type

Required

Type classification of this order line. Should be PO (Purchase Order), TO (Transfer Order) or MO (Manufacture Order).

status

Optional

Current status of this specific line item (e.g., Open, InTransit, Closed, Cancelled).

from_site_id

Conditionally required

Mandatory for TO (Transfer Orders). Origin site from which the product is being shipped.

to_site_id

Required

Destination site for this line item's delivery.

quantity_submitted

Conditionally required

Original quantity requested/ordered. Either quantity_submitted or quantity_confirmed should be provided.

quantity_confirmed

Conditionally required

Quantity confirmed by the supplier for delivery. Either quantity_submitted or quantity_confirmed should be provided.

quantity_received

Optional

Quantity physically received at the destination site.

submitted_date

Optional

Date this line item was created in the system.

earliest_delivery_date

Conditionally required

At least one of earliest_delivery_date, latest_delivery_date or expected_delivery_date should be provided.

expected_delivery_date

Conditionally required

Planned or promised delivery date for this line item. At least one of earliest_delivery_date, latest_delivery_date or expected_delivery_date should be provided.

latest_delivery_date

Conditionally required

At least one of earliest_delivery_date, latest_delivery_date or expected_delivery_date should be provided.

earliest_ship_date

Optional

Earliest date and time when vendor shipped products for this order-line. If populated, planning engine will use this date to determine order start date.

latest_ship_date

Optional

Latest date and time when vendor shipped products for this order-line. If populated, planning engine will use this date to determine order start date.

product_group_id

Optional

Product group context for this alternate mapping.

to_site_id

Optional

Destination site for the alternate product delivery.

from_site_id

Optional

Origin site for the alternate product sourcing.

transportation_lane_id

Optional

Transportation lane to use when sourcing this alternate product.

min_qty

Optional

Minimum order quantity for the alternate product.

qty_multiple

Optional

Order quantity must be a multiple of this value for the alternate product.

product_bom (conditionally required)

How is this data entity used? Supply Planning uses Product Bill of Materials (BOM) data to explode finished goods demand into component-level requirements. When the planning engine generates production orders for manufactured products, it uses the BOM to calculate how much of each raw material or sub-assembly is needed, creating dependent demand signals for component procurement and production planning.

Column Is the column required? How is this column used in Supply Planning?

id

Required

Unique identifier for the BOM line record, typically a surrogate key or composite of parent product, component product, site, and effective dates.

product_id

Required

Foreign key to the Product table identifying the finished good or parent assembly that is manufactured using this BOM.

site_id

Required

Foreign key to the Site table identifying the manufacturing location where this BOM is valid.

component_product_id

Required

Foreign key to the Product table identifying the raw material, sub-assembly, or intermediate component required to produce the parent product.

component_quantity_per

Required

Quantity of the component product required to produce one unit of the parent finished good, expressed in the component's base unit of measure.

eff_start_date

Required

Calendar date from which this BOM relationship is effective and should be used by the planning engine for demand explosion.

eff_end_date

Required

Calendar date after which this BOM relationship is no longer valid and should not be used for planning.

production_process_id

Optional

Foreign key to the Production Process table identifying which manufacturing route or recipe uses this specific BOM.

production_process (not supported in Supply Planning right now, to be added soon)

How is this data entity used? This data entity is not supported in Supply Planning right now. But it will be added soon. When supported, the planning engine will use setup time and operation time to calculate the manufacturing lead times and evaluate production capacity feasibility.

Column Is the column required? How is this column used in Supply Planning?

production_process_id

Required

Unique identifier for the manufacturing process or production route. Represents a specific sequence of operations that transforms raw materials/components into a finished product at a given site.

product_id

Required

Foreign key to the Product table identifying the finished good or output product manufactured by this production process.

site_id

Required

Foreign key to the Site table identifying the manufacturing facility where this production process is physically executed.

setup_time

Required

Fixed one-time duration (in hours) required to changeover, calibrate, and prepare the production equipment before a batch run can begin.

operation_time

Required

Variable processing time (in hours) consumed per unit of output produced on this manufacturing line. Total production duration = setup_time + (operation_time x planned quantity).

segmentation_rule (not supported in Supply Planning right now, to be added soon)

How is this data entity used? This data entity is not supported in Supply Planning right now. But it will be added soon. Segmentation Rule data will enable differentiated planning by classifying products and sites into segments (e.g., by demand variability, customer tier, or product lifecycle). When supported, the planning engine will apply segment-specific inventory policies, forecast models, and service-level targets.

Column Is the column required? How is this column used in Supply Planning?

segmentation_rule_id

Required

Unique identifier for a segmentation rule mapping a specific segment_type + segment_value combination to product/site/channel dimensions.

segment_type

Required

Name of the segmentation dimension being defined (e.g., DemandVariability, CustomerTier, ProductLifecycle, ServiceLevel).

segment_value

Required

Specific value within the segment_type classification (e.g., High, Medium, Low for DemandVariability; A, B, C for CustomerTier).

segmentation_rule_description

Optional

Human-readable explanation of the business logic or criteria used to assign entities to this segment.

product_id

Optional

Foreign key to the Product table. When populated, the rule applies to this specific product only.

product_level_1

Optional

Highest level in the product hierarchy. Enables broad segmentation across entire product families.

product_level_2

Optional

Second-level product hierarchy classification. Provides intermediate product grouping for segmentation.

product_level_3

Optional

Third-level product hierarchy classification. Enables mid-granularity product segmentation.

product_level_4

Optional

Fourth-level product hierarchy classification. Enables fine-grained product segmentation.

product_level_5

Optional

Most granular product hierarchy level. Leave blank if the rule targets a coarser level or a specific product_id.

site_id

Optional

Foreign key to the Site table. When populated, the rule applies to this specific site only.

site_level_1

Optional

Highest level in the site hierarchy. Enables broad geographic segmentation across the network.

site_level_2

Optional

Second-level site hierarchy. Provides intermediate geographic grouping for segmentation.

site_level_3

Optional

Third-level site hierarchy. Enables mid-granularity geographic segmentation.

site_level_4

Optional

Fourth-level site hierarchy. Enables fine-grained geographic segmentation.

site_level_5

Optional

Most granular site hierarchy level. Leave blank if the rule targets a coarser level or a specific site_id.

city

Optional

City name of the ship-from site location. Provides geographic context for location-based segmentation.

state_prov

Optional

State or province of the ship-from site. Enables regional segmentation and compliance with jurisdiction-specific business rules.

postal_code

Optional

Postal/ZIP code of the ship-from site. Enables precise geographic targeting for segmentation rules.

country

Optional

Country of the ship-from site. Enables country-level segmentation for international operations.

trading_partner_id

Optional

Foreign key to the Trading Partner table. Enables segmentation rules based on supplier, customer, or carrier relationships.

company_id

Optional

Foreign key to the Company table. Enables multi-entity segmentation where different legal entities maintain separate classification rules.

channel_id

Optional

Foreign key referencing the sales/distribution channel. Enables channel-specific segmentation for omnichannel operations.

creation_date

Optional

ISO 8601 timestamp when this segmentation rule was created. Supports audit trail and version tracking.

connection_id

Optional

System-assigned identifier for the data source connection. Auto-populated by Prism upon ingestion — do not supply manually.

updated_at

Optional

System-managed timestamp of the last modification to this record. Auto-populated by Prism for data lineage — do not supply manually.

updated_by

Optional

System-managed identifier of the user or process that last modified this record. Auto-populated by Prism for data lineage — do not supply manually.

Direct upload data entities

Note

capacity_constraints, capacity_product_mapping, warehouse_space_limit, and planning_time_fence_constraints don't require setting up the data ingestion flows. These data entities can be directly uploaded on the supply planning configuration page through Decision Teammates.

capacity_constraints (conditionally required)

How is this data entity used? Supply Planning uses capacity constraint data to define the minimum and maximum throughput limits for each capacity resource at each site within defined time buckets. The planning engine enforces these constraints when generating production and storage recommendations to ensure plans remain within physical or contractual feasibility boundaries.

Column Is the column required? How is this column used in Supply Planning?

id

Required

Unique identifier for the capacity constraint record. References a combination of capacity resource, site, time bucket, and effective date range.

capacity_id

Required

Foreign key to the Capacity table identifying the specific resource being constrained (e.g., a production line, storage zone, dock, or labor pool).

site_id

Required

Foreign key to the Site table identifying the physical location where this capacity constraint applies.

bucket_type

Required

Defines the time bucket granularity for measuring and enforcing capacity utilization. Accepted values: Daily, Weekly, Monthly.

eff_start_date

Required

Calendar date from which this capacity constraint becomes active and enforceable by the planning engine.

eff_end_date

Required

Calendar date after which this capacity constraint expires and is no longer enforced.

min_capacity_usage

Optional

Minimum throughput or utilization volume required within the defined time bucket. Represents a contractual or operational floor.

max_capacity_usage

Required

Maximum throughput or utilization volume allowed within the defined time bucket. The planning engine must not schedule production or allocate inventory beyond this limit.

capacity_product_mapping (conditionally required)

How is this data entity used? Supply Planning uses capacity product mapping data to link products to the capacity resources they consume at each site. This mapping enables the planning engine to aggregate total capacity demand across all products sharing a common resource, identify bottlenecks, and prioritize production sequencing when capacity is limited.

Column Is the column required? How is this column used in Supply Planning?

id

Required

Unique identifier for the capacity-to-product mapping record linking a specific product to the capacity resource it consumes at a given site.

product_id

Required

Foreign key to the Product table identifying the specific SKU or material whose production or handling consumes capacity from the mapped resource.

site_id

Required

Foreign key to the Site table specifying the location where this product-to-capacity relationship is valid.

capacity_id

Required

Foreign key to the Capacity table identifying which capacity resource this product consumes during production, storage, or handling.

warehouse_space_limit (conditionally required)

How is this data entity used? Supply Planning uses warehouse space limit data to constrain replenishment recommendations so that planned inventory never exceeds the physical storage capacity of a warehouse. This prevents the planning engine from generating supply orders that would result in overcrowding or infeasible storage requirements at a site.

Column Is the column required? How is this column used in Supply Planning?

site_id

Required

Identifier of the warehouse whose capacity is being defined.

max_capacity

Required

Maximum storage capacity of the warehouse, expressed in the volume unit of measure defined in the Product entity. Used to constrain supply plans from exceeding physical space.

planning_time_fence_constraints (conditionally required)

How is this data entity used? Supply Planning uses planning time fence constraint data to define time boundaries within which the planning engine is restricted from making changes to existing supply orders. These constraints enable planners to protect near-term supply plans from automatic rescheduling, preserving confirmed orders for specific products and sites within the defined time fence window.

Column Is the column required? How is this column used in Supply Planning?

rule_id

Required

Unique identifier for the planning time fence constraint rule.

product_id

Optional

Foreign key to the Product table. When populated, the time fence applies to this specific product only. When left blank, the constraint applies to all products at the specified site.

site_id

Optional

Foreign key to the Site table. When populated, the time fence applies to this specific site only. When left blank, the constraint applies to the specified product across all sites.

planning_time_fence_days

Required

Number of calendar days from the planning run date within which the planning engine will not automatically reschedule or cancel existing supply orders. Orders with order start dates within this window are treated as frozen and protected from automated changes.