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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
- Ve a tu perfil de desarrollador y envía un rol para añadirlo.
- 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.
- 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.
Updated 27 days ago