Guía de casos de uso de FBA Small and Light API
Cómo utilizar la FBA Small and Light API
Versión API: v1
¿Qué es la Small and Light API?
La API Small and Light permite a los desarrolladores acceder al programa Small and Light FBA. Puede utilizar la API para:
- Determine si un seller SKU es elegible para el programa Small and Light.
- Determine si un seller SKU está inscrito en el programa Small and Light.
- Inscriba un seller SKU en el programa.
- Cancele la inscripción de un seller SKU del programa.
Esta API no admite la consulta de varios marketplaces en la misma solicitud. Si se proporcionan varios marketplaces en la solicitud, la API seleccionará el primer marketplace de la lista.
Terminología
- SKU : Unidad de mantenimiento de existencias. Identifica la lista de un seller para un ASIN en un marketplace determinado.
requisitos previos
Para completar cualquiera de los tutoriales necesitarás:
- Autorización del selling partner para el que está haciendo llamadas. Consulte Autorización de aplicaciones Selling Partner API para obtener más información.
- Aprobación para el rol Amazon Fulfillment en su perfil de desarrollador.
- El rol Amazon Fulfillment seleccionado en la página de registro de la aplicación para su aplicación.
Tutorial: Comprobar la elegibilidad de un seller SKU para el programa Small and Light
Este tutorial le muestra cómo averiguar si un seller SKU es elegible para inscribirse en el programa Small and Light para un marketplace determinado. Si un seller SKU no es elegible para el programa, las respuestas de error indicarán los motivos de no elegibilidad. Para inscribir un seller SKU en el programa Small and Light, vaya a Tutorial: Inscríbase en el programa Small and Light .
requisitos previos
Para completar este tutorial necesitarás:
- Autorización del selling partner para el que está haciendo llamadas. Consulte Autorización de aplicaciones Selling Partner API para obtener más información.
- Aprobación para el rol Amazon Fulfillment en su perfil de desarrollador.
- El rol Amazon Fulfillment seleccionado en la página de registro de la aplicación para su aplicación.
Obtenga la elegibilidad de SKU del seller para el programa Small and Light
Llama la operacióngetSmallAndLightEligibilityBySellerSKU
pasando los siguientes parámetros:
Parámetro | Descripción | Requerido |
---|---|---|
marketplaceIds | El marketplace para el que se recupera el estado de elegibilidad. Nota : solo acepta un único marketplace. Número máximo: 1 Tipo:< string > array | Sí |
sellerSKU | El SKU del seller que identifica el artículo. Tipo: string | Sí |
Ejemplo de solicitud
GET https://sellingpartnerapi-na.amazon.com/fba/smallAndLight/v1/eligibilities/exampleSellerSKU?marketplaceIds= ATVPDKIKX0DER
Respuesta
Una respuesta exitosa tiene el código 200 e incluye los objetos a continuación.
Nombre | Descripción | Requerido |
---|---|---|
marketplaceId | Un identificador de marketplace. Tipo: MarketplaceId | Sí |
sellerSKU | Identifica un artículo en el marketplace dado. SellerSKU está calificado por el seller SellerId , que se incluye con cada operación que envíe.Tipo: SellerSku | Sí |
status | El estado de elegibilidad de artículos Small and Light. Tipo: SmallAndLightEligibilityStatus | Sí |
Una respuesta fallida tiene un código que no es 2xx e incluye los objetos a continuación. Si el SKU del seller no es elegible para el programa, una respuesta 404 proporcionará los errores de no elegibilidad.
Error | ||
Nombre | Descripción | Requerido |
code | Un código de error que identifica el tipo de error que ocurrió. Tipo: string | Sí |
message | Un mensaje que describe la condición de error en un formato legible por humanos. Tipo: string | Sí |
details | Información adicional que puede ayudar a la persona que llama a comprender o solucionar el problema. Tipo: string | No |
Ejemplo de respuesta exitosa
HTTP/1.1 200 OK
{
"marketplaceId": "ATVPDKIKX0DER",
"sellerSKU": "exampleSellerSKU",
"status": "ELIGIBLE"
}
Ejemplo de respuesta fallida
HTTP/1.1 404 Not Found
{
"errors": [
{
"code": "INVALID_ASIN_PRICE",
"message": "The product's selling price is too high."
},
{
"code": "INVALID_PACKAGE_WEIGHT",
"message": "The product's package weight does not meet the required criteria."
}
]
}
Tutorial: comprobar si un seller SKU está inscrito en el programa Small and Light
Este tutorial le muestra cómo averiguar si un seller SKU está inscrito en el programa Small and Light para un marketplace determinado. Para inscribir un seller SKU en el programa Small and Light, vaya a Tutorial: Inscríbase en el programa Small and Light . Para cancelar la inscripción de un seller SKU del programa Small and Light, vaya a Tutorial: Cancelar la inscripción del programa Small and Light .
requisitos previos
Para completar este tutorial necesitarás:
- Autorización del selling partner para el que está haciendo llamadas. Consulte Autorización de aplicaciones Selling Partner API para obtener más información.
- Aprobación para el rol Amazon Fulfillment en su perfil de desarrollador.
- El rol Amazon Fulfillment seleccionado en la página de registro de la aplicación para su aplicación.
Obtenga los detalles de inscripción de Small and Light para un seller SKU
Llama agetSmallAndLightEnrollmentBySellerSKU
operación pasando los siguientes parámetros:
Parámetro | Descripción | Requerido |
---|---|---|
marketplaceIds | El marketplace para el que se recupera el estado de inscripción. Nota : solo acepta un único marketplace. Recuento máximo: 1 Tipo: array | Sí |
sellerSKU | El SKU del seller que identifica el artículo. Tipo: string | Sí |
Ejemplo de solicitud
GET https://sellingpartnerapi-na.amazon.com/fba/smallAndLight/v1/enrollments/exampleSellerSKU?marketplaceIds= ATVPDKIKX0DER
Respuesta
Una respuesta exitosa tiene el código 200 e incluye los objetos a continuación.
Nombre | Descripción | Requerido |
---|---|---|
marketplaceId | Un identificador de marketplace. Tipo: MarketplaceId | Sí |
sellerSKU | Identifica un artículo en el marketplace dado. SellerSKU está calificado por el seller SellerId , que se incluye con cada operación que envíe.Tipo: SellerSKU | Sí |
status | El estado de registro de artículos Small and Light. del artículo. Tipo: SmallAndLightEnrollmentStatus | Sí |
Una respuesta fallida tiene un código que no es 2xx e incluye los objetos a continuación.
Error | ||
Nombre | Descripción | Requerido |
code | Un código de error que identifica el tipo de error que ocurrió. Tipo: string | Sí |
message | Un mensaje que describe la condición de error en un formato legible por humanos. Tipo: string | Sí |
details | Información adicional que puede ayudar a la persona que llama a comprender o solucionar el problema. Tipo: string | No |
Ejemplo de respuesta exitosa
HTTP/1.1 200 OK
{
"marketplaceId": "ATVPDKIKX0DER",
"sellerSKU": "exampleSellerSKU",
"status": "NOT_ENROLLED"
}
Ejemplo de respuesta fallida
HTTP/1.1 400 Not Found
{
"errors": [
{
"code": "ServiceUnavailable",
"message": "Service is temporarily unavailable."
}
]
}
Tutorial: Inscríbase en el programa Small and Light
Este tutorial le muestra cómo inscribir un seller SKU en el programa Small and Light para un marketplace determinado. Para cancelar la inscripción de un seller SKU del programa Small and Light, vaya a Tutorial: Cancelar la inscripción del programa Small and Light .
requisitos previos
Para completar este tutorial necesitarás:
- Autorización del selling partner para el que está haciendo llamadas. Consulte Autorización de aplicaciones Selling Partner API para obtener más información.
- Aprobación para el rol Amazon Fulfillment en su perfil de desarrollador.
- El rol Amazon Fulfillment seleccionado en la página de registro de la aplicación para su aplicación.
Inscriba un seller SKU en el programa Small and Light
Llama la operaciónputSmallAndLightEnrollmentBySellerSKU
operación pasando los siguientes parámetros:
Parámetro | Descripción | Requerido |
---|---|---|
marketplaceIds | El marketplace en el que inscribir el artículo. Nota : solo acepta un único marketplace. Número máximo: 1 Tipo: array | Sí |
sellerSKU | El SKU del seller que identifica el artículo. Tipo: string | Sí |
Ejemplo de solicitud
PUT https://sellingpartnerapi-na.amazon.com/fba/smallAndLight/v1/enrollments/exampleSellerSKU?marketplaceIds= ATVPDKIKX0DER
Respuesta
Una respuesta exitosa tiene el código 200 e incluye los objetos a continuación.
Nombre | Descripción | Requerido |
---|---|---|
marketplaceId | Un identificador de marketplace. Tipo: MarketplaceId | Sí |
sellerSKU | Identifica un artículo en el marketplace dado. SellerSKU está calificado por el seller SellerId , que se incluye con cada operación que envíe.Tipo: SellerSKU | Sí |
status | El estado de registro de artículos Small and Light. del artículo. Tipo: SmallAndLightEnrollmentStatus | Sí |
Una respuesta fallida tiene un código que no es 2xx e incluye los objetos a continuación. Una respuesta 404 proporcionará los errores de inelegibilidad, si los hubiere.
Error | ||
Nombre | Descripción | Requerido |
code | Un código de error que identifica el tipo de error que ocurrió. Tipo: string | Sí |
message | Un mensaje que describe la condición de error en un formato legible por humanos. Tipo: string | Sí |
details | Información adicional que puede ayudar a la persona que llama a comprender o solucionar el problema. Tipo: string | No |
Ejemplo de respuesta exitosa
HTTP/1.1 200 OK
{
"marketplaceId": "ATVPDKIKX0DER",
"sellerSKU": "exampleSellerSKU",
"status": "ENROLLED"
}
Ejemplo de respuesta fallida
HTTP/1.1 404 Not Found
{
"errors": [
{
"code": "INVALID_ASIN_PRICE",
"message": "The product's selling price is too high."
},
{
"code": "INVALID_PACKAGE_WEIGHT",
"message": "The product's package weight does not meet the required criteria."
}
]
}
Tutorial: Darse de baja del programa Small and Light
Este tutorial le muestra cómo cancelar la inscripción de un seller SKU del programa Small and Light para un marketplace determinado. Para inscribir un seller SKU en el programa Small and Light, vaya a Tutorial: Inscríbase en el programa Small and Light .
requisitos previos
Para completar este tutorial necesitarás:
- Autorización del selling partner para el que está haciendo llamadas. Consulte Autorización de aplicaciones Selling Partner API para obtener más información.
- Aprobación para el rol Amazon Fulfillment en su perfil de desarrollador.
- El rol Amazon Fulfillment seleccionado en la página de registro de la aplicación para su aplicación.
Eliminar un seller SKU del programa Small and Light
Llama la operacióndeleteSmallAndLightEnrollmentBySellerSKU
pasando los siguientes parámetros:
Parámetro | Descripción | Requerido |
---|---|---|
marketplaceIds | 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 Tipo: array | Sí |
sellerSKU | El SKU del seller que identifica el artículo. Tipo: string | Sí |
Ejemplo de solicitud
DELETE https://sellingpartnerapi-na.amazon.com/fba/smallAndLight/v1/enrollments/exampleSellerSKU?marketplaceIds= ATVPDKIKX0DER
Respuesta
Una respuesta exitosa tiene el código 204 con un cuerpo de respuesta vacío. Una respuesta fallida tiene un código que no es 2xx e incluye los objetos a continuación.
Error | ||
Nombre | Descripción | Requerido |
code | Un código de error que identifica el tipo de error que ocurrió. Tipo: string | Sí |
message | Un mensaje que describe la condición de error en un formato legible por humanos. Tipo: string | Sí |
details | Información adicional que puede ayudar a la persona que llama a comprender o solucionar el problema. Tipo: string | No |
Ejemplo de respuesta exitosa
HTTP/1.1 204 OK
{
}
Ejemplo de respuesta fallida
HTTP/1.1 400 Not Found
{
"errors": [
{
"code": "ServiceUnavailable",
"message": "Service is temporarily unavailable."
}
]
}
Updated over 1 year ago