Hub per sviluppatoriStato dell'APISupporto

Guida ai casi d'uso dell'API Spedizione in uscita di gestione logistica v2020-07-01

Come utilizzare l'API Spedizioni in entrata con gestione logistica

Versione API: v01-07-2020

Cos'è l'API Spedizione in uscita di gestione logistica?

L'API per i partner di vendita per Spedizione in uscita di gestione logistica (API Spedizione in uscita di gestione logistica) consente di creare applicazioni che aiutano un venditore a gestire gli ordini a gestione multicanale utilizzando il proprio inventario nella rete logistica di Amazon. Puoi anche ottenere informazioni sugli ordini con gestione logistica potenziali ed esistenti.

Prerequisiti

Per completare i tutorial, hai bisogno di:

  1. Autorizzazione dal partner di vendita per il quale stai effettuando chiamate. Per ulteriori informazioni, vedi Autorizzazione delle applicazioni API per i partner di vendita.

  2. Il Ruolo di Logistica di Amazon assegnato al tuo profilo di sviluppatore.

  3. Il Ruolo di Logistica di Amazon selezionato nella pagina di registrazione dell'app per la tua domanda.

Tutorial: Recupera la prova di consegna di un pacco consegnato

Scopri come ottenere la foto o la firma per una spedizione in uscita con gestione multicanale consegnata.

Prerequisiti

Per completare questo tutorial, hai bisogno di:

  1. Autorizzazione dal partner di vendita per il quale stai effettuando chiamate. Per ulteriori informazioni, vedi Autorizzazione delle applicazioni API per i partner di vendita.
  2. Il Ruolo di Logistica di Amazon assegnato al tuo profilo di sviluppatore.
  3. Il Ruolo di Logistica di Amazon selezionato nella pagina di registrazione dell'app per la tua domanda.

Ottieni la prova di consegna

Chiama l'operazione getFulfillmentOrder passando i seguenti parametri:

Parametri del percorso

NomeDescrizioneObbligatorio
sellerFulfillmentOrderIdL'identificativo assegnato all'articolo dal venditore al momento della creazione dell'ordine di evasione. Lunghezza massima: 40
Tipo: corda

Esempio di richiesta

GET "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders/CONSUMER-2022921-145045"

Risposta

NomeDescrizioneObbligatorio
fulfillmentOrderInformazioni generali su un ordine di evasione, incluso il suo stato. Tipo: FulfillmentOrder
fulfillmentOrderItemsUna serie di informazioni sugli articoli relativi agli ordini di evasione. Tipo: FulfillmentOrderItemList
fulfillmentShipmentsUna serie di informazioni relative all'evasione e alla spedizione. Tipo: FulfillmentShipmentListNo
returnItemsUna serie di articoli che Amazon ha accettato per la restituzione. I resi sono vuoti se nessun articolo è stato accettato per la restituzione. Tipo: ReturnItemList
returnAuthorizationsUna serie di informazioni sull'autorizzazione alla restituzione. Tipo: ReturnAuthorizationList

Esempio di risposta

{ "payload": { "fulfillmentOrder": { "sellerFulfillmentOrderId": "CONSUMER-2022921-145045", "marketplaceId": "ATVPDKIKX0DER", "displayableOrderId": "CONSUMER-2022921-145045", "displayableOrderDate": "2024-05-21T14:48:15Z", "displayableOrderComment": "Thank you for your order", "shippingSpeedCategory": "Standard", "destinationAddress": { "name": "Jane Smith", "addressLine1": "123 Any Street", "city": "Any Town", "stateOrRegion": "NC" "countryCode": "US", "postalCode": "28277" }, "fulfillmentAction": "Ship", "fulfillmentPolicy": "FillAllAvailable", "receivedDate": "2024-05-21T14:50:45Z", "fulfillmentOrderStatus": "CompletePartialled", "statusUpdatedDate": "2024-05-22T03:44:35Z", "notificationEmails": [ "email@email.com" ], "featureConstraints": [ { "featureName": "BLANK_BOX", "featureFulfillmentPolicy": "NotRequired" } ] }, "fulfillmentOrderItems": [ { "sellerSku": "LT110WHTAM", "sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-0", "quantity": "1", "fulfillmentNetworkSku": "X002ZKH36D", "orderItemDisposition": "Sellable", "cancelledQuantity": "0", "unfulfillableQuantity": "0", "estimatedShipDate": "2024-05-22T06:59:59Z", "estimatedArrivalDate": "2024-05-26T06:59:59Z", "perUnitDeclaredValue": { "currencyCode": "USD", "value": "35.00" } }, ], "fulfillmentShipments": [ { "amazonShipmentId": "T7mfkbDX5", "fulfillmentCenterId": "TUL2", "fulfillmentShipmentStatus": "SHIPPED", "shippingDate": "2024-05-22T03:39:19Z", "estimatedArrivalDate": "2024-05-26T06:59:59Z", "fulfillmentShipmentItem": [ { "sellerSku": "LT205BLKAM", "sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-1", "quantity": "1", "packageNumber": "1681854637" } ], "fulfillmentShipmentPackage": [ { "packageNumber": "1681854637", "carrierCode": "AMZL", "trackingNumber": "TBA123456789012", "estimatedArrivalDate": "2024-05-26T06:59:59Z", "deliveryInformation": { "deliveryDocumentList": [ { "documentType" : "DELIVERY_IMAGE", "url" : "https://some-image-url.com" } ], "dropOffLocation": { "type" : "FRONT_DOOR" } } } ], "returnItems": [], "returnAuthorizations": [] } }

Tutorial: Recuperare un elenco di ordini con gestione logistica

Questo tutorial mostra come ottenere un elenco di ordini con gestione logistica dopo (o in) una data e ora specifica o indicata dal successivo parametro del token.

Prerequisiti

Per completare questo tutorial, hai bisogno di:

  1. Autorizzazione dal partner di vendita per il quale stai effettuando chiamate. Per ulteriori informazioni, vedi Autorizzazione delle applicazioni API per i partner di vendita.

  2. Il Ruolo di Logistica di Amazon assegnato al tuo profilo di sviluppatore.

  3. Il Ruolo di Logistica di Amazon selezionato nella pagina di registrazione dell'app per la tua domanda.

Passaggio 1. Ottieni un elenco di tutti gli ordini con gestione logistica

Chiama l'operazione listAllFulfillmentOrders passando i seguenti parametri:

ParametroDescrizioneObbligatorio
queryStartDate

Una data utilizzata per selezionare gli ordini con gestione logistica che sono stati aggiornati l'ultima volta dopo (o in) un momento specifico. Per aggiornamento si intende qualsiasi modifica dello stato dell'ordine con gestione logistica, inclusa la creazione di un nuovo ordine con gestione logistica.

Tipo: stringa (data-ora)

No
nextToken

Un token di stringa riportato nella risposta alla tua richiesta precedente. È obbligatorio per recuperare l'insieme successivo di risultati [impaginazione]

Tipo: stringa

No

Esempio di richiesta

GET "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders?queryStartDate=2020-01-01T19:46:45Z"

Risposta

Una risposta corretta ha un codice 200.

Esempio di risposta

{ "payload": { "fulfillmentOrders": [ { "sellerFulfillmentOrderId": "902-6018020-0202003", "displayableOrderId": "mws-test-query-20100713023203751", "displayableOrderDate": "2020-01-09T19:46:45Z", "displayableOrderComment": "TestOrder", "shippingSpeedCategory": "Standard", "destinationAddress": { "name": "AnyCompany", "addressLine1": "123 Any Street", "addressLine2": "Suite 123", "city": "Any Town", "stateOrRegion": "MI", "countryCode": "US", "postalCode": "48084" }, "fulfillmentPolicy": "FillOrKill", "receivedDate": "2020-01-21T21:07:13Z", "fulfillmentOrderStatus": "RECEIVED", "statusUpdatedDate": "2020-01-21T21:07:30Z", "featureConstraints": [ { "featureName": "BLANK_BOX", "featureFulfillmentPolicy": "NotRequired" }, { "featureName": "BLOCK_AMZL", "featureFulfillmentPolicy": "NotRequired" } ] }, { "sellerFulfillmentOrderId": "601-2020200-12345678", "displayableOrderId": "TestOrder-FBAOutbound", "displayableOrderDate": "2020-01-09T19:46:45Z", "displayableOrderComment": "TestOrder", "shippingSpeedCategory": "Standard", "destinationAddress": { "name": "AnyCompany", "addressLine1": "123 Any Street", "addressLine2": "Suite 123", "addressLine3": "Lane1", "city": "Any Town", "stateOrRegion": "MI", "countryCode": "US", "postalCode": "48084" }, "fulfillmentPolicy": "FillOrKill", "receivedDate": "2020-01-23T19:56:41Z", "fulfillmentOrderStatus": "COMPLETE", "statusUpdatedDate": "2020-01-24T15:28:27Z", "featureConstraints": [ { "featureName": "BLANK_BOX", "featureFulfillmentPolicy": "NotRequired" }, { "featureName": "BLOCK_AMZL", "featureFulfillmentPolicy": "Required" } ] } ] } }
NomeDescrizioneObbligatorio
sellerFulfillmentOrderId

L'identificativo dell'ordine con gestione logistica inviato con l'operazione createFulfillmentOrder.

Tipo: stringa

marketplaceId

L'identificativo del marketplace in cui viene effettuato l'ordine con gestione logistica.

Tipo: stringa

displayableOrderId

Un identificativo dell'ordine con gestione logistica inviato con l'operazione createFulfillmentOrder. Viene visualizzato come identificativo dell'ordine nei materiali rivolti al destinatario, ad esempio la distinta di imballaggio.

Tipo: stringa

displayableOrderDate

Una data e un'ora inviate con l'operazione createFulfillmentOrder. Viene visualizzata come data dell'ordine nei materiali rivolti al destinatario, ad esempio la distinta di imballaggio.

Tipo: Timestamp

displayableOrderComment

Un blocco di testo inviato con l'operazione createFulfillmentOrder. Viene visualizzato nei materiali rivolti al destinatario, ad esempio la distinta di imballaggio.

Tipo: stringa

shippingSpeedCategory

Il metodo di spedizione utilizzato per l'ordine con gestione logistica.

Tipo: ShippingSpeedCategory

deliveryWindow

L'intervallo di tempo entro il quale deve essere consegnato un ordine con gestione logistica a consegna programmata.

Tipo: DeliveryWindow

No
destinationAddress

L'indirizzo di destinazione inviato con l'operazione createFulfillmentOrder .

Tipo: Address

fulfillmentAction

Specifica se l'ordine con gestione logistica deve essere spedito adesso o se l'ordine è bloccato.

Tipo: FulfillmentAction

No
fulfillmentPolicy

Il valore FulfillmentPolicy specificato quando hai inviato l'operazione createFulfillmentOrder.

Tipo: FulfillmentPolicy

No
codSettings

Gli addebiti in contrassegno (COD) associati a un ordine di evasione in contrassegno.

Tipo: CODSettings

No
receivedDate

La data e l'ora in cui l'ordine con gestione logistica è stato ricevuto da un centro logistico Amazon.

Tipo: Timestamp

fulfillmentOrderStatus

Lo stato attuale dell'ordine con gestione logistica.

Tipo: FulfillmentOrderStatus

statusUpdatedDate

The date and time that the status of the fulfillment order last changed, in ISO 8601 date-time format.

Tipo: Timestamp

notificationEmails

Un elenco di indirizzi e-mail forniti dal venditore e utilizzati da Amazon per inviare notifiche di completamento della spedizione ai destinatari per conto del venditore.

Tipo: NotificationEmailList

No
featureConstraints

Un elenco delle funzionalità e delle relative politiche di gestione logistica da applicare all'ordine.

Tipo: matrice < FeatureSettings >

No

Una risposta non riuscita ha un codice diverso da 2xx e include i seguenti oggetti.

NomeDescrizione
errors

Durante l'operazione si sono verificati uno o più errori imprevisti.

Tipo: ErrorList

Tutorial: Recuperare le informazioni di tracciamento della spedizione

Questo tutorial mostra come ottenere informazioni di tracciabilità della consegna per un pacco in una spedizione in uscita per un ordine a gestione multicanale.

Prerequisiti

Per completare questo tutorial, hai bisogno di:

  1. Autorizzazione dal partner di vendita per il quale stai effettuando chiamate. Per ulteriori informazioni, vedi Autorizzazione delle applicazioni API per i partner di vendita.
  2. Il Ruolo di Logistica di Amazon assegnato al tuo profilo di sviluppatore.
  3. Il Ruolo di Logistica di Amazon selezionato nella pagina di registrazione dell'app per la tua domanda.

Passaggio 1. Ottieni i dettagli di tracciamento del pacco

Chiama l'operazione getPackageTrackingDetails passando i seguenti parametri:

ParametroDescrizioneObbligatorio
packageNumber

L'identificativo del pacco riportato dall'operazione getFulfillmentOrder.

Tipo: numero intero (int32)

Esempio di richiesta

GET "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/tracking?packageNumber=1987644423"

Esempio di risposta

{ "payload": { "packageNumber": 1987644423, "trackingNumber": "TBA123456789012", "carrierCode": "AMZN_US", "carrierPhoneNumber": "1111111111", "carrierURL": "https://www.swiship.com/track?id=TBA123456789012", "shipDate": "2022-11-13T03:18:38Z", "estimatedArrivalDate": "2022-11-15T03:18:38Z", "shipToAddress": { "city": "Troy", "state": "MI", "country": "US" }, "currentStatus": "DELIVERED", "signedForBy": "Richard Roe", "additionalLocationInfo": "FRONT_DOOR", "trackingEvents": [ { "eventDate": "2022-11-13T03:18:37Z", "eventAddress": { "city": "Buffalo", "state": "NY", "country": "US" }, "eventCode": "EVENT_101", "eventDescription": "Carrier notified to pick up package." }, { "eventDate": "2022-11-13T03:18:38Z", "eventAddress": { "city": "Buffalo", "state": "NY", "country": "US" }, "eventCode": "EVENT_102", "eventDescription": "Shipment picked up from seller's facility." }, { "eventDate": "2022-11-13T17:27:49Z", "eventAddress": { "city": "Boise", "state": "ID", "country": "US" }, "eventCode": "EVENT_302", "eventDescription": "Out for delivery." }, { "eventDate": "2022-11-15T03:18:38Z", "eventAddress": { "city": "Troy", "state": "MI", "country": "US" }, "eventCode": "EVENT_301", "eventDescription": "Delivered." } ] } }

Una risposta non riuscita ha un codice diverso da 2xx e include i seguenti oggetti. Se PackageNumber non esiste, una risposta 404 fornisce gli errori di ineleggibilità.

NomeDescrizione
errors

Si sono verificati uno o più errori imprevisti durante l'operazione getPackageTrackingDetails.

Tipo: ErrorList

Tutorial: Annullare un ordine con gestione logistica

Questo tutorial mostra come inviare una richiesta ad Amazon per bloccare i tentativi di gestione di un ordine con gestione logistica indicato dall'identificativo dell'ordine specificato per un determinato marketplace. l'operazione cancelFulfillmentOrder deve essere chiamata solo quando l'ordine è in stato "Ricevuto" o "Pianificazione".

Prerequisiti

Per completare questo tutorial, hai bisogno di:

  1. Autorizzazione dal partner di vendita per il quale stai effettuando chiamate. Per ulteriori informazioni, vedi Autorizzazione delle applicazioni API per i partner di vendita.
  2. Il Ruolo di Logistica di Amazon assegnato al tuo profilo di sviluppatore.
  3. Il Ruolo di Logistica di Amazon selezionato nella pagina di registrazione dell'app per la tua domanda.

Passaggio 1. Annullare un ordine con gestione logistica

Chiama l'operazione cancelFulfillmentOrder passando i seguenti parametri:

ParametroDescrizioneObbligatorio
sellerFulfillmentOrderId

L'identificativo assegnato all'articolo dal venditore al momento della creazione dell'ordine con gestione logistica.

Lunghezza massima: 40

Tipo: stringa

Esempio di richiesta

PUT "https://sellingpartnerapi-na.amazon.com /fba/outbound/2020-07-01/fulfillmentOrders/TestOrder-7/cancel"

Esempio di risposta

{}

Una risposta non riuscita ha un codice diverso da 2xx e include i seguenti oggetti. Se sellerFulfillmentOrderId non esiste, una risposta 404 fornisce gli errori di ineleggibilità.

NomeDescrizione
errors

Si sono verificati uno o più errori imprevisti durante l'operazione cancelFulfillmentOrder.

Tipo: ErrorList

Tutorial: Recuperare un elenco di funzionalità

Questo tutorial mostra come ottenere un elenco delle funzionalità disponibili per gli ordini a gestione multicanale nel marketplace specificato e se il venditore per il quale hai effettuato la chiamata è iscritto a ciascuna funzionalità.

Prerequisiti

Per completare questo tutorial, hai bisogno di:

  1. Autorizzazione dal partner di vendita per il quale stai effettuando chiamate. Per ulteriori informazioni, vedi Autorizzazione delle applicazioni API per i partner di vendita.
  2. Il Ruolo di Logistica di Amazon assegnato al tuo profilo di sviluppatore.
  3. Il Ruolo di Logistica di Amazon selezionato nella pagina di registrazione dell'app per la tua domanda.

Passaggio 1. Ottieni un elenco di funzionalità

Chiama l'operazione getFeatures passando i seguenti parametri:

ParametroDescrizioneObbligatorio
marketplaceId

Il marketplace per il quale riportare l'elenco delle funzionalità.

Tipo: stringa

Esempio di richiesta

GET "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/features?MarketplaceId=ATVPDKIKX0DER"

Risposta

Una risposta corretta ha un codice 200.

Esempio di risposta

{ "features": [ { "featureName": "BLANK_BOX", "featureDescription": "Enables Shipment in non-Amazon branded boxes", "sellerEligible": true }, { "featureName": "BLOCK_AMAZON ", "featureDescription": "Blocks using Amazon Logistics as carrier", "sellerEligible": true } ] }
ParametroDescrizioneObbligatorio
featureName

Il nome della funzionalità

Tipo: stringa

featureDescription

La descrizione della funzionalità.

Tipo: stringa

sellerEligible

Se impostato su True, indica che il venditore è idoneo a utilizzare la funzionalità.

Tipo: booleano

No

Una risposta non riuscita ha un codice diverso da 2xx e include i seguenti oggetti.

NomeDescrizione
errors

Si sono verificati uno o più errori imprevisti durante l'operazione getFeatures.

Tipo: ErrorList

Tutorial: Recuperare l'inventario idoneo per Blank Box

Questo tutorial mostra come ottenere un elenco degli articoli dell'inventario idonei per Blank Box.

Prerequisiti

Per completare questo tutorial, hai bisogno di:

  1. Autorizzazione dal partner di vendita per il quale stai effettuando chiamate. Per ulteriori informazioni, vedi Autorizzazione delle applicazioni API per i partner di vendita.
  2. Il Ruolo di Logistica di Amazon assegnato al tuo profilo di sviluppatore.
  3. Il Ruolo di Logistica di Amazon selezionato nella pagina di registrazione dell'app per la tua domanda.

Passaggio 1. Ottieni un elenco degli articoli dell'inventario delle funzionalità

Chiama l'operazione getFeatureInventory passando i seguenti parametri:

ParametroDescrizioneObbligatorio
marketplaceId

Il marketplace per il quale riportare un elenco dell'inventario idoneo per la funzionalità specificata.

Tipo: stringa

featureName

Il nome della funzionalità per la quale riportare un elenco di inventario idoneo.

Tipo: stringa

nextToken

Un token di stringa riportato nella risposta alla richiesta precedente che viene utilizzato per riportare la pagina di risposta successiva. Un valore di null riporterà la prima pagina.

Tipo: stringa

No
queryStartDate

Una data utilizzata per selezionare l'inventario che è stato aggiornato l'ultima volta dopo (o il), fino a 90 giorni fa. Per aggiornamento si intende qualsiasi modifica della disponibilità dell'inventario abilitata dalle funzionalità. Deve essere nel formato YYYY-MM-DDTHH:MM:ss.sssz, ad esempio: 2020-04-04T 16:20:23.000 Z.

Tipo: stringa (data-ora)

No

Esempio di richiesta

GET "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/features/inventory/BLANK_BOX?marketplaceId=ATVPDKIKX0DER"

Risposta

Una risposta corretta ha un codice 200.

Esempio di risposta

{ "payload": { "marketplaceId": "ATVPDKIKX0DER", "featureName": "BLANK_BOX", "featureSkus": [ { "sellerSku": "TEST_SKU_BLKAM", "fnSku": "X00TEST9UZ", "asin": "B08DTESTNM", "skuCount": "4", "overlappingSkus": [] }, { "sellerSku": "TEST_SKU_BLKAM2", "fnSku": "X00TESTTS5", "asin": "B0TESTXXQM", "skuCount": "2", "overlappingSkus": [] } ] } }

ParametroDescrizioneObbligatorio
marketplaceId

Il marketplace richiesto.

Tipo: stringa

featureName

Il nome della funzionalità.

Tipo: stringa

nextToken

Se presente e non vuoto, trasmette questo token di stringa nella richiesta successiva per restituire la pagina di risposta successiva.

Tipo: stringa

No
featureSkus

Un array di SKU idonei per questa funzionalità e la quantità disponibile.

Tipo: matrice < FeatureSku >

No

Una risposta non riuscita ha un codice diverso da 2xx e include i seguenti oggetti.

NomeDescrizione
errors

Si sono verificati uno o più errori imprevisti durante l'operazione getFeatureInventory.

Tipo: ErrorList

Tutorial: Recuperare l'inventario Blank Box per uno SKU specifico

Questo tutorial mostra come ottenere il numero totale di SKU del venditore per le funzionalità con sellerSKU da te specificati.

📘

Non idoneo sellerSKU

Se il sellerSKU non è idoneo, la risposta conterrà un oggetto skuInfo vuoto.

Prerequisiti

Per completare questo tutorial, hai bisogno di:

  1. Autorizzazione dal partner di vendita per il quale stai effettuando chiamate. Per ulteriori informazioni, vedi Autorizzazione delle applicazioni API per i partner di vendita.
  2. Il Ruolo di Logistica di Amazon assegnato al tuo profilo di sviluppatore.
  3. Il Ruolo di Logistica di Amazon selezionato nella pagina di registrazione dell'app per la tua domanda.

Passaggio 1. Ottieni un conteggio degli SKU del venditore per le funzionalità

Chiama l'operazione getFeatureSKU passando i seguenti parametri:

ParametroDescrizioneObbligatorio
marketplaceId

Il marketplace per il quale riportare il conteggio.

Tipo: stringa

featureName

Il nome della funzionalità.

Tipo: stringa

sellerSku

Utilizzato per identificare un articolo in un determinato marketplace. SellerSKU è qualificato dal SellerId del venditore, che è incluso in ogni operazione inviata.

Tipo: stringa

Esempio di richiesta

GET "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/features/inventory/BLANK_BOX/TEST_SKU_BLKAM?marketplaceId=ATVPDKIKX0DER"

Esempio di risposta

{ "payload": { "marketplaceId": "ATVPDKIKX0DER", "featureName": "BLANK_BOX", "isEligible": true, "ineligibleReasons": [], "sellerSku": "TEST_SKU_BLKAM", "fnSku": "X0TEST9UZ", "asin": "B0TESTQ6NM", "skuCount": "4" } }
ParametroDescrizioneObbligatorio
marketplaceId

Il marketplace richiesto.

Tipo: stringa

featureName

Il nome della funzionalità.

Tipo: stringa

isEligible

Quando il valore è True, il SKU del venditore è idoneo per la funzionalità richiesta.

Tipo: booleano

ineligibleReasons

Un elenco di uno o più motivi per cui lo SKU del venditore non è idoneo per la funzionalità.

Valori possibili:

  • MERCHANT_NOT_ENROLLED - Il commerciante non è iscritto alla funzionalità.

  • SKU_NOT_ELIGIBLE - Lo SKU non si trova in un magazzino che supporta la funzionalità.
  • INVALID_SKU - C'è un problema con lo SKU fornito.

Type: < stringa > array

No
skuInfo

Informazioni sul SKU, che includono il conteggio disponibile, gli identificativi e un elenco di SKUs corrispondenti che condividono lo stesso inventario.

Tipo: FeatureSku

No

Una risposta non riuscita ha un codice diverso da 2xx e include i seguenti oggetti.

NomeDescrizione
errors

Si sono verificati uno o più errori imprevisti durante l'operazione getFeatureInventory.

Tipo: ErrorList

Tutorial: Creare un ordine in Giappone con una consegna e tempi di spedizione programmati

Questo tutorial illustra il processo di creazione dell'ordine per il Giappone con l'opzione di spedizione con consegna programmata. Questa opzione di spedizione è disponibile solo per gli ordini sul mercato giapponese.

Prerequisiti

Per completare questo tutorial, hai bisogno di:

  1. Autorizzazione dal partner di vendita per il quale stai effettuando chiamate. Per ulteriori informazioni, vedi Autorizzazione delle applicazioni API per i partner di vendita.
  2. Il Ruolo di Logistica di Amazon assegnato al tuo profilo di sviluppatore.
  3. Il Ruolo di Logistica di Amazon selezionato nella pagina di registrazione dell'app per la tua domanda.

Passaggio 1. Ottieni l'anteprima di gestione logistica per le date di consegna programmate

Chiama l'operazione getFulfillmentPreview con valori ShippingSpeedCategories = ScheduledDelivery e IncludeDeliveryWindows = true.

Parametro del corpoDescrizioneObbligatorio
marketplaceId

Il marketplace in cui viene effettuato l'ordine con gestione logistica.

Tipo: stringa

No
address

L'indirizzo di destinazione per l'anteprima dell'ordine con gestione logistica.

Tipo: Address

items

Informazioni identificative e informazioni sulla quantità per gli articoli nell'anteprima dell'ordine con gestione logistica.

Tipo: GetFulfillmentPreviewItemList

shippingSpeedCategories

Un elenco dei metodi di spedizione utilizzati per creare le anteprime degli ordini con gestione logistica.

Valori possibili:

  • Standard - Metodo di spedizione standard.
  • Expedited - Metodo di spedizione Express.
  • Priority - Metodo di spedizione prioritario.
  • ScheduledDelivery - Metodo di spedizione con consegna programmata solo per il Giappone.

Nota: i contratti di livello di servizio del metodo di spedizione variano in base al marketplace. I venditori devono consultare il sito web di Seller Central nel loro marketplace per quanto riguarda i contratti di livello di servizio per il metodo di spedizione e i costi di gestione.

No
includeCODFulfillmentPreview

Specifica se restituire le anteprime degli ordini di evasione in contrassegno (COD).

Valori possibili:

true - Riporta tutte le anteprime degli ordini con gestione logistica (sia per COD che non per COD).

false - Riporta solo le anteprime degli ordini con gestione logistica non destinate al pagamento alla consegna. Applicabile solo per gli ordini in Giappone.

Tipo: booleano

No
includeDeliveryWindows

Specifica se riportare l'oggetto di risposta ScheduledDeliveryInfo, che contiene le finestre di consegna disponibili per una consegna pianificata. L'oggetto di risposta ScheduledDeliveryInfo può essere riportato solo per le anteprime degli ordini con gestione logistica con ShippingSpeedCategories = ScheduledDelivery. Applicabile solo per gli ordini in Giappone.

Tipo: booleano

No
featureConstraints

Un elenco delle funzionalità e delle relative politiche di gestione logistica da applicare all'ordine.

Tipo: matrice < FeatureSettings >

No

Esempio di richiesta

POST "https://sellingpartnerapi-fe.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders/preview" { "marketplaceId": "A1VC38T7YXB528", "address": { "name": "Mary Major", "addressLine1": "1-8-1 Shimomeguro", "addressLine2": "Meguro-ku", "city": "Tokyo", "countryCode": "JP", "postalCode": "153-0064" }, "items": [ { "sellerSku": "SellerSKU12", "sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-1", "quantity": 2 } ], "shippingSpeedCategories": [ "ScheduledDelivery" ], "IncludeDeliveryWindows": "true" }

Risposta

Una risposta positiva ha un codice 200 e lo schema di risposta per l'operazione getFulfillmentPreview.

{ "payload": { "fulfillmentPreviews": [ { "shippingSpeedCategory": "ScheduledDelivery", "isFulfillable": true, "isCODCapable": false, "estimatedShippingWeight": { "unit": "POUNDS", "value": "0.441" }, "estimatedFees": [ { "name": "FBAPerOrderFulfillmentFee", "amount": { "currencyCode": "YEN", "value": "0.0" } }, { "name": "FBATransportationFee", "amount": { "currencyCode": "YEN", "value": "0.0" } }, { "name": "FBAPerUnitFulfillmentFee", "amount": { "currencyCode": "YEN", "value": "9.82" } } ], "fulfillmentPreviewShipments": [ { "earliestShipDate": "2022-12-11T08:00:00Z", "latestShipDate": "2022-12-12T07:59:59Z", "earliestArrivalDate": "2022-12-13T08:00:00Z", "latestArrivalDate": "2022-12-14T07:59:59Z", "fulfillmentPreviewItems": [ { "sellerSku": "SellerSKU12", "quantity": 2, "sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-1", "estimatedShippingWeight": { "unit": "POUNDS", "value": "0.441" }, "shippingWeightCalculationMethod": "Dimensional" } ] } ], "scheduledDeliveryinfo": { "deliveryTimeZone": "UTC", "deliveryWindows": [ { "endDate": "2022-12-15T10:48:11Z", "startDate": "2022-12-15T06:48:11Z" }, { "endDate": "2022-12-16T14:48:11Z", "startDate": "2022-12-16T10:48:11Z" } ] }, "unfulfillablePreviewItems": [], "marketplaceId": "A1VC38T7YXB528" } ] } }
NomeDescrizione
FulfillmentPreviews

Un array di informazioni sull'anteprima di gestione logistica.

Tipo: FulfillmentPreviewList

Una risposta non riuscita ha un codice diverso da 2xx e include i seguenti oggetti.

NomeDescrizione
errors

Durante l'operazione si sono verificati uno o più errori imprevisti.

Tipo: ErrorList

Passaggio 2. Crea un ordine con gestione logistica

Chiama l'operazione createFulfillmentOrder con la finestra di consegna ottenuta dalla risposta getFulfillmentPreview e con ShippingSpeedCategory = ScheduledDelivery. Se viene utilizzata un'altra finestra con l'operazione createFulfillmentOrder, il servizio riporterà un errore e l'operazione getFulfillmentPreview dovrà essere eseguita nuovamente.

📘

Nota

I contratti sui livelli di servizio del metodo di spedizione variano in base al marketplace. I venditori possono fare riferimento a Seller Central per i contratti sui livelli di servizio relativi ai metodi di spedizione e le commissioni di gestione multicanale.

Parametro del corpoDescrizioneObbligatorio
marketplaceId

Il marketplace in cui viene effettuato l'ordine con gestione logistica.

Tipo: stringa

No
sellerFulfillmentOrderId

Un identificativo dell'ordine con gestione logistica creato dal venditore per tracciare il proprio ordine con gestione logistica. Il sellerFulfillmentOrderId deve essere univoco per ogni ordine con gestione logistica creato da un venditore. Se il sistema del venditore crea già identificatori d'ordine univoci, questi potrebbero essere valori validi da utilizzare.

Lunghezza massima: 40

Tipo: stringa

displayableOrderId

Un identificativo dell'ordine con evasione logistica creato dal venditore. Questo valore viene visualizzato come identificativo dell'ordine nei materiali rivolti al destinatario, ad esempio la distinta di imballaggio per spedizioni in uscita. Il valore di DisplayableOrderId deve corrispondere all'identificativo dell'ordine che il venditore fornisce al destinatario. Il venditore può utilizzare SellerFulfillmentOrderId per questo valore oppure può specificare un valore alternativo se vuole che il destinatario faccia riferimento a un identificativo dell'ordine alternativo.

Il valore deve essere una stringa alfanumerica o conforme a ISO 8859-1 con una lunghezza compresa tra uno e 40 caratteri. Non può contenere due spazi in una riga. Gli spazi bianchi iniziali e finali vengono rimossi.

Lunghezza massima: 40

Tipo: stringa

displayableOrderDate

La data e l'ora dell'ordine con gestione logistica. Viene visualizzata come data dell'ordine nei materiali rivolti al destinatario, ad esempio la distinta di imballaggio della spedizione in uscita.

Tipo: Timestamp

displayableOrderComment

Testo specifico dell'ordine che appare nei materiali rivolti al destinatario, come la distinta di imballaggio della spedizione in uscita.

Lunghezza massima: 250

Tipo: stringa

shippingSpeedCategory

Il metodo di spedizione per l'ordine con gestione logistica.

Tipo:

ShippingSpeedCategory
deliveryWindow

L'intervallo di tempo entro il quale deve essere consegnato un ordine con gestione logistica a consegna programmata.

Tipo: DeliveryWindow

No
destinationAddress

L'indirizzo di destinazione dell'ordine con gestione logistica.

Tipo: Address

deliveryPreferences

Le preferenze di spedizione applicate all'indirizzo di destinazione. Queste preferenze vengono applicate quando possibile e sono il massimo sforzo possibile. Per gli ordini idonei, la preferenza di consegna predefinita è lasciare il pacco incustodito davanti alla porta d'ingresso. Questa funzionalità è attualmente supportata solo nel marketplace giapponese e non applicabile ad altri marketplace.

Tipo: DeliveryPreferences

No
fulfillmentAction

Specifica se l'ordine con gestione logistica deve essere spedito adesso o se l'ordine è bloccato.

Tipo: FulfillmentAction

No
fulfillmentPolicy

Il valore FulfillmentPolicy specificato quando hai inviato l'operazione createFulfillmentOrder.

Tipo: FulfillmentPolicy

No
codSettings

Gli addebiti COD che associ a un ordine di evasione COD.

Tipo: CODSettings

No
shipFromCountryCode

Il codice Paese a due caratteri per il Paese da cui viene spedito l'ordine con gestione logistica. Deve essere in formato ISO 3166-1 alpha-2. È Richiesto se si effettua una spedizione transfrontaliera.

Tipo: stringa

No
notificationEmails

Un elenco di indirizzi e-mail forniti dal venditore e utilizzati da Amazon per inviare notifiche di completamento della spedizione ai destinatari per conto del venditore.

Tipo: NotificationEmailList

No
featureConstraints

Un elenco delle funzionalità e delle relative politiche di gestione logistica da applicare all'ordine.

Tipo: matrice < FeatureSettings >

No
Items

Un elenco di articoli da includere nell'anteprima dell'ordine con gestione logistica, inclusa la quantità.

Tipo: CreateFulfillmentOrderItemList

Esempio di richiesta

POST "https://sellingpartnerapi-fe.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders" { "sellerFulfillmentOrderId": "CONSUMER-2022921-145045", "displayableOrderId": "CONSUMER-2022921-145045", "displayableOrderDate": "2022-01-09T19:46:45.809Z", "displayableOrderComment": "TestOrder", "shippingSpeedCategory": "ScheduledDelivery", "deliveryWindow": { "endDate": "2022-12-15T10:48:11Z", "startDate": "2022-12-15T06:48:11Z" }, "fulfillmentAction": "Ship", "destinationAddress": { "name": "Mary Major", "addressLine1": "1-8-1 Shimomeguro", "addressLine2": "Meguro-ku", "city": "Tokyo", "countryCode": "JP", "postalCode": "153-0064" }, "items": [ { "sellerSku": "SellerSKU12", "sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-0", "quantity": 1 } ] }

Risposta

Una risposta corretta ha un codice 200 e include i seguenti oggetti.

Esempio di risposta

{}

Una risposta non riuscita ha un codice diverso da 2xx e include i seguenti oggetti.

NomeDescrizione
errors

Si sono verificati uno o più errori imprevisti durante l'operazione createFulfillmentOrder.

Tipo: ErrorList

Passaggio 3. Ottieni l'ordine con gestione logistica per convalidare i dettagli dell'ordine

Dopo aver chiamato con successo l'operazione createFulfillmentOrder, chiama l'operazione getFulfillmentOrder per convalidare fulfillmentAction= Ship e fulfillmentOrderStatus= Received.

ParametroDescrizioneObbligatorio
sellerFulfillmentOrderId

L'identificativo assegnato all'articolo dal venditore al momento della creazione dell'ordine con gestione logistica.

Lunghezza massima: 40

Tipo: stringa

Esempio di richiesta

GET "https://sellingpartnerapi-fe.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders/CONSUMER-2022921-145045"

Risposta

Una risposta corretta ha un codice 200 con un payload.

Esempio di risposta

{ "payload": { "fulfillmentOrder": { "sellerFulfillmentOrderId": "CONSUMER-2022921-145045", "marketplaceId": "A1VC38T7YXB528", "displayableOrderId": "CONSUMER-2022921-145045", "displayableOrderDate": "2022-01-09T19:46:45.809Z", "displayableOrderComment": "TestOrder", "shippingSpeedCategory": "ScheduledDelivery", "destinationAddress": { "name": "Mary Major", "addressLine1": "1-8-1 Shimomeguro", "addressLine2": "Meguro-ku", "city": "Tokyo", "countryCode": "JP", "postalCode": "153-0064" }, "deliveryWindow": { "endDate": "2022-12-15T10:48:11Z", "startDate": "2022-12-15T06:48:11Z" } "fulfillmentAction": "Ship", "fulfillmentPolicy": "FillAllAvailable", "receivedDate": "2022-09-21T14:50:45Z", "fulfillmentOrderStatus": "Received", "statusUpdatedDate": "2022-09-22T03:44:35Z" }, "fulfillmentOrderItems": [ { "sellerSku": "SellerSKU12", "sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-0", "quantity": "1" } ], "fulfillmentShipments": [], "returnItems": [], "returnAuthorizations": [] } }
Parametro del corpoDescrizioneObbligatorio
fulfillmentOrder

Informazioni generali su un ordine con gestione logistica, incluso il suo stato.

Tipo: FulfillmentOrder

fulfillmentOrderItems

Un array di informazioni sugli articoli relativi agli ordini con gestione logistica.

Tipo: FulfillmentOrderItemList

fulfillmentShipments

Un array di informazioni relative alla spedizione con gestione logistica.

Tipo: FulfillmentShipmentList

No
returnItems

Un array di articoli che Amazon ha accettato per il reso. Ritorna vuoto se nessun articolo è stato accettato per il reso.

Tipo: ReturnItemList

returnAuthorizations

Un array di informazioni sull'autorizzazione del reso.

Tipo: ReturnAuthorizationList

Una risposta non riuscita ha un codice diverso da 2xx e include i seguenti oggetti.

NomeDescrizione
errors

Durante l'operazione si sono verificati uno o più errori imprevisti.

Tipo: ErrorList

Tutorial: creare un ordine MCF per l'India

Questo tutorial illustra il processo di creazione degli ordini MCF per l'India.

Prerequisiti

Per completare questo tutorial, hai bisogno di:

  1. Autorizzazione dal partner di vendita per il quale stai effettuando chiamate. Per ulteriori informazioni, vedi Autorizzazione delle applicazioni API per i partner di vendita.
  2. Il Ruolo di Logistica di Amazon assegnato al tuo profilo di sviluppatore.
  3. Il Ruolo di Logistica di Amazon selezionato nella pagina di registrazione dell'app per la tua domanda.

Passaggio 1. Ottieni un'anteprima di gestione logistica

Parametro del corpoDescrizioneObbligatorio
marketplaceId

Il marketplace in cui viene effettuato l'ordine con gestione logistica.

Tipo: stringa

No
address

L'indirizzo di destinazione per l'anteprima dell'ordine con gestione logistica.

Tipo: Address

items

Informazioni identificative e informazioni sulla quantità per gli articoli nell'anteprima dell'ordine con gestione logistica.

Tipo: GetFulfillmentPreviewItemList

shippingSpeedCategories

Un elenco dei metodi di spedizione utilizzati per creare le anteprime degli ordini con gestione logistica.

Valori possibili:

  • Standard - Metodo di spedizione standard.

Nota: I contratti sui livelli di servizio del metodo di spedizione variano in base al marketplace. Il metodo di spedizione standard è l'unico metodo di spedizione supportato per l'India. I venditori devono fare riferimento al Sito web di Seller Central nel loro marketplace per quanto riguarda i metodi di spedizione, gli accordi sui livelli di servizio e le spese di gestione.

No
includeCODFulfillmentPreview

Specifica se restituire le anteprime degli ordini di evasione in contrassegno (COD).

Valori possibili:

true - Riporta tutte le anteprime degli ordini con gestione logistica (sia per COD che non per COD).

false - Riporta solo le anteprime degli ordini con gestione logistica non destinate al pagamento alla consegna. Applicabile solo per gli ordini in Giappone.

Tipo: booleano

No
includeDeliveryWindows

Specifica se riportare l'oggetto di risposta ScheduledDeliveryInfo, che contiene le finestre di consegna disponibili per una consegna pianificata. L'oggetto di risposta ScheduledDeliveryInfo può essere riportato solo per le anteprime degli ordini con gestione logistica con ShippingSpeedCategories = ScheduledDelivery. Applicabile solo per gli ordini in Giappone.

Tipo: booleano

No
featureConstraints

Un elenco delle funzionalità e delle relative politiche di gestione logistica da applicare all'ordine.

Tipo: matrice < FeatureSettings >

No

Esempio di richiesta

POST "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders/preview" { "marketplaceId": "A21TJRUUN4KGV", "address": { "name": "Saanvi Sarkar", "addressLine1": "FLAT#20012, Tower#20, Prestige Ferns Residency, Haralur Road", "city": "Bengaluru", "stateOrRegion": "KA", "countryCode": "IN", "postalCode": "560021", "phone": "9986365404" }, "items": [ { "sellerSku": "mohamf devogst8 B06XSK3XL6", "sellerFulfillmentOrderItemId": "OrderItemID1", "quantity": 1 } ], "shippingSpeedCategories": [ "Standard" ], "featureConstraints": [ { "featureName": "BLANK_BOX", "featureFulfillmentPolicy": "NOTREQUIRED" } ] }

Risposta

Una risposta positiva ha un codice 200 e lo schema di risposta per l'operazione getFulfillmentPreview.

{ "payload": { "fulfillmentPreviews": [ { "shippingSpeedCategory": "Standard", "isFulfillable": false, "isCODCapable": false, "fulfillmentPreviewShipments": [ { "earliestShipDate": "2023-12-09T10:42:10Z", "latestShipDate": "2023-12-09T10:42:10Z", "earliestArrivalDate": "2023-12-11T10:42:10Z", "latestArrivalDate": "2023-12-13T10:42:10Z", "fulfillmentPreviewItems": [ { "sellerSku": "mohamf devogst8 B06XSK3XL6", "quantity": 1, "sellerFulfillmentOrderItemId": "OrderItemID1", "estimatedShippingWeight": { "unit": "KILOGRAMS", "value": "0.350" }, "shippingWeightCalculationMethod": "Package" } ] } ], "marketplaceId": "A21TJRUUN4KGV", "featureConstraints": [ { "featureName": "BLANK_BOX", "featureFulfillmentPolicy": "NotRequired" } ] } ] } }
NomeDescrizione
FulfillmentPreviews

Un array di informazioni sull'anteprima di gestione logistica.

Tipo: FulfillmentPreviewList

Una risposta non riuscita ha un codice diverso da 2xx e include i seguenti oggetti.

NomeDescrizione
errors

Durante l'operazione si sono verificati uno o più errori imprevisti.

Tipo: ErrorList

Passaggio 2. Crea un ordine con gestione logistica

Chiama l'operazione createFulfillmentOrder per creare un ordine di gestione multicanale specificando i vincoli di funzionalità richiesti per l'ordine.

Parametro del corpoDescrizioneObbligatorio
marketplaceId

Il marketplace in cui viene effettuato l'ordine con gestione logistica.

Tipo: stringa

No
sellerFulfillmentOrderId

Un identificativo dell'ordine con gestione logistica creato dal venditore per tracciare il proprio ordine con gestione logistica. Il sellerFulfillmentOrderId deve essere univoco per ogni ordine con gestione logistica creato da un venditore. Se il sistema del venditore crea già identificatori d'ordine univoci, questi potrebbero essere valori validi da utilizzare.

Lunghezza massima: 40

Tipo: stringa

displayableOrderId

Un identificativo dell'ordine con evasione logistica creato dal venditore. Questo valore viene visualizzato come identificativo dell'ordine nei materiali rivolti al destinatario, ad esempio la distinta di imballaggio per spedizioni in uscita. Il valore di DisplayableOrderId deve corrispondere all'identificativo dell'ordine che il venditore fornisce al destinatario. Il venditore può utilizzare SellerFulfillmentOrderId per questo valore oppure può specificare un valore alternativo se vuole che il destinatario faccia riferimento a un identificativo dell'ordine alternativo.

Il valore deve essere una stringa alfanumerica o conforme a ISO 8859-1 con una lunghezza compresa tra uno e 40 caratteri. Non può contenere due spazi in una riga. Gli spazi bianchi iniziali e finali vengono rimossi.

Lunghezza massima: 40

Tipo: stringa

displayableOrderDate

La data e l'ora dell'ordine con gestione logistica. Viene visualizzata come data dell'ordine nei materiali rivolti al destinatario, ad esempio la distinta di imballaggio della spedizione in uscita.

Tipo: Timestamp

displayableOrderComment

Testo specifico dell'ordine che appare nei materiali rivolti al destinatario, come la distinta di imballaggio della spedizione in uscita.

Lunghezza massima: 250

Tipo: stringa

shippingSpeedCategory

Il metodo di spedizione per l'ordine con gestione logistica.

Tipo:

ShippingSpeedCategory
deliveryWindow

L'intervallo di tempo entro il quale deve essere consegnato un ordine con gestione logistica a consegna programmata.

Tipo: DeliveryWindow

No
destinationAddress

L'indirizzo di destinazione dell'ordine con gestione logistica.

Tipo: Address

deliveryPreferences

Le preferenze di spedizione applicate all'indirizzo di destinazione. Queste preferenze vengono applicate quando possibile e sono il massimo sforzo possibile. Per gli ordini idonei, la preferenza di consegna predefinita è lasciare il pacco incustodito davanti alla porta d'ingresso. Questa funzionalità è attualmente supportata solo nel marketplace giapponese e non applicabile ad altri marketplace.

Tipo: DeliveryPreferences

No
fulfillmentAction

Specifica se l'ordine con gestione logistica deve essere spedito adesso o se l'ordine è bloccato.

Tipo: FulfillmentAction

No
fulfillmentPolicy

Il valore FulfillmentPolicy specificato quando hai inviato l'operazione createFulfillmentOrder.

Tipo: FulfillmentPolicy

No
codSettings

Gli addebiti COD che associ a un ordine di evasione COD.

Tipo: CODSettings

No
shipFromCountryCode

Il codice Paese a due caratteri per il Paese da cui viene spedito l'ordine con gestione logistica. Deve essere in formato ISO 3166-1 alpha-2. È Richiesto se si effettua una spedizione transfrontaliera.

Tipo: stringa

No
notificationEmails

Un elenco di indirizzi e-mail forniti dal venditore e utilizzati da Amazon per inviare notifiche di completamento della spedizione ai destinatari per conto del venditore.

Tipo: NotificationEmailList

No
featureConstraints

Un elenco delle funzionalità e delle relative politiche di gestione logistica da applicare all'ordine.

Tipo: matrice < FeatureSettings >

No
items

Un elenco di articoli da includere nell'anteprima dell'ordine di evasione, inclusa la quantità. Massimo 100 articoli con un massimo di 250 unità per ordine.

Tipo: CreateFulfillmentOrderItemList

paymentInformation

Le informazioni di pagamento per l'ordine di evasione.

Tipo: PaymentInformation

Esempio di richiesta

POST "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders" { "sellerFulfillmentOrderId": "createOrder1703154732", "displayableOrderId": "TestOrder-FBAOutbound20", "displayableOrderDate": "2023-11-09T19:46:45.809Z", "displayableOrderComment": "TestOrder", "shippingSpeedCategory": "Standard", "fulfillmentAction": "Ship", "destinationAddress": { "name": "Anshul R", "addressLine1": "FLAT#1234, Tower#201, Prestige Residency, Haralur Road", "city": "Bengaluru", "stateOrRegion": "KA", "countryCode": "IN", "postalCode": "560102", "phone": "9168071234" }, "notificationEmails": [ "lokshws@amazon.com" ], "items": [ { "sellerSku": "mohamf devogst8 B06XSK3XL6", "sellerFulfillmentOrderItemId": "OrderItemID1", "quantity": 1, "perUnitDeclaredValue": { "currencyCode": "INR", "value": "2.00" } } ], "paymentInformation": [ { "paymentTransactionId": "TestPaymenttransaction", "paymentMode": "Other", "paymentDate": "2023-11-14T16:25:56Z" } ] }

Risposta

Una risposta corretta ha un codice 200 e include i seguenti oggetti.

Esempio di risposta

{}

Una risposta non riuscita ha un codice diverso da 2xx e include i seguenti oggetti.

NomeDescrizione
errors

Si sono verificati uno o più errori imprevisti durante l'operazione createFulfillmentOrder.

Tipo: ErrorList

Fase 2b. Crea un ordine di evasione con un'opzione COD

Chiama il createFullfillmentOrder operazione per creare un ordine MCF con opzione contrassegno (COD). Per gli ordini in contrassegno nel mercato IN, nessuno dei valori monetari in codSettings (codCharge, codChargeTax, shippingCharge, shippingChargeTax) dovrebbe essere impostato. Tutti gli addebiti dell'ordine devono essere rappresentati con perUnitDeclaredValue.

Parametro del corpoDescrizioneObbligatorio
marketplaceIdIl marketplace in cui viene effettuato l'ordine di evasione.
Tipo: corda
No
sellerFulfillmentOrderIdUn identificativo dell'ordine di evasione che il venditore crea per tracciare il proprio ordine di evasione. Il sellerFulfillmentOrderId deve essere univoco per ogni ordine di evasione creato da un venditore. Se il sistema del venditore crea già identificatori d'ordine univoci, questi potrebbero essere valori validi da utilizzare.
lunghezza massima: 40
Tipo: corda
displayableOrderIdUn identificativo dell'ordine con gestione logistica creato dal venditore. Questo valore viene visualizzato come identificativo dell'ordine nei materiali rivolti al destinatario, ad esempio la distinta di imballaggio della spedizione in uscita. Il valore di displayableOrderId deve corrispondere all'identificativo dell'ordine che il venditore fornisce al destinatario. Il venditore può utilizzare sellerFulfillmentOrderId per questo valore oppure può specificare un valore alternativo se vuole che il destinatario faccia riferimento a un identificativo d'ordine alternativo. Il valore deve essere una stringa alfanumerica o conforme a ISO 8859-1 con una lunghezza compresa tra uno e 40 caratteri. Non può contenere due spazi in una riga. Gli spazi iniziali e finali vengono rimossi.
displayableOrderDateLa data e l'ora dell'ordine di evasione. Viene visualizzata come data dell'ordine nei materiali rivolti al destinatario, ad esempio il documento di trasporto di spedizione in uscita.
Tipo: Timestamp
displayableOrderCommentTesto specifico dell'ordine che appare nei materiali rivolti al destinatario, ad esempio la distinta di imballaggio della spedizione in uscita.
lunghezza massima: 250
Tipo: corda
shippingSpeedCategoryIl metodo di spedizione per l'ordine di evasione.
Tipo: ShippingSpeedCategory
deliveryWindowL'intervallo di tempo entro il quale deve essere consegnato un ordine di evasione con consegna programmata.
Tipo: DeliveryWindow
No
destinationAddressL'indirizzo di destinazione per l'ordine di evasione.
Tipo: Address
deliveryPreferencesLe preferenze di spedizione applicate all'indirizzo di destinazione. Queste preferenze vengono applicate quando possibile e sono il massimo sforzo possibile. Per gli ordini idonei, la preferenza di consegna predefinita è lasciare il pacco incustodito davanti alla porta d'ingresso. Questa funzionalità è attualmente supportata solo nel marketplace giapponese e non applicabile ad altri marketplace.
Tipo: DeliveryPreferences
No
fulfillmentActionSpecifica se l'ordine di evasione deve essere spedito adesso o se è stato bloccato.
Tipo: FulfillmentAction
No
fulfillmentPolicyLa politica di adempimento.
Tipo: FulfillmentPolicy
No
codSettingsGli addebiti COD che associ a un ordine di evasione COD. Nota: Solo isCodRequired deve essere impostato. codCharge, codChargeTax, shippingCharge, e shippingChargeTax non dovrebbe essere impostato per il marketplace IN.
Tipo: CODSettings
shipFromCountryCodeIl codice paese a due caratteri per il paese da cui viene spedito l'ordine di evasione ordini. Deve essere in formato ISO 3166-1 alpha-2. Questo è necessario per le spedizioni transfrontaliere.
Tipo: corda
No
notificationEmailsUn elenco di indirizzi email forniti dal venditore e utilizzati da Amazon per inviare notifiche di completamento della spedizione ai destinatari per conto del venditore.
Tipo: NotificationEmailList
No
featureConstraintsUn elenco delle funzionalità e delle relative politiche di evasione da applicare all'ordine.
Tipo: < FeatureSettings > matrice
No
itemsUn elenco di articoli da includere nell'anteprima dell'ordine di evasione, inclusa la quantità. Massimo 100 articoli con un massimo di 250 unità per ordine.
Tipo: CreateFulfillmentOrderItemList

Esempio di richiesta

POST "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders" { "sellerFulfillmentOrderId": "createOrder1703154732", "displayableOrderId": "TestOrder-FBAOutbound20", "displayableOrderDate": "2023-11-09T19:46:45.809Z", "displayableOrderComment": "TestOrder", "shippingSpeedCategory": "Standard", "fulfillmentAction": "Ship", "destinationAddress": { "name": "Anshul R", "addressLine1": "FLAT#1234, Tower#201, Prestige Residency, Haralur Road", "city": "Bengaluru", "stateOrRegion": "KA", "countryCode": "IN", "postalCode": "560102", "phone": "9168071234" }, `"codSettings": { "isCodRequired": true },` "notificationEmails": [ "lokshws@amazon.com" ], "items": [ { "sellerSku": "mohamf devogst8 B06XSK3XL6", "sellerFulfillmentOrderItemId": "OrderItemID1", "quantity": 1, "perUnitDeclaredValue": { "currencyCode": "INR", "value": "2.00" } } ] }

Risposta

Una risposta corretta ha un codice 200 ed è vuota.

Un errore ha un codice diverso da 2xx e include i seguenti oggetti:

NomeDescrizione
errorsSi sono verificati uno o più errori imprevisti durante createFulfillmentOrder operazione.
Tipo: ErrorList

Passaggio 3. Ottieni l'ordine con gestione logistica per convalidare i dettagli dell'ordine

Dopo aver chiamato con successo l'operazione createFulfillmentOrder, chiama l'operazione getFulfillmentOrder per convalidare fulfillmentAction= Ship e fulfillmentOrderStatus= Received.

ParametroDescrizioneObbligatorio
sellerFulfillmentOrderId

L'identificativo assegnato all'articolo dal venditore al momento della creazione dell'ordine con gestione logistica.

Lunghezza massima: 40

Tipo: stringa

Esempio di richiesta

GET "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders/CONSUMER-2022921-145045"

Risposta

Una risposta corretta ha un codice 200 con un payload.

Esempio di risposta

{ "payload": { "fulfillmentOrder": { "sellerFulfillmentOrderId": "createOrder1703154732", "marketplaceId": "A2XZLSVIQ0F4JT", "displayableOrderId": "TestOrder-FBAOutbound20", "displayableOrderDate": "2023-11-09T19:46:45Z", "displayableOrderComment": "TestOrder", "shippingSpeedCategory": "Standard", "destinationAddress": { "name": "Anshul R", "addressLine1": "FLAT#1234, Tower#201, Prestige Residency, Haralur Road", "city": "Bengaluru", "stateOrRegion": "KA", "countryCode": "IN", "postalCode": "560102", "phone": "9168071234" }, "fulfillmentAction": "Ship", "fulfillmentPolicy": "FillOrKill", "receivedDate": "2023-12-21T10:32:12Z", "fulfillmentOrderStatus": "Planning", "statusUpdatedDate": "2023-12-21T10:32:20Z", "notificationEmails": [ "lokshws@amazon.com" ], "featureConstraints": [ { "featureName": "BLANK_BOX", "featureFulfillmentPolicy": "NotRequired" } ] }, "fulfillmentOrderItems": [ { "sellerSku": "mohamf devogst8 B06XSK3XL6", "sellerFulfillmentOrderItemId": "OrderItemID1", "quantity": "1", "fulfillmentNetworkSku": "X0014EAZ4D", "orderItemDisposition": "Sellable", "cancelledQuantity": "0", "unfulfillableQuantity": "0", "estimatedShipDate": "2023-12-22T18:29:59Z", "estimatedArrivalDate": "2023-12-26T18:29:59Z", "perUnitDeclaredValue": { "currencyCode": "INR", "value": "2.00" } } ], "fulfillmentShipments": [], "returnItems": [], "returnAuthorizations": [], "paymentInformation": [ { "paymentTransactionId": "TestPaymenttransaction", "paymentMode": "Other", "paymentDate": "2023-11-15T00:25:56Z" } ] } }
Parametro del corpoDescrizioneObbligatorio
fulfillmentOrder

Informazioni generali su un ordine con gestione logistica, incluso il suo stato.

Tipo: FulfillmentOrder

fulfillmentOrderItems

Un array di informazioni sugli articoli relativi agli ordini con gestione logistica.

Tipo: FulfillmentOrderItemList

fulfillmentShipments

Un array di informazioni relative alla spedizione con gestione logistica.

Tipo: FulfillmentShipmentList

No
returnItems

Un array di articoli che Amazon ha accettato per il reso. Ritorna vuoto se nessun articolo è stato accettato per il reso.

Tipo: ReturnItemList

returnAuthorizations

Un array di informazioni sull'autorizzazione del reso.

Tipo: ReturnAuthorizationList

Una risposta non riuscita ha un codice diverso da 2xx e include i seguenti oggetti.

NomeDescrizione
errors

Durante l'operazione si sono verificati uno o più errori imprevisti.

Tipo: ErrorList

Tutorial: Effettuare il monitoraggio di un ordine gestito parzialmente

Questo tutorial illustra i passaggi per effettuare il monitoraggio di un ordine gestito parzialmente per articoli con inventario ridotto.

Prerequisiti

Per completare questo tutorial, hai bisogno di:

  1. Autorizzazione dal partner di vendita per il quale stai effettuando chiamate. Per ulteriori informazioni, vedi Autorizzazione delle applicazioni API per i partner di vendita.
  2. Il Ruolo di Logistica di Amazon assegnato al tuo profilo di sviluppatore.
  3. Il Ruolo di Logistica di Amazon selezionato nella pagina di registrazione dell'app per la tua domanda.

Passaggio 1. Ottieni un'anteprima di gestione logistica

Chiama l'operazione getFulfillmentPreview con due voci e assicurati che siano disponibili per una determinata opzione di spedizione (Standard, Express o Prioritaria).

Parametro del corpoDescrizioneObbligatorio
marketplaceId

Il marketplace in cui viene effettuato l'ordine con gestione logistica.

Tipo: stringa

No
address

L'indirizzo di destinazione per l'anteprima dell'ordine con gestione logistica.

Tipo: Address

items

Informazioni identificative e informazioni sulla quantità per gli articoli nell'anteprima dell'ordine di evasione. Massimo 100 articoli con un massimo di 250 unità per ordine.

Tipo: GetFulfillmentPreviewItemList

shippingSpeedCategories

Un elenco dei metodi di spedizione utilizzati per creare le anteprime degli ordini con gestione logistica.

Valori possibili:

  • Standard - Metodo di spedizione standard.
  • Expedited - Metodo di spedizione Express.
  • Priority - Metodo di spedizione prioritario.
  • ScheduledDelivery - Metodo di spedizione con consegna programmata solo per il Giappone.

Nota: i contratti di livello di servizio del metodo di spedizione variano in base al marketplace. I venditori devono consultare il sito web di Seller Central nel loro marketplace per quanto riguarda i contratti di livello di servizio per il metodo di spedizione e i costi di gestione.

No
includeCODFulfillmentPreview

Specifica se restituire le anteprime degli ordini di evasione in contrassegno (COD).

Valori possibili:

  • true - Riporta tutte le anteprime degli ordini con gestione logistica (sia per COD che non per COD).
  • false - Riporta solo le anteprime degli ordini con gestione logistica che non prevedono il pagamento alla consegna.

Applicabile solo per ordini in India.

Tipo: booleano

No
includeDeliveryWindows

Specifica se riportare l'oggetto di risposta ScheduledDeliveryInfo, che contiene le finestre di consegna disponibili per una consegna pianificata. L'oggetto di risposta ScheduledDeliveryInfo può essere riportato solo per le anteprime degli ordini con gestione logistica con ShippingSpeedCategories = ScheduledDelivery. Applicabile solo per gli ordini in Giappone.

Tipo: booleano

No
featureConstraints

Un elenco delle funzionalità e delle relative politiche di gestione logistica da applicare all'ordine.

Tipo: matrice < FeatureSettings >

No

Esempio di richiesta

POST "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders/preview" { "marketplaceId": "ATVPDKIKX0DER", "address": { "name": "Mary Major", "addressLine1": "Stockton Street", "city": "Alexandria", "stateOrRegion": "VA", "countryCode": "US", "postalCode": "22308" }, "items": [ { "sellerSku": "LT110WHTAM", "sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-0", "quantity": 1 }, { "sellerSku": "LT205BLKAM", "sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-1", "quantity": 1 } ], "shippingSpeedCategories": [ "Standard" ] }

Risposta

Una risposta positiva ha un codice 200 e lo schema di risposta per l'operazione getFulfillmentPreview.

{ "payload": { "fulfillmentPreviews": [ { "estimatedFees": [ { "amount": { "currencyCode": "USD", "value": "2" }, "name": "FBAPerOrderFulfillmentFee" }, { "amount": { "currencyCode": "USD", "value": "2" }, "name": "FBATransportationFee" }, { "amount": { "currencyCode": "USD", "value": "8" }, "name": "FBAPerUnitFulfillmentFee" } ], "estimatedShippingWeight": { "unit": "POUNDS", "value": "12.377249768019787" }, "featureConstraints": [ { "featureFulfillmentPolicy": "NotRequired", "featureName": "BLANK_BOX" }, { "featureFulfillmentPolicy": "NotRequired", "featureName": "BLOCK_AMZL" } ], "fulfillmentPreviewShipments": [ { "earliestArrivalDate": "2023-04-15T00:16:14Z", "earliestShipDate": "2023-04-13T00:16:14Z", "fulfillmentPreviewItems": [ { "estimatedShippingWeight": { "unit": "POUNDS", "value": "6.394347942660858" }, "quantity": 1, "sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-0", "sellerSku": "LT110WHTAM", "shippingWeightCalculationMethod": "PACKAGE" } ], "latestArrivalDate": "2023-04-16T00:16:14Z", "latestShipDate": "2023-04-14T00:16:14Z", "shippingNotes": [] }, { "earliestArrivalDate": "2023-04-15T00:16:14Z", "earliestShipDate": "2023-04-13T00:16:14Z", "fulfillmentPreviewItems": [ { "estimatedShippingWeight": { "unit": "POUNDS", "value": "7.521162362321674" }, "quantity": 1, "sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-1", "sellerSku": "LT205BLKAM", "shippingWeightCalculationMethod": "PACKAGE" } ], "latestArrivalDate": "2023-04-16T00:16:14Z", "latestShipDate": "2023-04-14T00:16:14Z", "shippingNotes": [] } ], "isCodCapable": false, "isFulfillable": true, "marketplaceId": "ATVPDKIKX0DER", "scheduledDeliveryinfo": {}, "shippingSpeedCategory": "Standard", "unfulfillablePreviewItems": [] } ] } }
NomeDescrizione
fulfillmentPreviews

Un array di informazioni sull'anteprima di gestione logistica.

Tipo: FulfillmentPreviewList

Una risposta non riuscita ha un codice diverso da 2xx e include i seguenti oggetti. Se PackageNumber non esiste, una risposta 404 fornisce gli errori di ineleggibilità.

NomeDescrizione
errors

Si sono verificati uno o più errori imprevisti durante l'operazione getFulfillmentPreview.

Tipo: ErrorList

Passaggio 2. Crea un ordine in uscita di gestione multicanale

Chiama il createFulfillmentOrder operazione con un ID ordine univoco e almeno due voci oppure una voce con una quantità superiore a 1 per la stessa opzione di spedizione.

Parametro del corpoDescrizioneObbligatorio
marketplaceId

Il marketplace in cui viene effettuato l'ordine con gestione logistica.

Tipo: stringa

No
sellerFulfillmentOrderIdUn identificativo dell'ordine di evasione che il venditore crea per tracciare il proprio ordine di evasione. Il

sellerFulfillmentOrderId deve essere univoco per ogni ordine di evasione creato da un venditore. Se il sistema del venditore crea già identificatori d'ordine univoci, questi potrebbero essere valori validi da utilizzare.

Lunghezza massima: 40

Tipo: stringa

displayableOrderIdUn identificativo dell'ordine con gestione logistica creato dal venditore. Questo valore viene visualizzato come identificativo dell'ordine nei materiali rivolti al destinatario, ad esempio la distinta di imballaggio della spedizione in uscita. Il valore di DisplayableOrderId deve corrispondere all'identificativo dell'ordine che il venditore fornisce al destinatario. Il venditore può utilizzare SellerFulfillmentOrderId per questo valore oppure può specificare un valore alternativo se vuole che il destinatario faccia riferimento a un identificativo d'ordine alternativo. Il valore deve essere una stringa alfanumerica o conforme a ISO 8859-1 con una lunghezza compresa tra uno e 40 caratteri. Non può contenere due spazi in una riga. Gli spazi iniziali e finali vengono rimossi.

Lunghezza massima: 40

Tipo: stringa

No
displayableOrderDate

La data e l'ora dell'ordine con gestione logistica. Viene visualizzata come data dell'ordine nei materiali rivolti al destinatario, ad esempio la distinta di imballaggio della spedizione in uscita.

Tipo: Timestamp

displayableOrderComment

Testo specifico dell'ordine che appare nei materiali rivolti al destinatario, come la distinta di imballaggio della spedizione in uscita.

Lunghezza massima: 250

Tipo: stringa

shippingSpeedCategory

Il metodo di spedizione per l'ordine con gestione logistica.

Tipo: ShippingSpeedCategory

deliveryWindow

L'intervallo di tempo entro il quale deve essere consegnato un ordine con gestione logistica a consegna programmata.

Tipo: DeliveryWindow

No
destinationAddress

L'indirizzo di destinazione dell'ordine con gestione logistica.

Tipo: Address

deliveryPreferences

Le preferenze di spedizione applicate all'indirizzo di destinazione. Queste preferenze vengono applicate quando possibile e sono il massimo sforzo possibile. Per gli ordini idonei, la preferenza di consegna predefinita è lasciare il pacco incustodito davanti alla porta d'ingresso. Questa funzionalità è attualmente supportata solo nel marketplace giapponese e non applicabile ad altri marketplace.

Tipo: DeliveryPreferences

No
fulfillmentAction

Specifica se l'ordine con gestione logistica deve essere spedito adesso o se l'ordine è bloccato.

Tipo: FulfillmentAction

No
fulfillmentPolicy

Il valore FulfillmentPolicy specificato quando hai inviato l'operazione createFulfillmentOrder.

Tipo: FulfillmentPolicy

No
codSettings

Gli addebiti COD che associ a un ordine di evasione COD.

Tipo: CODSettings

No
shipFromCountryCode

Il codice Paese a due caratteri per il Paese da cui viene spedito l'ordine con gestione logistica. Deve essere in formato ISO 3166-1 alpha-2. È Richiesto se si effettua una spedizione transfrontaliera.

Tipo: stringa

No
notificationEmails

Un elenco di indirizzi e-mail forniti dal venditore e utilizzati da Amazon per inviare notifiche di completamento della spedizione ai destinatari per conto del venditore.

Tipo: NotificationEmailList

No
featureConstraints

Un elenco delle funzionalità e delle relative politiche di gestione logistica da applicare all'ordine.

Tipo: < FeatureSettings >

No
Items

Un elenco di articoli da includere nell'anteprima dell'ordine di evasione, inclusa la quantità. Massimo 100 articoli con un massimo di 250 unità per ordine.

Tipo: CreateFulfillmentOrderItemList

Esempio di richiesta

POST "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders" { "sellerFulfillmentOrderId": "CONSUMER-2022921-145045", "displayableOrderId": "CONSUMER-2022921-145045", "displayableOrderDate": "2022-01-09T19:46:45.809Z", "displayableOrderComment": "TestOrder", "shippingSpeedCategory": "Standard", "fulfillmentAction": "Ship", "destinationAddress": { "name": "Mary Major", "addressLine1": "Stockton Street", "city": "Alexandria", "stateOrRegion": "VA", "countryCode": "US", "postalCode": "22308" }, "items": [ { "sellerSku": "LT110WHTAM", "sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-0", "quantity": 1 }, { "sellerSku": "LT205BLKAM", "sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-1", "quantity": 1 } ] }

Risposta

Una risposta corretta ha un codice 200 e include i seguenti oggetti.

Esempio di risposta

{}

Una risposta non riuscita ha un codice diverso da 2xx e include i seguenti oggetti.

NomeDescrizione
errors

Si sono verificati uno o più errori imprevisti durante l'operazione createFulfillmentOrder.

Tipo: ErrorList

Passaggio 3. Convalida i dettagli dell'ordine

Chiama l'operazione getFulfillmentOrder per convalidare fulfillmentAction = Ship e fulfillmentOrderStatus = Received.

ParametroDescrizioneObbligatorio
sellerFulfillmentOrderId

L'identificativo assegnato all'articolo dal venditore al momento della creazione dell'ordine con gestione logistica.

Lunghezza massima: 40

Tipo: stringa

Esempio di richiesta

GET "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders/CONSUMER-2022921-145045 "

Risposta

Una risposta corretta ha un codice 200 con un payload.

Esempio di risposta

{ "payload": { "fulfillmentOrder": { "sellerFulfillmentOrderId": "CONSUMER-2022921-145045", "marketplaceId": "ATVPDKIKX0DER", "displayableOrderId": "CONSUMER-2022921-145045", "displayableOrderDate": "2022-09-21T14:48:15Z", "displayableOrderComment": "TestOrder", "shippingSpeedCategory": "Standard", "destinationAddress": { "name": "Mary Major", "addressLine1": "123 Any Street", "city": "Any Town", "stateOrRegion": "VA", "countryCode": "US", "postalCode": "22308" }, "fulfillmentAction": "Ship", "fulfillmentPolicy": "FillAllAvailable", "receivedDate": "2022-09-21T14:50:45Z", "fulfillmentOrderStatus": "Received", "statusUpdatedDate": "2022-09-22T03:44:35Z", "notificationEmails": [ "marymajor@email.com" ], "featureConstraints": [ { "featureName": "BLANK_BOX", "featureFulfillmentPolicy": "NotRequired" } ] }, "fulfillmentOrderItems": [ { "sellerSku": "LT110WHTAM", "sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-0", "quantity": "1", "fulfillmentNetworkSku": "X002ZKH36D", "orderItemDisposition": "Sellable", "cancelledQuantity": "0", "unfulfillableQuantity": "1", "estimatedShipDate": "2022-09-22T06:59:59Z", "estimatedArrivalDate": "2022-09-26T06:59:59Z", "perUnitDeclaredValue": { "currencyCode": "USD", "value": "0.00" } }, { "sellerSku": "LT205BLKAM", "sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-1", "quantity": "1", "giftMessage": "", "fulfillmentNetworkSku": "X002ZKYQ4Z", "orderItemDisposition": "Sellable", "cancelledQuantity": "0", "unfulfillableQuantity": "0", "estimatedShipDate": "", "estimatedArrivalDate": "", "perUnitDeclaredValue": { "currencyCode": "USD", "value": "1995.00" } } ], "fulfillmentShipments": [], "returnItems": [], "returnAuthorizations": [] } }
Parametro del corpoDescrizioneObbligatorio
fulfillmentOrder

Informazioni generali su un ordine con gestione logistica, incluso il suo stato.

Tipo: FulfillmentOrder

fulfillmentOrderItems

Un array di informazioni sugli articoli relativi agli ordini con gestione logistica.

Tipo: FulfillmentOrderItemList

fulfillmentShipments

Un array di informazioni relative alla spedizione con gestione logistica.

Tipo: FulfillmentShipmentList

No
returnItems

Un array di articoli che Amazon ha accettato per il reso. Ritorna vuoto se nessun articolo è stato accettato per il reso.

Tipo: ReturnItemList

returnAuthorizations

Un array di informazioni sull'autorizzazione del reso.

Tipo: ReturnAuthorizationList

Una risposta non riuscita ha un codice diverso da 2xx e include i seguenti oggetti.

NomeDescrizioneObbligatorio
errors

Si sono verificati uno o più errori imprevisti durante l'operazione getFulfillmentOrder.

Tipo: ErrorList

Passaggio 4. Cambiamenti dello stato dell'ordine

L'ordine subisce modifiche di stato da Planning a Processing a Complete, nel caso in cui uno o più articoli non dispongano di scorte sufficienti come richiesto nella createFulfillmentOrder operazione. Per ricevere aggiornamenti sulle modifiche di stato, iscriviti e ascolta FULFILLMENT_ORDER_STATUS notifiche.

Fase 5. Richiedi l'ordine di evasione per visualizzare i dettagli più recenti dell'ordine

Una volta che l'ordine è Shipped, viene innescata la notifica sullo stato dell'ordine per Complete. Ora chiama l'operazione getFulfillmentOrder per visualizzare gli ultimi dettagli dell'ordine. Chiama l'operazione getFulfillmentOrder passando i seguenti parametri:

ParametroDescrizioneObbligatorio
sellerFulfillmentOrderId

L'identificativo assegnato all'articolo dal venditore al momento della creazione dell'ordine con gestione logistica.

Lunghezza massima: 40

Tipo: stringa

Esempio di richiesta

GET "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders/CONSUMER-2022921-145045"

Risposta

Una risposta corretta ha un codice 200 con un payload.

Esempio di risposta

{ "payload": { "fulfillmentOrder": { "sellerFulfillmentOrderId": "CONSUMER-2022921-145045", "marketplaceId": "ATVPDKIKX0DER", "displayableOrderId": "CONSUMER-2022921-145045", "displayableOrderDate": "2022-09-21T14:48:15Z", "displayableOrderComment": "Thank you for your order", "shippingSpeedCategory": "Standard", "destinationAddress": { "name": "Mary Major", "addressLine1": "Stockton Street", "city": "Alexandria", "stateOrRegion": "VA", "countryCode": "US", "postalCode": "22308" }, "fulfillmentAction": "Ship", "fulfillmentPolicy": "FillAllAvailable", "receivedDate": "2022-09-21T14:50:45Z", "fulfillmentOrderStatus": "CompletePartialled", "statusUpdatedDate": "2022-09-22T03:44:35Z", "notificationEmails": [ "email@email.com" ], "featureConstraints": [ { "featureName": "BLANK_BOX", "featureFulfillmentPolicy": "NotRequired" } ] }, "fulfillmentOrderItems": [ { "sellerSku": "LT110WHTAM", "sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-0", "quantity": "1", "fulfillmentNetworkSku": "X002ZKH36D", "orderItemDisposition": "Sellable", "cancelledQuantity": "0", "unfulfillableQuantity": "1", "estimatedShipDate": "2022-09-22T06:59:59Z", "estimatedArrivalDate": "2022-09-26T06:59:59Z", "perUnitDeclaredValue": { "currencyCode": "USD", "value": "0.00" } }, { "sellerSku": "LT205BLKAM", "sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-1", "quantity": "1", "giftMessage": "", "fulfillmentNetworkSku": "X002ZKYQ4Z", "orderItemDisposition": "Sellable", "cancelledQuantity": "0", "unfulfillableQuantity": "0", "estimatedShipDate": "", "estimatedArrivalDate": "", "perUnitDeclaredValue": { "currencyCode": "USD", "value": "1995.00" } } ], "fulfillmentShipments": [ { "amazonShipmentId": "T7mfkbDX5", "fulfillmentCenterId": "TUL2", "fulfillmentShipmentStatus": "SHIPPED", "shippingDate": "2022-09-22T03:39:19Z", "estimatedArrivalDate": "2022-09-26T06:59:59Z", "fulfillmentShipmentItem": [ { "sellerSku": "LT205BLKAM", "sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-1", "quantity": "1", "packageNumber": "1681854637" } ], "fulfillmentShipmentPackage": [ { "packageNumber": "1681854637", "carrierCode": "Amazon Logistics", "trackingNumber": "TBA303037991486", "estimatedArrivalDate": "2022-09-26T03:00:00Z" } ] } ], "returnItems": [], "returnAuthorizations": [] } }
Parametro del corpoDescrizioneObbligatorio
fulfillmentOrder

Informazioni generali su un ordine con gestione logistica, incluso il suo stato.

Tipo: FulfillmentOrder

fulfillmentOrderItems

Un array di informazioni sugli articoli relativi agli ordini con gestione logistica.

Tipo: FulfillmentOrderItemList

fulfillmentShipments

Un array di informazioni relative alla spedizione con gestione logistica.

Tipo: FulfillmentShipmentList

No
returnItems

Un array di articoli che Amazon ha accettato per il reso. Ritorna vuoto se nessun articolo è stato accettato per il reso.

Tipo: ReturnItemList

returnAuthorizations

Un array di informazioni sull'autorizzazione del reso.

Tipo: ReturnAuthorizationList

Una risposta non riuscita ha un codice diverso da 2xx e include i seguenti oggetti.

NomeDescrizioneObbligatorio
errors

Si sono verificati uno o più errori imprevisti durante l'operazione getFulfillmentOrder.

Tipo: ErrorList

Passaggio 6. Convalida lo stato dell'ordine e le quantità degli articoli

Convalida fulfillmentShipmentStatus = Shipped e fulfillmentOrderStatus = CompletePartialled. Se ci sono articoli che hanno unfulfillableQuantity !=0, ciò implica che l'ordine è gestito parzialmente.

Passaggio 7. Ottieni il numero del pacco

Copia il numero di pacco dell'ordine dal getFulfillmentOrder risposta di Fase 5. Potrebbero esserci più numeri di pacco in base al numero di spedizioni Amazon per quell'ordine.

Passaggio 8. Ottieni i dettagli di monitoraggio

Chiama l'operazione getPackageTrackingDetails utilizzando il numero del pacco del Passaggio 7 e ottieni i dettagli di monitoraggio completi del pacco.

ParametroDescrizioneObbligatorio
packageNumber

L'identificativo del pacco non crittografato riportato dall'operazione getFulfillmentOrder.

Tipo: numero intero (int32)

Esempio di richiesta

GET “https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/tracking?packageNumber=1681854637”

Risposta

Una risposta corretta ha un codice 200.

Esempio di risposta

{ "payload": { "packageNumber": 1681854637, "trackingNumber": "TBA303037991486", "carrierCode": "Amazon", "carrierURL": "https://www.swiship.com/track?id=TBA303037991486", "shipDate": "2022-09-22T03:57:50Z", "estimatedArrivalDate": "2022-09-26T03:00:00Z", "shipToAddress": { "city": "Alexandria", "state": "VA", "country": "US" }, "currentStatus": "DELIVERED", "additionalLocationInfo": "FRONT_DOOR/PORCH", "trackingEvents": [ { "eventDate": "2022-09-25T16:55:51Z", "eventAddress": { "city": "Alexandria", "country": "US" }, "eventCode": "EVENT_301", "eventDescription": "Package delivered near the front door or porch." }, { "eventDate": "2022-09-25T14:29:43Z", "eventAddress": { "city": "Waldorf", "country": "US" }, "eventCode": "EVENT_302", "eventDescription": "Package is out for delivery." }, { "eventDate": "2022-09-25T01:00:54Z", "eventAddress": { "city": "Sparrows Point", "state": "Maryland", "country": "US" }, "eventCode": "EVENT_201", "eventDescription": "Package arrived at an Amazon facility." }, { "eventDate": "2022-09-24T20:50:45Z", "eventAddress": { "city": "Trenton", "state": "NJ", "country": "US" }, "eventCode": "EVENT_202", "eventDescription": "Package left an Amazon facility." }, { "eventDate": "2022-09-24T08:35:48Z", "eventAddress": { "city": "Trenton", "state": "NJ", "country": "US" }, "eventCode": "EVENT_201", "eventDescription": "Package arrived at an Amazon facility." }, { "eventDate": "2022-09-23T06:54:31Z", "eventAddress": { "city": "Liberty", "state": "Missouri", "country": "US" }, "eventCode": "EVENT_202", "eventDescription": "Package left an Amazon facility." }, { "eventDate": "2022-09-22T23:15:03Z", "eventAddress": { "city": "Liberty", "state": "Missouri", "country": "US" }, "eventCode": "EVENT_201", "eventDescription": "Package arrived at an Amazon facility." }, { "eventDate": "2022-09-22T03:57:50Z", "eventCode": "EVENT_101", "eventDescription": "Carrier picked up the package." } ] } }
NomeDescrizioneObbligatorio
packageNumber

L'identificativo del pacco.

Tipo: numero intero (int32)

trackingNumber

Il numero di tracciamento del pacco.

Tipo: stringa

No
customerTrackingLink

Link su swiship.com che consente ai clienti di tracciare il pacco.

Tipo: stringa

No
carrierCode

Il nome del corriere.

Tipo: stringa

No
carrierPhoneNumber

Il numero di telefono del corriere.

Tipo: stringa

No
carrierURL

L'URL del sito web del corriere.

Tipo: stringa

No
shipDate

La data di spedizione del pacco.

Tipo: Timestamp

No
estimatedArrivalDate

La data di arrivo prevista.

Tipo: Timestamp

No
shipToAddress

La città di destinazione del pacco.

Tipo: TrackingAddress

No
currentStatus

Lo stato di consegna attuale del pacco.

Tipo: CurrentStatus

No
currentStatusDescription

Descrizione corrispondente al valore CurrentStatus.

Tipo: stringa

No
signedForBy

Il nome della persona che ha firmato per il pacco.

Tipo: stringa

No
additionalLocationInfo

Informazioni aggiuntive sulla posizione.

Tipo: AdditionalLocationInfo

No
trackingEvents

Un array di informazioni sugli eventi di tracciamento.

Tipo: TrackingEventList

No

Una risposta non riuscita ha un codice diverso da 2xx e include i seguenti oggetti. Se PackageNumber non esiste, una risposta 404 fornisce gli errori di ineleggibilità.

NomeDescrizione
errors

Si sono verificati uno o più errori imprevisti durante l'operazione getPackageTrackingDetails.

Tipo: ErrorList

Tutorial: Creare un ordine in stato di Attesa e poi spostarlo nello stato Spedito

Questo tutorial spiega come un ordine può passare da uno stato di gestione logistica di HOLD a SHIP. Gli ordini nello stato HOLD non procederà a ulteriori azioni di gestione logistica finché lo stato non sarà aggiornato a SHIP.

Prerequisiti

Per completare questo tutorial, hai bisogno di:

  1. Autorizzazione dal partner di vendita per il quale stai effettuando chiamate. Per ulteriori informazioni, vedi Autorizzazione delle applicazioni API per i partner di vendita.
  2. Il Ruolo di Logistica di Amazon assegnato al tuo profilo di sviluppatore.
  3. Il Ruolo di Logistica di Amazon selezionato nella pagina di registrazione dell'app per la tua domanda.

Passaggio 1. Ottieni l'anteprima di gestione logistica

Chiama l'operazione getFulfillmentPreview sull'ordine per garantire che gli SKU siano idonei e gestibili per le opzioni di spedizione richieste (Standard, Express, Prioritaria).

Parametro del corpoDescrizioneObbligatorio
marketplaceId

Il marketplace in cui viene effettuato l'ordine con gestione logistica.

Tipo: stringa

No
address

L'indirizzo di destinazione per l'anteprima dell'ordine con gestione logistica.

Tipo: Address

items

Informazioni identificative e informazioni sulla quantità per gli articoli nell'anteprima dell'ordine con gestione logistica.

Tipo: GetFulfillmentPreviewItemList

shippingSpeedCategories

Un elenco dei metodi di spedizione utilizzati per creare le anteprime degli ordini con gestione logistica.

Valori possibili:

  • Standard - Metodo di spedizione standard
  • Expedited - Metodo di spedizione Express
  • Priority - Metodo di spedizione prioritario.
  • ScheduledDelivery - Metodo di spedizione con consegna programmata solo per il Giappone.

Nota: i contratti di livello di servizio del metodo di spedizione variano in base al marketplace. I venditori devono consultare il sito web di Seller Central nel loro marketplace per quanto riguarda i contratti di livello di servizio per il metodo di spedizione e i costi di gestione.

No
includeCODFulfillmentPreview

Specifica se restituire le anteprime degli ordini di evasione in contrassegno (COD).

Valori possibili:

  • true - Riporta tutte le anteprime degli ordini con gestione logistica (sia per COD che non per COD).
  • false - Riporta solo le anteprime degli ordini con gestione logistica non destinate al pagamento alla consegna. Applicabile solo per gli ordini in Giappone.

  • Tipo: booleano

    No
    includeDeliveryWindows

    Specifica se riportare l'oggetto di risposta ScheduledDeliveryInfo, che contiene le finestre di consegna disponibili per una consegna pianificata. L'oggetto di risposta ScheduledDeliveryInfo può essere riportato solo per le anteprime degli ordini con gestione logistica con ShippingSpeedCategories = ScheduledDelivery. Applicabile solo per gli ordini in Giappone.

    Tipo: booleano

    No
    featureConstraints

    Un elenco delle funzionalità e delle relative politiche di gestione logistica da applicare all'ordine.

    Tipo: matrice < FeatureSettings >

    No

    Esempio di richiesta

    POST "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders/preview" { "marketplaceId": "ATVPDKIKX0DER", "address": { "name": "Mary Major", "addressLine1": "123 Any Street", "city": "Anytown", "stateOrRegion": "VA", "countryCode": "US", "postalCode": "22308" }, "items": [ { "sellerSku": "LT205BTBLKAM", "sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-1", "quantity": 2 } ], "shippingSpeedCategories": [ "Standard" ] }
    NomeDescrizione
    fulfillmentPreviews

    Un array di informazioni sull'anteprima di gestione logistica.

    Tipo: FulfillmentPreviewList

    Una risposta non riuscita ha un codice diverso da 2xx e include i seguenti oggetti. Una risposta 404 fornisce gli eventuali errori di inidoneità.

    NomeDescrizioneObbligatorio
    errors

    Si sono verificati uno o più errori imprevisti durante l'operazione getFulfillmentPreview.

    Tipo: ErrorList

    Passaggio 2. Crea un ordine con gestione logistica in sospeso.

    Chiama l'operazione createFulfillmentOrder con una o più voci con fulfillmentAction=Hold nella richiesta. In questo modo l'ordine viene mantenuto nello stato Hold e le ulteriori azioni con gestione logistica non verranno eseguite su quell'ordine.

    Parametro del corpoDescrizioneObbligatorio
    marketplaceId

    Il marketplace in cui viene effettuato l'ordine con gestione logistica.

    Tipo: stringa

    No
    sellerFulfillmentOrderId

    Un identificativo dell'ordine con gestione logistica creato dal venditore per tracciare il proprio ordine con gestione logistica. Il sellerFulfillmentOrderId deve essere univoco per ogni ordine con gestione logistica creato da un venditore. Se il sistema del venditore crea già identificatori d'ordine univoci, questi potrebbero essere valori validi da utilizzare.

    Lunghezza massima: 40

    Tipo: stringa

    displayableOrderId

    Un identificativo dell'ordine con gestione logistica creato dal venditore. Questo valore viene visualizzato come identificativo dell'ordine nei materiali rivolti al destinatario, ad esempio la distinta di imballaggio della spedizione in uscita. Il valore di DisplayableOrderId deve corrispondere all'identificativo dell'ordine che il venditore fornisce al destinatario. Il venditore può utilizzare SellerFulfillmentOrderId per questo valore oppure può specificare un valore alternativo se vuole che il destinatario faccia riferimento a un identificativo d'ordine alternativo. Il valore deve essere una stringa alfanumerica o conforme a ISO 8859-1 con una lunghezza compresa tra uno e 40 caratteri. Non può contenere due spazi in una riga. Gli spazi iniziali e finali vengono rimossi.

    Lunghezza massima: 40

    Tipo: stringa

    displayableOrderDate

    La data e l'ora dell'ordine con gestione logistica. Viene visualizzata come data dell'ordine nei materiali rivolti al destinatario, ad esempio la distinta di imballaggio della spedizione in uscita.

    Tipo: Timestamp

    displayableOrderComment

    Testo specifico dell'ordine che appare nei materiali rivolti al destinatario, come la distinta di imballaggio della spedizione in uscita.

    Lunghezza massima: 250

    Tipo: stringa

    shippingSpeedCategory

    Il metodo di spedizione per l'ordine con gestione logistica.

    Tipo: ShippingSpeedCategory

    deliveryWindow

    L'intervallo di tempo entro il quale deve essere consegnato un ordine con gestione logistica a consegna programmata.

    Tipo: DeliveryWindow

    No
    destinationAddress

    L'indirizzo di destinazione dell'ordine con gestione logistica.

    Tipo: Address

    deliveryPreferences

    Le preferenze di spedizione applicate all'indirizzo di destinazione. Queste preferenze vengono applicate quando possibile e sono il massimo sforzo possibile. Per gli ordini idonei, la preferenza di consegna predefinita è lasciare il pacco incustodito davanti alla porta d'ingresso. Questa funzionalità è attualmente supportata solo nel marketplace giapponese e non applicabile ad altri marketplace.

    Tipo: DeliveryPreferences

    No
    fulfillmentAction

    Specifica se l'ordine con gestione logistica deve essere spedito adesso o se l'ordine è bloccato.

    Tipo: FulfillmentAction

    No
    fulfillmentPolicy

    Il valore "FulfillmentPolicy" specificato quando hai inviato l'operazione createFulfillmentOrder.

    Tipo: FulfillmentPolicy

    No
    codSettings

    Gli addebiti COD che associ a un ordine di evasione COD.

    Tipo: CODSettings

    No
    shipFromCountryCode

    Il codice Paese a due caratteri per il Paese da cui viene spedito l'ordine con gestione logistica. Deve essere in formato ISO 3166-1 alpha-2. È Richiesto se si effettua una spedizione transfrontaliera.

    Tipo: stringa

    No
    notificationEmails

    Un elenco di indirizzi e-mail forniti dal venditore e utilizzati da Amazon per inviare notifiche di completamento della spedizione ai destinatari per conto del venditore.

    Tipo: NotificationEmailList

    No
    featureConstraints

    Un elenco delle funzionalità e delle relative politiche di gestione logistica da applicare all'ordine.

    Tipo: matrice < FeatureSettings >

    No
    Items

    Un elenco di articoli da includere nell'anteprima dell'ordine con gestione logistica, inclusa la quantità.

    Tipo: CreateFulfillmentOrderItemList

    Esempio di richiesta

    POST "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders" { "sellerFulfillmentOrderId": "CONSUMER-2022921-145045", "displayableOrderId": "CONSUMER-2022921-145045", "displayableOrderDate": "2022-01-09T19:46:45.809Z", "displayableOrderComment": "TestOrder", "shippingSpeedCategory": "Standard", "fulfillmentAction": "Hold", "destinationAddress": { "name": "Mary Major", "addressLine1": "123 Any Street", "city": "Alexandria", "stateOrRegion": "VA", "countryCode": "US", "postalCode": "22308" }, "items": [ { "sellerSku": "LT110WHTAM", "sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-0", "quantity": 1 }, { "sellerSku": "LT205BLKAM", "sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-1", "quantity": 1 } ] }

    Risposta

    Una risposta corretta ha un codice 200 e include i seguenti oggetti.

    Esempio di risposta

    {}

    Una risposta non riuscita ha un codice diverso da 2xx e include i seguenti oggetti.

    NomeDescrizione
    errors

    Si sono verificati uno o più errori imprevisti durante l'operazione createFulfillmentOrder.

    Tipo: ErrorList

    Passaggio 3. Aggiorna l'azione di gestione logistica dell'ordine per la spedizione

    Chiama l'operazione updateFulfillmentOrder per aggiornare l'ordine con fulfillmentAction = Ship nel corpo della richiesta per spostare l'ordine da Hold a Ship.

    ParametroDescrizioneObbligatorio
    sellerFulfillmentOrderId

    L'identificativo assegnato all'articolo dal venditore al momento della creazione dell'ordine con gestione logistica.

    Tipo: stringa

    Esempio di richiesta

    PUT "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders/CONSUMER-2022921-145045" { "fulfillmentAction": "Ship" }

    Risposta

    Una risposta corretta ha un codice 200.

    Una risposta non riuscita ha un codice diverso da 2xx e include i seguenti oggetti.

    NomeDescrizione
    errors

    Si sono verificati uno o più errori imprevisti durante l'operazione UpdateFulfillmentOrderResponse.

    Tipo: ErrorList

    Passaggio 4. Ottieni l'ordine con gestione logistica per convalidare le modifiche

    Una volta completato l'aggiornamento dell'ordine, chiama l'operazione getFulfillmentOrder per convalidare che il fulfillmentAction è aggiornato a Ship. Una volta che l'ordine passa all'azione Ship, i passaggi successivi di gestione logistica inizieranno a essere eseguite sull'ordine.

    ParametroDescrizioneObbligatorio
    sellerFulfillmentOrderId

    L'identificativo assegnato all'articolo dal venditore al momento della creazione dell'ordine con gestione logistica.

    Lunghezza massima: 40

    Tipo: stringa

    Esempio di richiesta

    GET "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders/CONSUMER-2022921-145045"

    Risposta

    Una risposta corretta ha un codice 200 con un payload.

    Esempio di risposta

    { "payload": { "fulfillmentOrder": { "sellerFulfillmentOrderId": "CONSUMER-2022921-145045", "marketplaceId": "ATVPDKIKX0DER", "displayableOrderId": "CONSUMER-2022921-145045", "displayableOrderDate": "2022-09-21T14:48:15Z", "displayableOrderComment": "TestOrder", "shippingSpeedCategory": "Standard", "destinationAddress": { "name": "Mary Major", "addressLine1": "123 Any Street", "city": "Alexandria", "stateOrRegion": "VA", "countryCode": "US", "postalCode": "22308" }, "fulfillmentAction": "Ship", "fulfillmentPolicy": "FillAllAvailable", "receivedDate": "2022-09-21T14:50:45Z", "fulfillmentOrderStatus": "Received", "statusUpdatedDate": "2022-09-22T03:44:35Z", "notificationEmails": [ "email@email.com" ], "featureConstraints": [ { "featureName": "BLANK_BOX", "featureFulfillmentPolicy": "NotRequired" } ] }, "fulfillmentOrderItems": [ { "sellerSku": "LT110WHTAM", "sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-0", "quantity": "1" }, { "sellerSku": "LT205BLKAM", "sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-1", "quantity": "1" } ], "fulfillmentShipments": [], "returnItems": [], "returnAuthorizations": [] } }
    Parametro del corpoDescrizioneObbligatorio
    fulfillmentOrder

    Informazioni generali su un ordine con gestione logistica, incluso il suo stato.

    Tipo: FulfillmentOrder

    fulfillmentOrderItems

    Un array di informazioni sugli articoli relativi agli ordini con gestione logistica.

    Tipo: FulfillmentOrderItemList

    fulfillmentShipments

    Un array di informazioni relative alla spedizione con gestione logistica.

    Tipo: FulfillmentShipmentList

    No
    returnItems

    Un array di articoli che Amazon ha accettato per il reso. Ritorna vuoto se nessun articolo è stato accettato per il reso.

    Tipo: ReturnItemList

    returnAuthorizations

    Un array di informazioni sull'autorizzazione del reso.

    Tipo: ReturnAuthorizationList

    Una risposta non riuscita ha un codice diverso da 2xx e include i seguenti oggetti.

    NomeDescrizioneObbligatorio
    errors

    Si sono verificati uno o più errori imprevisti durante l'operazione getFulfillmentOrder.

    Tipo: ErrorList

    Tutorial: Effettuare il monitoraggio di un ordine con il numero di serie di un articolo

    Per determinati prodotti, un venditore potrebbe aver bisogno di sapere quale istanza di un articolo è stata venduta a un determinato cliente. Se gli articoli vengono monitorati in modo univoco con un numero di serie, i centri logistici possono aggiungere passaggi per scansionare e registrare i numeri di serie sia in uscita che in fase di reso.

    Una volta spedito un articolo, l'operazione getFulfillmentOrder avrà il numero di serie nella risposta affinché il venditore ne tenga traccia.

    Prerequisiti

    1. Il venditore deve condividere l'espressione regolare dei numeri di serie generati con Amazon.
    2. Il venditore deve incollare il numero di serie univoco generato su ogni articolo quando invia l'inventario ad Amazon.
    3. Se il cliente utilizza il Servizio di etichettatura Amazon, oltre a registrare un ASIN, anche l'FNSKU associato all'articolo deve essere registrato utilizzando la stessa procedura.
    4. Autorizzazione dal partner di vendita per il quale stai effettuando chiamate. Per ulteriori informazioni, vedi Autorizzazione delle applicazioni API per i partner di vendita.
    5. Il Ruolo di Logistica di Amazon assegnato al tuo profilo di sviluppatore.
    6. Il Ruolo di Logistica di Amazon selezionato nella pagina di registrazione dell'app per la tua domanda.

    Passaggio 1. Crea un ordine con gestione logistica con articoli dotati di numeri di serie

    Chiama l'operazione createFulfillmentOrder per creare un ordine con gestione multicanale con articoli dotati di numeri di serie abilitati durante l'invio ad Amazon.
    La richiesta createFulfillmentOrder non avrà bisogno di attributi esclusivi nella richiesta per questo tipo di ordine.

    Parametro del corpoDescrizioneObbligatorio
    marketplaceId

    Il marketplace in cui viene effettuato l'ordine con gestione logistica.

    Tipo: stringa

    No
    sellerFulfillmentOrderId

    Un identificativo dell'ordine con gestione logistica creato dal venditore per tracciare il proprio ordine con gestione logistica. Il sellerFulfillmentOrderId deve essere univoco per ogni ordine con gestione logistica creato da un venditore. Se il sistema del venditore crea già identificatori d'ordine univoci, questi potrebbero essere valori validi da utilizzare.

    Lunghezza massima: 40

    Tipo: stringa

    displayableOrderId

    Un identificativo dell'ordine con evasione logistica creato dal venditore. Questo valore viene visualizzato come identificativo dell'ordine nei materiali rivolti al destinatario, ad esempio la distinta di imballaggio per spedizioni in uscita. Il valore di DisplayableOrderId deve corrispondere all'identificativo dell'ordine che il venditore fornisce al destinatario. Il venditore può utilizzare SellerFulfillmentOrderId per questo valore oppure può specificare un valore alternativo se vuole che il destinatario faccia riferimento a un identificativo dell'ordine alternativo.

    Il valore deve essere una stringa alfanumerica o conforme a ISO 8859-1 con una lunghezza compresa tra uno e 40 caratteri. Non può contenere due spazi in una riga. Gli spazi bianchi iniziali e finali vengono rimossi.

    displayableOrderDate

    La data e l'ora dell'ordine con gestione logistica. Viene visualizzata come data dell'ordine nei materiali rivolti al destinatario, ad esempio la distinta di imballaggio della spedizione in uscita.

    Tipo: Timestamp

    displayableOrderComment

    Testo specifico dell'ordine che appare nei materiali rivolti al destinatario, come la distinta di imballaggio della spedizione in uscita.

    Lunghezza massima: 250

    Tipo: stringa

    shippingSpeedCategory

    Il metodo di spedizione per l'ordine con gestione logistica.

    Tipo: ShippingSpeedCategory

    deliveryWindow

    L'intervallo di tempo entro il quale deve essere consegnato un ordine con gestione logistica a consegna programmata.

    Tipo: DeliveryWindow

    No
    destinationAddress

    L'indirizzo di destinazione dell'ordine con gestione logistica.

    Tipo: Address

    deliveryPreferences

    Le preferenze di spedizione applicate all'indirizzo di destinazione. Queste preferenze vengono applicate quando possibile e sono il massimo sforzo possibile. Per gli ordini idonei, la preferenza di consegna predefinita è lasciare il pacco incustodito davanti alla porta d'ingresso. Questa funzionalità è attualmente supportata solo nel marketplace giapponese e non applicabile ad altri marketplace.

    Tipo: DeliveryPreferences

    No
    fulfillmentAction

    Specifica se l'ordine con gestione logistica deve essere spedito adesso o se l'ordine è bloccato.

    Tipo: FulfillmentAction

    No
    fulfillmentPolicy

    Il valore FulfillmentPolicy specificato quando hai inviato l'operazione createFulfillmentOrder.

    Tipo: FulfillmentPolicy

    No
    codSettings

    Gli addebiti in contrassegno (COD) associati a un ordine di evasione in contrassegno.

    Tipo: CODSettings

    No
    shipFromCountryCode

    Il codice Paese a due caratteri per il Paese da cui viene spedito l'ordine con gestione logistica. Deve essere in formato ISO 3166-1 alpha-2. È Richiesto se si effettua una spedizione transfrontaliera.

    Tipo: stringa

    No
    notificationEmails

    Un elenco di indirizzi e-mail forniti dal venditore e utilizzati da Amazon per inviare notifiche di completamento della spedizione ai destinatari per conto del venditore.

    Tipo: NotificationEmailList

    No
    featureConstraints

    Un elenco delle funzionalità e delle relative politiche di gestione logistica da applicare all'ordine.

    Tipo:< FeatureSettings > array

    No
    Articoli

    Un elenco di articoli da includere nell'anteprima dell'ordine con gestione logistica, inclusa la quantità.

    Tipo: CreateFulfillmentOrderItemList

    Esempio di richiesta

    POST "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders" { "sellerFulfillmentOrderId": "CONSUMER-2022921-145045", "displayableOrderId": "CONSUMER-2022921-145045", "displayableOrderDate": "2022-01-09T19:46:45.809Z", "displayableOrderComment": "TestOrder", "shippingSpeedCategory": "Standard", "fulfillmentAction": "Ship", "destinationAddress": { "name": "Mary Major", "addressLine1": "123 Any Street", "city": "Alexandria", "stateOrRegion": "VA", "countryCode": "US", "postalCode": "22308" }, "items": [ { "sellerSku": "LT110WHTAM", "sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-0", "quantity": 1 } ] }

    Risposta

    Una risposta corretta ha un codice 200 e include i seguenti oggetti.

    Esempio di risposta

    {}

    Una risposta non riuscita ha un codice diverso da 2xx e include i seguenti oggetti.

    NomeDescrizione
    errors

    Si sono verificati uno o più errori imprevisti durante l'operazione createFulfillmentOrder.

    Tipo: ErrorList

    Passaggio 2. Ottieni l'ordine con gestione logistica per convalidare i dettagli dell'ordine

    Dopo aver creato con successo l'ordine, chiama l'operazione getFulfillmentOrder per convalidare fulfillmentAction = Ship e fulfillmentOrderStatus = Received sull'ordine.

    ParametroDescrizioneObbligatorio
    sellerFulfillmentOrderId

    L'identificativo assegnato all'articolo dal venditore al momento della creazione dell'ordine con gestione logistica.

    Lunghezza massima: 40

    Tipo: stringa

    Esempio di richiesta

    GET "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders/CONSUMER-2022921-145045"

    Risposta

    Una risposta corretta ha un codice 200 con un payload.

    Esempio di risposta

    { "payload": { "fulfillmentOrder": { "sellerFulfillmentOrderId": "CONSUMER-2022921-145045", "marketplaceId": "ATVPDKIKX0DER", "displayableOrderId": "CONSUMER-2022921-145045", "displayableOrderDate": "2022-01-09T19:46:45.809Z", "displayableOrderComment": "TestOrder", "shippingSpeedCategory": "Standard", "destinationAddress": { "name": "Mary Major", "addressLine1": "123 Any Street", "city": "Alexandria", "stateOrRegion": "VA", "countryCode": "US", "postalCode": "22308" }, "fulfillmentAction": "Ship", "fulfillmentPolicy": "FillAllAvailable", "receivedDate": "2022-09-21T14:50:45Z", "fulfillmentOrderStatus": "Received", "statusUpdatedDate": "2022-09-22T03:44:35Z", "notificationEmails": [ "email@email.com" ], "fulfillmentOrderItems": [ { "sellerSku": "LT110WHTAM", "sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-0", "quantity": "1" } ], "fulfillmentShipments": [], "returnItems": [], "returnAuthorizations": [] } } }
    Parametro del corpoDescrizioneObbligatorio
    fulfillmentOrder

    Informazioni generali su un ordine con gestione logistica, incluso il suo stato.

    Tipo: FulfillmentOrder

    fulfillmentOrderItems

    Un array di informazioni sugli articoli relativi agli ordini con gestione logistica.

    Tipo: FulfillmentOrderItemList

    fulfillmentShipments

    Un array di informazioni relative alla spedizione con gestione logistica.

    Tipo: FulfillmentShipmentList

    No
    returnItems

    Un array di articoli che Amazon ha accettato per il reso. Ritorna vuoto se nessun articolo è stato accettato per il reso.

    Tipo: ReturnItemList

    returnAuthorizations

    Un array di informazioni sull'autorizzazione del reso.

    Tipo: ReturnAuthorizationList

    Una risposta non riuscita ha un codice diverso da 2xx e include i seguenti oggetti.

    NomeDescrizioneObbligatorio
    errors

    Si sono verificati uno o più errori imprevisti durante l'operazione getFulfillmentOrder.

    Tipo: ErrorList

    Passaggio 3. Ottieni l'ordine con gestione logistica per tenere traccia delle modifiche di stato

    L'ordine subirà cambiamenti di stato, da Planning a Processing a Complete. Iscriviti e ascolta le notifiche FULFILLMENT_ORDER_STATUS per rimanere aggiornato su questi cambiamenti di stato.
    Quando l'ordine viene spedito, il numero di serie dell'articolo viene scansionato e convalidato in modo tale che corrisponda all'espressione regolare condivisa.
    Chiama l'operazione getFulfillmentOrder con sellerFulfillmentOrderId per visualizzare gli ultimi dettagli dell'ordine e verificare se il numero di serie dell'articolo è stato spedito.

    ParametroDescrizioneObbligatorio
    sellerFulfillmentOrderId

    L'identificativo assegnato all'articolo dal venditore al momento della creazione dell'ordine con gestione logistica.

    Lunghezza massima: 40

    Tipo: stringa

    Esempio di richiesta

    GET "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders/CONSUMER-2022921-145045 "

    Risposta

    Una risposta corretta ha un codice 200 con un payload.

    Esempio di risposta

    { "payload": { "fulfillmentOrder": { "sellerFulfillmentOrderId": "CONSUMER-2022921-145045", "marketplaceId": "ATVPDKIKX0DER", "displayableOrderId": "CONSUMER-2022921-145045", "displayableOrderDate": "2022-09-21T14:48:15Z", "displayableOrderComment": "TestOrder1", "shippingSpeedCategory": "Standard", "destinationAddress": { "name": "Mary Major", "addressLine1": "123 Any Street", "city": "Any Town", "stateOrRegion": "VA", "countryCode": "US", "postalCode": "22308" }, "fulfillmentAction": "Ship", "fulfillmentPolicy": "FillAllAvailable", "receivedDate": "2022-09-21T14:50:45Z", "fulfillmentOrderStatus": "Complete", "statusUpdatedDate": "2022-09-22T03:44:35Z", "notificationEmails": [ "email@email.com" ], "featureConstraints": [ { "featureName": "BLANK_BOX", "featureFulfillmentPolicy": "NotRequired" } ] }, "fulfillmentOrderItems": [ { "sellerSku": "LT110WHTAM", "sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-0", "quantity": "1", "fulfillmentNetworkSku": "X002ZKH36D", "orderItemDisposition": "Sellable", "cancelledQuantity": "0", "unfulfillableQuantity": "0", "estimatedShipDate": "2022-09-22T06:59:59Z", "estimatedArrivalDate": "2022-09-26T06:59:59Z", "perUnitDeclaredValue": { "currencyCode": "USD", "value": "100.00" } } ], "fulfillmentShipments": [ { "amazonShipmentId": "T7mfkbDX5", "fulfillmentCenterId": "TUL2", "fulfillmentShipmentStatus": "SHIPPED", "shippingDate": "2022-09-22T03:39:19Z", "estimatedArrivalDate": "2022-09-26T06:59:59Z", "fulfillmentShipmentItem": [ { "sellerSku": "LT110WHTAM", "sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-0", "quantity": "1", "packageNumber": "1681854637", "serialNumber": "355313088062664" } ], "fulfillmentShipmentPackage": [ { "packageNumber": "1681854637", "carrierCode": "Amazon Logistics", "trackingNumber": "TBA303037991486", "estimatedArrivalDate": "2022-09-26T03:00:00Z" } ] } ], "returnItems": [], "returnAuthorizations": [] } }
    Parametro del corpoDescrizioneObbligatorio
    fulfillmentOrder

    Informazioni generali su un ordine con gestione logistica, incluso il suo stato.

    Tipo: FulfillmentOrder

    fulfillmentOrderItems

    Un array di informazioni sugli articoli relativi agli ordini con gestione logistica.

    Tipo: FulfillmentOrderItemList

    fulfillmentShipments

    Un array di informazioni relative alla spedizione con gestione logistica.

    Tipo: FulfillmentShipmentList

    No
    returnItems

    Un array di articoli che Amazon ha accettato per il reso. Ritorna vuoto se nessun articolo è stato accettato per il reso.

    Tipo: ReturnItemList

    returnAuthorizations

    Un array di informazioni sull'autorizzazione del reso.

    Tipo: ReturnAuthorizationList

    Una risposta non riuscita ha un codice diverso da 2xx e include i seguenti oggetti.

    NomeDescrizioneObbligatorio
    errors

    Si sono verificati uno o più errori imprevisti durante l'operazione getFulfillmentOrder.

    Tipo: ErrorList

    Passaggio 4. Convalida lo stato dell'ordine e le quantità degli articoli

    Convalida fulfillmentShipmentStatus=Shipped e conferma che il serialNumber nel fulfillmentShipmentItem sia uguale a quello generato durante il processo di spedizione in entrata.

    Tutorial: Creare un ordine con gestione logistica transfrontaliera

    Questo tutorial illustra come un venditore che opera e vende in due Paesi diversi può gestire gli ordini attraverso un confine. Questa operazione è valida solo per libri, video, contenuti multimediali e dischi.

    In questo esempio, il venditore sta cercando di gestire un ordine da un magazzino canadese (CA) a un indirizzo negli Stati Uniti.

    Prerequisiti

    Per completare questo tutorial, hai bisogno di:

    1. Autorizzazione dal partner di vendita per il quale stai effettuando chiamate. Per ulteriori informazioni, vedi Autorizzazione delle applicazioni API per i partner di vendita.
    2. Il Ruolo di Logistica di Amazon assegnato al tuo profilo di sviluppatore.
    3. Il Ruolo di Logistica di Amazon selezionato nella pagina di registrazione dell'app per la tua domanda.

    Passaggio 1. Crea un ordine con gestione logistica per la spedizione transfrontaliera

    Crea un ordine con un indirizzo di destinazione negli Stati Uniti e shipFromCountryCode=CA. In questo caso, possiamo saltare l'operazione di specificare marketplaceId nella richiesta e l'articolo verrà prelevato dal marketplace CA. Inoltre, includi perUnitDeclaredValue negli articoli di valore superiore a 0. Chiama l'operazione createFulfillmentOrder passando i seguenti Parametri di corpo richiesti:

    Parametro del corpoDescrizioneObbligatorio
    marketplaceIdIl marketplace in cui viene effettuato l'ordine con gestione logistica.No
    sellerFulfillmentOrderId

    Un identificativo dell'ordine con gestione logistica creato dal venditore per tracciare il proprio ordine con gestione logistica. Il sellerFulfillmentOrderId deve essere univoco per ogni ordine con gestione logistica creato da un venditore. Se il sistema del venditore crea già identificatori d'ordine univoci, questi potrebbero essere valori validi da utilizzare.

    Lunghezza massima: 40

    Tipo: stringa

    displayableOrderId

    Un identificativo dell'ordine con gestione logistica creato dal venditore. Questo valore viene visualizzato come identificativo dell'ordine nei materiali rivolti al destinatario, ad esempio la distinta di imballaggio della spedizione in uscita. Il valore di DisplayableOrderId deve corrispondere all'identificativo dell'ordine che il venditore fornisce al destinatario. Il venditore può utilizzare SellerFulfillmentOrderId per questo valore oppure può specificare un valore alternativo se vuole che il destinatario faccia riferimento a un identificativo d'ordine alternativo. Il valore deve essere una stringa alfanumerica o conforme a ISO 8859-1 con una lunghezza compresa tra uno e 40 caratteri. Non può contenere due spazi in una riga. Gli spazi iniziali e finali vengono rimossi.

    Lunghezza massima: 40

    Tipo: stringa

    displayableOrderDate

    La data e l'ora dell'ordine con gestione logistica. Viene visualizzata come data dell'ordine nei materiali rivolti al destinatario, ad esempio la distinta di imballaggio della spedizione in uscita.

    Tipo: Timestamp

    displayableOrderComment

    Testo specifico dell'ordine che appare nei materiali rivolti al destinatario, come la distinta di imballaggio della spedizione in uscita.

    Lunghezza massima: 250

    Tipo: stringa

    shippingSpeedCategory

    Il metodo di spedizione per l'ordine con gestione logistica.

    Tipo: ShippingSpeedCategory

    deliveryWindow

    L'intervallo di tempo entro il quale deve essere consegnato un ordine con gestione logistica a consegna programmata.

    Tipo: DeliveryWindow

    No
    destinationAddress

    L'indirizzo di destinazione dell'ordine con gestione logistica.

    Tipo: Address

    deliveryPreferences

    Le preferenze di spedizione applicate all'indirizzo di destinazione. Queste preferenze vengono applicate quando possibile e sono il massimo sforzo possibile. Per gli ordini idonei, la preferenza di consegna predefinita è lasciare il pacco incustodito davanti alla porta d'ingresso. Questa funzionalità è attualmente supportata solo nel marketplace giapponese e non applicabile ad altri marketplace.

    Tipo: DeliveryPreferences

    No
    fulfillmentAction

    Specifica se l'ordine con gestione logistica deve essere spedito adesso o se l'ordine è bloccato.

    Tipo: FulfillmentAction

    No
    fulfillmentPolicy

    Il valore FulfillmentPolicy specificato quando hai inviato l'operazione createFulfillmentOrder.

    Tipo: FulfillmentPolicy

    No
    codSettings

    Gli addebiti in contrassegno (COD) associati a un ordine di evasione in contrassegno.

    Tipo: CODSettings

    No
    shipFromCountryCode

    Il codice Paese a due caratteri per il Paese da cui viene spedito l'ordine con gestione logistica. Deve essere in formato ISO 3166-1 alpha-2. È Richiesto se si effettua una spedizione transfrontaliera.

    Tipo: stringa

    No
    notificationEmails

    Un elenco di indirizzi e-mail forniti dal venditore e utilizzati da Amazon per inviare notifiche di completamento della spedizione ai destinatari per conto del venditore.

    Tipo: NotificationEmailList

    No
    featureConstraints

    Un elenco delle funzionalità e delle relative politiche di gestione logistica da applicare all'ordine.

    Tipo: matrice < FeatureSettings >

    No
    Items

    Un elenco di articoli da includere nell'anteprima dell'ordine con gestione logistica, inclusa la quantità.

    Tipo: CreateFulfillmentOrderItemList

    Esempio di richiesta

    POST "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders" { "sellerFulfillmentOrderId": "CONSUMER-2022921-145045", "displayableOrderId": "CONSUMER-2022921-145045", "displayableOrderDate": "2022-01-09T19:46:45.809Z", "displayableOrderComment": "TestOrder", "shippingSpeedCategory": "Standard", "fulfillmentAction": "Ship", "shipFromCountryCode": "CA", "destinationAddress": { "name": "Mary Major", "addressLine1": "Stockton Street", "city": "Alexandria", "stateOrRegion": "VA", "countryCode": "US", "postalCode": "22308" }, "items": [ { "sellerSku": "LT205BLKAM", "sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-0", "quantity": 1, "perUnitDeclaredValue": { "currencyCode": "USD", "value": "0.10" } } ] }

    Risposta

    Una risposta corretta ha un codice 200 e include i seguenti oggetti.

    Esempio di risposta

    {}

    Una risposta non riuscita ha un codice diverso da 2xx e include i seguenti oggetti.

    NomeDescrizione
    errors

    Si sono verificati uno o più errori imprevisti durante l'operazione createFulfillmentOrder.

    Tipo: ErrorList

    Tutorial: Creare ordini con le funzionalità richieste Blank Box e Block AMZL

    Durante la creazione di un ordine, la Gestione multicanale offre due funzionalità che possono essere specificate nella richiesta:

    • Scatola vuota: consente al venditore di scegliere la confezione senza loghi/etichette Amazon.

    • Blocca AMZL: consente al venditore di rifiutare la logistica di Amazon e di effettuare la spedizione utilizzando un altro servizio di corriere.

    Una volta effettuata la richiesta durante il processo di creazione dell'ordine, non può essere aggiornata durante i passaggi di gestione logistica dell'ordine.

    Prerequisiti

    Per completare questo tutorial, hai bisogno di:

    1. Autorizzazione dal partner di vendita per il quale stai effettuando chiamate. Per ulteriori informazioni, vedi Autorizzazione delle applicazioni API per i partner di vendita.
    2. Il Ruolo di Logistica di Amazon assegnato al tuo profilo di sviluppatore.
    3. Il Ruolo di Logistica di Amazon selezionato nella pagina di registrazione dell'app per la tua domanda.

    Passaggio 1. Ottieni un'anteprima di gestione logistica per determinati vincoli di funzionalità

    Chiama l'operazione getFulfillmentPreview sulle voci dell'ordine utilizzando una determinata opzione di spedizione e un vincolo di funzionalità per garantire che le funzionalità siano disponibili per la gestione logistica degli ordini per il marketplace e l'indirizzo.

    Chiama l'operazione getFulfillmentPreview passando i seguenti parametri di corpo:

    Parametro del corpoDescrizioneObbligatorio
    marketplaceId

    Il marketplace in cui viene effettuato l'ordine con gestione logistica.

    Tipo: stringa

    No
    address

    L'indirizzo di destinazione per l'anteprima dell'ordine con gestione logistica.

    Tipo: Address

    items

    Informazioni identificative e informazioni sulla quantità per gli articoli nell'anteprima dell'ordine con gestione logistica.

    Tipo: GetFulfillmentPreviewItemList

    shippingSpeedCategories

    Un elenco dei metodi di spedizione utilizzati per creare le anteprime degli ordini con gestione logistica.

    Valori possibili:

    • Standard - Metodo di spedizione standard.
    • Expedited - Metodo di spedizione Express.
    • Priority - Metodo di spedizione prioritario.
    • ScheduledDelivery - Metodo di spedizione con consegna programmata solo per il Giappone.

    Nota: i contratti di livello di servizio del metodo di spedizione variano in base al marketplace. I venditori devono consultare il sito web di Seller Central nel loro marketplace per quanto riguarda i contratti di livello di servizio per il metodo di spedizione e i costi di gestione.

    No
    includeCODFulfillmentPreview

    Specifica se restituire le anteprime degli ordini di evasione in contrassegno (COD).

    Valori possibili:

    • true - Riporta tutte le anteprime degli ordini con gestione logistica (sia per COD che non per COD).
    • false - Riporta solo le anteprime degli ordini con gestione logistica non destinate al pagamento alla consegna. Applicabile solo per gli ordini in Giappone.

    Tipo: booleano

    No
    includeDeliveryWindows

    Specifica se riportare l'oggetto di risposta ScheduledDeliveryInfo, che contiene le finestre di consegna disponibili per una consegna pianificata. L'oggetto di risposta ScheduledDeliveryInfo può essere riportato solo per le anteprime degli ordini con gestione logistica con ShippingSpeedCategories = ScheduledDelivery. Applicabile solo per gli ordini in Giappone.

    Tipo: booleano

    No
    featureConstraints

    Un elenco delle funzionalità e delle relative politiche di gestione logistica da applicare all'ordine.

    Tipo: matrice < FeatureSettings >

    No

    Esempio di richiesta

    POST "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders/preview" { "marketplaceId": "ATVPDKIKX0DER", "address": { "name": "Mary Major", "addressLine1": "123 Any Street", "city": "Alexandria", "stateOrRegion": "VA", "countryCode": "US", "postalCode": "22308" }, "items": [ { "sellerSku": "LT205BTBLKAM", "sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-1", "quantity": 2 } ], "featureConstraints": [ { "featureName": "BLANK_BOX", "featureFulfillmentPolicy": "Required" }, { "featureName": "BLOCK_AMZL", "featureFulfillmentPolicy": "Required" } ], "shippingSpeedCategories": [ "Standard" ] }

    Risposta

    Una risposta positiva ha un codice 200 e lo schema di risposta per l'operazione getFulfillmentPreview.

    Esempio di risposta

    { "payload": { "fulfillmentPreviews": [ { "shippingSpeedCategory": "Standard", "isFulfillable": true, "isCODCapable": false, "estimatedShippingWeight": { "unit": "POUNDS", "value": "0.441" }, "estimatedFees": [ { "name": "FBAPerOrderFulfillmentFee", "amount": { "currencyCode": "USD", "value": "0.0" } }, { "name": "FBATransportationFee", "amount": { "currencyCode": "USD", "value": "0.0" } }, { "name": "FBAPerUnitFulfillmentFee", "amount": { "currencyCode": "USD", "value": "10.31" } } ], "fulfillmentPreviewShipments": [ { "earliestShipDate": "2022-12-13T08:00:00Z", "latestShipDate": "2022-12-14T07:59:59Z", "earliestArrivalDate": "2022-12-15T08:00:00Z", "latestArrivalDate": "2022-12-16T07:59:59Z", "fulfillmentPreviewItems": [ { "sellerSku": "LT205BTBLKAM", "quantity": 2, "sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-1", "estimatedShippingWeight": { "unit": "POUNDS", "value": "0.379" }, "shippingWeightCalculationMethod": "Dimensional" } ] } ], "unfulfillablePreviewItems": [], "marketplaceId": "ATVPDKIKX0DER" } ] } }
    NomeDescrizione
    FulfillmentPreviews

    Un array di informazioni sull'anteprima di gestione logistica.

    Tipo: FulfillmentPreviewList

    Una risposta non riuscita ha un codice diverso da 2xx e include i seguenti oggetti. Una risposta 404 fornisce gli eventuali errori di inidoneità.

    NomeDescrizioneObbligatorio
    errors

    Si sono verificati uno o più errori imprevisti durante l'operazione getFulfillmentPreview.

    Tipo: ErrorList

    Passaggio 2. Crea un ordine con gestione logistica specificando i vincoli di funzionalità

    Chiama l'operazione createFulfillmentOrder per creare un ordine di gestione multicanale specificando i vincoli di funzionalità richiesti per l'ordine.

    📘

    Vincoli delle funzionalità:

    I vincoli delle funzionalità possono essere abilitati nel portale Seller Central che fungerà da valore predefinito, ma il valore specificato nella richiesta d'ordine ha la priorità.

    Parametro del corpoDescrizioneObbligatorio
    marketplaceId

    Il marketplace in cui viene effettuato l'ordine con gestione logistica.

    Tipo: stringa

    No
    sellerFulfillmentOrderId

    Un identificativo dell'ordine con gestione logistica creato dal venditore per tracciare il proprio ordine con gestione logistica. Il sellerFulfillmentOrderId deve essere univoco per ogni ordine con gestione logistica creato da un venditore. Se il sistema del venditore crea già identificatori d'ordine univoci, questi potrebbero essere valori validi da utilizzare.

    Lunghezza massima: 40

    Tipo: stringa

    displayableOrderId

    Un identificativo dell'ordine con gestione logistica creato dal venditore. Questo valore viene visualizzato come identificativo dell'ordine nei materiali rivolti al destinatario, ad esempio la distinta di imballaggio della spedizione in uscita. Il valore di "DisplayableOrderId" deve corrispondere all'identificativo dell'ordine che il venditore fornisce al destinatario. Il venditore può utilizzare SellerFulfillmentOrderId per questo valore oppure può specificare un valore alternativo se vuole che il destinatario faccia riferimento a un identificativo d'ordine alternativo. Il valore deve essere una stringa alfanumerica o conforme a ISO 8859-1 con una lunghezza compresa tra uno e 40 caratteri. Non può contenere due spazi in una riga. Gli spazi iniziali e finali vengono rimossi.

    Lunghezza massima: 40

    Tipo: stringa

    displayableOrderDate

    La data e l'ora dell'ordine con gestione logistica. Viene visualizzata come data dell'ordine nei materiali rivolti al destinatario, ad esempio la distinta di imballaggio della spedizione in uscita.

    Tipo: Timestamp

    displayableOrderComment

    Testo specifico dell'ordine che appare nei materiali rivolti al destinatario, come la distinta di imballaggio della spedizione in uscita.

    Lunghezza massima: 250

    Tipo: stringa

    shippingSpeedCategory

    Il metodo di spedizione per l'ordine con gestione logistica. Tipo: ShippingSpeedCategory

    deliveryWindow

    L'intervallo di tempo entro il quale deve essere consegnato un ordine con gestione logistica a consegna programmata.

    Tipo: DeliveryWindow

    No
    destinationAddress

    L'indirizzo di destinazione dell'ordine con gestione logistica. Tipo: Address

    deliveryPreferences

    Le preferenze di spedizione applicate all'indirizzo di destinazione. Queste preferenze vengono applicate quando possibile e sono il massimo sforzo possibile. Per gli ordini idonei, la preferenza di consegna predefinita è lasciare il pacco incustodito davanti alla porta d'ingresso. Questa funzionalità è attualmente supportata solo nel marketplace giapponese e non applicabile ad altri marketplace.

    Tipo: DeliveryPreferences

    No
    fulfillmentAction

    Specifica se l'ordine con gestione logistica deve essere spedito adesso o se l'ordine è bloccato.

    Tipo: FulfillmentAction

    No
    fulfillmentPolicy

    Il valore FulfillmentPolicy specificato quando hai inviato l'operazione createFulfillmentOrder.

    Tipo: FulfillmentPolicy

    No
    codSettings

    Gli addebiti COD che associ a un ordine di evasione COD.

    Tipo: CODSettings

    No
    shipFromCountryCode

    Il codice Paese a due caratteri per il Paese da cui viene spedito l'ordine con gestione logistica. Deve essere in formato ISO 3166-1 alpha-2. È Richiesto se si effettua una spedizione transfrontaliera.

    Tipo: stringa

    No
    notificationEmails

    Un elenco di indirizzi e-mail forniti dal venditore e utilizzati da Amazon per inviare notifiche di completamento della spedizione ai destinatari per conto del venditore.

    Tipo: NotificationEmailList

    No
    featureConstraints

    Un elenco delle funzionalità e delle relative politiche di gestione logistica da applicare all'ordine.

    Tipo:< FeatureSettings > array

    No
    Items

    Un elenco di articoli da includere nell'anteprima dell'ordine con gestione logistica, inclusa la quantità.

    Tipo: CreateFulfillmentOrderItemList

    Esempio di richiesta

    POST "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders" { "sellerFulfillmentOrderId": "CONSUMER-2022921-145045", "displayableOrderId": "CONSUMER-2022921-145045", "displayableOrderDate": "2022-01-09T19:46:45.809Z", "displayableOrderComment": "TestOrder", "shippingSpeedCategory": "Priority", "fulfillmentAction": "Ship", "destinationAddress": { "name": "Mary Major", "addressLine1": "123 Any Street", "city": "Alexandria", "stateOrRegion": "VA", "countryCode": "US", "postalCode": "22308" }, "items": [ { "sellerSku": "LT205BTBLKAM", "sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-0", "quantity": 1 } ], "featureConstraints": [ { "featureName": "BLANK_BOX", "featureFulfillmentPolicy": "Required" }, { "featureName": "BLOCK_AMZL", "featureFulfillmentPolicy": "Required" } ] }

    Risposta

    Una risposta corretta ha un codice 200 e include i seguenti oggetti.

    Esempio di risposta

    {}

    Una risposta non riuscita ha un codice diverso da 2xx e include i seguenti oggetti.

    NomeDescrizione
    errors

    Si sono verificati uno o più errori imprevisti durante l'operazione createFulfillmentOrder.

    Tipo: ErrorList

    Passaggio 3. Ottieni l'ordine con gestione logistica per convalidare i dettagli dell'ordine

    Dopo aver creato con successo un ordine, chiama l'operazione getFulfillmentOrder per convalidare che fulfillmentAction = Ship, fulfillmentOrderStatus = Received, e featureConstraints vengono riportati nella risposta relativa ai dettagli dell'ordine.

    ParametroDescrizioneObbligatorio
    sellerFulfillmentOrderId

    L'identificativo assegnato all'articolo dal venditore al momento della creazione dell'ordine con gestione logistica.

    Lunghezza massima: 40

    Tipo: stringa

    Esempio di richiesta

    GET "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders/CONSUMER-2022921-145045"

    Risposta

    Una risposta corretta ha un codice 200 con un payload.

    Esempio di risposta

    { "payload": { "fulfillmentOrder": { "sellerFulfillmentOrderId": "CONSUMER-2022921-145045", "marketplaceId": "ATVPDKIKX0DER", "displayableOrderId": "CONSUMER-2022921-145045", "displayableOrderDate": "2022-01-09T19:46:45.809Z", "displayableOrderComment": "TestOrder", "shippingSpeedCategory": "Priority", "destinationAddress": { "name": "Mary Major", "addressLine1": "123 Any Street", "city": "Alexandria", "stateOrRegion": "VA", "countryCode": "US", "postalCode": "22308" }, "fulfillmentAction": "Ship", "fulfillmentPolicy": "FillAllAvailable", "receivedDate": "2022-09-21T14:50:45Z", "fulfillmentOrderStatus": "Received", "statusUpdatedDate": "2022-09-22T03:44:35Z", "notificationEmails": [ "email@email.com" ], "featureConstraints": [ { "featureName": "BLANK_BOX", "featureFulfillmentPolicy": "Required" }, { "featureName": "BLOCK_AMZL", "featureFulfillmentPolicy": "Required" } ] }, "fulfillmentOrderItems": [ { "sellerSku": "LT205BLKAM", "sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-0", "quantity": "1", "perUnitDeclaredValue": { "currencyCode": "USD", "value": "0.00" } } ], "fulfillmentShipments": [], "returnItems": [], "returnAuthorizations": [] } }
    Parametro del corpoDescrizioneObbligatorio
    fulfillmentOrder

    Informazioni generali su un ordine con gestione logistica, incluso il suo stato.

    Tipo: FulfillmentOrder

    fulfillmentOrderItems

    Un array di informazioni sugli articoli relativi agli ordini con gestione logistica.

    Tipo: FulfillmentOrderItemList

    fulfillmentShipments

    Un array di informazioni relative alla spedizione con gestione logistica.

    Tipo: FulfillmentShipmentList

    No
    returnItems

    Un array di articoli che Amazon ha accettato per il reso. Ritorna vuoto se nessun articolo è stato accettato per il reso.

    Tipo: ReturnItemList

    returnAuthorizations

    Un array di informazioni sull'autorizzazione del reso.

    Tipo: ReturnAuthorizationList

    Una risposta non riuscita ha un codice diverso da 2xx e include i seguenti oggetti.

    NomeDescrizioneObbligatorio
    errors

    Si sono verificati uno o più errori imprevisti durante l'operazione getFulfillmentOrder.

    Tipo: ErrorList

    Tutorial: Mostrare i dettagli dell'anteprima di tutte le velocità di spedizione

    Se l'operazione getFulfillmentPreview viene chiamata senza menzionare alcuna velocità di spedizione nella richiesta, la risposta mostrerà i dettagli dell'anteprima di tutte le velocità di spedizione.

    Prerequisiti

    Per completare questo tutorial, hai bisogno di:

    1. Autorizzazione dal partner di vendita per il quale stai effettuando chiamate. Per ulteriori informazioni, vedi Autorizzazione delle applicazioni API per i partner di vendita.
    2. Il Ruolo di Logistica di Amazon assegnato al tuo profilo di sviluppatore.
    3. Il Ruolo di Logistica di Amazon selezionato nella pagina di registrazione dell'app per la tua domanda.

    Passaggio 1. Ottieni un'anteprima della gestione logistica per tutte le velocità di spedizione

    Per recuperare i dettagli dell'anteprima di un ordine per tutte le velocità di spedizione, salta l'attributo shippingCategories nella richiesta di recuperare i dettagli di anteprima per tutte le velocità di spedizione.

    Chiama l'operazione getFulfillmentPreview passando i seguenti parametri di corpo:

    Parametro del corpoDescrizioneObbligatorio
    marketplaceId

    Il marketplace in cui viene effettuato l'ordine con gestione logistica.

    Tipo: stringa

    No
    address

    L'indirizzo di destinazione per l'anteprima dell'ordine con gestione logistica.

    Tipo: Address

    items

    Informazioni identificative e informazioni sulla quantità per gli articoli nell'anteprima dell'ordine con gestione logistica.

    Tipo: GetFulfillmentPreviewItemList

    shippingSpeedCategories

    Un elenco dei metodi di spedizione utilizzati per creare le anteprime degli ordini con gestione logistica.

    Valori possibili:

    • Standard - Metodo di spedizione standard.
    • Express: metodo di spedizione Express.
    • Priorità - Metodo di spedizione prioritario.
    • ScheduledDelivery - Metodo di spedizione con consegna programmata solo per il Giappone.

    Nota: i contratti di livello di servizio del metodo di spedizione variano in base al marketplace. I venditori devono consultare il sito web di Seller Central nel loro marketplace per quanto riguarda i contratti di livello di servizio per il metodo di spedizione e i costi di gestione.

    No
    includeCODFulfillmentPreview

    Specifica se restituire le anteprime degli ordini di evasione in contrassegno (COD).

    Valori possibili:

    • true - Riporta tutte le anteprime degli ordini con gestione logistica (sia per COD che non per COD).
    • false - Riporta solo le anteprime degli ordini con gestione logistica non destinate al pagamento alla consegna. Applicabile solo per gli ordini in Giappone.

    Tipo: booleano

    No
    includeDeliveryWindows

    Specifica se riportare l'oggetto di risposta ScheduledDeliveryInfo, che contiene le finestre di consegna disponibili per una consegna pianificata. L'oggetto di risposta ScheduledDeliveryInfo può essere riportato solo per le anteprime degli ordini con gestione logistica con ShippingSpeedCategories = ScheduledDelivery. Applicabile solo per gli ordini in Giappone.

    Tipo: booleano

    No
    featureConstraints

    Un elenco delle funzionalità e delle relative politiche di gestione logistica da applicare all'ordine.

    Tipo: < FeatureSettings >

    No

    Esempio di richiesta

    POST "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders/preview" { "marketplaceId": "ATVPDKIKX0DER", "address": { "name": "Amazon", "addressLine1": "123 Any Street", "addressLine2": "Building2010", "addressLine3": "Lane1", "stateOrRegion": "MI", "countryCode": "US", "country": "US", "city": "Troy", "postalCode": "48084", "phone": "480-441-2465" }, "items": [ { "quantity": 5, "sellerFulfillmentOrderItemId": "04740712772466", "sellerSku": "LT205BLKAM" } ], "featureConstraints": [ { "featureName": "BLANK_BOX", "featureFulfillmentPolicy": "NotRequired" }, { "featureName": "BLOCK_AMZL", "featureFulfillmentPolicy": "Required" } ] }

    Esempio di risposta

    Una risposta positiva ha un codice 200 e lo schema di risposta per l'operazione getFulfillmentPreview.

    { "payload": { "fulfillmentPreviews": [ { "estimatedFees": [ { "amount": { "currencyCode": "USD", "value": "10" }, "name": "FBAPerUnitFulfillmentFee" } ], "estimatedShippingWeight": { "unit": "POUNDS", "value": "37.55115842140852" }, "featureConstraints": [ { "featureFulfillmentPolicy": "NotRequired", "featureName": "BLANK_BOX" }, { "featureFulfillmentPolicy": "Required", "featureName": "BLOCK_AMZL" } ], "fulfillmentPreviewShipments": [ { "earliestArrivalDate": "2022-12-11T20:35:15Z", "earliestShipDate": "2022-12-09T20:35:15Z", "fulfillmentPreviewItems": [ { "estimatedShippingWeight": { "unit": "POUNDS", "value": "13.44454399298887" }, "quantity": 5, "sellerFulfillmentOrderItemId": "04740712772466", "sellerSku": "LT205BLKAM", "shippingWeightCalculationMethod": "Package" } ], "latestArrivalDate": "2022-12-12T20:35:15Z", "latestShipDate": "2022-12-10T20:35:15Z", "shippingNotes": [] } ], "isCodCapable": false, "isFulfillable": true, "marketplaceId": "ATVPDKIKX0DER", "orderUnfulfillableReasons": [], "shippingSpeedCategory": "Standard", "unfulfillablePreviewItems": [] }, { "estimatedFees": [ { "amount": { "currencyCode": "USD", "value": "25" }, "name": "FBAPerUnitFulfillmentFee" } ], "estimatedShippingWeight": { "unit": "POUNDS", "value": "13.005463669980378" }, "featureConstraints": [ { "featureFulfillmentPolicy": "NotRequired", "featureName": "BLANK_BOX" }, { "featureFulfillmentPolicy": "Required", "featureName": "BLOCK_AMZL" } ], "fulfillmentPreviewShipments": [ { "earliestArrivalDate": "2022-12-09T20:35:15Z", "earliestShipDate": "2022-12-08T20:35:15Z", "fulfillmentPreviewItems": [ { "estimatedShippingWeight": { "unit": "POUNDS", "value": "6.396357461045615" }, "quantity": 5, "sellerFulfillmentOrderItemId": "04740712772466", "sellerSku": "LT205BLKAM", "shippingWeightCalculationMethod": "Package" } ], "latestArrivalDate": "2022-12-10T20:35:15Z", "latestShipDate": "2022-12-09T20:35:15Z", "shippingNotes": [] } ], "isCodCapable": false, "isFulfillable": true, "marketplaceId": "ATVPDKIKX0DER", "orderUnfulfillableReasons": [], "shippingSpeedCategory": "Expedited", "unfulfillablePreviewItems": [] }, { "estimatedFees": [ { "amount": { "currencyCode": "USD", "value": "10" }, "name": "FBAPerUnitFulfillmentFee" } ], "estimatedShippingWeight": { "unit": "POUNDS", "value": "37.09772884213881" }, "featureConstraints": [ { "featureFulfillmentPolicy": "NotRequired", "featureName": "BLANK_BOX" }, { "featureFulfillmentPolicy": "Required", "featureName": "BLOCK_AMZL" } ], "fulfillmentPreviewShipments": [ { "earliestArrivalDate": "2022-12-08T20:35:15Z", "earliestShipDate": "2022-12-07T20:35:15Z", "fulfillmentPreviewItems": [ { "estimatedShippingWeight": { "unit": "POUNDS", "value": "28.261562502894723" }, "quantity": 5, "sellerFulfillmentOrderItemId": "04740712772466", "sellerSku": "LT205BLKAM", "shippingWeightCalculationMethod": "Package" } ], "latestArrivalDate": "2022-12-09T20:35:15Z", "latestShipDate": "2022-12-08T20:35:15Z", "shippingNotes": [] } ], "isCodCapable": false, "isFulfillable": true, "marketplaceId": "ATVPDKIKX0DER", "orderUnfulfillableReasons": [], "shippingSpeedCategory": "Priority", "unfulfillablePreviewItems": [] } ] } }
    NomeDescrizione
    FulfillmentPreviews

    Un array di informazioni sull'anteprima di gestione logistica.

    Tipo: FulfillmentPreviewList

    Una risposta non riuscita ha un codice diverso da 2xx e include i seguenti oggetti. Una risposta 404 fornisce gli eventuali errori di inidoneità.

    NomeDescrizioneObbligatorio
    errors

    Si sono verificati uno o più errori imprevisti durante l'operazione getFulfillmentPreview.

    Tipo: ErrorList

    Tutorial: Visualizzare le notifiche degli ordini con l'API Notifiche

    Un venditore può iscriversi alle FULFILLMENT_ORDER_STATUS per rimanere aggiornato su tutti i cambiamenti in corso dell'ordine.

    Per completare questo tutorial, hai bisogno di:

    1. Autorizzazione dal partner di vendita per il quale stai effettuando chiamate. Per ulteriori informazioni, vedi Autorizzazione delle applicazioni API per i partner di vendita.
    2. Il Ruolo di Logistica di Amazon assegnato al tuo profilo di sviluppatore.
    3. Il Ruolo di Logistica di Amazon selezionato nella pagina di registrazione dell'app per la tua domanda.

    Passaggio 1. Crea e iscriviti alle notifiche

    Fai riferimento all'API Notifiche per creare e gestire le iscrizioni.

    Passaggio 2. Ascolta le notifiche sullo stato degli ordini

    La notifica Fulfillment_Order_Status mantiene il venditore aggiornato sui cambiamenti dello stato dell'ordine.
    Rivedi l'array FulfillmentShipmentPackages nella risposta per ottenere i dettagli del pacco di un ordine una volta che è pronto per la spedizione.

    Esempio di risposta

    { "NotificationVersion": "1.0", "NotificationType": "FULFILLMENT_ORDER_STATUS", "PayloadVersion": "1.0", "EventTime": "2020-07-13T19:42:04.284Z", "Payload": { "FulfillmentOrderStatusNotification": { "SellerId": "A3TH9S8BH6GOGM", "EventType": "Order", "StatusUpdatedDateTime": "2020-07-13T19:42:04.284Z", "SellerFulfillmentOrderId": "amazonbooks.KLA1.202203072322.6911", "FulfillmentOrderStatus": "Complete", "FulfillmentShipment": { "FulfillmentShipmentStatus": "Shipped", "AmazonShipmentId": "ASID49535", "EstimatedArrivalDateTime": "2020-07-13T19:42:04.284Z", "FulfillmentShipmentPackages": [ { "PackageNumber": 1, "CarrierCode": "2-930434", "TrackingNumber": "1Z84456456573405" }, { "PackageNumber": 2, "CarrierCode": "1-930434", "TrackingNumber": "1Z84456456573405" }, { "PackageNumber": 3, "CarrierCode": "3-930434", "TrackingNumber": "1Z885647654573405" } ] }, "FulfillmentReturnItem": { "ReceivedDateTime": "2020-07-13T19:42:04.284Z", "ReturnedQuantity": 12, "SellerSKU": "SELLERSKU9345" } } }, "NotificationMetadata": { "ApplicationId": "app-id-d0e9e693-c3ad-4373-979f-ed4ec98dd746", "SubscriptionId": "subscription-id-d0e9e693-c3ad-4373-979f-ed4ec98dd746", "PublishTime": "2020-07-13T19:42:04.284Z", "NotificationId": "d0e9e693-c3ad-4373-979f-ed4ec98dd746" } }
    Parametro del corpoDescrizioneObbligatorio
    EventType

    Indica se la notifica contiene informazioni sull'ordine, sulla spedizione o sul reso.

    Valori EventType:

    • Ordine - Questa notifica contiene informazioni su un ordine con gestione logistica.
    • Spedizione: questa notifica contiene informazioni su una spedizione con adempimento. Per ulteriori informazioni, consulta la FulfillmentShipment oggetto.
    • Reso: questa notifica contiene informazioni su un reso di gestione logistica.

    Tipo: stringa

    SellerId

    L'identificativo del venditore.

    Tipo: stringa

    No
    StatusUpdatedDateTime

    La data e l'ora dell'ultimo aggiornamento dello stato. Nel ISO 8601 formato.

    Tipo: stringa

    SellerFulfillmentOrderId

    L'identificativo dell'ordine con gestione logistica che hai creato e inviato utilizzando l'operazione CreateFulfillmentOrder.

    Tipo: stringa

    FulfillmentOrderStatus

    Lo stato attuale dell'ordine con gestione logistica.

    Valori FulfillmentOrderStatus:

    • Received - L'ordine con gestione logistica è stato ricevuto e convalidato. La convalida include la determinazione della validità dell'indirizzo di destinazione e della verifica che i registri di Amazon indicano che il venditore dispone di un inventario vendibile sufficiente (non danneggiato) per gestire l'ordine. Il venditore può annullare un ordine con gestione logistica che ha lo stato di Received.
    • Invalid - L'ordine con gestione logistica è stato ricevuto ma non è stato possibile convalidarlo. I motivi includono un indirizzo di destinazione non valido o i registri di Amazon che indicano che il venditore non dispone di inventario vendibile sufficiente per gestire l'ordine. In tal caso, l'ordine con gestione logistica non è valido e nessun articolo dell'ordine verrà spedito.
    • Planning - L'ordine con gestione logistica è stato inviato alla rete logistica di Amazon per iniziare la pianificazione della spedizione, ma nessuna unità di nessuna spedizione è stata ancora prelevata dall'inventario. Il venditore può annullare un ordine con gestione logistica con lo stato di Planning.
    • Processing - Il processo di prelievo delle unità dall'inventario è iniziato per almeno una spedizione dell'ordine con gestione logistica. Il venditore non può annullare un ordine con gestione logistica con lo stato di Processing.
    • Cancelled - L'ordine di evasione con gestione logistica è stato annullato dal venditore.
    • Complete - Tutte le quantità di articoli nell'ordine con gestione logistica sono state gestite.
    • CompletePartialled - Alcune quantità di articoli nell'ordine con gestione logistica sono state gestite; le altre sono state annullate o non erano elaborabili.
    • Unfulfillable - Non è stato possibile gestire alcuna quantità di articoli nell'ordine con gestione logistica perché gli addetti del centro logistico Amazon non hanno trovato l'inventario per tali articoli o non hanno trovato alcun inventario vendibile (non danneggiato).

    Tipo: stringa

    FulfillmentShipment

    Informazioni sulla consegna e sull'articolo per una spedizione in un ordine con gestione logistica.

    Tipo: FulfillmentShipment

    No
    FulfillmentReturnItem

    Informazioni su un articolo restituito a un centro logistico Amazon.

    Tipo: FulfillmentReturnItem

    No

    Tutorial: Creare un reso per un ordine con gestione multicanale

    I resi degli ordini con gestione multicanale sono composti da tre passaggi: ottenere i codici dei motivi del reso, inviare il reso utilizzando uno dei codici e infine restituire l'oggetto. Attualmente, la gestione multicanale prevede che il cliente finale paghi spese postali poiché le etichette di reso condivise non sono prepagate.

    Prerequisiti

    Per completare questo tutorial, hai bisogno di:

    1. Autorizzazione dal partner di vendita per il quale stai effettuando chiamate. Per ulteriori informazioni, vedi Autorizzazione delle applicazioni API per i partner di vendita.
    2. Il Ruolo di Logistica di Amazon assegnato al tuo profilo di sviluppatore.
    3. Il Ruolo di Logistica di Amazon selezionato nella pagina di registrazione dell'app per la tua domanda.

    Passaggio 1. Ottieni un elenco dei motivi del reso per un determinato prodotto.

    Chiama l'operazione listReturnReasonCodes passando i seguenti parametri:

    ParametroDescrizioneObbligatorio
    sellerSKU

    Lo SKU del venditore per il quale sono richiesti i codici del motivo del reso.

    Tipo: stringa

    marketplaceId

    Il marketplace per il quale il venditore desidera i codici dei motivi del reso.

    Tipo: stringa

    No
    sellerFulfillmentOrderId

    L'identificativo assegnato all'articolo dal venditore al momento della creazione dell'ordine con gestione logistica. Il servizio utilizza questo valore per determinare il marketplace per il quale il venditore desidera i codici del motivo del reso.

    Tipo: stringa

    No
    language

    Il linguaggio in cui dovrebbe essere tradotta la proprietà TranslatedDescription dell'oggetto di risposta ReasonCodeDetails.

    Tipo: stringa

    Esempio di richiesta

    GET https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/returnReasonCodes?sellerSku=LT205BLKAM&marketplaceId=ATVPDKIKX0DER&sellerFulfillmentOrderId=CONSUMER-2022921-1450456&language=EN

    Risposta

    Una risposta corretta ha un codice 200.

    Esempio di risposta

    { "payload": { "ReasonCodeDetailsList": [ { "ReturnReasonCode": "CR-SWITCHEROO", "Description": "Different from what was ordered", "TranslatedDescription": "Product does not meet customer expectations" }, { "ReturnReasonCode": "CR-DAMAGED_BY_CARRIER", "Description": "Damaged during shipping" }, { "ReturnReasonCode": "CR-UNAUTHORIZED_PURCHASE", "Description": "Unauthorized purchase" }, { "ReturnReasonCode": "CR-UNWANTED_ITEM", "Description": "No longer needed/wanted", "TranslatedDescription": "Unwanted item" }, { "ReturnReasonCode": "CR-MISSED_ESTIMATED_DELIVERY", "Description": "Missed estimated delivery date" }, { "ReturnReasonCode": "CR-FOUND_BETTER_PRICE", "Description": "Better price available", "TranslatedDescription": "I found better prices elsewhere" }, { "ReturnReasonCode": "CR-MISSING_PARTS", "Description": "Missing parts or accessories" }, { "ReturnReasonCode": "CR-EXTRA_ITEM", "Description": "Arrived in addition to what was ordered", "TranslatedDescription": "Extra item included in shipment" }, { "ReturnReasonCode": "CR-ORDERED_WRONG_ITEM", "Description": "Accidental order" }, { "ReturnReasonCode": "AMZ-PG-BAD-DESC", "Description": "Different from website description" }, { "ReturnReasonCode": "CR-DAMAGED_BY_FC", "Description": "Damaged due to inappropriate packaging", "TranslatedDescription": "Product damaged or defective prior to shipping" }, { "ReturnReasonCode": "CR-DEFECTIVE", "Description": "Defective/Does not work properly", "TranslatedDescription": "Item is defective" } ] } }
    NomeDescrizioneObbligatorio
    returnReasonCode

    Un codice che indica un motivo valido per il reso.

    Tipo: stringa

    description

    Una descrizione leggibile dall'uomo del codice del motivo del reso.

    Tipo: stringa

    translatedDescription

    Una traduzione della descrizione. La traduzione è nella lingua specificata nel parametro di richiesta Language.

    Tipo: stringa

    No

    Una risposta non riuscita ha un codice diverso da 2xx e include i seguenti oggetti.

    NomeDescrizione
    errors

    Si sono verificati uno o più errori imprevisti durante l'operazione listReturnReasonCodes.

    Tipo: ErrorList

    Passaggio 2. Crea un reso con gestione logistica per un ordine

    Utilizzando uno dei motivi recuperati nel passaggio precedente, effettua una chiamata all'operazione createFulfillmentReturn per inviare la richiesta di reso e recuperare l'etichetta di spedizione per il reso necessaria per spedire l'articolo ad Amazon.

    📘

    Etichetta non prepagata

    Questa etichetta non è prepagata. Deve essere pagata dal mittente.

    ParametroDescrizioneObbligatorio
    sellerFulfillmentOrderId

    Un identificativo assegnato dal venditore all'ordine con gestione logistica al momento della sua creazione. Il venditore utilizza i propri registri per trovare il valore sellerFulfillmentOrderId corretto in base alla richiesta dell'acquirente di restituire gli articoli.

    Tipo: stringa

    Parametro del corpoDescrizioneObbligatorio
    sellerReturnItemId

    Un identificativo assegnato dal venditore all'articolo per cui effettuare il reso.

    Tipo: stringa

    sellerFulfillmentOrderItemId

    L'identificativo assegnato all'articolo dal venditore al momento della creazione dell'ordine con gestione logistica.

    Tipo: stringa

    amazonShipmentId

    L'identificativo della spedizione associato all'articolo di reso.

    Tipo: stringa

    returnReasonCode

    Il codice del motivo del reso assegnato all'articolo del reso dal venditore.

    Tipo: stringa

    returnComment

    Un commento opzionale sull'articolo per cui effettuare il reso.

    Tipo: stringa

    No

    Esempio di richiesta

    PUT "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders/fc5d0aaf64e6d9d517fa7572c0/return" { "items": [ { "sellerReturnItemId": "Itm1", "sellerFulfillmentOrderItemId": "fc5d0aaf64e6d9d517fa7572c0", "amazonShipmentId": "Uvwxq86C7", "returnReasonCode": "CR-ORDERED_WRONG_ITEM", "returnComment": "Accidental order" } ] }

    Risposta

    Una risposta positiva ha un codice 200 e lo schema di risposta per l'operazione createFulfillmentReturn.

    Esempio di risposta

    { "payload": { "returnItems": [ { "sellerReturnItemId": "Itm1", "sellerFulfillmentOrderItemId": "fc5d0aaf64e6d9d517fa7572c0", "amazonShipmentId": "Uvwxq86C7", "returnComment": "Accidental order", "amazonReturnReasonCode": "CR-ORDERED_WRONG_ITEM", "status": "New", "statusChangedDate": "2022-10-26T03:48:29Z", "returnAuthorizationId": "RMA26PCEUDROQE18" } ], "invalidReturnItems": [], "returnAuthorizations": [ { "returnAuthorizationId": "RMA26PCEUDROQE18", "fulfillmentCenterId": "LEX2", "returnToAddress": { "name": "Returns Department", "addressLine1": "123 Any Street", "districtOrCounty": "US", "city": "Lexington", "stateOrRegion": "KY", "countryCode": "US", "postalCode": "40511" }, "amazonRmaId": "DBKKwqJ0RRMA", "rmaPageURL": "https://www.amazon.com/spr/returns/label/rmaID/DBKKwqJ0RRMA" } ] } }
    NomeDescrizioneObbligatorio
    ReturnItemList

    Un array di articoli che Amazon ha accettato per il reso. Ritorna vuoto se nessun articolo è stato accettato per il reso.

    Tipo: matrice < ReturnItem >

    InvalidReturnItemList

    Un array di informazioni sugli articoli resi non validi.

    Tipo: matrice < InvalidReturnItem >

    ReturnAuthorizationList

    Un array di informazioni sull'autorizzazione del reso.

    Tipo: matrice < ReturnAuthorization >

    NomeDescrizione
    errors

    Durante l'operazione si sono verificati uno o più errori imprevisti.

    Tipo: ErrorList

    Una risposta non riuscita ha un codice diverso da 2xx e include i seguenti oggetti. Una risposta 404 fornisce gli eventuali errori di inidoneità.

    NomeDescrizioneObbligatorio
    errors

    Si sono verificati uno o più errori imprevisti durante l'operazione createFulfillmentReturn.

    Tipo: ErrorList

    Passaggio 3. Spedisci l'articolo da restituire

    Dalla risposta di cui sopra, rmaPageURL fornirà l'etichetta di reso che deve essere stampata e incollata sul pacco e le spese postali devono essere pagate dall'acquirente che effettua il reso.

    Passaggio 4. Ricevi l'ordine con gestione logistica per convalidare la restituzione dell'ordine

    Una volta ricevuto il pacco da Amazon Warehouse, l'articolo viene contrassegnato come restituito per quell'ordine. Chiama l'operazione getFulfillmentOrder per convalidare che l'autorizzazione al reso sia compilata nell'ordine originale. returnItems e returnAuthorizations dovrebbero contenere gli stessi dettagli della risposta createFulfillmentReturn insieme allo stato/alle condizioni dell'articolo restituito.

    ParametroDescrizioneObbligatorio
    sellerFulfillmentOrderId

    L'identificativo assegnato all'articolo dal venditore al momento della creazione dell'ordine con gestione logistica.

    Lunghezza massima: 40

    Tipo: stringa

    Esempio di richiesta

    GET "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders/CONSUMER-2022921-1450456"

    Risposta

    Una risposta corretta ha un codice 200 con un payload.

    Esempio di risposta

    { "payload": { "fulfillmentOrder": { "sellerFulfillmentOrderId": "CONSUMER-2022921-1450456", "marketplaceId": "ATVPDKIKX0DER", "displayableOrderId": "Test Order1", "displayableOrderDate": "2022-10-31T15:15:20Z", "displayableOrderComment": "We have received your Order.", "shippingSpeedCategory": "Standard", "destinationAddress": { "name": "Nikki Wolf", "addressLine1": "123 Any Street", "city": "Charlotte", "stateOrRegion": "NC", "countryCode": "US", "postalCode": "28277" }, "fulfillmentAction": "Ship", "fulfillmentPolicy": "FillAllAvailable", "receivedDate": "2022-10-31T13:24:13Z", "fulfillmentOrderStatus": "Complete", "statusUpdatedDate": "2022-11-07T15:14:04Z", "featureConstraints": [ { "featureName": "BLANK_BOX", "featureFulfillmentPolicy": "Required" }, { "featureName": "BLOCK_AMZL", "featureFulfillmentPolicy": "Required" } ] }, "fulfillmentOrderItems": [ { "sellerSku": "LT205BLKAM", "sellerFulfillmentOrderItemId": "fc5d0aaf64e6d9d517fa7572c0", "quantity": "1", "fulfillmentNetworkSku": "X002ZKYQ4Z", "orderItemDisposition": "Sellable", "cancelledQuantity": "0", "unfulfillableQuantity": "0", "estimatedShipDate": "2022-11-01T06:59:59Z", "estimatedArrivalDate": "2022-11-05T06:59:59Z", "perUnitDeclaredValue": { "currencyCode": "USD", "value": "1995.00" } } ], "fulfillmentShipments": [ { "amazonShipmentId": "Uvwxq86C7", "fulfillmentCenterId": "GYR1", "fulfillmentShipmentStatus": "SHIPPED", "shippingDate": "2022-10-31T21:16:36Z", "estimatedArrivalDate": "2022-11-05T06:59:59Z", "fulfillmentShipmentItem": [ { "sellerSku": "LT205BLKAM", "sellerFulfillmentOrderItemId": "16653", "quantity": "1", "packageNumber": "1725289037" } ], "fulfillmentShipmentPackage": [ { "packageNumber": "UA-123456789", "carrierCode": "UPS", "trackingNumber": "1Z62Y7Y8425779999", "estimatedArrivalDate": "2022-11-05T03:00:00Z" } ] } ], "returnItems": [ { "amazonShipmentId": "Uvwxq86C7", "sellerFulfillmentOrderItemId": "fc5d0aaf64e6d9d517fa7572c0", "sellerReturnItemId": "SRII1", "returnComment": "recomment", "amazonReturnReasonCode": "CR-ORDERED_WRONG_ITEM", "status": "New", "statusChangedDate": "2022-11-07T23:14:01Z", "returnAuthorizationId": "RMA26PCEUDROQE18" } ], "returnAuthorizations": [ { "returnAuthorizationId": "RMA26PCEUDROQE18", "fulfillmentCenterId": "LAS2", "returnToAddress": { "name": "Returns Department", "addressLine1": "100 Main Street", "addressLine2": "Ste 111", "districtOrCounty": "US", "city": "Las Vegas", "stateOrRegion": "NV", "countryCode": "US", "postalCode": "89193" }, "amazonRmaId": "D2dJ2rJ6RRMA", "rmaPageURL": "https://www.amazon.com/spr/returns/label/rmaID/D2dJ2rJ6RRMA" } ] } }
    Parametro del corpoDescrizioneObbligatorio
    fulfillmentOrder

    Informazioni generali su un ordine con gestione logistica, incluso il suo stato.

    Tipo: FulfillmentOrder

    fulfillmentOrderItems

    Un array di informazioni sugli articoli relativi agli ordini con gestione logistica.

    Tipo: FulfillmentOrderItemList

    fulfillmentShipments

    Un array di informazioni relative alla spedizione con gestione logistica.

    Tipo: FulfillmentShipmentList

    No
    returnItems

    Un array di articoli che Amazon ha accettato per il reso. Ritorna vuoto se nessun articolo è stato accettato per il reso.

    Tipo: ReturnItemList

    returnAuthorizations

    Un array di informazioni sull'autorizzazione del reso.

    Tipo: ReturnAuthorizationList

    Una risposta non riuscita ha un codice diverso da 2xx e include i seguenti oggetti.

    NomeDescrizioneObbligatorio
    errors

    Si sono verificati uno o più errori imprevisti durante l'operazione getFulfillmentOrder.

    Tipo: ErrorList

    Tutorial: Ottieni offerte di consegna dinamiche

    Questo tutorial illustra come ottenere offerte di consegna dinamiche per un prodotto acquistabile utilizzando un codice postale statunitense o un indirizzo IP statunitense.

    Prerequisiti

    Per completare questo tutorial, hai bisogno di:

    1. Autorizzazione dal partner di vendita per il quale stai effettuando chiamate. Per ulteriori informazioni, vedi Autorizzazione delle applicazioni API per i partner di vendita.
    2. Il Ruolo di Logistica di Amazon assegnato al tuo profilo di sviluppatore.
    3. Il Ruolo di Logistica di Amazon selezionato nella pagina di registrazione dell'app per la tua domanda.

    Fase 1. Ottieni un'offerta di consegna dinamica

    Chiama il deliveryOffers operazione per ottenere l'offerta di consegna dinamica con una velocità di consegna standard per il prodotto e le informazioni sulla località specificati.

    Parametro del corpoDescrizioneObbligatorio
    product

    I dettagli del prodotto per l'offerta di consegna.

    Tipo: getDeliveryOffersProduct

    terms

    I termini dell'offerta di consegna.

    Tipo: getDeliveryOffersTerms

    Esempio di richiesta

    POST "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/deliveryOffers" { "product": { "productIdentifier": { "merchantSku": "TestSku" }, "amount": { "unitOfMeasure": "Eaches", "value": "2" } }, "terms": { "origin": { "countryCode": "US" }, "destination": { "deliveryAddress": { "countryCode": "US", "postalCode": "94560", "addressLine1": "", "addressLine2": "", "addressLine3": "", "city": "", "districtOrCounty": "", "stateOrRegion": "CA" }, "ipAddress": "" } } }

    Risposta

    Una risposta corretta ha un codice 200.

    Esempio di risposta

    { "payload": { "deliveryOffers": [ { "dateRange": { "earliest": "2024-06-07T02:59:00Z", "latest": "2024-06-07T02:59:00Z" }, "expiresAt": "2024-06-04T01:32:16Z", "policy": { "messaging": { "locale": "en-US", "text": "Fastest Delivery Thursday, Jun 6" } } } ] } }

    Se un'offerta di consegna non è disponibile, deliveryOffers è vuoto nella risposta.

    { "payload": { "deliveryOffers": [] } }

    Una risposta non riuscita ha un codice diverso da 2xx e include i seguenti oggetti.

    NomeDescrizione
    errors

    Si sono verificati uno o più errori imprevisti durante l'operazione deliveryOffers.

    Tipo: ErrorList

    Tutorial: Crea un ordine in Giappone con preferenze di consegna

    Questo tutorial illustra il processo di creazione degli ordini per il Giappone con le preferenze di consegna. Questa funzione è disponibile solo per gli ordini sul mercato giapponese.

    Prerequisiti

    Per completare questo tutorial, hai bisogno di:

    1. Autorizzazione dal partner di vendita per il quale stai effettuando chiamate. Per ulteriori informazioni, vedi Autorizzazione delle applicazioni API per i partner di vendita.
    2. Il Ruolo di Logistica di Amazon assegnato al tuo profilo di sviluppatore.
    3. Il Ruolo di Logistica di Amazon selezionato nella pagina di registrazione dell'app per la tua domanda.

    Fase 1. Crea un ordine di evasione specificando le preferenze di spedizione

    Chiama l'operazione createFulfillmentOrder per creare un ordine di gestione multicanale specificando i vincoli di funzionalità richiesti per l'ordine.

    Parametro del corpoDescrizioneObbligatorio
    marketplaceId

    Il marketplace in cui viene effettuato l'ordine con gestione logistica.

    Tipo: stringa

    No
    sellerFulfillmentOrderId

    Un identificativo dell'ordine con gestione logistica creato dal venditore per tracciare il proprio ordine con gestione logistica. Il sellerFulfillmentOrderId deve essere univoco per ogni ordine con gestione logistica creato da un venditore. Se il sistema del venditore crea già identificatori d'ordine univoci, questi potrebbero essere valori validi da utilizzare.

    Lunghezza massima: 40

    Tipo: stringa

    displayableOrderId

    Un identificativo dell'ordine con evasione logistica creato dal venditore. Questo valore viene visualizzato come identificativo dell'ordine nei materiali rivolti al destinatario, ad esempio la distinta di imballaggio per spedizioni in uscita. Il valore di DisplayableOrderId deve corrispondere all'identificativo dell'ordine che il venditore fornisce al destinatario. Il venditore può utilizzare SellerFulfillmentOrderId per questo valore oppure può specificare un valore alternativo se vuole che il destinatario faccia riferimento a un identificativo dell'ordine alternativo.

    Il valore deve essere una stringa alfanumerica o conforme a ISO 8859-1 con una lunghezza compresa tra uno e 40 caratteri. Non può contenere due spazi in una riga. Gli spazi bianchi iniziali e finali vengono rimossi.

    Lunghezza massima: 40

    Tipo: stringa

    displayableOrderDate

    La data e l'ora dell'ordine con gestione logistica. Viene visualizzata come data dell'ordine nei materiali rivolti al destinatario, ad esempio la distinta di imballaggio della spedizione in uscita.

    Tipo: Timestamp

    displayableOrderComment

    Testo specifico dell'ordine che appare nei materiali rivolti al destinatario, come la distinta di imballaggio della spedizione in uscita.

    Lunghezza massima: 250

    Tipo: stringa

    shippingSpeedCategory

    Il metodo di spedizione per l'ordine con gestione logistica.

    Tipo:

    ShippingSpeedCategory
    deliveryWindow

    L'intervallo di tempo entro il quale deve essere consegnato un ordine con gestione logistica a consegna programmata.

    Tipo: DeliveryWindow

    No
    destinationAddress

    L'indirizzo di destinazione dell'ordine con gestione logistica.

    Tipo: Address

    deliveryPreferences

    Le preferenze di spedizione applicate all'indirizzo di destinazione. Queste preferenze vengono applicate quando possibile e sono il massimo sforzo possibile. Per gli ordini idonei, la preferenza di consegna predefinita è lasciare il pacco incustodito davanti alla porta d'ingresso. Questa funzionalità è attualmente supportata solo nel marketplace giapponese e non applicabile ad altri marketplace.

    Tipo: DeliveryPreferences

    No
    fulfillmentAction

    Specifica se l'ordine con gestione logistica deve essere spedito adesso o se l'ordine è bloccato.

    Tipo: FulfillmentAction

    No
    fulfillmentPolicy

    Il valore FulfillmentPolicy specificato quando hai inviato l'operazione createFulfillmentOrder.

    Tipo: FulfillmentPolicy

    No
    codSettings

    Gli addebiti in contrassegno (COD) associati a un ordine di evasione in contrassegno.

    Tipo: CODSettings

    No
    shipFromCountryCode

    Il codice Paese a due caratteri per il Paese da cui viene spedito l'ordine con gestione logistica. Deve essere in formato ISO 3166-1 alpha-2. È Richiesto se si effettua una spedizione transfrontaliera.

    Tipo: stringa

    No
    notificationEmails

    Un elenco di indirizzi e-mail forniti dal venditore e utilizzati da Amazon per inviare notifiche di completamento della spedizione ai destinatari per conto del venditore.

    Tipo: NotificationEmailList

    No
    featureConstraints

    Un elenco delle funzionalità e delle relative politiche di gestione logistica da applicare all'ordine.

    Tipo: matrice < FeatureSettings >

    No
    Items

    Un elenco di articoli da includere nell'anteprima dell'ordine con gestione logistica, inclusa la quantità.

    Tipo: CreateFulfillmentOrderItemList

    Esempio di richiesta

    POST "https://sellingpartnerapi-fe.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders" { "sellerFulfillmentOrderId": "CONSUMER-2022921-145045", "displayableOrderId": "CONSUMER-2022921-145045", "displayableOrderDate": "2022-01-09T19:46:45.809Z", "displayableOrderComment": "TestOrder", "shippingSpeedCategory": "Standard", "fulfillmentAction": "Ship", "destinationAddress": { "name": "Mary Major", "addressLine1": "1-8-1 Shimomeguro", "addressLine2": "Meguro-ku", "city": "Tokyo", "countryCode": "JP", "postalCode": "153-0064" }, "deliveryPreferences": { "deliveryInstructions": "Beware of dogs", "dropOffLocation": { "type": "FRONT_DOOR" } }, "items": [ { "sellerSku": "SellerSKU12", "sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-0", "quantity": 1 } ] }

    Risposta

    Una risposta corretta ha un codice 200 e include i seguenti oggetti.

    Esempio di risposta

    {}

    Una risposta non riuscita ha un codice diverso da 2xx e include i seguenti oggetti.

    NomeDescrizione
    errors

    Si sono verificati uno o più errori imprevisti durante l'operazione createFulfillmentOrder.

    Tipo: ErrorList

    Tutorial: Crea un ordine in Giappone inserendo i dati del vicino nelle preferenze di consegna

    Questo tutorial illustra il processo di creazione dell'ordine per il Giappone, in cui la preferenza di consegna è impostata su un vicino designato se il destinatario non è disponibile all'indirizzo di destinazione. Questa funzione è disponibile solo per gli ordini sul mercato giapponese.

    Prerequisiti

    Per completare questo tutorial, hai bisogno di:

    1. Autorizzazione dal partner di vendita per il quale stai effettuando chiamate. Per ulteriori informazioni, vedi Autorizzazione delle applicazioni API per i partner di vendita.
    2. Il Ruolo di Logistica di Amazon assegnato al tuo profilo di sviluppatore.
    3. Il Ruolo di Logistica di Amazon selezionato nella pagina di registrazione dell'app per la tua domanda.

    Fase 1. Crea un ordine di evasione specificando le preferenze di spedizione

    Chiama l'operazione createFulfillmentOrder per creare un ordine di gestione multicanale specificando i vincoli di funzionalità richiesti per l'ordine.

    Parametro del corpoDescrizioneObbligatorio
    marketplaceId

    Il marketplace in cui viene effettuato l'ordine con gestione logistica.

    Tipo: stringa

    No
    sellerFulfillmentOrderId

    Un identificativo dell'ordine con gestione logistica creato dal venditore per tracciare il proprio ordine con gestione logistica. Il sellerFulfillmentOrderId deve essere univoco per ogni ordine con gestione logistica creato da un venditore. Se il sistema del venditore crea già identificatori d'ordine univoci, questi potrebbero essere valori validi da utilizzare.

    Lunghezza massima: 40

    Tipo: stringa

    displayableOrderId

    Un identificativo dell'ordine con evasione logistica creato dal venditore. Questo valore viene visualizzato come identificativo dell'ordine nei materiali rivolti al destinatario, ad esempio la distinta di imballaggio per spedizioni in uscita. Il valore di DisplayableOrderId deve corrispondere all'identificativo dell'ordine che il venditore fornisce al destinatario. Il venditore può utilizzare SellerFulfillmentOrderId per questo valore oppure può specificare un valore alternativo se vuole che il destinatario faccia riferimento a un identificativo dell'ordine alternativo.

    Il valore deve essere una stringa alfanumerica o conforme a ISO 8859-1 con una lunghezza compresa tra uno e 40 caratteri. Non può contenere due spazi in una riga. Gli spazi bianchi iniziali e finali vengono rimossi.

    Lunghezza massima: 40

    Tipo: stringa

    displayableOrderDate

    La data e l'ora dell'ordine con gestione logistica. Viene visualizzata come data dell'ordine nei materiali rivolti al destinatario, ad esempio la distinta di imballaggio della spedizione in uscita.

    Tipo: Timestamp

    displayableOrderComment

    Testo specifico dell'ordine che appare nei materiali rivolti al destinatario, come la distinta di imballaggio della spedizione in uscita.

    Lunghezza massima: 250

    Tipo: stringa

    shippingSpeedCategory

    Il metodo di spedizione per l'ordine con gestione logistica.

    Tipo:

    ShippingSpeedCategory
    deliveryWindow

    L'intervallo di tempo entro il quale deve essere consegnato un ordine con gestione logistica a consegna programmata.

    Tipo: DeliveryWindow

    No
    destinationAddress

    L'indirizzo di destinazione dell'ordine con gestione logistica.

    Tipo: Address

    deliveryPreferences

    Le preferenze di spedizione applicate all'indirizzo di destinazione. Queste preferenze vengono applicate quando possibile e sono il massimo sforzo possibile. Per gli ordini idonei, la preferenza di consegna predefinita è lasciare il pacco incustodito davanti alla porta d'ingresso. Questa funzionalità è attualmente supportata solo nel marketplace giapponese e non applicabile ad altri marketplace.

    Tipo: DeliveryPreferences

    No
    fulfillmentAction

    Specifica se l'ordine con gestione logistica deve essere spedito adesso o se l'ordine è bloccato.

    Tipo: FulfillmentAction

    No
    fulfillmentPolicy

    Il valore FulfillmentPolicy specificato quando hai inviato l'operazione createFulfillmentOrder.

    Tipo: FulfillmentPolicy

    No
    codSettings

    Gli addebiti in contrassegno (COD) associati a un ordine di evasione in contrassegno.

    Tipo: CODSettings

    No
    shipFromCountryCode

    Il codice Paese a due caratteri per il Paese da cui viene spedito l'ordine con gestione logistica. Deve essere in formato ISO 3166-1 alpha-2. È Richiesto se si effettua una spedizione transfrontaliera.

    Tipo: stringa

    No
    notificationEmails

    Un elenco di indirizzi e-mail forniti dal venditore e utilizzati da Amazon per inviare notifiche di completamento della spedizione ai destinatari per conto del venditore.

    Tipo: NotificationEmailList

    No
    featureConstraints

    Un elenco delle funzionalità e delle relative politiche di gestione logistica da applicare all'ordine.

    Tipo: matrice < FeatureSettings >

    No
    Items

    Un elenco di articoli da includere nell'anteprima dell'ordine con gestione logistica, inclusa la quantità.

    Tipo: CreateFulfillmentOrderItemList

    Esempio di richiesta

    POST "https://sellingpartnerapi-fe.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders" { "sellerFulfillmentOrderId": "CONSUMER-2022921-145045", "displayableOrderId": "CONSUMER-2022921-145045", "displayableOrderDate": "2022-01-09T19:46:45.809Z", "displayableOrderComment": "TestOrder", "shippingSpeedCategory": "Standard", "fulfillmentAction": "Ship", "destinationAddress": { "name": "Mary Major", "addressLine1": "1-8-1 Shimomeguro", "addressLine2": "Meguro-ku", "city": "Tokyo", "countryCode": "JP", "postalCode": "153-0064" }, "deliveryPreferences": { "deliveryInstructions": "Beware of dogs", "dropOffLocation": { "type": "FALLBACK_NEIGHBOR_DELIVERY", "attributes": { "neighborName": "Liam Lowe", "houseNumber": "1-8-2 Shimomeguro" } } }, "items": [ { "sellerSku": "SellerSKU12", "sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-0", "quantity": 1 } ] }

    Risposta

    Una risposta corretta ha un codice 200 e include i seguenti oggetti.

    Esempio di risposta

    {}

    Una risposta non riuscita ha un codice diverso da 2xx e include i seguenti oggetti.

    NomeDescrizione
    errors

    Si sono verificati uno o più errori imprevisti durante l'operazione createFulfillmentOrder.

    Tipo: ErrorList

    Tutorial: Recupera i dettagli dell'armadietto (scatola di consegna) per i pacchi consegnati in Giappone

    Questo tutorial mostra come ottenere informazioni sull'armadietto per un pacco che è stato consegnato a un armadietto (scatola di consegna) per il Giappone in una spedizione in uscita per un ordine con gestione multicanale.

    Le getFulfillmentOrder L'API potrebbe non restituire sempre lockerDetails, a seconda dello stato della consegna e del luogo di consegna.

    Usa il getPackageTrackingDetails API per verificare lo stato della consegna e identificare se il pacco è stato consegnato in un armadietto (scatola di consegna).

    Prerequisiti

    Per completare questo tutorial, hai bisogno di:

    1. Autorizzazione dal partner di vendita per il quale stai effettuando chiamate. Per ulteriori informazioni, vedi Autorizzazione delle applicazioni API per i partner di vendita.
    2. Il Ruolo di Logistica di Amazon assegnato al tuo profilo di sviluppatore.
    3. Il Ruolo di Logistica di Amazon selezionato nella pagina di registrazione dell'app per la tua domanda.

    Fase 1. Richiedi l'ordine di evasione per visualizzare i dettagli più recenti dell'ordine e i dettagli dell'armadietto, se presenti

    Chiama l'operazione getFulfillmentOrder passando i seguenti parametri:

    ParametroDescrizioneObbligatorio
    sellerFulfillmentOrderId

    L'identificativo assegnato all'articolo dal venditore al momento della creazione dell'ordine con gestione logistica.

    Lunghezza massima: 40

    Tipo: stringa

    Esempio di richiesta

    GET "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders/CONSUMER-2022921-145045"

    Risposta

    Una risposta corretta ha un codice 200 con un payload.

    Esempio di risposta

    { "payload": { "fulfillmentOrder": { "sellerFulfillmentOrderId": "CONSUMER-2022921-145045", "marketplaceId": "ATVPDKIKX0DER", "displayableOrderId": "CONSUMER-2022921-145045", "displayableOrderDate": "2024-05-21T14:48:15Z", "displayableOrderComment": "Thank you for your order", "shippingSpeedCategory": "Standard", "destinationAddress": { "name": "Mary Major", "addressLine1": "1-8-1 Shimomeguro", "addressLine2": "Meguro-ku", "city": "Tokyo", "countryCode": "JP", "postalCode": "153-0064" }, "fulfillmentAction": "Ship", "fulfillmentPolicy": "FillAllAvailable", "receivedDate": "2024-05-21T14:50:45Z", "fulfillmentOrderStatus": "CompletePartialled", "statusUpdatedDate": "2024-05-22T03:44:35Z", "notificationEmails": [ "email@email.com" ], "featureConstraints": [ { "featureName": "BLANK_BOX", "featureFulfillmentPolicy": "NotRequired" } ] }, "fulfillmentOrderItems": [ { "sellerSku": "LT110WHTAM", "sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-0", "quantity": "1", "fulfillmentNetworkSku": "X002ZKH36D", "orderItemDisposition": "Sellable", "cancelledQuantity": "0", "unfulfillableQuantity": "1", "estimatedShipDate": "2024-05-22T06:59:59Z", "estimatedArrivalDate": "2024-05-26T06:59:59Z", "perUnitDeclaredValue": { "currencyCode": "YEN", "value": "0.00" } }, { "sellerSku": "LT205BLKAM", "sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-1", "quantity": "1", "giftMessage": "", "fulfillmentNetworkSku": "X002ZKYQ4Z", "orderItemDisposition": "Sellable", "cancelledQuantity": "0", "unfulfillableQuantity": "0", "estimatedShipDate": "", "estimatedArrivalDate": "", "perUnitDeclaredValue": { "currencyCode": "YEN", "value": "15.00" } } ], "fulfillmentShipments": [ { "amazonShipmentId": "T7mfkbDX5", "fulfillmentCenterId": "TUL2", "fulfillmentShipmentStatus": "SHIPPED", "shippingDate": "2024-05-22T03:39:19Z", "estimatedArrivalDate": "2024-05-26T06:59:59Z", "fulfillmentShipmentItem": [ { "sellerSku": "LT205BLKAM", "sellerFulfillmentOrderItemId": "CONSUMER-2022921-145045-1", "quantity": "1", "packageNumber": 1681854637 } ], "fulfillmentShipmentPackage": [ { "packageNumber": 1681854637, "carrierCode": "AMZL", "trackingNumber": "TBA123456789012", "estimatedArrivalDate": "2024-05-26T06:59:59Z", "lockerDetails": { "lockerNumber": "A-42", "lockerAccessCode" : "7380" } } ] } ], "returnItems": [], "returnAuthorizations": [] } }
    Parametro del corpoDescrizioneObbligatorio
    fulfillmentOrder

    Informazioni generali su un ordine con gestione logistica, incluso il suo stato.

    Tipo: FulfillmentOrder

    fulfillmentOrderItems

    Un array di informazioni sugli articoli relativi agli ordini con gestione logistica.

    Tipo: FulfillmentOrderItemList

    fulfillmentShipments

    Un array di informazioni relative alla spedizione con gestione logistica.

    Tipo: FulfillmentShipmentList

    No
    returnItems

    Un array di articoli che Amazon ha accettato per il reso. Ritorna vuoto se nessun articolo è stato accettato per il reso.

    Tipo: ReturnItemList

    returnAuthorizations

    Un array di informazioni sull'autorizzazione del reso.

    Tipo: ReturnAuthorizationList

    Una risposta non riuscita ha un codice diverso da 2xx e include i seguenti oggetti.

    NomeDescrizioneObbligatorio
    errors

    Si sono verificati uno o più errori imprevisti durante l'operazione getFulfillmentOrder.

    Tipo: ErrorList


    Questa pagina ti è stata utile?