---
name: promotions-taxes-api
description: "Promotions & Taxes API skill. Use when working with Promotions & Taxes for api, price-sheet, pub. Covers 31 endpoints."
version: 1.0.0
generator: lapsh
---

# Promotions & Taxes API
API version: 1.0

## Auth
ApiKey X-VTEX-API-AppKey in header | ApiKey X-VTEX-API-AppToken in header | ApiKey VtexIdclientAutCookie in header

## Base URL
https://apiexamples.vtexcommercestable.com.br

## Setup
1. Set your API key in the appropriate header
2. GET /api/rnb/pvt/coupon -- verify access
3. POST /api/rnb/pvt/multiple-coupons -- create first multiple-coupons

## Endpoints

31 endpoints across 3 groups. See references/api-spec.lap for full details.

### api
| Method | Path | Description |
|--------|------|-------------|
| POST | /api/rnb/pvt/multiple-coupons | Create multiple coupons |
| POST | /api/rnb/pvt/coupon | Create or update coupon |
| GET | /api/rnb/pvt/coupon | Get all coupons |
| GET | /api/rnb/pvt/coupon/{couponCode} | Get coupon by coupon code |
| GET | /api/rnb/pvt/archive/coupon/{couponCode} | Get archived coupon by coupon code |
| POST | /api/rnb/pvt/archive/coupon/{couponCode} | Archive coupon by coupon code |
| POST | /api/rnb/pvt/coupons | Generate coupons in bulk |
| GET | /api/rnb/pvt/coupon/usage/{couponCode} | Get coupon usage |
| POST | /api/rnb/pvt/unarchive/coupon/{couponCode} | Unarchive coupon by coupon code |
| GET | /api/rnb/pvt/benefits/calculatorconfiguration | Get all promotions |
| GET | /api/rnb/pvt/benefits/calculatorconfiguration/search | Search promotion by name |
| GET | /api/rnb/pvt/taxes/calculatorconfiguration | Get all taxes |
| GET | /api/rnb/pvt/calculatorconfiguration/{idCalculatorConfiguration} | Get promotion or tax by ID |
| POST | /api/rnb/pvt/calculatorconfiguration/{promotionId}/seller-opt | Seller opt-in or opt-out |
| POST | /api/rnb/pvt/calculatorconfiguration | Create or update promotion or tax |
| POST | /api/rnb/pvt/import/calculatorConfiguration | Create multiple SKU promotion |
| PUT | /api/rnb/pvt/import/calculatorConfiguration/{promotionId} | Update multiple SKU promotion |
| POST | /api/rnb/pvt/archive/calculatorConfiguration/{idCalculatorConfiguration} | Archive promotion or tax |
| POST | /api/rnb/pvt/unarchive/calculatorConfiguration/{idCalculatorConfiguration} | Unarchive promotion or tax |
| GET | /api/rnb/pvt/archive/benefits/calculatorConfiguration | List archived promotions |
| GET | /api/rnb/pvt/archive/taxes/calculatorConfiguration | List archived taxes |
| GET | /api/rnb/pvt/campaignConfiguration/{campaignId} | Get campaign audience configuration |
| GET | /api/rnb/pvt/campaignConfiguration | Get all campaign audiences |
| POST | /api/rnb/pvt/campaignConfiguration | Create campaign audience |

### price-sheet
| Method | Path | Description |
|--------|------|-------------|
| GET | /price-sheet/{skuId} | Get price by SKU ID |
| DELETE | /price-sheet/{skuId} | Delete price by SKU ID |
| GET | /price-sheet/all/{page}/{pageSize} | Get all paged prices |
| POST | /price-sheet/context | Get price by context |
| GET | /price-sheet/{skuId}/{tradePolicy} | Get price by SKU ID and trade policy |
| POST | /price-sheet | Save price |

### pub
| Method | Path | Description |
|--------|------|-------------|
| POST | /pub/bundles | Calculate discounts and taxes bundles |

## Common Questions

Match user requests to endpoints in references/api-spec.lap. Key patterns:
- "Create a multiple-coupon?" -> POST /api/rnb/pvt/multiple-coupons
- "Create a coupon?" -> POST /api/rnb/pvt/coupon
- "List all coupon?" -> GET /api/rnb/pvt/coupon
- "Get coupon details?" -> GET /api/rnb/pvt/coupon/{couponCode}
- "Get coupon details?" -> GET /api/rnb/pvt/archive/coupon/{couponCode}
- "Create a coupon?" -> POST /api/rnb/pvt/coupons
- "Get usage details?" -> GET /api/rnb/pvt/coupon/usage/{couponCode}
- "List all calculatorconfiguration?" -> GET /api/rnb/pvt/benefits/calculatorconfiguration
- "List all search?" -> GET /api/rnb/pvt/benefits/calculatorconfiguration/search
- "List all calculatorconfiguration?" -> GET /api/rnb/pvt/taxes/calculatorconfiguration
- "Get calculatorconfiguration details?" -> GET /api/rnb/pvt/calculatorconfiguration/{idCalculatorConfiguration}
- "Create a seller-opt?" -> POST /api/rnb/pvt/calculatorconfiguration/{promotionId}/seller-opt
- "Create a calculatorconfiguration?" -> POST /api/rnb/pvt/calculatorconfiguration
- "Create a calculatorConfiguration?" -> POST /api/rnb/pvt/import/calculatorConfiguration
- "Update a calculatorConfiguration?" -> PUT /api/rnb/pvt/import/calculatorConfiguration/{promotionId}
- "List all calculatorConfiguration?" -> GET /api/rnb/pvt/archive/benefits/calculatorConfiguration
- "List all calculatorConfiguration?" -> GET /api/rnb/pvt/archive/taxes/calculatorConfiguration
- "Get price-sheet details?" -> GET /price-sheet/{skuId}
- "Delete a price-sheet?" -> DELETE /price-sheet/{skuId}
- "Get all details?" -> GET /price-sheet/all/{page}/{pageSize}
- "Create a context?" -> POST /price-sheet/context
- "Get price-sheet details?" -> GET /price-sheet/{skuId}/{tradePolicy}
- "Create a price-sheet?" -> POST /price-sheet
- "Create a bundle?" -> POST /pub/bundles
- "Get campaignConfiguration details?" -> GET /api/rnb/pvt/campaignConfiguration/{campaignId}
- "List all campaignConfiguration?" -> GET /api/rnb/pvt/campaignConfiguration
- "Create a campaignConfiguration?" -> POST /api/rnb/pvt/campaignConfiguration
- "How to authenticate?" -> See Auth section

## Response Tips
- Check response schemas in references/api-spec.lap for field details
- List endpoints may support pagination; check for limit, offset, or cursor params
- Create/update endpoints typically return the created/updated object

## CLI

```bash
# Update this spec to the latest version
npx @lap-platform/lapsh get promotions-taxes-api -o references/api-spec.lap

# Search for related APIs
npx @lap-platform/lapsh search promotions-taxes-api
```

## References
- Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas

> Generated from the official API spec by [LAP](https://lap.sh)