Migración de Listings Management Workflows(Flujos de trabajo de gestión de listados)

En esta guía se explica cómo migrar los listados de gestión de flujos de trabajo de XML y archivos planos listados de los envíos a los Listados de Artículos y API JSON_LISTINGS_FEED. Esto es necesario para prepararse para la amortización de legado tipos de feed.

Revise la Guía para la construcción de flujos de trabajo para la gestión de listados antes de esta guía de migración..

Beneficios

Las orientaciones que se ofrecen a continuación se describen las siguientes ventajas para los sellers y vendors:

• Lleno de los requisitos de datos en esquemas de producto
• Disponibilidad de pre-presentación de las reglas de validación
• Sincronización y asincrónica mecanismos de retroalimentación
• Hasta la fecha, tipo de producto requisitos de datos que asegurarse de que está utilizando la última versión, a diferencia de XMLs
• La uniformidad en los esquemas a través de los requisitos de datos, a diferencia de XML en el pasado que condujo a errores de los desarrolladores de cargar múltiples categorías
• Reduce el esfuerzo necesario para mapa de archivo plano o XML atributos a los Listados de las Api y los JSON_LISTINGS_FEED.
• La reducción de humanos/manual de errores de entrada que conduce a errores de envío y abandonado selecciones
• Facilitar la gestión de grandes catálogos y envío de todos los modelos sin subir restricciones

Versiones de API

Esta guía de referencias de las operaciones en la siguiente Venta de Socio de la API de secciones. Para obtener información más detallada acerca de la creación de flujos de trabajo con estas secciones, consulte la Guía para la construcción de flujos de trabajo para la gestión de listados. Para obtener información más detallada sobre cada una de las API de secciones, siga los enlaces de referencia.

tipos de feed

Esta guía de referencias de los siguientes tipos de feeds utilizados con los Feeds API. Para obtener información más detallada acerca de los tipos de feeds, vea Valores de tipo de Feed.

Terminología

• JSON Esquema: JSON es el formato de serialización utilizado por las APIs, notificaciones y alimentan a los formatos que se describen en esta guía. JSON Schema es un vocabulario para anotar, describir y validar el contenido JSON y es utilizado por las Definiciones del Tipo de Producto API para describir el modelo de datos para Artículos del Catálogo y Listas de Elementos. Consulte http://json-schema.org/learn/ para obtener más detalles acerca de JSON Esquema.
• JSON_LISTINGS_FEED: El JSON_LISTINGS_FEED es un bulto formato de fuente contractual compatible con Listings Items API y es intercambiable con los Listados individuales Elementos de la API de operaciones.
• Esquema XML (XSD): XML es el formato de serialización utilizado por algunos de los listados de los tipos de feeds (por ejemplo, POST_PRODUCT_DATA). Esquema XML (XSD) es la especificación para describir y validar el contenido XML. Consulte https://www.w3.org/XML/Schema para obtener más detalles acerca de Esquema XML (XSD).
• Categoría Xsd: Categoría Xsd definir la categoría específica de modelado de datos de POST_PRODUCT_DATA XML feed presentaciones.
• Listados de Artículo: Representa un elemento (es decir, una lista) en la venta de un compañero de catálogo que se identifica por una venta de socio-siempre SKU (Stock Keeping Unit) y representa el producto de los hechos y los términos de venta de un artículo vendido o cumplido por parte de Amazon.
• Variación de la Familia: Una variación de la familia es una colección de artículos similares que varían en color, tamaño, o de otros atributos utilizados para proporcionar una sola página de detalles de la experiencia para los compradores en Amazon. Por ejemplo, un artículo de ropa puede venir en varios colores, varios tamaños y varios estilos. Cada combinación única de color, el tamaño, y el estilo es representado por un elemento independiente en la variación de la familia.
• FBA: (Cumplido por parte de Amazon) los Artículos que se venden en Amazon son cumplidas por Amazon.
• NMF: (Comerciante Cumplimiento de Red) los Artículos que se venden en Amazon cumplido por el vendedor.

Estrategias de migración

Los pasos necesarios para migrar los listados de flujo de trabajo son únicos para su caso de uso y las necesidades del negocio. Esta sección describe las consideraciones adicionales que pueden ayudar en la definición de una estrategia de migración que es mínimamente impactante y toma ventaja de las nuevas características de forma iterativa.

La asignación de los atributos del producto de la categoría archivos Xsd (XML) y el archivo de plano de tipos de feed

Elementos de datos en los Listings Items API y JSON_LISTINGS_FEED están estructurados y, en algunos casos, se denominan de manera diferente de cómo los elementos de datos están estructurados y nombrado en XML y archivos planos tipos de feed. La actualización de los elementos de datos de una manera más directa representación de los modelos de datos de Amazon catálogo, ampliando el apoyo para las características que no estaban disponibles anteriormente con el legado de los tipos de feeds y la habilitación de la coherencia con los requisitos más recientes del catálogo de Amazon. La asignación de elementos de datos para el inventario, la fijación de precios, las imágenes, los gastos de envío, y la variación de las relaciones se describen en esta guía en las siguientes secciones. Sin embargo, para los datos del producto (por ejemplo: los nombres de los elementos, puntos de bala, y otros atributos relevantes), hay miles de asignaciones del legado de XML y archivos planos tipos de feed. Para ayudar en la migración de los atributos del producto, los siguientes archivos proporcionan las asignaciones de los datos del producto, elementos del legado de XML y archivos planos tipos de feed a los correspondientes elementos de datos en los Listings Items API y JSON_LISTINGS_FEED.

• Producto XML (Categoría XSD) Asignaciones: https://m.media-amazon.com/images/G/01/VSSC/XPath-To-JSON-mappings.xlsx
• Producto Plano de Asignaciones de Archivo: https://m.media-amazon.com/images/G/01/VSSC/FlatFile-To-JSON-Mapping.xlsx

Las asignaciones en estos archivos están limitados a producto-atributos relacionados (es decir, no incluir el inventario o los precios) y no incluyen el tipo de producto o marketplace específico de la relevancia de cada uno. Las Definiciones del Tipo de Producto API proporciona JSON Esquemas que representan la aplicable atributos y restricciones por tipo de producto y marketplace. El uso de los archivos de asignación en conjunción con el JSON Esquemas te permitirá actualizar tu asignaciones de datos, identificar que las asignaciones son relevantes para cada tipo de producto y de marketplace, identificar los elementos de datos que ya no es relevante, e identificar nuevos elementos de datos relevantes.

Iterativo de flujo de trabajo de migraciones

Listados de gestión de flujos de trabajo son a menudo una combinación compleja de casos de uso y la lógica de negocio único para cada venta de socio que se construyen en torno a las capacidades específicas de los listados individuales de herramientas (por ejemplo, la Categoría archivos Xsd). Con los anteriores XML feed presentaciones, los listados de los flujos de trabajo se vieron obligados a manejar los productos, precios, inventarios, y otros datos por separado, ya sea o no que el patrón de ajuste el caso de uso y la lógica de negocios para la persona que vende los socios. Con Listings Items API y JSON_LISTINGS_FEED, este tipo de patrón de flujo de trabajo es apoyado mientras que proporciona la flexibilidad necesaria para crear flujos de trabajo que más se asemejan a la de casos de uso y la lógica de negocios para la persona que vende los socios.

La flexibilidad proporcionada por Listings Items API y JSON_LISTINGS_FEED permite un enfoque iterativo para la migración de las porciones de los listados de gestión de flujos de trabajo sin tener que migrar todo a la vez. Tomando un enfoque por fases permite a refactorizar, prueba, repetir, y migrar porciones más pequeñas de su flujo de trabajo, disminuir el impacto que estos cambios tienen en su negocio, flujos de trabajo en cada etapa de su migración. A continuación se sugieren aspectos a considerar cuando se acerca a la migración de una manera iterativa.

Tipos de datos

Creación y gestión de los datos del producto en los listados de los flujos de trabajo es complejo debido a que el modelo de datos y las restricciones varían entre los marketplaces y los tipos de producto. Para la mayoría de los casos de uso, actualización de inventarios, los precios y las imágenes son la forma menos compleja.

Iterativa enfoque de la migración de los listados de los flujos de trabajo, romper la migración de tipo de datos (por ejemplo, inventarios, precios, imágenes). Esto permite iniciar con el menos complejo de los elementos de datos y dejar las más complejas (es decir, datos del producto) el pasado.

Por ejemplo, migrar los precios y el inventario de los flujos de trabajo de primera. De esta manera, a construir su inicial integraciones mediante la migración de los elementos de datos que puede ser asignada estáticamente desde un XML basado en el flujo de trabajo a un Listados de los Elementos de la API o de JSON_LISTINGS_FEEDflujo de trabajo basado en. Como expandir su migración a incorporar cada tipo de datos, puede elegir mantener el aislamiento entre el manejo de cada tipo de datos o refactorizar para consolidar el manejo de diferentes tipos de datos.

El proceso de incorporación a la nueva API y las funciones de notificación

Usted puede comenzar a emplear la nueva Venta de Socio de la API y las funciones de notificación que obra junto con el XML o archivo plano feeds basado en el flujo de trabajo. Haciendo tan temprano en su migración, usted puede tomar ventaja de las características siguientes:

• Listings Items API (getListingsItem) - La getListingsItem operación de Listings Items API devuelve el estado actual, problemas y otros datos asociados con un listado, incluyendo los listados creados con otras herramientas. Para los actuales listados, esta operación devuelve los anteriormente presentados los datos en el formato utilizado para las Listas de Elementos de la API y JSON_LISTINGS_FEED presentaciones.
• Listings Restrictions API - Listings Restrictions API proporciona detalles de elegibilidad para la venta de los socios de la creación de ofertas en artículos en el catálogo de Amazon. Esta API permite verificar los requisitos de elegibilidad para una venta de socio antes de gastar tiempo y esfuerzo en la creación de ofertas de proceso.
• LISTINGS_ITEM_ISSUES_CHANGE Notificaciones - Usted puede suscribirse a la LISTINGS_ITEM_ISSUES_CHANGE notificación a recibir una notificación cuando los problemas se agregan o despejado en la venta de listados de partner. Usted puede utilizar Listings Items API para recuperar el estado más reciente y cuestiones para una lista.
• LISTINGS_ITEM_STATUS_CHANGE de las Notificaciones puede subscibre a la LISTINGS_ITEM_STATUS_CHANGE notificación a recibir una notificación cada vez que el buyability cambios en el estado de la venta de listados de partner. Usted puede utilizar Listings Items API para recuperar el estado más reciente y cuestiones para una lista.

Ofrecemos sólo los flujos de trabajo

Listados de gestión de flujos de trabajo que gestionan la oferta-sólo los listados son menos complejos que los flujos de trabajo de gestión de listados de datos de producto. Ofrecemos sólo los listados se refiere a los listados con los términos de venta (inventario y precios) de los artículos existentes en el catálogo de Amazon. Otro enfoque iterativo es la migración de ofrecer sólo los listados de los flujos de trabajo antes de migrar los listados que incluyen datos de los productos. Para más detalles sobre la creación de ofrecer sólo los listados con Listings Items API y JSON_LISTINGS_FEED presentaciones, consulte la Lista de una oferta por un artículo que ya existe en el catálogo de Amazon tutorial en la Guía para la construcción de flujos de trabajo para la gestión de listados.

Los tipos de productos y marketplaces

El modelo de datos y las limitaciones para la gestión de listados de datos de productos se diferencian por el tipo de producto y marketplace. Categoría Xsd definir estos modelos de datos en un nivel de categoría, mientras que las Definiciones del Tipo de Producto API define estas en el individuo tipo de producto. Con la migración de los datos del producto son los más complejos de la porción de la migración de los listados de los flujos de trabajo para la mayoría de los casos de uso, un enfoque iterativo por categoría, tipo de producto, y en el marketplace le permite configurar las asignaciones de datos, prueba de presentaciones, y recorrer más rápidamente en pequeñas cantidades de datos, en lugar de configurar todo a la vez.

🚧

Aún no hay soporte para todos los tipos de producto en todos los marketplaces

Listings Items API y JSON_LISTINGS_FEED no es compatible con todos los tipos de productos en todos los marketplaces . Un enfoque iterativo por tipo de producto y el marketplace le permite empezar a migrar y de forma iterativa adoptar tipos de producto en estas herramientas a medida que estén disponibles.

La migración de los feeds de productos de flujos de trabajo

Con los anteriores XML feed presentaciones (POST_PRODUCT_DATA), los datos del producto fue siempre presentado por separado de los otros Listings Items de datos (precios, inventario, imágenes, envío y relaciones). El modelo de datos para estas presentaciones se derivan de la utilización de la Categoría XSD (descargar Vendedor Central) y Productos.xsd esquemas XML.

Con Listings Items API y JSON_LISTINGS_FEEDde producto, los datos pueden ser presentados junto con todos los otros Listings Items (por ejemplo, a la hora de crear un listado con todos los elementos de datos en un único envío) o por sí mismo (producto-sólo las actualizaciones). Con miles de asignaciones de atributos, en esta guía no se lista cada asignación, como también para los otros elementos de datos. Ver la La asignación de los atributos del producto de la categoría archivos Xsd (XML) y el archivo de plano de tipos de feeds sección de archivos que contiene el conjunto completo de las asignaciones para los datos de los productos. Esta sección describe ejemplos de antes y después de la migración.

La presentación de los datos del producto

Producto XML feeds siempre manejan las actualizaciones de producto por separado de los otros Listings Items de datos (inventario, precios, etc.). Con Listings Items API y JSON_LISTINGS_FEEDde producto, los datos pueden ser enviados por sí mismo o junto con otros Listings Items de datos. Los ejemplos siguientes ilustran la presentación de los datos del producto para ambos escenarios.

XML anterior Presentación

<AmazonEnvelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="amzn-envelope.xsd">
  <Header>
    <DocumentVersion>1.01</DocumentVersion>
    <MerchantIdentifier>AXXXXXXXXXXXXX</MerchantIdentifier>
  </Header>
  <MessageType>Product</MessageType>
  <Message>
    <MessageID>1</MessageID>
    <OperationType>Update</OperationType>
    <Product>
      <SKU>ABC123</SKU>
      <StandardProductID>
        <Type>ASIN</Type>
        <Value>BXXXXXXXXX</Value>
      </StandardProductID>
      <Condition>
        <ConditionType>New</ConditionType>
      </Condition>
      <DescriptionData>
        <Title>MyBrand Carry-On Luggage</Title>
        <Brand>MyBrand</Brand>
      </DescriptionData>
      <ProductData>
        <Luggage>
          <ProductType>Luggage</ProductType>
          <Color>Red</Color>
        </Luggage>
      </ProductData>
    </Product>
  </Message>
</AmazonEnvelope>

Nuevos Listings Items API de presentación a la hora de crear un listado con otros elementos de datos

PUT https://sellingpartnerapi-na.amazon.com/listings/2021-08-01/items/AXXXXXXXXXXXXX/ABC123
  ?marketplaceIds=ATVPDKIKX0DER
  &issueLocale=en_US

{
  "productType": "LUGGAGE",
  "requirements": "LISTING",
  "attributes": {
    "condition_type": [
      {
        "value": "new_new",
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "merchant_suggested_asin": [
      {
        "value": "BXXXXXXXXX",
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "item_name": [
      {
        "value": "MyBrand Carry-On Luggage",
        "language_tag": "en_US",
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "brand": [
      {
        "value": "MyBrand",
        "language_tag": "en_US",
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "color": [
      {
        "value": "Red",
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "main_product_image_locator": [
      {
         "media_location": "https://example/main.jpg",
         "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    ... (more attributes, if applicable)
  }
}

Nuevos Listings Items API de presentación a la hora de actualizar el producto sólo

PATCH https://sellingpartnerapi-na.amazon.com/listings/2021-08-01/items/AXXXXXXXXXXXXX/ABC123
  ?marketplaceIds=ATVPDKIKX0DER
  &issueLocale=en_US

{
  "productType": "LUGGAGE",
  "patches": [
    {
      "op": "replace",
      "path": "/attributes/item_name",
      "value": [
        {
          "value": "MyBrand Carry-On Luggage",
          "language_tag": "en_US",
          "marketplace_id": "ATVPDKIKX0DER"
        }
      ]
    },
    ... (more patches, if applicable)
  ]
}

Nueva JSON_LISTINGS_FEED presentación a la hora de crear un listado con otros elementos de datos

{
  "header": {
    "sellerId": "AXXXXXXXXXXXXX",
    "version": "2.0",
    "issueLocale": "en_US"
  },
  "messages": [
    {
      "messageId": 1,
      "sku": "ABC123",
      "operationType": "UPDATE",
      "productType": "LUGGAGE",
      "requirements": "LISTING",
      "attributes": {
        "condition_type": [
          {
            "value": "new_new",
            "marketplace_id": "ATVPDKIKX0DER"
          }
        ],
        "merchant_suggested_asin": [
          {
            "value": "BXXXXXXXXX",
            "marketplace_id": "ATVPDKIKX0DER"
          }
        ],
        "item_name": [
          {
            "value": "MyBrand Carry-On Luggage",
            "language_tag": "en_US",
            "marketplace_id": "ATVPDKIKX0DER"
          }
        ],
        "brand": [
          {
            "value": "MyBrand",
            "language_tag": "en_US",
            "marketplace_id": "ATVPDKIKX0DER"
          }
        ],
        "color": [
          {
            "value": "Red",
            "marketplace_id": "ATVPDKIKX0DER"
          }
        ],
        "main_product_image_locator": [
          {
            "media_location": "https://example/main.jpg",
            "marketplace_id": "ATVPDKIKX0DER"
          }
        ],
        ... (more attributes, if applicable)
      }
    },
    ... (more messages, if applicable)
  ]
}

Nueva JSON_LISTINGS_FEED presentación a la hora de actualizar el producto sólo

{
  "header": {
    "sellerId": "AXXXXXXXXXXXXX",
    "version": "2.0",
    "issueLocale": "en_US"
  },
  "messages": [
    {
      "messageId": 1,
      "sku": "ABC123",
      "operationType": "PATCH",
      "productType": "LUGGAGE",
      "patches": [
        {
          "op": "replace",
          "path": "/attributes/item_name",
          "value": [
            {
              "value": "MyBrand Carry-On Luggage",
              "language_tag": "en_US",
              "marketplace_id": "ATVPDKIKX0DER"
            }
          ]
        },
        ... (more patches, if applicable)
      ]
    },
    ... (more messages, if applicable)
  ]
}

La migración de inventario se alimenta de flujos de trabajo

Con los anteriores XML feed presentaciones (POST_INVENTORY_AVAILABILITY_DATA), los datos de inventario siempre fue presentado por separado de producto y otros Listings Items de datos. Con Listings Items API y JSON_LISTINGS_FEED, inventario de datos pueden ser presentados junto con todos los otros Listings Items de datos (por ejemplo, a la hora de crear un listado con todos los elementos de datos en un único envío) o por sí mismo (inventario-sólo las actualizaciones). Esta sección describe las asignaciones de datos desde el legado de la fuente XML schema (Inventario.xsd), junto con ejemplos de antes y después de la migración.

Mientras que algunos tipos de productos que aún no están disponibles para Listings Items API y JSON_LISTINGS_FEED, los datos de inventario pueden ser presentadas por cualquier listados elemento, independientemente de su tipo de producto. Esto permite que el inventario de flujos de trabajo sólo para migrar completamente a los Listados de Artículos y API JSON_LISTINGS_FEED.

Las asignaciones de datos

La siguiente tabla proporciona una asignación de elemento XML por XPath para JSON elemento por JSON Puntero de datos de inventario.

La presentación de los datos de inventario

Inventario de fuentes XML siempre manejado actualizaciones de inventario separado de los otros Listings Items de datos (productos, precios, etc.). Con Listings Items API y JSON_LISTINGS_FEED, los datos de inventario pueden ser presentadas por sí mismo o junto con otros Listings Items de datos. Los ejemplos siguientes ilustran la presentación de datos de inventario para ambos escenarios.

XML anterior, la Presentación de NMF Cantidad

<AmazonEnvelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="amznenvelope.xsd">
  <Header>
    <DocumentVersion>1.01</DocumentVersion>
    <MerchantIdentifier>AXXXXXXXXXXXXX</MerchantIdentifier>
  </Header>
  <MessageType>Inventory</MessageType>
  <Message>
    <MessageID>1</MessageID>
    <OperationType>Update</OperationType>
    <Inventory>
      <SKU>ABC123</SKU>
      <FulfillmentCenterID>DEFAULT</FulfillmentCenterID>
      <Quantity>5</Quantity>
    </Inventory>
  </Message>
</AmazonEnvelope>

Nuevos Listings Items API de presentación a la hora de crear una oferta sólo listado con otros elementos de datos

PUT https://sellingpartnerapi-na.amazon.com/listings/2021-08-01/items/AXXXXXXXXXXXXX/ABC123
  ?marketplaceIds=ATVPDKIKX0DER
  &issueLocale=en_US

{
  "productType": "PRODUCT",
  "requirements": "LISTING_OFFER_ONLY",
  "attributes": {
    "condition_type": [
      {
        "value": "new_new",
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "merchant_suggested_asin": [
      {
        "value": "BXXXXXXXXX",
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "fulfillment_availability": [
      {
         "fulfillment_channel_code": "DEFAULT",
         "quantity": 5
      }
    ],
    ... (more attributes, if applicable)
  }
}

Nuevos Listings Items API de presentación a la hora de actualizar el inventario

PATCH https://sellingpartnerapi-na.amazon.com/listings/2021-08-01/items/AXXXXXXXXXXXXX/ABC123
  ?marketplaceIds=ATVPDKIKX0DER
  &issueLocale=en_US

{
  "productType": "PRODUCT",
  "patches": [
    {
      "op": "replace",
      "path": "/attributes/fulfillment_availability",
      "value": [
        {
          "fulfillment_channel_code": "DEFAULT",
          "quantity": 5
        }
      ]
    },
    ... (more patches, if applicable)
  ]
}

Nueva JSON_LISTINGS_FEED presentación a la hora de crear una oferta sólo listado con otros elementos de datos

{
  "header": {
    "sellerId": "AXXXXXXXXXXXXX",
    "version": "2.0",
    "issueLocale": "en_US"
  },
  "messages": [
    {
      "messageId": 1,
      "sku": "ABC123",
      "operationType": "UPDATE",
      "productType": "PRODUCT",
      `"requirements"`: `"LISTING_OFFER_ONLY"`,
      "attributes": {
        "condition_type": [
          {
            "value": "new_new",
            "marketplace_id": "ATVPDKIKX0DER"
          }
        ],
        "merchant_suggested_asin": [
          {
            "value": "BXXXXXXXXX",
            "marketplace_id": "ATVPDKIKX0DER"
          }
        ],
        "fulfillment_availability": [
          {
            "fulfillment_channel_code": "DEFAULT",
            "quantity": 5
          }
        ],
        ... (more attributes, if applicable)
      }
    },
    ... (more messages, if applicable)
  ]
}

Nueva JSON_LISTINGS_FEED presentación a la hora de actualizar el inventario

{
  "header": {
    "sellerId": "AXXXXXXXXXXXXX",
    "version": "2.0",
    "issueLocale": "en_US"
  },
  "messages": [
    {
      "messageId": 1,
      "sku": "ABC123",
      "operationType": "PATCH",
      "productType": "PRODUCT",
      "patches": [
        {
          "op": "replace",
          "path": "/attributes/fulfillment_availability",
          "value": [
            {
              "fulfillment_channel_code": "DEFAULT",
              "quantity": 5
            }
          ]
        },
        ... (more patches, if applicable)
      ]
    },
    ... (more messages, if applicable)
  ]
}

SwitchFulfillmentTo (convertir entre NMF y FBA)

Inventario de feeds XML apoyo de conmutación entre NMF y FBA la realización de un listados de elemento. Con Listings Items API y JSON_LISTINGS_FEED, el mismo resultado puede lograrse mediante la aplicación de parches de un elemento a agregar explícitamente uno y eliminar explícitamente los otros. Los siguientes ejemplos ilustran el cambio de FBA para NMF.

XML anterior, la presentación de conmutación de FBA para NMF

<AmazonEnvelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="amznenvelope.xsd">
  <Header>
    <DocumentVersion>1.01</DocumentVersion>
    <MerchantIdentifier>AXXXXXXXXXXXXX</MerchantIdentifier>
  </Header>
  <MessageType>Inventory</MessageType>
  <Message>
    <MessageID>1</MessageID>
    <OperationType>Update</OperationType>
    <Inventory>
      <SKU>ABC123</SKU>
      <FulfillmentCenterID>DEFAULT</FulfillmentCenterID>
      <Quantity>5</Quantity>
      <SwitchFulfillmentTo>MFN</SwitchFulfillmentTo>
    </Inventory>
  </Message>
</AmazonEnvelope>

Nuevos Listings Items API de envío de conmutación de FBA para NMF

PATCH https://sellingpartnerapi-na.amazon.com/listings/2021-08-01/items/AXXXXXXXXXXXXX/ABC123
  ?marketplaceIds=ATVPDKIKX0DER
  &issueLocale=en_US

{
  "productType": "PRODUCT",
  "patches": [
    {
      "op": "add",
      "path": "/attributes/fulfillment_availability",
      "value": [
        {
          "fulfillment_channel_code": "DEFAULT",
          "quantity": 5
        }
      ]
    },
    {
      "op": "delete",
      "path": "/attributes/fulfillment_availability",
      "value": [
        {
          "fulfillment_channel_code": "AMAZON_NA"
        }
      ]
    }
  ]
}

Nueva JSON_LISTINGS_FEED presentación de FBA para NMF

{
  "header": {
    "sellerId": "AXXXXXXXXXXXXX",
    "version": "2.0",
    "issueLocale": "en_US"
  },
  "messages": [
    {
      "messageId": 1,
      "sku": "ABC123",
      "operationType": "PATCH",
      "productType": "PRODUCT",
      "patches": [
        {
          "op": "add",
          "path": "/attributes/fulfillment_availability",
          "value": [
            {
              "fulfillment_channel_code": "DEFAULT",
              "quantity": 5
            }
          ]
        },
        {
          "op": "delete",
          "path": "/attributes/fulfillment_availability",
          "value": [
            {
              "fulfillment_channel_code": "AMAZON_NA"
            }
          ]
        }
      ]
    }
  ]
}

La migración de fuentes de precios de flujos de trabajo

Con los anteriores XML feed presentaciones (POST_PRODUCT_PRICING_DATA), los datos de precios fue siempre presentado por separado de producto y otros Listings Items de datos. Con Listings Items API y JSON_LISTINGS_FEED, los datos de precios puede ser presentado junto con todos los otros Listings Items de datos (Por ejemplo, la creación de una lista con todos los elementos de datos en un único envío) o por sí mismo (por ejemplo, la fijación de precios-sólo las actualizaciones). Esta sección describe las asignaciones de datos desde el legado de la fuente XML schema (el Precio.xsd), junto con ejemplos de antes y después de la migración.

🚧

B2B precios todavía no está disponible para envíos

B2B precios todavía no está disponible para envíos en los Listings Items API y JSON_LISTINGS_FEED. B2B precios serán soportadas antes de la amortización de XML feed presentaciones. Además, estándar la fijación de precios puede ser presentado con Listings Items API y JSON_LISTINGS_FEED sin afectar a la existente B2B precios configurado usando XML feeds, plantillas, o el Vendedor Central.

Mientras que algunos tipos de productos que aún no están disponibles para Listings Items API y JSON_LISTINGS_FEED, los datos de precios puede ser presentada por cualquier listados elemento, independientemente de su tipo de producto. Esto permite que los precios de flujos de trabajo sólo para migrar completamente a los Listados de Artículos y API JSON_LISTINGS_FEED.

Las asignaciones de datos

La siguiente tabla proporciona una asignación de elemento XML por XPath para JSON elemento por JSON Puntero de datos de precios. Elementos de datos no relevantes han sido excluidos.

La presentación de los datos de precios de

Precios XML feeds siempre manejado actualizaciones de inventario separado de los otros Listings Items de datos (producto, inventario, etc.). Con Listings Items API y JSON_LISTINGS_FEED, los datos de precios pueden ser presentadas por sí mismo o junto con otros Listings Items de datos. Los ejemplos siguientes ilustran la presentación de los datos de precios para ambos escenarios.

XML anterior presentación

<AmazonEnvelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="amznenvelope.xsd">
  <Header>
    <DocumentVersion>1.01</DocumentVersion>
    <MerchantIdentifier>AXXXXXXXXXXXXX</MerchantIdentifier>
  </Header>
  <MessageType>Price</MessageType>
  <Message>
    <MessageID>1</MessageID>
    <OperationType>Update</OperationType>
    <Price>
      <SKU>ABC123</SKU>
      <StandardPrice currency="USD">90.00</StandardPrice>
    </Price>
  </Message>
</AmazonEnvelope>

Nuevos Listings Items API de presentación a la hora de crear una oferta sólo listado con otros elementos de datos

PUT https://sellingpartnerapi-na.amazon.com/listings/2021-08-01/items/AXXXXXXXXXXXXX/ABC123
  ?marketplaceIds=ATVPDKIKX0DER
  &issueLocale=en_US

{
  "productType": "PRODUCT",
  "requirements": "LISTING_OFFER_ONLY",
  "attributes": {
    "condition_type": [
      {
        "value": "new_new",
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "merchant_suggested_asin": [
      {
        "value": "BXXXXXXXXX",
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "purchasable_offer": [
      {
        "currency": "USD",
        "our_price": [
          {
            "schedule": [
              {
                "value_with_tax": 90.00
              }
            ]
          }
        ]
      }
    ],
    ... (more attributes, if applicable)
  }
}

Nuevos Listings Items API de presentación a la hora de actualizar los precios sólo

PATCH https://sellingpartnerapi-na.amazon.com/listings/2021-08-01/items/AXXXXXXXXXXXXX/ABC123
  ?marketplaceIds=ATVPDKIKX0DER
  &issueLocale=en_US

{
  "productType": "PRODUCT",
  "patches": [
    {
      "op": "replace",
      "path": "/attributes/purchasable_offer",
      "value": [
        {
          "currency": "USD",
          "our_price": [
            {
              "schedule": [
                {
                  "value_with_tax": 90.00
                }
              ]
            }
          ]
        }
      ]
    },
    ... (more patches, if applicable)
  }
}

Nueva JSON_LISTINGS_FEED presentación a la hora de crear una oferta sólo listado con otros elementos de datos

{
  "header": {
    "sellerId": "AXXXXXXXXXXXXX",
    "version": "2.0",
    "issueLocale": "en_US"
  },
  "messages": [
    {
      "messageId": 1,
      "sku": "ABC123",
      "operationType": "UPDATE",
      "productType": "PRODUCT",
      `"requirements"`: `"LISTING_OFFER_ONLY"`,
      "attributes": {
        "condition_type": [
          {
            "value": "new_new",
            "marketplace_id": "ATVPDKIKX0DER"
          }
        ],
        "merchant_suggested_asin": [
          {
            "value": "BXXXXXXXXX",
            "marketplace_id": "ATVPDKIKX0DER"
          }
        ],
        "purchasable_offer": [
          {
            "currency": "USD",
            "our_price": [
              {
                "schedule": [
                  {
                    "value_with_tax": 90.00
                  }
                ]
              }
            ]
          }
        ],
        ... (more attributes, if applicable)
      }
    },
    ... (more messages, if applicable)
  ]
}

Nueva JSON_LISTINGS_FEED presentación a la hora de actualizar los precios sólo

{
  "header": {
    "sellerId": "AXXXXXXXXXXXXX",
    "version": "2.0",
    "issueLocale": "en_US"
  },
  "messages": [
    {
      "messageId": 1,
      "sku": "ABC123",
      "operationType": "PATCH",
      "productType": "PRODUCT",
      "patches": [
        {
          "op": "replace",
          "path": "/attributes/purchasable_offer",
          "value": [
            {
              "currency": "USD",
              "our_price": [
                {
                  "schedule": [
                    {
                      "value_with_tax": 90.00
                    }
                  ]
                }
              ]
            }
          ]
        },
        ... (more patches, if applicable)
      ]
    },
    ... (more messages, if applicable)
  ]
}

La migración de la imagen se alimenta de flujos de trabajo

Con los anteriores XML feed presentaciones (POST_PRODUCT_IMAGE_DATA), los datos de la imagen siempre fue presentado por separado de producto y otros Listings Items de datos al proporcionar los tipos de imágenes y URLs para Amazon para descargar las imágenes. Con Listings Items API y JSON_LISTINGS_FEED, los datos de imagen pueden ser presentadas junto con todos los otros Listings Items de datos (por ejemplo, a la hora de crear un listado con todos los elementos de datos en un único envío) o por sí mismo (sólo imagen de actualizaciones). Esta sección describe el tipo de imagen de las asignaciones del legado de la fuente XML schema (ProductImage.xsd), junto con ejemplos de antes y después de la migración.

Mientras que algunos tipos de productos que aún no están disponibles para Listings Items API y JSON_LISTINGS_FEED, los datos de imagen pueden ser presentadas por cualquier listados elemento, independientemente de su tipo de producto. Esto permite que la imagen flujos de trabajo sólo para migrar completamente a los Listados de Artículos y API JSON_LISTINGS_FEED.

Alojamiento de imágenes

Las imágenes presentadas con Listings Items API y JSON_LISTINGS_FEED debe estar alojado en o distribuido por un recurso de Amazon (por ejemplo, Amazon S3, AWS CloudFront). Para más detalles sobre el alojamiento de los requisitos, vea la Presentación de Imágenes y Otros Medios de comunicación de los Atributos. Su caso de uso puede calificar para la capa Gratuita de AWS de Amazon S3. Para obtener más avanzada de casos de uso, AWS CloudFront orígenes personalizados, puede ser utilizado para hospedar el contenido en sus propios servicios o redes de entrega de contenido, con AWS CloudFront proporcionando la distribución de su contenido a Amazon cuando la presentación de sus entradas relacionadas con imágenes.

Tipo de imagen asignaciones

La siguiente tabla proporciona un mapeo de los tipos de imagen utilizados en la imagen XML feeds a la aplicable JSON elemento por JSON Puntero.

La presentación de los datos de la imagen

Imagen de XML feeds siempre maneja la imagen de las actualizaciones por separado de los otros Listings Items de datos (productos, precios, etc.) por la prestación de los tipos de imágenes y URLs para Amazon para descargar las imágenes. Con Listings Items API y JSON_LISTINGS_FEED, los datos de imagen pueden ser presentadas por sí mismo o junto con otros Listings Items de datos. Los ejemplos siguientes ilustran la presentación de los datos de la imagen para ambos escenarios.

XML anterior Presentación

<AmazonEnvelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="amzn-envelope.xsd">
  <Header>
    <DocumentVersion>1.01</DocumentVersion>
    <MerchantIdentifier>AXXXXXXXXXXXXX</MerchantIdentifier>
  </Header>
  <MessageType>ProductImage</MessageType>
  <Message>
    <MessageID>1</MessageID>
    <OperationType>Update</OperationType>
    <ProductImage>
      <SKU>ABC123</SKU>
      <ImageType>Main</ImageType>
      <ImageLocation>https://example/main.jpg</ImageLocation>
    </ProductImage>
  </Message>
</AmazonEnvelope>

Nuevos Listings Items API de presentación a la hora de crear un listado con otros elementos de datos

PUT https://sellingpartnerapi-na.amazon.com/listings/2021-08-01/items/AXXXXXXXXXXXXX/ABC123
  ?marketplaceIds=ATVPDKIKX0DER
  &issueLocale=en_US

{
  "productType": "LUGGAGE",
  "requirements": "LISTING",
  "attributes": {
    "condition_type": [
      {
        "value": "new_new",
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "merchant_suggested_asin": [
      {
        "value": "BXXXXXXXXX",
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "main_product_image_locator": [
      {
         "media_location": "https://example/main.jpg",
         "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    ... (more attributes, if applicable)
  }
}

Nuevos Listings Items API de presentación a la hora de actualizar las imágenes sólo

PATCH https://sellingpartnerapi-na.amazon.com/listings/2021-08-01/items/AXXXXXXXXXXXXX/ABC123
  ?marketplaceIds=ATVPDKIKX0DER
  &issueLocale=en_US

{
  "productType": "PRODUCT",
  "patches": [
    {
      "op": "replace",
      "path": "/attributes/main_product_image_locator",
      "value": [
        {
          "media_location": "https://example/main.jpg",
          "marketplace_id": "ATVPDKIKX0DER"
        }
      ]
    },
    ... (more patches, if applicable)
  ]
}

Nueva JSON_LISTINGS_FEED presentación a la hora de crear un listado con otros elementos de datos

{
  "header": {
    "sellerId": "AXXXXXXXXXXXXX",
    "version": "2.0",
    "issueLocale": "en_US"
  },
  "messages": [
    {
      "messageId": 1,
      "sku": "ABC123",
      "operationType": "UPDATE",
      "productType": "LUGGAGE",
      "requirements": "LISTING",
      "attributes": {
        "condition_type": [
          {
            "value": "new_new",
            "marketplace_id": "ATVPDKIKX0DER"
          }
        ],
        "merchant_suggested_asin": [
          {
            "value": "BXXXXXXXXX",
            "marketplace_id": "ATVPDKIKX0DER"
          }
        ],
        "main_product_image_locator": [
          {
            "media_location": "https://example/main.jpg",
            "marketplace_id": "ATVPDKIKX0DER"
          }
        ],
        ... (more attributes, if applicable)
      }
    },
    ... (more messages, if applicable)
  ]
}

Nueva JSON_LISTINGS_FEED presentación a la hora de actualizar las imágenes sólo

{
  "header": {
    "sellerId": "AXXXXXXXXXXXXX",
    "version": "2.0",
    "issueLocale": "en_US"
  },
  "messages": [
    {
      "messageId": 1,
      "sku": "ABC123",
      "operationType": "PATCH",
      "productType": "PRODUCT",
      "patches": [
        {
          "op": "replace",
          "path": "/attributes/main_product_image_locator",
          "value": [
            {
              "media_location": "https://example/main.jpg",
              "marketplace_id": "ATVPDKIKX0DER"
            }
          ]
        },
        ... (more patches, if applicable)
      ]
    },
    ... (more messages, if applicable)
  ]
}

La migración de relación se alimenta de flujos de trabajo

Una variación de la familia representa una colección de elementos de un producto que se vende en múltiples variedades. Por ejemplo, un artículo de ropa puede venir en varios tamaños y colores. Cada tamaño y la combinación de colores está representada por separado listas de elemento y agrupados por los padres de los listados de elemento para proporcionar una sola página de detalles de la experiencia.

Con XML feeds, individuales Listings Items que fueron creados con el POST_PRODUCT_DATA tipo de feed y el POST_PRODUCT_RELATIONSHIP_DATA tipo de feed fue utilizada para la vinculación explícita de los Listings Items en virtud de uno de los padres de los listados de elemento. Con Listings Items API y JSON_LISTINGS_FEED, un padre listados elemento se crea por primera vez y cada niño listados elemento se refiere a los padres de los listados de elemento con el child_parent_sku_relationship atributo. Cada uno de los listados en el elemento de la variación de la familia utiliza el parentage_level atributo para definir si es un padre o un niño dentro de la variación de la familia y el variation_theme atributo para definir el variated los atributos de la variación de la familia.

Esta sección se describen ejemplos de la vinculación de los Listings Items en una variación de la familia a través de un legado XML feed (POST_PRODUCT_RELATIONSHIP_DATA), Listings Items API, y JSON_LISTINGS_FEED.

La presentación de las relaciones de datos

Relationship XML feeds siempre manejado relación actualizaciones por separado de los otros Listings Items de datos (productos, precios, etc.). Con Listings Items API y JSON_LISTINGS_FEED, la relación de los datos podrán ser presentadas por sí mismo o junto con otros Listings Items de datos. Los ejemplos siguientes ilustran la presentación de datos de la relación para ambos escenarios.

📘

Parent/Child de relaciones se definen de manera diferente en XML y JSON

Con relaciones definidas en XML feed (POST_PRODUCT_RELATIONSHIP_DATA) presentaciones, las relaciones que se configuran en la variación de los padres que se refieren a cada variación de niño. Con relaciones definidas en los Listings Items API y JSON_LISTINGS_FEED las presentaciones, las relaciones que se configuran en cada variación del niño en referencia a la variación de los padres.

XML anterior Presentación

<?xml version="1.0" encoding="UTF-8"?>
<AmazonEnvelope>
  <Header>
    <DocumentVersion>1.01</DocumentVersion>
    <MerchantIdentifier>AXXXXXXXXXXXXX</MerchantIdentifier>
  </Header>
  <MessageType>Relationship</MessageType>
  <PurgeAndReplace>false</PurgeAndReplace>
  <Message>
    <MessageID>1</MessageID>
    <OperationType>Update</OperationType>
    <Relationship>
      <ParentSKU>ABC123</ParentSKU>
      <Relation>
        <SKU>Child123</SKU>
        <Type>Variation</Type>
      </Relation>
    </Relationship>
  </Message>
</AmazonEnvelope>

Nuevos Listings Items API de presentación a la hora de crear un niño, y añadiendo a una variación de la familia con otros elementos de datos

PUT https://sellingpartnerapi-na.amazon.com/listings/2021-08-01/items/AXXXXXXXXXXXXX/Child123
  ?marketplaceIds=ATVPDKIKX0DER
  &issueLocale=en_US

{
  "productType": "LUGGAGE",
  "requirements": "LISTING",
  "attributes": {
    "condition_type": [
      {
        "value": "new_new",
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "merchant_suggested_asin": [
      {
        "value": "BXXXXXXXXX",
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "child_parent_sku_relationship": [
      {
        "child_relationship_type": "variation",
        "parent_sku": "ABC123",
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    ... (more attributes, if applicable)
  }
}

Nuevos Listings Items API de presentación cuando se agrega a un niño a una variación de la familia sólo

PATCH https://sellingpartnerapi-na.amazon.com/listings/2021-08-01/items/AXXXXXXXXXXXXX/Child123
  ?marketplaceIds=ATVPDKIKX0DER
  &issueLocale=en_US

{
  "productType": "LUGGAGE",
  "patches": [
    {
      "op": "replace",
      "path": "/attributes/child_parent_sku_relationship",
      "value": [
        {
          "child_relationship_type": "variation",
          "parent_sku": "ABC123",
          "marketplace_id": "ATVPDKIKX0DER"
        }
      ]
    },
    ... (more patches, if applicable)
  ]
}

Nueva JSON_LISTINGS_FEED presentación a la hora de crear un niño, y añadiendo a una variación de la familia con otros elementos de datos

{
  "header": {
    "sellerId": "AXXXXXXXXXXXXX",
    "version": "2.0",
    "issueLocale": "en_US"
  },
  "messages": [
    {
      "messageId": 1,
      "sku": "Child123",
      "operationType": "UPDATE",
      "productType": "LUGGAGE",
      "requirements": "LISTING",
      "attributes": {
        "condition_type": [
          {
            "value": "new_new",
            "marketplace_id": "ATVPDKIKX0DER"
          }
        ],
        "merchant_suggested_asin": [
          {
            "value": "BXXXXXXXXX",
            "marketplace_id": "ATVPDKIKX0DER"
          }
        ],
        "child_parent_sku_relationship": [
          {
            "child_relationship_type": "variation",
            "parent_sku": "ABC123",
            "marketplace_id": "ATVPDKIKX0DER"
          }
        ],
        ... (more attributes, if applicable)
      }
    },
    ... (more messages, if applicable)
  ]
}

Nuevo envío de JSON_LISTINGS_FEED al agregar un niño solo a una familia de variación

{
  "header": {
    "sellerId": "AXXXXXXXXXXXXX",
    "version": "2.0",
    "issueLocale": "en_US"
  },
  "messages": [
    {
      "messageId": 1,
      "sku": "Child123",
      "operationType": "PATCH",
      "productType": "LUGGAGE",
      "patches": [
        {
          "op": "replace",
          "path": "/attributes/child_parent_sku_relationship",
          "value": [
            {
              "child_relationship_type": "variation",
              "parent_sku": "ABC123",
              "marketplace_id": "ATVPDKIKX0DER"
            }
          ]
        },
        ... (more patches, if applicable)
      ]
    },
    ... (more messages, if applicable)
  ]
}

La migración de envío reemplazar alimenta los flujos de trabajo

Configuración de envío de los Listings Items que se configuran en el nivel de cuenta por defecto para los sellers en Seller Central. Los sellers profesionales pueden aplicar alternativas de configuración de envío mediante la definición de envío de plantillas que se aplican a cada aplicables listados de elemento. Listings Items API y JSON_LISTINGS_FEED de apoyo a la aplicación de envío de plantillas de listados individuales elementos especificando el merchant_shipping_group atributo. Al proporcionar el sellerId parámetro con el Tipo de Producto Definiciones de la API, se puede recuperar el envío disponibles plantillas configuradas por el vendedor como una enumeración en el merchant_shipping_group valor de atributo.

Con XML feeds (POST_PRODUCT_OVERRIDES_DATA), sin embargo, el envío anula fueron aplicadas por la lista en lugar de con el envío de plantillas. Envío anula han sido despreciado en favor de envío de plantillas y no son compatibles con los Listings Items o API JSON_LISTINGS_FEED. Para los sellers mediante envío de las modificaciones, el siguiente Vendedor de ayuda del centro de recursos se proporcionan detalles sobre la configuración de nivel de cuenta y envío de la configuración de la plantilla.

• Configurar las tarifas de envío y restricciones: https://sellercentral.amazon.com/help/hub/reference/G891
• Crear, editar, o eliminar el envío de plantillas: https://sellercentral.amazon.com/help/hub/reference/G201834090
• Migrar a la nueva configuración de envío: https://sellercentral.amazon.com/help/hub/reference/G201834130

🚧

Envío anula están en desuso

Envío anula (POST_PRODUCT_OVERRIDES_DATA) son una característica obsoleta. El MerchantShippingGroupName atributo puede utilizarse con el actual POST_PRODUCT_DATA tipo de feed para el envío de plantillas hasta la migración a las Listas de Elementos de la API o JSON_LISTINGS_FEED es completa.

La presentación de envío de datos

Envío de XML feeds siempre tratados de envío reemplaza por separado de los otros Listings Items de datos (productos, precios, etc.). Con Listings Items API y JSON_LISTINGS_FEED, el envío de plantillas de datos pueden ser enviados por sí mismo o junto con otros Listings Items de datos. Los ejemplos siguientes ilustran la presentación de envío de plantillas de datos para ambos escenarios.

Nueva JSON_LISTINGS_FEED presentación a la hora de crear un listado con otros elementos de datos

{
  "header": {
    "sellerId": "AXXXXXXXXXXXXX",
    "version": "2.0",
    "issueLocale": "en_US"
  },
  "messages": [
    {
      "messageId": 1,
      "sku": "ABC123",
      "operationType": "UPDATE",
      "productType": "LUGGAGE",
      "requirements": "LISTING",
      "attributes": {
        "condition_type": [
          {
            "value": "new_new",
            "marketplace_id": "ATVPDKIKX0DER"
          }
        ],
        "merchant_suggested_asin": [
          {
            "value": "BXXXXXXXXX",
            "marketplace_id": "ATVPDKIKX0DER"
          }
        ],
        "merchant_shipping_group": [
          {
            "value": "legacy-template-id",
            "marketplace_id": "ATVPDKIKX0DER"
          }
        ],
        ... (more attributes, if applicable)
      }
    },
    ... (more messages, if applicable)
  ]
}

Nueva JSON_LISTINGS_FEED presentación a la hora de actualizar el envío de plantillas sólo

{
  "header": {
    "sellerId": "AXXXXXXXXXXXXX",
    "version": "2.0",
    "issueLocale": "en_US"
  },
  "messages": [
    {
      "messageId": 1,
      "sku": "ABC123",
      "operationType": "PATCH",
      "productType": "PRODUCT",
      "patches": [
        {
          "op": "replace",
          "path": "/attributes/merchant_shipping_group",
          "value": [
            {
              "value": "legacy-template-id",
              "marketplace_id": "ATVPDKIKX0DER"
            }
          ]
        },
        ... (more patches, if applicable)
      ]
    },
    ... (more messages, if applicable)
  ]
}

La migración de archivos planos se alimenta de flujos de trabajo

Con el anterior archivo plano (POST_FLAT_FILE_LISTINGS_DATA, POST_FLAT_FILE_INVLOADER_DATA) se alimentan de las presentaciones, varias combinaciones de listas de elementos de datos fueron aceptados en formato tabular (hojas de cálculo de Excel o archivos TSV). Estas combinaciones incluyen todos los Listings Items de datos, ofrecer sólo los elementos de datos, precio y datos de inventario de los elementos, y otros. Ver la La asignación de los atributos del producto de la categoría archivos Xsd (XML) y el archivo de plano de tipos de feeds sección de archivos que contiene el conjunto completo de las asignaciones para los datos de los productos. Esta sección describe ejemplos de antes y después de la migración para el precio y la plantilla de inventario.

La presentación de los datos

Archivo plano alimenta manejado varias combinaciones de listas de elementos de datos, dependiendo de la plantilla utilizada. Con Listings Items API y JSON_LISTINGS_FEED, estas combinaciones se han generalizado a los "requisitos" para identificar el tipo de listado que es creado:

• LISTING: Indica que los datos presentados contiene características de los productos y condiciones de venta. Esto se correlaciona con la "Plantilla de Producto" para tv de fuentes de archivos.
• LISTING_PRODUCT_ONLY: Indica que los datos presentados contiene productos hechos solamente. Esto se correlaciona con la "Plantilla de Producto" para el archivo plano se alimenta con el skip ofrecen seleccionados en cada fila.
• LISTING_OFFER_ONLY: Indica que los datos presentados contiene términos de venta única. Esto se correlaciona con el "Listado de Gestor de la" plantilla de archivo de planos de feeds.

Cuando la edición existente listados con tv de fuentes de archivos, el "Precio y la Cantidad de la plantilla" aceptado un conjunto mínimo de datos para la actualización de los precios y detalles de inventario, mientras que la "Plantilla de Producto" aceptado detalles adicionales con la actualización parcial de la característica seleccionada. Los ejemplos a continuación, compare los Precios y la Cantidad de la plantilla" para actualizaciones parciales presentadas a los Listados de Artículos y API JSON_LISTINGS_FEED.

Anterior plana de envío de archivos para actualizar el precio y la cantidad

Nuevos Listings Items API de presentación para la actualización de precio y cantidad

PATCH https://sellingpartnerapi-na.amazon.com/listings/2021-08-01/items/AXXXXXXXXXXXXX/ABC123
  ?marketplaceIds=ATVPDKIKX0DER
  &issueLocale=en_US

{
  "productType": "PRODUCT",
  "patches": [
    {
      "op": "replace",
      "path": "/attributes/purchasable_offer",
      "value": [
        {
          "currency": "USD",
          "our_price": [
            {
              "schedule": [
                {
                  "value_with_tax": 90.00
                }
              ]
            }
          ],
          "minimum_seller_allowed_price": [
            {
              "schedule": [
                {
                  "value_with_tax": 80.00
                }
              ]
            }
          ],
          "maximum_seller_allowed_price": [
            {
              "schedule": [
                {
                  "value_with_tax": 100.00
                }
              ]
            }
          ]
        }
      ]
    },
    {
      "op": "replace",
      "path": "/attributes/fulfillment_availability",
      "value": [
        {
          "fulfillment_channel_code": "DEFAULT",
          "quantity": 5,
          "lead_time_to_ship_max_days": 1
        }
      ]
    }
    ... (more patches, if applicable)
  ]
}

Nueva JSON_LISTINGS_FEED presentación para actualizar el precio y la cantidad

{
  "header": {
    "sellerId": "AXXXXXXXXXXXXX",
    "version": "2.0",
    "issueLocale": "en_US"
  },
  "messages": [
    {
      "messageId": 1,
      "sku": "ABC123",
      "operationType": "PATCH",
      "productType": "LUGGAGE",
      "patches": [
        {
          "op": "replace",
          "path": "/attributes/purchasable_offer",
          "value": [
            {
              "currency": "USD",
              "our_price": [
                {
                  "schedule": [
                    {
                      "value_with_tax": 90.00
                    }
                  ]
                }
              ],
              "minimum_seller_allowed_price": [
                {
                  "schedule": [
                    {
                      "value_with_tax": 80.00
                    }
                  ]
                }
              ],
              "maximum_seller_allowed_price": [
                {
                  "schedule": [
                    {
                      "value_with_tax": 100.00
                    }
                  ]
                }
              ]
            }
          ]
        },
        {
          "op": "replace",
          "path": "/attributes/fulfillment_availability",
          "value": [
            {
              "fulfillment_channel_code": "DEFAULT",
              "quantity": 5,
              "lead_time_to_ship_max_days": 1
            }
          ]
        },
        ... (more patches, if applicable)
      ]
    },
    ... (more messages, if applicable)
  ]
}

Preguntas frecuentes

¿Estoy obligado a migrar fuera de la feed de los tipos mencionados en esta guía?

No todavía. Listings Items API, JSON_LISTINGS_FEED tipo de feed, y relacionadas con la API de ofertas de proporcionar los medios para la construcción integral, eficiente y orientado a eventos listados de flujos de trabajo. Sin embargo, no todos los tipos de productos están soportados en los Listings Items API en este momento. Una vez que todos los tipos de productos son compatibles, además de orientación y de los plazos será proporcionado por la depreciación de los tipos de feed (distinto JSON_LISTINGS_FEED) que aparecen en esta guía.

Envío anula (POST_PRODUCT_OVERRIDES_DATA), sin embargo, son una característica obsoleta. Los sellers mediante el envío de anulaciones deben migrar a nivel de cuenta o el envío de la configuración de la plantilla tan pronto como sea posible para evitar la interrupción. El MerchantShippingGroupName atributo puede utilizarse con el actual POST_PRODUCT_DATA tipo de feed para el envío de plantillas hasta la migración a las Listas de Elementos de la API o JSON_LISTINGS_FEED es completa.

Puedo continuar usando los tipos de feed hasta que a mi se complete la migración?

Sí. Usted puede continuar usando los listados de los flujos de trabajo mientras la migración. Una vez migrado (en su totalidad o en parte), propuestas para el contenido de la misma no debe ser duplicado utilizando tanto los flujos de trabajo. Por ejemplo, si ha migrado de un flujo de trabajo para el precio-sólo actualizaciones, sometiendo el mismo precio-sólo actualizaciones en viejos y nuevos flujos de trabajo será redundante y causar retrasos en el proceso de la duplicación de las presentaciones.

¿Por qué debería empezar a migrar ahora?

La migración a los Listados de la API ofrece acceso a-a-fecha de plantillas, incluyendo datos claros los requisitos para el producto de los esquemas, y la capacidad para recibir sincrónicas y asincrónicas de la retrofeed de sus envíos, independientemente de si usted es un vendedor o proveedor.

Puedo continuar para enviar de forma masiva con los feeds?

Sí. El JSON_LISTINGS_FEED tipo de feed es compatible e interoperable con Listings Items API y Referencia de Product Type Definitions API. Decidir entre el uso de la JSON_LISTINGS_FEED, Listings Items API, o ambos, depende de cada caso de uso. Consulte Creación y Actualización de los Listados de Artículos al por mayor para obtener más información y orientación.

¿Qué puedo migrar si los tipos de producto para mi caso de uso todavía no están disponibles?

Los Listados Api está disponible para el Hardlines y Softlines categorías a través de todos los marketplaces (excepto India) en todo el mundo, excepto Consumibles, Libros, Medios de comunicación y categorías. Usted todavía puede migrar el proceso de actualización de sólo inventario/precio u ofrecer actualizaciones para cualquier listado de elemento, independientemente de su tipo de producto. Consulte la tabla de abajo para obtener más detalles sobre su caso de uso específico: