Versions Compared

Key

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

Overview

Excerpt

This method returns a list of vendors.

 

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.

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"
        }
    ]
}