specification: FinOps Framework
specificationVersion: '1.0'
schema: https://www.finops.org/framework/
provider: Ricoh USA
providerId: ricoh-usa
created: '2026-05-23'
modified: '2026-05-23'
reconciled: false
tags:
  - Printing
  - Document Management
  - 360 Cameras
  - FinOps
  - FOCUS
description: |
  Ricoh USA's developer surfaces split into a one-time hardware-bundled cost (THETA cameras with
  open device APIs) and contract-priced cloud / workflow services (RICOH360 Cloud API and Ricoh
  Smart Integration). Neither track exposes a metered per-call billing feed today, so FinOps
  mapping is structural: device CapEx for THETA, OpEx contract for cloud and MFP workflows.
notes: |
  No public consumption-based pricing or FOCUS billing feed exists for Ricoh USA APIs. Cost
  attribution flows through (1) the hardware purchase line for THETA and (2) the master
  managed-services / cloud agreement for RICOH360 and Smart Integration.
sources:
  - https://www.ricoh360.com/developer/
  - https://docs.ricoh360.com/
  - https://docs-theta-api.ricoh360.com/
  - https://www.ricoh-usa.com/en/services-and-solutions
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/
publisherName: Ricoh USA, Inc.
serviceCategory: Imaging / Document Management
billingModel:
  pricingCategory: Mixed (Hardware CapEx + Contract OpEx)
  billingFrequency: Per-Invoice
  billingCurrency: USD
  chargeCategories:
    - Purchase
    - Subscription
focusColumns:
  ServiceName: Ricoh USA APIs (THETA / RICOH360 / Smart Integration)
  ServiceCategory: Imaging / Document Management
  ProviderName: Ricoh USA
  PublisherName: Ricoh USA, Inc.
  InvoiceIssuerName: Ricoh USA, Inc.
  BillingCurrency: USD
meters:
  - name: theta_device
    description: Per-camera CapEx; unlocks unlimited use of the open THETA device APIs (Web / BLE / USB).
    unit: device
    aggregation: count
    dimensions:
      - model
      - serialNumber
  - name: ricoh360_cloud_contract
    description: Annual contract for RICOH360 Cloud API access; not metered per call publicly.
    unit: contract
    aggregation: count
    dimensions:
      - account
  - name: smart_integration_contract
    description: Bundled MFP workflow license; tied to managed-services agreement.
    unit: contract
    aggregation: count
    dimensions:
      - account
principles:
  - name: Visibility
    description: Track THETA hardware as CapEx in the field-team or imaging cost center; track RICOH360 Cloud and Smart Integration as OpEx under the master Ricoh agreement.
  - name: Allocation
    description: Allocate THETA device costs to the business unit that operates the cameras (construction, real estate, insurance); allocate cloud / MFP contracts to the IT or workplace-services owner.
  - name: Optimization
    description: For THETA Web API, prefer batch operations (single startCapture / listFiles / delete cycles) over per-frame polling. For RICOH360 Cloud, consolidate ingestion windows to fit contract volume bands.
  - name: Accountability
    description: Operational team owns camera hardware fleet; IT / facilities owns the Ricoh master contract that covers cloud and MFP workflows. Review utilization at managed-services renewal.
maintainers:
  - FN: Kin Lane
    email: kin@apievangelist.com