Skip to main content

Retail

Pack file: catalog/industries/retail in ambient-core.

Workspace demo (screenshots) · Catalog consumption

Industry summary​

Industry code

ISIC Rev.4 4711

20 metrics · 6 data options

NAICS 2022
455219
NACE Rev.2
47.11
GICS 2023
255040

Taxonomy tags from ambient-core pack.yaml / manifest v3 (analysis lens, not legal-entity self-classification). Coverage notes: catalog-industry-coverage.md.

Data options (6)​

Accounting Software​

Catalog key retail.core.accounting_software

Fields

date
date
period_start_date
date
period_end_date
date
revenue
decimal
cogs
decimal
cost_of_goods
decimal
operating_expenses
decimal
net_income
decimal
produce_revenue
decimal
total_production_cost
decimal
total_operational_cost
decimal

Financial statements​

Catalog key retail.core.financial_statements

Fields

date
date
statement_type
enum
period_start_date
date
period_end_date
date

HR records​

Catalog key retail.core.hr_records

Fields

date
date
headcount
decimal

Payroll records​

Catalog key retail.core.payroll_records

Fields

date
date
period_start_date
date
period_end_date
date
headcount
decimal
gross_pay
decimal
net_pay
decimal
employer_taxes
decimal
labor_cost
decimal
revenue
decimal
net_income
decimal
total_labor_costs
decimal
total_harvested_kg
decimal
total_production_cost
decimal
total_operational_cost
decimal
drivers_left
decimal
total_drivers
decimal
total_maintenance_costs
decimal
total_miles
decimal

Inventory valuation export​

Catalog key retail.financial.inventory_summary

Fields

date
date
banner
string
cogs
string
average_inventory_value
string
shrinkage_value
string
sales
string

Store sales summary export​

Catalog key retail.operations.store_sales_summary

Fields

date
date
store_id
id
current_period_sales
enum
prior_period_sales
enum
net_sales
string
selling_square_footage
string
transactions
string
visitors
string

Metrics (20)​

Monthly Burn Rate​

  • ID: 1652
  • Type: Financial
  • Unit: Currency/month
  • Description: Net cash consumed per month (negative net operating cash flow).
  • Inputs: cash_out, cash_in
  • Methodology: Net Burn = Cash Out − Cash In (per month)
  • Calculation: cash_out - cash_in
  • Catalog key: retail.core.burn_rate

Cash Conversion Cycle​

  • ID: 1650
  • Type: Financial
  • Unit: Days
  • Description: Days to convert investments in inventory and receivables back into cash.
  • Inputs: days_inventory_outstanding
  • Methodology: CCC = DSO + Days Inventory Outstanding − DPO
  • Calculation: dso + days_inventory_outstanding - dpo
  • Catalog key: retail.core.ccc

Current Ratio​

  • ID: 1640
  • Type: Financial
  • Unit: Ratio
  • Description: Short-term liquidity: ability to cover current liabilities with current assets.
  • Inputs: current_assets, current_liabilities
  • Methodology: Current Ratio = Current Assets / Current Liabilities
  • Calculation: current_assets / current_liabilities
  • Catalog key: retail.core.current_ratio

Days Payable Outstanding (DPO)​

  • ID: 1649
  • Type: Financial
  • Unit: Days
  • Description: Average number of days the business takes to pay its suppliers.
  • Inputs: accounts_payable, cogs, days
  • Methodology: DPO = (Accounts Payable / COGS) × Number of Days
  • Calculation: accounts_payable / cogs * days
  • Catalog key: retail.core.dpo

Days Sales Outstanding (DSO)​

  • ID: 1648
  • Type: Financial
  • Unit: Days
  • Description: Average number of days to collect cash after a sale.
  • Inputs: accounts_receivable, total_credit_sales, days
  • Methodology: DSO = (Accounts Receivable / Total Credit Sales) × Number of Days
  • Calculation: accounts_receivable / total_credit_sales * days
  • Catalog key: retail.core.dso

EBITDA Margin​

  • ID: 1644
  • Type: Financial
  • Unit: %
  • Description: Core operating cash profitability before interest, tax, depreciation and amortization.
  • Inputs: ebitda, revenue
  • Methodology: EBITDA Margin = (EBITDA / Revenue) × 100
  • Calculation: ebitda / revenue * 100
  • Catalog key: retail.core.ebitda_margin

Gross Profit Margin​

  • ID: 1642
  • Type: Financial
  • Unit: %
  • Description: Share of revenue retained after the direct cost of goods sold.
  • Inputs: revenue, cogs
  • Methodology: Gross Margin = ((Revenue − COGS) / Revenue) × 100
  • Calculation: (revenue - cogs) / revenue * 100
  • Catalog key: retail.core.gross_margin

Headcount (FTE)​

  • ID: 1654
  • Type: Operational
  • Unit: Count
  • Description: Period-end count of active full-time-equivalent employees. A directly measured input, not a derived ratio.
  • Methodology: Period-end count of active employees expressed as full-time equivalents (directly measured, not calculated).
  • Calculation: No machine-readable calc — directly reported or qualitative.
  • Catalog key: retail.core.headcount

Net Profit Margin​

  • ID: 1645
  • Type: Financial
  • Unit: %
  • Description: Bottom-line profitability after all costs, interest and tax.
  • Inputs: net_income, revenue
  • Methodology: Net Profit Margin = (Net Income / Revenue) × 100
  • Calculation: net_income / revenue * 100
  • Catalog key: retail.core.net_margin

Operating Cash Flow​

  • ID: 1651
  • Type: Financial
  • Unit: Currency (e.g., USD)
  • Description: Cash generated by core operations during the period.
  • Inputs: net_income, non_cash_charges, increase_in_working_capital
  • Methodology: Operating Cash Flow = Net Income + Non-Cash Charges − Increase in Working Capital
  • Calculation: net_income + non_cash_charges - increase_in_working_capital
  • Catalog key: retail.core.operating_cash_flow

Operating Margin (EBIT)​

  • ID: 1643
  • Type: Financial
  • Unit: %
  • Description: Operating profitability after operating expenses (EBIT margin).
  • Inputs: operating_income, revenue
  • Methodology: Operating Margin = (Operating Income / Revenue) × 100
  • Calculation: operating_income / revenue * 100
  • Catalog key: retail.core.operating_margin

Quick Ratio (Acid Test)​

  • ID: 1641
  • Type: Financial
  • Unit: Ratio
  • Description: Acid-test liquidity excluding inventory — most conservative short-term solvency view.
  • Inputs: current_assets, inventory, current_liabilities
  • Methodology: Quick Ratio = (Current Assets − Inventory) / Current Liabilities
  • Calculation: (current_assets - inventory) / current_liabilities
  • Catalog key: retail.core.quick_ratio

Revenue Growth Rate​

  • ID: 1646
  • Type: Financial
  • Unit: %
  • Description: Period-over-period revenue growth rate.
  • Inputs: revenue, revenue_prior
  • Methodology: Revenue Growth = ((Current Period Revenue − Prior Period Revenue) / Prior Period Revenue) × 100
  • Calculation: (revenue - revenue_prior) / revenue_prior * 100
  • Catalog key: retail.core.revenue_growth

Cash Runway​

  • ID: 1653
  • Type: Financial
  • Unit: Months
  • Description: Number of months of cash remaining at the current net burn rate.
  • Inputs: current_cash_balance
  • Methodology: Runway (months) = Current Cash Balance / Monthly Net Burn
  • Calculation: current_cash_balance / burn_rate
  • Catalog key: retail.core.runway

Working Capital​

  • ID: 1647
  • Type: Financial
  • Unit: Currency (e.g., USD)
  • Description: Operating liquidity available to fund day-to-day operations.
  • Inputs: current_assets, current_liabilities
  • Methodology: Working Capital = Current Assets − Current Liabilities
  • Calculation: current_assets - current_liabilities
  • Catalog key: retail.core.working_capital

Inventory Turnover​

  • ID: 1671
  • Type: Financial
  • Unit: Turns
  • Description: How often retail inventory is sold and replaced over a period.
  • Inputs: cogs, average_inventory_value
  • Methodology: Inventory Turnover = COGS / Average Inventory Value
  • Calculation: cogs / average_inventory_value
  • Catalog key: retail.financial.inventory_turnover

Sales per Square Foot​

  • ID: 1673
  • Type: Financial
  • Unit: Currency
  • Description: Revenue productivity per selling square foot (aggregated by store or banner).
  • Inputs: net_sales, selling_square_footage
  • Methodology: Sales per Sq Ft = Net Sales / Selling Square Footage
  • Calculation: net_sales / selling_square_footage
  • Catalog key: retail.financial.sales_per_square_foot

Conversion Rate​

  • ID: 1674
  • Type: Operational
  • Unit: %
  • Description: Share of store or site visitors who complete a purchase (omnichannel where available).
  • Inputs: transactions, visitors
  • Methodology: Conversion Rate = (Transactions / Visitors) × 100
  • Calculation: transactions / visitors * 100
  • Catalog key: retail.operations.conversion_rate

Same-Store Sales Growth​

  • ID: 1670
  • Type: Operational
  • Unit: %
  • Description: Year-over-year revenue growth for stores open in both periods (aggregated).
  • Inputs: current_period_sales, prior_period_sales
  • Methodology: SSS Growth = ((Current Period Sales − Prior Period Sales) / Prior Period Sales) × 100
  • Calculation: (current_period_sales - prior_period_sales) / prior_period_sales * 100
  • Catalog key: retail.operations.same_store_sales_growth

Shrink Rate​

  • ID: 1672
  • Type: Operational
  • Unit: %
  • Description: Inventory loss from theft, damage, or administrative error (aggregated).
  • Inputs: shrinkage_value, sales
  • Methodology: Shrink Rate = (Shrinkage Value / Sales) × 100
  • Calculation: shrinkage_value / sales * 100
  • Catalog key: retail.operations.shrink_rate

Data engineering pipeline​

Ambient Core ships the catalog (typed data options and metrics) and ambient_pipeline helpers. Lakehouse jobs and schedules live in the application repository that pins a core tag.

Canonical order: map columns → coerce types → unpivot → stamp lineage → (optional Silver validate) → contract assert → write. Gold vertical products evaluate catalog formulas with ambient_calc after Silver.

How this pack feeds the pipeline​

Further reading: Catalog consumption · Pipeline governance helpers

Generated from ambient-core ref 22b6089 (digest f5bca892574e3e28). Regenerate: npm run sync:catalog-wiki.