One of the most common use cases of the Infoplus API is to create Orders in Infoplus.  This can be useful, for example:

  • If you have an in-house system with Orders that need to be managed and/or fulfilled by Infoplus.
  • If you are pulling Orders from an order source with which Infoplus is not directly integrated.

However, at first glance, the Order object in the Infoplus API documentation may appear overwhelming, as there are over 80 fields in the Order object in version 1.0 of the API (plus almost 30 more in the Order Line child type).  

The purpose of this article is to explain the basic set of required fields for placing an Order with the Infoplus API, to give you a starting point that you can build upon.  

From a mechanical standpoint, creating an Order is as simple as a single HTTP POST to the order endpoint in the Infoplus API.  For example, using version 1.0 of the api, on the command line:   
curl -s -H API-Key:YOUR-API-KEY -H Content-Type:application/json -X POST -d @order.json \
   https://YOUR-INFOPLUS-DOMAIN/infoplus-wms/api/v2.0/order


The interesting part is all about the data that is included in that POST.  


The simplest example Order that can be placed through the Infoplus API looks like the following:  
{
   "lobId": 10000,
   "warehouseId": 1000,
   "customerNo": "100",
   "orderDate": "2020-01-01",
   "lineItems":
   [
      {
         "sku": "SKU-1",
         "orderedQty": 1
      }
   ]
}

 

Going through that JSON object field-by-field, we have:

FieldDescriptionNotes
lobIdInteger; Id of the Line of Business (LOB) that the Order belongs to. You can find your LOB Id by using the lineOfBusiness/search endpoint in the Infoplus API, as in:
curl -H API-Key:YOUR-API-KEY \
https://YOUR-INFOPLUS-DOMAIN/infoplus-wms/api/v1.0/lineOfBusiness/search

warehouseIdInteger; Id of the Warehouse that the Order will be fulfilled from.You can find your Warehouse Id in the Warehouse Table, within Infoplus.
Or, you can use the warehouse/search endpoint in the Infoplus API, as in:
curl -H API-Key:YOUR-API-KEY \
https://YOUR-INFOPLUS-DOMAIN/infoplus-wms/api/v1.0/warehouse/search
 
customerNoString; Unique identifier (within the LOB) for the Customer that the Order will be associated with.
See How to use Customers, Bill To Address, and Ship To Address with Orders in the Infoplus API for more information.
orderDateDate (YYYY-MM-DD); Date that the order was placed in the source system.Note:  Infoplus may adjust this date based on the Order's scheduled fulfillment date.  
lineItemsList of Line Items on the Order. 
lineItems[i].skuString;  Unique identifier (within the LOB) for the Item being ordered.All SKU's on an order must be unique (i.e., you can not have 2 or more line items for the same SKU).
lineItems[i].orderedQtyInteger; Unit quantity being ordered. 


Beyond these required fields, there are many more optional fields which can be included when you create (or update) an Order. You can consult the API Reference site for a listing of all fields.  

   

See Also