Roles de la API del colaborador comercial

Obtén información sobre cómo usar los roles en la API de socios vendedores.

¿Qué es un rol?

Un rol es el mecanismo que utilizan las API del colaborador comercial para determinar si un desarrollador o una aplicación tienen acceso a una operación o recurso. Como desarrollador, debes solicitar un rol concreto y cumplir sus requisitos, de lo contrario no podrás acceder a las operaciones y los recursos agrupados en ese rol. Los roles protegen el acceso a la información de identificación personal (IIP) y a 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 de colaboradores comerciales que utilizan las API del colaborador comercial.

Definiciones de roles

En la tabla siguiente, Restringido significa que el rol requiere información confidencial que puede incluir información de identificación personal (IIP). Se te pedirá que proporciones información adicional sobre el uso que haces de los datos y tus controles de seguridad.

Rol Descripción
Brand Analytics Permite acceder a informes que contienen información sobre el rendimiento de vendedores y proveedores en Amazon y a los informes de comportamiento de los consumidores que proporcionan información sobre cómo los clientes encuentran y compran los productos de un colaborador comercial en Amazon. Estos son algunos ejemplos de operaciones que requieren esta asignación de rol:
  • El createReport funcionamiento de la API de informes de socios vendedores, cuando se utiliza para solicitar la GET_BRAND_ANALYTICS_SEARCH_TERMS_REPORT informe. Este informe muestra datos sobre los ASIN en los que más se ha hecho clic por palabra clave de búsqueda y departamento de una plataforma.
  • El createReport funcionamiento de la API de informes de socios vendedores, cuando se utiliza para solicitar la GET_PROMOTION_PERFORMANCE_REPORT informe. Este informe muestra datos de las campañas de promoción para ayudar a los vendedores y vendedores a optimizar sus promociones y ajustar sus estrategias publicitarias.
Consulta Brand Analytics para obtener una lista completa de las operaciones y los tipos de ficheros, informes y notificaciones que requieren este rol.

Listing de productos Permite crear y gestionar listings de productos. Suele utilizarse para informes, ficheros y operaciones relacionados con el catálogo de productos. Estos son algunos ejemplos de operaciones que requieren esta asignación de rol:
  • El getCatalogItem funcionamiento de la API de socios vendedores para los artículos del catálogo, que devuelve información sobre el artículo indicado y sus atributos.
  • El createReport funcionamiento de la API de informes de socios vendedores, cuando se utiliza para solicitar la GET_MERCHANT_LISTINGS_INACTIVE_DATA informe. Este informe muestra listados inactivos detallados.
  • El getMyFeesEstimateForSKU funcionamiento de la API de socios vendedores para las tarifas de productos, que devuelve las tarifas estimadas para el artículo indicado.
Consulta Listing de productos para obtener una lista completa de las operaciones y los tipos de ficheros, informes y notificaciones que requieren este rol.

Precios Permite determinar los precios de venta y automatizar los precios de los productos. Suele utilizarse para informes, ficheros y operaciones relacionados con los precios. Estos son algunos ejemplos de operaciones que requieren esta asignación de rol:
  • El createFeed funcionamiento de la API de socios vendedores para los feeds cuando se utiliza para enviar un RFQ_UPLOAD_FEED alimentar. Esto te permite subir descuentos por cantidad en respuesta a las solicitudes de clientes empresariales.
  • El getPricing funcionamiento de la API de precios de los socios vendedores, que muestra información sobre los precios de las ofertas de un vendedor.
  • El createReport funcionamiento de la API de informes de socios vendedores, cuando se utiliza para solicitar la GET_MERCHANT_CANCELLED_LISTINGS_DATA informe. Este informe muestra los anuncios cancelados.
Consulta Precios para obtener una lista completa de las operaciones y los tipos de ficheros, informes y notificaciones que requieren este rol.

Logística de Amazon Permite realizar envíos a Amazon y Amazon envía directamente a los clientes (Logística de Amazon, Red logística de Amazon). Se utiliza generalmente para los informes de ventas de Logística de Amazon, los informes de seguimiento de pedidos y las operaciones relacionadas con la gestión logística de pedidos. Estos son algunos ejemplos de operaciones que requieren esta asignación de rol:
  • El createReport funcionamiento de la API de informes de socios vendedores, cuando se utiliza para solicitar la GET_FBA_ESTIMATED_FBA_FEES_TXT_DATA informe. Este informe contiene las tarifas estimadas de venta y gestión logística de Amazon.
  • El getSubscription funcionamiento de la API de socios vendedores para las notificaciones cuando se utiliza para suscribirse a FBA_OUTBOUND_SHIPMENT_STATUS notificaciones. Estas notificaciones se envían cada vez que creamos o cancelamos un envío de Logística de Amazon para un vendedor.
  • El getLabels funcionamiento de la API de socios vendedores para Fulfillment Inbound, que devuelve etiquetas para paquetes o palés.
  • El createFeed funcionamiento de la API de socios vendedores para los feeds cuando se utiliza para enviar un POST_FBA_INBOUND_CARTON_CONTENTS alimentar. Esto te permite enviar información sobre el contenido de las cajas al enviar inventario a la red logística de Amazon.
Consulta Logística de Amazon para obtener una lista completa de las operaciones y los tipos de ficheros, informes y notificaciones que requieren este rol.

Comunicación con el comprador Gestiona los mensajes enviados y recibidos por compradores de Amazon. Suele utilizarse para enviar mensajes a los compradores de Amazon mediante la API del colaborador comercial para mensajería. Esos son algunos ejemplos de operaciones que requieren esta asignación de rol:
  • El getMessagingActionsForOrder funcionamiento de la API de mensajería para socios vendedores, que muestra una lista de los tipos de mensajes disponibles para un pedido específico.
  • El createConfirmOrderDetails funcionamiento de la API de mensajería para socios vendedores, que envía un mensaje para hacerle al comprador una pregunta relacionada con el pedido antes del envío.
  • El createConfirmDeliveryDetails funcionamiento de la API de mensajería para socios vendedores, que envía un mensaje al comprador para organizar la entrega o confirmar la información de contacto para realizar una entrega.
Consulta Comunicación con el comprador para obtener una lista completa de las operaciones y los tipos de ficheros, informes y notificaciones que requieren este rol.

Solicitud al comprador Solicita valoraciones a los compradores de Amazon. Suele utilizarse para solicitar valoraciones a los compradores de Amazon mediante la API del colaborador comercial para solicitudes. Estos son algunos ejemplos de operaciones que requieren esta asignación de rol:
  • El getSolicitationActionsForOrder funcionamiento de la API de socios vendedores para solicitudes, que muestra una lista de los tipos de solicitudes disponibles para un pedido.
  • El createProductReviewAndSellerFeedbackSolicitation operación, que envía una solicitud a un comprador pidiéndole su opinión y una reseña del producto para un pedido.
Consulta Solicitud al comprador para obtener una lista completa de las operaciones y los tipos de ficheros, informes y notificaciones que requieren este rol.

Información del colaborador comercial Permite consultar información sobre la cuenta y el rendimiento del colaborador comercial de Amazon. Suele utilizarse para los informes y las operaciones que se utilizan para obtener información sobre los vendedores. Estos son algunos ejemplos de operaciones que requieren esta asignación de rol:
  • El createReport funcionamiento de la API de informes de socios vendedores, cuando se utiliza para solicitar la GET_V1_SELLER_PERFORMANCE_REPORT informe. Este informe contiene las métricas de rendimiento individuales del panel de Seller Central.
  • El getMarketplaceParticipations funcionamiento de la API de socios vendedores para vendedores, que muestra una lista de las plataformas en las que un vendedor puede vender e información sobre la participación del vendedor en esas plataformas.
Consulta Información del colaborador comercial para obtener una lista completa de las operaciones y los tipos de ficheros, informes y notificaciones que requieren este rol.

Finanzas y contabilidad Permite generar estados contables y financieros. Normalmente se utiliza para crear estados contables y financieros. Estos son algunos ejemplos de operaciones que requieren esta asignación de rol:
  • El getReports funcionamiento de la API de socios vendedores para informes, cuando se utiliza para devolver una lista de GET_V2_SETTLEMENT_REPORT_DATA_FLAT_FILE informes creados.
  • El getSubscription funcionamiento de la API de notificaciones de socios vendedores, cuando se utiliza para devolver información sobre las suscripciones al FEE_PROMOTION tipo de notificación.
Consulta Finanzas y contabilidad para obtener una lista completa de las operaciones y los tipos de ficheros, informes y notificaciones que requieren este rol.

Seguimiento de inventario y pedidos Permite analizar y gestionar el inventario. Normalmente se utiliza para los informes de ventas de Logística de Amazon, los informes de seguimiento de pedidos y las operaciones relacionadas con los pedidos, los pedidos de proveedores, las métricas de los pedidos de ventas y la gestión del inventario. Las operaciones que requieren este rol no utilizan la información de identificación personal necesaria para enviar un pedido. Por el contrario, este rol es necesario para las aplicaciones que realizan un seguimiento de los envíos de pedidos para gestionar el inventario, la fabricación o las compras. Estos son algunos ejemplos de operaciones que requieren esta asignación de rol:
  • El createReport funcionamiento de la API de informes de socios vendedores, cuando se utiliza para solicitar la GET_MERCHANT_LISTINGS_DATA informe. Este informe muestra listados activos detallados.
  • El createFeed funcionamiento de la API de socios vendedores para los feeds cuando se utiliza para enviar un POST_FLAT_FILE_FULFILLMENT_DATA alimentar. Esto te permite enviar la información de gestión logística del pedido a Amazon.
  • El getOrderMetrics funcionamiento de la API de socios vendedores para ventas, que muestra las métricas agregadas de los pedidos.
Consulta Seguimiento de inventario y pedidos para obtener una lista completa de las operaciones y los tipos de ficheros, informes y notificaciones que requieren este rol.

Almacenamiento y distribución de Amazon Analyze and manage Amazon Warehousing and Distribution shipments and inventory. Generally used for interacting with AWD inventory information and shipment details using the Selling Partner API for Amazon Warehousing and Distribution. Examples of operations that require this role assignment:
  • El listInventory funcionamiento de la API de socios vendedores para Amazon Warehousing and Distribution, que muestra los niveles y estados del inventario de los productos en AWD.
  • El getInboundShipment operación, que devuelve detalles sobre el envío, como el estado y las cantidades recibidas, para su conciliación.
Consulte Almacenamiento y distribución de Amazon para obtener una lista completa de las operaciones y los tipos de feeds, informes y notificaciones que requieren esta función.
Notificaciones en Seller Central Send targeted notifications to sellers within Seller Central. Using the App Integrations API v2024-04-01, you can send notifications that inform the seller about their business or to encourage the seller to take action on your website. Examples of operations that require this role assignment:
  • El createNotification La operación crea y envía una notificación a los vendedores con información relevante para su negocio.
  • El deleteNotifications la operación elimina una notificación que se envió anteriormente a un vendedor.
Para obtener una lista completa de las operaciones que requieren este rol, consulte la Notificaciones en el rol de Seller Central.
Proveedor de servicios de iniciación de pagos Permite iniciar un pago mediante el método de depósito del vendedor y emitir un reembolso (ajuste) para un pedido. Puedes usar la función de proveedor de servicios de iniciación de pagos (PISP) para ver los métodos de pago del vendedor.
Para obtener una lista completa de las operaciones y los tipos de feeds, informes y notificaciones que requieren esta función, consulte Proveedor de servicios de iniciación de pagos.
Para obtener información sobre el registro de desarrolladores de proveedores externos, consulte Registro de proveedores externos.
Proveedor de servicios de información de cuentas Proporciona información sobre la cuenta de socio vendedor de Amazon, incluida información sobre la empresa del vendedor y los sitios web en los que está activa la cuenta de vendedor. Puedes usar la función de proveedor de servicios de información de cuentas (AISP) para ver los métodos de pago y los eventos financieros del vendedor.
Para obtener una lista completa de las operaciones y los tipos de feeds, informes y notificaciones que requieren esta función, consulte Proveedor de servicios de información de cuentas.
Para obtener información sobre el registro de desarrolladores de proveedores externos, consulte Registro de proveedores externos.
Envío directo al consumidor (restringido) Permite enviar los pedidos directamente a los clientes con el transportista que prefieran, incluido Amazon. Las operaciones que requieren este rol utilizan la información de identificación personal para habilitar el envío. Suele utilizarse para los informes de pedidos, los informes de seguimiento de pedidos, EasyShip y para las operaciones relacionadas con el envío de pedidos realizados en Amazon. Estos son algunos ejemplos de operaciones que requieren esta asignación de rol:
  • El getShipment funcionamiento de la API de socios vendedores para Merchant Fulfillment, que devuelve la información de envío de un envío específico.
  • El getOrders funcionamiento de la API de socios vendedores para pedidos, que devuelve una lista de pedidos e información sobre los pedidos en función de los criterios especificados.
  • El createReport funcionamiento de la API de informes de socios vendedores, cuando se utiliza para solicitar la GET_FLAT_FILE_ ORDER_REPORT_DATA_SHIPPING informe.
  • El createFeed funcionamiento de la API de socios vendedores para los feeds, cuando se utiliza para enviar un POST_ORDER_FULFILLMENT_DATA alimentar. Este fichero permite que tu sistema actualice el sistema de Amazon con la información de gestión logística de los pedidos.
Consulta Envío directo al consumidor (restringido) para obtener una lista completa de las operaciones y los tipos de ficheros, informes y notificaciones que requieren este rol.

Facturación fiscal (restringido) Permite generar facturas fiscales para cumplir con la normativa fiscal. Las operaciones que requieren este rol requieren información de identificación personal para permitir la generación de facturas fiscales. Por lo general, se utiliza para los informes fiscales y de pedidos, y para las operaciones que devuelven información sobre los pedidos. Estos son algunos ejemplos de operaciones que requieren esta asignación de rol:
  • El createReport funcionamiento de la API de informes de socios vendedores, cuando se utiliza para solicitar la GET_AMAZON_FULFILLED_SHIPMENTS_INVOICING informe. Este informe muestra información detallada sobre el pedido, el envío y el artículo.
  • El getOrderAddress funcionamiento de la API de socios vendedores para pedidos, que devuelve la dirección de envío de un pedido.
  • El getOrderBuyerInfo funcionamiento de la API de socios vendedores para pedidos, que devuelve la información del comprador de un pedido.
  • El createReport funcionamiento de la API de informes de socios vendedores, cuando se utiliza para solicitar la GET_EASYSHIP_DOCUMENTS informe. Este informe contiene la factura, la etiqueta de envío y los documentos de garantía de un pedido de Easy Ship.
Consulta Facturación fiscal (restringido) para obtener una lista completa de las operaciones y los tipos de ficheros, informes y notificaciones que requieren este rol.
Remesa de impuestos (restringido) Calculate and remit sales taxes. Operations that require this role might use PII to calculate sales taxes. Generally used for FBA Sales Reports and Order Reports and operations that return information about orders. Examples of operations that require this role assignment:
  • El createReport funcionamiento de la API de informes de socios vendedores, cuando se utiliza para solicitar la GET_AMAZON_FULFILLED_SHIPMENTS_REMITTANCE informe. Este informe muestra información detallada sobre el pedido, el envío y el artículo.
  • El getOrderItems funcionamiento de la API de socios vendedores para pedidos, que devuelve información detallada de los artículos de un pedido.
  • El getOrders funcionamiento de la API de socios vendedores para pedidos, que devuelve una lista con la información de los artículos del pedido según un período de tiempo y una serie de criterios.
Consulta Remesa de impuestos (restringido) para obtener una lista completa de las operaciones y los tipos de ficheros, informes y notificaciones que requieren este rol.
Servicios profesionales (Restricto) Provides add-on services such as Room of Choice Delivery, Assembly and Installation to Amazon buyers. Generally used to provide add-on services to Amazon buyers using the Selling Partner API for Services. Examples of operations that require this role assignment:
  • El getServiceJobs funcionamiento de la API de socios vendedores para servicios, que devuelve una lista de los detalles de los trabajos de servicio para la consulta de filtro especificada.
  • El addAppointmentForServiceJobByServiceJobId operación, que agrega una cita al trabajo de servicio indicado por el identificador del trabajo de servicio especificado.
Consulte Servicios profesionales para obtener una lista completa de las operaciones y los tipos de feeds, informes y notificaciones que requieren esta función.

Preguntas frecuentes

¿Cómo puedo solicitar un rol y cumplir sus requisitos?

Para solicitar y cumplir los requisitos para ocupar las funciones de la API de socio vendedor, debes rellenar tu perfil de desarrollador. La información específica que se solicita depende de si te has registrado previamente.

Una vez enviado tu perfil, Amazon evalúa la información proporcionada y aprueba o deniega la solicitud. Si se deniega, puedes responder al motivo de la denegación y volver a enviar el perfil.

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

Al crear tu aplicación de API del colaborador comercial en la página de creación del cliente de la aplicación, puedes elegir roles entre los que se solicitaron y aprobaron en tu perfil de desarrollador. Si falta el rol que necesitas, debes actualizarlo en tu perfil de desarrollador para incluirlo y, a continuación, volver a enviar tu perfil para que Amazon lo evalúe. Una vez aprobado, podrás seleccionar el rol añadido para la aplicación.

Nota: si tienes una aplicación híbrida de la SP-API publicada, debes volver a publicarla antes de volver a autorizarla.

¿Cómo determino qué roles solicitar?

Revisa las descripciones de los roles de este documento para comprender la finalidad de cada rol y ver ejemplos de los recursos y las operaciones que se rigen por cada uno. Para cada rol, utiliza el enlace proporcionado para acceder a la documentación que proporciona una lista completa de las operaciones y los tipos de ficheros, informes y notificaciones que requieren el rol.

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

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

¿Cómo puedo añadir un nuevo rol después de publicar mi aplicación?

Para añadir un nuevo rol después de publicar tu aplicación, sigue estos pasos:

  1. Ve a tu perfil de desarrollador y envía un rol para añadirlo.
  2. Una vez que se haya aprobado tu perfil de desarrollador, ve a la configuración de tu aplicación y aplica el rol recién aprobado a la aplicación. Guarda los cambios y vuelve a publicar la aplicación.
  3. Una vez aprobada la aplicación, obtén nuevas autorizaciones para generar un nuevo token de actualización que concederá acceso a las operaciones, informes, ficheros y notificaciones de la API que proporcionará el nuevo rol.

¿Te ha ayudado esta página?