Tutorial: Recupera e passa un numero d'ordine di acquisto a un corriere
Utilizza l'API Selling Partner per recuperare e trasmettere il numero dell'ordine di acquisto a UPS, FedEx o USPS.
Gli ordini Business-to-Business (B2B) in genere includono i numeri degli ordini di acquisto sulle etichette di spedizione. Le etichette di spedizione recuperate tramite Seller Central o utilizzando l'API Selling Partner includono automaticamente il numero dell'ordine di acquisto.
Se ricevi etichette di spedizione da una fonte esterna ad Amazon, le etichette di spedizione potrebbero non includere il numero dell'ordine di acquisto. In questi casi, puoi ottenere il numero dell'ordine di acquisto utilizzando API per gli ordini o il API per i report dell'API Selling Partner. Quindi trasmetti il numero dell'ordine di acquisto al corriere quando utilizzi l'API del corriere.
Questi tutorial mostrano come ottenere il numero dell'ordine di acquisto e quindi passare il numero dell'ordine di acquisto a UPS, FedEx e USPS.
Tutorial: Recupera il numero di un ordine di acquisto utilizzando l'API Orders
Il seguente tutorial mostra come recuperare un numero d'ordine di acquisto utilizzando il API per gli ordini. Affinché questo metodo funzioni, isBusinessOrder
il campo dell'ordine deve essere true
.
Passaggio 1. Chiama l'operazione getOrder
getOrder
Chiama il getOrder
operazione. Includi il orderId
nel percorso.
Fase 2 Controlla il IsBusinessOrder
campo
IsBusinessOrder
campoNella risposta, controlla se IsBusinessOrder
il campo è true
. Se il IsBusinessOrder
il campo è false
o è assente, la risposta non include il numero dell'ordine di acquisto.
L'esempio seguente mostra un payload di risposta che contiene IsBusinessOrder
campo impostato su true
.
"payload": {
"AmazonOrderId": "902-3159896-1390916",
"PurchaseDate": "2017-01-20T19:49:35Z",
"LastUpdateDate": "2017-01-20T19:49:35Z",
"OrderStatus": "Pending",
"FulfillmentChannel": "SellerFulfilled",
"NumberOfItemsShipped": 0,
"NumberOfItemsUnshipped": 0,
"PaymentMethod": "Other",
"PaymentMethodDetails": [
"CreditCard"
],
"MarketplaceId": "ATVPDKIKX0DER",
"ShipmentServiceLevelCategory": "Standard",
"OrderType": "StandardOrder",
"EarliestShipDate": "2017-01-20T19:51:16Z",
"LatestShipDate": "2017-01-25T19:49:35Z",
"IsBusinessOrder": true,
"IsPrime": false,
"IsGlobalExpressEnabled": false,
"IsPremiumOrder": false,
"IsSoldByAB": false,
"IsIBA": false,
"DefaultShipFromLocationAddress": {
"Name": "TestMerchant",
"AddressLine1": "2201 WESTLAKE AVE",
"City": "SEATTLE",
"StateOrRegion": "WA",
"PostalCode": "98121-2778",
"CountryCode": "US",
"Phone": "+1 234-567-8910",
"AddressType": "Commercial"
},
"FulfillmentInstruction": {
"FulfillmentSupplySourceId": "sampleSupplySourceId"
},
"IsISPU": false,
"IsAccessPointOrder": false,
"ShippingAddress": {
"Name": "Michigan address",
"AddressLine1": "1 Main Street",
"City": "Canton",
"StateOrRegion": "MI",
"PostalCode": "48817",
"CountryCode": "US"
},
"BuyerInfo": {
"BuyerEmail": "user@example.com",
"BuyerName": "John Doe",
"BuyerTaxInfo": {
"CompanyLegalName": "A Company Name"
},
"PurchaseOrderNumber": "1234567890123"
},
"AutomatedShippingSettings": {
"HasAutomatedShippingSettings": false
}
}
Fase 3 Ottieni il numero dell'ordine di acquisto
Il numero dell'ordine di acquisto è indicato in PurchaseOrderNumber
campo nel BuyerInfo
oggetto nella risposta. Fai riferimento al passaggio precedente per un esempio di payload di risposta.
Tutorial: Recupera il numero di un ordine di acquisto utilizzando l'API Reports
Il seguente tutorial mostra come recuperare un numero d'ordine di acquisto utilizzando il API per i report.
Passaggio 1. Chiama l'operazione createReport
createReport
Chiama il createReport
operazione. Specificare uno dei seguenti tipi di report:
GET_FLAT_FILE_ORDER_REPORT_DATA_SHIPPING
GET_FLAT_FILE_ORDERS_RECONCILIATION_DATA_SHIPPING
GET_ORDER_REPORT_DATA_SHIPPING
Fase 2 Verificare se il rapporto è terminato
Esegui periodicamente il polling della coda di Amazon SQS per REPORT_PROCESSING_FINISHED
evento, che fornisce informazioni quando è in corso l'elaborazione del report CANCELLED
, DONE
, oppure FATAL
. Se i dati del rapporto sono disponibili, l'evento include un valore per reportDocumentId
campo.
Per ulteriori informazioni, fare riferimento a Verifica che l'elaborazione del rapporto sia completa.
Fase 3 Scarica il rapporto
Chiama il getReportDocument
operazione. Passa nel reportDocumentId
valore del passaggio precedente.
Una risposta efficace include un url
che puoi usare per scaricare il rapporto. Per informazioni dettagliate, fare riferimento a Recupera un rapporto.
Passaggio 2. Scarica il report
Scarica il rapporto dall'URL che hai trovato nel passaggio precedente.
Fase 5 Controlla il IsBusinessOrder
campo
IsBusinessOrder
campoNel rapporto, controlla se IsBusinessOrder
il campo è true
. Se il IsBusinessOrder
il campo è false
o è assente, il rapporto non include il numero dell'ordine di acquisto.
L'esempio seguente mostra un rapporto che contiene IsBusinessOrder
campo impostato su true
.
<AmazonEnvelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="amzn-envelope.xsd">
<Header>
<DocumentVersion>1.01</DocumentVersion>
<MerchantIdentifier>A3912FIWOIVW91</MerchantIdentifier>
</Header>
<MessageType>OrderReport</MessageType>
<Message>
<MessageID>1</MessageID>
<OrderReport>
<AmazonOrderID>123-4567-8910</AmazonOrderID>
<AmazonSessionID>12-13141516-171819</AmazonSessionID>
<OrderDate>2024-03-18T16:59:49-07:00</OrderDate>
<OrderPostedDate>2024-03-18T16:59:49-07:00</OrderPostedDate>
<BillingData>
<BuyerEmailAddress>7f032r5qjxxxxxx@marketplace.amazon.com</BuyerEmailAddress>
<BuyerName>John Doe</BuyerName>
<BuyerPhoneNumber>123-456-7891</BuyerPhoneNumber>
</BillingData>
<FulfillmentData>
<FulfillmentMethod>Ship</FulfillmentMethod>
<FulfillmentServiceLevel>Standard</FulfillmentServiceLevel>
<Address>
<Name>Denise Park</Name>
<AddressFieldOne>1 Main Street</AddressFieldOne>
<City>Bellevue</City>
<StateOrRegion>WI</StateOrRegion>
<PostalCode>53189-6553</PostalCode>
<CountryCode>US</CountryCode>
<PhoneNumber>+1 123-456-7891</PhoneNumber>
</Address>
</FulfillmentData>
<IsBusinessOrder>true</IsBusinessOrder>
<PurchaseOrderNumber>PO12345</PurchaseOrderNumber>
<Item>
<AmazonOrderItemCode>123456789</AmazonOrderItemCode>
<SKU>12-3456-789</SKU>
<Title>Marshmallows</Title>
<Quantity>2</Quantity>
<ProductTaxCode>A1_FB_CANDY17</ProductTaxCode>
<ItemPrice>
<Component>
<Type>Principal</Type>
<Amount currency="USD">20.90</Amount>
</Component>
<Component>
<Type>Shipping</Type>
<Amount currency="USD">0.00</Amount>
</Component>
<Component>
<Type>Tax</Type>
<Amount currency="USD">1.04</Amount>
</Component>
<Component>
<Type>ShippingTax</Type>
<Amount currency="USD">0.00</Amount>
</Component>
</ItemPrice>
<ItemFees>
<Fee>
<Type>Commission</Type>
<Amount currency="USD">-1.68</Amount>
</Fee>
</ItemFees>
<SignatureConfirmationRecommended>false</SignatureConfirmationRecommended>
</Item>
</OrderReport>
</Message>
Fase 6. Ottieni il numero dell'ordine di acquisto
Nel report, il numero dell'ordine di acquisto è indicato in PurchaseOrderNumber
campo. Fai riferimento al passaggio precedente per un esempio di payload di risposta.
Tutorial: Trasmetti il numero dell'ordine di acquisto a un corriere
Il seguente tutorial mostra come passare il numero dell'ordine di acquisto a UPS, FedEx e USPS.
-
UPS: Chiama l'UPS
Shipment
operazione. NelReferenceNumber
matrice, includi un elemento conCode
pari a"PO"
eValue
uguale al numero dell'ordine di acquisto.Sono consentiti un massimo di cinque numeri di riferimento a livello di pacco per spedizione e solo i primi due numeri di riferimento sono stampati sull'etichetta.
-
FedEx: Chiama la FedEx
CreateShipment
operazione. NelrequestedShipment
oggetto, nelrequestedPackageLineItems
.customerReferences
matrice, includi un elemento concustomerReferenceType
pari a"P_O_NUMBER"
evalue
uguale al numero dell'ordine di acquisto. Per un elenco dei tipi di riferimento dei clienti, consulta Tipi di referenze dei clienti. -
USPS: Chiama l'USPS Etichetta eVs API. Usa il
CustomerRefNo
campo oCustomerRefNo2
campo per inserire il numero dell'ordine di acquisto. Imposta ilPrintCustomerRefNo
campo atrue
.
Updated 27 days ago