Referencia de FBA Inbound Eligibility API v1
Permita que los sellers obtengan vistas previas de elegibilidad de los artículos antes de enviarlos a los centros logísticos de Amazon.
Descripción general
Con la FBA Inbound Eligibility API, puede crear aplicaciones que permitan a los sellers obtener vistas previas de elegibilidad de los artículos antes de enviarlos a los centros logísticos de Amazon. Con esta API, puede averiguar si un artículo es apto para el envío entrante a los centros logísticos de Amazon en un marketplace específico. También puede averiguar si un artículo es elegible para usar el código de barras del fabricante para el seguimiento de FBA inventory. Los sellers pueden usar esta información para fundamentar sus decisiones sobre qué artículos enviar a los centros logísticos de Amazon(Amazon's fulfillment centers).
Información de versión
Versión : v1
Información del contacto
Contacto : Soporte para desarrolladores Selling Partner API
URL de contacto : https://sellercentral.amazon.com/gp/mws/contactus.html
Información de licencia
Licencia : Licencia Apache 2.0
URL de la licencia : http://www.apache.org/licenses/LICENSE-2.0
esquema URI
Anfitrión : Sellingpartnerapi-na.amazon.com
Esquemas : HTTPS
consume
application/json
produce
application/json
Operaciones
Rutas
GET /fba/inbound/v1/eligibility/itemPreview
Operación: getItemEligibilityPreview
Descripción
Esta operación obtiene una vista previa de elegibilidad para un elemento que especifique. Puede especificar el tipo de vista previa de elegibilidad que desea (INBOUND o COMMINGLING). Para las vistas previas INBOUND, puede especificar el marketplace en el que desea determinar la elegibilidad del artículo.
Plan de uso:
| Tasa (solicitudes por segundo) | Burst |
|---|---|
| 1 | 1 |
El header de respuesta x-amzn-RateLimit-Limit devuelve los límites de tarifa del plan de uso que se aplicaron a la operación solicitada, cuando estén disponibles. La tabla anterior indica la tasa predeterminada y los valores de burst para esta operación. Los Selling partners cuyas demandas comerciales requieren un mayor rendimiento pueden ver valores de tasa y burst más altos que los que se muestran aquí. Para obtener más información, consulte Planes de uso y límites de tarifas en la API de Selling partners .
Parámetros
| Tipo | Nombre | Descripción | Esquema |
|---|---|---|---|
| Query | marketplaceIds opcional | El identificador del marketplace en el que desea determinar la elegibilidad. Requerido solo cuando program=INBOUND. Número máximo : 1 | < string > array |
| Query | asin requerido | El ASIN del artículo para el que desea una vista previa de elegibilidad. | string |
| Query | program requerido | El programa con el que desea verificar la elegibilidad. | enum ( Program ) |
Respuestas
| Código HTTP | Descripción | Esquema |
|---|---|---|
| 200 | Éxito. Headers : x-amzn-RateLimit-Limit (string): su límite de velocidad (solicitudes por segundo) para esta operación. x-amzn-RequestId (string): ID de referencia de solicitud única. | GetItemEligibilityPreviewResponse |
Para códigos de estado de error, descripciones y esquemas, consulte Respuestas y esquemas de error .
Respuestas de error y esquemas
Esta tabla contiene códigos de estado HTTP e información asociada para respuestas de error.
| Código HTTP | Descripción | Esquema |
|---|---|---|
| 400 | La solicitud tiene parámetros faltantes o no válidos y no se puede analizar. Headers : x-amzn-RateLimit-Limit (string): su límite de velocidad (solicitudes por segundo) para esta operación. x-amzn-RequestId (string): ID de referencia de solicitud única. | GetItemEligibilityPreviewResponse |
| 401 | El header de autorización de la solicitud no tiene el formato correcto o no contiene un token válido. Headers : x-amzn-RateLimit-Limit (string): su límite de velocidad (solicitudes por segundo) para esta operación. Nota: Para este código de estado, el header de límite de tasa está obsoleto y ya no se devuelve. x-amzn-RequestId (string): ID de referencia de solicitud única. | GetItemEligibilityPreviewResponse |
| 403 | 403 puede ser causado por razones como acceso denegado, no autorizado, token caducado, firma no válida o recurso no encontrado. Headers : x-amzn-RequestId (string): ID de referencia de solicitud única. | GetItemEligibilityPreviewResponse |
| 404 | El recurso especificado no existe. Headers : x-amzn-RateLimit-Limit (string): su límite de velocidad (solicitudes por segundo) para esta operación. x-amzn-RequestId (string): ID de referencia de solicitud única. | GetItemEligibilityPreviewResponse |
| 429 | La frecuencia de las solicitudes fue mayor a la permitida. Headers : x-amzn-RateLimit-Limit (string): su límite de velocidad (solicitudes por segundo) para esta operación. Nota: Para este código de estado, el header de límite de tasa está obsoleto y ya no se devuelve. x-amzn-RequestId (string): ID de referencia de solicitud única. | GetItemEligibilityPreviewResponse |
| 500 | Se encontró una condición inesperada que impidió que el servidor cumpliera con la solicitud. Headers : x-amzn-RateLimit-Limit (string): su límite de velocidad (solicitudes por segundo) para esta operación. Nota: Para este código de estado, el header de límite de tasa está obsoleto y ya no se devuelve. x-amzn-RequestId (string): ID de referencia de solicitud única. | GetItemEligibilityPreviewResponse |
| 503 | Sobrecarga temporal o mantenimiento del servidor. Headers : x-amzn-RateLimit-Limit (string): su límite de velocidad (solicitudes por segundo) para esta operación. Nota: Para este código de estado, el header de límite de tasa está obsoleto y ya no se devuelve. x-amzn-RequestId (string): ID de referencia de solicitud única. | GetItemEligibilityPreviewResponse |
Definiciones
GetItemEligibilityPreviewResponse
El esquema de respuesta para la operación getItemEligibilityPreview.
| Nombre | Descripción | Esquema |
|---|---|---|
| payload opcional | La payload para la operación getItemEligibilityPreview. | ItemEligibilityPreview |
| errores opcional | Ocurrió una condición inesperada durante la operación GetItemEligibilityPreview. | ErrorList |
ItemEligibilityPreview
El objeto de respuesta que contiene el ASIN, el ID de marketplace si es necesario, el programa de elegibilidad, el estado de elegibilidad (booleano) y una lista de códigos de motivos de no elegibilidad.
| Nombre | Descripción | Esquema |
|---|---|---|
| asin requerido | El ASIN para el que se determinó la elegibilidad. | string |
| marketplaceId opcional | El marketplace para el cual se determinó la elegibilidad. | string |
| program requerido | El programa para el cual se determinó la elegibilidad. | enum ( Program ) |
| isEligibleForProgram requerido | Indica si el artículo es elegible para el programa. | booleano |
| ineligibilityReasonList opcional | Posibles códigos de motivos de inelegibilidad. | < enum ( IneligibilityReasonList ) > array |
ErrorList
Una lista de respuestas de error devueltas cuando una solicitud no se realiza correctamente.
Error
Respuesta de error devuelta cuando la solicitud no tiene éxito.
| Nombre | Descripción | Esquema |
|---|---|---|
| código requerido | Un código de error que identifica el tipo de error que ocurrió. | string |
| mensaje opcional | Un mensaje que describe la condición de error en un formato legible por humanos. | string |
| detalles opcional | Información adicional que puede ayudar a la persona que llama a comprender o solucionar el problema. | string |
IneligibilityReasonList
Posibles códigos de motivos de inelegibilidad.
Tipo : enum
| Valor | Descripción |
|---|---|
| FBA_INB_0004 | Faltan las dimensiones del paquete. A este producto le falta la información necesaria; las dimensiones deben proporcionarse en el embalaje original del fabricante. |
| FBA_INB_0006 | El SKU de este producto es desconocido o no se puede encontrar. |
| FBA_INB_0007 | Producto bajo revisión de mercancías peligrosas (hazmat). No tenemos suficiente información para determinar qué es el producto o qué viene para permitirnos completar nuestra revisión de mercancías peligrosas. Hasta que proporcione la información necesaria, los productos no estarán disponibles para la venta y no podrá enviar más unidades a los centros logísticos de Amazon. Deberá agregar más detalles a las listas de productos, como un título claro, viñetas, descripción e imagen. El proceso de revisión tarda 4 días hábiles. |
| FBA_INB_0008 | Producto bajo revisión de mercancías peligrosas (hazmat). Requerimos información detallada de la batería para clasificar correctamente el producto, y hasta que proporcione la información necesaria, los productos no estarán disponibles para la venta y no podrá enviar más unidades a los centros logísticos de Amazon. Descargue una hoja de exención para baterías y productos alimentados por batería disponible en varios idiomas en "Cargar documentos de mercancías peligrosas: hoja de datos de seguridad (SDS) o hoja de exención" en Seller Central y siga las instrucciones para enviarla a través de la misma página. El proceso de revisión tarda 4 días hábiles. |
| FBA_INB_0009 | Producto bajo revisión de mercancías peligrosas (hazmat). No tenemos suficiente información sobre mercancías peligrosas para clasificar correctamente el producto y hasta que no proporcione la información necesaria, los productos no estarán disponibles para la venta y no podrá enviar más unidades a los centros logísticos de Amazon. Proporcione una hoja de datos de seguridad (SDS) a través de "Cargar documentos de mercancías peligrosas: hoja de datos de seguridad (SDS) o hoja de exención" en Seller Central y asegúrese de que la SDS cumpla con todos los requisitos. El proceso de revisión tarda 4 días hábiles. |
| FBA_INB_0010 | Producto bajo revisión de mercancías peligrosas (hazmat). La información sobre mercancías peligrosas no coincide y, por lo tanto, el producto no se puede clasificar correctamente. Hasta que proporcione la información necesaria, los productos no estarán disponibles para la venta y no podrá enviar más unidades a los centros logísticos de Amazon. Proporcione documentos que cumplan con los requisitos a través de "Cargar documentos de artículos peligrosos: hoja de datos de seguridad (SDS) o hoja de exención" en Seller Central y asegúrese de que cumpla con todos los requisitos. El proceso de revisión demora 4 días hábiles, el producto seguirá sin cumplirse hasta que se complete el proceso de revisión. |
| FBA_INB_0011 | Producto bajo revisión de mercancías peligrosas (hazmat). Tenemos información sobre mercancías peligrosas incompleta, inexacta o contradictoria y no podemos clasificar correctamente el producto. Hasta que proporcione la información necesaria, los productos no estarán disponibles para la venta y no podrá enviar más unidades a los centros logísticos de Amazon. Proporcione documentos que cumplan con los requisitos a través de "Cargar documentos de artículos peligrosos: hoja de datos de seguridad (SDS) o hoja de exención" en Seller Central y asegúrese de que cumpla con todos los requisitos. El proceso de revisión demora 4 días hábiles y el producto seguirá sin cumplirse hasta que se complete el proceso de revisión. |
| FBA_INB_0012 | Producto bajo revisión de mercancías peligrosas (hazmat). Hemos determinado que hay información contradictoria del producto (título, viñetas, imágenes o descripción del producto) dentro de las páginas de detalles del producto o con otras ofertas del producto. Hasta que se corrija la información contradictoria, los productos no estarán disponibles para la venta y no podrá enviar más unidades a los centros logísticos de Amazon. Necesitamos que confirmes la información en la página de detalles del producto. El proceso de revisión demora 4 días hábiles. |
| FBA_INB_0013 | Producto bajo revisión de mercancías peligrosas (hazmat). Se requiere información adicional para completar el proceso de revisión de Hazmat. |
| FBA_INB_0014 | Producto bajo revisión de mercancías peligrosas (hazmat). El producto ha sido identificado como posible mercancía peligrosa. El proceso de revisión generalmente demora de 4 a 7 días hábiles y hasta que se complete el proceso de revisión, el producto no se puede completar y no se puede recibir en los centros logísticos de Amazon ni los clientes pueden pedirlo. Para obtener más información sobre mercancías peligrosas, consulte la página de ayuda "Guía de identificación de mercancías peligrosas (hazmat)"" en Seller Central. |
| FBA_INB_0015 | Mercancías peligrosas (Hazmat). El producto está regulado como imposible de cumplir y no elegible para la venta con Amazon. Le pedimos que se abstenga de enviar unidades adicionales en nuevos envíos. Tendremos que deshacernos de su inventario de mercancías peligrosas de acuerdo con los términos del Acuerdo de Amazon Business Services. Si tiene preguntas o inquietudes, comuníquese con Atención al seller dentro de los cinco días hábiles posteriores a este aviso. Para obtener más información sobre mercancías peligrosas, consulte la página de ayuda "Guía de identificación de mercancías peligrosas (hazmat)" en Seller Central. |
| FBA_INB_0016 | Mercancías peligrosas (Hazmat). El producto está regulado como mercancía peligrosa cumplible (Hazmat). Es posible que deba estar en el programa de mercancías peligrosas (Hazmat) de FBA para poder vender su producto. Para obtener más información sobre el programa de productos peligrosos (Hazmat) de FBA, comuníquese con Atención al seller. Para obtener más información sobre mercancías peligrosas, consulte la página de ayuda "Guía de identificación de mercancías peligrosas (hazmat)" en Seller Central. |
| FBA_INB_0017 | Este producto no existe en el catálogo del marketplace de destino. La información necesaria del producto deberá proporcionarse antes de que pueda recibirse. |
| FBA_INB_0018 | Falta la categoría del producto. Este producto debe tener una categoría especificada antes de que pueda enviarse a Amazon. |
| FBA_INB_0019 | Este producto debe tener un título antes de que pueda enviarse a Amazon. |
| FBA_INB_0034 | El producto no puede ser sin adhesivo, mezclado. Este producto debe ser eliminado. Puede enviar un nuevo inventario creando una nueva lista para este producto que requiera etiquetas de producto. |
| FBA_INB_0035 | El producto con fecha de caducidad/lote controlado debe etiquetarse. Este producto requiere etiquetado para ser recibido en nuestros centros logísticos. |
| FBA_INB_0036 | El producto con fecha de caducidad o lote controlado debe mezclarse. Este producto no puede enviarse a Amazon sin mezclarse. Esta condición de error no se puede corregir desde aquí. Este producto debe ser eliminado. |
| FBA_INB_0037 | Este producto no es elegible para ser enviado a nuestro centro logístico. No tiene todos los documentos fiscales requeridos. Si ya ha presentado documentos, espere hasta 48 horas para que se propaguen los datos. |
| FBA_INB_0038 | Amazon no puede cumplir con el ASIN principal. Puedes enviar este producto creando una lista con el ASIN secundario. |
| FBA_INB_0050 | Actualmente no hay ningún centro logístico en el país de destino capaz de recibir este producto. Elimine este producto del envío o comuníquese con Atención al seller si cree que se trata de un error. |
| FBA_INB_0051 | FBA bloqueó este producto y actualmente no se puede enviar a Amazon para su cumplimiento. |
| FBA_INB_0053 | El producto no es elegible en el marketplace de destino. Este producto no es elegible porque la opción de envío requerida no está disponible o porque el producto es demasiado grande o pesado. |
| FBA_INB_0055 | Producto no cumplible debido a restricciones de región de medios. Este producto tiene un código de región restringido para este marketplace. Este producto debe ser eliminado. |
| FBA_INB_0056 | El producto no es apto para la entrada. Los productos usados que no sean de medios no se pueden enviar a Amazon. |
| FBA_INB_0059 | Excepción desconocida. Este producto debe ser eliminado en este momento. |
| FBA_INB_0065 | El producto no puede ser sin adhesivo, mezclado. Este producto debe ser eliminado. Puede enviar un nuevo inventario creando una nueva lista para este producto que requiera etiquetas de producto. |
| FBA_INB_0066 | Excepción desconocida. Este producto debe ser eliminado en este momento. |
| FBA_INB_0067 | Producto no elegible para envío de carga. Este artículo no es elegible para el envío de carga con nuestro Servicio de envío global. Este artículo debe ser eliminado. |
| FBA_INB_0068 | Cuenta no configurada para productos con fecha de vencimiento o controlados por lote. Comuníquese con TAM si desea configurar su cuenta para manejar inventario con fecha de vencimiento o controlado por lote. Una vez configurado, podrá enviar este producto. |
| FBA_INB_0095 | El código de barras (UPC/EAN/JAN/ISBN) de este producto está asociado con más de un producto en nuestro sistema de cumplimiento. Este producto debe ser eliminado. Puede enviar un nuevo inventario creando una nueva lista para este producto que requiera etiquetas de producto. |
| FBA_INB_0097 | Mercancía peligrosa totalmente regulada. |
| FBA_INB_0098 | El comerciante no está autorizado para enviar artículos al marketplace de destino. |
| FBA_INB_0099 | Cuenta de seller cancelada anteriormente. |
| FBA_INB_0100 | No tienes la información fiscal requerida para enviar inventario a centros logísticos en México. |
| FBA_INB_0103 | Este es un producto con fecha de vencimiento/controlado por lote que no se puede manejar en este momento. |
| FBA_INB_0104 | El artículo requiere el código de barras del fabricante. Solo los productos NUEVOS pueden almacenarse en nuestros centros logísticos sin etiquetas de productos. |
| FBA_INB_0197 | El artículo requiere documentación de seguridad y cumplimiento. FBA no puede cumplir con los pedidos de este producto sin la documentación de seguridad y cumplimiento requerida. |
| UNKNOWN_INB_ERROR_CODE | Motivo de inelegibilidad desconocido. |
Program
Tipo : enum
Para usar con la(s) definición(es): ItemEligibilityPreview
El programa para el cual se determinó la elegibilidad.
| Valor | Descripción |
|---|---|
| INBOUND | Envío entrante. |
| COMMINGLING | Uso del código de barras del fabricante para el seguimiento del FBA inventory. |
Para usar con la(s) operación(es): getItemEligibilityPreview
El programa con el que desea verificar la elegibilidad.
| Valor | Descripción |
|---|---|
| INBOUND | - |
| COMMINGLING | - |
Updated over 1 year ago