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
getOrder
Call the getOrder
operation. Include the orderId
in the path.
Étape 2 Vérifiez le IsBusinessOrder
champ
IsBusinessOrder
champDans 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
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
IsBusinessOrder
champDans 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
.
<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 theReferenceNumber
array, include an element withCode
equal to"PO"
andValue
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 therequestedShipment
object, in therequestedPackageLineItems
.customerReferences
array, include an element withcustomerReferenceType
equal to"P_O_NUMBER"
andvalue
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 theCustomerRefNo2
field to pass the purchase order number. Set thePrintCustomerRefNo
field totrue
.
Updated 27 days ago