Tutoriel : récupérer un numéro de bon de commande et le transmettre à un transporteur

Utilisez l'API Selling Partner pour récupérer un numéro de bon de commande et le transmettre à UPS, FedEx ou USPS.

Les commandes interentreprises (B2B) incluent généralement des numéros de bon de commande sur les étiquettes d'expédition. Les étiquettes d'expédition que vous récupérez via Seller Central ou à l'aide de l'API Selling Partner incluent automatiquement le numéro de commande.

If you get shipping labels from a source outside of Amazon, the shipping labels might not include the purchase order number. For these cases, you can get the purchase order number by using the Orders API or the Reports API of the Selling Partner API. You then pass the purchase order number to the carrier when you use the carrier's API.

Ces didacticiels montrent comment obtenir le numéro de bon de commande, puis le transmettre à UPS, FedEx et USPS.

Tutoriel : récupérer un numéro de bon de commande à l'aide de l'API Orders

The following tutorial shows how to retrieve a purchase order number by using the Orders API. For this method to work, the isBusinessOrder field of the order must be true.

Étape 1 : Appeler l'opération getOrder

Call the getOrder operation. Include the orderId in the path.

Étape 2 Vérifiez le IsBusinessOrder champ

Dans la réponse, vérifiez si IsBusinessOrder le champ est true. Si le IsBusinessOrder le champ est false ou est absent, la réponse n'inclut pas le numéro de bon de commande.

L'exemple suivant montre une charge utile de réponse qui contient le IsBusinessOrder champ défini sur 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 } }

Étape 3 Obtenir le numéro de bon de commande

Le numéro de commande se trouve dans le PurchaseOrderNumber terrain dans le BuyerInfo objet dans la réponse. Reportez-vous à l'étape précédente pour obtenir un exemple de charge utile de réponse.

Tutoriel : récupérer un numéro de bon de commande à l'aide de l'API Reports

The following tutorial shows how to retrieve a purchase order number by using the Reports API.

Étape 1 : Appeler l'opération createReport

Call the createReport operation. Specify one of the following report types:

  • GET_FLAT_FILE_ORDER_REPORT_DATA_SHIPPING
  • GET_FLAT_FILE_ORDERS_RECONCILIATION_DATA_SHIPPING
  • GET_ORDER_REPORT_DATA_SHIPPING

Étape 2 Vérifiez si le rapport est terminé

Interrogez régulièrement la file d'attente Amazon SQS pour REPORT_PROCESSING_FINISHED événement, qui fournit des informations sur le moment où le traitement du rapport est CANCELLED, DONE, ou FATAL. Si les données du rapport sont disponibles, l'événement inclut une valeur pour reportDocumentId champ.

For details, refer to Verify that Report Processing is Complete.

Étape 3 Télécharger le rapport

Call the getReportDocument operation. Pass in the reportDocumentId value from the previous step.

A successful response includes a url that you can use to download the report. For details, refer to Retrieve a Report.

Étape 2. Télécharger le rapport

Téléchargez le rapport à partir de l'URL que vous avez trouvée à l'étape précédente.

Étape 5 Vérifiez le IsBusinessOrder champ

Dans le rapport, vérifiez si IsBusinessOrder le champ est true. Si le IsBusinessOrder le champ est false ou est absent, le rapport n'inclut pas le numéro de bon de commande.

L'exemple suivant montre un rapport contenant les IsBusinessOrder champ défini sur 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>

Étape 6 Obtenir le numéro de bon de commande

Dans le rapport, le numéro de commande se trouve dans le PurchaseOrderNumber champ. Reportez-vous à l'étape précédente pour obtenir un exemple de charge utile de réponse.

Tutoriel : Transmettre un numéro de bon de commande à un transporteur

Le didacticiel suivant montre comment transmettre le numéro de commande à UPS, FedEx et USPS.

  • UPS: Call the UPS Shipment operation. In the ReferenceNumber array, include an element with Code equal to "PO" and Value equal to the purchase order number.

    Un maximum de cinq numéros de référence par colis est autorisé par envoi et seuls les deux premiers numéros de référence sont imprimés sur l'étiquette.

  • FedEx: Call the FedEx CreateShipment operation. In the requestedShipment object, in the requestedPackageLineItems.customerReferences array, include an element with customerReferenceType equal to "P_O_NUMBER" and value equal to the purchase order number. For a list of customer reference types, refer to Customer Reference Types.

  • USPS: Call the USPS eVS Label API. Use the CustomerRefNo field or the CustomerRefNo2 field to pass the purchase order number. Set the PrintCustomerRefNo field to true.


Cette page vous a-t-elle été utile ?