Guía de casos de uso de la API para vendedores v1

Recupera la información de la cuenta de vendedor y del mercado.

Versión de API: v1

¿Qué es la API para vendedores?

The Selling Partner API for Sellers (Sellers API) provides information about seller accounts and marketplaces. The returned information includes:

  • Los sitios web en los que el vendedor puede publicar artículos
  • El idioma y la moneda predeterminados de un mercado
  • Si el vendedor ha suspendido los listados
  • Información comercial del vendedor

For details about the operations, data types, and schemas of the Sellers API, refer to Sellers API v1 Reference.

Tutorial: Obtén la información de la cuenta de un vendedor (solo en la UE)

Obtén información sobre cómo recuperar la información de la cuenta de un vendedor. La información que recuperas incluye una lista de participaciones en el mercado, información empresarial y detalles del plan de ventas. Solo está disponible en la región de la UE.

Requisitos

Para completar este tutorial, debe cumplir los siguientes requisitos previos:

Obtenga información de la cuenta

Call the getAccount operation.

Parámetros de solicitud

Ninguna.

Ejemplo de solicitud

GET /sellers/v1/account

Propiedades de la respuesta

Una respuesta correcta incluye las siguientes propiedades:

NombreDescripciónSchema
businessInformación sobre el negocio del vendedor. En función de la del vendedor businessType, puede omitir ciertos campos.Business
businessTypeEl tipo de empresa para la que está registrada la cuenta de vendedor.enum (BusinessType)
marketplaceParticipationListUna lista de participaciones en el mercado.< MarketplaceParticipationList> array
primaryContactInformación sobre el contacto principal del vendedor.PrimaryContact
sellingPlanDetalles del plan de ventas.enum (SellingPlan)

Ejemplo de respuesta

{ "businessType": "PRIVATE_LIMITED", "marketplaceParticipationList": [ { "marketplace": { "id": "ATVPDKIKX0DER", "name": "United States", "countryCode": "US", "domainName": "www.amazon.com" }, "storeName": "BestSellerStore", "participation": { "isParticipating": true, "hasSuspendedListings": false } } ], "sellingPlan": "PROFESSIONAL", "business": { "name": "BestSeller Inc.", "nonLatinName": "ベストセラー株式会社", "registeredBusinessAddress": { "addressLine1": "123 Main St", "addressLine2": "Suite 500", "city": "Seattle", "stateOrProvinceCode": "WA", "postalCode": "98101", "countryCode": "US" }, "companyRegistrationNumber": "123456789", "companyTaxIdentificationNumber": "987654321" }, "primaryContact": { "name": "John Doe", "nonLatinName": "ジョン・ドゥ", "address": { "addressLine1": "456 Oak St", "addressLine2": "Apt 12", "city": "Seattle", "stateOrProvinceCode": "WA", "postalCode": "98102", "countryCode": "US" } } }

Tutorial: Obtén la participación de un vendedor en el mercado

Obtén información sobre cómo obtener una lista de las plataformas de Amazon en las que el vendedor puede publicar artículos. La información que recuperas incluye información de la plataforma, el nombre de la tienda del vendedor en la plataforma, si el vendedor participa en la plataforma y si el vendedor ha suspendido los listados en la plataforma.

Requisitos

Para completar este tutorial, debe cumplir los siguientes requisitos previos:

Obtenga participación en el mercado

Call the getMarketplaceParticipations operation.

Parámetros de solicitud

Ninguna.

Ejemplo de solicitud

GET /sellers/v1/marketplaceParticipations

Respuesta

Una respuesta correcta incluye los siguientes elementos:

NombreDescripciónSchema
marketplaceParticipationListUna lista de las plataformas de Amazon en las que el vendedor puede publicar artículos y los clientes pueden ver y comprar artículos.< MarketplaceParticipationList> array

Ejemplo de respuesta

[ { "marketplace": { "id": "ATVPDKIKX0DER", "name": "Amazon.com", "countryCode": "US", "defaultCurrencyCode": "USD", "defaultLanguageCode": "en_US", "domainName": "www.amazon.com" }, "storeName": "BestSellerStore", "participation": { "isParticipating": true, "hasSuspendedListings": false } } ]

¿Te ha ayudado esta página?