Sent Offers
The Marketplace API enables marketplaces and sellers hosted on VTEX to perform their collaborative operations.
The marketplace must create an appKey and appToken for each non-VTEX seller that will use this API.
Index
Notification
Endpoints used by sellers to notify marketplaces that the price or inventory language has changed for one of their SKUs.
POST Notify marketplace of price update
POST Notify marketplace of inventory update
Suggestions
Get Suggestions
Search and filter all suggestions using specific criteria.
Manage Suggestions
Send or delete SKU suggestions from the seller to marketplace.
DELETE Delete SKU Suggestion
Get Versions
Search and filter all versions of suggestions, using specific criteria.
GET Get all versions
Match Received SKUs
Match SKU suggestions received in the marketplace.
PUT Match Received SKUs individually
PUT Match Multiple Received SKUs
SKU Approval Settings
Allows marketplaces to configure rules for automatically and manually approving SKUs received from sellers.
GETGet autoApprove Status in Account Settings
PUTActivate autoApprove in Marketplace's Account
GETGet Account's Approval Settings
PUTSave Account's Approval Settings
GETGet Seller's Approval Settings
PUTSave Seller's Approval Settings
PUTActivate autoApprove Setting for a Seller
Matched Offers
Offers are seller products and SKUs that were sent to the marketplace, and already have their price and inventory level configured.
Endpoints
Offer Management
| Summary | Method | Path |
|---|---|---|
| Create Channel | POST | /api/sent-offers/channels |
| Activate Feed | POST | /api/sent-offers/feeds |
| List Feeds | GET | /api/sent-offers/feeds |
| Update Feed | PUT | /api/sent-offers/feeds/{feedId} |
| Get Feed by feedId | GET | /api/sent-offers/feeds/{feedId} |
| Deactivate Feed | DELETE | /api/sent-offers/feeds/{feedId} |
| Open Interaction | POST | /api/sent-offers/feeds/{feedId}/skus/{skuId}/interactions |
| Get Interaction Data by interactionId | GET | /api/sent-offers/feeds/{feedId}/skus/{skuId}/interactions/{interactionId} |
| Close Interaction | POST | /api/sent-offers/feeds/{feedId}/skus/{skuId}/interactions/{interactionId}/close |
| Create Log | POST | /api/sent-offers/feeds/{feedId}/skus/{skuId}/interactions/{interactionId}/logs |
| Get Log Data by logId | GET | /api/sent-offers/feeds/{feedId}/skus/{skuId}/interactions/{interactionId}/logs/{logId} |
| Search Interactions and their Logs | GET | /api/sent-offers/search/interactions |
| Search Errors | GET | /api/sent-offers/search/errors |
| Get Error Code data by errorCodeId | GET | /api/sent-offers/error-codes/{errorCodeId} |