Ana SayfaBelgelerKod ÖrnekleriAPI BaşvurusuDuyurularModellerSürüm NotlarıSSSGitHubVideolar
Geliştirici MerkeziAPI DurumuDestek
Belgeler
Geliştirici MerkeziAPI DurumuDestek

Eğitim: Bir Satınalma Siparişi Numarasını Alın ve Taşıyıcıya Aktarın

Satınalma emri numarasını almak ve UPS, FedEx veya USPS'ye iletmek için Satış Ortağı API'sini kullanın.

İşletmeler arası (B2B) siparişler genellikle gönderim etiketlerinde satın alma siparişi numaralarını içerir. Satıcı Merkezi aracılığıyla veya Satış Ortağı API'sini kullanarak aldığınız kargo etiketleri otomatik olarak satın alma siparişi numarasını içerir.

Kargo etiketleri Amazon dışındaki bir kaynaktan alırsanız kargo etiketleri satın alma siparişi numarasını içermeyebilir. Bu durumlarda, satınalma siparişi numarasını kullanarak alabilirsiniz Siparişler API'si ya da Rapor API'si Satış Ortağı API'sinin. Ardından, operatörün API'sini kullandığınızda satın alma siparişi numarasını taşıyıcıya iletirsiniz.

Bu eğitimler, satınalma siparişi numarasının nasıl alınacağını ve ardından satın alma emri numarasının UPS, FedEx ve USPS'ye nasıl iletileceğini gösterir.

Eğitim: Siparişler API'sini kullanarak bir satınalma siparişi numarası alma

Aşağıdaki eğitim, aşağıdakileri kullanarak bir satınalma siparişi numarasının nasıl alınacağını gösterir. Siparişler API'si. Bu yöntemin işe yaraması için, isBusinessOrder Siparişin alanı olmalıdır true.

1. Adım: getOrder işlemini çağırın

Arayın getOrder operasyon. Dahil et orderId yolda.

Adım 2. Kontrol edin IsBusinessOrder tarla

Yanıtta, olup olmadığını kontrol edin IsBusinessOrder alan true. Eğer IsBusinessOrder alan false veya yok, yanıt satınalma siparişi numarasını içermiyor.

Aşağıdaki örnek, aşağıdakileri içeren bir yanıt yükünü gösterir IsBusinessOrder alan olarak ayarlandı 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 } }

Adım 3. Satınalma siparişi numarasını alın

Satınalma siparişi numarası şurada yer almaktadır. PurchaseOrderNumber alan içinde BuyerInfo Cevaptaki nesne. Örnek yanıt yükü için önceki adıma bakın.

Eğitim: Raporlar API'sini kullanarak bir satınalma siparişi numarasını alma

Aşağıdaki eğitim, aşağıdakileri kullanarak bir satınalma siparişi numarasının nasıl alınacağını gösterir. Rapor API'si.

1. Adım: createReport işlemini çağırın

Arayın createReport operasyon. Aşağıdaki rapor türlerinden birini belirtin:

  • GET_FLAT_FILE_ORDER_REPORT_DATA_SHIPPING
  • GET_FLAT_FILE_ORDERS_RECONCILIATION_DATA_SHIPPING
  • GET_ORDER_REPORT_DATA_SHIPPING

Adım 2. Raporun tamamlanıp bitmediğini kontrol edin

Amazon SQS kuyruğunu periyodik olarak anket yapın REPORT_PROCESSING_FINISHED rapor işleme sırasında bilgi sağlayan olay CANCELLED, DONE, veya FATAL. Rapor verileri mevcutsa, olay için bir değer içerir. reportDocumentId alan.

Ayrıntılar için bkz. Rapor İşlemenin Tamamlandığını Doğrulayın.

Adım 3. Raporu alın

Arayın getReportDocument operasyon. İçeri geç reportDocumentId önceki adımdaki değer.

Başarılı bir yanıt şunları içerir: url Raporu indirmek için kullanabileceğiniz. Ayrıntılar için bkz. Rapor Alma.

2. Adım: Raporu indirin

Raporu önceki adımda bulduğunuz url'den indirin.

Adım 5. Kontrol edin IsBusinessOrder tarla

Raporda, olup olmadığını kontrol edin IsBusinessOrder alan true. Eğer IsBusinessOrder alan false veya mevcut değilse, rapor satınalma siparişi numarasını içermez.

Aşağıdaki örnek, aşağıdakileri içeren bir raporu gösterir: IsBusinessOrder alan olarak ayarlandı 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>

Adım 6. Satınalma siparişi numarasını alın

Raporda, satınalma siparişi numarası şurada yer almaktadır. PurchaseOrderNumber alan. Örnek yanıt yükü için önceki adıma bakın.

Eğitim: Bir satınalma siparişi numarasını taşıyıcıya iletme

Aşağıdaki eğitim, satın alma siparişi numarasının UPS, FedEx ve USPS'ye nasıl iletileceğini gösterir.

  • UPS: UPS'i arayın Shipment operasyon. İçinde ReferenceNumber dizi, bir öğe dahil et Code eşit "PO" ve Value satınalma emri numarasına eşittir.

    Gönderi başına izin verilen maksimum beş paket düzeyinde referans numarası vardır ve etikette yalnızca ilk iki referans numarası yazdırılır.

  • FedEx: FedEx'i arayın CreateShipment operasyon. İçinde requestedShipment nesne, içinde requestedPackageLineItems.customerReferences dizi, bir öğe dahil et customerReferenceType eşit "P_O_NUMBER" ve value satınalma emri numarasına eşittir. Müşteri referans türlerinin listesi için bkz. Müşteri Referans Türleri.

  • USPS: USPS'yi arayın EVs Etiketi APİ. Kullan CustomerRefNo alan veya CustomerRefNo2 satınalma emri numarasını iletmek için alan. Ayarla PrintCustomerRefNo alan için true.


Bu sayfa size yardımcı oldu mu?