Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Next »

Products - https://developer.channeladvisor.com/working-with-products

A product in the ChannelAdvisor system can be one of the following types:

TypeDescriptionBuyableHas Quantity
StandaloneThe default type of product. Self-contained and without any relationship to other products, it can be listed and purchased.YesYes
ParentA container for one or more child items that vary by one or more attributes such as size or color. A parent does not have quantity and is not purchasable.NoNo
ChildA child product can be purchased and is always related to a single parent product. A child product usually exists for each variation of a parent product.YesYes
BundleBundles are a virtual container for one or more other buyable items. For example, a bundle may contain one camera and two memory cards. Each bundle component, which can be either a standalone or child product, has a component multiplier quantity, which is used to calculate the bundle's overall quantity.YesYes (calculated)

Flow of Product Creation

Outline the process of creating products (as a general concept):

The Product Creation and Update process usually flows something like this with REST API.

  1. Client provides new SKU data to the system at will.
  2. Some pre-requisites may need to be in place depending on design of the client products:
    1. Variation Names/Types
    2. Distribution Centers - ie when an order will be fulfilled by a marketplace store of products
  3. During creation of SKUs, apply all known product attributes within the same product creation request for ease of use - otherwise individual attribute requests are required to append new attributes.
  4. Apply Quantity information to products.
  5. Once a product has been created, these are the options going forward:

    CREATE BundlesThe products now need to be applied to Bundles for sale.
    UPDATE Field DataData needs to be adjusted added for an existing product in an existing field
    ADD More Data

    Data needs to be added to an existing product in an existing field, or a new field and data needs to be added for a product

    DELETE Individual Data

    A data point needs to be cleared of the existing values, leaving a blank

    DELETE the Entire ProductRemove a product from the system because it is no longer active
    UPLOAD Product DataSame as ADD and UPDATE, but executed in bulk
    EXPORT Product DataExtract data in bulk

    About Export Status

    • To retrieve only orders that haven't already been marked as exported by the Developer Key and Application ID combination being used.

    • This is a good way to ensure order imports are not duplicated.
    • See more on all the options for filtering, querying, expanding data under the Getting and Filtering Data page

    Considerations

    • Default export status value is 'false'.
    • Export status is set by each Developer Key and Integration Application ID and can be set and removed at will through the API.
    • The Application ID is unique by the Integration created in the Developer Console, so plan to mark orders as exported and retrieve orders from the same Integration to ensure the goal of avoiding retrieving already imported orders. 
    • Export status is not viewable in the system user interface and is not a field on an item through the API.
    • To test Export status on orders previously marked as exported=true, place a GET Orders request to retrieve orders without defining a specific Order ID. The orders marked as Exported should not be in the response.
    • Retrieving a specific order ID will always ignore the status, so this is not a valid way to test if Exported status has been set.

    Resource URL / Endpoint

    GET https://api.channeladvisor.com/v1/Orders?exported=false
    GET https://api.channeladvisor.com/v1/Orders?exported=true
    POST https://api.channeladvisor.com/v1/Orders(OrderID)/Export
    DELETE https://api.channeladvisor.com/v1/Orders(OrderID)/Export 

    Required Parameters (for GET)

    PropertyRequiredNote
    exportedRequiredInclude in URL. Query value will be true or false.
    Note: there is no dollar sign ($) before this parameter. 

    Required Parameters (for POST and DELETE)

    PropertyRequiredNote
    OrderIDRequiredInclude in URL. The ChannelAdvisor generated unique identifier for the Order.
    Cannot be substituted with Marketplace Order ID.

    Export Status Request Examples


  • No labels