Overview

Returns a list of Purchase Orders with their corresponding details from the Vendor Availability based on the applied filters.

Request

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

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

Input parameters:

  • authenticationToken (required)(string:50): Komet Sales security token.
  • purchaseOrderNumbers (optional)(string:200): purchase order number. You may send a set of numbers separated by commas. 
  • purchaseOrderItemIds (optional)(string:200): A set of purchase order item IDs separated by commas. This is very useful for the Vendor Availability integration. 
  • shipDate (optional)(date): the date when the order will be shipped. (format YYYY-MM-DD).

You must send at least one of these filters: purchaseOrderNumbers or purchaseOrderItemIds. 


Sample
https://api.kometsales.com/api/purchase.order.va.details.list?authenticationToken=token_info_goes_here&shipDate=2015-07-24&purchaseOrderItemIds=123445,2342343

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: array of purchase orders
    • id (integer:20): Komet Sales internal purchase order ID.
    • number (integer:10): purchase order number.
    • shipDate (date): order ship date. (date format YYYY-MM-DD).
    • details: array of purchase orders details
        • poItemId (integer:20): PO item internal ID.
        • vendorAvailabilityDetails: details of the vendor availability items associated to this line of the order. 
          • productDescription (string:200): product description.
          • availableFrom (date): date when 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): product where the item was downgraded from.