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:
- Crea nuove fonti di approvvigionamento o aggiorna quelle esistenti tramite l'API Supply Sources o l'interfaccia utente di Seller Central.
- Fornisci un inventario specifico per sede tramite l'API.
- Crea o identifica i modelli esistenti consentiti da SSA.
- 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.
- Imposta il canale di inventario
DEFAULT
su0
. - 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 a0
. Mancata impostazione delDEFAULT
canale a0
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
Parametro | Descrizione | Obbligatorio |
---|---|---|
sellerId | L'identificativo del partner di vendita, ad esempio il Merchant Customer Identifier (MCID) o il codice del fornitore. | Sì |
sku | L'identificatore SKU dell'inserzione che è univoco per l'ID venditore. | Sì |
marketplaceIds | L'elenco delimitato da virgole degli identificativi del marketplace per la richiesta. | Sì |
issueLocale | Una 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
Nome | Value |
---|---|
Accepts | application/json |
Content-Type | application/json |
{
"productType": "PRODUCT",
"patches": [
{
"op": "replace",
"path": "/attributes/fulfillment_availability",
"value": [
{
"fulfillment_channel_code": "StoreID1234567",
"quantity": 10
}
]
}
]
}
Avvertenza
È necessario impostare
Product Type
ePath
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
Nome | Descrizione | Obbligatorio |
---|---|---|
sellerId | L'identificativo del partner di vendita, ad esempio il Merchant Customer Identifier (MCID) o il codice del fornitore. | Sì |
sku | L'identificatore SKU per l'inserzione che è univoco per sellerId . | Sì |
Parametri di query
Nome | Descrizione | Obbligatorio |
---|---|---|
marketplaceIds | L'elenco delimitato da virgole degli identificativi del marketplace per la richiesta. | Sì |
issueLocale | Una 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 |
includedData | L'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
- Usa il
GET
operazione per trovare la quantità di un singolo SKU per la sede predefinita. Questo esempio utilizzassnm001
SKU, che ha una quantità di3
da un'unica fonte di approvvigionamento.
GET: {{baseUrl}}/listings/2021-08-01/items/{{sellerid}}/ssnm001?marketplacelds={{Marketplaceld}}
{
"sku": "ssnm001",
"fulfillmentAvailability": [
{
"fulfillmentChannelCode": "DEFAULT",
"quantity": 3
}
]
}
- Usa il
PATCH
funzionamento e impostare ilfulfillmentChannelCode
aDEFAULT
e ilquantity
a0
.
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": []
}
- Usa il
getListingsItem
operazione per inviare le modifiche e recuperare i dettagli sufulfillmentAvailability
.
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:
- Accedi al tuo account Seller Central.
- Nell'angolo in alto a sinistra, seleziona il menu dell'hamburger.
- Scegli Inventory e seleziona Manage All Inventory.
- 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
<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
- Crea un documento feed con due SKU e assegnali entrambi a due fonti di approvvigionamento. Questo esempio utilizza
ssnm001
essnm002
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"
}
- 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
}
]
}
}
]
}
- Crea un feed.
POST: {{baseUrl}}/feeds/2021-06-30/feeds
var jsonData=JSON.parse(responseBody);
postman.setEnvironmentVariable("feedId", jsonData. feedId);
{
"feedId": "50037019429"
}
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"
}
- 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
}
]
}
-
Per verificare che la quantità di inventario sia aggiornata in Seller Central:
- Accedi al tuo account Seller Central.
- Nell'angolo in alto a sinistra, seleziona il menu dell'hamburger ed espandilo.
- Scegli Inventory e seleziona Manage All Inventory.
- Controlla il numero SKU e le relative fonti di approvvigionamento.
Risoluzione dei problemi
Se ricevi errori di autorizzazione, consulta Errori di autorizzazione.
Updated 27 days ago