VTEX Matched Offers API

The Matched Offers API from VTEX — 3 operation(s) for matched offers.

Operations 3

GET /offer-manager/pvt/offers VTex Get Matched Offers List #
GET /offer-manager/pvt/product/{productId}/sku/{skuId} VTex Get Matched Offer's Data by SKU ID #
GET /offer-manager/pvt/product/{productId} VTex Get Matched Offer's Data by Product ID #

Documentation

📖
Documentation
https://developers.vtex.com/docs/guides/how-the-integration-protocol-between-vtex-and-antifraud-companies-works
📖
Documentation
https://developers.vtex.com/docs/guides/bulk-import-buyer-organizations-spreadsheet
📖
Documentation
https://developers.vtex.com/docs/guides/catalog-api-seller-portal-overview
📖
Documentation
https://developers.vtex.com/docs/guides/catalog-overview
📖
Documentation
https://developers.vtex.com/docs/guides/checkout-overview
📖
Documentation
https://help.vtex.com/en/tutorial/customer-credit-overview--1uIqTjWxIIIEW0COMg4uE0
📖
Documentation
https://help.vtex.com/en/tutorial/data-subject-rights--6imchxTx09icupKMbzHVIM
📖
Documentation
https://developers.vtex.com/docs/api-reference/do-api
📖
Documentation
https://developers.vtex.com/docs/guides/managing-vtex-gift-cards
📖
Documentation
https://developers.vtex.com/docs/guides/gift-card-integration-guide
📖
Documentation
https://developers.vtex.com/docs/guides/faststore/headless-cms-overview
📖
Documentation
https://developers.vtex.com/docs/api-reference/vtex-id-api
📖
Documentation
https://help.vtex.com/en/tracks/vtex-intelligent-search--19wrbB7nEQcmwzDPl1l4Cb/3qgT47zY08biLP3d5os3DG
📖
Documentation
https://developers.vtex.com/docs/apps/vtex.search@1.0.8
📖
Documentation
https://help.vtex.com/en/tracks/cms--2YcpgIljVaLVQYMzxQbc3z/1oN446gRGcR2s70RvBCAmj
📖
Documentation
https://developers.vtex.com/docs/guides/search-overview
📖
Documentation
https://help.vtex.com/en/tutorial/license-manager-resources--3q6ztrC8YynQf6rdc6euk3
📖
Documentation
https://developers.vtex.com/docs/guides/fulfillment
📖
Documentation
https://developers.vtex.com/docs/guides/marketplace-overview
📖
Documentation
https://developers.vtex.com/updates/release-notes/marketplace-protocol-documentation-update
📖
Documentation
https://developers.vtex.com/docs/guides/external-marketplace-integration-guide
📖
Documentation
https://developers.vtex.com/docs/guides/external-seller-integration-connector
📖
Documentation
https://developers.vtex.com/docs/guides/external-seller-integration-guide
📖
Documentation
https://help.vtex.com/en/tutorial/master-data--4otjBnR27u4WUIciQsmkAw
📖
Documentation
https://help.vtex.com/en/tutorial/understanding-the-message-center--tutorials_84
📖
Documentation
https://developers.vtex.com/docs/guides/orders-overview
📖
Documentation
https://developers.vtex.com/docs/guides/changes-in-vtex-features-behavior-to-handle-pii-data
📖
Documentation
https://help.vtex.com/en/tutorial/payment-provider-protocol--RdsT2spdq80MMwwOeEq0m
📖
Documentation
https://developers.vtex.com/docs/guides/payments-integration-guide
📖
Documentation
https://help.vtex.com/en/tutorial/vtex-pick-and-pack-last-mile--HN7WKV0xoq2ssVjsJlfzr
📖
Documentation
https://developers.vtex.com/docs/guides/vtex-io-documentation-policies
📖
Documentation
https://developers.vtex.com/docs/guides/pricing-hub
📖
Documentation
https://developers.vtex.com/docs/guides/pricing-overview
📖
Documentation
https://developers.vtex.com/docs/guides/profile-system
📖
Documentation
https://developers.vtex.com/docs/guides/promotions-overview
📖
Documentation
https://developers.vtex.com/docs/apps/vtex.reviews-and-ratings
📖
Documentation
https://developers.vtex.com/docs/guides/sent-offers-integration-guide-connectors
📖
Documentation
https://developers.vtex.com/docs/guides/sessions-system-overview
📖
Documentation
https://developers.vtex.com/docs/guides/vtex-shipping-network
📖
Documentation
https://help.vtex.com/en/tutorial/sku-bindings--1SmrVgNwjJX17hdqwLa0TX
📖
Documentation
https://developers.vtex.com/docs/guides/subscriptions
📖
Documentation
https://developers.vtex.com/docs/apps/vtex.search/suggestions
📖
Documentation
https://developers.vtex.com/docs/guides/vtex-tracking

Specifications

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/vtex-matched-offers-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

vtex-matched-offers-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: VTex Marketplace Matched Offers API
  description: "The **Marketplace API** enables marketplaces and sellers hosted on VTEX to perform their collaborative operations.  \n\n>⚠️ The marketplace must [create an appKey and appToken](https://developers.vtex.com/docs/guides/getting-started-authentication) for each non-VTEX seller that will use this API.\n\n## Index\n\n### Notification\n\nEndpoints used by sellers to notify marketplaces that the price or inventory language has changed for one of their SKUs.\n\n`POST` [Notify marketplace of price update](https://developers.vtex.com/docs/api-reference/marketplace-apis#post-/notificator/-sellerId-/changenotification/-skuId-/price)\n\n`POST` [Notify marketplace of inventory update](https://developers.vtex.com/docs/api-reference/marketplace-apis#post-/notificator/-sellerId-/changenotification/-skuId-/inventory)\n\n\n### Suggestions\n\n#### Get Suggestions\n\nSearch and filter all suggestions using specific criteria.\n\n`GET` [Get all SKU Suggestions](https://developers.vtex.com/docs/api-reference/marketplace-apis-suggestions#get-/suggestions)\n\n`GET` [Get SKU Suggestion by ID](https://developers.vtex.com/docs/api-reference/marketplace-apis-suggestions#get-/suggestions/-sellerId-/-sellerSkuId-)\n\n\n#### Manage Suggestions\n\nSend or delete SKU suggestions from the seller to marketplace.\n\n`PUT` [Send SKU Suggestion](https://developers.vtex.com/docs/api-reference/marketplace-apis-suggestions#put-/suggestions/-sellerId-/-sellerSkuId-)\n\n`DELETE` [Delete SKU Suggestion](https://developers.vtex.com/docs/api-reference/marketplace-apis-suggestions#delete-/suggestions/-sellerId-/-sellerSkuId-)\n\n\n#### Get Versions\n\nSearch and filter all versions of suggestions, using specific criteria.\n\n`GET` [Get all versions](https://developers.vtex.com/docs/api-reference/marketplace-apis-suggestions#get-/suggestions/-sellerId-/-sellerskuid-/versions)\n\n`GET` [Get version by ID](https://developers.vtex.com/docs/api-reference/marketplace-apis-suggestions#get-/suggestions/-sellerId-/-sellerskuid-/versions/-version-)\n\n\n#### Match Received SKUs\n\nMatch SKU suggestions received in the marketplace.\n\n`PUT` [Match Received SKUs individually](https://developers.vtex.com/docs/api-reference/marketplace-apis-suggestions#put-/suggestions/-sellerId-/-sellerskuid-/versions/-version-/matches/-matchid-)\n\n`PUT` [Match Multiple Received SKUs](https://developers.vtex.com/docs/api-reference/marketplace-apis-suggestions#put-/suggestions/matches/action/-actionName-)\n\n\n#### SKU Approval Settings\n\nAllows marketplaces to configure rules for automatically and manually approving SKUs received from sellers.\n\n`GET`[Get autoApprove Status in Account Settings](https://developers.vtex.com/docs/api-reference/marketplace-apis-suggestions#get-/suggestions/configuration/autoapproval/toggle)  \n\n`PUT`[Activate autoApprove in Marketplace's Account](https://developers.vtex.com/docs/api-reference/marketplace-apis-suggestions#put-/suggestions/configuration/autoapproval/toggle)  \n\n`GET`[Get Account's Approval Settings](https://developers.vtex.com/docs/api-reference/marketplace-apis-suggestions#get-/suggestions/configuration)\n\n`PUT`[Save Account's Approval Settings](https://developers.vtex.com/docs/api-reference/marketplace-apis-suggestions#put-/suggestions/configuration)\n\n`GET`[Get Seller's Approval Settings](https://developers.vtex.com/docs/api-reference/marketplace-apis-suggestions#get-/suggestions/configuration/seller/-sellerId-)\n\n`PUT`[Save Seller's Approval Settings](https://developers.vtex.com/docs/api-reference/marketplace-apis-suggestions#put-/suggestions/configuration/seller/-sellerId-)\n\n`PUT`[Activate autoApprove Setting for a Seller](https://developers.vtex.com/docs/api-reference/marketplace-apis-suggestions#put-/suggestions/configuration/autoapproval/toggle/seller/-sellerId-)   \n\n\n### Matched Offers\n\nOffers are seller products and SKUs that were sent to the marketplace, and already have their price and inventory level configured.\n\n`GET`[Get Matched Offers List](https://developers.vtex.com/docs/api-reference/marketplace-apis#get-/offer-manager/pvt/offers)\n\n`GET`[Get Matched Offer's Data by SKU ID](https://developers.vtex.com/docs/api-reference/marketplace-apis#get-/offer-manager/pvt/product/-productId-/sku/-skuId-)  \n\n`GET`[Get Matched Offer's Data by Product ID](https://developers.vtex.com/docs/api-reference/marketplace-apis#get-/offer-manager/pvt/product/-productId-)\n"
  version: '1.0'
servers:
- url: https://{accountName}.{environment}.com.br/api
  description: VTEX Server URL.
  variables:
    accountName:
      description: Name of the VTEX account. Used as part of the URL.
      default: apiexamples
    environment:
      description: Environment to use. Used as part of the URL.
      enum:
      - vtexcommercestable
      default: vtexcommercestable
security:
- appKey: []
  appToken: []
tags:
- name: Matched Offers
paths:
  /offer-manager/pvt/offers:
    get:
      tags:
      - Matched Offers
      summary: VTex Get Matched Offers List
      description: "Offers are seller's products and SKUs that were sent to the marketplace, and already have their price and inventory level configured. \n\n This endpoint retrieves the available offers in a marketplace. It differs from the Get Suggestions endpoints, since it retrieves products that were already matched by the marketplace, and are currently in its catalog. \n\nIt is possible to filter the search through the following parameters: \n\n- rows \n- sort \n\n- start \n\n- fq\n\n## Permissions\n\nThis endpoint does not require [permissions](https://help.vtex.com/en/tutorial/license-manager-resources--3q6ztrC8YynQf6rdc6euk3).\n\nTo learn more about machine authentication at VTEX, see [Authentication overview](https://developers.vtex.com/docs/guides/authentication-overview#machine-authentication).\n\n>❗ To prevent integrations from having excessive permissions, consider the [best practices for managing app keys](https://help.vtex.com/en/tutorial/best-practices-application-keys--7b6nD1VMHa49aI5brlOvJm) when assigning License Manager roles to integrations."
      operationId: Getofferslist
      parameters:
      - $ref: '#/components/parameters/sort'
      - $ref: '#/components/parameters/rows'
      - $ref: '#/components/parameters/start'
      - $ref: '#/components/parameters/fq'
      - $ref: '#/components/parameters/accountName'
      - $ref: '#/components/parameters/contentType'
      - $ref: '#/components/parameters/environment'
      - $ref: '#/components/parameters/accept'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/responseGetMatchedOffersList'
              example:
              - LastModified: '2021-05-06T21:37:24.262529'
                ProductId: '941947'
                CategoryId: 1563
                BrandId: 2004291
                ProductName: Produto Teste 04 - Preto - 40
                Skus:
                - SkuId: '1070268'
                  EanId: null
                  RefId: null
                  NameComplete: Produto Teste 04 - Preto - 40 Cor:Preto
                  Name: Cor:Preto
                  IsActive: true
                  MainImage:
                    ImageId: '53878805'
                    ImageLabel: null
                    ImageTag: <img src="~/arquivos/ids/53878805-#width#-#height#/image-8b4364782e664d76a6ebc8702008e478.jpg" width="#width#" height="#height#" alt="image-8b4364782e664d76a6ebc8702008e478" id="" />
                    ImagePath: ~/arquivos/ids/53878805-#width#-#height#/image-8b4364782e664d76a6ebc8702008e478.jpg
                    IsMain: true
                    IsZoomSize: true
                    ImageText: image-8b4364782e664d76a6ebc8702008e478
                    LastModified: '2021-04-06T03:01:30.747'
                  Offers:
                  - SellerId: '1'
                    SellerSkuId: '1070268'
                    OffersPerSalesChannel:
                    - SaleChannel: 1
                      Price: 0
                      ListPrice: 0
                      PriceWithoutDiscount: 0
                      AvailableQuantity: 0
                    AvailableSalesChannels: null
                  - SellerId: madesacms
                    SellerSkuId: '3298'
                    OffersPerSalesChannel:
                    - SaleChannel: 0
                      Price: 1200
                      ListPrice: 1200
                      PriceWithoutDiscount: 1200
                      AvailableQuantity: 10000000
                    AvailableSalesChannels: null
      deprecated: false
  /offer-manager/pvt/product/{productId}/sku/{skuId}:
    get:
      tags:
      - Matched Offers
      summary: VTex Get Matched Offer's Data by SKU ID
      description: "Offers are seller products and SKUs that were sent to the marketplace, and already have their price and inventory level configured. \n\nThis endpoint retrieves the available offers for a speciic SKU ID in the marketplace's catalog. It differs from the Get Suggestions endpoints, since it retrieves products that were already matched by the marketplace operator, and are currently active in its catalog. \n\nThe call returns a list of offers for that ID, that contain the following data: \n\n- Seller that sells the SKU \n\n- Correspondent SKU ID \n\n- SKU's price value \n\n- Inventory level \n\n- Sales channel (or [trade policy](https://help.vtex.com/en/tutorial/como-funciona-uma-politica-comercial--6Xef8PZiFm40kg2STrMkMV#master-data)) that it is available at."
      operationId: GetSKUoffers
      parameters:
      - $ref: '#/components/parameters/accountName'
      - $ref: '#/components/parameters/environment'
      - $ref: '#/components/parameters/contentType'
      - $ref: '#/components/parameters/accept'
      - $ref: '#/components/parameters/productId'
      - $ref: '#/components/parameters/skuId'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/responseGetMatchedOffersDataBySKU'
              example:
              - productId: '1561208'
                skuId: '1559161'
                nameComplete: Blusa Cardigan Manga Longa Vestem - Feminina - CINZA G
                mainImage:
                  imagePath: ~/arquivos/ids/8567753-#width#-#height#/image-05b40d3167b5b7ed42285124f6862f12.jpg
                sellersOffers:
                - sellerId: '1'
                  sellerSkuId: '1559161'
                  salesChannelOffer:
                  - salesChannelId: '1'
                    salesChannelName: Principal
                    price: 49.99
                    listPrice: 59.99
                    priceWithoutDiscount: 49.99
                    availableQuantity: 8
                  - salesChannelId: '2'
                    salesChannelName: Online Store
                    price: 47.99
                    listPrice: 59.99
                    priceWithoutDiscount: 47.99
                    availableQuantity: 12
      deprecated: false
  /offer-manager/pvt/product/{productId}:
    get:
      tags:
      - Matched Offers
      summary: VTex Get Matched Offer's Data by Product ID
      description: "Offers are seller products and SKUs that were sent to the marketplace, and already have their price and inventory level configured. \n\nThis endpoint retrieves the available offers for a speciic Product ID in the marketplace's catalog. It differs from the Get Suggestions endpoints, since it retrieves products that were already matched by the marketplace operator, and are currently active in its catalog. \n\nThe call returns a list of offers for that ID, that contain the following data: \n\n- Seller that sells the SKU \n\n- Correspondent SKU ID \n\n- SKU's price value \n\n- Inventory level \n\n- Sales channel (or [trade policy](https://help.vtex.com/en/tutorial/como-funciona-uma-politica-comercial--6Xef8PZiFm40kg2STrMkMV#master-data)) that it is available at.\n\n## Permissions\n\nThis endpoint does not require [permissions](https://help.vtex.com/en/tutorial/license-manager-resources--3q6ztrC8YynQf6rdc6euk3).\n\nTo learn more about machine authentication at VTEX, see [Authentication overview](https://developers.vtex.com/docs/guides/authentication-overview#machine-authentication).\n\n>❗ To prevent integrations from having excessive permissions, consider the [best practices for managing app keys](https://help.vtex.com/en/tutorial/best-practices-application-keys--7b6nD1VMHa49aI5brlOvJm) when assigning License Manager roles to integrations."
      operationId: GetProductoffers
      parameters:
      - $ref: '#/components/parameters/accountName'
      - $ref: '#/components/parameters/environment'
      - $ref: '#/components/parameters/contentType'
      - $ref: '#/components/parameters/accept'
      - $ref: '#/components/parameters/productId'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/responseGetMatchedOffersDataByProductId'
              example:
              - productId: '1561208'
                skuId: '1559161'
                nameComplete: Blusa Cardigan Manga Longa Vestem - Feminina - CINZA G
                mainImage:
                  imagePath: ~/arquivos/ids/8567753-#width#-#height#/image-05b40d3167b5b7ed42285124f6862f12.jpg
                sellersOffers:
                - sellerId: '1'
                  sellerSkuId: '1559161'
                  salesChannelOffer:
                    salesChannelId: '1'
                    salesChannelName: Principal
                    price: 0
                    listPrice: 0
                    priceWithoutDiscount: 0
                    availableQuantity: 0
              - productId: '1561208'
                skuId: '1559163'
                nameComplete: Blusa Cardigan Manga Longa Vestem - Feminina - CINZA PP
                mainImage:
                  imagePath: ~/arquivos/ids/8567753-#width#-#height#/image-05b40d3167b5b7ed42285124f6862f12.jpg
                sellersOffers:
                - sellerId: '1'
                  sellerSkuId: '1559161'
                  salesChannelOffer:
                    salesChannelId: '1'
                    salesChannelName: Principal
                    price: 0
                    listPrice: 0
                    priceWithoutDiscount: 0
                    availableQuantity: 0
      deprecated: false
components:
  parameters:
    contentType:
      name: Content-Type
      in: header
      description: Type of the content being sent.
      required: true
      style: simple
      schema:
        type: string
        default: application/json
    accountName:
      name: accountName
      in: path
      required: true
      description: Name of the VTEX account that belongs to the marketplace. The notification will be posted into this account.
      schema:
        type: string
        example: apiexamples
    fq:
      name: fq
      in: query
      description: "This filter query can be used to filter offers by the criteria described below. It should be filled in by following the format: `fq={{criteriaName}}:{{criteriaValue}}`. \n\n- **productId:** integer of the product ID \n\n- **productName:** string of the product's name \n\n- **skuId:** integer of the SKU ID \n\n- **eanId:** string of the EAN ID \n\n- **refId:** string of the Ref ID \n\n- **categoryId:** integer of the category ID \n\n- **brandId:** integer of the brand ID \n\n- **sellerId:** string of the seller ID \n\n- **sc:** integer of the sales channel's ID (trade policy in VTEX) \n\nEx: skuId:172 \n\nEx: categoryId:13 \n\nEx. productName:Product example-123"
      required: false
      style: form
      explode: true
      schema:
        type: string
        example: skuId:172
    rows:
      name: rows
      in: query
      description: Number of rows included in the response. Each row corresponds to a single offer. The default amount of rows in the response is 1, and the maximum amount is 50. To have more than one offer listed in the response, please add the `rows` parameter with a number greater than 1.
      required: false
      style: form
      explode: true
      schema:
        type: integer
        example: 20
    accept:
      name: Accept
      in: header
      description: HTTP Client Negotiation Accept Header. Indicates the types of responses the client can understand.
      required: true
      style: simple
      schema:
        type: string
        default: application/json
    sort:
      name: sort
      in: query
      description: "Criteria used to sort the list of offers. For sorting values in ascending order, use `asc`, while for descending order, use `desc`. To fill in the field, insert the sorting criteria, followed by 'asc', or 'desc', separated by a comma. You can sort by the following criteria: \n\n- **price:** sorts offers by price. *Ascending* goes from lowest to highest price, while *Descending* goes from highest to lowest price. \n\n- **name:** sorts offers by *productName*, in alphabetical order. *Ascending* goes from *A* to *Z*, while *Descending* goes from *Z* to *A*. \n\n- **availability:** availability in the sales channel (sc). The default value is 1. \n\nEx. sort=availability,desc \n\nEx. sort=name,asc \n\nEx. price,desc"
      required: false
      style: form
      explode: true
      schema:
        type: string
        example: availability,desc
    environment:
      name: environment
      in: path
      required: true
      description: Environment to use. Used as part of the URL.
      schema:
        type: string
        default: vtexcommercestable
    productId:
      name: productId
      in: path
      description: A string that identifies the seller's product. This is the ID that the marketplace will use for all references to this product, such as price and inventory notifications.
      required: true
      style: simple
      schema:
        type: string
        example: '123456'
    skuId:
      name: skuId
      in: path
      description: A string that identifies the seller's SKU that suffered the change. This is the ID that the marketplace will use for all  references to this SKU, such as price and inventory notifications.
      required: true
      style: simple
      schema:
        type: string
        example: '1234'
    start:
      name: start
      in: query
      description: Number corresponding to the row from which the offer list will begin, used for pagination. Filters the list of offers by retrieving the offers starting from the row defined. The default value is 0, if the param is not included in the call.
      required: false
      style: form
      explode: true
      schema:
        type: integer
        default: 0
  schemas:
    OffersPerSalesChannel:
      title: OffersPerSalesChannel
      required:
      - SaleChannel
      - Price
      - ListPrice
      - PriceWithoutDiscount
      - AvailableQuantity
      type: object
      properties:
        SaleChannel:
          type: integer
          description: The sales channel (or [trade policy](https://help.vtex.com/en/tutorial/como-funciona-uma-politica-comercial--6Xef8PZiFm40kg2STrMkMV#master-data)) of the SKU.
          default: 1
        Price:
          type: integer
          description: SKU's price.
          default: 1300
        ListPrice:
          type: integer
          description: SKU's suggested selling price
          default: 1200
        PriceWithoutDiscount:
          type: integer
          description: SKU's price without discount applied.
          default: 1400
        AvailableQuantity:
          type: integer
          description: Available SKU stock quantity
          default: 30
      example:
        SaleChannel: 1
        Price: 0
        ListPrice: 0
        PriceWithoutDiscount: 0
        AvailableQuantity: 0
    responseGetMatchedOffersDataBySKU:
      description: Array of matched offers data by SKU.
      type: array
      items:
        type: object
        description: Schema for individual offer data.
        properties:
          productId:
            type: string
            description: The unique identifier for the product.
            example: '1561208'
          skuId:
            type: string
            description: The unique identifier for the product SKU.
            example: '1559161'
          nameComplete:
            type: string
            description: The complete name of the product.
            example: Blusa Cardigan Manga Longa Vestem - Feminina - CINZA G
          mainImage:
            type: object
            description: Schema for the main product image.
            required:
            - imagePath
            properties:
              imagePath:
                type: string
                description: The file path of the main product image.
                example: ~/arquivos/ids/8567753-#width#-#height#/image-05b40d3167b5b7ed42285124f6862f12.jpg
          sellersOffers:
            type: array
            description: Array of offers from different sellers.
            items:
              type: object
              description: Schema for individual seller offer data.
              properties:
                sellerId:
                  type: string
                  description: The unique identifier for the seller.
                  example: '1'
                sellerSkuId:
                  type: string
                  description: The unique identifier for the seller's SKU.
                  example: '1559161'
                salesChannelOffer:
                  type: array
                  description: Array of offers on different sales channels from the same seller.
                  items:
                    type: object
                    description: Schema for individual sales channel offer data.
                    properties:
                      salesChannelId:
                        type: string
                        description: The unique identifier for the sales channel.
                        example: '1'
                      salesChannelName:
                        type: string
                        description: The name of the sales channel.
                        example: Principal
                      price:
                        type: number
                        description: The offer price.
                        example: 0
                      listPrice:
                        type: number
                        description: The list price of the product.
                        example: 0
                      priceWithoutDiscount:
                        type: number
                        description: The offer price without any discount.
                        example: 0
                      availableQuantity:
                        type: integer
                        description: The available quantity of the product.
                        example: 8
    responseGetMatchedOffersList:
      type: array
      description: Response with the list of offers available on the Marketplace.
      items:
        type: object
        description: Array of SKUs in the offer.
        properties:
          LastModified:
            type: string
            description: Last date the offer was modified.
            example: '2021-05-06T21:37:24.262529'
          ProductId:
            type: string
            description: A string that identifies the seller's product. This is the ID that the marketplace will use for all references to this product.
            example: '941947'
          CategoryId:
            type: integer
            description: Offer's Category ID that the product belongs to, configured in the Catalog. It should be the marketplace's category chosen for the offer to be matched with.
            example: 1563
          BrandId:
            type: integer
            description: Offer's brand ID that the product belongs to, configured in the Catalog. It should be the marketplace's brand chosen for the offer to be matched with.
            example: 2004291
          ProductName:
            type: string
            description: Name of the offer's product.
            example: Name of the Product - 123
          Skus:
            type: array
            items:
              $ref: '#/components/schemas/Sku2'
    Offer:
      title: Offer
      required:
      - SellerId
      - SellerSkuId
      - OffersPerSalesChannel
      - AvailableSalesChannels
      type: object
      properties:
        SellerId:
          type: string
          description: ID of the seller in the marketplace. This ID must be created by the marketplace.
          default: '1'
        SellerSkuId:
          type: string
          description: A string that identifies the SKU in the seller. This is the ID that the marketplace will use for future references to this SKU, such as price and inventory notifications.
          default: '1070268'
        OffersPerSalesChannel:
          type: array
          items:
            $ref: '#/components/schemas/OffersPerSalesChannel'
          description: Each element in the array corresponds to an offer in a specific sales channel.
        AvailableSalesChannels:
          type:
          - string
          - 'null'
          description: The sales channel (or [trade policy](https://help.vtex.com/en/tutorial/como-funciona-uma-politica-comercial--6Xef8PZiFm40kg2STrMkMV#master-data)) ID in which the SKU is available.
          default: '1'
      example:
        SellerId: '1'
        SellerSkuId: '1070268'
        OffersPerSalesChannel:
        - SaleChannel: 1
          Price: 0
          ListPrice: 0
          PriceWithoutDiscount: 0
          AvailableQuantity: 0
        AvailableSalesChannels: null
    responseGetMatchedOffersDataByProductId:
      type: array
      description: Array of matched offers data by product ID.
      items:
        type: object
        description: Schema for individual offer data.
        properties:
          productId:
            type: string
            description: The unique identifier for the product.
            example: '1561208'
          skuId:
            type: string
            description: The unique identifier for the product SKU.
            example: '1559161'
          nameComplete:
            type: string
            description: The complete name of the product.
            example: Blusa Cardigan Manga Longa Vestem - Feminina - CINZA G
          mainImage:
            type: object
            description: Schema for the main product image.
            required:
            - imagePath
            properties:
              imagePath:
                type: string
                description: The file path of the main product image.
                example: ~/arquivos/ids/8567753-#width#-#height#/image-05b40d3167b5b7ed42285124f6862f12.jpg
          sellersOffers:
            type: array
            description: Array of offers from different sellers.
            items:
              type: object
              description: Schema for individual seller offer data.
              properties:
                sellerId:
                  type: string
                  description: The unique identifier for the seller.
                  example: '1'
                sellerSkuId:
                  type: string
                  description: The unique identifier for the seller's SKU.
                  example: '1559161'
                salesChannelOffer:
                  type: object
                  description: Schema for the offer data on a specific sales channel.
                  properties:
                    salesChannelId:
                      type: string
                      description: The unique identifier for the sales channel.
                      example: '1'
                    salesChannelName:
                      type: string
                      description: The name of the sales channel.
                      example: Principal
                    price:
                      type: number
                      description: The offer price.
                      example: 0
                    listPrice:
                      type: number
                      description: The list price of the product.
                      example: 0
                    priceWithoutDiscount:
                      type: number
                      description: The offer price without any discount.
                      example: 0
                    availableQuantity:
                      type: integer
                      description: The available quantity of the product.
                      example: 0
    Sku2:
      title: Sku
      required:
      - SkuId
      - EanId
      - RefId
      - NameComplete
      - Name
      - IsActive
      - MainImage
      - Offers
      type: object
      properties:
        SkuId:
          type: string
          description: SKU's unique identifier number
          default: '1070268'
        EanId:
          type:
          - string
          - 'null'
          description: EAN's unique identifier number
          default: '768655'
        RefId:
          type:
          - string
          - 'null'
          description: SKU's Reference ID
          default: '1234'
        NameComplete:
          type: string
          description: Complete name of the SKU
          default: 'Name of the Product - 123 Color: Black'
        Name:
          type: string
          description: Summarized name of the SKU
          default: 'Color: Black'
        IsActive:
          type: boolean
          description: Whether the SKU is active in the sales channel (true), or not (false).
          default: true
        MainImage:
          type: object
          items:
            $ref: '#/components/schemas/MainImage'
          description: Main image's information.
        Offers:
          type: array
          items:
            $ref: '#/components/schemas/Offer'
          description: Array with offers
      example:
        SkuId: '1070268'
        EanId: null
        RefId: null
        NameComplete: Produto Teste 04 - Preto - 40 Cor:Preto
        Name: Cor:Preto
        IsActive: true
        MainImage:
          ImageId: '53878805'
          ImageLabel: null
          ImageTag: <img src="~/arquivos/ids/53878805-#width#-#height#/image-8b4364782e664d76a6ebc8702008e478.jpg" width="#width#" height="#height#" alt="image-8b4364782e664d76a6ebc8702008e478" id="" />
          ImagePath: ~/arquivos/ids/53878805-#width#-#height#/image-8b4364782e664d76a6ebc8702008e478.jpg
          IsMain: true
          IsZoomSize: true
          ImageText: image-8b4364782e664d76a6ebc8702008e478
          LastModified: '2021-04-06T03:01:30.747'
        Offers:
        - SellerId: '1'
          SellerSkuId: '1070268'
          OffersPerSalesChannel:
          - SaleChannel: 1
            Price: 0
            ListPrice: 0
            PriceWithoutDiscount: 0
            AvailableQuantity: 0
          AvailableSalesChannels: null
        - SellerId: madesacms
          SellerSkuId: '3298'
          OffersPerSalesChannel:
          - SaleChannel: 0
            Price: 1200
            ListPrice: 1200
            PriceWithoutDiscount: 1200
            AvailableQuantity: 10000000
          AvailableSalesChannels: null
    MainImage:
      title: MainImage
      required:
      - ImageId
      - ImageLabel
      - ImageTag
      - ImagePath
      - IsMain
      - IsZoomSize
      - ImageText
      - LastModified
      type: object
      properties:
        ImageId:
          type: string
          description: Code identifying the image's file.
          default: '53878805'
        ImageLabel:
          type:
          - string
          - 'null'
          description: Image's label.
          default: Image 1
        ImageTag:
          type: string
          description: HTML tag for the selected image.
          default: <img src="~/archives/ids/155411-#width#-#height#/Webp.net-resizeimage.jpg" width="#width#" height="#height#" alt="Image name and description" id="" />
        ImagePath:
          type: string
          description: Path for the image's file.
          default: ~/archives/ids/155411-#width#-#height#/Webp.net-resizeimage.jpg
        IsMain:
          type: boolean
          description: Whether the image is the main one or not.
          default: true
        IsZoomSize:
          type: boolean
          description: If zoom can be appl

# --- truncated at 32 KB (33 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/vtex/refs/heads/main/openapi/vtex-matched-offers-api-openapi.yml