Create Order

After receiving authentication, the Create Order API is used to submit an order from a website into Kibo OMS. This call acts as the central API of the Customer Care Suite – all communication with Kibo OMS begins here. In order to query and manipulate orders, they must first be created. All APIs used to pull information about an order are used downstream from the Create Order API.

Note that the request body and parameter schemas outlined in this guide are the exact same as in the previous version of OMS, as the Unified Commerce platform supports backwards compatibility for this API. The only change to this request is the format of the base endpoint, as shown in the below table. Remember to provide the x-vol-tenant key for authentication in the headers.

Example

The example case creates an API call for an order that has the following properties:

• Currency – USD
• Payment Type – Credit Card
• Order Type – Gift
• Two order items
• Custom order and item data points

This guide will demonstrate how to put together each section of the request to build this order.

Required Parameters

These parameters are necessary for the Create Order API to return a successful response:

Optional Parameters

Other possible parameters can be provided to specify other details about the order. These variables are:

Primary Elements

The required elements of Customer, Order Items, Shipping Method, and Order Payments have their own parameters. These are listed in detail in the Create Order Schema, but examples also follow below. However, there are a few things to note in the initial block of Create Order data before delving deeper into those elements.

First, it is important to note that the Customer IP is the external address of the consumer purchasing the order, NOT the internal address of the web server or client. The Customer IP is required for bundled clients, and providing the incorrect address will hinder the fraud review process.

{
  "externalOrderID": "00000000-12345-54321",
  "manufacturerID": MFG_ID,
  "catalogID": CATALOG_ID,
  "locale": "en-US",
  "currency": "USD",
  "customerIP": "0.1.2.3."
}

Second, Kibo supports IETF codes to denote locales and languages for orders. These codes are listed below:

Likewise, ISO codes are used to refer to denote the currencies that orders are made in. The full list of ISO codes supported by Unified Commerce is provided below.

{
 "totalCount": 162,
 "items": [
  {
   "code": "AED",
   "name": "United Arab Emirates Dirham"
  },
  {
   "code": "AFN",
   "name": "Afghanistan Afghani"
  },
  {
   "code": "ALL",
   "name": "Albania Lek"
  },
  {
   "code": "AMD",
   "name": "Armenia Dram"
  },
  {
   "code": "ANG",
   "name": "Netherlands Antilles Guilder"
  },
  {
   "code": "AOA",
   "name": "Angola Kwanza"
  },
  {
   "code": "ARS",
   "name": "Argentina Peso"
  },
  {
   "code": "AUD",
   "name": "Australia Dollar"
  },
  {
   "code": "AWG",
   "name": "Aruba Guilder"
  },
  {
   "code": "AZN",
   "name": "Azerbaijan New Manat"
  },
  {
   "code": "BAM",
   "name": "Bosnia and Herzegovina Convertible Marka"
  },
  {
   "code": "BBD",
   "name": "Barbados Dollar"
  },
  {
   "code": "BDT",
   "name": "Bangladesh Taka"
  },
  {
   "code": "BGN",
   "name": "Bulgaria Lev"
  },
  {
   "code": "BHD",
   "name": "Bahrain Dinar"
  },
  {
   "code": "BIF",
   "name": "Burundi Franc"
  },
  {
   "code": "BMD",
   "name": "Bermuda Dollar"
  },
  {
   "code": "BND",
   "name": "Brunei Darussalam Dollar"
  },
  {
   "code": "BOB",
   "name": "Bolivia Boliviano"
  },
  {
   "code": "BRL",
   "name": "Brazil Real"
  },
  {
   "code": "BSD",
   "name": "Bahamas Dollar"
  },
  {
   "code": "BTN",
   "name": "Bhutan Ngultrum"
  },
  {
   "code": "BWP",
   "name": "Botswana Pula"
  },
  {
   "code": "BYR",
   "name": "Belarus Ruble"
  },
  {
   "code": "BZD",
   "name": "Belize Dollar"
  },
  {
   "code": "CAD",
   "name": "Canada Dollar"
  },
  {
   "code": "CDF",
   "name": "Congo/Kinshasa Franc"
  },
  {
   "code": "CHF",
   "name": "Switzerland Franc"
  },
  {
   "code": "CLP",
   "name": "Chile Peso"
  },
  {
   "code": "CNY",
   "name": "China Yuan Renminbi"
  },
  {
   "code": "COP",
   "name": "Colombia Peso"
  },
  {
   "code": "CRC",
   "name": "Costa Rica Colon"
  },
  {
   "code": "CUC",
   "name": "Cuba Convertible Peso"
  },
  {
   "code": "CUP",
   "name": "Cuba Peso"
  },
  {
   "code": "CVE",
   "name": "Cape Verde Escudo"
  },
  {
   "code": "CZK",
   "name": "Czech Republic Koruna"
  },
  {
   "code": "DJF",
   "name": "Djibouti Franc"
  },
  {
   "code": "DKK",
   "name": "Denmark Krone"
  },
  {
   "code": "DOP",
   "name": "Dominican Republic Peso"
  },
  {
   "code": "DZD",
   "name": "Algeria Dinar"
  },
  {
   "code": "EGP",
   "name": "Egypt Pound"
  },
  {
   "code": "ERN",
   "name": "Eritrea Nakfa"
  },
  {
   "code": "ETB",
   "name": "Ethiopia Birr"
  },
  {
   "code": "EUR",
   "name": "Euro Member Countries"
  },
  {
   "code": "FJD",
   "name": "Fiji Dollar"
  },
  {
   "code": "FKP",
   "name": "Falkland Islands (Malvinas) Pound"
  },
  {
   "code": "GBP",
   "name": "United Kingdom Pound"
  },
  {
   "code": "GEL",
   "name": "Georgia Lari"
  },
  {
   "code": "GGP",
   "name": "Guernsey Pound"
  },
  {
   "code": "GHS",
   "name": "Ghana Cedi"
  },
  {
   "code": "GIP",
   "name": "Gibraltar Pound"
  },
  {
   "code": "GMD",
   "name": "Gambia Dalasi"
  },
  {
   "code": "GNF",
   "name": "Guinea Franc"
  },
  {
   "code": "GTQ",
   "name": "Guatemala Quetzal"
  },
  {
   "code": "GYD",
   "name": "Guyana Dollar"
  },
  {
   "code": "HKD",
   "name": "Hong Kong Dollar"
  },
  {
   "code": "HNL",
   "name": "Honduras Lempira"
  },
  {
   "code": "HRK",
   "name": "Croatia Kuna"
  },
  {
   "code": "HTG",
   "name": "Haiti Gourde"
  },
  {
   "code": "HUF",
   "name": "Hungary Forint"
  },
  {
   "code": "IDR",
   "name": "Indonesia Rupiah"
  },
  {
   "code": "ILS",
   "name": "Israel Shekel"
  },
  {
   "code": "IMP",
   "name": "Isle of Man Pound"
  },
  {
   "code": "INR",
   "name": "India Rupee"
  },
  {
   "code": "IQD",
   "name": "Iraq Dinar"
  },
  {
   "code": "IRR",
   "name": "Iran Rial"
  },
  {
   "code": "ISK",
   "name": "Iceland Krona"
  },
  {
   "code": "JEP",
   "name": "Jersey Pound"
  },
  {
   "code": "JMD",
   "name": "Jamaica Dollar"
  },
  {
   "code": "JOD",
   "name": "Jordan Dinar"
  },
  {
   "code": "JPY",
   "name": "Japan Yen"
  },
  {
   "code": "KES",
   "name": "Kenya Shilling"
  },
  {
   "code": "KGS",
   "name": "Kyrgyzstan Som"
  },
  {
   "code": "KHR",
   "name": "Cambodia Riel"
  },
  {
   "code": "KMF",
   "name": "Comoros Franc"
  },
  {
   "code": "KPW",
   "name": "Korea (North) Won"
  },
  {
   "code": "KRW",
   "name": "Korea (South) Won"
  },
  {
   "code": "KWD",
   "name": "Kuwait Dinar"
  },
  {
   "code": "KYD",
   "name": "Cayman Islands Dollar"
  },
  {
   "code": "KZT",
   "name": "Kazakhstan Tenge"
  },
  {
   "code": "LAK",
   "name": "Laos Kip"
  },
  {
   "code": "LBP",
   "name": "Lebanon Pound"
  },
  {
   "code": "LKR",
   "name": "Sri Lanka Rupee"
  },
  {
   "code": "LRD",
   "name": "Liberia Dollar"
  },
  {
   "code": "LSL",
   "name": "Lesotho Loti"
  },
  {
   "code": "LTL",
   "name": "Lithuania Litas"
  },
  {
   "code": "LVL",
   "name": "Latvia Lat"
  },
  {
   "code": "LYD",
   "name": "Libya Dinar"
  },
  {
   "code": "MAD",
   "name": "Morocco Dirham"
  },
  {
   "code": "MDL",
   "name": "Moldova Leu"
  },
  {
   "code": "MGA",
   "name": "Madagascar Ariary"
  },
  {
   "code": "MKD",
   "name": "Macedonia Denar"
  },
  {
   "code": "MMK",
   "name": "Myanmar (Burma) Kyat"
  },
  {
   "code": "MNT",
   "name": "Mongolia Tughrik"
  },
  {
   "code": "MOP",
   "name": "Macau Pataca"
  },
  {
   "code": "MRO",
   "name": "Mauritania Ouguiya"
  },
  {
   "code": "MUR",
   "name": "Mauritius Rupee"
  },
  {
   "code": "MVR",
   "name": "Maldives (Maldive Islands) Rufiyaa"
  },
  {
   "code": "MWK",
   "name": "Malawi Kwacha"
  },
  {
   "code": "MXN",
   "name": "Mexico Peso"
  },
  {
   "code": "MYR",
   "name": "Malaysia Ringgit"
  },
  {
   "code": "MZN",
   "name": "Mozambique Metical"
  },
  {
   "code": "NAD",
   "name": "Namibia Dollar"
  },
  {
   "code": "NGN",
   "name": "Nigeria Naira"
  },
  {
   "code": "NIO",
   "name": "Nicaragua Cordoba"
  },
  {
   "code": "NOK",
   "name": "Norway Krone"
  },
  {
   "code": "NPR",
   "name": "Nepal Rupee"
  },
  {
   "code": "NZD",
   "name": "New Zealand Dollar"
  },
  {
   "code": "OMR",
   "name": "Oman Rial"
  },
  {
   "code": "PAB",
   "name": "Panama Balboa"
  },
  {
   "code": "PEN",
   "name": "Peru Nuevo Sol"
  },
  {
   "code": "PGK",
   "name": "Papua New Guinea Kina"
  },
  {
   "code": "PHP",
   "name": "Philippines Peso"
  },
  {
   "code": "PKR",
   "name": "Pakistan Rupee"
  },
  {
   "code": "PLN",
   "name": "Poland Zloty"
  },
  {
   "code": "PYG",
   "name": "Paraguay Guarani"
  },
  {
   "code": "QAR",
   "name": "Qatar Riyal"
  },
  {
   "code": "RON",
   "name": "Romania New Leu"
  },
  {
   "code": "RSD",
   "name": "Serbia Dinar"
  },
  {
   "code": "RUB",
   "name": "Russia Ruble"
  },
  {
   "code": "RWF",
   "name": "Rwanda Franc"
  },
  {
   "code": "SAR",
   "name": "Saudi Arabia Riyal"
  },
  {
   "code": "SBD",
   "name": "Solomon Islands Dollar"
  },
  {
   "code": "SCR",
   "name": "Seychelles Rupee"
  },
  {
   "code": "SDG",
   "name": "Sudan Pound"
  },
  {
   "code": "SEK",
   "name": "Sweden Krona"
  },
  {
   "code": "SGD",
   "name": "Singapore Dollar"
  },
  {
   "code": "SHP",
   "name": "Saint Helena Pound"
  },
  {
   "code": "SLL",
   "name": "Sierra Leone Leone"
  },
  {
   "code": "SOS",
   "name": "Somalia Shilling"
  },
  {
   "code": "SPL",
   "name": "Seborga Luigino"
  },
  {
   "code": "SRD",
   "name": "Suriname Dollar"
  },
  {
   "code": "STD",
   "name": "Sao Principe and Tome Dobra"
  },
  {
   "code": "SVC",
   "name": "El Salvador Colon"
  },
  {
   "code": "SYP",
   "name": "Syria Pound"
  },
  {
   "code": "SZL",
   "name": "Swaziland Lilangeni"
  },
  {
   "code": "THB",
   "name": "Thailand Baht"
  },
  {
   "code": "TJS",
   "name": "Tajikistan Somoni"
  },
  {
   "code": "TMT",
   "name": "Turkmenistan Manat"
  },
  {
   "code": "TND",
   "name": "Tunisia Dinar"
  },
  {
   "code": "TOP",
   "name": "Tonga Pa anga"
  },
  {
   "code": "TRY",
   "name": "Turkey Lira"
  },
  {
   "code": "TTD",
   "name": "Trinidad and Tobago Dollar"
  },
  {
   "code": "TVD",
   "name": "Tuvalu Dollar"
  },
  {
   "code": "TWD",
   "name": "Taiwan New Dollar"
  },
  {
   "code": "TZS",
   "name": "Tanzania Shilling"
  },
  {
   "code": "UAH",
   "name": "Ukraine Hryvna"
  },
  {
   "code": "UGX",
   "name": "Uganda Shilling"
  },
  {
   "code": "USD",
   "name": "US Dollar"
  },
  {
   "code": "UYU",
   "name": "Uruguay Peso"
  },
  {
   "code": "UZS",
   "name": "Uzbekistan Som"
  },
  {
   "code": "VEF",
   "name": "Venezuela Bolivar Fuerte"
  },
  {
   "code": "VND",
   "name": "Viet Nam Dong"
  },
  {
   "code": "VUV",
   "name": "Vanuatu Vatu"
  },
  {
   "code": "WST",
   "name": "Samoa Tala"
  },
  {
   "code": "XDR",
   "name": "IMF Special Drawing Rights"
  },
  {
   "code": "XOF",
   "name": "CFA (BCEAO) Franc"
  },
  {
   "code": "XPF",
   "name": "CFP Franc"
  },
  {
   "code": "YER",
   "name": "Yemen Rial"
  },
  {
   "code": "ZAR",
   "name": "South Africa Rand"
  },
  {
   "code": "ZMK",
   "name": "Zambia Kwacha"
  },
  {
   "code": "ZWD",
   "name": "Zimbabwe Dollar"
  }
 ]
}

Customer

The customer details can then be expanded upon with various properties from the Customer API. For this example, we use the following information:

"customer": {
  "customerID": null,
  "firstName": "Test",
  "lastName": "Customer",
  "email": "testemail@kibotest.com",
  "password": null,
  "phone1": "000-000-1111x000",
  "phone2": "0000000000",
  "accountCreated": null
},

See the Customer API details in the corresponding guide. But note that the customerID (and customerCustomDataID, if provided, as this is an ID designating the custom data record and not the customer themselves) are internal identifiers that are actually set within OMS. They are read-only in practice, though not noted as such in the schema – if an API request includes either of these fields and assigns a value to them instead of “null”, then it will be ignored by the API.

Order Items

The following snippet shows the JSON array attached to this example call. Although there are a number of properties, the crucial elements about line items include the Part Number, Price and Quantity, Name, and Availability (explained below). In addition to these elements, custom data elements are used to send additional, non-structured data associated with the order items. Information such as serial numbers, warranty information, or any additional information in regards to the item can be included in the custom data part of the API call. 

Tax is generally calculated here at the line item-level, and then all items’ tax values are added together for the total order tax amount. In the case of US orders, the tax rate must be no higher than 20.1% for both individual line items and the overall order total. If even a single item has a rate greater than 20.1% then the order creation will fail with a validation error – even if the total order rate comes out to be under 20.1%.

The supported codes and definitions for the Availability parameter are listed below. Note that some cases require the order to be split into more than one order if there are products with different availabilities. OMS does not automatically perform this splitting on order creation – instead, this must be done on the client side because OMS will need to receive an External Order ID for each child order and then appropriate shipping for all items. However, this does not apply to onBlocks configurations – in onBlocks, OMS stores all of the necessary information and can perform the splitting upon order placement.

Note that there are some limitations on how products can be combined in an order:

1. Products with “Preorder” Availability
   • The Create Order API doesn’t accept orders that mix preorder products and non-preorder products. These products need to be separated into several payloads at checkout with separate externalOrderIDs prior to submitting them to the API. One payload needs to contain all non-preorder items while the other should contain the preorder items. This will generate two orderIDs in OMS and two order numbers for the customer.
2. Certified Products in Express Orders
   • Certified fulfillment options within OMS have been used for orders that may need a longer time to be processed due to special product requirements (product customization, fitting parts, etc.). Such orders aren’t candidates to be “expedited” and will negate Express shipping. If certified products are included in an Express order, the order will be created in Kibo OMS but not flagged as “Express.”
3. Products with “Discontinued” Availability
   • Products with availability “D” cannot be combined with normal items in a cart. These products must be split at the cart or checkout level into their own orders with distinct externalOrderIDs, as their order flow will be different from products that should be processed sooner.
4. Products with “Split to Merchant” Availability
   • If an order has products with availability “J” and normal products, then the order must be split into two orders. In OMS, a “J” availability product goes to “Waiting for Manufacturer Acceptance” status whereas other products go to the usual fulfillment status depending on their availability.

This example shows a purchase of 5 items with the part number “Product0001” in the color black.

"orderItems": [
    {
      "orderItemID": null,
      "product": {
        "partNumber": "Product0001",
        "productID": null,
        "availability": "Y",
        "name": "Test Product 0001",
        "retailPrice": 2,
        "averageDealerMargin": 0.3,
        "upc": null
      },
      "itemSpecifics": {
        "externalItemID": null,
        "actualPrice": 1,
        "quantity": 5,
        "shipping": null,
        "shippingTax": null,
        "itemTaxOverride": 1,
        "customItemData": {
          "Custom Data Key 2": "Custom Data Value 2",
          "Custom Data Key 3": "Custom Data Value 3",
          "Custom Data Key 1": "Custom Data Value 1"
        },
        "options": {
          "size": "12",
          "color": "black"
        },
        "customData": null
      }
    },
    {
      "orderItemID": null,
      "product": {
        "partNumber": "Product0002",
        "productID": null,
        "availability": "Y",
        "name": "Test Product 0002",
        "retailPrice": 2,
        "averageDealerMargin": 0.3,
        "upc": null
      },
      "itemSpecifics": {
        "externalItemID": "external002",
        "actualPrice": 1,
        "quantity": 5,
        "shipping": 1,
        "shippingTax": 0.1,
        "itemTaxOverride": 1,
        "options": null,
        "customItemData": {
          "Custom Data Key 2": "Custom Data Value 2",
          "Custom Data Key 3": "Custom Data Value 3",
          "Custom Data Key 1": "Custom Data Value 1"
        }
      }
    }
  ],

Shipping Method and Address

The segment that defines the shipping instructions for the order has two parts:

1. The general type and class of shipping
2. The address where the order will be shipped

There are a few different configurations that this information can be provided in – see the schema for a full template of these builds. Note that in the configuration that includes “name”, “price” and “description” parameters, these are read-only fields that are automatically populated by legacy OMS. Attempting to manually set these fields will result in invalid input errors. The deliveryMethod and shipType parameters are sufficient when using that particular configuration option.

To override shipping default options for the order being created and specify a particular carrier and service type, include the optional parameters of carrier, carrierType, and shipType with the preferred information. If these values are not provided, then the order will be created with the default carrier. Additionally, all three of these values must be used together in order to successfully submit the request. Providing only one or two values will result in a Bad Request error.

An example of specifying an override is shown below:

>"shippingMethod":{
    "shippingType":"standard",
    "deliveryMethod":"SHIP_TO_HOME",
    "carrier":"FEDEX_CROSS_BORDER",
    "carrierType":"INTERNATIONAL",
    "serviceType":"INTERNATIONAL_ECONOMY"
}

This example shows an order with the Standard shipping type being shipped to 123 Elm Lane, San Luis Obispo, CA 93405, US. It does not override the carrier defaults.

"shippingMethod": {
  "shippingType": "standard",
  "shippingClass": "Standard"
},
"shippingAddress": {
  "addressID": null,
  "customerID": null,
  "addressLine1": "123 Elm Ln.",
  "addressLine2": null,
  "addressLine3": null,
  "phone": "111-222-3333",
  "city": "San Luis Obispo",
  "postalCode": "93405",
  "state": "CA",
  "countryCode": "US",
  "latitude": null,
  "longitude": null,
  "fraudLock": false,
  "active": false
},

Order Payments

The Order Payments structure contains information about the way the customer is paying for the order. There are 11 options for defining the payment method, but the method will always include a valid billing address (which supports up to 250 characters per addressLine1, addressLine2, and addressLine3). See the schema for the full details of these 11 options and other parameters, but note that the following parameters can also be included in orderPayments regardless of which option is chosen:

• maxAmount
• transactionID (for pre-authorized payments)
• authorizationID (for pre-authorized payments)
• authAmount (for pre-authorized payments)

The maxAmount parameter can be set to null, -1, or a positive number. Both null and -1 specify that there is no maximum amount; null should be used particularly for the payment types TK, LV, VO, CC, CS, NO, TD, PZ, PL, NG, and ST. Use a positive value if there are multiple payment methods and some of them should be limited (such as $5 on giftcard1, $10 on giftcard2, and the rest on a credit card with no limit) or if the payment is a gift card (in which case, maxAmount should be the available balance).

Possible payment types vary depending on implementation and should be verified before placing the call. The supported codes and definitions for non-gift card payment types are listed below:

The supported codes and definitions for gift card payment types are listed below:

The supported codes and definitions for card issuers are listed below:

If using a no-operation payment, note that the cardNumber field must still be populated even if the card is not actually exposed – in this case, the field can be set to a bogus number. There are several different types of no-operation payment subtypes defined below with their supported currency types, but there are also custom subtypes that are only used by specific implementations and not listed here for public use. All of these gateways must be configured by Kibo Professional Services if needed.

This example lists a standard credit card as the method of payment. Note that both a cardNumber and ccLastFour parameter is included here - you can include either one alone, but it is beneficial to provide both. Though cardNumber may be a credit card token and not the actual card number, the ccLastFour field explicitly sends in the last four digits of the real credit card number. These four digits will then be displayed in the Order Admin UI (such as for CSRs to confirm payment information with a customer). If ccLastFour is not provided, then the UI will fall back to using the last four digits of the cardNumber field.

"orderPayments": [
    {
      "orderPaymentID": null,
      "paymentMethod": {
        "billingAddress": {
          "addressID": null,
          "customerID": null,
          "addressLine1": "123 San Luis Obispo Ln.",
          "addressLine2": null,
          "addressLine3": null,
          "phone": "111-222-3333",
          "city": "San Luis Obispo",
          "postalCode": "93405",
          "state": "CA",
          "countryCode": "US",
          "latitude": null,
          "longitude": null,
          "fraudLock": false,
          "active": true
        },
        "paymentType": "CC",
        "cardIssuer": "VI",
        "cardNumber": "411111111111111",
        "ccLastFour": "1234",
        "cardSecurityCode": "111",
        "cardExpiration": "12/2020",
        "paymentClass": "CreditCard"
      },
      "paymentMethodID": null,
      "maxAmount": null,
      "transactionID": "12123",
      "authorizationID": "48484",
      "paymentType": null,
      "authAmount": 20
    }
  ],

External Fraud

As noted above, the Create Order API schema lists several options for how to define fraudData for the order being created. In the event that the implementation uses an external fraud system instead of one already supported by OMS, refer to the External Fraud Guide for more details.

The Full Request

This is the entire request that will create an order. Remember to put account-specific information under the data points specified by:

• manufacturerID
• catalogID

The other content in this sample is the combination of all previously explained sections, with additional parameters defined where necessary such as the gift order details at the end of the request.

{
  "externalOrderID": "8885456-98658-12215",
  "manufacturerID": MFG_ID,
  "catalogID": CATALOG_ID,
  "locale": "en-US",
  "currency": "USD",
  "customer": {
    "customerID": null,
    "firstName": "Test",
    "lastName": "Customer",
    "email": "testemail@kibotest.com",
    "password": null,
    "phone1": "852-658-4578x124",
    "phone2": "8885552147",
    "accountCreated": null
  },
  "orderItems": [
    {
      "orderItemID": null,
      "product": {
        "partNumber": "Product0001",
        "productID": null,
        "availability": "Y",
        "name": "Test Product 0001",
        "retailPrice": 2,
        "averageDealerMargin": 0.3,
        "upc": null
      },
      "itemSpecifics": {
        "externalItemID": null,
        "actualPrice": 1,
        "quantity": 5,
        "shipping": null,
        "shippingTax": null,
        "itemTaxOverride": 1,
        "customItemData": {
          "Custom Data Key 2": "Custom Data Value 2",
          "Custom Data Key 3": "Custom Data Value 3",
          "Custom Data Key 1": "Custom Data Value 1"
        },
        "options": {
          "size": "12",
          "color": "black"
        },
        "customData": null
      }
    },
    {
      "orderItemID": null,
      "product": {
        "partNumber": "Product0002",
        "productID": null,
        "availability": "Y",
        "name": "Test Product 0002",
        "retailPrice": 2,
        "averageDealerMargin": 0.3,
        "upc": null
      },
      "itemSpecifics": {
        "externalItemID": "external002",
        "actualPrice": 1,
        "quantity": 5,
        "shipping": 1,
        "shippingTax": 0.1,
        "itemTaxOverride": 1,
        "options": null,
        "customItemData": {
          "Custom Data Key 2": "Custom Data Value 2",
          "Custom Data Key 3": "Custom Data Value 3",
          "Custom Data Key 1": "Custom Data Value 1"
        }
      }
    }
  ],
  "shippingMethod": {
    "shippingType": "standard",
    "shippingClass": "Standard"
  },
  "shippingAddress": {
    "addressID": null,
    "customerID": null,
    "addressLine1": "123 San Luis Obispo Ln.",
    "addressLine2": null,
    "addressLine3": null,
    "phone": "111-222-3333",
    "city": "San Luis Obispo",
    "postalCode": "93405",
    "state": "CA",
    "countryCode": "US",
    "latitude": null,
    "longitude": null,
    "fraudLock": false,
    "active": false
  },
  "orderPayments": [
    {
      "orderPaymentID": null,
      "paymentMethod": {
        "billingAddress": {
          "addressID": null,
          "customerID": null,
          "addressLine1": "123 San Luis Obispo Ln.",
          "addressLine2": null,
          "addressLine3": null,
          "phone": "111-222-3333",
          "city": "San Luis Obispo",
          "postalCode": "93405",
          "state": "CA",
          "countryCode": "US",
          "latitude": null,
          "longitude": null,
          "fraudLock": false,
          "active": true
        },
        "paymentType": "CC",
        "cardIssuer": "VI",
        "cardNumber": "411111111111111",
				"ccLastFour": "1234",
        "cardSecurityCode": "111",
        "cardExpiration": "12/2020",
        "paymentClass": "CreditCard"
      },
      "paymentMethodID": null,
      "maxAmount": null,
      "transactionID": "12123",
      "authorizationID": "48484",
      "paymentType": null,
      "authAmount": 20
    }
  ],
  "customerIP": "88.152.11.125",
  "orderID": null,
  "shippingTax": 2,
  "forceItemTaxOverride": true,
  "optInRetailer": true,
  "landingCode": "TestLandingCode",
  "customOrderData": {
    "Custom Data Key 2": "Custom Data Value 2",
    "Custom Data Key 3": "Custom Data Value 3",
    "Custom Data Key 1": "Custom Data Value 1"
  },
  "allowSplit": false,
  "orderGift": {
    "recipient": "John Doe",
    "message": "this is the gift message"
  },
  "orderComment": null,
  "sendEmail":true
}

The response will list all order details, including the OMS-assigned Order ID that can be used in future calls to retrieve order information, search for orders, add notes, etc.