Versions Compared
compared with
Key
- This line was added.
- This line was removed.
- Formatting was changed.
Overview
Excerpt |
---|
This method returns a list of customers. |
Request
https://api.kometsales.com/api/customer.list
- Method: GET
- Content-Type: URL Params.
Input parameters:
- authenticationToken (required)(string:50): Komet Sales security token.
- id (optional)(integer:20): Komet Sales internal customer ID.
- name (optional)(string:200): name of the customer.
- code (optional)(string:10): code of the customer.
- salesPersonId (optional)(integer:20): Komet Sales internal salesperson ID.
- includeInactive (optional)(boolean): true or false. If it's true it will also return customers that have been deactivated.
- locationId (optional)(integer:20): location Komet Sales internal ID. You can obtain this value from the location.list API method. This only applies for companies in Multi Location mode.
- updateAsOf (optional) (date) (date format YYYY-MM-DD): the system will only search for customers updated as of this date.
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 | ||||||
---|---|---|---|---|---|---|
| ||||||
https://api.kometsales.com/api/customer.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.
- customers: array of customers
- id (integer:20): Komet Sales internal customer ID.
- name (string:200): name of the customer.
- code (string:10): code of the customer.
- active (boolean:1): 1 if the customer is active, 0 if the customer is not active.
- salesPerson (string:200): salesperson name.
- salesPersonId (integer:20): salesperson ID.
- customerType (string:200): customer type. e.g.: Retailer, Wholesaler, etc.
- updatedOn (datetime) (date format YYYY-MM-DD'T'hh:mm:ss).: last updating date of the customer.
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
{ "status": "1", "message": "OK", "customers": [ { "id": "25475", "customerType": "PART-TIME FLORIST", "salesPerson": "Lance Bossard", "name": "2-14 ENTERPRISES BRIDAL CAKES", "salesPersonId": 1819, "active": "1", "code": "T3526", "updatedOn": "2017-08-02T12:15:17" } , { "id": "29775", "customerType": "", "name": "Alejandro Sandobal SAS", "active": "1", "code": "ASS", "salesPersonId": 23423, "customerType": "Retailer" "updatedOn": "2017-09-15T17:02:50" } ] } |
Panel | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||
|
Info | ||
---|---|---|
| ||
This method can be executed with tokens type company and vendor. |