Tutorial: Convierta una aplicación pública de Amazon MWS en una aplicación Selling Partner API

Flujo de trabajo de migración

Este flujo de trabajo de migración convierte una aplicación pública de Amazon MWS en una aplicación hybrid Selling Partner API. Una aplicación híbrida puede realizar llamadas de API tanto a Amazon MWS como a SP-API. Con una aplicación híbrida, tiene funcionalidad de ambos servicios y cero tiempo de inactividad de la aplicación durante el proceso de migración.

Nota: este flujo de trabajo es solo para aplicaciones públicas. Una aplicación pública está disponible públicamente y autorizada por un selling partner. Si tiene una aplicación privada, vaya a Tutorial: Crear una aplicación privada de selling partner .

Tutorial de migración para aplicaciones públicas

Este tutorial explica cómo convertir una aplicación pública de Amazon MWS en una aplicación hybrid Selling Partner API.

requisitos previos

• Una aplicación de Amazon MWS registrada que se publica en la Selling Partner Appstore.
• Una cuenta de Amazon Web Services (AWS). Para crear una cuenta, regístrese en AWS .

Paso 1. Solicite el acceso a los datos que requiere su aplicación Selling Partner API

1. Inicie sesión en Seller Central con sus credenciales de desarrolador y vaya a Desarrollo de Aplicaciones .
2. En la página Central de desarrolladores , elija Ver perfil .
3. En la página Perfil de desarrollador , en la sección Acceso a datos , seleccione los roles que requieren sus aplicaciones. Para obtener más información sobre cómo elegir o solicitar roles, consulte Roles en la Selling Partner API .
4. ElijaRegistro .

El equipo de soporte para desarrolador evaluará su solicitud y responderá a su caso de soporte después de que se complete su revisión. Este proceso puede tardar varios días. Puede controlar el estado de su registro en Central de desarrolladores en el banner Su registro de desarrollador está bajo revisión .

Nota: No puede modificar su Perfil de desarrollador mientras está siendo revisado por Soporte para desarrolador.

Paso 2. Crear y configurar recursos de IAM

Se requieren recursos de AWS Identity and Access Management (IAM) para convertir su aplicación de Amazon MWS en una aplicación de Selling Partner API, incluidos un usuario de IAM, una política de IAM y un rol de IAM .

Cuando crea su rol de IAM, también genera un Amazon Resource Name (ARN), que es un identificador único para su rol de IAM. Debe usar este ARN de rol de IAM cuando convierta su aplicación privada de Amazon MWS en una aplicación hybrid Selling Partner API en el Paso 3 .

Puede crear y configurar sus recursos de IAM de dos maneras:

• Para crear y configurar mediante programación los recursos de IAM, utilice la Selling Partner API en AWS Quick Start . El inicio rápido de la Selling Partner API en AWS incluye una plantilla de AWS CloudFormation que implementa en su cuenta de AWS para crear mediante programación todas las políticas y funciones de IAM requeridas.
• Para crear y configurar manualmente los recursos de IAM, consulte Creación y configuración de políticas y entidades de IAM en la Guía para Selling Partner API desarrolador.

Para obtener más información sobre cómo configurar AWS IAM, vea el video Integrar con Amazon SP-API: configurar AWS IAM en el canal de YouTube de Amazon Seller University.

Paso 3. Convierta su aplicación pública de Amazon MWS en una aplicación hybrid Selling Partner API

1. Inicie sesión en Seller Central con sus credenciales de desarrolador y vaya a Desarrollo de Aplicaciones .
2. En la página Central de desarrolladores , junto a su aplicación de Amazon MWS, seleccione Editar aplicación .
3. En el formulario registro de la aplicación , para Tipo de API , elija SP-API y MWS . Esta selección llena el formulario con los detalles de su aplicación.
4. En el cuadro IAM ARN , pegue el ARN para el rol de IAM que creó en el Paso 2. Crear y configurar recursos de IAM . Si no está seguro del valor del ARN, puede utilizar los siguientes procesos:
   • Si creó sus recursos de IAM mediante programación mediante la API de selling partner en la Guía de implementación de inicio rápido de AWS, pegue el ARN que copió en Pasos posteriores a la implementación - Copie el Role ARN de IAM .
   • Si creó sus recursos de IAM manualmente siguiendo los pasos de la Guía para Selling Partner API desarrolador, pegue el ARN para el rol de IAM que copió en el Paso 4. Cree un rol de IAM . Este rol de IAM también debe tener adjunta la política de AWS Security Token Service (AWS STS).
   • Para ver el ARN en la AWS Management Console, inicie sesión en el panel de control de IAM y, en el panel de navegación izquierdo, elija Roles . Busque y seleccione el rol SP-API que creó. En la página Resumen , copie el Role ARN .
5. En la sección Roles , seleccione todos los roles requeridos por su aplicación. Para obtener más información sobre cómo elegir o solicitar roles, consulte Roles en la Selling Partner API .
6. Elija Guardar y salir para completar el registro y crear un borrador de la aplicación de hybrid Selling Partner API.

Paso 4. Implementar el flujo de trabajo de autorización de OAuth

Configure y pruebe un flujo de trabajo de autorización de OAuth para su aplicación hybrid Selling Partner API. Para obtener más información, consulte Autorización de aplicaciones de Selling Partner API en la Guía para Selling Partner API desarrolador .

Cuando termine de probar su flujo de trabajo de autorización, debe convertir su flujo de trabajo de autorización de prueba en un flujo de trabajo de autorización de producción.

Paso 5. Conéctese a la Selling Partner API

Configure un flujo de trabajo para las operaciones de llamadas en la Selling Partner API. Este flujo de trabajo incluye el intercambio de Login with Amazon (LWA), la construcción de URI, la adición de headers y la creación y signing solicitudes. Para configurar este flujo de trabajo, genere y use un SDK que incluya autenticación e intercambio de tokens LWA. Para obtener más información, consulte Generación de un SDK de Java con autenticación e intercambio de tokens LWA y Conexión a la Selling Partner API mediante un SDK de Java generado en la Guía para desarrolador de la Selling Partner API.

Para obtener información sobre cómo conectarse a la Selling Partner API sandbox, consulte la Selling Partner API sandbox en la Guía para desarrolador de la Selling Partner API.

Paso 6. Migre sus notificaciones de Amazon MWS a la Selling Partner API

A medida que migre las secciones de la API de MWS, asegúrese de eliminar sus antiguas suscripciones de MWS y use la Selling Partner API para notificaciones que le permite suscribirse a las notificaciones relevantes para el negocio de un selling partner. Con esta API, puede crear un destino para recibir notificaciones, suscribirse a notificaciones, eliminar suscripciones a notificaciones y más.

Paso 7. Publique su aplicación hybrid Selling Partner en la Selling Partner Appstore

1. Inicie sesión en Seller Central con sus credenciales de desarrolador y vaya a Desarrollo de Aplicaciones .
2. En la página Central de desarrolladores , busque su aplicación. Seleccione Editar aplicación y luego elija Editar listado .
3. En el formulario registro de la aplicación , para Tipo de API , elija SP-API y MWS . Esta selección llena el formulario con los detalles de su aplicación.
4. Complete los campos restantes y envíe el formulario. Su aplicación hybrid Selling Partner se publicará en la Selling Partner Appstore en 3 a 4 semanas.

Paso 8. Migrar autorizaciones de Amazon MWS a autorizaciones de Selling Partner API

Nota: Confirme que su aplicación de API de selling partner esté publicada en la Selling Partner Appstore antes de migrar sus autorizaciones existentes de Amazon MWS a autorizaciones de Selling Partner API. Además, cualquier vía de autorización de MWS existente utilizada para su MWS o aplicación híbrida debe eliminarse en su nueva aplicación. Eliminar la vía de autorización garantiza que sus nuevas autorizaciones se realizarán correctamente después de la conversión.

Migre sus autorizaciones existentes de Amazon MWS a autorizaciones de Selling Partner API. Para obtener más información, consulte la Guía de casos de uso de la Authorization API . Asegúrese de guardar el LWA refresh token que recibió en el Paso 2 .

Paso 9. Migre sus llamadas de Amazon MWS a llamadas de Selling Partner API

Actualice su aplicación para que las acciones que antes llamaban operaciones de Amazon MWS llamen a las operaciones de la Selling Partner API correspondientes. Consulte Asignación de API de Amazon MWS a la Selling Partner API para determinar qué operaciones de Selling Partner API se corresponden con qué operaciones de Amazon MWS.

🚧

No genere nuevos LWA refresh tokens para cada llamada a SP-API

La Authorization API es para migrar la autorización de MWS a SP-API una vez por autorización. No debe usarse repetidamente para obtener nuevos LWA refresh tokens para cada llamada de SP-API. Se debe almacenar y reutilizar un LWA refresh token para obtener access tokens para llamadas posteriores.

Paso 10. Convierta su aplicación hybrid Selling Partner API en una aplicación completa de API de selling partner

1. Convierta su aplicación SP-API híbrida en una aplicación SP-API pura (es decir, tenga SP-API como el único Tipo de API):
   • En la página Central de desarrolladores , busque su aplicación. Elija el menú desplegable Editar aplicación y luego elija Editar listado .
   • En el formulario registro de la aplicación, para el Tipo de API, elija SP-API .
   • Envíe el formulario.
2. Vuelva a publicar la aplicación:
   • En la página Central de desarrolladores , busque su aplicación. Elija Editar listado .
   • Complete el formulario de listings y Envíe .
3. Notifique a sus sellers sobre el nuevo flujo de trabajo de autorización.
   Nota: Después de cambiar a una aplicación SP-API completa, el antiguo flujo de trabajo de autorización de MWS no será compatible.