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 ilincludeDetails
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 usiincludeDetails=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.
getPurchaseOrders
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:
getPurchaseOrder
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:
Requisiti aziendali
-
Ordinazione basata sul peso
Per gli ordini che contengono articoli venduti a peso,
unitOfMeasure
campo (sottolistPrice
enetCost
) riflette l'unità di misura effettiva del peso. I valori dell'unità di misura del peso includonoPOUNDS
,OUNCES
,GRAMS
, eKILOGRAMS
. -
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à | India | Europa | Nord America |
---|---|---|---|
Costo netto | Condizionale. Costo netto o prezzo di listino. | Condizionale. Costo netto o prezzo di listino. | Condizionale. Costo netto o prezzo di listino. |
Prezzo di listino | Condizionale. Costo netto o prezzo di listino. | Condizionale. Costo netto o prezzo di listino. | Condizionale. Costo netto o prezzo di listino. |
Arretrato | Non applicabile | Supportato | Supportato |
Parte acquirente | L'indirizzo dell'entità acquirente di Amazon | L'ID assegnato alla parte acquirente | Non applicabile |
Parte venditrice | Il codice fornitore Amazon assegnato al fornitore | Il codice fornitore Amazon assegnato al fornitore | Il codice fornitore Amazon assegnato al fornitore |
Destinatario spedizione | L'indirizzo dell'entità destinataria della spedizione | L'ID assegnato al destinatario della spedizione | Non applicabile |
Intestatario della fattura | L'indirizzo dell'entità a cui intestare la fattura. | L'indirizzo dell'entità a cui intestare la fattura. | Non applicabile |
submitAcknowledgement
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.
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 indicanorejected
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 codiceaccepted
con la data corrispondente e un altro ciclo di conferma utilizzando il codicebackordered
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à | India | Europa | Nord America |
---|---|---|---|
Data di spedizione programmata | Condizionale. Dipende dai termini di trasporto e dagli attuali accordi commerciali con il fornitore. | Opzionale | Opzionale |
Data di consegna programmata | Condizionale. Dipende dai termini di trasporto e dagli attuali accordi commerciali con il fornitore. | Opzionale | Opzionale |
Prezzo di listino | Necessario solo per i fornitori di libri | Supportato | Necessario 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
ecreatedAfter
) o di aggiornamento (updatedBefore
eupdatedAfter
) insieme apurchaseOrderStatus=OPEN
. -
Puoi usare
getPurchaseOrdersStatus
operazione per filtrare lo stato dei PoS. Ad esempio, seitemConfirmationStatus=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 includendopurchaseOrderStatus=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 increatedBefore
ecreatedAfter
.
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
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
esellingParty.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.
Requisiti aziendali
-
Quando un venditore spedisce articoli venduti a peso, deve fornire il
totalWeight
campo. IltotalWeight
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 includonoPOUNDS
,OUNCES
,GRAMS
, eKILOGRAMS
. -
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
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
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
, esellingParty.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
andFailure
status values for submitted Cancel Shipment requests.
Il diagramma seguente mostra il flusso di lavoro di integrazione durante l'invio delle richieste di spedizione.
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
, esellingParty.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
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.
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
GetShipmentDetails
richiestoTo 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 (
|
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:
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
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.
Requisiti aziendali
- Chiama il
GetShipmentLabels
solo dopo l'assegnazione di un corriere. - If
GetShipmentLabels
does not return a label or returnsResource Not Found
, verify that a carrier has been assigned. Alternatively, you can callGetShipmentDetails
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 (
|
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:
Operazione | Metodo HTTP | Path | Descrizione |
---|---|---|---|
submitInvoices | POST | /vendor/payments/v1/invoices | Invia 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.
Requisiti aziendali
-
Per gli articoli il cui prezzo è calcolato in base al peso, è necessario fornire
totalWeight
campo. IltotalWeight
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 includonoPOUNDS
,OUNCES
,GRAMS
, eKILOGRAMS
. -
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:
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 |
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
submitInvoices
ClasseFattura 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:
.Operazione | Metodo HTTP | Path | Descrizione | |
---|---|---|---|---|
getTransaction | GET | /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 transazione | Definizione |
---|---|
In elaborazione | Amazon 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. |
Successo | This 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 riuscito | La 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 è Processing
e 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."
}
]
}
}
}
Updated 23 days ago