Place Order Transaction

The Place Order is used to send an order (the contents of the shopping cart) to the Group Member. Note that if multiple locations are designated in the cart, a separate order will be placed for each location. The request and response JSON strings are defined below.

Request JSON Example (Version 2.1)

The following is an example of the JSON string that will be posted

{
   "placeorder": {
      "version": "2.1",
      "transid": "f163bdef-0adb-4973-b5cb-0d15e7df8f85",
      "integrationtype": "FLK",
      "utctime": "2014-07-04 11:00:26",
      "accountid": "854200",
      "username": "",
      "password": "",
      "memberno": "###",
      "ponumber": "job1234",
      "comment": "Deliver ASAP - Customer waiting in lobby.",
      "ordertype": "delivery",
      "items": [
         {
            "id": 1,
            "mfrcode": "HAS",
            "partno": "LF115",
            "locationid": "TESTXX",
            "list": 7.8,
            "cost": 3.25,
            "core": 0,
            "bundlecost": 6.2,
            "bundleid": "98eaa5e1-5a",
            "quantity": 1,
            "comment": "",
            "basevehicleid": 8074,
            "vehicledescription": "1996 Toyota Land Cruiser",
            "vehicledescriptionlong": "1996 Toyota Land Cruiser 4.5L L6 DOHC GAS MFI FI J 1FZ-FE",
            "partdescription": "Benchmark | 10194 | Alternator"
         },
         {
            "id": 2,
            "mfrcode": "FEF",
            "partno": "LF115F",
            "locationid": "TESTXX",
            "list": 5,
            "cost": 1.77,
            "core": 0,
            "bundlecost": 4.2,
            "bundleid": "98eaa5e1-5a",
            "quantityordered": 1,
            "comment": "",
            "basevehicleid": 8074,
            "vehicledescription": "1996 Toyota Land Cruiser",
            "vehicledescriptionlong": "1996 Toyota Land Cruiser 4.5L L6 DOHC GAS MFI FI J 1FZ-FE",
            "partdescription": "Benchmark | 10194 | Alternator"
         }
      ]
   }
}

Request JSON Schema (Version 2.1)

{
   "title": "Item Inquiry Request JSON Schema (Version 2.1)",
   "type": "object",
   "properties": {
      "placeorder": {
         "type": "object",
         "properties": {
            "accountid": {
               "description": "Account identifier (typically the account number).",
               "type": "string"
            },
            "transid": {
               "description": "A unique transaction ID.",
               "type": "integer"
            },
            "version": {
               "description": "Specifies the version being used.",
               "type": "string"
            },
            "username": {
               "description": "Specifies the User making the Request.",
               "type": "string"
            },
            "password": {
               "description": "Specifies the Password for the User that is making the Request.",
               "type": "string"
            },
            "memberno": {
               "description": "Specifies the Group Member Number for the User making the Request.",
               "type": "string"
            },
            "integrationtype": {
               "description": "Specifies the integration type from which the request originated.",
               "type": "string",
               "utctime": {
                  "description": "UTC Date/Time this JSON string is created (yyyy-DD-mm hh:mm:ss)",
                  "type": "string"
               },
               "items": {
                  "type": "array",
                  "items": {
                     "description": "An array containing the item(s) being inquired.",
                     "type": "object",
                     "properties": {
                        "id": {
                           "description": "A unique ID used to identify the match the returned results. This will be an incrementing integer value.",
                           "type": "integer"
                        },
                        "mfrcode": {
                           "description": "The Catalog MfrCode (3 character alpha-numeric).",
                           "type": "string"
                        },
                        "partno": {
                           "description": "The part number.",
                           "type": "string"
                        },
                        "locationid": {
                           "description": "The Branch Abbreviation where the Order is placed.",
                           "type": "string"
                        },
                        "list": {
                           "description": "The List Price for the Part.",
                           "type": "double"
                        },
                        "cost": {
                           "description": "The Selling Price for the Part.",
                           "type": "double"
                        },
                        "core": {
                           "description": "The Core charge for the Part.",
                           "type": "double"
                        },
                        "bundlecost": {
                           "description": "The Bundle Cosst of the ordered Part",
                           "type": "double"
                        },
                        "bundleid": {
                           "description": "Unique ID identifying a single Bundle",
                           "type": "string"
                        },
                        "quantity": {
                           "description": "The number of items being requested (this would typically be the per car quantity).",
                           "type": "number"
                        },
                        "comment": {
                           "description": "The Part level Comment.",
                           "type": "string"
                        },
                        "basevehicleid": {
                           "description": "The ACES Base Vehicle ID.",
                           "type": "string"
                        },
                        "vehicledescription": {
                           "description": "The human readble description of the Vehicle.",
                           "type": "string"
                        }
                     }
                  }
               }
            }
         }
      }
   }
}

Response JSON Example (Version 2.1)

The following is an example of the JSON string to be returned

{
   "placeorderresponse": {
      "version": "2.1",
      "transid": "f163bdef-0adb-4973-b5cb-0d15e7df8f85",
      "utctime": "2014-07-04 11:00:27",
      "status": "success",
      "errordescription": "",
      "ordernumber": "987654",
      "items": [
         {
            "id": 1,
            "status": "success",
            "mfrcode": "HAS",
            "partno": "LF115",
            "quantityordered": 1,
            "quantitybackordered": 0,
            "comment": ""
         },
         {
            "id": 2,
            "status": "backordered",
            "mfrcode": "FEF",
            "partno": "LF115F",
            "quantityordered": 1,
            "quantitybackordered": 0,
            "comment": "This part is backordered. Please call if you wish to cancel."
         }
      ]
   }
}

Response JSON Schema (Version 2.1)

{
   "title": "A work in progress"
}