Estamos aprimorando sua experiência com a documentação. Em 1º de setembro de 2025, toda a documentação estará disponível em nosso site aprimorado da API do parceiro de vendas. Para garantir acesso contínuo aos nossos recursos, você será redirecionado automaticamente para o novo site. Recomendamos atualizar seus favoritos para o novo site para melhor experiência.
Estamos mejorando tu experiencia con la documentación. El 1 de septiembre de 2025, toda la documentación estará disponible en nuestro sitio web mejorado de la API del colaborador comercial. Para garantizar un acceso sin interrupciones a nuestros recursos, se te redirigirá automáticamente al nuevo sitio. Te recomendamos que actualices tus marcadores a la nueva ubicación para disfrutar de la mejor experiencia.

Schema de mensagem de feed de listas V2

O schema JSON de mensagem de feed de listas para a API de feeds de parceiros de vendas.

{
  "$schema":"http://json-schema.org/draft-07/schema#",
  "$comment":"JSON Schema describing the document format for JSON Selling Partner Listings Message (v2).",
  "title":"Selling Partner Listings Message (v2)",
  "properties":{
    "messageId":{
      "title":"Message Identifier",
      "description":"Identifier for the message that is unique within this feed submission. Response messages are correlated to this identifier.",
      "examples":[
        1
      ],
      "type":"integer",
      "minimum":1,
      "maximum": 2147483647
    },
    "sku":{
      "title":"SKU (Stock Keeping Unit)",
      "description":"Selling Partner SKU (stock keeping unit) identifier for the listing. SKU uniquely identifies a listing for a Selling Partner.",
      "examples":[
        "ABC123"
      ],
      "minLength":1,
      "type":"string"
    },
    "operationType":{
      "title":"Operation Type",
      "description":"Type of operation to perform for the listings data submission in this message. \"UPDATE\" indicates the full set of item attributes are provided and any existing attributes data will be replaced with the provided attributes. \"PARTIAL_UPDATE\" indicates only the provided item attributes will be updated with the provided attribute data. \"PATCH\" indicates the provided JSON Patch operations will be used to update the applicable attributes. \"DELETE\" indicates the listings item will be deleted.",
      "enum":[
        "UPDATE",
        "PARTIAL_UPDATE",
        "PATCH",
        "DELETE"
      ],
      "type":"string"
    },
    "productType":{
      "title":"Amazon Product Type",
      "description":"Amazon product type of the listings data submission in this message.",
      "examples":[
        "LUGGAGE",
        "SHOES"
      ],
      "minLength":1,
      "type":"string"
    },
    "requirements":{
      "title":"Requirements",
      "description":"Name of the requirements type for the listings data submission in this message. \"LISTING\" indicates requirements inclusive of product facts and sales terms. \"LISTING_PRODUCT_ONLY\" indicates requirements inclusive of product facts only. \"LISTING_OFFER_ONLY\" indicates requirements inclusive of sales terms only.",
      "default":"LISTING",
      "enum":[
        "LISTING",
        "LISTING_PRODUCT_ONLY",
        "LISTING_OFFER_ONLY"
      ],
      "type":"string"
    },
    "attributes":{
      "title":"Listings Item Attributes",
      "description":"Attributes data for the listings data submission.",
      "additionalProperties":true,
      "minProperties":1,
      "type":"object"
    },
    "patches":{
      "title":"Listings Item JSON Patch Operations",
      "description":"Attributes data in the form of JSON Patch operations to update or delete.",
      "minItems":1,
      "items":{
        "description":"Individual JSON Patch operation.",
        "properties":{
          "op":{
            "description":"Type of JSON Patch operation. Supported JSON Patch operations include add, replace, and delete. See https://tools.ietf.org/html/rfc6902.",
            "example":"replace",
            "enum":[
              "add",
              "replace",
              "delete"
            ],
            "type":"string"
          },
          "path":{
            "description":"JSON Pointer path of the attribute to patch. See https://tools.ietf.org/html/rfc6902.",
            "example":"/attributes/fulfillment_availability",
            "type":"string"
          },
          "value":{
            "description":"JSON value to add, replace, or delete.",
            "example":[
              {
                "fulfillment_channel_code":"DEFAULT",
                "quantity":10
              }
            ],
            "type":"array",
            "items":{
              "type":"object",
              "additionalProperties":true
            }
          }
        },
        "required":[
          "op",
          "path"
        ],
        "type":"object"
      },
      "type":"array"
    }
  },
  "required":[
    "messageId",
    "sku",
    "operationType"
  ],
  "oneOf":[
    {
      "$comment":"\"UPDATE\" operations require a \"productType\" and \"attributes\"; \"patches\" are not applicable to \"UPDATE\" operations.",
      "properties":{
        "operationType":{
          "const":"UPDATE",
          "type":"string"
        },
        "patches":false
      },
      "required":[
        "productType",
        "attributes"
      ]
    },
    {
      "$comment":"\"requirements\", \"attributes\", \"productType\", and \"patches\" are not applicable to \"DELETE\" operations.",
      "properties":{
        "operationType":{
          "const":"DELETE",
          "type":"string"
        },
        "requirements":false,
        "attributes":false,
        "productType":false,
        "patches":false
      }
    },
    {
      "$comment":"\"PARTIAL_UPDATE\" operations require a \"productType\" and \"attributes\"; \"requirements\" and \"patches\" are not applicable to \"PARTIAL_UPDATE\" operations.",
      "properties":{
        "operationType":{
          "const":"PARTIAL_UPDATE",
          "type":"string"
        },
        "requirements":false,
        "patches":false
      },
      "required":[
        "productType",
        "attributes"
      ]
    },
    {
      "$comment":"\"PATCH\" operations require a \"productType\" and \"patches\"; \"requirements\" and \"attributes\" are not applicable to \"PATCH\" operations.",
      "properties":{
        "operationType":{
          "const":"PATCH",
          "type":"string"
        },
        "requirements":false,
        "attributes":false
      },
      "required":[
        "productType",
        "patches"
      ]
    }
  ],
  "type":"object"
}