Overview

Request

https://api.kometsales.com/api/purchase.order.list

• Method: GET
• Content-Type: URL Params. 

Input parameters:

• authenticationToken (required)(string:50): Komet Sales security token.
• date (required)(date): the vendor ship date of the order. (format YYYY-MM-DD).
• futureInventoryAvailableFrom (optional)(date): the date when the product will be available from. (format YYYY-MM-DD). The specified date range must not exceed 4 days.
• futureInventoryAvailableTo (optional)(date): the date when the product will beavailable to. (format YYYY-MM-DD). The specified date range must not exceed 4 days.
• vendor (optional)(string:50): vendor name or code.
• vendorId(optional)(integer:10): vendor Komet Sales internal ID. This parameter is used to search purchase orders from only one vendor. You can obtain this value from the vendor.list API method.
• customerId(optional)(integer:20): customer Komet Sales internal ID. You can obtain this value from the customer.list API method.
• customerPONumber (optional) (string:20): The PO # of the customer.   (available soon)
• product (optional)(string:100): product description.
• number (optional)(string:10): purchase order number. You may send a set of numbers separated by commas. 
• origin (optional)(string:4): origin code (MIA, MDE, BOG, etc).
• prebook(optional)(string:10):prebooknumber.
• locationId(optional)(integer:10): location Komet Sales internal ID. You can obtain this value from the location.list API method.
• status (optional)(string:20): it's used if you want to load only some orders with a specific status. Valid values: Confirmed by Farm, Approved, Pending Approval, Cancelled. If this filter is not set, the system will return all the purchases orders, including those that are Pending Approval.
• purchaseOrderItemIds (optional)(string:200): A set of purchase order item IDs separated by commas. This is very useful for the Vendor Availability integration. 
• includeVendorAvailabilityDetails (optional)(boolean:true/false): By default it's false. If this value is true, the response will include the details of the vendor availability information but you will have to apply the number filter and only one number is allowed at a time. 
• updatedAsOf(optional) (datetime) (date format YYYY-MM-DDhh:mm:ss):When provided it will force the method to only return orders that have been updated as of the date/time that is specified. Time must be in the GMT time zone. 
• excludeDetails(optional)(integer:1): specify 1 if you want the list only the header of the orders and exclude the details. Default = 0.  

Filtering byvendorId, status, number, origin,prebookandlocationIduses an exact match. Filtering by vendor and product uses a "LIKE" expression. Filters are not case sensitive.

The array of boxes will be only available when the purchase order has been shipped from the farm.

https://api.kometsales.com/api/purchase.order.list?authenticationToken=token_info_goes_here&date=2014-09-24&status=A

Response

Output:

• status (integer:1): transaction status. 1 for success or 0 for failure.
• message (string:500): description of the status of the transaction.
• purchaseOrders:arrayof purchase orders
  • id (integer:20): Komet Sales internal purchase order ID.
  • number (integer:10): purchase order number.
  • origin (string:4): origin code.
  • vendorId(integer:20): vendor Komet Sales internal ID.
  • vendorName(string:200): vendor name.
  • shipDate(date): order ship date. (date format YYYY-MM-DD).
  • status (string:1): status code (CF = Confirmed by Farm, A = Approved, PA = Pending Approval, CA = Cancelled).
  • locationId(integer:20): location Komet Sales internal ID.
  • locationName(string:200): location name.
  • totalCost(decimal:10,2): total cost of the order.
  • comments (string:500): special instructions or comments.
  • totalBoxes(integer:10): number of boxes.
  • updatedOn(datetime): last time when the order was updated. (date format YYYY-MM-DD'T'hh:mm:ss). Time will be in the GMT time zone.
  • createdOn(datetime):datewhen the order was created. (formatYYYY-MM-DD'T'hh:mm:ss).
  • shipName (string:200): Ship To name. (available soon) 
  • shipCity (string:200): ship city name.  (available soon)
  • shipState (string:200): ship state name. (available soon)
  • shipAddress (string:200): ship address. (available soon)
  • shipZipCode (string:10): ship zip code.  (available soon)
  • shipCountry (string:200): ship country name.  (available soon)
  • details:arrayof purchase orders details
    • poItemId(integer:20): PO item internal ID.
    • prebookItemId(integer:20): Prebook item internal ID.
    • prebook(integer:10):prebooknumber.
    • prebookTruckDate(date):prebooktruck date. (date format YYYY-MM-DD).
    • carrierId(integer:20): carrier Komet Sales internal ID.
    • carrierName(string:200): carrier name.
    • standingOrder(string:10): standing order number.
    • orderType(string:1): P forprebook, S for standing Order, D for double.
    • customerId(integer:20): customer Komet Sales internal ID.
    • customerName(string:200): customer name.
    • productId (integer:20) product Komet Sales internal ID.
    • productDescription(string:200): product description.
    • totalBoxes(integer:10): number of boxes.
    • quantityConfirmed(integer:10): number of boxes confirmed by the vendor. 
    • boxType(string:3): box type code. (HB, QB, EB, etc).
    • bunches (integer:10): number of bunches per box.
    • stemsBunch(integer:10): stems per bunch.
    • unitCost(decimal:10,2): unit flower cost.
    • units (integer:10): units per box.
    • unitType(string:5): stem or bunch.
    • totalUnits(integer:10):totalof units.
    • totalCost(decimal:10,2): total cost.
    • markCode(string:20): special mark code or slot number.
    • customField1 (string:50): additional field #1.
    • notes (string:200): special instructions or comments for each line.
    • lineItemStatus(string:1): vendor status code of the product line. P for Pending, C for Confirmed, CA for Cancelled, PC for Partial Confirm, S for Shipped.
    • breakdowns:arrayof breakdowns
      • productId (integer:20): product Komet Sales internal ID.
      • productDescription(string:200): product description.
      • stemsBunch(integer:10): stems per bunch.
      • bunches (integer:10): number of bunches.
      • cost (decimal:10,2): unit flower cost.
    • boxes:arrayof boxes
      • boxCode(string:20): box code number.
      • lotNumber(integer:10): box lot number.
      • position (string:5): physical position of the box.
      • statusId(integer:10): status Komet Sales internal ID.
      • statusName(string:20): status name (Farm Shipped, Received Warehouse, Shipped Warehouse)
    • customFields:arrayof custom fields of the line, only if they exist.
      • name and value of the custom field (string:20).
    • vendorAvailabilityDetails: details of the vendor availability items associatedtothis line of the order. 
      • productDescription(string:200): product description.
      • availableFrom(date): datewhen the product was available from the vendor. (date format YYYY-MM-DD).
      • postHarvest (string:20): post harvest. 
      • unitType(string:20): unit type. Stem or Bunch. 
      • unitsAllocated(integer:10): number of units allocated to this line of the order. 
      • downgraded (boolean): true if the product was downgraded.
      • originalProductDescription(string:200):productwhere the item was downgraded from. 
    • upc: details of theupcinformation added to the product. 
      • number (string: 50): UPC number. 
      • checkDigit(integer: 2): UPC check digit. 
      • pullDate(string: 20): UPC Pull date
      • price (string:20): UPC unit price. 
      • description (string:200): Product description for the UPC. 
      • instructions (string:200): Additional instructions for the UPC. 

{
   "message": "OK",
   "status": 1,
   "purchaseOrders": [
    {
        "id": 297405,
        "totalCost": 45.6,
        "vendorName": "Flores ABC",
        "status": "A",
        "origin": "MDE",
        "totalBoxes": 5,
        "number": "P003006",
        "shipDate": "2014-09-24",
        "vendorId": 6325
        "details": [
            {
                "customerName": "ADO Flowers",
                "totalCost": 45.6,
                "breakdowns": [],
                "prebook": 10353,
                "prebookTruckDate": "2014-09-25",
                "boxType": "HB",
                "unitType": "Bunch",
                "stemsBunch": 25,
                "orderType": "P",
                "productDescription": "Carnation White Floriana Fancy",              
                "units": 6,
                "productId": 138825,
                "totalUnits": 30,
                "poItemId": 1055599,
                "customerId": 37783,
                "lineItemStatus": "S",
                "unitCost": 1.52,
                "carrierId": 1280,
                "bunches": 6,
                "carrierName": "DHL",
                "totalBoxes": 5,
                "notes": "",
                "markCode": "",
                "boxes": [
                    {
                        "statusId": 1,
                        "statusName": "Farm Shipped",
                        "lotNumber": "5317",
                        "boxCode": "KS6819038"
                    },
                    {
                        "statusId": 1,
                        "statusName": "Farm Shipped",
                        "lotNumber": "5317",
                        "boxCode": "KS6819039"
                    },
                    {
                        "statusId": 1,
                        "statusName": "Farm Shipped",
                        "lotNumber": "5317",
                        "boxCode": "KS6819040"
                    },
                    {
                        "statusId": 1,
                        "statusName": "Farm Shipped",
                        "lotNumber": "5317",
                        "boxCode": "KS6819041"
                    },
                    {
                        "statusId": 1,
                        "statusName": "Farm Shipped",
                        "lotNumber": "5317",
                        "boxCode": "KS6819042"
                    }
                ],
                "customFields":[
                    {
                         "customFieldId": 1,
                         "customFieldValueId": 2,
                         "fieldName":"Cut Point",
                         "value":"Cut Point 1"
                    },
                    {
                         "customFieldId": 2,
                         "customFieldValueId": 5,
                         "fieldName":"Sleeve",
                         "value":"Sleeve 3"
                    }
                ],
                "upc": 
				{
						"number":"454656565333",
						"checkDigit":"6",
						"pullDate":"09/10",
						"price":"0.89",
						"description":"White Pom",
						"instructions":"White Pom Instructions"
				}
            }
        ]
      }
   ]
 }