Objetivo do blog
Depois de ler este blog, você será capaz de entender como o vendedor pode obter os pedidos da Amazon usando a API.
Vamos conhecer a API do pedido
A API de pedidos da Amazon ajuda os vendedores a obter os detalhes do pedido e sincronizar os pedidos da Amazon em seu aplicativo personalizado. Isso é muito útil para recuperar atualizações de pedidos em tempo real e os vendedores também podem obter as informações de status do pedido (enviadas ou não) com facilidade para todos os pedidos usando a API.
Como sincronizar pedidos da Amazon em aplicativos personalizados
Primeiro de tudo, você precisa da credencial da API do Amazon MWS (Market Place Web Service). Se você ainda não possui, pode obter a ajuda de este blog
Para buscar pedidos da Amazon do seu lado, siga as etapas abaixo:
1. Pedidos de lista – Nesta etapa, você precisa enviar uma solicitação à Amazon para obter os pedidos da Amazon por um intervalo de tempo específico. Você precisa enviar os seguintes dados fornecidos abaixo na solicitação:
mws.amazonservices.co.uk/Orders/2013-09-01? AWSAccessKeyId = XXXXXXXXXXXXXXX & Action = ListOrders & SellerId = XXXXXXXXXXXXXX // // Escreva aqui o seu ID de comerciante & SignatureVersion = 2 // Escreva aqui a sua versão de assinatura & Timestamp = gmdate : i: s \ Z ", time ()) // Escreva o carimbo do tempo & Version = 2013-09-01 & Signature = 1234Knowband1234example1234 // Aqui você precisa escrever a assinatura & SignatureMethod = HmacSHA256 // Aqui, escreva seu método de assinatura & LastUpdatedAfter = date ("Ymd \ TH: i: s \ Z", horário ('- 24 hora')); // solicita a obtenção de pedidos somente para as últimas horas 24 da Amazon & OrderStatus.Status.1 = Não enviado // Aqui você precisa adicionar o status para o qual deseja buscar os pedidos & OrderStatus.Status.2 = Parcialmente enviado e OrderStatus.Status.3 = Enviado e MarketplaceId.Id.1 = XXXXXXXXXXXXX AWSAccessKeyId = XXXXXXXXXXXXXXXXXXXXXX
Na resposta, você receberá um arquivo de feed de pedidos que conterá a lista de pedidos feitos na Amazon nas últimas horas 24 e com o status de pedido solicitado. Aqui está o arquivo de feed de pedidos de amostra.
<?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. Itens do pedido de lista Desde o primeiro passo, você obterá apenas detalhes do pedido (como ID de pedidos da Amazon, data da compra, etc.) e não detalhes do item do pedido (detalhes do produto solicitado). Para obter os detalhes do item do pedido, você precisará enviar uma solicitação à Amazon. Você precisa enviar uma solicitação correspondente a cada pedido. Se você precisar de detalhes para pedidos da 5 Amazon, precisará enviar solicitações da 5. A solicitação é fornecida abaixo: por exemplo, $ Amazon_order_id = 112-5028700-7051869
mws.amazonservices.co.uk/Orders/2013-09-01? AWSAccessKeyId = XXXXXXXXXXXXXXXXXXXXXX & Action = ListOrderItems & SellerId = 'XXXXXXXXXXXXXX'; // Aqui, escreva seu ID de comerciante, & 'AmazonOrderId' = $ Amazon_order_id // Aqui, escreva o ID do pedido do qual você deseja obter detalhes // Aqui, você precisa escrever a assinatura, quando enviar solicitações HTTP para a AWS, precisará assine as solicitações para que a AWS possa identificar quem enviou a solicitação & Signature = 1234Knowband1234example1234 & SignatureVersion = 2 // Aqui, escreva sua versão de assinatura & SignatureMethod = HmacSHA256 // Aqui, escreva seu método de assinatura & Timestamp = gmdate ("Ymd \ TH: i: s \ Z" , time ()) // Escreva o registro de data e hora = 2013-09-01
Em resposta à solicitação, você obterá os detalhes descritivos do pedido. A amostra é dada abaixo:
mws.amazonservices.co.uk/Orders/2013-09-01 <? xml version = "1.0"?> <ListOrderItemsResponse xmlns = "https://mws.amazonservices.com/Orders/2013-09-01"> < ListOrderItemsResult> <OrderItems> <OrderItem> <QuantityOrdered> 1 </QuantityOrdered> <Title> Manchester United Kids Third Shorts 2017 / 18 </Title> <ShippingTax> <CurrencyCode> USD </CurrencyCode> <Amount> 0.00 </Amount </ShippingTax> <PromotionDiscount> <CurrencyCode> USD </CurrencyCode> <Amount> 0.00 </Amount> </PromotionDiscount> <ConditionId> Novo </ConditionId> <IsGift> false </IsGift> <ASIN> B072N7QVXNUM > <SellerSKU> x-69-96909 </SellerSKU> <OrderItemId> 266 </OrderItemId> <ProductInfo> <NumberOfItems> 22621871528658 </NumberOfItems> </ProductInfo> <GiftWrapTax> <CurrencyCode> USD </CurrencyCode> USD </CurrencyCode> 1 </Amount> </GiftWrapTax> <QuantityShipped> 0.00 </QuantityShipped> <ShippingPrice> <CurrencyCode> USD </CurrencyCode> <Amount> 0 </Amount> </ShippingPrice> <GiftWrapPrice> <CurrencyCode> USD </ CurrencyCode> > <Montante> XNU MX </Amount> </GiftWrapPrice> <ConditionSubtypeId> Novo </ConditionSubtypeId> <ItemPrice> <CurrencyCode> USD </CurrencyCode> <Amount> 19.95 </Amount> </ItemPrice> <ItemTax> <CurrencyCode> USD </ CurrencyCode > <Amount> 0.00 </Amount> </ItemTax> <ShippingDiscount> <CurrencyCode> USD </CurrencyCode> <Amount> 29.49 </Amount> </ShippingDiscount> </OrderItem> </OrderItems> <AmazonOrderId> 0.00-0.00 -112XXX </AmazonOrderId> </ListOrderItemsResult> <ResponseMetadata> <RequestId> 5028700b7d7c-cce5-934e7-ab45-d6da99cesponse </RequestId>
3. Criar pedidos Esta etapa é a etapa final e, na etapa 1 e 2, você obtém todos os detalhes dos pedidos da Amazon necessários para criar pedidos no seu aplicativo. Analisando os feeds XML acima (pedido de lista e item de pedido de lista), você pode criar pedidos no seu aplicativo. Se um pedido da Amazon já estiver criado no seu aplicativo, você poderá usar a etapa 1 para atualizar o status do pedido.
