Versions Compared

Key

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

This method returns a list of vendors

ordered by the vendor name.

to Komet Sales. 

Request

URL: 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

grower id. This field is very useful in other methods.
  • code: Vendor code.
  • name: Vendor name.
    • vendor ID.

    • name (optional)(string:200): name of the vendor.

    • code (optional)(string:10): code of the vendor.

    • portOrigin (optional)(string:4): code of the origin port (MIA, BOG, MDE, etc).

    • includeInactive (optional)(boolean): true or false. If it's true it will also return vendors that have been deactivated. 

    Info

    You can send other parameters

    such as the id, code and name in order

    to filter the results. Keep these things in mind:

    • Filtering by

    id
    • ID and code uses an exact match.

    • Filtering by name uses a "LIKE" expression.

    • Filters are not case-sensitive.

    curl

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

    Response

    Output

    :
  • status
  • message

    • 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

  • active
  •  

     

     

     

    Code Block
      • (string:10): code of the vendor.

      • portOrigin(string:4): code of the origin port (MIA, BOG, MDE, etc).

      • cargoMasterCode (string: 20): vendor code set up for the Cargo Master integration. This field will be available only if the company has the Integration with Cargo Master enabled.

      • active (boolean:1): 1 if the vendor is active, 0 if the vendor is not active.

    Sample Response

    Code Block
    {
        "status": "1",
        "message": "OK",
        "vendors": [
            {
                "id": "1",
                "name": "Vendor I",
                "code": "VI",
                "cargoMasterCode": "CMVI",
                "active": 1
            },
            {
                "id": "2",
                "name": "Vendor II",
                "code": "GII",
                "cargoMasterCode": "CMVII",
                "active": 1
            }
        ]
    }
    Panel
    titleRelated Articles
    Filter by label (Content by label)
    showLabelsfalse
    max10
    showSpacefalse
    sorttitle
    cqllabel in ( "vendor-setup" , "vendors" )
    labelsvendors vendor-setup