specification: FinOps Framework
specificationVersion: '1.0'
schema: https://www.finops.org/framework/
provider: Nuvemshop / Tiendanube
providerId: nuvemshop
created: '2026-07-12'
modified: '2026-07-12'
reconciled: false
tags:
- E-commerce
- Latin America
- SaaS
- FinOps
- Cost Management
- FOCUS
description: >-
  FinOps view of Nuvemshop / Tiendanube spend. There are two distinct cost
  perspectives. (1) MERCHANT side: a store pays a monthly SaaS subscription
  (varying by country and plan tier) plus a per-sale fee on non-native payment
  methods (reduced or waived when using the native Nuvem Pago gateway); the
  Admin API is included in the subscription and is not separately metered by
  call volume. (2) APP DEVELOPER / PARTNER side: building on and calling the API
  is free; developers monetize apps through the App Store and Nuvemshop takes a
  revenue share on app charges, billed through the platform's billing system.
  Exact subscription prices, per-sale percentages by market, and revenue-share
  rates are NOT reconciled in this artifact.
notes: >-
  This is a SaaS + marketplace-revenue-share model, not a usage-metered API. No
  per-API-call charge exists. Subscription amounts and revenue-share
  percentages change and differ by country (BR/AR/MX/CL/CO); verify on the
  provider pricing and Partner pages during reconciliation.
sources:
- https://www.nuvemshop.com.br/planos-e-precos
- https://tiendanube.github.io/api-documentation/intro
- https://github.com/TiendaNube
- https://focus.finops.org/focus-specification/v1-3/
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: Nuvemshop / Tiendanube
serviceCategory: E-commerce Platform (SaaS)
billingModel:
  pricingCategory: Subscription-Based
  billingFrequency: Monthly
  billingCurrency: BRL
  chargeCategories:
  - Purchase
  - Usage
  - Adjustment
focusColumns:
  ServiceName: Nuvemshop / Tiendanube
  ServiceCategory: E-commerce Platform (SaaS)
  ProviderName: Nuvemshop / Tiendanube
  PublisherName: Nuvemshop / Tiendanube
  InvoiceIssuerName: Nuvemshop / Tiendanube
  BillingCurrency: BRL
  ChargeCategory: Purchase
  PricingCategory: Subscription-Based
meters:
- name: store_subscription
  description: Monthly per-store SaaS subscription, varying by plan tier and country.
  unit: months
  aggregation: sum
  dimensions:
  - store
  - plan
  - country
- name: per_sale_fee
  description: Percentage-of-sale fee charged on non-native payment methods (reduced/waived with Nuvem Pago); varies by plan.
  unit: gmv_percentage
  aggregation: sum
  dimensions:
  - store
  - plan
  - payment_method
- name: app_revenue_share
  description: Revenue share Nuvemshop takes on App Store app charges (developer/partner side).
  unit: revenue_share
  aggregation: sum
  dimensions:
  - app
  - partner
- name: api_calls
  description: Admin API calls - NOT billed; included with the store subscription and only rate limited per store.
  unit: requests
  aggregation: sum
  dimensions:
  - store
  - app
principles:
- name: Visibility
  description: Track each store's plan subscription and per-sale fees; for app developers, track App Store revenue net of Nuvemshop's revenue share. API calls are free but rate limited, so monitor 429s rather than cost.
- name: Allocation
  description: Map subscriptions and per-sale fees to the owning store/brand; map app revenue share to the specific app and partner account.
- name: Optimization
  description: Use the native Nuvem Pago gateway to cut or waive per-sale fees; pick the plan tier whose per-sale fee and features match store GMV; batch and pace API calls to stay within the per-store leaky bucket instead of paying for higher tiers solely for rate limits.
- name: Accountability
  description: Assign an owner per store subscription and per published app; review plan fit and revenue share monthly against sales volume.
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com