Knowband Blog | Ecommerce Modules

How to get Amazon Orders using API

Objectif du blog

Après avoir lu ce blog, vous serez en mesure de comprendre comment le vendeur peut obtenir les commandes Amazon à l’aide de l’API.

Connaissons l'API de la commande

L'API des commandes Amazon aide les vendeurs à obtenir les détails de la commande et à synchroniser les commandes Amazon sur leur application personnalisée. Ceci est très utile pour récupérer les mises à jour des commandes en temps réel et les vendeurs peuvent également obtenir facilement les informations sur le statut des commandes (expédiées ou non expédiées) pour toutes les commandes à l'aide de l'API.

Comment synchroniser les commandes Amazon sur une application personnalisée

Tout d'abord, vous avez besoin des informations d'identification de l'API Amazon MWS (Market Place Web Service). Si vous n'en avez toujours pas, vous pouvez obtenir l'aide de ce blog

Pour récupérer des commandes Amazon chez vous, vous devez suivre les étapes ci-dessous:

1. Liste des commandes – Dans cette étape, vous devez envoyer une demande à Amazon pour obtenir les commandes d'Amazon pour un intervalle de temps particulier. Vous devez envoyer les données suivantes indiquées ci-dessous dans la demande:

mws.amazonservices.co.uk/Orders/2013-09-01? AWSAccessKeyId = XXXXXXXXXXXXX & Action = ListOrders & SellerId = XXXXXXXXXXXX // Écrivez ici votre identifiant marchand et SignatureVersion = 2 // écrivez ici votre signature & timestamp : i: s \ Z ", time ()) // Écrivez l'horodatage & Version = 2013-09-01 & Signature = 1234Knowband1234example1234 // Ici, vous devez écrire la signature & SignatureMethod = HmacSHA256 // Écrivez ici votre méthode de signature & LastUpdatedAfter = date ("Ymd \ TH: i: s \ Z", strtotime ('- heure 24')); // demande à Amazon & OrderStatus.Status.24 = Non expédié // d'obtenir les commandes pour les dernières heures 1 uniquement. Vous devez ici ajouter le statut pour lequel vous souhaitez récupérer les commandes & OrderStatus.Status.2 = PartiallyShipped & OrderStatus.Status.3 = Expédié & MarketplaceId.Id.1 = XXXXXXXXXXXXX AWSAccessKeyId = XXXXXXXXXXXXXXXXXXXX

Dans la réponse, vous obtiendrez un fichier de flux de commandes contenant la liste des commandes passées sur Amazon au cours des dernières heures 24 et indiquant le statut de commande demandé. Voici l'exemple de fichier de flux de commandes.

<?xml version="1.0"?>
<ListOrdersResponse xmlns="https://mws.amazonservices.com/Orders/2013-09-01">
    <ListOrdersResult>
        <Orders>
            <Order>
                <LatestShipDate>2018-03-09T07:59:59Z</LatestShipDate>
                <OrderType>StandardOrder</OrderType>
                <PurchaseDate>2018-03-07T01:15:57Z</PurchaseDate>
                <AmazonOrderId>112-5028700-7051869</AmazonOrderId>
                <BuyerEmail>knowband@marketplace.amazon.com</BuyerEmail>
                <IsReplacementOrder>false</IsReplacementOrder>
                <LastUpdateDate>2018-03-07T10:05:30Z</LastUpdateDate>
                <NumberOfItemsShipped>1</NumberOfItemsShipped>
                <ShipServiceLevel>Std US D2D Intl</ShipServiceLevel>
                <OrderStatus>Shipped</OrderStatus>
                <SalesChannel>Amazon.com</SalesChannel>
                <ShippedByAmazonTFM>false</ShippedByAmazonTFM>
                <IsBusinessOrder>false</IsBusinessOrder>
                <LatestDeliveryDate>2018-04-06T06:59:59Z</LatestDeliveryDate>
                <NumberOfItemsUnshipped>0</NumberOfItemsUnshipped>
                <PaymentMethodDetails>
                    <PaymentMethodDetail>Standard</PaymentMethodDetail>
                </PaymentMethodDetails>
                <BuyerName>George</BuyerName>
                <EarliestDeliveryDate>2018-03-21T07:00:00Z</EarliestDeliveryDate>
                <OrderTotal>
                    <CurrencyCode>USD</CurrencyCode>
                    <Amount>49.44</Amount>
                </OrderTotal>
                <IsPremiumOrder>false</IsPremiumOrder>
                <EarliestShipDate>2018-03-07T08:00:00Z</EarliestShipDate>
                <MarketplaceId>ATVPDKIKX0DER</MarketplaceId>
                <FulfillmentChannel>MFN</FulfillmentChannel>
                <PaymentMethod>Other</PaymentMethod>
                <ShippingAddress>
                    <City>Hong Kong</City>
                    <Phone>XXXXXXXXXX</Phone>
                    <CountryCode>HK</CountryCode>
                    <Name>Khattak Muhammad S.B</Name>
                    <AddressLine1>D, Block 2, Example </AddressLine1>
                    <AddressLine2>H Address Example</AddressLine2>
                </ShippingAddress>
                <IsPrime>false</IsPrime>
                <ShipmentServiceLevelCategory>Standard</ShipmentServiceLevelCategory>
        </Order>
        <Order>
            <LatestShipDate>2018-03-09T07:59:59Z</LatestShipDate>
            <OrderType>StandardOrder</OrderType>
            <PurchaseDate>2018-03-06T20:23:38Z</PurchaseDate>
            <AmazonOrderId>114-8648933-7253863</AmazonOrderId>
            <BuyerEmail>knowband1@marketplace.amazon.com</BuyerEmail>
            <IsReplacementOrder>false</IsReplacementOrder>
            <LastUpdateDate>2018-03-07T10:05:31Z</LastUpdateDate>
            <NumberOfItemsShipped>2</NumberOfItemsShipped>
            <ShipServiceLevel>Std US D2D Dom</ShipServiceLevel>
            <OrderStatus>Shipped</OrderStatus>
            <SalesChannel>Amazon.com</SalesChannel>
            <ShippedByAmazonTFM>false</ShippedByAmazonTFM>
            <IsBusinessOrder>false</IsBusinessOrder>
            <LatestDeliveryDate>2018-04-06T06:59:59Z</LatestDeliveryDate>
            <NumberOfItemsUnshipped>0</NumberOfItemsUnshipped>
            <PaymentMethodDetails>
                <PaymentMethodDetail>Standard</PaymentMethodDetail>
            </PaymentMethodDetails>
            <BuyerName>George</BuyerName>
            <EarliestDeliveryDate>2018-03-21T07:00:00Z</EarliestDeliveryDate>
            <OrderTotal>
            <CurrencyCode>USD</CurrencyCode>
            <Amount>98.87</Amount>
            </OrderTotal>
            <IsPremiumOrder>false</IsPremiumOrder>
            <EarliestShipDate>2018-03-07T08:00:00Z</EarliestShipDate>
            <MarketplaceId>ATVPDKIKX0DER</MarketplaceId>
            <FulfillmentChannel>MFN</FulfillmentChannel>
            <PaymentMethod>Other</PaymentMethod>
            <ShippingAddress>
                <City>Hobe Sound</City>
                <AddressType>Residential</AddressType>
                <PostalCode>2101</PostalCode>
                <StateOrRegion>FL</StateOrRegion>
                <Phone>XXXXXXXXXX</Phone>
                <CountryCode>US</CountryCode>
                <Name> SMITH</Name>
                <AddressLine1>Knowband </AddressLine1>
            </ShippingAddress>
            <IsPrime>false</IsPrime>
            <ShipmentServiceLevelCategory>Standard</ShipmentServiceLevelCategory>
        </Order>
        <LastUpdatedBefore>2018-03-08T06:58:45Z</LastUpdatedBefore>
    </ListOrdersResult>
    <ResponseMetadata>
    <RequestId>7fc9364b-a296-4380-954d-1b0355b9ccea</RequestId>
    </ResponseMetadata>
</ListOrdersResponse>

2. Liste des articles de commande Dès la première étape, vous obtiendrez uniquement les détails de la commande (comme l'identifiant de commande Amazon, la date d'achat, etc.) et non les détails de l'article commandé (détail du produit commandé). Pour obtenir les détails de l'article de la commande, vous devez envoyer une demande distincte à Amazon. Vous devez envoyer une demande correspondant à chaque commande. Si vous avez besoin de détails sur les commandes 5 Amazon, vous devrez envoyer des demandes 5. La demande est donnée ci-dessous: par exemple $ Amazon_order_id = 112-5028700-7051869

mws.amazonservices.co.uk/Orders/2013-09-01? AWSAccessKeyId = XXXXXXXXXXXXXXXXXX & Action = ListOrderItems & SellerId = 'XXXXXXXXXXXXXX'; // écrivez ici votre identifiant de marchand, & 'AmazonOrderId' = $ Amazon_order_id // écrivez ici l'identifiant de la commande dont vous souhaitez obtenir les détails // vous devez écrire la signature, lorsque vous envoyez des demandes HTTP à AWS, vous devez signez les demandes afin qu'AWS puisse identifier qui a envoyé la demande & Signature = 1234KnowbandXNumXexample1234 & SignatureVersion = 1234 // Ecrivez ici votre version de signature & SignatureMethod = HmacSHA2 // Ecrivez ici votre méthode de signature & Timestamp = gmdate ("Ymd \ TH: i \ s" Z " , time ()) // Ecrit l'horodatage & Version = 256-2013-09

En réponse à la demande, vous obtiendrez le détail descriptif de la commande. L'échantillon est donné ci-dessous:

mws.amazonservices.co.uk/Orders/2013-09-01 <? xml version = "1.0"?> <ListOrderItemsResponse xmlns = "https://mws.amazonservices.com/Orders/2013-09-01-1-quot;>> ListOrderItemsResult> <OrderItems> <OrderItem> <QuantityOrdered> 2017 </ QuantityOrdered> <Title> Troisième short Manchester United pour enfants 18 / 0.00 </ Titre> <ShippingTax> <CodeVers> USD </ CodeVers> <Amount> 0.00 </ Amount> </ ShippingTax> <PromotionDiscount> <CurrencyCode> USD </ CurrencyCode> <Montant> 072 </ Montant> </ PromotionDiscount> <ConditionId> Nouveau </ ConditionId> <IsGift> false </ IsGift> <ASIN> B7XXUMX </ ASIN > <SellerSKU> x-69-96909 </ SellerSKU> <OrderItemId> 266 </ OrderItemId> <ProductInfo> <NumberOfItems> 22621871528658 </ NumberOfItems> </ ProductInfo> <GiftWrapTax> <CurrencyCode> USD 1 </ Amount> </ GiftWrapTax> <QuantityShipped> 0.00 </ QuantityShipped> <ShippingPrice> <CurrencyCode> USD </ CurrencyCode> <Amount> 0 </ Quantité> </ ShippingPrice> <GiftWrapPrice> <CodeCon> <CodeCon> > <Montant> XNU MX </ Amount> </ GiftWrapPrice> <ConditionSubtypeId> Nouveau </ ConditionSubtypeId> <ItemPrice> <CurrencyCode> USD </ CurrencyCode> <Amount> 19.95 </ Amount> </ ItemPrice> <ItemTax> > <Montant> 0.00 </ Montant> </ ItemTax> <ShippingDiscount> <CurrencyCode> USD </ CurrencyCode> <Montant> 29.49 </ Amount> </ ShippingDiscount> </ OrderItem> </ OrderItems> <AmazonOrderId> 0.00-0.00 Vous ne connaissez pas le type de fichier.

3. Créer des commandes Cette étape est la dernière étape et à partir de l'étape 1 & 2, vous obtenez tous les détails des commandes Amazon dont vous avez besoin pour créer des commandes sur votre application. En analysant les flux XML ci-dessus (ordre de liste et poste de commande de liste), vous pouvez créer des commandes dans votre application. Si une commande Amazon est déjà créée sur votre application, vous pouvez utiliser l'étape 1 pour mettre à jour le statut de la commande de cette commande.