Hub per sviluppatoriStato dell'APISupporto

Guida all'integrazione dell'inventario multisede

Integra l'inventario multi-sede con API e operazioni per fornire dati a livello di sede per i clienti.

I venditori possono utilizzare l'inventario in più sedi per fornire ad Amazon dati a livello di località per i loro dati e le funzionalità di evasione degli ordini. Questi dati a livello di località, abbinati ai dati di provenienza della spedizione del venditore, generano informazioni precise che i clienti possono esaminare. L'inventario in più sedi aumenta la velocità e l'affidabilità dei venditori e riduce i costi di servizio, rendendo le offerte più attraenti per i clienti, incentivando le vendite MFN e aumentando i profitti dei venditori. Questa guida fornisce consigli ai partner di vendita sulle API e sulle operazioni obbligatorie per integrare con successo l'inventario in più sedi.

🚧

L'inventario in più sedi non è attualmente disponibile per i venditori che:

  • Usa l'inventario FBA
  • Gestisci il loro inventario con Seller Central

Prerequisiti

Il tuo Account venditore deve disporre delle autorizzazioni necessarie per utilizzare l'inventario con più sedi. Se il tuo account non dispone delle autorizzazioni per l'inventario in più sedi, puoi richiedere l'accesso tramite Modulo di iscrizione all'inventario in più sedi. Riceverai la conferma che il tuo account è pronto entro 15 giorni lavorativi.

Dopo aver ottenuto le autorizzazioni richieste, Amazon aggiunge la tua posizione predefinita come fonte di approvvigionamento. Se hai utilizzato un modello per creare sedi aggiuntive e Shipping Settings Automation (SSA) le consente, queste sedi vengono aggiunte anche come fonti di approvvigionamento.

Per completare la configurazione dell'account venditore:

  1. Crea nuove fonti di approvvigionamento o aggiorna quelle esistenti tramite l'API Supply Sources o l'interfaccia utente di Seller Central.
  2. Fornisci un inventario specifico per sede tramite l'API.
  3. Crea o identifica i modelli esistenti consentiti da SSA.
  4. Assegna il modello di spedizione creato o identificato nel passaggio 3 agli SKU a cui hai aggiunto l'inventario. Effettua questa operazione per ogni sede.
  5. Imposta il canale di inventario DEFAULT su 0.
  6. Aggiungi il ruolo Informazioni sui partner di vendita al tuo profilo di sviluppatore.

API obbligatorie per l'integrazione dell'inventario in più sedi

I partner di vendita devono integrare API delle fonti di approvvigionamento, il API Listings Items, e il API per i feed per utilizzare l'inventario con più sedi.

Crea modelli di spedizione dell'inventario in più sedi consentiti da SSA in Seller Central

Per informazioni su come creare modelli di spedizione dell'inventario in più sedi consentiti da SSA, consulta Automazione delle impostazioni di spedizione.

Integra l'API Supply Sources

Per sapere come utilizzare il programma di inventario con più sedi con l'API Supply Sources, consulta la Guida ai casi d'uso dell'API Supply Sources.

Integra l'API Listings Items

I venditori possono utilizzare l'API Listings Items per sostituire il conteggio dell'inventario disponibile presso una fonte di fornitura. L'API Listings Items accetta PATCH operazioni per aggiornare ed eliminare uno o più attributi individuali per un elenco esistente, ad esempio price e quantity.

🚧

Attenzione

È necessario impostare DEFAULT canale a 0. Mancata impostazione del DEFAULT canale a 0 si traduce in due offerte elencate: un'offerta di inventario in più sedi e un'offerta di inventario non in più sedi. Questo problema non influisce sull'acquistabilità dell'offerta, ma l'offerta di inventario non in più sedi potrebbe mostrare tempistiche di inventario e spedizione imprecise.

Usa l'inventario in più sedi per aggiornare il tuo inventario

Usa il PATCH operazione con l'endpoint /listings/2021-08-01/items/{sellerId}/{sku}?marketplaceIds={marketplaceIds}&issueLocale={issueLocale}, quindi passa i seguenti parametri:

Parametri del percorso

ParametroDescrizioneObbligatorio
sellerIdL'identificativo del partner di vendita, ad esempio il Merchant Customer Identifier (MCID) o il codice del fornitore.
skuL'identificatore SKU dell'inserzione che è univoco per l'ID venditore.
marketplaceIdsL'elenco delimitato da virgole degli identificativi del marketplace per la richiesta.
issueLocaleUna lingua per la localizzazione per il testo del motivo. Se non viene indicata, viene utilizzato il codice della lingua del primo marketplace. Esempi: en_US, fr_CA, fr_FR. I messaggi localizzati sono in en_US per impostazione predefinita quando non è disponibile una localizzazione nella lingua specificata.No

Parametri dell'intestazione

NomeValue
Acceptsapplication/json
Content-Typeapplication/json
{ "productType": "PRODUCT", "patches": [ { "op": "replace", "path": "/attributes/fulfillment_availability", "value": [ { "fulfillment_channel_code": "StoreID1234567", "quantity": 10 } ] } ] }

❗️

Avvertenza

È necessario impostare Product Type e Path come segue:

  • Product Type + PRODUCT.
  • Path + /attributes/fulfillment_availability.

La mancata impostazione di questi valori può comportare:

  • Un errore o una risposta di avviso

  • Dati che potrebbero essere ignorati o che potrebbero non raggiungere la parte prevista del sistema di Amazon. Ciò può influire sui relativi aggiornamenti delle inserzioni e sulla disponibilità dell'inventario

  • Comportamento inatteso dell'API, ad esempio una sovrascrittura dei dati in base alle impostazioni predefinite o problemi con le operazioni specifiche del marketplace

{ "sku": "SKUID1234567", "status": "ACCEPTED", "submissionId": "f1dc2914-75dd-11ea-bc55-0242ac130003", "issues": [] }
{ "productType": "PRODUCT", "patches": [ { "op": "replace", "path": "/attributes/fulfillment_availability", "value": [ { "fulfillment_channel_code": "ISPU01", "quantity": 10 }, { "fulfillment_channel_code": "ISPU02", "quantity": 10 } ] } ] }
{ "header": { "sellerId": "{merchantId}", "version": "2.0", "issueLocale": "en_US" }, "messages": [ { "messageId": 1, "sku": "My-SKU-01", "operationType": "PATCH", "productType": "PRODUCT", "patches": [ { "op": "replace", "path": "/attributes/fulfillment_availability", "value": [ { "fulfillment_channel_code": "ISPU01", "quantity": 10 }, { "fulfillment_channel_code": "ISPU02", "quantity": 10 } ] } ] }, { "messageId": 2, "sku": "My-SKU-02", "operationType": "PATCH", "productType": "PRODUCT", "patches": [ { "op": "replace", "path": "/attributes/fulfillment_availability", "value": [ { "fulfillment_channel_code": "ISPU01", "quantity": 10 }, { "fulfillment_channel_code": "ISPU02", "quantity": 10 } ] } ] } ] }

Usa l'API Listings Items per visualizzare il tuo inventario

I venditori possono utilizzare l'API Listings Items per visualizzare il conteggio delle scorte disponibile presso la fonte di fornitura. Chiama il getListingsItem operazione per restituire i dettagli relativi a un elemento dell'inserzione.

Usa il GET operazione con l'endpoint /listings/2021-08-01/items/{sellerId}/{sku}?marketplaceIds={marketplaceIds}&issueLocale={issueLocale} &includedData=issues,attributes,summaries,offers,fulfillmentAvailability e passa i seguenti parametri:

Parametri del percorso

NomeDescrizioneObbligatorio
sellerIdL'identificativo del partner di vendita, ad esempio il Merchant Customer Identifier (MCID) o il codice del fornitore.
skuL'identificatore SKU per l'inserzione che è univoco per sellerId.

Parametri di query

NomeDescrizioneObbligatorio
marketplaceIdsL'elenco delimitato da virgole degli identificativi del marketplace per la richiesta.
issueLocaleUna lingua per la localizzazione per il testo del motivo. Se non viene indicata, viene utilizzato il codice della lingua del primo marketplace. Esempi: en_US, fr_CA, fr_FR. I messaggi localizzati sono in en_US per impostazione predefinita quando non è disponibile una localizzazione nella lingua specificata.Opzionale
includedDataL'elenco delimitato da virgole degli identificativi del marketplace per la richiesta.

Tipo: array (csv)
No

Una risposta di successo include Fulfillment Availability attributo di matrice che restituisce l'ID della fonte di fornitura (fulfillmentChannelCode) e il numero di scorte rimanenti (quantity).

Assegna l'inventario per i singoli SKU

  1. Usa il GET operazione per trovare la quantità di un singolo SKU per la sede predefinita. Questo esempio utilizza ssnm001 SKU, che ha una quantità di 3 da un'unica fonte di approvvigionamento.
GET: {{baseUrl}}/listings/2021-08-01/items/{{sellerid}}/ssnm001?marketplacelds={{Marketplaceld}}
{ "sku": "ssnm001", "fulfillmentAvailability": [ { "fulfillmentChannelCode": "DEFAULT", "quantity": 3 } ] }
  1. Usa il PATCH funzionamento e impostare il fulfillmentChannelCode a DEFAULT e il quantity a 0.
PATCH: {{baseUrl}}/listings/2021-08-01/items/{{sellerid}}/ssnm001?marketplacelds={{Marketplaceld}}
{ "productType": "PRODUCT", "patches": [ { "op": "replace", "path": "/attributes/fulfillment_availability", "value": [ { "fulfillmentchannelCode": "353e4e48-6301-4d50-990e-43a86e8787a3", "quantity": 10 }, { "fulfillmentchannelCode": "8e07a0c9-ab0a-4108-9f16-83dc3496bee0", "quantity": 5 }, { "fulfillmentchannelCode": "DEFAULT", "quantity": 0 } ] } ] }
{ "sku": "ssnm001", "status": "ACCEPTED", "submissionId": "680b16163093417da2edfd77a7edc38f", "issues": [] }
  1. Usa il getListingsItem operazione per inviare le modifiche e recuperare i dettagli su fulfillmentAvailability.
GET: {{baseUrl}}/listings/2021-08-01/items/{{sellerId}}/ssnm001?marketplacelds={{Marketplaceld}}&includedData=fulfillmentAvailability
{ "sku": "ssnm001", "fulfilmentAvailability": [ { "fulfillmentchannelCode": "DEFAULT", "quantity": 9 }, { "fulfillmentchannelCode": "353e4e48-6301-4d50-990e-43a86e8787a3", "quantity": 10 }, { "fulfillmentchannelCode": "8e07a0c9-ab0a-4108-9f16-83dc3496bee0", "quantity": 5 } ] }

La risposta conferma che lo SKU è ssnm001 e quell'inventario è consolidato da due fonti di approvvigionamento, Store A e Store B.

Verifica che la quantità sia stata aggiornata in Seller Central:

  1. Accedi al tuo account Seller Central.
  2. Nell'angolo in alto a sinistra, seleziona il menu dell'hamburger.
  3. Scegli Inventory e seleziona Manage All Inventory.
  4. Controlla il numero SKU e le relative fonti di approvvigionamento.

Recupera l'ID della fonte di fornitura utilizzato dai partner di vendita tramite il feed Order Fulfillment

Le Feed di evasione degli ordini ordina ad Amazon di addebitare l'importo all'acquirente, accreditare l'account venditore e notificare all'acquirente che l'ordine è stato spedito.

Questo feed fornisce l'ID della fonte di fornitura utilizzato da un partner di vendita. Per recuperarlo, devi utilizzare il feed di Order Fulfillment schema XML.

Conferma più ordini tramite il feed di evasione degli ordini

Per confermare un ordine o un gruppo di ordini utilizzando il POST_ORDER_FULFILLMENT_DATA tipo di feed, devi includere CarrierCode, ShippingMethod, e ShipperTrackingNumber all'interno dello schema XML. È possibile integrare POST_ORDER_FULFILLMENT_DATA tipo di feed per confermare gli ordini evasi dal venditore.

Esempio XML

<?xml version="1.0" encoding="utf-8"?> <AmazonEnvelope xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <Header> <DocumentVersion>1.01</DocumentVersion> <MerchantIdentifier>MerchantID</MerchantIdentifier> </Header> <MessageType>OrderFulfillment</MessageType> <Message> <MessageID>1</MessageID> <OrderFulfillment> <AmazonOrderID>7XX-XXXXXXX-XXXXXXX</AmazonOrderID> <FulfillmentDate>2023-01-01T01:01:01+00:00</FulfillmentDate> <FulfillmentData> <CarrierCode>USPS</CarrierCode> <ShippingMethod>USPS First Class Mail</ShippingMethod> <ShipperTrackingNumber>1234567891011121314</ShipperTrackingNumber> </FulfillmentData> </OrderFulfillment> </Message> </AmazonEnvelope>

I nuovi corrieri vengono aggiunti regolarmente all'interfaccia utente di Seller Central. Se CarrierCode il valore del corriere che desideri utilizzare non è associato a amzn-base XSD file, usa il CarrierCode valore di Other e inserisci il nome del corriere nel CarrierName campo. Tieni presente che se utilizzi questo metodo, Amazon non è in grado di tracciare gli aggiornamenti sulla spedizione dei pacchi.

Dopo aver creato l'XML con le informazioni necessarie, è possibile utilizzare POST_ORDER_FULFILLMENT_DATA tipo di feed per richiedere ad Amazon di notificare all'acquirente che l'ordine è stato spedito.

Effettua aggiornamenti in blocco

L'API Feeds può effettuare aggiornamenti in blocco. Per un feed di esempio con due SKU contenenti ciascuno più aggiornamenti relativi all'evasione degli ordini, consulta la API per i feed delle inserzioni.

Assegna l'inventario per più SKU

  1. Crea un documento feed con due SKU e assegnali entrambi a due fonti di approvvigionamento. Questo esempio utilizza ssnm001 e ssnm002 SKU.
POST: {{baseUrl}}/feeds/2021-06-30/documents
{ "contentType": "application/json; charset=UTF-8" }
{ "feedDocumentId": "amzn1.tortuga.4.na.116e0ef0-ae4e-4430-9c13-249cd489c9a.T20RL98XXLBHV9", "url": "https://tortuga-prod-na.s3-external-1.amazonaws.com/&2FNinetyDays/amzn1.tortuga.4.na.116e0ef0-ae4e-4430-9c13-249cd48f9c9a.T20RL98XXLBHV9?X" }
  1. Carica un singolo JSON per tutti gli SKU e modifica il livello di inventario di ciascuna fonte di fornitura.
PUT: {{FeedUrl}} { "header": { "sellerId": "A1PP0FEH11RW77", "version": "2.0" }, "messages": [ { "messageId": 1, "sku": "ssnm002", "operationType": "PATCH", "patches": { "op": "replace", "path": "/attributes/fulfillment_availability", "value": [ { "fulfillmentchannelCode": "353e4e48-6301-4d50-990e-43a86e8787a3", "quantity": 10 }, { "fulfillmentchannelCode": "8e07a0c9-ab0a-4108-9f16-83dc3496bee0", "quantity": 7 }, { "fulfillmentchannelCode": "DEFAULT", "quantity": 0 } ] } }, { "messageId": 2, "sku": "ssnm001", "operationType": "PATCH", "patches": { "op": "replace", "path": "/attributes/fulfillment_availability", "value": [ { "fulfillmentchannelCode": "353e4e48-6301-4d50-990e-43a86e8787a3", "quantity": 5 }, { "fulfillmentchannelCode": "8e07a0c9-ab0a-4108-9f16-83dc3496bee0", "quantity": 8 }, { "fulfillmentchannelCode": "DEFAULT", "quantity": 0 } ] } } ] }
  1. Crea un feed.
POST: {{baseUrl}}/feeds/2021-06-30/feeds
var jsonData=JSON.parse(responseBody); postman.setEnvironmentVariable("feedId", jsonData. feedId);
{ "feedId": "50037019429" }
  1. GET il documento relativo al feed.
GET: {{baseUrl}}/feeds/2021-06-30/feeds/:feedId
{ "createdTime": "2023-03-12T21:23:02+00:00", "processingStatus": "DONE ", "marketplaceIds": ["ATVPDKIKX0DER"], "feedId": "50037019429", "feedType": "JSON_LISTINGS_FEED", "createdTime": "2023-03-12T21:23:02+00:00", "processingStartTime": "2023-03-12T21:23:02+00:00", "resultFeedDocumentId": "amzn1.tortuga.4.na.55£45d82-9068-4386-bbdd-9d0b7330c2e1.T3HAQ94M1R94U6" }
  1. Verifica le quantità per entrambi gli SKU.
GET: {{baseUrl}}/listings/2021-08-01/items/{{sellerId}}/ssnm001?marketplacelds={{Marketplaceld}}&includedData=fulfillmentAvailability
{ "sku": "ssnm001", "fulfillmentAvailability": [ { "fulfillmentchannelCode": "DEFAULT", "quantity": 15 }, { "fulfillmentchannelCode": "353e4e48-6301-4d50-990e-43a86e8787a3", "quantity": 10 }, { "fulfillmentchannelCode": "8e07a0c9-ab0a-4108-9f16-83dc3496bee0", "quantity": 5 } ] }
GET: {{baseUrl}}/listings/2021-08-01/items/{{sellerId}}/ssnm002?marketplacelds={{Marketplaceld}}&includedData=fulfillmentAvailability
{ "sku": "ssnm002", "fulfillmentAvailability": [ { "fulfillmentchannelCode": "DEFAULT", "quantity": 17 }, { "fulfillmentchannelCode": "353e4e48-6301-4d50-990e-43a86e8787a3", "quantity": 10 }, { "fulfillmentchannelCode": "8e07a0c9-ab0a-4108-9f16-83dc3496bee0", "quantity": 7 } ] }
  1. Per verificare che la quantità di inventario sia aggiornata in Seller Central:

    1. Accedi al tuo account Seller Central.
    2. Nell'angolo in alto a sinistra, seleziona il menu dell'hamburger ed espandilo.
    3. Scegli Inventory e seleziona Manage All Inventory.
    4. Controlla il numero SKU e le relative fonti di approvvigionamento.

Risoluzione dei problemi

Se ricevi errori di autorizzazione, consulta Errori di autorizzazione.


Questa pagina ti è stata utile?