vtex.local – Promotions-
Check the new . We created this guide to improve the onboarding experience for developers at VTEX. It assembles all documentation on our Developer Portal about Promotions and is organized by focusing on the developer's journey.
The Promotions & Taxes API allows you to manage and retrieve all promotions, coupons and tax rules from your VTEX store.
Index
Coupons
POST
POST
GET
GET
POST
POST
GET
POST
GET
POST
Promotions and Taxes
GET
GET
GET
POST
POST
PUT
POST
POST
GET
GET
Campaign Audiences
GET
POST
- Homepage
- https://api.apis.guru/v2/specs/vtex.local:Promotions-/1.0.json
- Provider
- vtex.local:Promotions- / Promotions-
- OpenAPI version
- 3.0.0
- Spec (JSON)
- https://api.apis.guru/v2/specs/vtex.local/Promotions-/1.0/openapi.json
- Spec (YAML)
- https://api.apis.guru/v2/specs/vtex.local/Promotions-/1.0/openapi.yaml
Tools (33)
Extracted live via the executor SDK.
-
bundles.calculatediscountsandtaxesBundlesCalculate discounts and taxes
-
campaignAudiences.getcampaignaudiencesRetrieves a list of all campaign audiences and their respective configurations.
-
campaignAudiences.getcampaignconfigurationRetrieves a specific campaign audience configuration by its ID. This API uses the campaign ID, not the campaign name.
-
campaignAudiences.setcampaignconfigurationCreates a new campaign audience.
-
coupons.archivebycouponcodeArchives a specifc coupon by its coupon code.
-
coupons.getallCheck the new . We created this guide to improve the onboarding experience for developers at VTEX. It assembles all documentation on our Developer Portal about Promotions and is organized by focusing on the developer's journey.
Retrieves all coupons from an account.
-
coupons.getarchivedbycouponcodeRetrieves a specific archived coupon by its coupon code.
-
coupons.getbycouponcodeRetrieves a specific coupon by its coupon code.
-
coupons.getusageRetrieves information about the coupon usage.
-
coupons.massiveGenerationGenerates a massive amount of coupons
-
coupons.postApiRnbPvtCouponCreates a single new coupon.
-
coupons.postApiRnbPvtMultipleCouponsCreates multiple coupons with different coupon codes. This endpoint has a throttling of 60 requests per minute.
-
coupons.unarchivebycouponcodeUnarchives a specifc coupon by its coupon code.
-
coupons.updateUpdates information of a specific coupon.
-
notifications.usagenotificationUsage notification
-
pricesLegacyV1.deletebyskuIdDelete all prices from an SKU.
If your account is using Pricing v2, you should avoid using these routes. Please refer directly to the
If you are still using Pricing v1, please
-
pricesLegacyV1.getallpagedGet all paged prices.
If your account is using Pricing v2, you should avoid using these routes. Please refer directly to the
If you are still using Pricing v1, please
-
pricesLegacyV1.pricebycontextGet price by context.
If your account is using Pricing v2, you should avoid using these routes. Please refer directly to the
If you are still using Pricing v1, please
-
pricesLegacyV1.pricebyskuIdPrice by SKU ID
If your account is using Pricing v2, you should avoid using these routes. Please refer directly to the
-
pricesLegacyV1.pricebyskuIdandtradePolicyRetrieve price by SKU ID and Trade Policy.
If your account is using Pricing v2, you should avoid using these routes. Please refer directly to the
If you are still using Pricing v1, please
-
pricesLegacyV1.savepriceSave price.
If your account is using Pricing v2, you should avoid using these routes. Please refer directly to the
If you are still using Pricing v1, please
-
promotionsAndTaxes.archivePromotionArchives a Promotion or Tax by its ID.
-
promotionsAndTaxes.createOrUpdateCalculatorConfigurationCreates or updates a specific Promotion by its Promotion ID or a specific Tax by its Tax ID.
-
promotionsAndTaxes.getAllBenefitsRetrieves all promotions from an account.
📘 Onboarding guide
Check the new . We created this guide to improve the onboarding experience for developers at VTEX. It assembles all documentation on our Developer Portal about the Promotions and is organized by focusing on the developer's journey.
-
promotionsAndTaxes.getAllTaxesRetrieves all taxes from an account.
-
promotionsAndTaxes.getArchivedPromotionsLists all archived promotions.
-
promotionsAndTaxes.getArchivedTaxesLists all archived taxes.
-
promotionsAndTaxes.getCalculatorConfigurationByIdRetrieves a specific promotion by its Promotion ID or a specific tax by its Tax ID.
-
promotionsAndTaxes.postApiRnbPvtImportCalculatorConfigurationCreates a Multiple SKU Promotion. This scenario allows to create a single promotion for multiples SKUs with the Percentage Effect.
⚠️
The limit of SKUs on a Multiple Effects promotion is 400.
-
promotionsAndTaxes.putApiRnbPvtImportCalculatorConfigurationPromotionIdUpdates information from a Multiple SKU Promotion. This scenario allows to create a single promotion for multiples SKUs with the Percentage Effect.
⚠️
The limit of SKUs on a Multiple Effects promotion is 400.
-
promotionsAndTaxes.unarchivePromotionUnarchives a Promotion or Tax by its ID.
-
openapi.previewSpecPreview an OpenAPI document before adding it as a source
-
openapi.addSourceAdd an OpenAPI source and register its operations as tools