Hub per sviluppatoriStato dell'APISupporto

Guida ai casi d'uso delle API Approvvigionamento al dettaglio per i fornitori v1

Come aiutare i fornitori a gestire le operazioni di vendita al dettaglio in modo programmatico tramite l'integrazione di servizi web.

Le API per i partner di vendita per i fornitori di vendita al dettaglio aiutano i fornitori nella gestione delle proprie operazioni di vendita al dettaglio a livello di programmazione tramite l'integrazione di servizi web. L'integrazione automatica con Amazon consente ai fornitori di migliorare e mantenere le proprie prestazioni su larga scala e far crescere la propria attività con Amazon.

Vendors in the direct fulfillment program should refer to the Vendor Direct Fulfillment APIs v1 Use Case Guide to learn about APIs specific to direct fulfillment.

I fornitori possono utilizzare queste API per creare applicazioni per aumentare l'efficienza operativa, ridurre gli sforzi e gli errori, e migliorare le prestazioni.

For authentication and authorization information, refer to Authorizing Selling Partner API applications.

Processi aziendali che puoi soddisfare utilizzando le API Vendor Retail Procurement

You can use the Vendor Orders API to manage purchase orders, the Vendor Shipments API to send shipment confirmations, the Vendor Invoices API to submit invoices, and the Vendor Transaction Status API to determine the status of your order acknowledgements and shipment confirmations.

Processo aziendale Caso d'uso Operazione
Gestione degli ordini di acquisto
Ottieni modifiche o cancellazioni degli ordini di acquisto getPurchaseOrders
Returns a list of purchase orders created or changed during the time frame that you specify.
Verifica lo stato dell'ordine di acquisto getPurchaseOrdersStatus
Returns purchase order statuses based on the filters that you specify.
Invia la conferma dell'ordine di acquisto submitAcknowledgement
Submits acknowledgements for one or more purchase orders.
Verifica lo stato della transazione di conferma dell'ordine getTransaction
Returns the status of the transaction that you specify.
Spedizioni
Invia richieste di spedizione SubmitShipments
Submits one or more shipment request for vendor Orders.
Ottieni lo stato della spedizione o le etichette di spedizione/trasporto GetShipmentDetails
Returns the Details about Shipment, Carrier Details, status of the shipment, container details and other details related to shipment based on the filter parameters value that you specify.
Invia o aggiorna la notifica di spedizione anticipata (ASN) /le conferme di spedizione SubmitShipmentConfirmations
Submits one or more shipment confirmations for vendor orders.
Verifica lo stato della transazione di conferma della spedizione getTransaction
Returns the status of the transaction that you specify.
Ottieni le etichette di spedizione GetShipmentLabels
Returns small parcel shipment labels based on the filters that you specify.
Fatture e note di credito
Invia le fatture dei fornitori submitInvoices
Submit new invoices to Amazon.

Cos'è l'API Ordini dei fornitori?

You can use the Vendor Orders API (Orders API) to receive purchase orders and to send order acknowledgements to accept or reject order fulfillment.

L'API Vendor Orders include le seguenti operazioni:

Operazione Metodo HTTP Path Descrizione
getPurchaseOrders GET /vendor/orders/v1/purchaseOrders Restituisce un elenco di ordini d'acquisto creati o modificati durante la finestra temporale specificata. Il recupero dei dati è possibile per un periodo massimo di sei mesi dalla data della chiamata POST originale.
getPurchaseOrder GET /vendor/orders/v1/purchaseOrders /{purchaseOrderNumber} Restituisce un ordine di acquisto (PO) in base al purchaseOrderNumber valore specificato dall'utente. Il recupero dei dati è possibile per un periodo massimo di sei mesi dalla data in cui viene effettuata la chiamata POST originale.
submitAcknowledgement POST /vendor/orders/v1/acknowledgements Conferma (accetta o rifiuta) uno o più ordini d'acquisto.
getPurchaseOrdersStatus GET /vendor/orders/v1/purchaseOrdersStatus Restituisce gli stati degli ordini d'acquisto in base ai filtri specificati. Il recupero dei dati è possibile per un periodo massimo di sei mesi dalla data della chiamata POST originale.

You can use the getPurchaseOrders operation to access orders created or changed during a specified time period (within a rolling window of the last six months, after June 2020). To optimize response time, we recommend that you limit the time range to no more than seven days.

You can use the getPurchaseOrder operation to get detailed order information for a specific order. You can then use the submitAcknowledgement operation to accept or reject the order.

After you accept or reject your orders, you can use the getPurchaseOrdersStatus operation to return the acknowledgement status of one or more purchase orders.

📘

Nota

È possibile restituire i dettagli completi dell'ordine di acquisto chiamando il getPurchaseOrders operazione, oppure restituisci solo i numeri dell'ordine di acquisto con il includeDetails filtro. Il valore predefinito per questo parametro è true, quindi se non includi questo parametro di query, restituirai i dettagli completi degli ordini di acquisto. Se usi includeDetails=false, la risposta includerà solo un elenco dei numeri degli ordini di acquisto e lo stato corrente di ciascun ordine di acquisto.

Il seguente diagramma illustra il flusso di lavoro per l'utilizzo dell'API Ordini dei fornitori.

The Vendor orders workflow.

getPurchaseOrders

The getPurchaseOrders operation returns either a list of order references (purchase order numbers and status) or complete order details, for all orders that meet the criteria specified in the request. If you are returning only order references, they can be used later with the getPurchaseOrder operation to get order details for a specific order.

Devi utilizzare questa API per ottenere gli ordini d'acquisto disponibili per la gestione logistica. Amazon consiglia ai fornitori di verificare la presenza di ordini almeno una volta all'ora durante l'orario lavorativo. A seconda del volume d'affari, puoi scegliere di controllare più frequentemente. Puoi ricevere fino a 100 ordini d'acquisto con una chiamata API. Se sono presenti più di 100 ordini, puoi utilizzare nextToken per ottenere il set di ordini successivo.

Modifiche e annullamento degli ordini

Puoi restituire le modifiche e gli annullamenti tramite l'operazione getPurchaseOrders.

Modifiche degli ordini: a volte Amazon modifica i dati degli ordini d'acquisto dopo la creazione per via di modifiche dei requisiti. I fornitori possono utilizzare l'API getPurchaseOrders per ottenere gli ordini aggiornati. Se Amazon modifica un ordine d'acquisto, tale ordine avrà un campo purchaseOrderChangedDate che rappresenta la data e l'ora dell'aggiornamento di Amazon. Se questo campo non esiste, l'ordine non è mai stato modificato dopo la creazione.

📘

Nota

Amazon può modificare l'ordine di acquisto anche dopo che lo hai confermato.

I fornitori possono ricevere un elenco di ordini modificati in un intervallo di date specifico utilizzando i parametri di query changedAfter e changedBefore, che restituiscono gli ordini modificati e aggiornati da Amazon in questo intervallo e che devono essere gestiti. In alternativa, i fornitori possono utilizzare il filtro isPOChanged=true per ricevere tutti gli ordini d'acquisto modificati.

Amazon consiglia di eseguire una chiamata API separata, con l'intervallo di date modificato, alcune volte al giorno per ricevere gli ordini modificati per un giorno. Ad esempio, quattro volte al giorno puoi chiamare l'operazione Get Purchase Orders per richiedere la modifica degli ordini nelle ultime sei ore.

Di seguito è riportato un elenco di modifiche che possono contribuire alle modifiche degli ordini. Per queste modifiche, è necessario recuperare l'ordine modificato e spedire l'ordine di acquisto corretto:

  • Modifica della finestra di spedizione o consegna
  • Aggiornamenti degli articoli dell'ordine d'acquisto come modifica della quantità, annullamento, modifica del costo.
  • Aggiunta di un nuovo articolo all'ordine d'acquisto.
  • PO annullato/non annullato
  • Modifica del tipo di ordine d'acquisto.
  • Modifica della destinazione di consegna dell'ordine di acquisto (centro logistico)
  • Modifica delle informazioni di trasporto dell'ordine d'acquisto.

Annullamento dell'articolo: Puoi anche utilizzare l'API Vendor Orders, con il filtro poItemState=Cancelled, per restituire gli ordini con uno o più articoli annullati. In questo modo verranno restituiti tutti gli ordini per i quali uno o più articoli sono stati annullati da Amazon dopo la creazione dell'ordine di acquisto. Questo ti aiuterà a ricevere solo gli ordini che hanno annullato gli articoli (la quantità ordinata è pari a zero) e ad assicurarti di non spedire gli articoli annullati.

📘

Nota

L'annullamento dell'articolo si qualifica come modifica dell'ordine e pertanto restituirai anche questi ordini con l'elenco degli ordini modificati.

Stato dell'ordine di acquisto e codice fornitore: Lo schema dell'ordine di acquisto include lo stato attuale dell'ordine di acquisto e l'ora di aggiornamento dello stato. Puoi usare il filtro purchaseOrderState per filtrare gli ordini in base allo stato corrente.

Per esempio, i fornitori possono ricevere gli ordini d'acquisto che non sono ancora stati confermati o gestiti utilizzando purchaseOrderState=New.

I fornitori possono anche ricevere gli ordini d'acquisto per un codice fornitore specifico indicando uno dei codici autorizzati nel filtro orderingVendorCode, che restituirà solo gli ordini d'acquisto generati per il codice fornitore nel filtro.

For details about all the available filters, refer to the Vendor Orders API Reference.

Il seguente diagramma illustra il flusso di lavoro di integrazione per il recupero di ordini d'acquisto:

The Vendor orders workflow when retrieving purchase orders.

getPurchaseOrder

The getPurchaseOrder operation uses the purchase order number to return information you specify about the purchase order. The response includes complete purchase order information, including line item details, quantity, and cost.

Utilizza questa operazione per ottenere i dettagli degli ordini specifici restituiti dal getPurchaseOrders operazione.

Il diagramma seguente mostra il flusso di lavoro di integrazione durante il recupero di un ordine di acquisto specifico:

The Vendor orders workflow when retrieving a specific purchase order.

Requisiti aziendali

  • Ordinazione basata sul peso

    Per gli ordini che contengono articoli venduti a peso, unitOfMeasure campo (sotto listPrice e netCost) riflette l'unità di misura effettiva del peso. I valori dell'unità di misura del peso includono POUNDS, OUNCES, GRAMS, e KILOGRAMS.

  • Utilizzo della finestra di spedizione o della finestra di consegna

    For vendor paid freights, the delivery window information should be used. Dates are represented in date time interval format in accordance with ISO 8601. The format is the start and end date separated by double hyphen (--). The start date field represents the earliest date that Amazon expects the freight to be delivered to the Amazon fulfillment center listed on the purchase order. The end date field represents the latest date that Amazon expects the freight to be delivered to the Amazon fulfillment center listed on the purchase order.

    Use the ship window information for Amazon-paid freights. The date is represented in date/time interval format according to ISO 8601. The format is start and end date separated by double hyphen (--). The start date field represents the earliest date that Amazon expects to pick up the freight. The end date represents the latest date that Amazon expects to pick up the freight. If the same date is listed in the start date and end date fields, then read that date as the date that Amazon expects to pick up the freight.

  • Gli arretrati sono accettabili per l'articolo di una voce?

    Devi leggere i valori nel campo isBackOrderAllowed. Se il valore è true, l'ordine può essere elaborato in arretrato, mentre se è false, gli arretrati non sono consentiti.

  • Codici offerta

    I codici offerta sono codici promozionali riportati nel campo dealCode dell'ordine, nel quale sarà riportata qualsiasi informazione relativa a codici promozionali, sconti speciali o prezzi.

  • Politica di annullamento degli arretrati

    Il tuo rappresentante commerciale Amazon determina la politica degli ordini arretrati. Discuti i dettagli con il tuo vendor manager.

📘

Nota

Le date di annullamento del backorder potrebbero non essere inserite nell'ordine. È necessario impostare la politica dei backorder a livello di account.

  • Usa l'API per modificare un ordine

    Al momento non è possibile inviare una modifica a un ordine utilizzando l'API. Dopo aver effettuato un ordine, modificarlo è una procedura manuale tramite Vendor Central.

Requisiti aziendali specifici per paese

FunzionalitàIndiaEuropaNord America
Costo nettoCondizionale. Costo netto o prezzo di listino.Condizionale. Costo netto o prezzo di listino.Condizionale. Costo netto o prezzo di listino.
Prezzo di listinoCondizionale. Costo netto o prezzo di listino.Condizionale. Costo netto o prezzo di listino.Condizionale. Costo netto o prezzo di listino.
ArretratoNon applicabileSupportatoSupportato
Parte acquirenteL'indirizzo dell'entità acquirente di AmazonL'ID assegnato alla parte acquirenteNon applicabile
Parte venditriceIl codice fornitore Amazon assegnato al fornitoreIl codice fornitore Amazon assegnato al fornitoreIl codice fornitore Amazon assegnato al fornitore
Destinatario spedizioneL'indirizzo dell'entità destinataria della spedizioneL'ID assegnato al destinatario della spedizioneNon applicabile
Intestatario della fatturaL'indirizzo dell'entità a cui intestare la fattura.L'indirizzo dell'entità a cui intestare la fattura.Non applicabile

submitAcknowledgement

You can use the submitAcknowledgement operation to accept or reject a purchase order for fulfillment. Amazon expects a complete acknowledgement, including all purchase order line items for the purchase order. If you do not provide all line items for the purchase order in the acknowledgement, Amazon will implicitly reject the missing line items.

Amazon si aspetta che tu invii la conferma il più rapidamente possibile, al più tardi entro 24 ore. La conferma deve essere una visualizzazione accurata delle quantità e delle date effettive di spedizione.

Per qualsiasi modifica di quantità, prezzo, date di spedizione o di consegna, Amazon si aspetta che il fornitore invii un aggiornamento della conferma entro 48 ore. Il fornitore può inviare un aggiornamento completo o aggiornare solamente un voce. Amazon considera sempre l'aggiornamento come sostituzione delle conferme precedenti per tale voce. Dopo 48 ore, ci aspettiamo di ricevere solamente aggiornamenti delle date di spedizione o di consegna.

Se il primo codice di conferma per una voce specifica era rejected, non sei autorizzato a modificarlo con l'aggiornamento a accepted o backordered.

Verifica delle conferme dell'ordine inviate correttamente

You can verify the status of the original or updated version of the order acknowledgement using Vendor Central or using the Transaction Status API. If the original or updated version doesn't appear after 30 minutes, submit a support case in Vendor Central by navigating to Vendor Central > Support > Contact Us > API Integration.

Il seguente diagramma illustra il flusso di lavoro di integrazione per la conferma degli ordini.

The Vendor orders workflow when acknowledging orders.

Requisiti aziendali

  • Un fornitore può aumentare la quantità originale inviata nell'ordine d'acquisto nella conferma dell'ordine?

    No, non è possibile inviare nella conferma una quantità superiore a quella inviata nell'ordine di acquisto.

  • È necessario inviare una conferma dell'ordine per ogni ordine d’acquisto?

    Yes, in order to update the status of an order in the Amazon system correctly, Amazon requires PO confirmation using the API or Vendor Central. If you are unable to meet our order acknowledgement requirements using the API, you must confirm your purchase orders using Vendor Central. Contact your Amazon business representative if you do not have a Vendor Central account.

  • È necessario indicare ogni voce dell'ordine d'acquisto nella conferma dell'ordine corrispondente?

    Sì, in modo che Amazon possa aggiornare correttamente lo stato dell'ordine.

  • Se un articolo viene messo in arretrato, è necessario fornire la quantità nella conferma dell'ordine?

    Sì, affinché il sistema Amazon possa aggiornare lo stato dell'articolo relativo alla voce correttamente.

  • Come devono essere segnalati gli articoli obsoleti in un ordine utilizzando la conferma dell'ordine?

    Non processare o spedire un articolo arrivato con un numero di articolo non valido sull'ordine. Restituisci il numero dell'articolo non valido sulla conferma e confermalo come invalid. I seguenti codici di riconoscimento indicano rejected a causa dell'obsolescenza dell'articolo:

    Rifiutata: l'interpretazione di Amazon è che la quantità indicata con questo codice non verrà consegnata ad Amazon come parte di questo ordine di acquisto. È necessario inviare il motivo del rifiuto appropriato come obsolete nel riconoscimento. Ciò indica che, poiché l'articolo è obsoleto, l'articolo non deve più essere ordinato. La nomenclatura Amazon per questo è «hard reject», il che significa che questo articolo non deve essere riordinato. Se questo codice viene ricevuto due volte consecutive per lo stesso progetto (separate da un intervallo di tempo di almeno 48 ore), l'articolo non verrà riordinato.

📘

Nota

Amazon expects an acknowledgement even if all the line items on the purchase order were invalid and did not produce an order or invoice. If a corresponding acknowledgement cannot be sent for a purchase order, Amazon requires manual notification of invalid items. You can notify your buying team through the Vendor Central Contact Us link.

  • Nella conferma devo restituire lo stesso identificativo del prodotto ricevuto nella transazione dell'ordine?

    Le conferme devono restituire esattamente lo stesso identificativo del prodotto inviato nell'ordine d’acquisto.

  • È necessario indicare il prezzo unitario nella conferma?

    Sì, i fornitori sono tenuti a restituire il prezzo di costo unitario nella conferma dell'ordine e tale prezzo deve corrispondere al prezzo di costo unitario che sarà fatturato. I fornitori di libri sono tenuti a fornire un prezzo di listino e un moltiplicatore di sconto.

  • Il prezzo dell'ordine d'acquisto può essere restituito semplicemente nella conferma?

    No. A prescindere dal prezzo inviato nell'ordine d'acquisto, Amazon richiede che il prezzo di costo sia incluso nella conferma dell'ordine. Il prezzo di costo inviato nella conferma deve corrispondere al prezzo che sarà contenuto nella fattura. I sistemi di pagamento Amazon confronteranno i due prezzi e potrebbero ritardare il pagamento in caso di mancata corrispondenza.

  • Cosa richiede Amazon.com nel caso in cui il prezzo e/o la disponibilità cambino dopo l'invio della conferma iniziale?

    Fornisci una notifica manuale per segnalare eventuali modifiche agli ordini Amazon dopo l'invio della conferma iniziale. Il tuo rappresentante commerciale di Amazon.com può consigliarti in merito a quando, come e chi notificare.

  • È necessario fornire i dati di prezzo per gli articoli in arretrato?

    Sì, è necessario affinché Amazon possa aggiornare correttamente lo stato dell'ordine. Se il prezzo viene omesso, la conferma verrà rifiutata.

  • Come posso sapere se gli ordini in arretrato sono consentiti o meno?

    È necessario leggere il valore in isBackOrderAllowed campo nell'ordine di acquisto. Il valore true indica che gli ordini arretrati sono consentiti. Il valore false indica che i backorder non sono consentiti.

  • È necessario fornire un codice di conferma per tutte le voci indipendentemente dallo stato?

    Sì, è necessario per poter aggiornare correttamente lo stato dell'ordine. Se il codice di conferma viene omesso, la conferma verrà respinta.

  • Qual è la politica di Amazon per le spedizioni parziali? Come devono essere segnalate quando si invia una conferma dell'ordine?

    Le spedizioni parziali sono consentite se l'ordine di acquisto consente ordini arretrati (quando isBackOrderAllowed è true). Amazon consiglia di indicare un ciclo di riconoscimento utilizzando il codice accepted con la data corrispondente e un altro ciclo di conferma utilizzando il codice backordered e la data corrispondente.

    Accettato: per gli articoli che possono essere gestiti immediatamente.

    In arretrato: per la quantità restante che non può essere gestita immediatamente. Tale quantità, ovvero la quantità ordinata meno la quantità confermata, sarà consegnata in seguito (in arretrato).

  • Quando devo usare il segmento listPrice?

    Il segmento listPrice è necessario solo se un fornitore vende libri con un prezzo di listino.

Requisiti aziendali specifici per paese

FunzionalitàIndiaEuropaNord America
Data di spedizione programmataCondizionale. Dipende dai termini di trasporto e dagli attuali accordi commerciali con il fornitore.OpzionaleOpzionale
Data di consegna programmataCondizionale. Dipende dai termini di trasporto e dagli attuali accordi commerciali con il fornitore.OpzionaleOpzionale
Prezzo di listinoNecessario solo per i fornitori di libriSupportatoNecessario solo per i fornitori di libri

Ottieni stato degli ordini d'acquisto

The getPurchaseOrdersStatus operation returns the status for the list of purchase orders that meet the criteria specified in the request. You can use this operation to get the acknowledgement status of the items in purchase orders available to you for fulfillment. This operation returns the history for ordered quantity and acknowledgements of an item. You can view details of all the acknowledgements processed for an item in a purchase order. We have provided a wide range of query parameters to filter the list of POs as per your requirement.

Puoi ricevere fino a 100 ordini con una chiamata API. Se sono presenti più di 100 ordini, puoi utilizzare nextToken per ottenere il set di ordini successivo.

Di seguito sono riportati alcuni esempi di utilizzo dell'operazione getPurchaseOrdersStatus con diversi parametri di query:

  • Puoi ottenere lo stato di tutti gli ordini d'acquisto aperti in un intervallo di date specifico utilizzando la data di creazione (createdBefore e createdAfter) o di aggiornamento (updatedBefore e updatedAfter) insieme a purchaseOrderStatus=OPEN.

  • Puoi usare getPurchaseOrdersStatus operazione per filtrare lo stato dei PoS. Ad esempio, se itemConfirmationStatus=REJECTED, la risposta restituirà tutti gli ordini il cui stato di uno o più articoli è stato rifiutato.

  • Puoi verificare lo stato di un ordine d'acquisto specifico indicando il numero dell'ordine nel parametro di query purchaseOrderNumber.

  • Puoi ricevere lo stato di tutti gli ordini d'acquisto aperti per un codice fornitore specifico indicando il valore del codice in orderingVendorCode e includendo purchaseOrderStatus=OPEN.

  • Puoi ricevere lo stato di tutti gli ordini d'acquisto creati in un intervallo di date che devono essere spediti a un centro logistico Amazon specifico indicando il codice del centro logistico in shipToPartyId e la finestra temporale in createdBefore e createdAfter.

Casi d'uso di ordini d'acquisto e conferme dell'ordine

Articolo non valido in una voce dell'ordine d'acquisto

Se ricevi un identificativo del prodotto non valido nell'ordine di acquisto, devi rifiutare l'articolo con un codice di conferma Rejected e il rejectionReason come InvalidProductIdentifier:

Ordine d'acquisto

{ "order": { "purchaseOrderNumber": " L8266355", "purchaseOrderState": "New", "orderDetails": { "purchaseOrderDate": "2019-07-16T19:17:34.304Z", "purchaseOrderStateChangedDate": "2019-07-16T19:17:34.304Z", "purchaseOrderType": "RegularOrder", "paymentMethod": "Invoice", "buyingParty": { "partyId": "NAG1" }, "sellingParty": { "partyId": "999US" }, "shipToParty": { "partyId": "NAG1" }, "billToParty": { "partyId": "NAG1" }, "items": [ { "itemSequenceNumber": "1", "amazonProductIdentifier": " ABC123434", "vendorProductIdentifier": "028877454078", "orderedQuantity": { "amount": "10", "unitOfMeasure": "Cases", "unitSize": "5" }, "isBackOrderAllowed": false, "netCost": { "amount": "10.2", "currencyCode": "USD" }, "listPrice": { "amount": "10.2", "currencyCode": "USD" } } ] } } }

Conferma dell'ordine d'acquisto

{ "acknowledgements": [ { "purchaseOrderNumber": "L8266355", "sellingParty": { "partyId": "999US" }, "acknowledgementDate": "2019-07-17T19:17:34.304Z", "items": [ { "itemSequenceNumber": "1", "amazonProductIdentifier": " ABC123434", "vendorProductIdentifier": "028877454078", "orderedQuantity": { "amount": 10, "unitOfMeasure": "Cases", "unitSize": 5 }, "netCost": { "currencyCode": "USD", "amount": "10.2" }, "itemAcknowledgements": [ { "acknowledgementCode": "Rejected", "acknowledgedQuantity": { "amount": 10 }, "rejectionReason": "InvalidProductIdentifier" } ] } ] } ] }

Stato dell'ordine di acquisto

{ "payload": { "ordersStatus": [ { "purchaseOrderNumber": "L8266355", "purchaseOrderStatus": "CLOSED", "purchaseOrderDate": "2019-07-16T19:17:34.304Z", "lastUpdatedDate": "2019-07-17T19:17:34.304Z", "sellingParty": { "partyId": "999US" }, "shipToParty": { "partyId": "NAG1" }, "itemStatus": [ { "itemSequenceNumber": "1", "buyerProductIdentifier": "ABC123434", "vendorProductIdentifier": "028877454078", "netCost": { "amount": "10.2", "currencyCode": "USD" }, "listPrice": { "amount": "10.2", "currencyCode": "USD" }, "orderedQuantity": { "orderedQuantity": { "amount": 10, "unitOfMeasure": "Cases", "unitSize": 5 }, "orderedQuantityDetails": [ { "updatedDate": "2019-07-16T19:17:34.304Z", "orderedQuantity": { "amount": 10, "unitOfMeasure": "Cases", "unitSize": 5 } } ] }, "acknowledgementStatus": { "confirmationStatus": "REJECTED", "acceptedQuantity": { "amount": 0, "unitOfMeasure": "Cases", "unitSize": 5 }, "rejectedQuantity": { "amount": 10, "unitOfMeasure": "Cases", "unitSize": 5 }, "acknowledgementStatusDetails": [ { "acknowledgementDate": "2019-07-17T19:17:34.304Z", "acceptedQuantity": { "amount": 0, "unitOfMeasure": "Cases", "unitSize": 5 }, "rejectedQuantity": { "amount": 10, "unitOfMeasure": "Cases", "unitSize": 5 } } ] } } ] } ] } }

Articolo obsoleto in una voce dell'ordine d'acquisto

Se ricevi un prodotto obsoleto nell'ordine di acquisto, devi rifiutare l'articolo con un codice di conferma Rejected e il rejectionReason come ObsoleteProduct.

Ordine d'acquisto

{ "order": { "purchaseOrderNumber": " L8266355", "purchaseOrderState": "New", "orderDetails": { "purchaseOrderDate": "2019-07-16T19:17:34.304Z", "purchaseOrderStateChangedDate": "2019-07-16T19:17:34.304Z", "purchaseOrderType": "RegularOrder", "paymentMethod": "Invoice", "buyingParty": { "partyId": "NAG1" }, "sellingParty": { "partyId": "999US" }, "shipToParty": { "partyId": "NAG1" }, "billToParty": { "partyId": "NAG1" }, "items": [ { "itemSequenceNumber": "1", "amazonProductIdentifier": " ABC123434", "vendorProductIdentifier": "028877454078", "orderedQuantity": { "amount": "10", "unitOfMeasure": "Cases", "unitSize": "5" }, "isBackOrderAllowed": false, "netCost": { "amount": "10.2", "currencyCode": "USD" } } ] } } }

Conferma dell'ordine d'acquisto

{ "acknowledgements": [ { "purchaseOrderNumber": "L8266356", "sellingParty": { "partyId": "999US" }, "acknowledgementDate": "2019-07-17T19:17:34.304Z", "items": [ { "itemSequenceNumber": "1", "amazonProductIdentifier": "ABC123438", "vendorProductIdentifier": "028877454079", "orderedQuantity": { "amount": 10, "unitOfMeasure": "Cases", "unitSize": "5" }, "netCost": { "currencyCode": "IN", "amount": "100.20" }, "itemAcknowledgements": [ { "acknowledgementCode": "Rejected", "acknowledgedQuantity": { "amount": 10 }, "rejectionReason": " ObsoleteProduct" } ] } ] } ] }

Conferma parziale della quantità di articoli e arretrato per la quantità restante

Amazon ha ordinato 10 quantità di articoli. Il fornitore prevede di suddividere le spedizioni e quindi invia un Accepted quantità dell'articolo pari a sei e un BackOrdered numero di articoli pari a quattro, indicando che nella prima spedizione verranno spedite sei unità e nella seconda quattro unità.

Ordine d'acquisto (importazione ordine d'acquisto)

{ "order": { "purchaseOrderNumber": " L8266357", "purchaseOrderState": "Acknowledged", "orderDetails": { "purchaseOrderDate": "2019-07-16T19:17:34.304Z", "purchaseOrderChangedDate": "2019-07-18T16:05:00Z", "purchaseOrderStateChangedDate": "2019-07-17T10:00:34.304Z", "purchaseOrderType": "RegularOrder", "importDetails": { "importContainers": "2-20'HC,1-45',1-45'HC", "internationalCommercialTerms": "FreeOnBoard", "methodOfPayment": "PrepaidBySeller", "portOfDelivery": "USA", "shippingInstructions": "PREFERENCE IS PALLET-LOAD, BUT IF CONTAINERS ARE FLOOR-LOADED" }, "paymentMethod": "Invoice", "buyingParty": { "partyId": "XYZ1" }, "sellingParty": { "partyId": "999US" }, "shipToParty": { "partyId": "XYZ1" }, "billToParty": { "partyId": "XYZ1", "taxInfo": { "taxRegistrationNumber": "12AAXYZ4259Z123", "taxRegistrationType": "VAT" } }, "items": [ { "itemSequenceNumber": "1", "amazonProductIdentifier": " ABC123434", "vendorProductIdentifier": "028877454078", "orderedQuantity": { "amount": "10", "unitOfMeasure": "Eaches" }, "isBackOrderAllowed": true, "netCost": { "amount": "10.2", "currencyCode": "USD" }, "listPrice": { "amount": "10.2", "currencyCode": "USD" } } ] } } }

Conferma dell'ordine d'acquisto

{ "acknowledgements": [ { "purchaseOrderNumber": "L8266355", "sellingParty": { "partyId": "999US" }, "acknowledgementDate": "2019-07-17T19:17:34.304Z", "items": [ { "itemSequenceNumber": "1", "amazonProductIdentifier": " ABC123434", "vendorProductIdentifier": "028877454078", "orderedQuantity": { "amount": 10, "unitOfMeasure": "Eaches" }, "netCost": { "currencyCode": "USD", "amount": "10.2" }, "itemAcknowledgements": [ { "acknowledgementCode": "Accepted", "acknowledgedQuantity": { "amount": 6 }, "scheduledShipDate": "2019-07-17T19:17:34.304Z" }, { "acknowledgementCode": "Backordered", "acknowledgedQuantity": { "amount": 4 }, "scheduledShipDate": "2019-07-25T19:17:34.304Z" } ] } ] } ] }

Dopo aver spedito la prima parte dell'ordine, il fornitore deve indicare ad Amazon una data più accurata per la seconda spedizione utilizzando scheduledShipDate per gli articoli in arretrato. Ricorda che i fornitori devono sempre inviare aggiornamenti completi con la quantità totale ordinata per gli articoli delle singole voci. Tali aggiornamenti offrono visibilità esplicita sulle quantità.

Stato dell'ordine di acquisto

{ "payload": { "ordersStatus": [ { "purchaseOrderNumber": "L8266355", "purchaseOrderStatus": "OPEN", "purchaseOrderDate": "2019-07-16T19:17:34.304Z", "lastUpdatedDate": "2019-07-18T16:05:00Z", "sellingParty": { "partyId": "999US" }, "shipToParty": { "partyId": "XYZ1" }, "itemStatus": [ { "itemSequenceNumber": "1", "buyerProductIdentifier": "ABC123434", "vendorProductIdentifier": "028877454078", "netCost": { "amount": "10.2", "currencyCode": "USD" }, "listPrice": { "amount": "10.2", "currencyCode": "USD" }, "orderedQuantity": { "orderedQuantity": { "amount": 10, "unitOfMeasure": "Eaches", "unitSize": 1 }, "orderedQuantityDetails": [ { "updatedDate": "2019-07-16T19:17:34.304Z", "orderedQuantity": { "amount": 10, "unitOfMeasure": "Eaches", "unitSize": 1 } } ] }, "acknowledgementStatus": { "confirmationStatus": "ACCEPTED", "acceptedQuantity": { "amount": 10, "unitOfMeasure": "Eaches", "unitSize": 1 }, "acknowledgementStatusDetails": [ { "acknowledgementDate": "2019-07-17T19:17:34.304Z", "acceptedQuantity": { "amount": 10, "unitOfMeasure": "Eaches", "unitSize": 1 }, "rejectedQuantity": { "amount": 0, "unitOfMeasure": "Eaches", "unitSize": 1 } } ] } } ] } ] } }

Conferme multiple per annullare le quantità accettate inizialmente

Puoi utilizzarlo quando scopri di non poter evadere alcune o tutte le unità di un ordine inizialmente accettato e desideri informare Amazon che tali unità non verranno spedite.

Ordine d'acquisto

{ "order": { "purchaseOrderNumber": " L8266355", "purchaseOrderState": "New", "orderDetails": { "purchaseOrderDate": "2019-07-16T19:17:34.304Z", "purchaseOrderStateChangedDate": "2019-07-16T19:17:34.304Z", "purchaseOrderType": "RegularOrder", "paymentMethod": "Invoice", "buyingParty": { "partyId": "NAG1" }, "sellingParty": { "partyId": "999US" }, "shipToParty": { "partyId": "NAG1" }, "billToParty": { "partyId": "NAG1" }, "items": [ { "itemSequenceNumber": "1", "amazonProductIdentifier": "ABC123434", "vendorProductIdentifier": "028877454078", "orderedQuantity": { "amount": "10", "unitOfMeasure": "Cases", "unitSize": "5" }, "isBackOrderAllowed": false, "netCost": { "amount": "10.2", "currencyCode": "USD" }, "listPrice": { "amount": "10.2", "currencyCode": "USD" } } ] } } }

Conferma dell'ordine d'acquisto

Il venditore ha inizialmente accettato la quantità.

{ "acknowledgements": [ { "purchaseOrderNumber": "L8266355", "sellingParty": { "partyId": "999US" }, "acknowledgementDate": "2019-07-17T19:17:34.304Z", "items": [ { "itemSequenceNumber": "1", "amazonProductIdentifier": "ABC123434", "vendorProductIdentifier": "028877454078", "orderedQuantity": { "amount": 10, "unitOfMeasure": "Cases", "unitSize": "5" }, "netCost": { "currencyCode": "USD", "amount": "10.2" }, "itemAcknowledgements": [ { "acknowledgementCode": "Accepted", "acknowledgedQuantity": { "amount": 10, "unitOfMeasure": "Cases", "unitSize": "5" }, "scheduledShipDate": "2019-07-17T19:17:34.304Z" } ] } ] } ] }

In seguito, il fornitore non riesce a gestire la quantità accettata e invia un annullamento completo o parziale tramite un altra richiesta di conferma dell'ordine d'acquisto.

Annullamento completo

{ "acknowledgements": [ { "purchaseOrderNumber": "L8266355", "sellingParty": { "partyId": "999US" }, "acknowledgementDate": "2019-07-17T19:17:34.304Z", "items": [ { "itemSequenceNumber": "1", "amazonProductIdentifier": "ABC123434", "vendorProductIdentifier": "028877454078", "orderedQuantity": { "amount": 10, "unitOfMeasure": "Cases", "unitSize": "5" }, "netCost": { "currencyCode": "USD", "amount": "10.2" }, "itemAcknowledgements": [ { "acknowledgementCode": "Rejected", "acknowledgedQuantity": { "amount": 10, "unitOfMeasure": "Cases", "unitSize": "5" }, "rejectionReason": "TemporarilyUnavailable" } ] } ] } ] }

Annullamento parziale

{ "acknowledgements": [ { "purchaseOrderNumber": "L8266355", "sellingParty": { "partyId": "999US" }, "acknowledgementDate": "2019-07-17T20:10:34.304Z", "items": [ { "itemSequenceNumber": "1", "amazonProductIdentifier": "ABC123434", "vendorProductIdentifier": "028877454078", "orderedQuantity": { "amount": 10, "unitOfMeasure": "Cases", "unitSize": "5" }, "netCost": { "currencyCode": "USD", "amount": "10.2" }, "itemAcknowledgements": [ { "acknowledgementCode": "Accepted", "acknowledgedQuantity": { "amount": 3, "unitOfMeasure": "Cases", "unitSize": "5" }, "scheduledShipDate": "2019-07-17T19:17:34.304Z" }, { "acknowledgementCode": "Rejected", "acknowledgedQuantity": { "amount": 7, "unitOfMeasure": "Cases", "unitSize": "5" }, "rejectionReason": "TemporarilyUnavailable" } ] } ] } ] }

Stato dell'ordine d'acquisto dopo l'annullamento parziale

{ "payload": { "ordersStatus": [ { "purchaseOrderNumber": "L8266355", "purchaseOrderStatus": "OPEN", "purchaseOrderDate": "2019-07-16T19:17:34.304Z", "lastUpdatedDate": "2019-07-17T19:17:34.304Z", "sellingParty": { "partyId": "999US" }, "shipToParty": { "partyId": "NAG1" }, "itemStatus": [ { "itemSequenceNumber": "1", "buyerProductIdentifier": "ABC123434", "vendorProductIdentifier": "028877454078", "netCost": { "amount": "10.2", "currencyCode": "USD" }, "listPrice": { "amount": "10.2", "currencyCode": "USD" }, "orderedQuantity": { "orderedQuantity": { "amount": 10, "unitOfMeasure": "Cases", "unitSize": 5 }, "orderedQuantityDetails": [ { "updatedDate": "2019-07-16T19:17:34.304Z", "orderedQuantity": { "amount": 10, "unitOfMeasure": "Cases", "unitSize": 5 } } ] }, "acknowledgementStatus": { "confirmationStatus": "PARTIALLY_ACCEPTED", "acceptedQuantity": { "amount": 3, "unitOfMeasure": "Cases", "unitSize": 5 }, "rejectedQuantity": { "amount": 7, "unitOfMeasure": "Cases", "unitSize": 5 }, "acknowledgementStatusDetails": [ { "acknowledgementDate": "2019-07-17T19:17:34.304Z", "acceptedQuantity": { "amount": 10, "unitOfMeasure": "Cases", "unitSize": 5 }, "rejectedQuantity": { "amount": 0, "unitOfMeasure": "Cases", "unitSize": 5 } }, { "acknowledgementDate": "2019-07-17T20:10:34.304Z", "acceptedQuantity": { "amount": 3, "unitOfMeasure": "Cases", "unitSize": 5 }, "rejectedQuantity": { "amount": 7, "unitOfMeasure": "Cases", "unitSize": 5 } } ] } } ] } ] } }

Cos'è l'API Spedizioni dei fornitori?

You can use the Vendor Shipments API (Shipments API) to exchange shipment related documents with Amazon.

Nell'API Spedizioni sono incluse le seguenti operazioni:

Operazione Metodo HTTP Path Descrizione
SubmitShipmentConfirmations POST /vendor/shipping/v1/shipmentConfirmations Invia una o più conferme di spedizione ad Amazon.
GetShipmentDetails GET /vendor/shipping/v1/shipments Ottieni i dettagli della spedizione per la richiesta di trasporto inviata ad Amazon. Il recupero dei dati è possibile per un periodo massimo di sei mesi dalla data di creazione della richiesta di spedizione.
SubmitShipments POST /vendor/shipping/v1/shipments Invia una o più richieste di trasporto ad Amazon.

SubmitShipmentConfirmations

You can use the SubmitShipmentConfirmations operation to submit shipment confirmations to Amazon. With your shipment confirmation we can efficiently receive and process your shipments. It contains information about the items being shipped, including purchase order number, ship date, estimated delivery date, lot number, expiration date, and the Serial Shipping Container Code (SSCC).

Ricevendo una conferma di spedizione valida e tempestiva, possiamo anticipare correttamente le spedizioni che ci invii. Alcuni vantaggi dell'invio delle conferme di spedizione includono:

  • Amazon può collaborare in modo più efficace con i corrieri per tracciare e ricevere le tue spedizioni. Questo ci consente di pianificare in modo efficace le nostre risorse di manodopera e aiuta a garantire una ricezione più rapida ed efficiente della spedizione, il che significa che puoi fatturare i tuoi ordini d'acquisto più velocemente.

  • Amazon può tenere traccia dell'inventario in entrata e creare ordini automatici per garantire che gli articoli non siano esauriti.

  • Maggiore visibilità sui prodotti in transito, che ci consente di riflettere con maggiore precisione la disponibilità degli articoli (consegna per periodo) ai clienti finali.

  • Con le politiche di annullamento degli ordini di acquisto di Amazon, le spedizioni PO in sospeso possono essere annullate. Tuttavia, gli ordini di acquisto con una conferma accurata della spedizione avvisano i nostri sistemi interni dello stato di transito. Questo può aiutare a evitare inutili annullamenti degli ordini di acquisto, storni di addebito e rifiuti di trasporto.

La mancanza di una conferma di spedizione valida può comportare:

  • Visibilità insufficiente sulle spedizioni in arrivo.
  • Errori nella riconciliazione delle spedizioni fisiche con gli ordini d'acquisto.
  • Follow-up manuali per risolvere le discrepanze.
  • La necessità di fornire una prova di consegna (POD) per la fatturazione.

Conferma di spedizione: sostituzione

Quando una conferma di spedizione presenta un shipmentConfirmationType di Replace, puoi correggere le conferme di spedizione inviate in precedenza inviando una versione aggiornata. La seconda chiamata di conferma della spedizione sovrascriverà completamente i dati della prima conferma della spedizione.

Il vantaggio principale è migliorare l'accuratezza della prenotazione tramite l'aggiornamento di conferme di spedizione errate dopo l'invio iniziale.

Come funziona?

Per sostituire una conferma di spedizione inviata in precedenza, è possibile inviare una seconda conferma di spedizione. La shipmentIdentifier e sellingParty.partyId devono essere identiche per entrambe le trasmissioni, in modo da poter sovrascrivere correttamente la versione precedente della conferma di spedizione.

Ambito della conferma della spedizione - Sostituisci

  • Tutti i valori di conferma della spedizione possono essere modificati ad eccezione di shipmentIdentifier e sellingParty.partyId, che devono rimanere identiche per una corretta conferma della spedizione - Sostituisci.

  • Pallet, pacchi e quantità spedita non possono essere aumentati, ma solo diminuiti. Per aumentare i volumi, devi inviare una seconda conferma di spedizione con un nuovo shipmentIdentifier. Puoi utilizzare come riferimento lo stesso numero di documento di trasporto se le unità aggiuntive verranno consegnate con la stessa spedizione.

  • A shipment confirmation submitted using the API can only be edited by submitting another shipment confirmation using the API. A shipment confirmation created in Vendor Central cannot be edited using the API.

  • La sostituzione di una conferma di spedizione è possibile solo entro 7 giorni dopo la conferma iniziale e in seguito solo se la spedizione non è ancora arrivata al centro logistico Amazon.

Verifica delle conferme di spedizione inviate correttamente

You can verify the status of your original or replaced shipment confirmations via Vendor Central > Orders > Shipments or by using the Transaction Status API. It can take the system up to 30 min to show the original/replaced version after submission. If Vendor Central is not showing the correct values for the replaced shipment confirmation, open a Contact Us case in Vendor Central.

Il seguente diagramma illustra il flusso di lavoro di integrazione per l'invio di conferme di spedizione.

The Vendor shipments workflow when submitting shipment confirmations.

Requisiti aziendali

  • Quando un venditore spedisce articoli venduti a peso, deve fornire il totalWeight campo. Il totalWeight il campo contiene il peso degli articoli spediti dal fornitore e l'unità di misura del peso. I valori dell'unità di misura del peso includono POUNDS, OUNCES, GRAMS, e KILOGRAMS.

  • Esiste un limite di 100 conferme di spedizione per ogni spedizione con carico. Ciò significa che puoi inviare una conferma di spedizione separata a livello di ordine d'acquisto o di pacco solo se il totale di conferme di spedizione singole è inferiore o uguale a 100 per tale spedizione a carico completo/parziale. Consigliamo di inviare un'unica conferma di spedizione per l'intera spedizione a carico completo o parziale, includendo tutti i dettagli relativi a ordini d'acquisto e pacchi.

  • Amazon deve ricevere la conferma di spedizione prima di ricevere il prodotto al centro logistico Amazon. La mancanza o il ritardo della conferma di spedizione comporterà la contestazione della transazione.

  • Per le spedizioni di piccoli colli, è necessaria una conferma di spedizione per ogni pacco/scatola.

  • I seguenti requisiti sono richiesti da Amazon e vengono misurati per effettuare il monitoraggio della conformità:

    • Per le spedizioni pallettizzate, devi inviare una conferma di spedizione prima di richiedere uno slot di consegna presso il centro logistico Amazon, poiché gli appuntamenti vengono forniti solo se nei sistemi Amazon viene trovata una conferma di spedizione valida. Per le eccezioni, consulta la conferma della spedizione locale Aiuto pagine per comprendere le opzioni disponibili. Per i pacchi, la conferma di spedizione deve essere inviata prima della spedizione degli articoli. La mancata o ritardata conferma della spedizione comporterà storni di addebito.
    • Una conferma di spedizione deve riguardare una consegna, da un fornitore e per un solo camion. Le spedizioni in più camion, verso più centri logistici Amazon, da più account fornitore o con arrivi in più giorni richiedono più conferme di spedizione.
    • Se più spedizioni più piccole per lo stesso account fornitore vengono combinate in una spedizione più grande e sono necessarie più conferme di spedizione, puoi utilizzare l'opzione BOL ombrello come mostrato nell'esempio seguente:

Conferma della spedizione 1

"billOfLadingNumber": "BOL1" "shipmentIdentifier": "SHIPMENT CONFIRMATION_ID1"

Conferma della spedizione 2

"billOfLadingNumber": "BOL1" "shipmentIdentifier": "SHIPMENT CONFIRMATION_ID2"

Requisiti aziendali specifici per paese

Funzionalità Definizione aziendale India Europa Nord America
Numero del documento di trasporto/preventivo di consegna

BOL number is the unique number assigned by the vendor. The BOL present in the shipment confirmation ideally matches the paper BOL provided with the shipment, but that is not required. Refer to Additional field explanations for more information. The BOL reference is used for appointment booking and shipment label creation.

Il numero del preventivo di consegna è un'alternativa al BOL come numero di riferimento per una spedizione.

Condizionale

Obbligatorio per tutte le conferme di spedizione. Obbligatorio per le spedizioni FTL o LTL.
Numero di riferimento della spedizione del corriere (PRO) Il numero di spedizione (numero PRO) è un numero univoco assegnato dal corriere. Viene utilizzato per identificare ed effettuare il monitoraggio della spedizione che parte per la consegna. Obbligatorio per tutte le conferme di spedizione. Opzionale Obbligatorio per tutte le conferme di spedizione.
Data di spedizione Data in cui la spedizione lascia il magazzino del fornitore.

Obbligatorio per tutte le conferme di spedizione.

Obbligatorio per tutte le conferme di spedizione. Obbligatorio per tutte le conferme di spedizione.
Data di consegna prevista

Data in cui è previsto l'arrivo della spedizione al centro logistico Amazon. La stima deve essere basata sul tempo di transito medio dall'origine della spedizione alla destinazione. La data e l'ora esatte dell'appuntamento saranno fornite da Amazon e potenzialmente non sono note al momento della creazione della spedizione.

Obbligatorio per tutte le conferme di spedizione.

Obbligatorio per tutte le conferme di spedizione. Obbligatorio per tutte le conferme di spedizione.
Numero di pacchi Il numero di pacchi presenti nella spedizione. Le unità impilate sul pallet senza imballaggio esterno vengono conteggiate come 1 unità = 1 pacco. Il numero dei pacchi è richiesto a livello di spedizione. Obbligatorio per tutte le conferme di spedizione. Obbligatorio per tutte le conferme di spedizione. Obbligatorio per tutte le conferme di spedizione.
Numero di pallet Il numero di pallet presenti nella spedizione. Per le spedizioni di soli pacchi deve essere indicato il valore 0. Tutti i volumi che raggiungono il centro logistico su un pallet devono avere un valore minimo di 1 indicato in questo segmento. L'informazione è richiesta a livello di spedizione. Obbligatorio per tutte le conferme di spedizione per le consegne pallettizzate. Obbligatorio per tutte le conferme di spedizione. Obbligatorio per le spedizioni FTL e LTL.
Standard Carrier Alpha Code (SCAC) Il codice che identifica il corriere per la spedizione. Lo Standard Carrier Alpha Code (SCAC) è un codice univoco tra due e quattro lettere utilizzato per identificare un corriere. I codici SCAC vengono assegnati e mantenuti dalla NMFTA (National Motor Freight Association). Opzionale Opzionale Obbligatorio per tutte le conferme di spedizione.
Luogo di spedizione (destinazione) ID parte/codice del magazzino del luogo in cui saranno spediti i prodotti. Il nome del campo dello schema API è "shipToParty". Obbligatorio per tutte le conferme di spedizione. Obbligatorio per tutte le conferme di spedizione. Obbligatorio per tutte le conferme di spedizione.
Identificazione del fornitore L'identificazione del fornitore che spedisce la merce ad Amazon. Il nome del campo dello schema API è "sellingParty". Obbligatorio per tutte le conferme di spedizione. Obbligatorio per tutte le conferme di spedizione. Opzionale
Origine spedizione Indirizzo (codice postale) e paese del luogo da cui vengono fisicamente spediti i prodotti. Obbligatorio per tutte le conferme di spedizione. Obbligatorio per tutte le conferme di spedizione. Obbligatorio per tutte le conferme di spedizione.
Numero di riferimento Amazon (solo per le spedizioni WePay) Numero di riferimento Amazon ricevuto nelle istruzioni di routing (GetShipmentDetails risposta) per una spedizione WePay. Obbligatorio solo per le conferme di spedizione

(per le spedizioni WePay).

Obbligatorio solo per le conferme di spedizione

(per le spedizioni WePay).

Obbligatorio per le spedizioni con ritiro.
Numero dell'ordine d'acquisto Il numero dell'ordine d'acquisto Amazon. Autorizzazione scritta che consente a un fornitore di spedire i prodotti a un prezzo specificato e che diventa un contratto legalmente vincolante una volta accettato dal fornitore. Obbligatorio a livello di intestazione o voce. Obbligatorio a livello di intestazione o voce. Obbligatorio a livello di intestazione o voce.
Serial Shipping Container Code (SSCC) Il codice univoco di 18 cifre Serial Shipment Container Code (SSCC) da includere per identificare un pallet/pacco. Consigliato per tutte le conferme di spedizione nell'unità di imballaggio. Obbligatorio per tutte le conferme di spedizione nell'unità di imballaggio. Obbligatorio per tutte le conferme di spedizione nell'unità di imballaggio.
Identificazione dell'articolo SKU del fornitore del prodotto. Obbligatorio per tutte le conferme di spedizione. Obbligatorio per tutte le conferme di spedizione. Obbligatorio per tutte le conferme di spedizione.
Numero del lotto Il numero di lotto associa un articolo alle informazioni che il produttore considera importanti per la tracciabilità dell'unità commerciale a cui è applicato l'elemento stringa. I dati possono fare riferimento all'unità commerciale in sé o agli articoli che contiene. Obbligatorio per gli articoli deperibili. Obbligatorio per gli articoli deperibili. Obbligatorio per gli articoli deperibili.
Data di scadenza La data che determina il limite di consumo o di uso di un prodotto. Il significato è determinato sulla base del contesto dell'unità commerciale. Obbligatorio per gli articoli deperibili. Obbligatorio per gli articoli deperibili. Richiesti o la data di scadenza, la data di produzione o la durata di conservazione.
Data di produzione Data di produzione, imballaggio o assemblaggio determinata dal produttore. Il significato è determinato sulla base del contesto dell'unità commerciale. Opzionale Opzionale Richiesti o la data di scadenza, la data di produzione o la durata di conservazione.
Quantità Il numero di unità spedite per un articolo specifico. Obbligatorio per tutte le conferme di spedizione. Obbligatorio per tutte le conferme di spedizione. Obbligatorio per tutte le conferme di spedizione.

Spiegazioni di campi aggiuntivi

Numero della polizza di carico

Il numero della polizza di carico (BOL#) è il numero di riferimento necessario per prenotare un appuntamento su Amazon. Questo riferimento deve essere fornito quando Amazon richiede una conferma di spedizione valida. È il numero di riferimento predefinito per il documento che accompagna la spedizione fisica. Il numero BOL# nella conferma della spedizione deve corrispondere al numero BOL# fornito nella documentazione di spedizione.

Quando definisci il BOL#, assicurati che sia univoco per ogni spedizione. Il numero BOL# può essere il riferimento BOL fisico, ma se opti per un numero diverso:

  • Usa un minimo di otto cifre.
  • Utilizzo del codice fornitore Amazon come prefisso (per esempio, ABCD193939393).
  • Non utilizzare una data o un'ora.
Identificazione della spedizione

Questo campo è un ID univoco (l'unicità è definita nel contesto del fornitore) che rappresenta questa conferma di spedizione. Mancata fornitura di un Shipment Identification comporterà il rifiuto della conferma di spedizione. Assicurati che l'ID inviato non sia stato utilizzato negli ultimi 365 giorni.

Data di spedizione

Questo campo indica la data di partenza della spedizione dalla sede del fornitore. I fornitori sono pregati di inviare le conferme di spedizione prima che il trasporto arrivi ad Amazon FC.

Data di consegna prevista

Si tratta di una stima approssimativa, basata sull'esperienza, di quando è prevista la consegna della spedizione al centro logistico Amazon. I fornitori sono tenuti a determinarla sulla base dei tempi di trasporto medi del corriere. Questa informazione ci consente di pianificare l'arrivo della spedizione se non riceviamo una data di consegna prevista dal corriere.

Questa data deve essere indicata per ogni spedizione, anche se in questa fase la data dell'appuntamento è potenzialmente sconosciuta.

Serial Shipment Container Code (SSCC)

Amazon elabora le ricevute utilizzando un approccio altamente automatizzato chiamato License Plate o LP Receive e questo processo richiede che tu fornisca i dettagli del contenuto del cartone nei messaggi di conferma della spedizione. Questo processo di ricezione richiesto esegue la scansione di un codice a barre SSCC (Serial Shipment Container Code) all'esterno di una scatola o di un pallet contenente gli articoli ricevuti, eliminando la necessità di scansionare ogni articolo all'interno del cartone o del pallet. Questo processo presenta una serie di vantaggi significativi, tra cui una maggiore efficienza, una migliore precisione di ricezione, pagamenti più accurati e tempi di ciclo di pagamento più rapidi.

Puoi scegliere una soluzione tecnica, poiché Amazon ha deciso di non seguire rigorosamente la soluzione GS1-128. Per essere conforme ai requisiti della targa di Amazon, un SSCC deve essere un codice univoco di 18 cifre che definisce un pallet o un cartone, non può essere ripetuto entro 365 giorni e deve includere un codice a barre sia sull'etichetta del cartone che nel messaggio di conferma della spedizione. Inoltre, il codice a barre sull'etichetta fisica deve corrispondere al 100% al codice SSCC nella conferma della spedizione. Ai fornitori che desiderano implementare GS1-128 viene chiesto di aggiungere un 00 all'inizio del loro SSCC nella conferma di spedizione.

For more information about generating an SSCC and the requirements for the physical shipment, refer to Vendor Central. To locate the Vendor Manual with labelling requirements, select Shipping, then License Plate label and receiving requirements.

Data di scadenza

La data di scadenza è la data che determina il limite di consumo o di utilizzo di un prodotto. Viene stabilita in base al contesto dell'unità commerciale: per esempio, nel caso di un cibo indica la possibilità di un rischio sanitario diretto dovuto all'uso del prodotto dopo la data indicata, mentre per un prodotto farmaceutico segnala la possibilità di un rischio sanitario indiretto come conseguenza dell'inefficacia del prodotto dopo la data indicata. Viene spesso chiamata "data di massima durata".

Data di produzione

Si tratta della data in cui la merce è stata confezionata o prodotta. Questo campo deve essere indicato se un articolo è deperibile o ha una durata di conservazione limitata.

Numero del lotto

Il numero di lotto associa un articolo a informazioni che il produttore ritiene rilevanti per la tracciabilità dell'articolo stesso o degli ingredienti contenuti nell'articolo. Il numero può indicare un lotto di produzione, un turno di lavoro, una macchina, un orario o un codice di produzione interno.

Uso di data di scadenza/data di produzione/numeri di lotto nella conferma di spedizione

Questi campi sono obbligatori solo per gli articoli deperibili, ovvero per quegli articoli in cui is expiration dated product l'attributo è Yes nel modulo di configurazione dei nuovi articoli (NIS).

Quando si definiscono le date di scadenza, le date di produzione o i numeri di lotto nella conferma della spedizione:

  • Date di scadenza/date di produzione/numeri di lotto devono essere inviati a livello di articolo.

  • Un pacco/pallet può contenere più articoli (ASIN), ognuno con date di scadenza/date di produzione/numeri di lotto diversi.

  • Un articolo (ASIN) non deve avere più date di scadenza/date di produzione/numeri di lotto all'interno dello stesso pacco/pallet.

I fornitori sono tenuti a fornire la data di scadenza e la data di produzione in formato AAAAMMGG nella conferma di spedizione.

Casi d'uso delle conferme di spedizione

Valigetta standard per piccoli pacchi con scadenza e numeri di lotto

{ "shipmentConfirmations": [ { "shipmentIdentifier": "00050003", "shipmentConfirmationType": "Original", "shipmentType": "TruckLoad", "shipmentStructure": "LooseStandardCase", "transportationDetails": { "carrierScac": "UPSN", "billOfLadingNumber": "02440000" }, "amazonReferenceNumber": "ARN_Number", "shipmentConfirmationDate": "2019-07-29T21:56:18.575Z", "shippedDate": "2019-07-29T21:56:18.575Z", "estimatedDeliveryDate": "2019-07-29T21:56:18.575Z", "sellingParty": { "partyId": "VENDORCODE" }, "shipFromParty": { "address": { "name": "ABC electronics warehouse", "addressLine1": "DEF 1st street", "city": "Lisses", "stateOrRegion": "abcland", "postalCode": "91090", "countryCode": "DE" }, "partyId": "ABCED" }, "shipToParty": { "partyId": "AMZWAREHOUSECODE" }, "shipmentMeasurements": { "grossShipmentWeight": { "unitOfMeasure": "Kg", "value": "120.45" }, "shipmentVolume": { "unitOfMeasure": "CuFt", "value": "2.4" }, "cartonCount": 2 }, "shippedItems": [ { "itemSequenceNumber": "001", "amazonProductIdentifier": "AB1234233", "vendorProductIdentifier": "VN24343334", "shippedQuantity": { "amount": 50, "unitOfMeasure": "Eaches", "unitSize": 1 }, "itemDetails": { "purchaseOrderNumber": "PO1234BD", "lotNumber": " 12345", "expiry": { "expiryDate": "2019-11-29T21:56:18.575Z" } } } ], "cartons": [ { "cartonIdentifiers": [ { "containerIdentificationType": "SSCC", "containerIdentificationNumber": "00102234567666698888" } ], "cartonSequenceNumber": " 001", "trackingNumber": "UPS TRACKING NUMBER", "items": [ { "itemReference": "001", "shippedQuantity": { "amount": 25, "unitOfMeasure": "Eaches", "unitSize": 1 } } ] }, { "cartonIdentifiers": [ { "containerIdentificationType": "SSCC", "containerIdentificationNumber": "00102234567666698889" } ], "cartonSequenceNumber": " 002", "trackingNumber": "UPS TRACKING NUMBER", "items": [ { "itemReference": "001", "shippedQuantity": { "amount": 25, "unitOfMeasure": "Eaches", "unitSize": 1 } } ] } ] } ] }

Piccolo LooseAssortmentCase pacco con scadenza e numeri di lotto

{ "shipmentConfirmations": [ { "shipmentIdentifier": "00050003", "shipmentConfirmationType": "Original", "shipmentType": "TruckLoad", "shipmentStructure": "LooseAssortmentCase", "transportationDetails": { "carrierScac": "UPSN", "billOfLadingNumber": "02440000" }, "amazonReferenceNumber": "ARN_Number", "shipmentConfirmationDate": "2019-07-29T21:56:18.575Z", "shippedDate": "2019-07-29T21:56:18.575Z", "estimatedDeliveryDate": "2019-07-29T21:56:18.575Z", "sellingParty": { "partyId": "VENDORCODE" }, "shipFromParty": { "address": { "name": "ABC electronics warehouse", "addressLine1": "DEF 1st street", "city": "Lisses", "stateOrRegion": "abcland", "postalCode": "91090", "countryCode": "DE" }, "partyId": "ABCED" }, "shipToParty": { "partyId": "AMZWAREHOUSECODE" }, "shipmentMeasurements": { "grossShipmentWeight": { "unitOfMeasure": "Kg", "value": "120.45" }, "shipmentVolume": { "unitOfMeasure": "CuFt", "value": "2.4" }, "cartonCount": 2 }, "shippedItems": [ { "itemSequenceNumber": "001", "amazonProductIdentifier": "AB1234233", "vendorProductIdentifier": "VN24343334", "shippedQuantity": { "amount": 50, "unitOfMeasure": "Eaches", "unitSize": 1 }, "itemDetails": { "purchaseOrderNumber": "PO1234BD", "lotNumber": " 12345", "expiry": { "expiryDate": "2019-11-29T21:56:18.575Z" } } }, { "itemSequenceNumber": "002", "amazonProductIdentifier": "AB1234235", "vendorProductIdentifier": "VN24343370", "shippedQuantity": { "amount": 50, "unitOfMeasure": "Eaches", "unitSize": 1 }, "itemDetails": { "purchaseOrderNumber": "PO1234BD", "lotNumber": " 12345", "expiry": { "expiryDate": "2019-11-29T21:56:18.575Z" } } } ], "cartons": [ { "cartonIdentifiers": [ { "containerIdentificationType": "SSCC", "containerIdentificationNumber": "00102234567666698888" } ], "cartonSequenceNumber": " 001", "trackingNumber": "UPS TRACKING NUMBER", "items": [ { "itemReference": "001", "shippedQuantity": { "amount": 10, "unitOfMeasure": "Cases", "unitSize": 1 } }, { "itemReference": "002", "shippedQuantity": { "amount": 10, "unitOfMeasure": "Cases", "unitSize": 1 } } ] } ] } ] }

Carico completo pallettizzato con più articoli

{ "shipmentConfirmations": [ { "shipmentIdentifier": "00050003", "shipmentConfirmationType": "Original", "shipmentType": "TruckLoad", "shipmentStructure": "PalletizedAssortmentCase", "transportationDetails": { "transportationMode": "Road", "billOfLadingNumber": "02440000" }, "shipmentConfirmationDate": "2019-08-07T19:56:45.632Z", "shippedDate": "2019-08-07T19:56:45.632Z", "estimatedDeliveryDate": "2019-08-07T19:56:45.632Z", "sellingParty": { "partyId": "VENDORCODE" }, "shipFromParty": { "address": { "name": "ABC electronics warehouse", "addressLine1": "DEF 1st street", "city": "Lisses", "stateOrRegion": "abcland", "postalCode": "91090", "countryCode": "DE" }, "partyId": "VENDORWAREHOUSECODE" }, "shipToParty": { "partyId": "AMZWAREHOUSECODE" }, "shipmentMeasurements": { "grossShipmentWeight": { "unitOfMeasure": "Kg", "value": "250" }, "shipmentVolume": { "unitOfMeasure": "CuFt", "value": "2.4" }, "palletCount": 2 }, "shippedItems": [ { "itemSequenceNumber": "001", "vendorProductIdentifier": "9782700001659", "shippedQuantity": { "amount": 100, "unitOfMeasure": "Eaches", "unitSize": 1 } }, { "itemSequenceNumber": "002", "vendorProductIdentifier": "9782700001000", "shippedQuantity": { "amount": 400, "unitOfMeasure": "Eaches", "unitSize": 1 } } ], "cartons": [ { "cartonIdentifiers": [ { "containerIdentificationType": "SSCC", "containerIdentificationNumber": "00102234567666698888" } ], "cartonSequenceNumber": "001", "items": [ { "itemReference": "001", "shippedQuantity": { "amount": 25, "unitOfMeasure": "Eaches", "unitSize": 1 }, "itemDetails": { "purchaseOrderNumber": "1BBBAAAA", "lotNumber": "1045", "maximumRetailPrice": { "currencyCode": "EUR", "amount": "89.00" }, "handlingCode": "Oversized" } }, { "itemReference": "002", "shippedQuantity": { "amount": 100, "unitOfMeasure": "Eaches", "unitSize": 1 }, "itemDetails": { "purchaseOrderNumber": "1BBBAACC", "lotNumber": "1087", "maximumRetailPrice": { "currencyCode": "EUR", "amount": "120.00" }, "handlingCode": "Oversized" } } ] }, { "cartonIdentifiers": [ { "containerIdentificationType": "SSCC", "containerIdentificationNumber": "00102234567666698999" } ], "cartonSequenceNumber": "002", "items": [ { "itemReference": "001", "shippedQuantity": { "amount": 25, "unitOfMeasure": "Eaches", "unitSize": 1 }, "itemDetails": { "purchaseOrderNumber": "1BBBAACD", "lotNumber": "1045", "maximumRetailPrice": { "currencyCode": "EUR", "amount": "89.00" }, "handlingCode": "Oversized" } }, { "itemReference": "002", "shippedQuantity": { "amount": 100, "unitOfMeasure": "Eaches", "unitSize": 1 }, "itemDetails": { "purchaseOrderNumber": "1BBBAADD", "lotNumber": "1087", "maximumRetailPrice": { "currencyCode": "EUR", "amount": "120.00" }, "handlingCode": "Oversized" } } ] }, { "cartonIdentifiers": [ { "containerIdentificationType": "SSCC", "containerIdentificationNumber": "00102234567666698669" } ], "cartonSequenceNumber": "003", "items": [ { "itemReference": "001", "shippedQuantity": { "amount": 25, "unitOfMeasure": "Eaches", "unitSize": 1 }, "itemDetails": { "purchaseOrderNumber": "1BBBAACD", "lotNumber": "1045", "maximumRetailPrice": { "currencyCode": "EUR", "amount": "89.00" }, "handlingCode": "Oversized" } }, { "itemReference": "002", "shippedQuantity": { "amount": 100, "unitOfMeasure": "Eaches", "unitSize": 1 }, "itemDetails": { "purchaseOrderNumber": "1BBBAADD", "lotNumber": "1087", "maximumRetailPrice": { "currencyCode": "EUR", "amount": "120.00" }, "handlingCode": "Oversized" } } ] }, { "cartonIdentifiers": [ { "containerIdentificationType": "SSCC", "containerIdentificationNumber": "00102234567666697799" } ], "cartonSequenceNumber": "004", "items": [ { "itemReference": "001", "shippedQuantity": { "amount": 25, "unitOfMeasure": "Eaches", "unitSize": 1 }, "itemDetails": { "purchaseOrderNumber": "1BBBAACD", "lotNumber": "1045", "maximumRetailPrice": { "currencyCode": "EUR", "amount": "89.00" }, "handlingCode": "Oversized" } }, { "itemReference": "002", "shippedQuantity": { "amount": 100, "unitOfMeasure": "Eaches", "unitSize": 1 }, "itemDetails": { "purchaseOrderNumber": "1BBBAADD", "lotNumber": "1087", "maximumRetailPrice": { "currencyCode": "EUR", "amount": "120.00" }, "handlingCode": "Oversized" } } ] } ], "pallets": [ { "palletIdentifiers": [ { "containerIdentificationType": "SSCC", "containerIdentificationNumber": "00102234567898098745" } ], "tier": 1, "block": 2, "dimensions": { "length": "1.2", "width": "0.8", "height": "1", "unitOfMeasure": "In" }, "weight": { "unitOfMeasure": "Kg", "value": "55" }, "cartonReferenceDetails": { "cartonCount": 2, "cartonReferenceNumbers": [ "001", "002" ] } }, { "palletIdentifiers": [ { "containerIdentificationType": "SSCC", "containerIdentificationNumber": "00102234567898098700" } ], "tier": 1, "block": 2, "dimensions": { "length": "1.2", "width": "0.8", "height": "1", "unitOfMeasure": "In" }, "weight": { "unitOfMeasure": "Kg", "value": "55" }, "cartonReferenceDetails": { "cartonCount": 2, "cartonReferenceNumbers": [ "003", "004" ] } } ] } ] }

Spedizione a carico parziale con pacchi standard pallettizzati

{ "shipmentConfirmations": [ { "shipmentIdentifier": "00050003", "shipmentConfirmationType": "Original", "shipmentType": "LessThanTruckLoad", "shipmentStructure": "PalletizedStandardCase", "transportationDetails": { "transportationMode": "Road", "billOfLadingNumber": "02440000" }, "shipmentConfirmationDate": "2019-08-07T19:56:45.632Z", "shippedDate": "2019-08-07T19:56:45.632Z", "estimatedDeliveryDate": "2019-08-07T19:56:45.632Z", "sellingParty": { "partyId": "VENDORCODE" }, "shipFromParty": { "address": { "name": "ABC electronics warehouse", "addressLine1": "DEF 1st street", "city": "Lisses", "stateOrRegion": "abcland", "postalCode": "91090", "countryCode": "DE" }, "partyId": "VENDORWAREHOUSECODE" }, "shipToParty": { "partyId": "AMZWAREHOUSECODE" }, "shipmentMeasurements": { "grossShipmentWeight": { "unitOfMeasure": "Kg", "value": "120.45" }, "shipmentVolume": { "unitOfMeasure": "CuFt", "value": "2.4" }, "palletCount": 1 }, "shippedItems": [ { "itemSequenceNumber": "001", "vendorProductIdentifier": "9782700001659", "shippedQuantity": { "amount": 100, "unitOfMeasure": "Eaches", "unitSize": 1 }, "itemDetails": { "purchaseOrderNumber": "1BBBAAAA", "lotNumber": "1045", "maximumRetailPrice": { "currencyCode": "EUR", "amount": "299.00" }, "handlingCode": "Oversized" } } ], "cartons": [ { "cartonIdentifiers": [ { "containerIdentificationType": "SSCC", "containerIdentificationNumber": "00102234567666698888" } ], "cartonSequenceNumber": "001", "items": [ { "itemReference": "001", "shippedQuantity": { "amount": 25, "unitOfMeasure": "Eaches", "unitSize": 1 } } ] }, { "cartonIdentifiers": [ { "containerIdentificationType": "SSCC", "containerIdentificationNumber": "00102234567666699999" } ], "cartonSequenceNumber": "002", "items": [ { "itemReference": "001", "shippedQuantity": { "amount": 25, "unitOfMeasure": "Eaches", "unitSize": 1 } } ] }, { "cartonIdentifiers": [ { "containerIdentificationType": "SSCC", "containerIdentificationNumber": "00102234567666696666" } ], "cartonSequenceNumber": "003", "items": [ { "itemReference": "001", "shippedQuantity": { "amount": 25, "unitOfMeasure": "Eaches", "unitSize": 1 } } ] }, { "cartonIdentifiers": [ { "containerIdentificationType": "SSCC", "containerIdentificationNumber": "00102234567666697777" } ], "cartonSequenceNumber": "004", "items": [ { "itemReference": "001", "shippedQuantity": { "amount": 25, "unitOfMeasure": "Eaches", "unitSize": 1 } } ] } ], "pallets": [ { "palletIdentifiers": [ { "containerIdentificationType": "SSCC", "containerIdentificationNumber": "00102234567898098745" } ], "tier": 2, "block": 2, "dimensions": { "length": "1.2", "width": "0.8", "height": "1", "unitOfMeasure": "In" }, "weight": { "unitOfMeasure": "Kg", "value": "120.45" }, "cartonReferenceDetails": { "cartonCount": 4, "cartonReferenceNumbers": [ "001", "002", "003", "004" ] } } ] } ] }

Spedizione a carico inferiore a quella del carico su camion di pallet ASIN singoli

{ "shipmentConfirmations": [ { "shipmentIdentifier": "5013088794", "shipmentConfirmationType": "Original", "shipmentType": "LessThanTruckLoad", "shipmentStructure": "PalletOfItems", "transportationDetails": { "carrierShipmentReferenceNumber": "1021396377", "billOfLadingNumber": "501308879400010001", "transportationMode": "Road" }, "shipmentConfirmationDate": "2023-04-21T22:31:43Z", "shippedDate": "2023-04-21T22:31:43Z", "estimatedDeliveryDate": "2023-04-21T22:31:43Z", "sellingParty": { "partyId": "VENDORCODE" }, "shipFromParty": { "address": { "name": "ABC electronics warehouse", "addressLine1": "DEF 1st street", "city": "Lisses", "stateOrRegion": "abcland", "postalCode": "91090", "countryCode": "DE" }, "partyId": "ABCED" }, "shipToParty": { "partyId": "AMZWAREHOUSECODE" }, "shipmentMeasurements": { "shipmentVolume": { "unitOfMeasure": "CuFt", "value": "181.656" }, "palletCount": 3, "grossShipmentWeight": { "unitOfMeasure": "Lb", "value": "3315.744" } }, "shippedItems": [ { "itemSequenceNumber": "001", "vendorProductIdentifier": "VN24343334", "shippedQuantity": { "amount": 315, "unitOfMeasure": "Cases", "unitSize": 1 }, "itemDetails": { "purchaseOrderNumber": "PO1234BD", "lotNumber": " 12345", "expiry": { "expiryDate": "2024-11-29T21:56:18.575Z" } } } ], "pallets": [ { "tier": 10, "palletIdentifiers": [ { "containerIdentificationNumber": "108195730651297459", "containerIdentificationType": "SSCC" } ], "weight": { "unitOfMeasure": "Lb", "value": "828.936" }, "block": 15, "items": [ { "itemReference": "001", "shippedQuantity": { "amount": 105, "unitOfMeasure": "Cases", "unitSize": 1 } } ], "dimensions": { "unitOfMeasure": "In", "length": "44.375", "width": "39.750", "height": "40.500" } }, { "tier": 10, "palletIdentifiers": [ { "containerIdentificationNumber": "108195730651297589", "containerIdentificationType": "SSCC" } ], "weight": { "unitOfMeasure": "Lb", "value": "828.936" }, "block": 15, "items": [ { "itemReference": "001", "shippedQuantity": { "amount": 105, "unitOfMeasure": "Cases", "unitSize": 1 } } ], "dimensions": { "unitOfMeasure": "In", "length": "44.375", "width": "39.750", "height": "40.500" } }, { "tier": 10, "palletIdentifiers": [ { "containerIdentificationNumber": "108195730651297595", "containerIdentificationType": "SSCC" } ], "weight": { "unitOfMeasure": "Lb", "value": "828.936" }, "block": 15, "items": [ { "itemReference": "001", "shippedQuantity": { "amount": 105, "unitOfMeasure": "Cases", "unitSize": 1 } } ], "dimensions": { "unitOfMeasure": "In", "length": "44.375", "width": "39.750", "height": "40.500" } } ] } ] }

SubmitShipments

🚧

Importante

SubmitShipments è disponibile solo nei marketplace del Nord America e dell'UE.

The SubmitShipments operation is designed for Collect or WePay vendors to submit requests for the pickup of their shipments by Amazon. With this operation they can also update or cancel submitted requests. You can consolidate multiple orders that are ready to be shipped and request transportation through a single shipment request, thus saving time and lowering costs. When submitting a shipment request, the requested pickup date must be a minimum of two business days after the current date.

📘

Nota

Le SubmitShipments l'operazione non supporta l'invio di richieste di spedizione per pallet non standard.

Crea o aggiorna la spedizione
Quando il transactionType per una richiesta di spedizione è New, puoi creare una nuova richiesta o aggiornare una richiesta di spedizione inviata in precedenza. Gli aggiornamenti a una richiesta di spedizione esistente vengono effettuati in base al numero di spedizione del fornitore. Se esiste già una spedizione con il numero di spedizione del fornitore fornito, viene eseguita un'operazione di aggiornamento; in caso contrario, viene creata una nuova spedizione.

Ambito della spedizione dell'aggiornamento:

  • Tutti i valori delle richieste di spedizione sono modificabili, tranne vendorShipmentIdentifier,buyerReferenceNumber, e sellingParty.partyId che deve rimanere identico per un corretto aggiornamento. Hai la flessibilità di modificare tutti gli altri campi della richiesta di spedizione prima che il corriere venga assegnato.
  • La data di ritiro richiesta nella richiesta di spedizione può essere modificata solo dopo l'assegnazione del corriere.

Annulla spedizione
Una richiesta di spedizione con transactionType come Cancel consente di annullare una richiesta di spedizione inviata in precedenza. Per annullare una richiesta di spedizione inviata in precedenza, è necessario fornire vendorShipmentIdentifier, buyerReferenceNumber, sellingParty.partyId, shipFromParty.partyId, shipToParty.partyId e transactionType come Cancel.

Ambito dell'annullamento della spedizione:

  • L'annullamento di una richiesta di spedizione è possibile sia prima che dopo l'assegnazione di un corriere e la pianificazione del percorso.

Verifica delle richieste di spedizione inviate con successo

You use Vendor Central or the Vendor Transaction Status API to verify the status of your shipment request. If the status of the posted request doesn't appear after 30 minutes, submit a support case in Vendor Central by navigating to Vendor Central > Support > Contact Us > API Integration.

📘

Nota

The Transaction Status API only supports Processing and Failure status values for submitted Cancel Shipment requests.

Il diagramma seguente mostra il flusso di lavoro di integrazione durante l'invio delle richieste di spedizione.

The Vendor Submit shipment workflow.

Requisiti aziendali

  • La richiesta di spedizione deve essere inoltrata solo quando l'ordine di acquisto corrispondente è stato completamente confermato. Se l'ordine di acquisto non è stato ancora confermato, la richiesta di spedizione non verrà elaborata.
  • Le requestedPickUp nella richiesta di spedizione, devono essere trascorsi almeno due giorni lavorativi dalla data corrente.
  • Tutti i valori delle richieste di spedizione sono modificabili, tranne vendorShipmentIdentifier, buyerReferenceNumber, e sellingParty.partyId, che deve rimanere identico per un corretto aggiornamento. Hai la flessibilità di modificare tutti gli altri campi della richiesta di spedizione prima che il corriere venga assegnato.
  • Puoi modificare la data di ritiro richiesta nella Richiesta di spedizione solo dopo l'assegnazione di un corriere.
  • L'annullamento di una richiesta di spedizione è possibile sia prima che dopo l'assegnazione di un corriere e la pianificazione del percorso.

Spiegazioni di campi aggiuntivi

Identificativo della spedizione del fornitore

Questo campo è un ID univoco (l'unicità è definita nel contesto del fornitore), che rappresenta questa richiesta di trasporto. Mancata fornitura di un vendorShipmentIdentifier comporterà il rifiuto della Richiesta di trasporto. Assicurati che l'ID inviato non sia stato utilizzato negli ultimi 365 giorni.

Data di ritiro richiesta

Questo campo è anche chiamato Freight Ready Date, viene utilizzato per specificare la prima data di ritiro della spedizione dalla sede del fornitore. Ti viene richiesto di inviare la richiesta di trasporto quando gli articoli sono pronti per il ritiro.

Invia richieste di esempio di spedizione

Crea o aggiorna una richiesta di spedizione

{ "shipments": [ { "vendorShipmentIdentifier": "00050003", "transactionType": "New", "transactionDate": "2019-08-07T19:56:45.632", "shipmentFreightTerm": "Collect", "sellingParty": { "partyId": "PQRSS" }, "shipFromParty": { "address": { "name": "ABC electronics warehouse", "addressLine1": "DEF 1st street", "city": "Lisses", "stateOrRegion": "abcland", "postalCode": "91090", "countryCode": "DE" }, "partyId": "999US" }, "shipToParty": { "partyId": "ABCDF" }, "shipmentMeasurements": { "totalCartonCount": 30, "totalPalletStackable": 30, "totalPalletNonStackable": 30, "shipmentWeight": { "unitOfMeasure": "Kg", "value": "120.45" }, "shipmentVolume": { "unitOfMeasure": "CuFt", "value": "2.4" } }, "collectFreightPickupDetails": { "requestedPickUp": "2019-08-07T19:56:45.632" }, "purchaseOrders": [ { "purchaseOrderNumber": "1BBBAAAA" }, { "purchaseOrderNumber": "1BBBACCC" } ] } ] }

Annulla richiesta di spedizione

{ "shipments": [ { "vendorShipmentIdentifier": "00050003", "buyerReferenceNumber": "1234567", "transactionType": "Cancel", "transactionDate": "2019-08-07T19:56:45.632", "shipmentFreightTerm": "Collect", "sellingParty": { "partyId": "PQRSS" }, "shipFromParty": { "address": { "name": "ABC electronics warehouse", "addressLine1": "DEF 1st street", "city": "Lisses", "stateOrRegion": "abcland", "postalCode": "91090", "countryCode": "DE" }, "partyId": "999US" }, "shipToParty": { "partyId": "ABCDF" } } ] }

GetShipmentDetails

🚧

Importante

GetShipmentDetails è solo per WePay e raccoglie ordini nei marketplace del Nord America e dell'UE.

You can use the GetShipmentDetails operation to retrieve scheduled pickup and carrier assignment information. You must use SubmitShipments or a routing request before shipment details are available. GetShipmentDetails only returns a response after carrier assignment, which occurs either on the same day as the scheduled pickup or one day prior to the pickup date.

I dettagli restituiti nella risposta ti aiutano a eseguire in modo efficiente il processo di spedizione, a garantire che l'ordine sia imballato e che sia pronto per il ritiro da parte del corriere alla data di ritiro assegnata. In qualsiasi momento durante il ciclo di vita della spedizione, puoi utilizzare questa operazione per visualizzare lo stato e i dettagli della spedizione. Questa operazione viene utilizzata principalmente dai fornitori di WePay.

Il diagramma seguente mostra il flusso di lavoro di integrazione delle spedizioni Vendor Get.

The Vendor Get shipment workflow.

Requisiti aziendali

  • The GetShipmentDetails operation only provides a response if shipment creation is successful. The response contains the Amazon Reference Number (ARN) and other shipment details. The carrier assignment details are available only after the carrier assignment for the shipment. Carrier assignment occurs on the same day as the scheduled pickup or one day prior to the pickup date.

  • The GetShipmentDetails operation will not provide details for shipments submitted through Vendor Central.

GetShipmentDetails richiesto

To return a list of shipments, call the GetShipmentDetails operation and pass the following parameters:

Parametri di query:

Nome Descrizione Obbligatorio
limit Il limite al numero di record restituiti.

Tipo: intero

No
sortOrder Ordina l'elenco in base alla data di creazione della spedizione in ordine crescente o decrescente.

Tipo: stringa

Type: enum ( SortOrder )

No
nextToken Utilizzato per l'impaginazione quando ci sono più etichette di spedizione rispetto al limite di dimensione dei risultati specificato. Il valore del token è restituito nella chiamata API precedente.

Tipo: stringa

No
createdAfter Shipments created after this time will be included in the result. This field must be in ISO 8601 date/time format.

Tipo: stringa (data-ora)

No
createdBefore Shipments created before this time will be included in the result. This field must be in ISO 8601 date/time format.

Tipo: stringa (data-ora)

No
shipmentConfirmedBefore Use to provide the date to retrieve Shipment Details of all shipments confirmed before this date. This field must be in ISO 8601 date/time format.

Tipo: stringa (data-ora)

No
shipmentConfirmedAfter Use to provide the date to retrieve Shipment Details of all shipments confirmed after this date. This field must be in ISO 8601 date/time format.

Tipo: stringa (data-ora)

No
packageLabelCreatedBefore Use to provide the date to fetch Shipment Details of all shipments for which package labels were created before this date. This field must be in ISO 8601 date/time format.

Tipo: stringa (booleana)

No
packageLabelCreatedAfter Use to provide the date to retrieve Shipment Details of all shipments for which package labels were created after this date. This field must be in ISO 8601 date/time format.

Tipo: stringa (data-ora)

No
shippedBefore Use to provide the date to retrieve Shipment Details of all shipments for which shipped date is before this date. This field must be in ISO 8601 date/time format.

Tipo: stringa (data-ora)

No
shippedAfter Use to provide the date to retrieve Shipment Details of all shipments for which the shipped date is after this date. This field must be in ISO 8601 date/time format.

Tipo: stringa (data-ora)

No
estimatedDeliveryBefore Use to provide the date to retrieve Shipment Details of all shipments for which estimated delivery date is before this date. This field must be in ISO 8601 date/time format.

Tipo: stringa (data-ora)

No
estimatedDeliveryAfter Use to provide the date to retrieve Shipment Details of all shipments with estimated delivery date after this date. This field must be in ISO 8601 date/time format.

Tipo: stringa (data-ora)

No
shipmentDeliveryBefore Use to provide the date to retrieve Shipment Details of all shipments with shipment delivery date before this date. This field must be in ISO 8601 date/time format.

Tipo: stringa (data-ora)

No
shipmentDeliveryAfter Use to provide the date to retrieve Shipment Details of all shipments for which shipment delivery date is after this date. This field must be in ISO 8601 date/time format.

Tipo: stringa (data-ora)

No
requestedPickUpBefore Use to provide the date to retrieve Shipment Details of all shipments for which requested pickup date is before this date. This field must be in ISO 8601 date/time format.

Tipo: stringa (data-ora)

No
requestedPickUpAfter Use to provide the date to retrieve Shipment Details of all shipments for which requested pickup date is after this date. This field must be in ISO 8601 date/time format.

Tipo: stringa (data-ora)

No
scheduledPickUpBefore Use to provide the date to retrieve Shipment Details of all shipments for which scheduled pickup date is before this date. This field must be in ISO 8601 date/time format.

Tipo: stringa (data-ora)

No
scheduledPickUpAfter Use to provide the date to retrieve Shipment Details of all shipments for which scheduled pickup date is after this date. This field must be in ISO 8601 date/time format.

Tipo: stringa (data-ora)

No
currentShipmentStatus Ottieni i dettagli della spedizione indicando lo stato attuale della spedizione.

Tipo: stringa

No
vendorShipmentIdentifier Ottieni i dettagli della spedizione inserendo il numero di spedizione del fornitore.

Tipo: stringa

No
buyerReferenceNumber Ottieni i dettagli della spedizione inserendo il numero di riferimento dell'acquirente.

Tipo: stringa

No
buyerWarehouseCode Ottieni i dettagli di spedizione in base al codice del magazzino dell'acquirente. Questo valore deve essere uguale a shipToParty.partyId nella spedizione.

Tipo: stringa

No
sellerWarehouseCode Ottieni i dettagli di spedizione in base al codice del magazzino del fornitore. Questo valore deve essere uguale a sellingParty.partyId nella Spedizione.

Tipo: stringa

No

Esempio di richiesta:

GET https://sellingpartnerapi-na.amazon.com/vendor/shipping/v1/shipments?vendorShipmentIdentifier=00050003

GetShipmentDetails esempio:

Esempio di risposta:

{ "payload": { "pagination": { "nextToken": "MDAwMDAwMDAwMQ==" }, "shipments": [ { "vendorShipmentIdentifier": "00050003", "buyerReferenceNumber": "1234567", "currentShipmentStatus": "CarrierAssigned", "currentshipmentStatusDate": "2019-08-09T19:56:45.632", "shipmentStatusDetails": [ { "shipmentStatus": "CarrierAssigned", "shipmentStatusDate": "2019-08-09T19:56:45.632" }, { "shipmentStatus": "TransportationRequested", "shipmentStatusDate": "2019-07-07T19:56:45.632" }, { "shipmentStatus": "Created", "shipmentStatusDate": "2019-07-06T19:56:45.632" } ], "shipmentCreateDate": "2019-07-06T19:56:45.632", "shipmentFreightTerm": "Collect", "sellingParty": { "partyId": "998US" }, "shipFromParty": { "address": { "name": "ABC electronics warehouse", "addressLine1": "DEF 1st street", "city": "Lisses", "stateOrRegion": "abcland", "postalCode": "91090", "countryCode": "DE" }, "partyId": "ABCD12" }, "shipToParty": { "partyId": "999US" }, "shipmentMeasurements": { "totalCartonCount": 30, "totalPalletStackable": 30, "totalPalletNonStackable": 30, "shipmentWeight": { "unitOfMeasure": "Kg", "value": "120.45" }, "shipmentVolume": { "unitOfMeasure": "CuFt", "value": "2.4" } }, "collectFreightPickupDetails": { "requestedPickUp": "2019-08-10T19:56:45.632", "scheduledPickUp": "2019-08-10T19:56:45.632", "carrierAssignmentDate": "2019-08-09T19:56:45.632", }, "purchaseOrders": [ { "purchaseOrderNumber": "1BBBAAAA" } ], "transportationDetails": { "shipMode": "LessThanTruckLoad", "transportationMode": "Road", "shippedDate": "2019-08-07T19:56:45.632", "estimatedDeliveryDate": "2019-08-07T19:56:45.632", "shipmentDeliveryDate": "2019-08-07T19:56:45.632", "carrierDetails": { "name": "UPS", "phone": "1234567890", "email": "abc@xyz.com", "code": "string", "shipmentReferenceNumber": "TRACK001" }, "billOfLadingNumber": "string" } } ] } }

GetShipmentLabels

You can use the GetShipmentLabels operation to obtain shipping labels from Amazon exclusively for small parcel shipments on behalf of Collect/WePay vendors. This operation helps vendors retrieve shipping labels for confirmed orders that require shipment from the vendor's warehouse to Amazon's warehouse. Vendors can retrieve labels through a single API call or multiple API calls. Labels are generated once the shipment request is finalized and a carrier is assigned. Vendors have the option to filter Amazon-generated labels based on various parameters, such as buyer reference numbers (also known as Amazon reference numbers), seller warehouse codes, and other values.

Il diagramma seguente illustra il flusso di lavoro di integrazione dell'etichetta di spedizione del fornitore.

The workflow for getting a shipment label

Requisiti aziendali

  • Chiama il GetShipmentLabels solo dopo l'assegnazione di un corriere.
  • If GetShipmentLabels does not return a label or returns Resource Not Found, verify that a carrier has been assigned. Alternatively, you can call GetShipmentDetails to confirm whether the carrier has been assigned.
  • Se è stato assegnato un corriere e l'operazione non restituisce ancora alcuna etichetta, apri una richiesta «Contattaci» nel portale Vendor Central.
  • Una volta utilizzata per la spedizione, un'etichetta non può più essere riutilizzata.

Requisiti aziendali specifici per paese

Questa operazione API è disponibile solo nella regione NA.

Richiesta di interrogazione

To return a list of shipment labels, call the GetShipmentLabels operation and pass the following parameters:

Nome Descrizione Obbligatorio
limit Il limite al numero di record restituiti.

Tipo: intero

No
sortOrder Ordina l'elenco in base alla data di creazione dell'etichetta di spedizione in ordine crescente o decrescente.

Tipo: stringa

Type: enum ( SortOrder )

No
nextToken Utilizzato per l'impaginazione quando ci sono più ordini rispetto al limite di dimensione dei risultati specificato. Il valore del token è restituito nella chiamata API precedente.

Tipo: stringa

No
labelCreatedAfter Le etichette di spedizione create dopo questo periodo verranno incluse nel risultato. Questo campo deve essere nel formato data/ora ISO 8601.

Tipo: stringa (data-ora)

No
labelCreatedBefore Le etichette di spedizione create prima di questo orario verranno incluse nel risultato. Questo campo deve essere nel formato data/ora ISO 8601.

Tipo: stringa (data-ora)

No
buyerReferenceNumber Ottieni le etichette di spedizione inserendo l'ID di riferimento dell'acquirente.

Tipo: stringa

No
vendorShipmentIdentifier Ottieni le etichette di spedizione inserendo il numero di spedizione del fornitore.

Tipo: stringa

No
sellerWarehouseCode Ottieni le etichette di spedizione in base al codice del magazzino del fornitore. Questo valore deve essere uguale a sellingParty.partyId nella spedizione.

Tipo: stringa

No

Esempio di richiesta

GET /vendor/shipping/v1/transportLabels?vendorShipmentIdentifier=7822

Risposta GetShipmentLabels

{ "payload": { "pagination": { "nextToken": "MDAwMDAwMDAwMQ==" }, "transportLabels": [ { "labelCreateDateTime": "2024-10-23T17:10:35Z", "shipmentInformation": { "vendorDetails": { "sellingParty": { "partyId": "WAD47" }, "vendorShipmentIdentifier": "7822" }, "buyerReferenceNumber": "14511336331", "shipToParty": { "partyId": "LAX9" }, "shipFromParty": { "partyId": "0-55767831", "address": { "name": "Wheeler Bros., Inc. HQ", "addressLine1": "384 Drum Ave", "addressLine2": "Suite 123", "addressLine3": "DOOR 1", "city": "Somerset", "stateOrRegion": "PA", "postalCode": "15501", "countryCode": "US" } }, "masterTrackingId": "1ZR873R70319165935", "totalLabelCount": 1, "shipMode": "SmallParcel" }, "labelData": [ { "labelSequenceNumber": 1, "labelFormat": "PDF", "carrierCode": "UPSN", "trackingId": "1ZR873R70319165935", "label": "Base 64 encoded string goes here." } ] } ] } }

Cos'è l'API Vendor Invoices?

You can use the Vendor Invoices API, to exchange payment related documents with Amazon. With the Submit Invoices operation, you can send vendor invoices to Amazon for confirmed and shipped orders.

Sono incluse le seguenti operazioni:

OperazioneMetodo HTTPPathDescrizione
submitInvoicesPOST/vendor/payments/v1/invoicesInvia una o più fatture del fornitore ad Amazon

📘

Nota

Le submitInvoices l'operazione può essere utilizzata per inviare note di credito in Europa.

Invia fatture

You can use the submitInvoices operation to request payment from Amazon for items shipped. You can use this operation to submit multiple invoices in a single API call.

Gli articoli devono essere fatturati solo dopo essere stati confermati e spediti ad Amazon. In caso contrario, la fattura sarà rifiutata.

Amazon elaborerà una fattura con informazioni corrette senza alcuna interazione umana, il che significa che il fornitore può ricevere il pagamento più velocemente.

Invoices with incorrect information will be rejected in Amazon's payee system, so sending correct information is important. Refer to the business requirements section to learn how to create invoices with correct information.

Test parallelo dell'invio di fatture

You need to complete parallel testing with our payments system before you can start using the submitInvoices operation for payment processing.

Quando inizi a inviare fatture utilizzando l'API, inizia la fase di test parallela. Durante la fase di test parallela, invii fatture Vendor Central e API per tutti gli ordini spediti. È necessario eseguire un test in parallelo fino alla convalida del contenuto di almeno 5-10 file di fattura. I test vengono condotti in parallelo con ordini d'acquisto e fatture di produzione.

Il team di Amazon Accounts Payable (AP) ti contatterà al termine del test parallelo o in caso di discrepanze di contenuto nelle tue fatture.

Quando ricevi un'email che dice che il test parallelo è completo, non devi più inviare fatture a Vender Central; puoi utilizzare l'API per inviare le fatture.

Verifica delle fatture inviate correttamente

The Transaction Status API shows the status of the semantic validations for submitted invoices, but not the actual status of invoice processing. You can verify the actual status of the original or updated version of the invoices via Vendor Central > Payments > Invoices. For more information on how to use the Transaction Status API, refer to the business use case documentation for Transaction Status. If the original or updated version with the correct values for the updated invoice isn't present after 30 minutes, submit a support case in Vendor Central by navigating to Vendor Central > Support > Contact Us > API Integration.

Il seguente diagramma illustra il flusso di lavoro di integrazione per l'invio di una fattura per un ordine confermato e spedito.

The Vendor invoices workflow when submitting an invoice for a confirmed and shipped order.

Requisiti aziendali

  • Per gli articoli il cui prezzo è calcolato in base al peso, è necessario fornire totalWeight campo. Il totalWeight il campo contiene il peso complessivo dell'articolo fatturato. Inoltre, netCostUnitOfMeasure il campo deve riflettere l'unità di misura degli articoli a cui viene assegnato il prezzo in base al peso. I valori dell'unità di misura includono POUNDS, OUNCES, GRAMS, e KILOGRAMS.

  • I numeri di fattura devono essere univoci e non devono mai essere riutilizzati, nemmeno dopo un anno.

  • Se una fattura inviata tramite API fallisce a causa di dati errati, ma una fattura Vendor Central contiene i dati corretti, è necessario aggiornare la fattura tramite l'API con i dati corretti utilizzando gli stessi Invoice ID.

  • Se una fattura contiene dati errati (sia Vendor Central che API), la fattura viene annullata e deve essere inviata una nuova fattura con una nuova Invoice ID.

  • Non devono essere inviate fatture con total amount = 0 = 0, poiché tali fatture non andrebbero a buon fine.

  • Amazon requires the full address details in the address segments for tax compliance reasons. This is especially important for bill to party. For this segment the Amazon Payee system requires an exact match. For the list of addresses, refer to SP-API Bill to Party Addresses.

  • I termini di pagamento inviati in una fattura devono corrispondere ai termini di pagamento concordati con l'acquirente Amazon.

  • Il identificativo prodotto dell'articolo deve corrispondere all'identificativo del prodotto dell'articolo dell'ordine inviato al fornitore nell'ordine d’acquisto corrispondente.

  • L'importo totale della fattura deve essere pari alla somma totale di articoli, spese e indennità.

  • L'importo dell'imposta totale per ogni voce deve essere pari all'importo totale dell'imposta a livello di intestazione.

  • La quantità totale della fattura deve corrispondere alla somma della quantità di tutti gli articoli.

  • Ogni diversa spesa e indennità deve essere dettagliata a livello di intestazione, per esempio spese di trasporto, spese per il pacco, spese per piccolo ordine, e così via.

Avvertenza

L'indirizzo di invio deve corrispondere all'indirizzo registrato da Amazon. Se l'indirizzo non corrisponde, la fattura ha esito negativo.

Requisiti aziendali specifici per paese

Funzionalità India Europa Nord America
Tipo di fattura Tipo di fattura CreditNote non è supportato. Il tipo di fattura deve essere sempre Invoice. Tipi di fattura Invoice e CreditNote sono supportati. I fornitori devono inviare il tipo di fattura di conseguenza. Tipo di fattura CreditNote non è supportato. Il tipo di fattura deve essere sempre Invoice.
Riferimenti delle note di credito Non in uso I fornitori sono tenuti a inviare questi riferimenti a livello di articolo se il tipo di fattura è CreditNote. Non in uso
Data Deve essere now o prima. Deve essere now o prima. Deve essere now o prima.
Numero HSN Il codice del Sistema armonizzato di nomenclatura (HSN) è obbligatorio per le fatture conformi alle imposte. La lunghezza massima consentita è di otto caratteri. Non in uso Non in uso
Tipo di imposta a livello di voce e intestazione Sono consentiti i seguenti tipi di imposta:
  • SGST e CGST
  • SGST e CGST e CESS
  • UTGST e CGST
  • UTGST e CGST e CESS
  • IGST
  • IGST e CESS

Se non vengono indicate informazioni sull'imposta, la fattura viene rifiutata.

Tipo di imposta da inviare. Non in uso
Numero di registrazione fiscale È necessario fornire un ID GST di 15 caratteri. Numero di partita IVA Numero di partita IVA
Dettagli fiscali a livello di voce e intestazione Se a un articolo possono essere applicate più imposte, la sezione Dettagli fiscali deve essere inviata più volte con il tipo di imposta appropriato per tale articolo.

Lo stesso vale per l'importo totale della fattura.

Se a un articolo possono essere applicate più imposte, la sezione Dettagli fiscali deve essere inviata più volte con il tipo di imposta appropriato per tale articolo.

Lo stesso vale per l'importo totale della fattura.

Esiste anche un tipo di imposta aggiuntivo chiamato DomesticVAT, che può essere utilizzato per inviare l'importo dell'imposta nella valuta locale. Per elaborare l'IVA nazionale è necessario utilizzare la stessa aliquota fiscale utilizzata per il tipo di imposta VAT.

Se a un articolo possono essere applicate più imposte, la sezione Dettagli fiscali deve essere inviata più volte con il tipo di imposta appropriato per tale articolo.

Lo stesso vale per l'importo totale della fattura.

Parte incaricata La parte che fornisce le merci ad Amazon e riceverà il pagamento. Chiamata anche fornitore. Dati fiscali e indirizzo della parte (fornitore) che riceverà il pagamento per gli articoli spediti nel caso di una fattura o per gli articoli restituiti nel caso di una nota di credito. È obbligatorio. Dati fiscali e indirizzo della parte (fornitore) che riceverà il pagamento per gli articoli spediti. È obbligatorio.
Mittente spedizione Dettagli dell'indirizzo di origine della spedizione, insieme al codice ISO dello stato.

L'ID GST deve essere inviato nel numero di registrazione fiscale. Il mittente è obbligatorio. I valori devono corrispondere a quelli presenti nei sistemi Amazon.

Codice fornitore o codice del magazzino e indirizzo della parte che spedisce gli articoli. Codice fornitore o codice del magazzino e indirizzo della parte che spedisce gli articoli.
Destinatario spedizione Dettagli dell'indirizzo di origine della spedizione, insieme al codice ISO dello stato. Il mittente è obbligatorio.

I valori devono corrispondere ai valori presenti nei sistemi Amazon.

ID Amazon o codice del magazzino e indirizzo della parte a cui saranno spediti gli articoli. ID Amazon o codice del magazzino e indirizzo della parte a cui saranno spediti gli articoli.
Intestatario della fattura L'intestatario della fattura è obbligatorio e può essere uguale al destinatario. In tal caso, il fornitore è tenuto a inviare le stesse informazioni in entrambi i segmenti. Tax and Address details of the party (Amazon) who will be billed for the shipped items (in case of an Invoice) or the returned items (in case of a credit note). For a complete list of Amazon bill to party addresses and JSON code examples, refer to SP-API bill to party addresses.

Questo campo è obbligatorio.

Dati fiscali e indirizzo della parte (Amazon) a cui sarà intestata la fattura per gli articoli spediti.

Questo campo è obbligatorio.

Identificativo del prodotto Amazon e identificativo del prodotto esterno Almeno uno di questi valori è obbligatorio. L'identificativo deve essere lo stesso ricevuto nell'ordine. Almeno uno dei valori è obbligatorio. L'identificativo deve essere lo stesso ricevuto nell'ordine. Almeno uno dei valori è obbligatorio. L'identificativo deve essere lo stesso ricevuto nell'ordine.
Costo netto Questo campo è obbligatorio. Questo campo è obbligatorio. Questo campo è obbligatorio.
Numero dell'ordine d'acquisto Una fattura può contenere informazioni relative solo a un ordine, pertanto il numero di ordine d'acquisto deve essere lo stesso per tutti gli articoli delle voci di una fattura.

Obbligatorio.

Una fattura può contenere informazioni per più ordini. Il numero d'ordine d'acquisto deve essere inviato di conseguenza per le diverse voci. Questo campo è necessario se il tipo di fattura è Invoice e non viene utilizzato quando il tipo di fattura è CreditNote. Una fattura può contenere informazioni relative a più ordini. Il numero dell'ordine d'acquisto deve essere inviato correttamente in base alle diverse voci.

Obbligatorio.

Dettagli aggiuntivi Non in uso Questo campo viene utilizzato quando la parte venditrice deve inviare dettagli aggiuntivi per scopi speciali. Ad esempio, nel caso di fatture polacche con pagamento frazionato, la parte venditrice deve inviare i dati»mechanizm podzielonej płatności"di tipo SUR e languageCode »PL». Non in uso
referenceNumber Un numero di riferimento univoco della fattura generato dal governo indiano per ogni fattura. Questo campo è obbligatorio per tutte le fatture in India. Non in uso Non in uso

Indirizzi degli intestatari delle fatture

When submitting an invoice, bill to party address details must be complete and formatted correctly, or the API call will fail. If you do not know the Amazon Tax ID for a bill to location, refer to the Vendor Central help pages.

For a complete list of Amazon bill to party addresses and JSON code examples, refer to SP-API bill to party addresses. You can also find this list, including Amazon's tax IDs, on the EDI Resources help page in your Vendor Central account.

Nota di credito

You can use the Vendor Invoices API to send credit notes to Amazon. A credit note lists the products, quantities, and agreed prices for products or services that you provided to Amazon, but Amazon returned or did not receive. A credit note can be issued in the case of damaged goods or errors in price when allowances or rebates are agreed on beforehand between Amazon and the vendor.

Note di credito supportate da Amazon

Note di credito per conto da pagare Note di credito per conto da esigere
Credito PPV

Credito per gli articoli fatturati ma non ricevuti o credito per pagamenti duplicati.

Restituzioni

Credito per gli articoli restituiti al venditore a causa, ad esempio, di merce danneggiata, merce spedita erroneamente e scorte in eccesso.

Credito PPV

Credito per articoli fatturati a un prezzo maggiore/inferiore.

COOP (ad esempio, protezione dei prezzi, indennità per danni)

Crediti COOP pagati ad Amazon dal fornitore per vendere i propri prodotti o per un accordo di protezione dei prezzi.


📘

Nota

Le note di credito non sono supportate in tutte le località.

submitInvoices Classe

Fattura con più articoli senza imposte

{ "invoices": [ { "invoiceType": "Invoice", "id": "I5599913", "date": "2019-07-24T21:17:59.821Z", "remitToParty": { "partyId": "VENDORID", "address": { "name": "VENDORNAME", "addressLine1": "PO BOX 1234", "city": "SAN RAFAEL", "stateOrRegion": "CA", "postalOrZipCode": "60693", "countryCode": "US" } }, "shipToParty": { "partyId": "AMAZON", "address": { "name": "AMAZON.COM", "addressLine1": "500 MCCARTHY DR", "addressLine2": "FAIRVIEW BUSINESS PARK", "city": "LEWISBERRY", "stateOrRegion": "PA", "postalOrZipCode": "17339", "countryCode": "US" } }, "billToParty": { "partyId": "AMAZON", "address": { "name": "AMAZON.COM", "addressLine1": "500 MCCARTHY DR", "addressLine2": "FAIRVIEW BUSINESS PARK", "addressLine3": "string", "city": "LEWISBERRY", "stateOrRegion": "PA", "postalOrZipCode": "17339", "countryCode": "US" } }, "paymentTerms": { "type": "Basic", "discountPercent": "2.00", "discountDueDays": 30, "netDueDays": 31 }, "invoiceTotal": { "currencyCode": "USD", "amount": "1295" }, "items": [ { "itemSequenceNumber": 1, "amazonProductIdentifier": "ABC123434", "vendorProductIdentifier": "040YP0U", "invoicedQuantity": { "amount": 2, "unitOfMeasure": "Cases", "unitSize": "10" }, "netCost": { "currencyCode": "USD", "amount": "140" }, "purchaseOrderNumber": "S8672793" }, { "itemSequenceNumber": 2, "amazonProductIdentifier": "ABC123435", "vendorProductIdentifier": "0264CBS", "invoicedQuantity": { "amount": 5, "unitOfMeasure": "Cases", "unitSize": "10" }, "netCost": { "currencyCode": "USD", "amount": "125" }, "purchaseOrderNumber": "S8672793" }, { "itemSequenceNumber": 3, "amazonProductIdentifier": "ABC123436", "vendorProductIdentifier": "040YP0K", "invoicedQuantity": { "amount": 3, "unitOfMeasure": "Cases", "unitSize": "5" }, "netCost": { "currencyCode": "USD", "amount": "130" }, "purchaseOrderNumber": "S8672793" } ] } ] }

Fattura con una sola imposta su un articolo

{ "invoices": [ { "invoiceType": "Invoice", "id": "5002841638", "date": "2019-07-24T21:17:59.821Z", "remitToParty": { "partyId": "VENDORID", "address": { "name": "VENDORNAME", "addressLine1": "PO BOX 1234", "city": "TORONTO", "stateOrRegion": "ON", "postalOrZipCode": "M5W 5M5", "countryCode": "CA" }, "taxRegistrationDetails": [ { "taxRegistrationType": "VAT", "taxRegistrationNumber": "VENDORTAXID" } ] }, "shipToParty": { "partyId": "AMAZONCA", "address": { "name": "AMAZON CANADA", "addressLine1": "500 MCCARTHY DR", "addressLine2": "FAIRVIEW BUSINESS PARK", "city": "MISSISSAUGA", "stateOrRegion": "ON", "postalOrZipCode": "M5W 5M5", "countryCode": "CA" } }, "billToParty": { "partyId": "AMAZONCA", "address": { "name": "AMAZON CANADA", "addressLine1": "500 MCCARTHY DR", "addressLine2": "FAIRVIEW BUSINESS PARK", "addressLine3": "string", "city": "MISSISSAUGA", "stateOrRegion": "ON", "postalOrZipCode": "M5W 5M5", "countryCode": "CA" }, "taxRegistrationDetails": [ { "taxRegistrationType": "VAT", "taxRegistrationNumber": "AMAZONTAXID" } ] }, "paymentTerms": { "type": "Basic", "netDueDays": 31 }, "invoiceTotal": { "currencyCode": "CAD", "amount": "1950" }, "taxDetails": [ { "taxType": "GS", "taxRate": "5", "taxAmount": { "currencyCode": "CAD", "amount": "97.5" }, "taxableAmount": { "currencyCode": "CAD", "amount": "1950" } } ], "items": [ { "itemSequenceNumber": 1, "amazonProductIdentifier": "ABC123434", "vendorProductIdentifier": "1012380100000", "invoicedQuantity": { "amount": 4, "unitOfMeasure": "Eaches" }, "netCost": { "currencyCode": "CAD", "amount": "20.00" }, "purchaseOrderNumber": "Q6515853", "taxDetails": [ { "taxType": "GS", "taxRate": "5", "taxAmount": { "currencyCode": "CAD", "amount": "1.00" } } ] }, { "itemSequenceNumber": 2, "amazonProductIdentifier": "ABC123435", "vendorProductIdentifier": "1000570100000", "invoicedQuantity": { "amount": 30, "unitOfMeasure": "Eaches" }, "netCost": { "currencyCode": "CAD", "amount": "50.00" }, "purchaseOrderNumber": "Q6515853", "taxDetails": [ { "taxType": "GS", "taxRate": "5", "taxAmount": { "currencyCode": "CAD", "amount": "2.50" } } ] }, { "itemSequenceNumber": 3, "amazonProductIdentifier": "ABC123436", "vendorProductIdentifier": "0543900100000", "invoicedQuantity": { "amount": 3, "unitOfMeasure": "Eaches" }, "netCost": { "currencyCode": "CAD", "amount": "90" }, "purchaseOrderNumber": "Q6515853", "taxDetails": [ { "taxType": "GS", "taxRate": "5", "taxAmount": { "currencyCode": "CAD", "amount": "4.50" } } ] }, { "itemSequenceNumber": 4, "amazonProductIdentifier": "ABC123437", "vendorProductIdentifier": "1000570200000", "invoicedQuantity": { "amount": 5, "unitOfMeasure": "Eaches" }, "netCost": { "currencyCode": "CAD", "amount": "20.00" }, "purchaseOrderNumber": "Q6515853", "taxDetails": [ { "taxType": "GS", "taxRate": "5", "taxAmount": { "currencyCode": "CAD", "amount": "1.00" } } ] } ] } ] }

Fattura con più imposte su un articolo

{ "invoices": [ { "invoiceType": "Invoice", "id": "8900000001234", "date": "2019-07-24T21:17:59.821Z", "remitToParty": { "partyId": "XYZ123", "address": { "name": "XYZ INDIA PRIVATE LIMITED", "addressLine1": "4TH FLOOR", "city": "GURUGRAM", "stateOrRegion": "HR", "postalOrZipCode": "122002", "countryCode": "IN" }, "taxRegistrationDetails": [ { "taxRegistrationType": "VAT", "taxRegistrationNumber": "VENDORTAXID" } ] }, "shipToParty": { "partyId": "AMAZONIN", "address": { "name": "AMAZON INDIA", "addressLine1": "Chowranghee Mansion JN Road", "city": "Kolkata", "stateOrRegion": "WB", "countryCode": "IN" } }, "shipFromParty": { "partyId": "XYZ123", "address": { "name": "XYZ RETAIL PVT LTD", "addressLine1": "Chowranghee Mansion JN Road", "city": "Kolkata", "stateOrRegion": "WB", "postalOrZipCode": "700016", "countryCode": "IN" } }, "billToParty": { "partyId": "AMAZONIN", "address": { "name": "AMAZON INDIA", "addressLine1": "Arrjaw Industrial & Warehouse Park", "addressLine2": "Near Coal India Complex", "city": "Hooghly", "stateOrRegion": "WB", "postalOrZipCode": "712310", "countryCode": "IN" }, "taxRegistrationDetails": [ { "taxRegistrationType": "VAT", "taxRegistrationNumber": "AMAZONTAXID" } ] }, "paymentTerms": { "type": "Basic", "netDueDays": 30 }, "invoiceTotal": { "currencyCode": "INR", "amount": "258262.39" }, "taxDetails": [ { "taxType": "SGST", "taxRate": "9", "taxAmount": { "currencyCode": "INR", "amount": "19697.98" }, "taxableAmount": { "currencyCode": "INR", "amount": "218866.43" } }, { "taxType": "CGST", "taxRate": "9", "taxAmount": { "currencyCode": "INR", "amount": "19697.98" }, "taxableAmount": { "currencyCode": "INR", "amount": "218866.43" } } ], "items": [ { "itemSequenceNumber": 1, "amazonProductIdentifier": "ABC123434", "vendorProductIdentifier": "809000-0000", "invoicedQuantity": { "amount": 2, "unitOfMeasure": "Eaches" }, "netCost": { "currencyCode": "INR", "amount": "21060.34" }, "purchaseOrderNumber": "3DY3TK6T", "hsnCode": "76.06.92.90", "taxDetails": [ { "taxType": "SGST", "taxRate": "9", "taxAmount": { "currencyCode": "INR", "amount": "1895.43" }, "taxableAmount": { "currencyCode": "INR", "amount": "21060.34" } }, { "taxType": "CGST", "taxRate": "9", "taxAmount": { "currencyCode": "INR", "amount": "1895.43" }, "taxableAmount": { "currencyCode": "INR", "amount": "21060.34" } } ] }, { "itemSequenceNumber": 2, "amazonProductIdentifier": "ABC123435", "vendorProductIdentifier": "795000-0001", "invoicedQuantity": { "amount": 3, "unitOfMeasure": "Eaches" }, "netCost": { "currencyCode": "INR", "amount": "58915.25" }, "purchaseOrderNumber": "3DY3TK6T", "hsnCode": "76.06.92.91", "taxDetails": [ { "taxType": "SGST", "taxRate": "9", "taxAmount": { "currencyCode": "INR", "amount": "5302.37" }, "taxableAmount": { "currencyCode": "INR", "amount": "58915.25" } }, { "taxType": "CGST", "taxRate": "9", "taxAmount": { "currencyCode": "INR", "amount": "5302.37" }, "taxableAmount": { "currencyCode": "INR", "amount": "58915.25" } } ] } ] } ] }

Fattura con dettagli di indennità/spese a livello di intestazione e di voce con imposta

{ "invoices": [ { "invoiceType": "Invoice", "id": "0136981234", "date": "2019-07-24T21:17:59.821Z", "remitToParty": { "partyId": "XYZ12345", "address": { "name": "XYZ INDIA PRIVATE LIMITED", "addressLine1": "4TH FLOOR", "city": "GURUGRAM", "stateOrRegion": "HR", "postalOrZipCode": "122002", "countryCode": "IN" }, "taxRegistrationDetails": [ { "taxRegistrationType": "VAT", "taxRegistrationNumber": "VENDORVATID" } ] }, "shipToParty": { "partyId": "AMAZONIN", "address": { "name": "AMAZON INDIA", "addressLine1": "Chowranghee Mansion JN Road", "city": "Kolkata", "stateOrRegion": "WB", "countryCode": "IN" } }, "shipFromParty": { "partyId": "XYZ12345", "address": { "name": "XYZ RETAIL PVT LTD", "addressLine1": "Chowranghee Mansion JN Road", "city": "Kolkata", "stateOrRegion": "WB", "postalOrZipCode": "700016", "countryCode": "IN" } }, "billToParty": { "partyId": "AMAZONIN", "address": { "name": "AMAZON INDIA", "addressLine1": "Arrjaw Industrial & Warehouse Park", "addressLine2": "Near Coal India Complex", "city": "Hooghly", "stateOrRegion": "WB", "postalOrZipCode": "712310", "countryCode": "IN" }, "taxRegistrationDetails": [ { "taxRegistrationType": "VAT", "taxRegistrationNumber": "AMAZONVATID" } ] }, "paymentTerms": { "type": "Basic", "discountPercent": "5", "discountDueDays": 15, "netDueDays": 30 }, "invoiceTotal": { "currencyCode": "INR", "amount": "259678.39" }, "taxDetails": [ { "taxType": "SGST", "taxRate": "9", "taxAmount": { "currencyCode": "INR", "amount": "19697.98" }, "taxableAmount": { "currencyCode": "INR", "amount": "218866.43" } }, { "taxType": "CGST", "taxRate": "9", "taxAmount": { "currencyCode": "INR", "amount": "19697.98" }, "taxableAmount": { "currencyCode": "INR", "amount": "218866.43" } } ], "chargeDetails": [ { "type": "Freight", "description": "Freight Charges", "chargeAmount": { "currencyCode": "INR", "amount": "1200.00" }, "taxDetails": [ { "taxType": "CGST", "taxRate": "9", "taxAmount": { "currencyCode": "INR", "amount": "108.00" }, "taxableAmount": { "currencyCode": "string", "amount": "string" } }, { "taxType": "SGST", "taxRate": "9", "taxAmount": { "currencyCode": "INR", "amount": "108.00" }, "taxableAmount": { "currencyCode": "string", "amount": "string" } } ] } ], "items": [ { "itemSequenceNumber": 1, "amazonProductIdentifier": "ABC123434", "vendorProductIdentifier": "809281-5100", "invoicedQuantity": { "amount": 2, "unitOfMeasure": "Eaches" }, "netCost": { "currencyCode": "INR", "amount": "21060.34" }, "purchaseOrderNumber": "3DY3TK6T", "hsnCode": "76.06.92.93", "taxDetails": [ { "taxType": "SGST", "taxRate": "9", "taxAmount": { "currencyCode": "INR", "amount": "1895.43" }, "taxableAmount": { "currencyCode": "INR", "amount": "21060.34" } }, { "taxType": "CGST", "taxRate": "9", "taxAmount": { "currencyCode": "INR", "amount": "1895.43" }, "taxableAmount": { "currencyCode": "INR", "amount": "21060.34" } } ], "chargeDetails": [ { "type": "Freight", "description": "Freight Charges", "chargeAmount": { "currencyCode": "INR", "amount": "600.00" } } ] }, { "itemSequenceNumber": 2, "amazonProductIdentifier": "ABC123435", "vendorProductIdentifier": "795000-0001", "invoicedQuantity": { "amount": 3, "unitOfMeasure": "Eaches" }, "netCost": { "currencyCode": "INR", "amount": "58915.25" }, "purchaseOrderNumber": "3DY3TK6T", "taxDetails": [ { "taxType": "SGST", "taxRate": "9", "taxAmount": { "currencyCode": "INR", "amount": "5302.37" }, "taxableAmount": { "currencyCode": "INR", "amount": "58915.25" } }, { "taxType": "CGST", "taxRate": "9", "taxAmount": { "currencyCode": "INR", "amount": "5302.37" }, "taxableAmount": { "currencyCode": "INR", "amount": "58915.25" } } ], "chargeDetails": [ { "type": "Freight", "description": "Freight Charges", "chargeAmount": { "currencyCode": "INR", "amount": "600.00" } } ] } ] } ] }

Nota di credito UE con imposta

{ "invoices": [ { "invoiceType": "CreditNote", "id": "BasicCredit", "date": "2019-07-24T21:17:59.821Z", "remitToParty": { "partyId": "AMAZON", "address": { "name": "AMAZON EU SARL, UK BRANCH", "addressLine1": "1 PRINCIPAL PLACE WORSHIP STREET", "city": "LONDON", "postalOrZipCode": "EC2A 2FA", "countryCode": "GB" } }, "billToParty": { "partyId": "VendorCode", "address": { "name": "Vendor Name", "addressLine1": "Vendor Address", "city": "Vendor City", "stateOrRegion": "Vendor State", "postalOrZipCode": "Vendor ZIP Code", "countryCode": "Vendor Country" } }, "invoiceTotal": { "currencyCode": "GBP", "amount": "100" }, "taxDetails": [ { "taxType": "VAT", "taxRate": "10", "taxAmount": { "currencyCode": "GBP", "amount": "10.00" }, "taxableAmount": { "currencyCode": "GBP", "amount": "100.00" } } ], "items": [ { "itemSequenceNumber": 1, "amazonProductIdentifier": "ABC123434", "vendorProductIdentifier": "TESTSKU", "invoicedQuantity": { "amount": 1, "unitOfMeasure": "Cases", "unitSize": "10" }, "netCost": { "currencyCode": "GBP", "amount": "100" }, "creditNoteDetails": { "referenceInvoiceNumber": "test-basic-ref", "debitNoteNumber": "debit-ref", "returnsReferenceNumber": "return-ref", "goodsReturnDate": "2019-07-24T21:17:59.821Z", "rmaId": "rma-ref", "consignorsReferenceNumber": "VRET-ref" } } ] } ] }

Cos'è l'API Stato delle transazioni dei fornitori?

You can use the Vendor Transaction Status API to check the transaction status of your POST transactions.

Sono incluse le seguenti operazioni:

.
OperazioneMetodo HTTPPathDescrizione
getTransactionGET/vendor/transactions/v1/transactionStatus/{transactionId}Ottieni lo stato di una richiesta di transazione Post. Restituisce un ordine d'acquisto sulla base del valore di purchaseOrderNumber specificato. Lo stato delle transazioni può essere verificato per i dati che risalgono a fino a un massimo di quattro mesi dalla data della chiamata POST originale.

Ottieni stato della transazione

You can use the Vendor Transaction Status API to check the status of a POST transaction. When a transaction such as an Order Acknowledgement or Shipment Confirmation is posted to Amazon using an API, the response includes a transaction identifier that uniquely identifies the transaction. Amazon will process the transaction asynchronously and the final response will be available via the getTransaction operation. Refer to the corresponding integration workflow diagrams in the individual API sections (for example, Vendor Orders and Vendor Shipments) to understand when to call this API to get the transaction status.

Amazon offre lo stato di elaborazione finale per le transazioni API POST come le conferme degli ordini e le conferme di spedizione tramite questa API. Consigliamo caldamente ai fornitori di verificare lo stato utilizzando questa API per assicurarsi che le transazioni siano state elaborate correttamente. Nel caso in cui si verifichi un errore, la risposta conterrà le relative informazioni per poter correggere e inviare nuovamente la transazione.

Stato transazioneDefinizione
In elaborazioneAmazon ha ricevuto la transazione API e l'elaborazione è in corso, ma non è ancora completa. Verifica i termini di ogni operazione API per conoscere il tempo previsto per il completamento dell'elaborazione.
SuccessoThis status is supported only for Submit Shipment Confirmations and Submit Shipment in NA and EU only. Success is not supported for the submitAcknowledgement and submitInvoices operations.
Non riuscitoLa transazione API non è andata a buon fine durante l'elaborazione. I dettagli dell'errore saranno forniti nel corpo della risposta dello stato della transazione.

📘

Nota

Lo stato della transazione è supportato per le seguenti operazioni API:

Lo stato della transazione supporta solo il Processing e Failure valori di stato. Se lo stato della transazione è Processinge non aggiornato a Failure dopo 15 minuti, ciò indica che la transazione è stata elaborata con successo nei nostri sistemi.

A transaction is generally considered to be successfully delivered on our end when the status is Processing. If for any reason, Vendor Central status is not updated within 30 minutes of sending the message, open a support case using Vendor Central by providing the transaction ID returned in the POST call. Ensure data submitted is in the correct format before opening the case.

You can't use this API for Invoice messages as they are not supported and status will be always Processing. For any payment related queries, first check in Vendor Central, and then create a Contact Us case in Vendor Central and select the relevant queue.

Casi d'uso di Stato delle transazioni

Transazione in elaborazione

{ "payload": { "transactionStatus": { "transactionId": "20190905193800-0c6b76cb-9662-4f3a-be03-1686c1e21477", "status": "Processing" } } }

Transazione elaborata correttamente

La transazione è nello stato "In elaborazione" da 15 minuti dopo l'invio.

{ "payload": { "transactionStatus": { "transactionId": "20190905193800-0c6b76cb-9662-4f3a-be03-1686c1e21477", "status": "Processing" } } }

Transazione non riuscita in Amazon

{ "payload": { "transactionStatus": { "transactionId": "20190908091302-6ca0ac50-d06e-45f5-a1e2-eb448eadac50", "status": "Failure", "errors": [ { "code": "INVALID_ORDER_ID", "message": "Invalid order ID." } ] } } }

Questa pagina ti è stata utile?