Solucionar problemas de cuentas de vendedor
Obtén información sobre cómo solucionar los errores de API en las cuentas de vendedor.
En este tema se describe cómo solucionar problemas relacionados con una cuenta de vendedor cuando se produce un error en la API. El uso de los siguientes métodos de solución de problemas puede ayudarte a detectar errores y a lograr que una llamada a la API entre SP-API y Seller Central se transmita correctamente.
Las API de los socios vendedores proporcionan mensajes de error que ayudan a rastrear los errores. Tanto los problemas con la cuenta como las llamadas incorrectas a la API pueden provocar un error. En el siguiente ejemplo, el 400
respuesta de error del createFeed
la operación se debió a un problema con la cuenta inactiva.
{
"errors": [
{
"code": "InvalidInput",
"message": "Invalid request parameters",
"details": ""
}
]
}
Código de error | Causa | Pasos para su resolución |
---|---|---|
400 | La respuesta del | El vendedor debe comprobar el estado de su cuenta en esta plataforma. Ten en cuenta que el |
Solución de problemas de un error de API
Cuando recibas un mensaje de error de la API, querrás determinar si se debe a un problema con la cuenta. Comprueba las siguientes condiciones:
- ¿Hay algún problema con la solicitud en sí?
- ¿Todos los vendedores tienen el mismo problema?
- ¿El vendedor está activo en el sitio web de Amazon designado?
El siguiente diagrama de flujo puede ayudarte a determinar el curso de acción más adecuado.
Cómo determinar la causa de un error de la API
Cuando recibes un error de la API, y el mensaje de error no contiene suficiente información para ayudar a detectar el problema inmediatamente, lo primero que hay que comprobar es el código de estado HTTP. Un código de estado 200
significa que la llamada a la API se ha realizado correctamente. Si el código de estado es de clase 400
o 500
, la llamada a la API habrá fallado.
Por ejemplo, la API getOrders
devuelve una clase 200
, pero la respuesta es una lista vacía. En este caso, la llamada a la API se ha realizado correctamente.
Para obtener la respuesta correcta de la API, comprueba los parámetros de solicitud correspondientes. Por ejemplo, comprueba si se supone que el intervalo de fechas especificado en el parámetro de consulta no tiene pedidos.
El 500
class revela un error interno del servidor que indica que el servidor de Amazon no ha podido atender una solicitud. Sin embargo, para algunas API específicas, como la getListingOffersBatch
operación, si el parámetro URI incorrecto está presente en el cuerpo de la solicitud, la respuesta es 500
en lugar de 400
.
Los siguientes documentos técnicos cubren las estrategias de optimización y solución de problemas relacionadas con 429
y 403
Códigos de estado HTTP:
- Estrategias para optimizar los límites de velocidad para las cargas de trabajo de las aplicaciones
- Errores de autorización
Si el problema persiste, comprueba tus funciones y fichas.
Paso 1: Comprueba los roles y los tokens
Tras confirmar el error, si el código y los mensajes de error no proporcionan soluciones, ponte en contacto con el equipo de ingeniería para determinar si algún cambio reciente en el código podría haber provocado un error en la llamada a la API. Comprueba los parámetros del rol y del token, especialmente cuando utilices una API nueva.
Roles
Al comprobar los parámetros de los roles, asegúrese de que la aplicación tenga rol correcto para la llamada a la API. Por ejemplo, algunos informes analíticos para propietarios de marcas (como el GET_BRAND_ANALYTICS_ALTERNATE_PURCHASE_REPORT
el informe, que está disponible en las regiones de NA, UE y FE) requiere el Función de análisis de marca. Además, asegúrese de que la función se aplique tanto al perfil del desarrollador como a la aplicación, o a 403
se puede producir un error.
Tokens de acceso
A continuación, compruebe los tokens de acceso. Hay tres tipos principales de tokens de acceso que se basan en el tipo de solicitud de API.
- El token de acceso
El token de acceso es el más utilizado en las llamadas a la SP-API. Si incluyes la clave refreshToken
en el parámetro de consulta de la operación LWA
, el token de acceso aparecerá en la respuesta.
- Token de acceso para operaciones sin concesión
El token de acceso para las operaciones de Grantless solo se usa para grantless operations
.
Asegúrate de incluir el parámetro de scope
en el parámetro de LWA operation
, especificando SCOPE_NOTIFICATIONS_API
para la API de Notifications
o SCOPE_MIGRATION_API
para la API de Authorization
.
- Token de datos restringidos
Un token de datos restringidos (RDT) solo se usa para obtener datos de información de identificación personal, como la dirección de envío, el nombre del comprador o la información relacionada con los impuestos.
Un token de datos restringidos solo puede obtenerse a través de la API de Tokens
. Por ejemplo, si un desarrollador necesita obtener información sobre la dirección de envío de la respuesta de la API de getOrders
, primero debe utilizar el código de acceso para solicitar un token de datos restringidos a través de la API de Tokens
y, a continuación, utilizar el token de datos restringidos de la respuesta como código de acceso para llamar a la API de getOrders
.
Al adoptar una nueva API, la mejor práctica es usar Postman y empezar con una simple llamada a la API con los parámetros mínimos. Cuando sea posible, usa solo los parámetros obligatorios. Asegúrese de que la llamada a la API se haya realizado correctamente y, a continuación, añada las opciones una por una para evitar conflictos entre los parámetros opcionales.
Después de comprobar las funciones y los símbolos, compruebe las rutas.
Paso 2: Comprueba las rutas
Comprobar las rutas te permite distinguir si un error se debe a problemas con la cuenta de vendedor.
Para determinar si los vendedores reciben el mismo error, te recomendamos registrar constantemente lo siguiente para cada solicitud HTTP.
- Ruta de recursos
- Código de estado
- Mensaje de error
- ID del vendedor (ID del vendedor)
- ID de sitio web
Al registrar esta información, estás creando registros que puedes revisar en cualquier momento para ayudarte a identificar problemas con tu cuenta. Esta información del mercado se usa en Paso 3.
Cuando se produce un error, comprueba la ruta de recursos de la API para identificar la operación de la API y, a continuación, filtra el registro de esta ruta de recursos para determinar cuántos vendedores tienen un estado de error.
Si un servicio tiene problemas de backend, el error aparece para todos los vendedores. El mensaje de error indica que hay un problema con la cuenta si solo un vendedor, o un grupo limitado de vendedores, lo detecta. Si solo algunos vendedores reciben un mensaje de error, tendrás que realizar más depuraciones para encontrar el problema. Si comparas el número de veces que se produce el mismo error, puedes determinar aproximadamente si el siguiente paso para solucionar el problema es continuar Paso 3 o para contactar con los vendedores.
Paso 3: Determina el mercado afectado
El último paso es comprobar cuál mercado en la que participa el vendedor, para la cuenta que provocó el error.
Los errores en las llamadas a la API pueden deberse a que los vendedores te han proporcionado información de cuenta incorrecta. Para evitarlo, usa el getMarketplaceParticipations
operación para determinar en qué plataformas participa un vendedor.
Si ves alguna de las siguientes respuestas, vuelve a comprobar con el vendedor su cuenta en este sitio web o pídele que vuelva a autorizarla:
403
+Unauthorized
.- El mercado esperado no se incluye en la respuesta.
- El valor del
isParticipating
el campo en este mercado esfalse
.
Ejemplo de respuesta para la región del Lejano Oriente (FE):
{
"payload": [
{
"marketplace": {
"id": "A1VC38T7YXB528",
"countryCode": "JP",
"name": "Amazon.co.jp",
"defaultCurrencyCode": "JPY",
"defaultLanguageCode": "ja_JP",
"domainName": "www.amazon.jp (http://www.amazon.jp/)“
},
"participation": {
"isParticipating": true,
"hasSuspendedListings": false
}
},
{
"marketplace": {
"id": "A1VN0HAN483KP2",
"countryCode": "JP",
"name": "Non-Amazon",
"defaultCurrencyCode": "JPY",
"defaultLanguageCode": "ja_JP",
"domainName": "jp-shipment-injection.stores.amazon.co.jp"
},
"participation": {
"isParticipating": true,
"hasSuspendedListings": false
}
}
]
}
También debes comprobar si la API está disponible para el sitio web, especialmente para las operaciones de la API de informes, la API de ficheros y la API de notificaciones, porque no todas las rutas de recursos están disponibles para todos los sitios web.
Para determinar el sitio web al que asiste una API, consulta la documentación sobre el tipo de ficheros, el tipo de informe y el tipo de notificación.
Una forma de ayudar a prevenir problemas con la cuenta es configurar las API para que te ayuden a supervisar la cuenta.
Uso de las API para evitar problemas con las cuentas
Saber si un vendedor tiene un problema con la cuenta antes de realizar la llamada a la API es útil para evitar errores de API innecesarios. Hay dos API que puedes solicitar para supervisar el estado de una cuenta.
-
API de tipo de notificación
ACCOUNT_STATUS_CHANGED
Se envía una notificación cada vez que cambia el estado de la cuenta de los pares vendedor/sitio web. Al implementar este tipo de notificación, los desarrolladores recibirán una notificación cada vez que el estado de la cuenta del vendedor cambie entreNORMAL
,AT_RISK
oDEACTIVATED
. Ve a Información de la cuenta de vendedor desde Seller Central si se notifica que elcurrentAccountStatus
no esNORMAL
. -
GET_V2_SELLER_PERFORMANCE_REPORT
Informe
Este tipo de informe contiene datos de métricas de rendimiento individuales del panel de estado de la cuenta de Seller Central. Proporcionamos una respuesta similar a la del siguiente ejemplo. Sin embargo, no debe confiar en este formato.
{
"accountStatuses":[
{
"marketplaceId":"A1VC38T7YXB528",
"status":"NORMAL"
}
],
"performanceMetrics":[
{
"lateShipmentRate":{},
"invoiceDefectRate":{},
"orderDefectRate":{
"afn":{},
"mfn":{}
},
"onTimeDeliveryRate":{},
"validTrackingRate":{},
"preFulfillmentCancellationRate":{},
"warningStates":[],
"accountHealthRating":{},
"listingPolicyViolations":{},
"productAuthenticityCustomerComplaints":{},
"productConditionCustomerComplaints":{},
"productSafetyCustomerComplaints":{},
"receivedIntellectualPropertyComplaints":{},
"restrictedProductPolicyViolations":{},
"suspectedIntellectualPropertyViolations":{},
"foodAndProductSafetyIssues":{},
"customerProductReviewsPolicyViolations":{},
"otherPolicyViolations":{},
"documentRequests":{},
"marketplaceId":"A1VC38T7YXB528"
}
]
}
Llama periódicamente a GET_V2_SELLER_PERFORMANCE_REPORT
y comprueba el primer nivel del objeto performanceMetrics
. Incluye las métricas de la cuenta , cada una con información del estado.
Si alguna métrica no está en estado GOOD
, comprueba el estado de la cuenta del vendedor en Seller Central para obtener más información. Consulta la guía de usuario de la API de informes para obtener más información sobre la adopción de esta API.
Al combinar el uso de las API ACCOUNT_STATUS_CHANGED
y GET_V2_SELLER_PERFORMANCE_REPORT
con la API de Sellers API
, puedes determinar en qué sitios web participó el vendedor, si la cuenta está activa en este sitio web y si hay indicios de un mal rendimiento de la cuenta.
El siguiente diagrama de flujo describe las mejores prácticas para el diseño de sistemas con respecto a la prevención de problemas con las cuentas.
Updated 8 months ago