Nuvemshop Ecommerce API

Name: Nuvemshop Ecommerce API
Brand: Nuvemshop Ecommerce API
Availability: InStock

✓ Official Vendor SpecE CommerceStorefrontbearer29 EndpointsREST

For Agents

Manage products, categories, orders, customers, and webhooks on a Nuvemshop or Tiendanube store with bearer authentication.

Install Jentic One Beta

Connect the Nuvemshop Ecommerce API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Nuvemshop Ecommerce API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Nuvemshop Ecommerce API.

List, create, update, and delete products with variant-level stock and pricing

Bulk-update variant stock and price across many products in a single call

Find a product by variant SKU for warehouse and POS lookups

GET STARTED

Start building with Nuvemshop Ecommerce API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use Nuvemshop Ecommerce API for, with concrete tasks.

★ ERP-to-Storefront Inventory Sync

Keep an ERP or warehouse system in sync with a Nuvemshop storefront by pushing nightly stock and price updates and reading back confirmed orders. The PATCH /products/stock-price endpoint accepts batched variant updates, which avoids the per-product round-trips that otherwise dominate sync runtime. Setup typically takes 1-2 days with a bearer token and the products and orders endpoints.

Read tonight's stock CSV and call PATCH /products/stock-price with an array of variant updates, then log any failures.

Order Fulfilment Pipeline

Stream new orders into a fulfilment system by subscribing to order webhooks, and resolve catalogue details on demand using the products and customers endpoints. This pattern handles label printing, picking lists, and customer notifications without polling, while keeping the order's current state authoritative on the Nuvemshop side.

Subscribe to the 'order/created' webhook, then on each event read the order details and create a shipment record in the WMS.

AI Shopping Assistant

Power a chat-based shopping assistant that lets a customer ask 'do you have black size-medium hoodies in stock?' by searching products and inspecting variant inventory. The product list, single-product retrieve, and SKU lookup endpoints together provide enough surface area to answer availability and price questions with current data.

Call GET /products with a search query for 'black hoodie', filter results to size M with stock greater than zero, and return the top three matches.

Agent-Driven Catalogue Updates

Let an AI agent take instructions like 'mark all variants of SKU SHIRT-RED-M as out of stock and discount 10%' and execute them by chaining the SKU lookup and bulk-update endpoints. Through Jentic, the agent searches by intent and gets only the operations it needs, with credentials handled by the platform.

Search Jentic for 'update Nuvemshop product stock and price', load the operation, and apply a 10% discount to all variants of a given SKU.

Key Endpoints

29 endpoints — the nuvemshop api (also known as tiendanube outside brazil) is the storefront and order-management surface for one of latin america's largest hosted e-commerce platforms.

METHOD

PATH

DESCRIPTION

GET

/products

List all products

POST

/products

Create a new product

PATCH

/products/stock-price

Bulk update stock and price for variants

GET

/products/sku/{sku}

Find product by variant SKU

GET

/orders

Retrieve all orders

GET

/products

List all products

POST

/products

Create a new product

PATCH

/products/stock-price

Bulk update stock and price for variants

GET

/products/sku/{sku}

Find product by variant SKU

GET

/orders

Retrieve all orders

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Nuvemshop bearer tokens and store ids are stored encrypted in the Jentic vault. Agents receive scoped access — the raw token is never exposed to the agent's context.

Intent-based discovery

Agents search Jentic with phrases like 'list Nuvemshop products' or 'create a Nuvemshop webhook'. Jentic returns the matching operation and its input schema so the agent can call the correct endpoint without browsing the OpenAPI spec.

Time to first call

Direct integration: 2-3 days for OAuth install, store-id routing, and webhook handling. Through Jentic: under an hour — search, load, execute.

FAQs

Specific to using Nuvemshop Ecommerce API through Jentic.

What authentication does the Nuvemshop API use?

The API uses bearer-token authentication. After installing your app on a store, you receive an access token that is passed in the Authorization header as 'bearer <token>' on every request, with the store id encoded in the URL path. Through Jentic, the bearer token is held in the encrypted vault and injected at execution time.

Can I bulk update stock and price across many products?

Yes — PATCH /products/stock-price accepts an array of variant updates in a single call, which is the recommended path for nightly catalogue sync from an ERP. Per-product PATCH /products/{id} is also available for finer-grained edits.

What are the rate limits for the Nuvemshop API?

The OpenAPI spec does not embed explicit limits. Nuvemshop's published policy is per-store throttling with HTTP 429 returned on excess; back off and retry. Use the bulk stock-price endpoint to reduce call volume.

How do I subscribe to order events through Jentic?

Run pip install jentic, then search for 'subscribe to a Nuvemshop webhook'. Jentic returns the webhook-creation operation with its input schema; supply the event name (for example 'order/created') and your callback URL. Sign up at https://app.jentic.com/sign-up to get an agent key.

Is the API the same as Tiendanube's API?

Yes — Nuvemshop is the Brazilian brand and Tiendanube is the Spanish-language brand of the same platform. The API spec serves both, with two server URLs (api.nuvemshop.com.br and api.tiendanube.com) sharing identical paths and schemas.

Nuvemshop Ecommerce API

Connect the Nuvemshop Ecommerce API to your agent

Capabilities

Start building with Nuvemshop Ecommerce API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs