====== Sales Channels ======
In most cases a ''sales channel'' will be a website.  More generally a ''sales channel'' will be any method by which customer orders can be collected and then retrieved by AutoMagic.

The core section is required minimum functionality for the integration to work.

===== Core =====
As a minimum, the software needs to be able to do the following on the sales channel:
  - Query orders that have not been dispatched yet.
  - To mark order as being dispatched.

===== Server side searches =====
The software can perform server side queries if the ''sales channel'' supports it.

==== Operators ====
  * Starts with
  * Ends with
  * Contains
  * Equals
  * Not equals
  * Before <=
  * After >=

==== Fields ====
  * Order ID.
  * Billing name
  * Total value
  * Order state

===== Sales orders =====

==== Core ====
A sales order arriving from the ''sales channel'' must contain the following information as a minimum:
  * The invoice address details.
  * The SKU of each item.
  * The quantity of each item.
  * The price of each item.

==== Verification and Validation ====
The software is designed to cross check an order to ensure that it is imported correctly.
If the data from the ''sales channel'' contains the following values the AutoMagic will perform the following checks on each imported sale:

  - **The order total** check the total amount of the order matches that of the imported sale.
  - **The item count** check the total number of items matches the imported sale.
  - **The line count** check the total number of lines creates matches the imported sale.
  - **The amount of the payment taken** If payment clearing information is present, AutoMagic can mark the imported sales as paid, with a payment method and amount of the payment.

The above checks allow the software to ensure that the incoming order from the ''sales channel'' and the sale created in AutoMagic are an exact match.

==== Order dispatch ====
In addition to marking the order as dispatch.  AutoMagic can upload tracking information about the order.  The tracking information can be any of the following:
  * The tracking number.
  * A unique courier identifier, this will be a 10 char alpha-numeric string.
  * The name of the courier, up to 30 chars in length.
  * A tracking URL for the consignment.