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:
-
Autorizzazione dal partner di vendita per il quale stai effettuando chiamate. Per ulteriori informazioni, vedi Autorizzazione delle applicazioni API per i partner di vendita.
-
Il Ruolo di Logistica di Amazon assegnato al tuo profilo di sviluppatore.
-
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:
- Autorizzazione dal partner di vendita per il quale stai effettuando chiamate. Per ulteriori informazioni, vedi Autorizzazione delle applicazioni API per i partner di vendita.
- Il Ruolo di Logistica di Amazon assegnato al tuo profilo di sviluppatore.
- 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
Nome | Descrizione | Obbligatorio |
---|---|---|
sellerFulfillmentOrderId | L'identificativo assegnato all'articolo dal venditore al momento della creazione dell'ordine di evasione. Lunghezza massima: 40 Tipo: corda | Sì |
Esempio di richiesta
GET "https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders/CONSUMER-2022921-145045"
Risposta
Nome | Descrizione | Obbligatorio |
---|---|---|
fulfillmentOrder | Informazioni generali su un ordine di evasione, incluso il suo stato. Tipo: FulfillmentOrder | Sì |
fulfillmentOrderItems | Una serie di informazioni sugli articoli relativi agli ordini di evasione. Tipo: FulfillmentOrderItemList | Sì |
fulfillmentShipments | Una serie di informazioni relative all'evasione e alla spedizione. Tipo: FulfillmentShipmentList | No |
returnItems | Una serie di articoli che Amazon ha accettato per la restituzione. I resi sono vuoti se nessun articolo è stato accettato per la restituzione. Tipo: ReturnItemList | Sì |
returnAuthorizations | Una serie di informazioni sull'autorizzazione alla restituzione. Tipo: ReturnAuthorizationList | Sì |
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:
-
Autorizzazione dal partner di vendita per il quale stai effettuando chiamate. Per ulteriori informazioni, vedi Autorizzazione delle applicazioni API per i partner di vendita.
-
Il Ruolo di Logistica di Amazon assegnato al tuo profilo di sviluppatore.
-
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:
Parametro | Descrizione | Obbligatorio |
---|---|---|
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"
}
]
}
]
}
}
Nome | Descrizione | Obbligatorio |
---|---|---|
sellerFulfillmentOrderId | L'identificativo dell'ordine con gestione logistica inviato con l'operazione Tipo: stringa | Sì |
marketplaceId | L'identificativo del marketplace in cui viene effettuato l'ordine con gestione logistica. Tipo: stringa | Sì |
displayableOrderId | Un identificativo dell'ordine con gestione logistica inviato con l'operazione Tipo: stringa | Sì |
displayableOrderDate | Una data e un'ora inviate con l'operazione Tipo: | Sì |
displayableOrderComment | Un blocco di testo inviato con l'operazione Tipo: stringa | Sì |
shippingSpeedCategory | Il metodo di spedizione utilizzato per l'ordine con gestione logistica. Tipo: | Sì |
deliveryWindow | L'intervallo di tempo entro il quale deve essere consegnato un ordine con gestione logistica a consegna programmata. Tipo: | No |
destinationAddress | L'indirizzo di destinazione inviato con l'operazione Tipo: | Sì |
fulfillmentAction | Specifica se l'ordine con gestione logistica deve essere spedito adesso o se l'ordine è bloccato. Tipo: | No |
fulfillmentPolicy | Il valore Tipo: | No |
codSettings | Gli addebiti in contrassegno (COD) associati a un ordine di evasione in contrassegno. Tipo: | No |
receivedDate | La data e l'ora in cui l'ordine con gestione logistica è stato ricevuto da un centro logistico Amazon. Tipo: | Sì |
fulfillmentOrderStatus | Lo stato attuale dell'ordine con gestione logistica. Tipo: | Sì |
statusUpdatedDate | The date and time that the status of the fulfillment order last changed, in ISO 8601 date-time format. Tipo: | Sì |
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: | No |
featureConstraints | Un elenco delle funzionalità e delle relative politiche di gestione logistica da applicare all'ordine. Tipo: matrice < | No |
Una risposta non riuscita ha un codice diverso da 2xx e include i seguenti oggetti.
Nome | Descrizione |
---|---|
errors | Durante l'operazione si sono verificati uno o più errori imprevisti. Tipo: |
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:
- Autorizzazione dal partner di vendita per il quale stai effettuando chiamate. Per ulteriori informazioni, vedi Autorizzazione delle applicazioni API per i partner di vendita.
- Il Ruolo di Logistica di Amazon assegnato al tuo profilo di sviluppatore.
- 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:
Parametro | Descrizione | Obbligatorio |
---|---|---|
packageNumber | L'identificativo del pacco riportato dall'operazione Tipo: numero intero (int32) | Sì |
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à.
Nome | Descrizione |
---|---|
errors | Si sono verificati uno o più errori imprevisti durante l'operazione Tipo: |
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:
- Autorizzazione dal partner di vendita per il quale stai effettuando chiamate. Per ulteriori informazioni, vedi Autorizzazione delle applicazioni API per i partner di vendita.
- Il Ruolo di Logistica di Amazon assegnato al tuo profilo di sviluppatore.
- 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:
Parametro | Descrizione | Obbligatorio |
---|---|---|
sellerFulfillmentOrderId | L'identificativo assegnato all'articolo dal venditore al momento della creazione dell'ordine con gestione logistica. Lunghezza massima: 40 Tipo: stringa | Sì |
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à.
Nome | Descrizione |
---|---|
errors | Si sono verificati uno o più errori imprevisti durante l'operazione Tipo: |
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:
- Autorizzazione dal partner di vendita per il quale stai effettuando chiamate. Per ulteriori informazioni, vedi Autorizzazione delle applicazioni API per i partner di vendita.
- Il Ruolo di Logistica di Amazon assegnato al tuo profilo di sviluppatore.
- 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:
Parametro | Descrizione | Obbligatorio |
---|---|---|
marketplaceId | Il marketplace per il quale riportare l'elenco delle funzionalità. Tipo: stringa | Sì |
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
}
]
}
Parametro | Descrizione | Obbligatorio |
---|---|---|
featureName | Il nome della funzionalità Tipo: stringa | Sì |
featureDescription | La descrizione della funzionalità. Tipo: stringa | Sì |
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.
Nome | Descrizione |
---|---|
errors | Si sono verificati uno o più errori imprevisti durante l'operazione Tipo: |
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:
- Autorizzazione dal partner di vendita per il quale stai effettuando chiamate. Per ulteriori informazioni, vedi Autorizzazione delle applicazioni API per i partner di vendita.
- Il Ruolo di Logistica di Amazon assegnato al tuo profilo di sviluppatore.
- 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:
Parametro | Descrizione | Obbligatorio |
---|---|---|
marketplaceId | Il marketplace per il quale riportare un elenco dell'inventario idoneo per la funzionalità specificata. Tipo: stringa | Sì |
featureName | Il nome della funzionalità per la quale riportare un elenco di inventario idoneo. Tipo: stringa | Sì |
nextToken | Un token di stringa riportato nella risposta alla richiesta precedente che viene utilizzato per riportare la pagina di risposta successiva. Un valore di 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": []
}
]
}
}
Parametro | Descrizione | Obbligatorio |
---|---|---|
marketplaceId | Il marketplace richiesto. Tipo: stringa | Sì |
featureName | Il nome della funzionalità. Tipo: stringa | Sì |
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 < | No |
Una risposta non riuscita ha un codice diverso da 2xx e include i seguenti oggetti.
Nome | Descrizione |
---|---|
errors | Si sono verificati uno o più errori imprevisti durante l'operazione Tipo: |
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 oggettoskuInfo
vuoto.
Prerequisiti
Per completare questo tutorial, hai bisogno di:
- Autorizzazione dal partner di vendita per il quale stai effettuando chiamate. Per ulteriori informazioni, vedi Autorizzazione delle applicazioni API per i partner di vendita.
- Il Ruolo di Logistica di Amazon assegnato al tuo profilo di sviluppatore.
- 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:
Parametro | Descrizione | Obbligatorio |
---|---|---|
marketplaceId | Il marketplace per il quale riportare il conteggio. Tipo: stringa | Sì |
featureName | Il nome della funzionalità. Tipo: stringa | Sì |
sellerSku | Utilizzato per identificare un articolo in un determinato marketplace. Tipo: stringa | Sì |
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"
}
}
Parametro | Descrizione | Obbligatorio |
---|---|---|
marketplaceId | Il marketplace richiesto. Tipo: stringa | Sì |
| Il nome della funzionalità. Tipo: stringa | Sì |
isEligible | Quando il valore è True, il Tipo: booleano | Sì |
ineligibleReasons | Un elenco di uno o più motivi per cui lo SKU del venditore non è idoneo per la funzionalità. Valori possibili:
Type: < stringa > array | No |
skuInfo | Informazioni sul Tipo: | No |
Una risposta non riuscita ha un codice diverso da 2xx e include i seguenti oggetti.
Nome | Descrizione |
---|---|
errors | Si sono verificati uno o più errori imprevisti durante l'operazione Tipo: |
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:
- Autorizzazione dal partner di vendita per il quale stai effettuando chiamate. Per ulteriori informazioni, vedi Autorizzazione delle applicazioni API per i partner di vendita.
- Il Ruolo di Logistica di Amazon assegnato al tuo profilo di sviluppatore.
- 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 corpo | Descrizione | Obbligatorio |
---|---|---|
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: | Sì |
items | Informazioni identificative e informazioni sulla quantità per gli articoli nell'anteprima dell'ordine con gestione logistica. | Sì |
shippingSpeedCategories | Un elenco dei metodi di spedizione utilizzati per creare le anteprime degli ordini con gestione logistica. Valori possibili:
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:
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 Tipo: booleano | No |
featureConstraints | Un elenco delle funzionalità e delle relative politiche di gestione logistica da applicare all'ordine. Tipo: matrice < | 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"
}
]
}
}
Nome | Descrizione |
---|---|
FulfillmentPreviews | Un array di informazioni sull'anteprima di gestione logistica. Tipo: |
Una risposta non riuscita ha un codice diverso da 2xx e include i seguenti oggetti.
Nome | Descrizione |
---|---|
errors | Durante l'operazione si sono verificati uno o più errori imprevisti. Tipo: |
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 corpo | Descrizione | Obbligatorio |
---|---|---|
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 Lunghezza massima: 40 Tipo: stringa | Sì |
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 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 | Sì |
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: | Sì |
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 | Sì |
shippingSpeedCategory | Il metodo di spedizione per l'ordine con gestione logistica. ShippingSpeedCategory | Sì |
deliveryWindow | L'intervallo di tempo entro il quale deve essere consegnato un ordine con gestione logistica a consegna programmata. Tipo: | No |
destinationAddress | L'indirizzo di destinazione dell'ordine con gestione logistica. Tipo: | Sì |
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: | No |
fulfillmentAction | Specifica se l'ordine con gestione logistica deve essere spedito adesso o se l'ordine è bloccato. Tipo: | No |
fulfillmentPolicy | Il valore Tipo: | No |
codSettings | Gli addebiti COD che associ a un ordine di evasione COD. Tipo: | 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: | No |
featureConstraints | Un elenco delle funzionalità e delle relative politiche di gestione logistica da applicare all'ordine. Tipo: matrice < | No |
Items | Un elenco di articoli da includere nell'anteprima dell'ordine con gestione logistica, inclusa la quantità. | Sì |
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.
Nome | Descrizione |
---|---|
errors | Si sono verificati uno o più errori imprevisti durante l'operazione Tipo: |
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
.
Parametro | Descrizione | Obbligatorio |
---|---|---|
sellerFulfillmentOrderId | L'identificativo assegnato all'articolo dal venditore al momento della creazione dell'ordine con gestione logistica. Lunghezza massima: 40 Tipo: stringa | Sì |
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 corpo | Descrizione | Obbligatorio |
---|---|---|
fulfillmentOrder | Informazioni generali su un ordine con gestione logistica, incluso il suo stato. Tipo: | Sì |
| Un array di informazioni sugli articoli relativi agli ordini con gestione logistica. Tipo: | Sì |
fulfillmentShipments | Un array di informazioni relative alla spedizione con gestione logistica. Tipo: | No |
returnItems | Un array di articoli che Amazon ha accettato per il reso. Ritorna vuoto se nessun articolo è stato accettato per il reso. Tipo: | Sì |
returnAuthorizations | Un array di informazioni sull'autorizzazione del reso. Tipo: | Sì |
Una risposta non riuscita ha un codice diverso da 2xx e include i seguenti oggetti.
Nome | Descrizione |
---|---|
errors | Durante l'operazione si sono verificati uno o più errori imprevisti. Tipo: |
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:
- Autorizzazione dal partner di vendita per il quale stai effettuando chiamate. Per ulteriori informazioni, vedi Autorizzazione delle applicazioni API per i partner di vendita.
- Il Ruolo di Logistica di Amazon assegnato al tuo profilo di sviluppatore.
- 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 corpo | Descrizione | Obbligatorio |
---|---|---|
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: | Sì |
items | Informazioni identificative e informazioni sulla quantità per gli articoli nell'anteprima dell'ordine con gestione logistica. | Sì |
shippingSpeedCategories | Un elenco dei metodi di spedizione utilizzati per creare le anteprime degli ordini con gestione logistica. Valori possibili:
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:
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 Tipo: booleano | No |
featureConstraints | Un elenco delle funzionalità e delle relative politiche di gestione logistica da applicare all'ordine. Tipo: matrice < | 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"
}
]
}
]
}
}
Nome | Descrizione |
---|---|
FulfillmentPreviews | Un array di informazioni sull'anteprima di gestione logistica. Tipo: |
Una risposta non riuscita ha un codice diverso da 2xx e include i seguenti oggetti.
Nome | Descrizione |
---|---|
errors | Durante l'operazione si sono verificati uno o più errori imprevisti. Tipo: |
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 corpo | Descrizione | Obbligatorio |
---|---|---|
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 Lunghezza massima: 40 Tipo: stringa | Sì |
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 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 | Sì |
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: | Sì |
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 | Sì |
shippingSpeedCategory | Il metodo di spedizione per l'ordine con gestione logistica. ShippingSpeedCategory | Sì |
deliveryWindow | L'intervallo di tempo entro il quale deve essere consegnato un ordine con gestione logistica a consegna programmata. Tipo: | No |
destinationAddress | L'indirizzo di destinazione dell'ordine con gestione logistica. Tipo: | Sì |
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: | No |
fulfillmentAction | Specifica se l'ordine con gestione logistica deve essere spedito adesso o se l'ordine è bloccato. Tipo: | No |
fulfillmentPolicy | Il valore Tipo: | No |
codSettings | Gli addebiti COD che associ a un ordine di evasione COD. Tipo: | 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: | No |
featureConstraints | Un elenco delle funzionalità e delle relative politiche di gestione logistica da applicare all'ordine. Tipo: matrice < | 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. | Sì |
paymentInformation | Le informazioni di pagamento per l'ordine di evasione. Tipo: | Sì |
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.
Nome | Descrizione |
---|---|
errors | Si sono verificati uno o più errori imprevisti durante l'operazione Tipo: |
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 corpo | Descrizione | Obbligatorio |
---|---|---|
marketplaceId | Il marketplace in cui viene effettuato l'ordine di evasione. Tipo: corda | No |
sellerFulfillmentOrderId | Un 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 | Sì |
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. | Sì |
displayableOrderDate | La 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 | Sì |
displayableOrderComment | Testo 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 | Sì |
shippingSpeedCategory | Il metodo di spedizione per l'ordine di evasione. Tipo: ShippingSpeedCategory | Sì |
deliveryWindow | L'intervallo di tempo entro il quale deve essere consegnato un ordine di evasione con consegna programmata. Tipo: DeliveryWindow | No |
destinationAddress | L'indirizzo di destinazione per l'ordine di evasione. Tipo: Address | Sì |
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 di evasione deve essere spedito adesso o se è stato bloccato. Tipo: FulfillmentAction | No |
fulfillmentPolicy | La politica di adempimento. Tipo: FulfillmentPolicy | No |
codSettings | Gli 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 | Sì |
shipFromCountryCode | Il 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 |
notificationEmails | Un 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 |
featureConstraints | Un elenco delle funzionalità e delle relative politiche di evasione da applicare all'ordine. Tipo: < FeatureSettings > matrice | 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 | Sì |
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:
Nome | Descrizione |
---|---|
errors | Si 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
.
Parametro | Descrizione | Obbligatorio |
---|---|---|
sellerFulfillmentOrderId | L'identificativo assegnato all'articolo dal venditore al momento della creazione dell'ordine con gestione logistica. Lunghezza massima: 40 Tipo: stringa | Sì |
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 corpo | Descrizione | Obbligatorio |
---|---|---|
fulfillmentOrder | Informazioni generali su un ordine con gestione logistica, incluso il suo stato. Tipo: | Sì |
| Un array di informazioni sugli articoli relativi agli ordini con gestione logistica. Tipo: | Sì |
fulfillmentShipments | Un array di informazioni relative alla spedizione con gestione logistica. Tipo: | No |
returnItems | Un array di articoli che Amazon ha accettato per il reso. Ritorna vuoto se nessun articolo è stato accettato per il reso. Tipo: | Sì |
returnAuthorizations | Un array di informazioni sull'autorizzazione del reso. Tipo: | Sì |
Una risposta non riuscita ha un codice diverso da 2xx e include i seguenti oggetti.
Nome | Descrizione |
---|---|
errors | Durante l'operazione si sono verificati uno o più errori imprevisti. Tipo: |
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:
- Autorizzazione dal partner di vendita per il quale stai effettuando chiamate. Per ulteriori informazioni, vedi Autorizzazione delle applicazioni API per i partner di vendita.
- Il Ruolo di Logistica di Amazon assegnato al tuo profilo di sviluppatore.
- 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 corpo | Descrizione | Obbligatorio |
---|---|---|
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: | Sì |
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. | Sì |
shippingSpeedCategories | Un elenco dei metodi di spedizione utilizzati per creare le anteprime degli ordini con gestione logistica. Valori possibili:
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:
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 Tipo: booleano | No |
featureConstraints | Un elenco delle funzionalità e delle relative politiche di gestione logistica da applicare all'ordine. Tipo: matrice < | 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": []
}
]
}
}
Nome | Descrizione |
---|---|
fulfillmentPreviews | Un array di informazioni sull'anteprima di gestione logistica. Tipo: |
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à.
Nome | Descrizione |
---|---|
errors | Si sono verificati uno o più errori imprevisti durante l'operazione Tipo: |
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 corpo | Descrizione | Obbligatorio |
---|---|---|
marketplaceId | Il marketplace in cui viene effettuato l'ordine con gestione logistica. Tipo: stringa | No |
sellerFulfillmentOrderId | Un identificativo dell'ordine di evasione che il venditore crea per tracciare il proprio ordine di evasione. Il
Lunghezza massima: 40 Tipo: stringa | Sì |
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 | 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: | Sì |
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 | Sì |
shippingSpeedCategory | Il metodo di spedizione per l'ordine con gestione logistica. Tipo: | Sì |
deliveryWindow | L'intervallo di tempo entro il quale deve essere consegnato un ordine con gestione logistica a consegna programmata. Tipo: | No |
destinationAddress | L'indirizzo di destinazione dell'ordine con gestione logistica. Tipo: | Sì |
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: | No |
fulfillmentAction | Specifica se l'ordine con gestione logistica deve essere spedito adesso o se l'ordine è bloccato. Tipo: | No |
fulfillmentPolicy | Il valore Tipo: | No |
codSettings | Gli addebiti COD che associ a un ordine di evasione COD. Tipo: | 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: | No |
featureConstraints | Un elenco delle funzionalità e delle relative politiche di gestione logistica da applicare all'ordine. Tipo: < | 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. | Sì |
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.
Nome | Descrizione |
---|---|
errors | Si sono verificati uno o più errori imprevisti durante l'operazione Tipo: |
Passaggio 3. Convalida i dettagli dell'ordine
Chiama l'operazione getFulfillmentOrder
per convalidare fulfillmentAction = Ship
e fulfillmentOrderStatus = Received
.
Parametro | Descrizione | Obbligatorio |
---|---|---|
sellerFulfillmentOrderId | L'identificativo assegnato all'articolo dal venditore al momento della creazione dell'ordine con gestione logistica. Lunghezza massima: 40 Tipo: stringa | Sì |
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 corpo | Descrizione | Obbligatorio |
---|---|---|
fulfillmentOrder | Informazioni generali su un ordine con gestione logistica, incluso il suo stato. Tipo: | Sì |
fulfillmentOrderItems | Un array di informazioni sugli articoli relativi agli ordini con gestione logistica. Tipo: | Sì |
fulfillmentShipments | Un array di informazioni relative alla spedizione con gestione logistica. Tipo: | No |
returnItems | Un array di articoli che Amazon ha accettato per il reso. Ritorna vuoto se nessun articolo è stato accettato per il reso. Tipo: | Sì |
returnAuthorizations | Un array di informazioni sull'autorizzazione del reso. Tipo: | Sì |
Una risposta non riuscita ha un codice diverso da 2xx e include i seguenti oggetti.
Nome | Descrizione | Obbligatorio |
---|---|---|
errors | Si sono verificati uno o più errori imprevisti durante l'operazione Tipo: | Sì |
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:
Parametro | Descrizione | Obbligatorio |
---|---|---|
sellerFulfillmentOrderId | L'identificativo assegnato all'articolo dal venditore al momento della creazione dell'ordine con gestione logistica. Lunghezza massima: 40 Tipo: stringa | Sì |
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 corpo | Descrizione | Obbligatorio |
---|---|---|
fulfillmentOrder | Informazioni generali su un ordine con gestione logistica, incluso il suo stato. Tipo: | Sì |
fulfillmentOrderItems | Un array di informazioni sugli articoli relativi agli ordini con gestione logistica. Tipo: | Sì |
fulfillmentShipments | Un array di informazioni relative alla spedizione con gestione logistica. Tipo: | No |
returnItems | Un array di articoli che Amazon ha accettato per il reso. Ritorna vuoto se nessun articolo è stato accettato per il reso. Tipo: | Sì |
returnAuthorizations | Un array di informazioni sull'autorizzazione del reso. Tipo: | Sì |
Una risposta non riuscita ha un codice diverso da 2xx e include i seguenti oggetti.
Nome | Descrizione | Obbligatorio |
---|---|---|
errors | Si sono verificati uno o più errori imprevisti durante l'operazione Tipo: | Sì |
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.
Parametro | Descrizione | Obbligatorio |
---|---|---|
packageNumber | L'identificativo del pacco non crittografato riportato dall'operazione Tipo: numero intero (int32) | Sì |
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."
}
]
}
}
Nome | Descrizione | Obbligatorio |
---|---|---|
packageNumber | L'identificativo del pacco. Tipo: numero intero (int32) | Sì |
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: | No |
estimatedArrivalDate | La data di arrivo prevista. Tipo: | No |
shipToAddress | La città di destinazione del pacco. Tipo: | No |
currentStatus | Lo stato di consegna attuale del pacco. Tipo: | No |
currentStatusDescription | Descrizione corrispondente al valore Tipo: stringa | No |
signedForBy | Il nome della persona che ha firmato per il pacco. Tipo: stringa | No |
additionalLocationInfo | Informazioni aggiuntive sulla posizione. Tipo: | No |
trackingEvents | Un array di informazioni sugli eventi di tracciamento. Tipo: | 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à.
Nome | Descrizione |
---|---|
errors | Si sono verificati uno o più errori imprevisti durante l'operazione Tipo: |
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:
- Autorizzazione dal partner di vendita per il quale stai effettuando chiamate. Per ulteriori informazioni, vedi Autorizzazione delle applicazioni API per i partner di vendita.
- Il Ruolo di Logistica di Amazon assegnato al tuo profilo di sviluppatore.
- 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 corpo | Descrizione | Obbligatorio |
---|---|---|
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: | Sì |
items | Informazioni identificative e informazioni sulla quantità per gli articoli nell'anteprima dell'ordine con gestione logistica. | Sì |
shippingSpeedCategories | Un elenco dei metodi di spedizione utilizzati per creare le anteprime degli ordini con gestione logistica. Valori possibili:
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 Tipo: booleano | No |
featureConstraints | Un elenco delle funzionalità e delle relative politiche di gestione logistica da applicare all'ordine. Tipo: matrice < | 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"
]
}
Nome | Descrizione |
---|---|
fulfillmentPreviews | Un array di informazioni sull'anteprima di gestione logistica. Tipo: |
Una risposta non riuscita ha un codice diverso da 2xx e include i seguenti oggetti. Una risposta 404 fornisce gli eventuali errori di inidoneità.
Nome | Descrizione | Obbligatorio |
---|---|---|
errors | Si sono verificati uno o più errori imprevisti durante l'operazione Tipo: | Sì |
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 corpo | Descrizione | Obbligatorio |
---|---|---|
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 Lunghezza massima: 40 Tipo: stringa | Sì |
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 Lunghezza massima: 40 Tipo: stringa | Sì |
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: | Sì |
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 | Sì |
shippingSpeedCategory | Il metodo di spedizione per l'ordine con gestione logistica. Tipo: | Sì |
deliveryWindow | L'intervallo di tempo entro il quale deve essere consegnato un ordine con gestione logistica a consegna programmata. Tipo: | No |
destinationAddress | L'indirizzo di destinazione dell'ordine con gestione logistica. Tipo: | Sì |
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: | No |
fulfillmentAction | Specifica se l'ordine con gestione logistica deve essere spedito adesso o se l'ordine è bloccato. Tipo: | No |
fulfillmentPolicy | Il valore "FulfillmentPolicy" specificato quando hai inviato l'operazione Tipo: | No |
codSettings | Gli addebiti COD che associ a un ordine di evasione COD. Tipo: | 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: | No |
featureConstraints | Un elenco delle funzionalità e delle relative politiche di gestione logistica da applicare all'ordine. Tipo: matrice < | No |
Items | Un elenco di articoli da includere nell'anteprima dell'ordine con gestione logistica, inclusa la quantità. | Sì |
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.
Nome | Descrizione |
---|---|
errors | Si sono verificati uno o più errori imprevisti durante l'operazione Tipo: |
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
.
Parametro | Descrizione | Obbligatorio |
---|---|---|
sellerFulfillmentOrderId | L'identificativo assegnato all'articolo dal venditore al momento della creazione dell'ordine con gestione logistica. Tipo: stringa | Sì |
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.
Nome | Descrizione |
---|---|
errors | Si sono verificati uno o più errori imprevisti durante l'operazione Tipo: |
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.
Parametro | Descrizione | Obbligatorio |
---|---|---|
sellerFulfillmentOrderId | L'identificativo assegnato all'articolo dal venditore al momento della creazione dell'ordine con gestione logistica. Lunghezza massima: 40 Tipo: stringa | Sì |
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 corpo | Descrizione | Obbligatorio |
---|---|---|
fulfillmentOrder | Informazioni generali su un ordine con gestione logistica, incluso il suo stato. Tipo: | Sì |
fulfillmentOrderItems | Un array di informazioni sugli articoli relativi agli ordini con gestione logistica. Tipo: | Sì |
fulfillmentShipments | Un array di informazioni relative alla spedizione con gestione logistica. Tipo: | No |
returnItems | Un array di articoli che Amazon ha accettato per il reso. Ritorna vuoto se nessun articolo è stato accettato per il reso. Tipo: | Sì |
returnAuthorizations | Un array di informazioni sull'autorizzazione del reso. Tipo: | Sì |
Una risposta non riuscita ha un codice diverso da 2xx e include i seguenti oggetti.
Nome | Descrizione | Obbligatorio |
---|---|---|
errors | Si sono verificati uno o più errori imprevisti durante l'operazione Tipo: | Sì |
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
- Il venditore deve condividere l'espressione regolare dei numeri di serie generati con Amazon.
- Il venditore deve incollare il numero di serie univoco generato su ogni articolo quando invia l'inventario ad Amazon.
- 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.
- Autorizzazione dal partner di vendita per il quale stai effettuando chiamate. Per ulteriori informazioni, vedi Autorizzazione delle applicazioni API per i partner di vendita.
- Il Ruolo di Logistica di Amazon assegnato al tuo profilo di sviluppatore.
- 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 corpo | Descrizione | Obbligatorio |
---|---|---|
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 Lunghezza massima: 40 Tipo: stringa | Sì |
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 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. | Sì |
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: | Sì |
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 | Sì |
shippingSpeedCategory | Il metodo di spedizione per l'ordine con gestione logistica. Tipo: | Sì |
deliveryWindow | L'intervallo di tempo entro il quale deve essere consegnato un ordine con gestione logistica a consegna programmata. Tipo: | No |
destinationAddress | L'indirizzo di destinazione dell'ordine con gestione logistica. Tipo: | Sì |
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: | No |
fulfillmentAction | Specifica se l'ordine con gestione logistica deve essere spedito adesso o se l'ordine è bloccato. Tipo: | No |
fulfillmentPolicy | Il valore Tipo: | No |
codSettings | Gli addebiti in contrassegno (COD) associati a un ordine di evasione in contrassegno. Tipo: | 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: | No |
featureConstraints | Un elenco delle funzionalità e delle relative politiche di gestione logistica da applicare all'ordine. Tipo:< | No |
Articoli | Un elenco di articoli da includere nell'anteprima dell'ordine con gestione logistica, inclusa la quantità. | Sì |
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.
Nome | Descrizione |
---|---|
errors | Si sono verificati uno o più errori imprevisti durante l'operazione Tipo: |
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.
Parametro | Descrizione | Obbligatorio |
---|---|---|
sellerFulfillmentOrderId | L'identificativo assegnato all'articolo dal venditore al momento della creazione dell'ordine con gestione logistica. Lunghezza massima: 40 Tipo: stringa | Sì |
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 corpo | Descrizione | Obbligatorio |
---|---|---|
fulfillmentOrder | Informazioni generali su un ordine con gestione logistica, incluso il suo stato. Tipo: | Sì |
fulfillmentOrderItems | Un array di informazioni sugli articoli relativi agli ordini con gestione logistica. Tipo: | Sì |
fulfillmentShipments | Un array di informazioni relative alla spedizione con gestione logistica. Tipo: | No |
returnItems | Un array di articoli che Amazon ha accettato per il reso. Ritorna vuoto se nessun articolo è stato accettato per il reso. Tipo: | Sì |
returnAuthorizations | Un array di informazioni sull'autorizzazione del reso. Tipo: | Sì |
Una risposta non riuscita ha un codice diverso da 2xx e include i seguenti oggetti.
Nome | Descrizione | Obbligatorio |
---|---|---|
errors | Si sono verificati uno o più errori imprevisti durante l'operazione Tipo: | Sì |
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.
Parametro | Descrizione | Obbligatorio |
---|---|---|
sellerFulfillmentOrderId | L'identificativo assegnato all'articolo dal venditore al momento della creazione dell'ordine con gestione logistica. Lunghezza massima: 40 Tipo: stringa | Sì |
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 corpo | Descrizione | Obbligatorio |
---|---|---|
fulfillmentOrder | Informazioni generali su un ordine con gestione logistica, incluso il suo stato. Tipo: | Sì |
fulfillmentOrderItems | Un array di informazioni sugli articoli relativi agli ordini con gestione logistica. Tipo: | Sì |
fulfillmentShipments | Un array di informazioni relative alla spedizione con gestione logistica. Tipo: | No |
returnItems | Un array di articoli che Amazon ha accettato per il reso. Ritorna vuoto se nessun articolo è stato accettato per il reso. Tipo: | Sì |
returnAuthorizations | Un array di informazioni sull'autorizzazione del reso. Tipo: | Sì |
Una risposta non riuscita ha un codice diverso da 2xx e include i seguenti oggetti.
Nome | Descrizione | Obbligatorio |
---|---|---|
errors | Si sono verificati uno o più errori imprevisti durante l'operazione Tipo: | Sì |
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:
- Autorizzazione dal partner di vendita per il quale stai effettuando chiamate. Per ulteriori informazioni, vedi Autorizzazione delle applicazioni API per i partner di vendita.
- Il Ruolo di Logistica di Amazon assegnato al tuo profilo di sviluppatore.
- 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 corpo | Descrizione | Obbligatorio |
---|---|---|
marketplaceId | Il 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 Lunghezza massima: 40 Tipo: stringa | Sì |
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 Lunghezza massima: 40 Tipo: stringa | Sì |
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: | Sì |
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 | Sì |
shippingSpeedCategory | Il metodo di spedizione per l'ordine con gestione logistica. Tipo: | Sì |
deliveryWindow | L'intervallo di tempo entro il quale deve essere consegnato un ordine con gestione logistica a consegna programmata. Tipo: | No |
destinationAddress | L'indirizzo di destinazione dell'ordine con gestione logistica. Tipo: | Sì |
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: | No |
fulfillmentAction | Specifica se l'ordine con gestione logistica deve essere spedito adesso o se l'ordine è bloccato. Tipo: | No |
fulfillmentPolicy | Il valore Tipo: | No |
codSettings | Gli addebiti in contrassegno (COD) associati a un ordine di evasione in contrassegno. Tipo: | 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: | No |
featureConstraints | Un elenco delle funzionalità e delle relative politiche di gestione logistica da applicare all'ordine. Tipo: matrice < | No |
Items | Un elenco di articoli da includere nell'anteprima dell'ordine con gestione logistica, inclusa la quantità. | Sì |
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.
Nome | Descrizione |
---|---|
errors | Si sono verificati uno o più errori imprevisti durante l'operazione Tipo: |
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:
- Autorizzazione dal partner di vendita per il quale stai effettuando chiamate. Per ulteriori informazioni, vedi Autorizzazione delle applicazioni API per i partner di vendita.
- Il Ruolo di Logistica di Amazon assegnato al tuo profilo di sviluppatore.
- 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 corpo | Descrizione | Obbligatorio |
---|---|---|
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: | Sì |
items | Informazioni identificative e informazioni sulla quantità per gli articoli nell'anteprima dell'ordine con gestione logistica. | Sì |
shippingSpeedCategories | Un elenco dei metodi di spedizione utilizzati per creare le anteprime degli ordini con gestione logistica. Valori possibili:
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:
Tipo: booleano | No |
includeDeliveryWindows | Specifica se riportare l'oggetto di risposta Tipo: booleano | No |
featureConstraints | Un elenco delle funzionalità e delle relative politiche di gestione logistica da applicare all'ordine. Tipo: matrice < | 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"
}
]
}
}
Nome | Descrizione |
---|---|
FulfillmentPreviews | Un array di informazioni sull'anteprima di gestione logistica. Tipo: |
Una risposta non riuscita ha un codice diverso da 2xx e include i seguenti oggetti. Una risposta 404 fornisce gli eventuali errori di inidoneità.
Nome | Descrizione | Obbligatorio |
---|---|---|
errors | Si sono verificati uno o più errori imprevisti durante l'operazione getFulfillmentPreview. Tipo: | Sì |
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 corpo | Descrizione | Obbligatorio |
---|---|---|
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 Lunghezza massima: 40 Tipo: stringa | Sì |
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 Lunghezza massima: 40 Tipo: stringa | Sì |
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: | Sì |
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 | Sì |
shippingSpeedCategory | Il metodo di spedizione per l'ordine con gestione logistica. Tipo: | Sì |
deliveryWindow | L'intervallo di tempo entro il quale deve essere consegnato un ordine con gestione logistica a consegna programmata. Tipo: | No |
destinationAddress | L'indirizzo di destinazione dell'ordine con gestione logistica. Tipo: | Sì |
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: | No |
fulfillmentAction | Specifica se l'ordine con gestione logistica deve essere spedito adesso o se l'ordine è bloccato. Tipo: | No |
fulfillmentPolicy | Il valore Tipo: | No |
codSettings | Gli addebiti COD che associ a un ordine di evasione COD. Tipo: | 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: | No |
featureConstraints | Un elenco delle funzionalità e delle relative politiche di gestione logistica da applicare all'ordine. Tipo:< | No |
Items | Un elenco di articoli da includere nell'anteprima dell'ordine con gestione logistica, inclusa la quantità. | Sì |
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.
Nome | Descrizione |
---|---|
errors | Si sono verificati uno o più errori imprevisti durante l'operazione Tipo: |
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.
Parametro | Descrizione | Obbligatorio |
---|---|---|
sellerFulfillmentOrderId | L'identificativo assegnato all'articolo dal venditore al momento della creazione dell'ordine con gestione logistica. Lunghezza massima: 40 Tipo: stringa | Sì |
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 corpo | Descrizione | Obbligatorio |
---|---|---|
fulfillmentOrder | Informazioni generali su un ordine con gestione logistica, incluso il suo stato. Tipo: | Sì |
fulfillmentOrderItems | Un array di informazioni sugli articoli relativi agli ordini con gestione logistica. Tipo: | Sì |
fulfillmentShipments | Un array di informazioni relative alla spedizione con gestione logistica. Tipo: | No |
returnItems | Un array di articoli che Amazon ha accettato per il reso. Ritorna vuoto se nessun articolo è stato accettato per il reso. Tipo: | Sì |
returnAuthorizations | Un array di informazioni sull'autorizzazione del reso. Tipo: | Sì |
Una risposta non riuscita ha un codice diverso da 2xx e include i seguenti oggetti.
Nome | Descrizione | Obbligatorio |
---|---|---|
errors | Si sono verificati uno o più errori imprevisti durante l'operazione Tipo: | Sì |
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:
- Autorizzazione dal partner di vendita per il quale stai effettuando chiamate. Per ulteriori informazioni, vedi Autorizzazione delle applicazioni API per i partner di vendita.
- Il Ruolo di Logistica di Amazon assegnato al tuo profilo di sviluppatore.
- 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 corpo | Descrizione | Obbligatorio |
---|---|---|
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: | Sì |
items | Informazioni identificative e informazioni sulla quantità per gli articoli nell'anteprima dell'ordine con gestione logistica. | Sì |
shippingSpeedCategories | Un elenco dei metodi di spedizione utilizzati per creare le anteprime degli ordini con gestione logistica. Valori possibili:
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:
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 Tipo: booleano | No |
featureConstraints | Un elenco delle funzionalità e delle relative politiche di gestione logistica da applicare all'ordine. Tipo: < | 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": []
}
]
}
}
Nome | Descrizione |
---|---|
FulfillmentPreviews | Un array di informazioni sull'anteprima di gestione logistica. Tipo: |
Una risposta non riuscita ha un codice diverso da 2xx e include i seguenti oggetti. Una risposta 404 fornisce gli eventuali errori di inidoneità.
Nome | Descrizione | Obbligatorio |
---|---|---|
errors | Si sono verificati uno o più errori imprevisti durante l'operazione Tipo: | Sì |
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:
- Autorizzazione dal partner di vendita per il quale stai effettuando chiamate. Per ulteriori informazioni, vedi Autorizzazione delle applicazioni API per i partner di vendita.
- Il Ruolo di Logistica di Amazon assegnato al tuo profilo di sviluppatore.
- 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 corpo | Descrizione | Obbligatorio |
---|---|---|
EventType | Indica se la notifica contiene informazioni sull'ordine, sulla spedizione o sul reso. Valori EventType:
Tipo: stringa | Sì |
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 | Sì |
SellerFulfillmentOrderId | L'identificativo dell'ordine con gestione logistica che hai creato e inviato utilizzando l'operazione Tipo: stringa | Sì |
FulfillmentOrderStatus | Lo stato attuale dell'ordine con gestione logistica. Valori
Tipo: stringa | Sì |
FulfillmentShipment | Informazioni sulla consegna e sull'articolo per una spedizione in un ordine con gestione logistica. Tipo: | No |
FulfillmentReturnItem | Informazioni su un articolo restituito a un centro logistico Amazon. Tipo: | 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:
- Autorizzazione dal partner di vendita per il quale stai effettuando chiamate. Per ulteriori informazioni, vedi Autorizzazione delle applicazioni API per i partner di vendita.
- Il Ruolo di Logistica di Amazon assegnato al tuo profilo di sviluppatore.
- 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:
Parametro | Descrizione | Obbligatorio |
---|---|---|
sellerSKU | Lo SKU del venditore per il quale sono richiesti i codici del motivo del reso. Tipo: stringa | Sì |
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à Tipo: stringa | Sì |
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"
}
]
}
}
Nome | Descrizione | Obbligatorio |
---|---|---|
returnReasonCode | Un codice che indica un motivo valido per il reso. Tipo: stringa | Sì |
description | Una descrizione leggibile dall'uomo del codice del motivo del reso. Tipo: stringa | Sì |
translatedDescription | Una traduzione della descrizione. La traduzione è nella lingua specificata nel parametro di richiesta Tipo: stringa | No |
Una risposta non riuscita ha un codice diverso da 2xx e include i seguenti oggetti.
Nome | Descrizione |
---|---|
errors | Si sono verificati uno o più errori imprevisti durante l'operazione 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.
Parametro | Descrizione | Obbligatorio |
---|---|---|
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 Tipo: stringa | Sì |
Parametro del corpo | Descrizione | Obbligatorio |
---|---|---|
sellerReturnItemId | Un identificativo assegnato dal venditore all'articolo per cui effettuare il reso. Tipo: stringa | Sì |
sellerFulfillmentOrderItemId | L'identificativo assegnato all'articolo dal venditore al momento della creazione dell'ordine con gestione logistica. Tipo: stringa | Sì |
amazonShipmentId | L'identificativo della spedizione associato all'articolo di reso. Tipo: stringa | Sì |
returnReasonCode | Il codice del motivo del reso assegnato all'articolo del reso dal venditore. Tipo: stringa | Sì |
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"
}
]
}
}
Nome | Descrizione | Obbligatorio |
---|---|---|
ReturnItemList | Un array di articoli che Amazon ha accettato per il reso. Ritorna vuoto se nessun articolo è stato accettato per il reso. Tipo: matrice < | Sì |
InvalidReturnItemList | Un array di informazioni sugli articoli resi non validi. Tipo: matrice < | Sì |
ReturnAuthorizationList | Un array di informazioni sull'autorizzazione del reso. Tipo: matrice < | Sì |
Nome | Descrizione |
---|---|
errors | Durante l'operazione si sono verificati uno o più errori imprevisti. Tipo: |
Una risposta non riuscita ha un codice diverso da 2xx e include i seguenti oggetti. Una risposta 404 fornisce gli eventuali errori di inidoneità.
Nome | Descrizione | Obbligatorio |
---|---|---|
errors | Si sono verificati uno o più errori imprevisti durante l'operazione Tipo: | Sì |
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.
Parametro | Descrizione | Obbligatorio |
---|---|---|
sellerFulfillmentOrderId | L'identificativo assegnato all'articolo dal venditore al momento della creazione dell'ordine con gestione logistica. Lunghezza massima: 40 Tipo: stringa | Sì |
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 corpo | Descrizione | Obbligatorio |
---|---|---|
fulfillmentOrder | Informazioni generali su un ordine con gestione logistica, incluso il suo stato. Tipo: | Sì |
fulfillmentOrderItems | Un array di informazioni sugli articoli relativi agli ordini con gestione logistica. Tipo: | Sì |
fulfillmentShipments | Un array di informazioni relative alla spedizione con gestione logistica. Tipo: | No |
returnItems | Un array di articoli che Amazon ha accettato per il reso. Ritorna vuoto se nessun articolo è stato accettato per il reso. Tipo: | Sì |
returnAuthorizations | Un array di informazioni sull'autorizzazione del reso. Tipo: | Sì |
Una risposta non riuscita ha un codice diverso da 2xx e include i seguenti oggetti.
Nome | Descrizione | Obbligatorio |
---|---|---|
errors | Si sono verificati uno o più errori imprevisti durante l'operazione Tipo: | Sì |
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:
- Autorizzazione dal partner di vendita per il quale stai effettuando chiamate. Per ulteriori informazioni, vedi Autorizzazione delle applicazioni API per i partner di vendita.
- Il Ruolo di Logistica di Amazon assegnato al tuo profilo di sviluppatore.
- 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 corpo | Descrizione | Obbligatorio |
---|---|---|
product | I dettagli del prodotto per l'offerta di consegna. Tipo: | Sì |
terms | I termini dell'offerta di consegna. Tipo: | Sì |
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.
Nome | Descrizione |
---|---|
errors | Si sono verificati uno o più errori imprevisti durante l'operazione Tipo: |
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:
- Autorizzazione dal partner di vendita per il quale stai effettuando chiamate. Per ulteriori informazioni, vedi Autorizzazione delle applicazioni API per i partner di vendita.
- Il Ruolo di Logistica di Amazon assegnato al tuo profilo di sviluppatore.
- 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 corpo | Descrizione | Obbligatorio |
---|---|---|
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 Lunghezza massima: 40 Tipo: stringa | Sì |
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 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 | Sì |
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: | Sì |
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 | Sì |
shippingSpeedCategory | Il metodo di spedizione per l'ordine con gestione logistica. ShippingSpeedCategory | Sì |
deliveryWindow | L'intervallo di tempo entro il quale deve essere consegnato un ordine con gestione logistica a consegna programmata. Tipo: | No |
destinationAddress | L'indirizzo di destinazione dell'ordine con gestione logistica. Tipo: | Sì |
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: | No |
fulfillmentAction | Specifica se l'ordine con gestione logistica deve essere spedito adesso o se l'ordine è bloccato. Tipo: | No |
fulfillmentPolicy | Il valore Tipo: | No |
codSettings | Gli addebiti in contrassegno (COD) associati a un ordine di evasione in contrassegno. Tipo: | 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: | No |
featureConstraints | Un elenco delle funzionalità e delle relative politiche di gestione logistica da applicare all'ordine. Tipo: matrice < | No |
Items | Un elenco di articoli da includere nell'anteprima dell'ordine con gestione logistica, inclusa la quantità. | Sì |
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.
Nome | Descrizione |
---|---|
errors | Si sono verificati uno o più errori imprevisti durante l'operazione Tipo: |
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:
- Autorizzazione dal partner di vendita per il quale stai effettuando chiamate. Per ulteriori informazioni, vedi Autorizzazione delle applicazioni API per i partner di vendita.
- Il Ruolo di Logistica di Amazon assegnato al tuo profilo di sviluppatore.
- 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 corpo | Descrizione | Obbligatorio |
---|---|---|
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 Lunghezza massima: 40 Tipo: stringa | Sì |
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 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 | Sì |
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: | Sì |
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 | Sì |
shippingSpeedCategory | Il metodo di spedizione per l'ordine con gestione logistica. ShippingSpeedCategory | Sì |
deliveryWindow | L'intervallo di tempo entro il quale deve essere consegnato un ordine con gestione logistica a consegna programmata. Tipo: | No |
destinationAddress | L'indirizzo di destinazione dell'ordine con gestione logistica. Tipo: | Sì |
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: | No |
fulfillmentAction | Specifica se l'ordine con gestione logistica deve essere spedito adesso o se l'ordine è bloccato. Tipo: | No |
fulfillmentPolicy | Il valore Tipo: | No |
codSettings | Gli addebiti in contrassegno (COD) associati a un ordine di evasione in contrassegno. Tipo: | 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: | No |
featureConstraints | Un elenco delle funzionalità e delle relative politiche di gestione logistica da applicare all'ordine. Tipo: matrice < | No |
Items | Un elenco di articoli da includere nell'anteprima dell'ordine con gestione logistica, inclusa la quantità. | Sì |
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.
Nome | Descrizione |
---|---|
errors | Si sono verificati uno o più errori imprevisti durante l'operazione Tipo: |
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:
- Autorizzazione dal partner di vendita per il quale stai effettuando chiamate. Per ulteriori informazioni, vedi Autorizzazione delle applicazioni API per i partner di vendita.
- Il Ruolo di Logistica di Amazon assegnato al tuo profilo di sviluppatore.
- 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:
Parametro | Descrizione | Obbligatorio |
---|---|---|
sellerFulfillmentOrderId | L'identificativo assegnato all'articolo dal venditore al momento della creazione dell'ordine con gestione logistica. Lunghezza massima: 40 Tipo: stringa | Sì |
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 corpo | Descrizione | Obbligatorio |
---|---|---|
fulfillmentOrder | Informazioni generali su un ordine con gestione logistica, incluso il suo stato. Tipo: | Sì |
fulfillmentOrderItems | Un array di informazioni sugli articoli relativi agli ordini con gestione logistica. Tipo: | Sì |
fulfillmentShipments | Un array di informazioni relative alla spedizione con gestione logistica. Tipo: | No |
returnItems | Un array di articoli che Amazon ha accettato per il reso. Ritorna vuoto se nessun articolo è stato accettato per il reso. Tipo: | Sì |
returnAuthorizations | Un array di informazioni sull'autorizzazione del reso. Tipo: | Sì |
Una risposta non riuscita ha un codice diverso da 2xx e include i seguenti oggetti.
Nome | Descrizione | Obbligatorio |
---|---|---|
errors | Si sono verificati uno o più errori imprevisti durante l'operazione Tipo: | Sì |
Updated 28 days ago