Roles en la Selling Partner API

Cómo se utilizan los roles en la Selling Partner API.

Roles en la API de selling partner

¿Qué es un rol?

Un rol es el mecanismo que utilizan las API de Selling Partner para determinar si un desarrollador o una aplicación tiene acceso a una operación o recurso. Como desarrollador, debe solicitar y calificar para un rol en particular, o no podrá acceder a las operaciones y recursos agrupados bajo ese rol. Los roles protegen el acceso a la información de identificación personal (PII) y otros datos confidenciales, y limitan el acceso a los datos para garantizar que los desarrolladores solo accedan a los datos necesarios para una aplicación. Esto ayuda a garantizar que los clientes confíen en Amazon y en las empresas de Servicios para Selling Partner que emplean las API de Selling Partner.

Definiciones de roles

En la siguiente tabla, Restringido significa que el rol requiere información confidencial que puede incluir información de identificación personal (PII). Se le pedirá que proporcione información adicional sobre el uso que hace de los datos y sus controles de seguridad.

Role	Descripción
Análisis de marca	Acceda a reportes que contienen información sobre el desempeño de seller y vendor en Amazon e reportes de comportamiento del consumidor que brindan información sobre cómo los clientes encuentran y compran los productos de un Selling Partner en Amazon. Ejemplos de operaciones que requieren esta asignación de roles: La operación createReport de la API de Selling Partner para reportes, cuando se utiliza para solicitar el reporte GET_BRAND_ANALYTICS_SEARCH_TERMS_REPORT . Este reporte devuelve datos sobre los ASIN con más clics por palabra clave de búsqueda y departamento para un mercado. La operación createReport de la API de Selling Partner para reportes, cuando se utiliza para solicitar el reporte GET_PROMOTION_PERFORMANCE_REPORT . Este reporte devuelve datos de campañas de promoción para ayudar a los vendors y sellers a optimizar sus promociones y ajustar sus estrategias publicitarias. Consulte Brand Analytics para obtener una lista completa de las operaciones y los tipos de noticias, reportes y notificaciones que requieren este rol.
Listado de productos	Crear y administrar listados de productos. Generalmente se utiliza para reportes y fuentes relacionados con catálogos de productos y operaciones. Ejemplos de operaciones que requieren esta asignación de roles: La operación getCatalogItem de la API de Selling Partner para artículos de catálogo, que devuelve información sobre el artículo indicado y sus atributos. La operación createReport de la API de Selling Partner para reportes, cuando se utiliza para solicitar el reporte GET_MERCHANT_LISTINGS_INACTIVE_DATA . Este reporte devuelve listados inactivos detallados. La operación getMyFeesEstimateForSKU de la API de Selling Partner para tarifas de productos, que devuelve las tarifas estimadas para el artículo indicado. Consulte la lista de productos para obtener una lista completa de las operaciones y los tipos de noticias, reportes y notificaciones que requieren este rol.
Precios	Determine los precios de lista y automatice los precios de los productos. Generalmente se utiliza para reportes, feeds y operaciones relacionados con precios. Ejemplos de operaciones que requieren esta asignación de roles: La operación createFeed de la API de Selling Partner para feeds cuando se utiliza para enviar un feed RFQ_UPLOAD_FEED . Esto le permite cargar descuentos por cantidad en respuesta a solicitudes de clientes comerciales. La operación getPricing de Selling Partner API para precio, que devuelve información de precios para las listas de ofertas de un seller. La operación createReport de la API de Selling Partner para reportes, cuando se utiliza para solicitar el reporte GET_MERCHANT_CANCELLED_LISTINGS_DATA . Este reporte devuelve listados cancelados. Consulte precios para obtener una lista completa de las operaciones y los tipos de noticias, reportes y notificaciones que requieren este rol.
Amazon Fulfillment	Envíe a Amazon, y Amazon envía directamente a los clientes (Fulfillment by Amazon (FBA), Amazon Fulfillment Network (AFN)). Generalmente se usa para reportes de ventas de Logística de Amazon, reportes de seguimiento de pedidos y operaciones relacionadas con el cumplimiento de pedidos. Ejemplos de operaciones que requieren esta asignación de roles: La operación createReport de la API de Selling Partner para reportes, cuando se utiliza para solicitar el reporte GET_FBA_ESTIMATED_FBA_FEES_TXT_DATA . Este reporte contiene tarifas estimadas de venta y Fulfillment de Amazon. La operación getSubscription de la API de Selling Partner para notificaciones cuando se usa para suscribirse a las notificaciones FBA_OUTBOUND_SHIPMENT_STATUS . Estas notificaciones se envían cada vez que creamos o cancelamos un envío Logística de Amazon para un seller. La operación getLabels de la API de Selling Partner para Fulfillment Inbound, que devuelve etiquetas de paquetes/pallets(tarimas). La operación createFeed de la API de Selling Partner para fuentes cuando se utiliza para enviar una fuente POST_FBA_INBOUND_CARTON_CONTENTS . Esto le permite enviar información sobre el contenido de la caja al enviar el inventario a la red logística de Amazon. Consulte Logística de Amazon para obtener una lista completa de las operaciones y los tipos de noticias, reportes y notificaciones que requieren esta función.
Comunicación del comprador	Administre la mensajería hacia y desde los compradores de Amazon. Generalmente se usa para enviar mensajes a los compradores de Amazon usando la API de Selling Partner para mensajes. Ejemplos de operaciones que requieren esta asignación de roles: La operación getMessagingActionsForOrder de la API de Selling Partner para mensajería, que devuelve una lista de tipos de mensajes disponibles para un pedido específico. La operación createConfirmOrderDetails de la API de Selling Partner para mensajería, que envía un mensaje para hacerle al comprador una pregunta relacionada con el pedido antes del envío. La operación createConfirmDeliveryDetails de la API de Selling Partner para mensajería, que envía un mensaje a un comprador para organizar una entrega o confirmar la información de contacto para realizar una entrega. Consulte Comunicación con el comprador para obtener una lista completa de las operaciones y los tipos de noticias, reportes y notificaciones que requieren este rol.
Solicitación del comprador	Solicite comentarios a los compradores de Amazon. Generalmente se usa para solicitar comentarios a los compradores de Amazon utilizando la API de Selling Partner para solicitudes. Ejemplos de operaciones que requieren esta asignación de roles: La operación getSolicitationActionsForOrder de la API de Selling Partner para solicitudes, que devuelve una lista de tipos de solicitudes disponibles para un pedido. La operación createProductReviewAndSellerFeedbackSolicitation , que envía una solicitud a un comprador solicitando comentarios y una revisión del producto para un pedido. Consulte Solicitación del comprador para obtener una lista completa de las operaciones y los tipos de noticias, reportes y notificaciones que requieren este rol.
Perspectivas de Selling Partner	Ver información sobre la cuenta y el rendimiento del Selling Partner de Amazon. Generalmente se usa para reportes y operaciones que se usan para devolver información del seller. Ejemplos de operaciones que requieren esta asignación de roles: La operación createReport de la API de Selling Partner para reportes, cuando se utiliza para solicitar el reporte GET_V1_SELLER_PERFORMANCE_REPORT . Este reporte contiene métricas de rendimiento individuales del panel de control de Seller Central. La operación getMarketplaceParticipations de la API de Selling Partner para sellers, que devuelve una lista de mercados en los que un seller puede vender e información sobre la participación del seller en esos mercados. Consulte Información sobre Selling Partner para obtener una lista completa de las operaciones y los tipos de noticias, reportes y notificaciones que requieren esta función.
Finanzas y Contabilidad	Elaborar estados contables y financieros. Generalmente se utiliza para crear estados contables y financieros. Ejemplos de operaciones que requieren esta asignación de roles: La operación getReports de la API de Selling Partner para reportes, cuando se utiliza para devolver una lista de los reportes GET_V2_SETTLEMENT_REPORT_DATA_FLAT_FILE creados. La operación getSubscription de la API de Selling Partner para notificaciones, cuando se usa para devolver información sobre suscripciones al tipo de notificación FEE_PROMOTION . Consulte Finanzas y Contabilidad para obtener una lista completa de las operaciones y los tipos de feeds, reportes y notificaciones que requieren este rol.
Seguimiento de inventario y pedidos	Analizar y administrar el inventario. Generalmente se usa para reportes de ventas de Logística de Amazon, reportes de seguimiento de pedidos y operaciones relacionadas con pedidos, pedidos de vendors, métricas de pedidos de ventas y gestión de inventario. Las operaciones que requieren esta función no utilizan la PII necesaria para enviar un pedido. Más bien, este rol es necesario para las aplicaciones que rastrean envíos de pedidos para administrar inventario/fabricación/compras. Ejemplos de operaciones que requieren esta asignación de roles: La operación createReport de la API de Selling Partner para reportes, cuando se utiliza para solicitar el reporte GET_MERCHANT_LISTINGS_DATA . Este reporte devuelve listados activos detallados. La operación createFeed de la API de Selling Partner para feeds cuando se utiliza para enviar un feed POST_FLAT_FILE_FULFILLMENT_DATA . Esto le permite enviar información de cumplimiento de pedidos a Amazon. La operación getOrderMetrics de la API de Selling Partner para ventas, que devuelve métricas de pedidos agregadas. Consulte Seguimiento de inventario y pedidos para obtener una lista completa de las operaciones y los tipos de noticias, reportes y notificaciones que requieren esta función.
Envío directo al consumidor ( restringido )	Envíe los pedidos directamente a los clientes utilizando el transportista de su elección, incluido Amazon. Las operaciones que requieren este rol usan PII para habilitar el envío. Generalmente se utiliza para Reportes de pedidos, Reportes de seguimiento de pedidos, EasyShip y para operaciones relacionadas con el envío de pedidos realizados en Amazon. Ejemplos de operaciones que requieren esta asignación de roles: La operación getShipment de la API del Selling Partner para el cumplimiento del comerciante, que devuelve información de envío para un envío específico. La operación getOrders de la API de Selling Partner para pedidos, que devuelve una lista de pedidos e información de pedidos según los criterios especificados. La operación createReport de la API de Selling Partner para reportes, cuando se utiliza para solicitar el reporte GETFLAT_FILE ORDER_REPORT_DATA_SHIPPING . La operación createFeed de la API de Selling Partner para feeds, cuando se utiliza para enviar un feed POST_ORDER_FULFILLMENT_DATA . Este feed permite que su sistema actualice el sistema de Amazon con información de cumplimiento de pedidos. Consulte Envío directo al consumidor (restringido) para obtener una lista completa de las operaciones y los tipos de noticias, reportes y fuentes que requieren esta función.
Facturación de Impuestos ( Restringido )	Generar facturas fiscales para cumplir con la normativa tributaria. Las operaciones que requieren este rol requieren PII para habilitar la generación de facturas de impuestos. Generalmente se usa para Reportes de impuestos e Reportes de pedidos, y operaciones que devuelven información sobre pedidos. Ejemplos de operaciones que requieren esta asignación de roles: La operación createReport de la API de Selling Partner para reportes, cuando se utiliza para solicitar el reporte GET_AMAZON_FULFILLED_SHIPMENTS_INVOICING . Este reporte devuelve información detallada de pedido/envío/artículo. La operación getOrderAddress de la API de Selling Partner para pedidos, que devuelve la dirección de envío de un pedido. La operación getOrderBuyerInfo de la API de Selling Partner para pedidos, que devuelve la información del comprador de un pedido. La operación createReport de la API de Selling Partner para reportes, cuando se utiliza para solicitar el reporte GET_EASYSHIP_DOCUMENTS . Este reporte contiene la factura, la etiqueta de envío y los documentos de garantía de un pedido de Easy Ship. Consulte Facturación de impuestos (restringida) para obtener una lista completa de las operaciones y los tipos de noticias, reportes y fuentes que requieren esta función.
Remesa de Impuestos ( Restringida )	Calcular y remitir los impuestos sobre las ventas. Las operaciones que requieren esta función pueden usar PII para calcular los impuestos sobre las ventas. Generalmente se usa para reportes de ventas e reportes de pedidos de Logística de Amazon y operaciones que devuelven información sobre pedidos. Ejemplos de operaciones que requieren esta asignación de roles: La operación createReport de la API de Selling Partner para reportes, cuando se utiliza para solicitar el reporte GET_AMAZON_FULFILLED_SHIPMENTS_REMITTANCE . Este reporte devuelve información detallada de pedido/envío/artículo. La operación getOrderItems de la API de Selling Partner para pedidos, que devuelve información detallada del artículo de pedido para un pedido. La operación getOrders de la API de Selling Partner para pedidos, que devuelve una lista de información de artículos de pedido para un período de tiempo y un rango de criterios. Consulte Envío de impuestos (restringido) para obtener una lista completa de las operaciones y los tipos de noticias, reportes y fuentes que requieren esta función.

Preguntas frecuentes

¿Cómo solicito y califico para un rol?

Usted solicita y califica para los roles de la API de Selling Partner completando su perfil de desarrollador. La información específica solicitada depende de si ya es un desarrollador de Amazon Marketplace Web Service (MWS) o no, y si se ha registrado previamente.

Una vez que se envía su perfil, Amazon evalúa la información proporcionada y aprueba o rechaza su solicitud. Si se le deniega, puede abordar el motivo de la denegación y luego volver a enviar su perfil.

¿Cómo elijo los roles para mi aplicación?

Cuando crea su aplicación API de Selling Partners en la página de creación de cliente de la aplicación, puede elegir funciones entre las que se solicitaron y aprobaron en su perfil de desarrollador. Si falta el rol que necesita, debe actualizar los roles en su perfil de desarrollador para incluirlo y luego volver a enviar su perfil para que Amazon lo evalúe. Una vez aprobado, el rol agregado estará disponible para seleccionarlo para su aplicación.

Nota: Si tiene una aplicación SP-API híbrida publicada, debe volver a incluir su aplicación antes de la reautorización.

¿Cómo determino qué roles solicitar?

Revise las descripciones de roles en este documento para comprender el propósito de cada rol y ver ejemplos de los recursos y operaciones regidos por cada rol. Para cada función, use el enlace proporcionado para navegar a la documentación que proporciona una lista completa de las operaciones y los tipos de noticias, reportes y fuentes que requieren la función.

¿Qué sucede cuando llamo a una operación para la cual no tengo los roles requeridos?

La respuesta a la solicitud tendrá un código de estado HTTP de 403 e información de error en el cuerpo de la respuesta.

¿Cómo agrego un nuevo rol después de que se haya publicado mi aplicación?

Para agregar un nuevo rol después de que se haya publicado su aplicación, siga estos pasos:

Vaya a su perfil de desarrollador y envíe un rol para agregarlo.
Una vez que se haya aprobado su perfil de desarrollador , vaya a la configuración de su aplicación y aplique el rol recién aprobado a su aplicación. Guarde los cambios y vuelva a listar la aplicación.
Después de que se apruebe la aplicación, obtenga nuevas autorizaciones para generar un nuevo token de actualización que otorgará acceso a las operaciones, reportes, fuentes y notificaciones de la API que proporcionará el nuevo rol.

Updated over 1 year ago