Get a detailed Web Order list
Use this method to get a detailed list of Web Orders.
Valid Tokens: Customer and User.
🔒 Fields with this icon are only available when the token has the Transactional API Access enabled. For more information, please visit the Transactional API Access page.
Related Articles
-
Checkout a Web Order (API)
-
Create a Web Order (API)
-
Data Import (Knowledge Base)
-
Delete a Web Order (API)
-
-
-
-
-
-
Get a Prebook list (API)
Request
URL: https://api.kometsales.com/api/web-order-details.list
Method: GET
Content-Type: URL Parameters
Headers
X-ACCOUNT (required)(integer:20)
Company ID that is using the API.
Please ask the Komet Sales team to get this ID.
authenticationToken (required)(string:50)
Komet Sales security token.
Input parameters
customerId (required)(integer:20)
Customer ID.
Use this parameter to search orders from a specific customer.
You can get this value from the customer.list API method.
webOrderId (required)(integer:20)
Komet Sales internal Web Order ID..
companyLocationId (required)(integer:10)
Location ID.
Only applies to Multi-Location Companies.
You can get this value from the location.list API method.
statusId (optional)(integer:1)
Order status.
Valid values: 1 = Pending | 2 = Checked-Out
If this value is not sent, the system will only return information for orders that have not been checked out.
curl -X 'GET' \
'https://api.kometsales.com/api/v2/web-order-details.list?customerId={1313}&webOrderId=1313' \
-H 'key: authenticationToken' \
-H 'value: u0j3ij91k2r58g6s0grbi02dor' \
-H 'type: text'
-H "X-ACCOUNT: 1313"
-H "Content-Type: application/json"
Response
message (string)
Transaction status description.
status (integer:1)
Transaction status.
Valid values: 1 = Success | 0 = Failure
webOrders (array)
An array containing Web Orders created in Komet Sales.
id (integer:20)
Komet Sales Internal Web Order ID.
number (integer:10)
Web Order number.
statusId (integer:1)
Web Order status.
Valid values: 1 = Pending | 2 = Confirmed
companyLocationId (integer:10)
Order location.
Only applies to Multi-Location Companies.
customerId (integer:10)
Web Order Customer ID.
subtotal (decimal:10,2)
Order subtotal.
This amount does not include additional charges or taxes.
additionalCharges (decimal:10,2)
Total additional charges.
total (decimal:10,2)
Order total.
Calculated with: subtotal
+ additionalCharges
+ taxes.
items (array)
An array of items that are associated with the web order.
id (string)
ID that identifies the row between all the records of the result.
webOrderItemId (integer)
Komet Sales internal Web Order Item ID.
webOrderItemType (integer:1)
Item type.
Valid values: 0 = Invoice | 1 = Prebook
imageUrl (string)
Product image URL.
productDescription (string:200)
Product description.
quantity (integer:10)
Total boxes.
price (decimal:10,3)
Unit price.
totalPrice (decimal:10,2)
The amount of the product line.
Calculated with: Unit Price x Total Units
deliveryBy (date)
Date when the order will be delivered.
Date format: YYYY-MM-DD
carrierId (integer:20)
Komet Sales internal Carrier ID.
carrierName (string:200)
Carrier name.
shipName (string:200)
Ship-To name.
markCode (string:50)
Mark code associated to the order, also known as order name.
itemSizeId (integer:10)
Box Type ID.
itemSizeCode (string:3)
Box type code.
For example: HB, QB, or FB.
unitType (string:10)
Unit type.
Valid values: Stem or Bunch.
stemsBunch (integer:10)
Number of Stems per Bunch.
pack (integer:10)
Number of Units per Box.
🔒lineStatus (string:20)
Product status.
Valid values: Pending Checkout, Pending Confirmation, Confirmed, Shipped.
🔒referenceNumber (string:20)
Order reference or tracking number when the product is already billed.
🔒orderNumber(integer:10)
Web Order order number.
It is returned when inventoryOrigin
= 1 (OH).
🔒prebookNumber(integer:10)
Web Order Prebook number.
It is returned when inventoryOrigin
= 2 (FS).
{
"message":"OK",
"status":1,
"webOrders":[
{
"id":48,
"number":27,
"statusId":1,
"companyId":7030,
"userId":793,
"companyLocationId":13,
"customerId":7349,
"items":[
{
"id":"8b891222-5ce4-11e7-81aa-2ca9caf6766c",
"webOrderItemId":928343,
"webOrderItemType":1,
"imageUrl":"http://test.kometsales.com.s3.amazonaws.com/7030/product/217044_250x250.jpg?AWSAccessKeyId=AKIAJCADKODN6ZCRUIYQ&Expires=1498924690&Signature=E8QAUci0ibpj%2F2Jzaf2vXtcmpK4%3D",
"productDescription":"Agapanthus Silver Queen",
"quantity":1,
"price":7,
"totalPrice":14,
"deliverBy":"2017-06-29",
"carrierId":1661,
"carrierName":"Armellini Miami",
"shipName":"RSVP2",
"markCode":"",
"itemSizeId":2520,
"itemSizeCode":"FB",
"unitType":"Bunch",
"stemsBunch":2,
"pack":2
}
],
"subTotal":14,
"additionalCharges":0,
"total":14
}
]
}