Hub per sviluppatoriStato dell'APISupporto

Guida ai casi d'uso dell'API Inventario di gestione logistica diretta v1

Help vendors in the direct fulfillment (DF) program use the Inventory API to manage their direct fulfillment operations.

Versione API: v1

Cos'è l'API Inventario di gestione logistica diretta?

I fornitori possono utilizzare l'API Inventario di gestione logistica diretta per scambiare i livelli di scorte dell'inventario con Amazon. Supportiamo l'API Feed dell'inventario, che consente ai fornitori di inviare feed inventario ad Amazon per il catalogo di gestione logistica diretta.

Sono incluse le seguenti operazioni:

Operazione Metodo HTTP Path Descrizione
submitInventoryUpdate POST /vendor/directFulfillment/inventory/v1/warehouses/{warehouseId}/items Invia feed parziali o completi di dettagli dell'inventario ad Amazon.

submitInventoryUpdate

There are two types of inventory feeds that can be submitted using this API. When isFullUpdate is set to true, the feed is a full update. When isFullUpdate is set to false, the feed is a partial update to inventory.

Quando scegli un aggiornamento completo, l'operazione aggiorna l'intero inventario per un magazzino specifico. Devi inviare informazioni in merito a tutti gli articoli presenti nel magazzino. Per eventuali articoli non inclusi, la quantità disponibile sarà aggiornata a zero. Questa operazione deve essere usata solo per effettuare una sincronizzazione completa del magazzino e solo nel caso in cui non ci sia la possibilità di aggiornare a zero l'inventario degli articoli esauriti. Se puoi gestire l'inventario di tutti i tuoi articoli, Amazon sconsiglia di scegliere un aggiornamento completo.

Quando scegli un aggiornamento parziale, viene aggiornato solo l'inventario in magazzino degli articoli selezionati. Viene generalmente chiamato a intervalli di qualche ora per aggiornare gli articoli in esaurimento o esauriti dopo l'ultimo aggiornamento.

Verifica dei feed ordini di inventario inviati correttamente

Vendors can verify the status of an inventory update using Vendor Central or using the Transaction Status API. For more information about how to use the Transaction Status API, refer to the business use case documentation for the Transaction Status API. Allow the system to take up to 15 minutes to show the original/updated version after submission. If Vendor Central is not showing the correct values for the acknowledgement, open a Contact Us case in Vendor Central.

Il seguente diagramma illustra il flusso di lavoro di integrazione per l'invio di aggiornamenti dell'inventario.

The Direct Fulfillment integration workflow for submitting inventory updates.

Requisiti aziendali

È richiesto un feed inventario per ogni magazzino. Se un fornitore ha più magazzini, è necessario inviare più feed inventario, ognuno contenente articoli per un determinato magazzino.

Per un aggiornamento completo, devono essere inviati tutti gli articoli disponibili in magazzino. La disponibilità di eventuali articoli non inviati sarà impostata a zero su Amazon e non saranno effettuati nuovi ordini per tali articoli non disponibili.

Per un aggiornamento parziale, devono essere inclusi solo gli articoli per cui deve essere aggiornata la quantità delle scorte. Gli articoli rimanenti non presenti nell'aggiornamento parziale non saranno modificati.

Quando lo stato di un articolo viene impostato su obsoleto tramite il parametro del corpo della richiesta isObsolete, l'articolo viene contrassegnato come permanentemente non disponibile. Se l'articolo diventa disponibile e torna in magazzino, devi impostare isObsolete su false, in modo che l'articolo venga contrassegnato come nuovamente disponibile.

If an item is rejected using the order acknowledgement multiple times, then those items will be marked as 'out of stock' and this can impact your fulfillment metrics.

Requisiti aziendali specifici per paese

Non esistono requisiti specifici per paese.

Richiesta submitInventoryUpdate

To submit inventory updates, call the submitInventoryUpdate operation and pass the following parameter:

Parametro del percorso:

Nome Descrizione Obbligatorio
warehouseId Identificativo del magazzino per cui aggiornare l'inventario.

Tipo: stringa

Parametro del corpo:

Nome Descrizione Obbligatorio
inventory I dettagli dell'inventario necessari per aggiornare alcuni o tutti gli articoli nel magazzino richiesto.

Type: InventoryUpdate

Esempio di richiesta:

POST "https://sellingpartnerapi-na.amazon.com/vendor/directFulfillment/inventory/v1/warehouses/ABCD/items" { "inventory": { "sellingParty": { "partyId": "VENDORID" }, "isFullUpdate": false, "items": [ { "buyerProductIdentifier": "ABCD4562", "vendorProductIdentifier": "7Q89K11", "availableQuantity": { "amount": 10, "unitOfMeasure": "Each" }, "isObsolete": false }, { "buyerProductIdentifier": "ABCD4563", "vendorProductIdentifier": "7Q89K12", "availableQuantity": { "amount": 15, "unitOfMeasure": "Each" }, "isObsolete": false }, { "buyerProductIdentifier": "ABCD4564", "vendorProductIdentifier": "7Q89K13", "availableQuantity": { "amount": 20, "unitOfMeasure": "Each" }, "isObsolete": false } ] } }

Risposta submitInventoryUpdate

Una risposta con esito positivo include quanto segue:

Nome Descrizione Obbligatorio
transactionId GUID per identificare questa transazione. Questo valore può essere utilizzato nell'API Stato delle transazioni per restituire lo stato di questa transazione.

Tipo: stringa

No

Esempio di risposta:

{ "transactionId": "20190905010908-8a3b6901-ef20-412f-9270-21c021796605" }

Questa pagina ti è stata utile?