Amazon Services
Amazon Marketplace Web Service (Amazon MWS) Documentation

Deprecation Notice:

Amazon Marketplace Web Service (MWS) will no longer be available after March 31, 2024. All MWS developers must migrate to Selling Partner API (SP-API) to avoid service disruptions. Refer to the Migration Hub for more information.

Amazon MWS Documentation

GetFulfillmentOrder

Returns a fulfillment order based on a specified SellerFulfillmentOrderId.

Description

The GetFulfillmentOrder operation returns a fulfillment order based on a SellerFulfillmentOrderId that you specify. This operation returns general fulfillment order information as well as item-level and shipment-level information. You can also use this operation to get information about fulfillment returns. See CreateFulfillmentReturn.

Availability

This operation is available in all marketplaces except Brazil.

Throttling

The GetFulfillmentOrder operation has a maximum request quota of 30 and a restore rate of two requests every second. For definitions of throttling terminology and for a complete explanation of throttling, see Throttling: Limits to how often you can submit requests in the Amazon MWS Developer Guide.

Request parameters

Name Description Required Values
SellerFulfillmentOrderId A fulfillment order identifier that was assigned by the seller with a previous call to the CreateFulfillmentOrder operation. Yes Maximum: 40 characters

Type: xs:string

Response elements

Name Description
FulfillmentOrder General fulfillment order information, including order status.

Type: FulfillmentOrder

FulfillmentOrderItem Item-level fulfillment order information.

Type: List of FulfillmentOrderItem

FulfillmentShipment Shipment-level fulfillment order information.

Type: List of FulfillmentShipment

ReturnItemList A list of items that Amazon accepted for return. Returns empty if no items were accepted for return.

Type: List of ReturnItem

ReturnAuthorizationList A list of return authorizations.

Type: List of ReturnAuthorization

Examples

Example query request

For information about standard request requirements, see Required request parameters.

Show example code Hide example code

http://mws.amazonservices.jp/FulfillmentOutboundShipment/2010-10-01/   
  ?Action=GetFulfillmentOrder   
  &Version=2010-10-01   
  &AWSAccessKeyId=AKIAJGUEXAMPLEE2NVUA   
  &MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE   
  &SignatureVersion=2   
  &SignatureMethod=HmacSHA256   
  &Signature=ZRA9DR5rveSuz%2F1D18AHvoipg2BAev8yblPQ1BbEbfU%3D   
  &Timestamp=2016-09-29T02:40:36Z   
  &SellerId=A2NKEXAMPLEF53   
  &SellerFulfillmentOrderId=extern_id_1154539615776

↑ Top

Example response

For information about standard response formatting, see Response format.

Show example code Hide example code

<?xml version="1.0" encoding="UTF-8"?>
<GetFulfillmentOrderResponse
  xmlns="http://mws.amazonaws.com/FulfillmentOutboundShipment/2010-10-01/">
  <GetFulfillmentOrderResult>
    <FulfillmentOrderItem>
      <member>
        <SellerSKU>SKU100</SellerSKU>
        <GiftMessage>giftwrap_message</GiftMessage>
        <SellerFulfillmentOrderItemId>merchant_order_item_id_2
          </SellerFulfillmentOrderItemId>
        <EstimatedShipDateTime>2016-09-03T07:07:53Z</EstimatedShipDateTime>
        <DisplayableComment>Example comment</DisplayableComment>
        <UnfulfillableQuantity>0</UnfulfillableQuantity>
        <CancelledQuantity>1</CancelledQuantity>
        <Quantity>5</Quantity>
        <EstimatedArrivalDateTime>2016-09-05T08:07:53Z
          </EstimatedArrivalDateTime>
        <PerUnitPrice>
          <CurrencyCode>JPY</CurrencyCode>
          <Value>2500</Value>
        </PerUnitPrice>
        <PerUnitTax>
          <CurrencyCode>JPY</CurrencyCode>
          <Value>5000</Value>
        </PerUnitTax>
      </member>
      <member>
        <SellerSKU>SKU101</SellerSKU>
        <GiftMessage>giftwrap_message</GiftMessage>
        <SellerFulfillmentOrderItemId>merchant_order_item_id_1
          </SellerFulfillmentOrderItemId>
        <EstimatedShipDateTime>2016-09-03T07:07:53Z</EstimatedShipDateTime>
        <DisplayableComment>Example comment</DisplayableComment>
        <UnfulfillableQuantity>2</UnfulfillableQuantity>
        <CancelledQuantity>1</CancelledQuantity>
        <Quantity>5</Quantity>
        <EstimatedArrivalDateTime>2016-09-05T08:07:53Z
          </EstimatedArrivalDateTime>
        <PerUnitPrice>
          <CurrencyCode>JPY</CurrencyCode>
          <Value>1000</Value>
        </PerUnitPrice>
        <PerUnitTax>
          <CurrencyCode>JPY</CurrencyCode>
          <Value>2000</Value>
        </PerUnitTax>
      </member>
    </FulfillmentOrderItem>
    <FulfillmentOrder>
      <ShippingSpeedCategory>ScheduledDelivery</ShippingSpeedCategory>
      <DeliveryWindow>
        <StartDateTime>2016-09-05T03:00:00Z</StartDateTime>
        <EndDateTime>2016-09-05T05:00:00Z</EndDateTime>
      </DeliveryWindow>
      <NotificationEmailList>
        <member>o8c2EXAMPLsfr7o@marketplace.amazon.com</member>
      </NotificationEmailList>
      <StatusUpdatedDateTime>2016-09-05T23:48:48Z</StatusUpdatedDateTime>
      <SellerFulfillmentOrderId>extern_id_1154539615776
        </SellerFulfillmentOrderId>
      <DestinationAddress>
        <PostalCode>153-0002</PostalCode>
        <Name>Amazon Taro</Name>
        <CountryCode>JP</CountryCode>
        <Line1>Meguro-ku Shimomeguro 12-34-56</Line1>
        <StateOrProvinceCode>Tokyo</StateOrProvinceCode>
        <Line2>XXX building 101</Line2>
      </DestinationAddress>
      <DisplayableOrderDateTime>2016-09-02T17:26:56Z </DisplayableOrderDateTime>
      <FulfillmentPolicy>FillOrKill</FulfillmentPolicy>
      <ReceivedDateTime>2016-09-02T17:26:56Z</ReceivedDateTime>
      <DisplayableOrderId>test_displayable_id</DisplayableOrderId>
      <DisplayableOrderComment>Sample comment</DisplayableOrderComment>
      <CODSettings>
        <IsCODRequired>true</IsCODRequired>
        <CODCharge>
          <Value>4000</Value>
          <CurrencyCode>JPY</CurrencyCode>
        </CODCharge>
        <CODChargeTax>
          <Value>300</Value>
          <CurrencyCode>JPY</CurrencyCode>
        </CODChargeTax>
        <ShippingCharge>
          <Value>1000</Value>
          <CurrencyCode>JPY</CurrencyCode>
        </ShippingCharge>
        <ShippingChargeTax>
          <Value>75</Value>
          <CurrencyCode>JPY</CurrencyCode>
        </ShippingChargeTax>
      </CODSettings>
      <FulfillmentOrderStatus>PROCESSING</FulfillmentOrderStatus>
      <FulfillmentAction>Ship</FulfillmentAction>
      <MarketplaceId>ATVPDKIKX0DER </MarketplaceId>
    </FulfillmentOrder>
    <FulfillmentShipment>
      <member>
        <FulfillmentShipmentStatus>PENDING</FulfillmentShipmentStatus>
        <FulfillmentShipmentItem>
          <member>
            <SellerSKU>SKU100</SellerSKU>
            <SellerFulfillmentOrderItemId>merchant_order_item_id_2
              </SellerFulfillmentOrderItemId>
            <Quantity>2</Quantity>
            <PackageNumber>0</PackageNumber>
          </member>
        </FulfillmentShipmentItem>
        <AmazonShipmentId>DnMDLWJWN</AmazonShipmentId>
        <ShippingDateTime>2016-09-03T07:00:00Z</ShippingDateTime>
        <FulfillmentCenterId>RNO1</FulfillmentCenterId>
        <EstimatedArrivalDateTime>2016-09-04T07:00:00Z
          </EstimatedArrivalDateTime>
      </member>
      <member>
        <FulfillmentShipmentStatus>SHIPPED</FulfillmentShipmentStatus>
        <FulfillmentShipmentItem>
          <member>
            <SellerSKU>SKU101</SellerSKU>
            <SellerFulfillmentOrderItemId>merchant_order_item_id_1
              </SellerFulfillmentOrderItemId>
            <Quantity>1</Quantity>
            <PackageNumber>1</PackageNumber>
          </member>
        </FulfillmentShipmentItem>
        <AmazonShipmentId>DKMKLXJmN</AmazonShipmentId>
        <ShippingDateTime>2016-09-03T07:00:00Z</ShippingDateTime>
        <FulfillmentShipmentPackage>
          <member>
            <TrackingNumber>93ZZ00</TrackingNumber>
            <CarrierCode>UPS</CarrierCode>
            <PackageNumber>1</PackageNumber>
          </member>
        </FulfillmentShipmentPackage>
        <FulfillmentCenterId>TST1</FulfillmentCenterId>
        <EstimatedArrivalDateTime>2016-09-05T07:00:00Z
          </EstimatedArrivalDateTime>
      </member>
    </FulfillmentShipment>
    <ReturnItemList>
      <ReturnItem>
        <SellerReturnItemId>16a6a142EXAMPLE</SellerReturnItemId>
        <SellerFulfillmentOrderItemId>order-item-1</SellerFulfillmentOrderItemId>
        <AmazonShipmentId>DLHg36GDN</AmazonShipmentId >
        <ReturnReasonCode>REASON-CODE</ReturnReasonCode>
        <ReturnComment>Did not like color</ReturnComment>
        <AmazonReturnReasonCode>OTHER-REASON-CODE</AmazonReturnReasonCode>
        <Status>Processed</Status> 
        <StatusChangedDate>2016-09-02T02:40:36Z</StatusChangedDate>
        <ReturnAuthorizationId>amzn-rma-id</ReturnAuthorizationId>
        <ReturnReceivedCondition>Sellable</ReturnReceivedCondition>
        <FulfillmentCenterId>FC123</FulfillmentCenterId>
      </ReturnItem>
    </ReturnItemList>
    <ReturnAuthorizationList>
      <ReturnAuthorization>
        <ReturnAuthorizationId>amzn-rma-id</ReturnAuthorizationId>
        <FulfillmentCenterId>FC123</FulfillmentCenterId>
        <ReturnToAddress>
          <Name>Amazon FC</Name>
          <Line1>123 Main Street</Line1>
          <City>Anywhere</City>
          <StateOrRegionCode>WA</StateOrRegionCode>
          <PostalCode>98122</PostalCode>
          <CountryCode>US</CountryCode>
        </ReturnToAddress>
        <AmazonRmaId>test123</AmazonRmaId>
        <RmaPageURL>https://sellercentral.amazon.com/URL</RmaPageURL>
      </ReturnAuthorization>
    </ReturnAuthorizationList>
  </GetFulfillmentOrderResult>
  <ResponseMetadata>
    <RequestId>5e5e5694-8e76-11df-929f-87c80302f8f6</RequestId>
  </ResponseMetadata>
</GetFulfillmentOrderResponse>

↑ Top