Guía de casos de uso de la FBA Small y Light API

Recupere mediante programación información sobre el inventario en la Amazon's fulfillment network

Versión API: v1

¿Qué es la FBA Inventory API?

La FBA Inventory API le permite realizar un seguimiento de la disponibilidad en tiempo real de su inventario en la Amazon's fulfillment network a nivel de marketplace. Puede obtener detalles como la condición de publicación y las cantidades de inventario, como fulfillable , inbound , reserved , unfulfillable y researching . Esta API está disponible a nivel mundial.

Cómo usar la FBA Inventory API

🚧

nextToken expirará en 30 segundos.

Para evitar errores, utiliza nextToken para obtener la siguiente página en un plazo de 30 segundos.

La FBA Inventory API requiere el rol de listado de productos .

ElgetInventorySummaries La operación devuelve una lista de inventory summaries. Los resúmenes devueltos dependen de la presencia o ausencia del startDateTime y sellerSkus parámetros de consulta:

  1. Se devuelven todos los inventory summaries con todos los detalles disponibles cuando startDateTime y sellerSkus se omiten los parámetros.

  2. Cuando startDateTime se proporciona, la operación devuelve inventory summaries que han cambiado después de la fecha y hora especificadas. El sellerSkus se ignora el parámetro.

    🚧

    Evitar errores de paginación

    Para evitar errores, utilice ambos startDateTime y nextToken para obtener la siguiente página de inventory summaries que han cambiado después de la fecha y hora especificadas.

  3. Cuando el sellerSkus se proporciona el parámetro, la operación devuelve inventory summaries solo para el sellerSkus especificado.

Tutorial: obtenga todos los inventory summaries disponibles con todos los detalles disponibles

Este tutorial le muestra cómo usar la FBA Inventory API para devolver todos los inventory summaries disponibles con detalles completos. Esto corresponde al número 1 en Cómo usar la FBA Inventory API .

requisitos previos

Para completar este tutorial necesitarás:

  • El ID de marketplace para el marketplace para el que se devolverán inventory summaries.

Obtenga todos los inventory summaries disponibles con detalles completos.

Para devolver todos los inventory summaries disponibles con detalles completos, llame a la operación getInventorySummaries de la FBA Inventory API y pase los siguientes parámetros de consulta:

ParámetroDescripciónRequerido
detailsAjustado a true para devolver inventory summaries con detalles y cantidades de inventory summaries adicionales. De lo contrario, devuelve solo inventory summaries (valor predeterminado).Sí. Debe estar configurado para true.
granularityTypeEl tipo de granularidad para el nivel de agregación de inventario.
Valores posibles: Marketplace.
Sí.
granularityIdEl ID de granularidad para el tipo de granularidad especificado. Cuando granularityType es Marketplace, debe especificar el marketplaceId.Sí.
marketplaceIdsEl ID de marketplace para el marketplace para el que se devolverán inventory summaries. Solo se permite una ID de marketplace.Sí.
nextTokenToken de string devuelto en la respuesta de su solicitud anterior. El token caduca después de 30 segundos.No.

Ejemplo de solicitud:

GET https://sellingpartnerapi-na.amazon.com/fba/inventory/v1/summaries?details=true&granularityType=Marketplace&granularityId=ATVPDKIKX0DER&marketplaceIds=ATVPDKIKX0DER

Una respuesta exitosa incluye lo siguiente en la payload para cada sellerSku:

NombreDescripción
sellerSkuLa unidad de mantenimiento de existencias (SKU) del seller del artículo.
fnSkuIdentificador de SKU de la red logística de Amazon. Las unidades de mantenimiento de existencias de la red logística (FNSKU) son identificadores únicos que Amazon asigna a los productos almacenados y gestionados desde los centros logísticos de Amazon.
asinEl número de identificación estándar de Amazon (ASIN) de un artículo. Puedes encontrar el ASIN en la página de detalles del producto.
productNameEl título del producto en el idioma localizado del artículo dentro del marketplace especificado.
lastUpdatedTimeLa fecha y hora en que se actualizó por última vez cualquier cantidad.
totalQuantityEl número total de unidades en un envío entrante o en los centros logísticos de Amazon.
fulfillableQuantityLa cantidad de artículos que se pueden recoger, embalar y enviar.
inboundWorkingQuantityEl número de unidades en un envío entrante para el que ha notificado a Amazon.
inboundShippedQuantityEl número de unidades en un envío entrante sobre el que ha notificado a Amazon y ha proporcionado un número de seguimiento.
inboundReceivingQuantityEl número de unidades que aún no se han recibido en un centro logístico de Amazon para su procesamiento, pero que forman parte de un envío entrante con algunas unidades que ya se han recibido y procesado.
totalReservedQuantityEl número total de unidades en la red logística de Amazon que actualmente se están recolectando, empaquetando y enviando; o se dejan de lado para la medición, el muestreo u otros procesos internos.
pendingCustomerOrderQuantityEl número de unidades reservadas para pedidos de clientes.
pendingTransshipmentQuantityEl número de unidades que se transfieren de un centro logístico a otro.
fcProcessingQuantityEl número de unidades que se han dejado de lado en el centro logístico para procesamiento adicional.
totalUnfulfillableQuantityEl número total de unidades en la red logística de Amazon en condiciones no vendibles.
customerDamagedQuantityEl número de unidades en disposición dañada del cliente.
warehouseDamagedQuantityEl número de unidades en disposición dañada del almacén.
distributorDamagedQuantityEl número de unidades en disposición dañada del distribuidor.
carrierDamagedQuantityEl número de unidades en disposición dañada del transportista.
defectiveQuantityEl número de unidades en disposición defectuosa.
expiredQuantityEl número de unidades en disposición vencida.
totalResearchingQuantityEl número total de unidades que se están investigando actualmente en la red de cumplimiento de Amazon.
researchingQuantityBreakdownUna lista de detalles de cantidad para artículos que se están investigando actualmente que incluye

researchingQuantityInShortTerm (1-10 días)
researchingQuantityInMidTerm (11-20 días)
* researchingQuantityInLongTerm (21 días o más).

Ejemplo de respuesta:

{ "pagination": { "nextToken": "seed" }, "payload": { "granularity": { "granularityType": "Marketplace", "granularityId": "ATVPDKIKX0DER" }, "inventorySummaries": [ { "asin": "B00T9QONN1", "fnSku": "B00T9QONN1", "sellerSku": "msku314best", "condition": "NewItem", "inventoryDetails": { "fulfillableQuantity": 66, "inboundWorkingQuantity": 21, "inboundShippedQuantity": 0, "inboundReceivingQuantity": 0, "reservedQuantity": { "totalReservedQuantity": 0, "pendingCustomerOrderQuantity": 0, "pendingTransshipmentQuantity": 0, "fcProcessingQuantity": 0 }, "researchingQuantity": { "totalResearchingQuantity": 0, "researchingQuantityBreakdown": [ { "name": "researchingQuantityInShortTerm", "quantity": 0 }, { "name": "researchingQuantityInMidTerm", "quantity": 0 }, { "name": "researchingQuantityInLongTerm", "quantity": 0 } ] }, "unfulfillableQuantity": { "totalUnfulfillableQuantity": 0, "customerDamagedQuantity": 0, "warehouseDamagedQuantity": 0, "distributorDamagedQuantity": 0, "carrierDamagedQuantity": 0, "defectiveQuantity": 0, "expiredQuantity": 0 } }, "lastUpdatedTime": "2018-03-31T23: 40: 39Z", "productName": "CalciumPowder", "totalQuantity": 87 } ] } }

Tutorial: obtenga todos los inventory summaries disponibles que han cambiado

Este instructivo le muestra cómo usar la FBA Inventory API para devolver todos los inventory summaries disponibles que han cambiado desde la fecha y hora de inicio especificadas. Esto corresponde al número 2 en Cómo usar la FBA Inventory API .

requisitos previos

Para completar este tutorial necesitarás:

  1. El ID de marketplace para el marketplace para el que se devolverán inventory summaries.
  2. La fecha y hora de inicio para usar como base para devolver inventory summaries que han cambiado.

Obtenga todos los inventory summaries disponibles que han cambiado

📘

startDateTime requerido

startDateTime es necesario para obtener la siguiente página de inventory summaries que han cambiado después de la fecha y hora especificadas.

Para devolver todos los inventory summaries disponibles que han cambiado, llame algetInventorySummaries funcionamiento de la FBA Inventory API, pasando los siguientes parámetros de consulta:

ParámetroDescripciónRequerido
detailsAjustado a true para devolver inventory summaries con detalles y cantidades de inventory summaries adicionales. De lo contrario, devuelve solo inventory summaries (valor predeterminado).No.
granularityTypeEl tipo de granularidad para el nivel de agregación de inventario.
Valores posibles: Marketplace.
Sí.
granularityIdEl ID de granularidad para el tipo de granularidad especificado. Cuando granularityType es Marketplace, debe especificar el marketplaceId.Sí.
startDateTimeUna fecha y hora de inicio en formato ISO 8601. Si se especifica, se devuelven todos los inventory summaries que han cambiado desde entonces. Debe especificar una fecha y hora que no sea anterior a 18 meses antes de la fecha y hora de la solicitud.

Nota: No se detectan cambios en lo siguiente:

inboundWorkingQuantity
inboundShippedQuantity
* inboundReceivingQuantity
Sí.
marketplaceIdsEl ID de marketplace para el marketplace para el que se devolverán inventory summaries. Solo se permite una ID de marketplace.Sí.
nextTokenToken de string devuelto en la respuesta de su solicitud anterior. El token caduca después de 30 segundos.No.

Ejemplo de solicitud:

GET https://sellingpartnerapi-na.amazon.com/fba/inventory/v1/summaries?granularityType=Marketplace&granularityId=ATVPDKIKX0DER&startDateTime=2018-03-27T23:40:39Z&marketplaceIds=ATVPDKIKX0DER

Una respuesta exitosa incluye lo siguiente en la payload para cada sellerSku. Observa que, porque el parámetro detail no se especificó en el ejemplo de solicitud y el valor predeterminado es false, no se devuelven cantidades y detalles de inventory summaries adicionales.

NombreDescripción
sellerSkuLa unidad de mantenimiento de existencias (SKU) del seller del artículo.
fnSkuIdentificador de SKU de la red logística de Amazon. Las unidades de mantenimiento de existencias de la red logística (FNSKU) son identificadores únicos que Amazon asigna a los productos almacenados y gestionados desde los centros logísticos de Amazon.
asinEl número de identificación estándar de Amazon (ASIN) de un artículo. Puedes encontrar el ASIN en la página de detalles del producto.
productNameEl título del producto en el idioma localizado del artículo dentro del marketplace especificado.
lastUpdatedTimeLa fecha y hora en que se actualizó por última vez cualquier cantidad.
totalQuantityEl número total de unidades en un envío entrante o en los centros logísticos de Amazon.

Ejemplo de respuesta:

{ "pagination": { "nextToken": "seed" }, "payload": { "granularity": { "granularityType": "Marketplace", "granularityId": "ATVPDKIKX0DER" }, "inventorySummaries": [ { "asin": "B00T9QONN1", "fnSku": "B00T9QONN1", "sellerSku": "msku314best", "condition": "NewItem", "lastUpdatedTime": "2018-03-31T23: 40: 39Z", "productName": "CalciumPowder", "totalQuantity": 87 } ] } }

Tutorial: obtenga inventory summaries para los SKU de seller especificados

Este tutorial le muestra cómo usar la FBA Inventory API para devolver inventory summaries para uno o más (hasta 50) especificados sellerSkus. Esto corresponde al número 3 en Cómo usar la FBA Inventory API .

requisitos previos

Para completar este tutorial necesitarás:

  1. El ID de marketplace para el marketplace para el que se devolverán inventory summaries.
  2. Una lista de hasta cincuenta sellerSkus para los que devolver inventory summaries.

Obtenga inventory summaries con detalles adicionales para los SKU de seller especificados.

Para devolver inventory summaries con todos los detalles de los SKU especificados, llame a la operación getInventorySummaries de la FBA Inventory API y pase los siguientes parámetros de consulta:

ParámetroDescripciónRequerido
detailsAjustado a true para devolver inventory summaries con detalles y cantidades de inventory summaries adicionales. De lo contrario, devuelve solo inventory summaries (valor predeterminado).Sí. Debe estar configurado para true.
granularityTypeEl tipo de granularidad para el nivel de agregación de inventario.
Valores posibles: Marketplace.
Sí.
granularityIdEl ID de granularidad para el tipo de granularidad especificado. Cuando granularityType es Marketplace, debe especificar el marketplaceId.Sí.
sellerSkusUna lista de SKU de seller para los que devolver inventory summaries. Puede especificar hasta 50 SKU.Sí.
marketplaceIdsEl ID de marketplace para el marketplace para el que se devolverán inventory summaries. Solo se permite una ID de marketplace.Sí.

Ejemplo de solicitud:

GET https://sellingpartnerapi-na.amazon.com/fba/inventory/v1/summaries?details=true&granularityType=Marketplace&granularityId=ATVPDKIKX0DER&sellerSkus=msku314best%2Cmsku271good&marketplaceIds=ATVPDKIKX0DER

Una respuesta exitosa incluye lo siguiente en la payload para cada uno de los sellerSkus especificados:

NombreDescripción
sellerSkuLa unidad de mantenimiento de existencias (SKU) del seller del artículo.
fnSkuIdentificador de SKU de la red logística de Amazon. Las unidades de mantenimiento de existencias de la red logística (FNSKU) son identificadores únicos que Amazon asigna a los productos almacenados y gestionados desde los centros logísticos de Amazon.
asinEl número de identificación estándar de Amazon (ASIN) de un artículo. Puedes encontrar el ASIN en la página de detalles del producto.
productNameEl título del producto en el idioma localizado del artículo dentro del marketplace especificado.
lastUpdatedTimeLa fecha y hora en que se actualizó por última vez cualquier cantidad.
totalQuantityEl número total de unidades en un envío entrante o en los centros logísticos de Amazon.
fulfillableQuantityLa cantidad de artículos que se pueden recoger, embalar y enviar.
inboundWorkingQuantityEl número de unidades en un envío entrante para el que ha notificado a Amazon.
inboundShippedQuantityEl número de unidades en un envío entrante sobre el que ha notificado a Amazon y ha proporcionado un número de seguimiento.
inboundReceivingQuantityEl número de unidades que aún no se han recibido en un centro logístico de Amazon para su procesamiento, pero que forman parte de un envío entrante con algunas unidades que ya se han recibido y procesado.
totalReservedQuantityEl número total de unidades en la red logística de Amazon que actualmente se están recolectando, empaquetando y enviando; o se dejan de lado para la medición, el muestreo u otros procesos internos.
pendingCustomerOrderQuantityEl número de unidades reservadas para pedidos de clientes.
pendingTransshipmentQuantityEl número de unidades que se transfieren de un centro logístico a otro.
fcProcessingQuantityEl número de unidades que se han dejado de lado en el centro logístico para procesamiento adicional.
totalUnfulfillableQuantityEl número total de unidades en la red logística de Amazon en condiciones no vendibles.
customerDamagedQuantityEl número de unidades en disposición dañada del cliente.
warehouseDamagedQuantityEl número de unidades en disposición dañada del almacén.
distributorDamagedQuantityEl número de unidades en disposición dañada del distribuidor.
carrierDamagedQuantityEl número de unidades en disposición dañada del transportista.
defectiveQuantityEl número de unidades en disposición defectuosa.
expiredQuantityEl número de unidades en disposición vencida.
totalResearchingQuantityEl número total de unidades que se están investigando actualmente en la red de cumplimiento de Amazon.
researchingQuantityBreakdownUna lista de detalles de cantidad para artículos que se están investigando actualmente que incluye

researchingQuantityInShortTerm (1-10 días)
researchingQuantityInMidTerm (11-20 días)
* researchingQuantityInLongTerm (21 días o más).

Ejemplo de respuesta:

{ "pagination": { "nextToken": "seed" }, "payload": { "granularity": { "granularityType": "Marketplace", "granularityId": "ATVPDKIKX0DER" }, "inventorySummaries": [ { "asin": "B00T9QONN1", "fnSku": "B00T9QONN1", "sellerSku": " msku314best", "condition": "NewItem", "inventoryDetails": { "fulfillableQuantity": 66, "inboundWorkingQuantity": 21, "inboundShippedQuantity": 0, "inboundReceivingQuantity": 0, "reservedQuantity": { "totalReservedQuantity": 0, "pendingCustomerOrderQuantity": 0, "pendingTransshipmentQuantity": 0, "fcProcessingQuantity": 0 }, "researchingQuantity": { "totalResearchingQuantity": 0, "researchingQuantityBreakdown": [ { "name": "researchingQuantityInShortTerm", "quantity": 0 }, { "name": "researchingQuantityInMidTerm", "quantity": 0 }, { "name": "researchingQuantityInLongTerm", "quantity": 0 } ] }, "unfulfillableQuantity": { "totalUnfulfillableQuantity": 0, "customerDamagedQuantity": 0, "warehouseDamagedQuantity": 0, "distributorDamagedQuantity": 0, "carrierDamagedQuantity": 0, "defectiveQuantity": 0, "expiredQuantity": 0 } }, "lastUpdatedTime": "2018-03-31T23: 40: 39Z", "productName": "CalciumPowder", "totalQuantity": 87 }, { "asin": "B00T9QONN2", "fnSku": "B00T9QONN2", "sellerSku": " msku271good", "condition": "NewItem", "inventoryDetails": { "fulfillableQuantity": 6, "inboundWorkingQuantity": 2, "inboundShippedQuantity": 0, "inboundReceivingQuantity": 0, "reservedQuantity": { "totalReservedQuantity": 0, "pendingCustomerOrderQuantity": 0, "pendingTransshipmentQuantity": 0, "fcProcessingQuantity": 0 }, "researchingQuantity": { "totalResearchingQuantity": 0, "researchingQuantityBreakdown": [ { "name": "researchingQuantityInShortTerm", "quantity": 0 }, { "name": "researchingQuantityInMidTerm", "quantity": 0 }, { "name": "researchingQuantityInLongTerm", "quantity": 0 } ] }, "unfulfillableQuantity": { "totalUnfulfillableQuantity": 0, "customerDamagedQuantity": 0, "warehouseDamagedQuantity": 0, "distributorDamagedQuantity": 0, "carrierDamagedQuantity": 0, "defectiveQuantity": 0, "expiredQuantity": 0 } }, "lastUpdatedTime": "2018-04-01T23: 40: 39Z", "productName": "CalciumPowder", "totalQuantity": 8 } ] } }

Recomendación general

Siguiente Token en GetInventorySummariesResponse

Para evitar errores, utilice nextToken para pasar a la página siguiente en 30 segundos.

Paginación en GetInventorySummariesResponse

Cuando una llamada a la operación getInventorySummaries produce un nextToken, luego hay inventarios que aún no se han encontrado y puede obtenerlos en las llamadas posteriores. Usted itera a través de los Inventarios usando el nextToken token proporcionado en respuestas sucesivas. Todo el inventario ha sido atravesado, sólo después de que el pagination se devuelve como respuesta. esto significa que inventorySummaries la lista puede estar vacía pero aún produciendo un nextToken.

Ejemplos:

Incluso si no hay inventarios en el inventorySummaries lista, hay una nextToken:

{ "response": { "pagination": { "nextToken": "XXXXXXXXX" }, "payload": { "granularity": { ... }, "inventorySummaries": [] } } }

El getInventorySummaries a operação é considerada concluída somente quando a pagination não é retornada na resposta:

{ "response": { "payload": { "granularity": { ... }, "inventorySummaries": [] } } }

Did this page help you?