specification: FinOps Framework
specificationVersion: '1.0'
schema: https://www.finops.org/framework/
alignedWith:
  framework: FinOps Foundation Framework
  frameworkUrl: https://www.finops.org/framework/
  dataSpec: FOCUS
  dataSpecVersion: '1.3'
  dataSpecUrl: https://focus.finops.org/focus-specification/v1-3/
provider: Acuity Brands
providerId: acuity-brands
publisherName: Acuity Brands Lighting, Inc.
serviceCategory: Lighting / Building Controls
created: '2026-05-04'
# Provenance stamped 2026-08-11: this artifact was written by the API Evangelist
# bulk sweep dated 2026-05-04, not harvested from the provider. See roadmap#35.
method: generated
modified: '2026-05-05'
reconciled: false
tags:
  - Lighting
  - B2B
  - Inventory
  - Order Management
  - Building Controls
  - FinOps
  - FOCUS
description: FOCUS-aligned FinOps scaffold for the Acuity Brands distributor API. Acuity Brands invoices
  distributors for product (hardware) — not for API access. The API is bundled into the partner relationship,
  so FinOps relevance is to the consuming distributor's integration economics, not a separately-billed
  Acuity surface.
sources:
  - https://api-docs.acuitybrands.com/
notes: No commercial API line item. Reconciled flag is false because there is no provider invoice that
  separates API from product spend.
billingModel:
  pricingCategory: Bundled With Distributor Agreement
  billingFrequency: Per-Order
  billingCurrency: USD
  chargeCategories:
    - Purchase
focusColumns:
  ServiceName: Acuity Brands API
  ServiceCategory: Lighting / Building Controls
  ProviderName: Acuity Brands
  PublisherName: Acuity Brands Lighting, Inc.
  InvoiceIssuerName: Acuity Brands Lighting, Inc.
  BillingCurrency: USD
  ChargeCategory: Purchase
meters:
  - name: api_request
    description: API request consumed against the distributor's allocation; not directly billed.
    unit: request
    aggregation: sum
    dimensions:
      - endpoint
      - distributor
  - name: product_order
    description: B2B order placed through Acuity's order-entry surface (the underlying business transaction
      that the API supports).
    unit: order
    aggregation: sum
    dimensions:
      - distributor
      - product_family
principles:
  - name: Visibility
    description: There is no Acuity API invoice. Visibility is internal to the distributor — track which
      ERP / e-commerce systems hit the API and at what frequency.
  - name: Allocation
    description: Allocate integration cost (distributor-side compute and engineering) to the function
      it supports — order entry, catalog refresh, inventory checks.
  - name: Optimization
    description: Cache catalog and inventory responses where appropriate, batch order-status polls, and
      avoid duplicate calls across multiple internal systems.
  - name: Accountability
    description: The distributor's IT integration owner is accountable; Acuity Brands acts as a partner
      contact for limit increases.
maintainers:
  - FN: Kin Lane
    email: info@apievangelist.com