This page has moved to nuvemshop.dev/en-US/api/resources/2025-03/CHANGELOG.
CHANGELOG
This changelog reflects changes in the documentation only, not in the API itself.
2026/09/04
RESOURCE:
SECTION:
DESCRIPTION:
- Added the
app_subscription/updatedWebhook, sent when a store's subscription to an app changes. Documented itstopicfield (churn,phoenix,plan_changed), theplanblock, and that it is delivered only to the app the change refers to. - Added the
charge/created,charge/paidandcharge/failedWebhooks, with theapp_idfield and thechargeblock (id,concept_code,from_date,to_date,amount_value,amount_currency). Documented that they are store-level events, so every app in the store subscribed to them receives them, and thatcharge/createddoes not carry thechargeblock. - Cross-referenced both from Billing: the new
app_subscription/updatedevent alongsidesubscription/updated, and a Webhooks section under Charges.
2026/09/02
RESOURCE:
SECTION:
DESCRIPTION:
- Added the
order/in_preparationWebhook, sent when an Order'sshipping_statusbecomesin_preparation. - Clarified that
in_preparationtransitions also trigger the genericorder/updatedWebhook, same as every other shipping status change.
2026/08/27
RESOURCE:
SECTION:
DESCRIPTION:
- Added the optional
IN_PREPARATIONFulfillment Order status to all shipping types. Documented that it is manually assigned, supportsIN_PREPARATION → UNPACKED, and may be skipped when moving forward. - Replaced the three Fulfillment Order status workflow images with color-coded Mermaid diagrams and clarified the allowed forward jumps, backward-transition restrictions,
pickupbehavior controlled byshipping.extras.shippable, and statuses rejected for each shipping type.
2026/08/04
RESOURCE:
SECTION:
DESCRIPTION:
- Added the Price Tables resource to the
2025-03documentation. - Consolidated Price Tables, Categories, Product Variants, and Customers into one resource page without changing endpoint contracts.
- Documented pagination defaults and limits, required fields, parameter purposes, customer-association constraints, and price-rule precedence.
2026/07/29
RESOURCE:
SECTION:
DESCRIPTION:
- Updated the Webhook retry policy: the maximum number of delivery attempts within the 48-hour window is now 16 instead of 18.
2026/07/28
RESOURCE:
SECTION:
DESCRIPTION:
- Documented the optional
tracking_info(codeandurl) andreason(typeandmessage) objects in thefulfillment_order/label_status_updatedwebhook. Each field is included when its corresponding data is available and omitted otherwise.
2026/07/28
RESOURCE:
SECTION:
DESCRIPTION:
- Documented the new
visibilityfield on the Product (valuesvisible,unlistedandhidden) and its relationship with the existingpublishedboolean, which is kept for backward compatibility and stays in sync (visible→published: true;unlisted/hidden→published: false). - Documented the new
unlistedstate: a Product hidden from every storefront discovery surface (search, categories, recommendations, sitemap, sales channel feeds) but reachable and fully purchasable through its direct URL. - Added the
visibilityquery-parameter filter toGET /products(multi-value, e.g.visibility=visible,unlisted) and clarified that the legacypublished=falsefilter now returns bothunlistedandhiddenProducts. - Documented the write contract on
POST /productsandPUT /products/{id}: send eitherpublishedorvisibility(never both, otherwiseHTTP 422). - Added the
visibilityfield to the Kit properties and example response.
2026/07/14
RESOURCE:
SECTION:
DESCRIPTION:
- Updated the "How to set up unlimited/infinite stock?" FAQ to cover stores with the Multiple Locations feature enabled. For these stores, stock must be set to infinite via the variant's
inventory_levelsarray (usingPUT /products/{product_id}/variants/{id}) instead of the top-levelstockfield. Added examples for stores with a single active location, and for setting infinite stock across all or just one specific location usinglocation_id.
2026/07/09
RESOURCE:
SECTION:
DESCRIPTION:
- Synced this version with content that was only published under
unstablebut already applies to every API version: added theby_dc_preparation_days_skippedfield toFulfillmentOrderAggregateDaysBase, recording how many distribution center preparation days were skipped when a shipping option is flagged to ignore DC preparation time (express/same-day). - The Cart Shipping Quotations API remains
unstable-only and was intentionally not added to this version.
2026/07/07
RESOURCE:
SECTION:
- Location Tags For Sales Channels
- Shipping Carrier Properties
- Circuit Breaker for Unstable Shipping Carrier
- Properties
- Labels API
- Labels API Endpoints
- Request to Shipping Carrier: callback_labels_url
- Webhooks
DESCRIPTION:
- Synced this version with content that was only published under
unstablebut already applies to every API version, since the underlying implementation is shared acrossv1,2025-03andunstable:- Added the
tagsfield (Location sale channel tags) to Location, including the new "Location Tags For Sales Channels" section and updated request/response examples. - Added
callback_labels_urlto Shipping Carrier properties, create/update request and response examples, and rewrote the Circuit Breaker section with clearer HTTP status handling and fallback behavior. - Added the
custom_fieldsline item aggregate and theaggregatesquery parameter, and expanded the FulfillmentOrder response schema and examples withrecipient,shipping,destination,status_history,tracking_info,tracking_info_historyandlabels. - Added the entire Labels API section (properties, input types, all Labels API endpoints, the
callback_labels_urlshipping carrier callback contract, and thefulfillment_order/label_status_updatedwebhook).
- Added the
- The
POST /orders/\{order_id\}/fulfillment-orders/\{fulfillment_order_id\}/splitendpoint remainsunstable-only and was intentionally not added to this version.
2026/05/29
RESOURCE:
SECTION:
DESCRIPTION:
- Added
nsufield to Transaction Info: available for Brazilian providers, holds the provider's unique sequential number for a credit/debit card transaction. It can be provided during creation or authorization events of a Transaction.
2026/05/13
RESOURCE:
SECTION:
DESCRIPTION:
- Added
kitfield (withcatalog_kit_idandorder_kit_id) toFulfillmentOrderLineItem, including the rule that both sub-fields must be sent together. - Added
stock_transferfield (withfrom_location_id) toFulfillmentOrderLineItem. - Added
estimated_delivery_timefield toFulfillmentOrderShipping, with the nestedFulfillmentOrderEstimatedDeliveryTime,FulfillmentOrderEstimatedDeliveryTimeBase, andFulfillmentOrderAggregateDaysBasebreakdowns. - Moved
custom_fieldsabovecreated_at/updated_atinFulfillmentOrderLineItem.
2026/05/05
RESOURCE:
SECTION:
DESCRIPTION:
- Added Kit resource documentation with catalog detail endpoint (
GET /kits/{id}), properties, and component structure. Moved from v1.
2026/04/28
RESOURCE:
SECTION:
DESCRIPTION:
- Added
GET /blogsendpoint to retrieve the Blog ID associated with the store.
2026/04/17
RESOURCE:
SECTION:
DESCRIPTION:
- Added new kit-related fields (
catalog_kit_id,order_kit_id,kit) to theproductsarray.
2026/04/15
RESOURCE:
SECTION:
DESCRIPTION:
- Added
visibilityandvisibility_updated_atfields to categories, along with documentation describing visibility rules within the category hierarchy.
2026/04/14
RESOURCE:
SECTION:
DESCRIPTION:
- Added HTTP response handling table with details on how 2xx, 4xx, 5xx, timeout and circuit breaker open states affect fallback behavior.
- Included recommendation to use 4xx for known business errors to ensure fallback shipping options are displayed.
- Documented circuit breaker parameters in a summary table.
- Added cache key composition details showing the MD5 hash structure used for server-side caching.
- Specified cache TTL expiration times for success and error responses.