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:
- The selling partner must authorize you to call the Selling Partner API (SP-API) on their behalf. For details about how selling partners can authorize an application to call the SP-API on their behalf, refer to Authorizing Selling Partner API Applications.
- Your developer profile must include the Finance and Accounting role. To learn about roles, refer to Roles in the Selling Partner API.
- The app registration page for your application must include the Finance and Accounting role.
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:
Nombre | Descripción | Schema |
---|---|---|
business | Información sobre el negocio del vendedor. En función de la del vendedor businessType , puede omitir ciertos campos. | Business |
businessType | El tipo de empresa para la que está registrada la cuenta de vendedor. | enum (BusinessType ) |
marketplaceParticipationList | Una lista de participaciones en el mercado. | < MarketplaceParticipationList > array |
primaryContact | Información sobre el contacto principal del vendedor. | PrimaryContact |
sellingPlan | Detalles 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:
- The selling partner must authorize you to call the Selling Partner API (SP-API) on their behalf. For details about how selling partners can authorize an application to call the SP-API on their behalf, refer to Authorizing Selling Partner API Applications.
- Your developer profile must include the Finance and Accounting role. To learn about roles, refer to Roles in the Selling Partner API.
- The app registration page for your application must include the Finance and Accounting role.
- The marketplace identifier of the marketplace for which you want data. For a list of marketplace identifiers, refer to Marketplace IDs.
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:
Nombre | Descripción | Schema |
---|---|---|
marketplaceParticipationList | Una 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
}
}
]
Updated about 2 months ago