Hub per sviluppatoriStato dell'APISupporto

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

Chiama il getOrder operazione. Includi il orderId nel percorso.

Fase 2 Controlla il IsBusinessOrder campo

Nella 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

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

Nel 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.

<?xml version="1.0" encoding="UTF-8"?> <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. Nel ReferenceNumber matrice, includi un elemento con Code pari a "PO" e Value 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. Nel requestedShipment oggetto, nel requestedPackageLineItems.customerReferences matrice, includi un elemento con customerReferenceType pari a "P_O_NUMBER" e value 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 o CustomerRefNo2 campo per inserire il numero dell'ordine di acquisto. Imposta il PrintCustomerRefNo campo a true.


Questa pagina ti è stata utile?