Referencia de la FBA Small and Light API v1

Administra las listas en el programa Small and Light.

Descripción general

La Selling Partner API for FBA Small and Light le permite ayudar a los sellers a administrar sus listados en el programa Small and Light. El programa reduce el costo de cumplir con los pedidos de FBA inventory Small and Light. Puede inscribir o eliminar artículos del programa y verificar la elegibilidad del artículo y el estado de inscripción. También puede obtener una vista previa de las tarifas estimadas del programa cobradas a un seller por los artículos vendidos mientras estaba inscrito en el programa.

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

getSmallAndLightEnrollmentBySellerSKU
putSmallAndLightEnrollmentBySellerSKU
deleteSmallAndLightEnrollmentBySellerSKU
getSmallAndLightEligibilityBySellerSKU
getSmallAndLightFeePreview

Rutas

GET /fba/smallAndLight/v1/enrollments/{sellerSKU}

Operación: getSmallAndLightEnrollmentBySellerSKU

Descripción

Devuelve el estado de inscripción de artículos Small and Light para el artículo indicado por el SKU del seller especificado en el marketplace especificado.

Plan de uso:

Tasa (solicitudes por segundo)	Burst
2	10

El x-amzn-RateLimit-Limit El header de respuesta 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 Selling Partner API .

Parámetros

Tipo	Nombre	Descripción	Esquema
Path	sellerSKU requerido	El SKU del seller que identifica el artículo.	string
Query	marketplaceIds requerido	El marketplace para el que se recupera el estado de inscripción. Nota: Solo acepta un único marketplace. Número máximo : 1	< string > array

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) : Identificador de referencia de solicitud único.	Inscripción SmallAndLight

Para códigos de estado de error, descripciones y esquemas, consulte Respuestas y esquemas de error .

PUT /fba/smallAndLight/v1/enrollments/{sellerSKU}

Operación: putSmallAndLightEnrollmentBySellerSKU

Descripción

Inscribe el artículo indicado por el SKU del seller especificado en el programa Small and Light en el marketplace especificado. Si el artículo no es elegible, se devuelven las razones de no elegibilidad.

Plan de uso:

Tasa (solicitudes por segundo)	Burst
2	5

Parámetros

Tipo	Nombre	Descripción	Esquema
Path	sellerSKU requerido	El SKU del seller que identifica el artículo.	string
Query	marketplaceIds requerido	El marketplace en el que inscribir el artículo. Nota: Solo acepta un único marketplace. Número máximo : 1	< string > array

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) : Identificador de referencia de solicitud único.	Inscripción SmallAndLight

Para códigos de estado de error, descripciones y esquemas, consulte Respuestas y esquemas de error .

DELETE /fba/smallAndLight/v1/enrollments/{sellerSKU}

Operación: deleteSmallAndLightEnrollmentBySellerSKU

Descripción

Elimina el artículo indicado por el SKU del seller especificado del programa Small and Light en el marketplace especificado. Si el artículo no es elegible para la desafiliación, se devuelven los motivos de no elegibilidad.

Plan de uso:

Tasa (solicitudes por segundo)	Burst
2	5

Parámetros

Tipo	Nombre	Descripción	Esquema
Path	sellerSKU requerido	El SKU del seller que identifica el artículo.	string
Query	marketplaceIds requerido	El marketplace en el que eliminar el artículo del programa Small and Light. Nota: Solo acepta un único marketplace. Número máximo : 1	< string > array

Respuestas

Código HTTP	Descripción	Esquema
204	Éxito. Headers : `x-amzn-RateLimit-Limit` (string) : Su límite de velocidad (solicitudes por segundo) para esta operación. `x-amzn-RequestId` (string) : Identificador de referencia de solicitud único.	Sin contenido

Para códigos de estado de error, descripciones y esquemas, consulte Respuestas y esquemas de error .

GET /fba/smallAndLight/v1/eligibilities/{sellerSKU}

Operación: getSmallAndLightEligibilityBySellerSKU

Descripción

Devuelve el estado de elegibilidad del programa Small and Light del artículo indicado por el SKU del seller especificado en el marketplace especificado. Si el artículo no es elegible, se devuelven las razones de no elegibilidad.

Plan de uso:

Tasa (solicitudes por segundo)	Burst
2	10

Parámetros

Tipo	Nombre	Descripción	Esquema
Path	sellerSKU requerido	El SKU del seller que identifica el artículo.	string
Query	marketplaceIds requerido	El marketplace para el que se recupera el estado de elegibilidad. NOTA: Solo acepta un único marketplace. Número máximo : 1	< string > array

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) : Identificador de referencia de solicitud único.	SmallAndLightEligibility

Para códigos de estado de error, descripciones y esquemas, consulte Respuestas y esquemas de error .

POST /fba/smallAndLight/v1/feePreviews

Operación: getSmallAndLightFeePreview

Descripción

Devuelve las estimaciones de tarifas de artículos Small and Light para los artículos especificados. Debe incluir un parámetro marketplaceId para recuperar las estimaciones de tarifas adecuadas para los artículos que se venderán en ese marketplace. El orden de los elementos en la respuesta reflejará el orden de los elementos en la solicitud. Se eliminan las combinaciones duplicadas de ASIN/precio.

Plan de uso:

Tasa (solicitudes por segundo)	Burst
1	3

Parámetros

Tipo	Nombre	Descripción	Esquema
Body	body requerido	Solicite el esquema para enviar artículos para los cuales recuperar estimaciones de tarifas.	SmallAndLightFeePreviewRequest

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) : Identificador de referencia de solicitud único.	SmallAndLightFeePreviews

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 inválidos y no se puede analizar. Headers: `x-amzn-RateLimit-Limit` (string):Tu límite de velocidad (solicitudes por segundo) para esta operación. `x-amzn-RequestId` (string): Identificador de referencia de solicitud único.	ErrorList
401	El header de autorización de la solicitud no está formateado correctamente 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): Identificador de referencia de solicitud único.	ErrorList
403	Indica que el acceso al recurso está prohibido. Posibles razones incluyen Acceso Denegado, No Autorizado, Token Expirado o Firma Inválida. Headers: `x-amzn-RequestId` (string): Identificador de referencia de solicitud único.	ErrorList
404	El recurso especificado no existe. Headers: `x-amzn-RateLimit-Limit` (string):Your rate limit (solicitudes per second) for this operation. `x-amzn-RequestId` (string): Identificador de referencia de solicitud único.	ErrorList
413	El tamaño de la solicitud superó el tamaño máximo permitido. 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): Identificador de referencia de solicitud único.	ErrorList
415	El formato del payload de la solicitud no es compatible. 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): Identificador de referencia de solicitud único.	ErrorList
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): Identificador de referencia de solicitud único.	ErrorList
500	Se produjo 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): Identificador de referencia de solicitud único.	ErrorList
503	Sobrecarga temporária ou manutenção do 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): Identificador de referencia de solicitud único.	ErrorList

Definiciones

MarketplaceId

Un identificador de marketplace.

Tipo : string

SellerSKU

Identifica un artículo en el marketplace dado. SellerSKU está calificado por el SellerId del seller, que se incluye con cada operación que envía.

Tipo : string

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 requerido	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

ErrorList

Una lista de respuestas de error devueltas cuando una solicitud no se realiza correctamente.

Nombre	Esquema
errores opcional	array

SmallAndLightEnrollmentStatus

El estado de registro de artículos Small and Light del artículo.

Tipo : enum

Valor	Descripción
ENROLLED	El estado de inscripción de Small and Light es inscrito.
NOT_ENROLLED	El estado de inscripción de Small and Light no es inscrito.

SmallAndLightEligibilityStatus

El estado de elegibilidad de artículos Small and Light.

Tipo : enum

Valor	Descripción
ELIGIBLE	El estado de elegibilidad Small and Light es elegible.
NOT_ELIGIBLE	El estado de elegibilidad de Small and Light no es elegible.

SmallAndLightEnrollment

El estado de registro de artículos Small and Light del artículo indicado por el SKU del seller especificado.

Nombre	Descripción	Esquema
marketplaceId requerido	Un identificador de marketplace.	MarketplaceId
sellerSKU requerido	Identifica un artículo en el marketplace dado. SellerSKU está calificado por el SellerId del seller, que se incluye con cada operación que envía.	sellerSKU
status requerido	El estado de registro de artículos Small and Light del artículo.	Estado de inscripción SmallAndLight

SmallAndLightEligibility

El estado de elegibilidad de artículos Small and Light del artículo indicado por el SKU del seller especificado.

Nombre	Descripción	Esquema
marketplaceId requerido	Un identificador de marketplace.	MarketplaceId
sellerSKU requerido	Identifica un artículo en el marketplace dado. SellerSKU está calificado por el SellerId del seller, que se incluye con cada operación que envía.	sellerSKU
status requerido	El estado de elegibilidad de artículos Small and Light.	SmallAndLightEligibilityStatus

SmallAndLightFeePreviewRequest

Solicite el esquema para enviar artículos para los cuales recuperar estimaciones de tarifas.

Nombre	Descripción	Esquema
marketplaceId requerido	Un identificador de marketplace.	MarketplaceId
items requerido	Una lista de artículos para los que recuperar estimaciones de tarifas (límite: 25).	< Item > array

SmallAndLightFeePreviews

Nombre	Descripción	Esquema
data opcional	Una lista de estimaciones de tarifas para los artículos solicitados. El orden de las estimaciones de tarifas seguirá el mismo orden que los artículos en la solicitud, con los duplicados eliminados.	< FeePreview > array

Item

Un artículo para ser vendido.

Nombre	Descripción	Esquema
asin requerido	El valor del número de identificación estándar de Amazon (ASIN) utilizado para identificar el artículo.	string
price requerido	El precio que el seller planea cobrar por el artículo.	MoneyType

FeePreview

La tarifa estimada para un artículo específico.

Nombre	Descripción	Esquema
asin opcional	El valor del número de identificación estándar de Amazon (ASIN) utilizado para identificar el artículo.	string
price opcional	El precio que el seller planea cobrar por el artículo.	MoneyType
feeBreakdown opcional	Una lista de las tarifas de productos Small and Light para el artículo.	array
totalFees opcional	Las tarifas totales cobradas si el artículo participó en el programa Small and Light.	MoneyType
errors opcional	Se produjeron uno o más errores inesperados durante la operación getSmallAndLightFeePreview.	array

FeeLineItem

Detalles de la tarifa para una tarifa específica.

Nombre	Descripción	Esquema
feeType requerido	El tipo de tarifa cobrada al seller.	enum ( FeeType )
feeCharge requerido	Importe cobrado al seller por el tipo de tarifa específico.	MoneyType

MoneyType

Nombre	Descripción	Esquema
currencyCode opcional	El código de moneda en formato ISO 4217.	string
amount opcional	El valor monetario.	number

FeeType

El tipo de tarifa cobrada al seller.

Tipo : enum

Valor	Descripción
FBAWeightBasedFee	La tarifa basada en el peso de Logística de Amazon (manejo de peso).
FBAPerOrderFulfillmentFee	La tarifa de cumplimiento por pedido de FBA (manejo de pedidos).
FBAPerUnitFulfillmentFee	La tarifa de cumplimiento de Logística de Amazon (Pick & Pack).
Commission	La comisión - tarifa de referencia.

Updated over 1 year ago