Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Overview

Excerpt

This method returns a list of vendors to Komet Sales.

 

Request

https://api.kometsales.com/api/vendor.list

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

Input parameters:

  • authenticationToken (required)(string:50): Komet Sales security token.
  • id (optional)(integer:20): Komet Sales internal vendor ID.
  • name (optional)(string:200): name of the vendor.
  • code (optional)(string:10): code of the vendor.
  • includeInactive (optional)(boolean): true or false. If it's true it will also return vendors that have been deactivated. 

You can send other parameters such as the ID, code and name in order to filter the results. Filtering by ID and code uses an exact match. Filtering by name uses a "LIKE" expression. Filters are not case sensitive.

Code Block
themeConfluence
languagejs
titleSample
https://api.kometsales.com/api/vendor.list?authenticationToken=token_info_goes_here

Response

Output:

  • status (integer:1): transaction status. 1 for success or 0 for failure.
  • message (string:500): description of the status of the transaction.
  • vendors: array of vendors
    • id (integer:20): Komet Sales internal vendor ID.
    • name (string:200): name of the vendor.
    • code (string:10): code of the vendor.
    • active (boolean:1): 1 if the vendor is active, 0 if the vendor is not active.
Code Block
themeConfluence
languagejs
titleSample
{
    "status": "1",
    "message": "OK",
    "vendors": [
        {
            "id": "1",
            "name": "Vendor I",
            "code": "VI"
        },
        {
            "id": "2",
            "name": "Vendor II",
            "code": "GII"
        }
    ]
}
 
Panel
titleRelated Articles

Filter by label (Content by label)
showLabelsfalse
max10
sorttitle
showSpacefalse
labelsvendors vendor-setup