Amazon Marketplace Web Service

From Just Solve the File Format Problem
Revision as of 12:06, 13 July 2014 by Dan Tobias (Talk | contribs)

Jump to: navigation, search
File Format
Name Amazon Marketplace Web Service
Ontology

The Amazon Marketplace Web Service is a set of API functions to let people selling things or fulfilling orders through Amazon's sites and services update their merchandise, download reports on activity, etc. A web interface is also offered for file uploads/downloads. Uploads and downloads are done largely using tab delimited files, but XML formats are also available for some reports.

Contents

File formats

Fulfillment request upload file

Contains orders taken on non-Amazon sites being uploaded to Amazon for fulfillment (when the products are stocked and shipped from Amazon's warehouses).

Tab delimited with these fields (one line per line item; there may be multiple line items in an order):

  • MerchantFulfillmentOrderID: Order number in merchant's system (needs to be unique for each order)
  • DisplayableOrderID: Order number shown on packing slip (usually the same as previous field)
  • DisplayableOrderDate: Order date (in ISO YYYY-MM-DDTHH:MM:SS format, with optional time zone specification +/-HH:MM following
  • MerchantSKU: Product code (as set up between merchant and Amazon)
  • Quantity: Number of units to ship
  • MerchantFulfillmentOrderItemID: A unique ID for each line item of order
  • GiftMessage: Message to add to packing slip for gift orders
  • DisplayableComment: Comment to add to packing slip for line item
  • PerUnitDeclaredValue: Value of a unit (used only for international orders needing to be declared for customs purposes)
  • DisplayableOrderComment: Comment to add to packing slip for entire order
  • DeliverySLA: Standard, Expedited, or Priority; indicates shipping type. Expedited is 2nd-day, Priority is overnight.
  • AddressName: Recipient's name.
  • AddressFieldOne: Street address
  • AddressFieldTwo
  • AddressFieldThree
  • AddressCity
  • AddressCountryCode: 2-letter ISO country code.
  • AddressStateOrRegion: State/province/etc. code. 2-letter codes in US and Canada.
  • AddressPostalCode: Zip/postal code (varies by country)
  • AddressPhoneNumber: Customer phone
  • NotificationEmail: Customer email
  • FulfillmentAction: Hold or Ship.

In orders with multiple line items, only the MerchantFulfillmentOrderID and the line item fields from MerchantSKU to PerUnitDeclaredValue need to be included on line items after the first in the order; the other fields are for the order as a whole and need only be included in the first line item.

Developer libraries

Sample data

Links

Personal tools
Namespaces

Variants
Actions
Navigation
Toolbox