Create a New Order

Important Note about Applying Test Orders to the ChannelAdvisor System

Any order created with this method will count toward monthly GMV and the client may be charged for them based on contractual GMV agreements.
Your contract may vary - be aware of this before creating any orders.

Orders Should be Created in One of Two Scenarios

  1. When test orders are needed:
    1. For a variety of unique scenarios
    2. For a large number of orders
  2. When using ChannelAdvisor to manage orders from another website or marketplace and need to "import" them

For Test Orders (#1)

To avoid having test orders created applied to monthly GMV goals:

  1. First: If you have a point of contact at ChannelAdvisor, discuss your plans with them first.
  2. Option 1: ChannelAdvisor has a tool available to employees to generate mock test orders which mimic those coming from many marketplaces (not all are marketplaces or locales are covered).
    • Contact Us by creating a case or reaching out to Support
  3. Option 2: Create orders through the workflows described in this section.
  4. Last: Only after orders have been created and within the same month - Contact Us by creating a case or reaching out to Support.
    • Be sure to include the ChannelAdvisor Order IDs that need to be excluded.

Two Workflows Exist to Create Orders

  1. Create orders & let ChannelAdvisor route to the appropriate distribution center
    1. Order Creation Entity Options:
      1. Define Items in the Order
      2. Define basic order level information: Site Order IDs, Seller Order ID, Tax handling, Shipping and Billing Address, etc
    2. These will be created as Checkout Direct orders (Site ID: 587).
    3. If Enabled in the account on Checkout Direct orders:
      1. Will route according to Distribution Center priority routing.
      2. Will route according to Order Routing rules.
      3. Will have Shipping Rules applied.
  2. Create orders & API request defines the distribution center
    1. Order Creation Entity Options:
      1. Same as above + definition of what distribution center the order should route to along with shipping status, tracking number, carrier/class, ship date, etc.
    2. These will be created as Checkout Direct orders (Site ID: 587).
    3. Distribution Center priority routing settings are ignored.
    4. Order Routing Rules and/or Shipping Rules are ignored.

If trying to mimic what a marketplace order will look like, review what Order Entity properties are required in POST, and look over some marketplace order responses to see what fields are commonly populated.

  • Marketplace-Specific Order Responses
  • Notes About SiteID/SiteName Values: 
    • All orders created via API will be Checkout Direct (Site ID: 587) even if a different value is supplied.
    • This ensures the system will not communicate the order to a specific marketplace.
    • If a specific SiteName is included in the request, it will be applied as provided.

Order Examples