List Sellers

Lists who can be credited as the seller of a sale item in the given locations, with the
semantics of the v1 GET /locations/sellers. Location by location, in this order:

  • provider: the location's active, bookable service providers (time resources excluded),
    ordered by display order and public name. role_name is Prestador.
  • user: the active staff users assigned to the location. role_name is the user's role
    label (Recepcionista, Staff, Administrador Local…).
  • cashier: the company's active cashier employee codes (company-wide, not per location).
    role_name is Cajero.

Important Notes

  • Requires sellers:read scope.
  • A seller that works at several locations is listed once. Only the name and the role are
    exposed.
  • Without location_ids, every location of the company is used, inactive ones included.
  • A location_ids value of another company (or unknown) answers 404 and nothing is listed.
  • seller_type maps to the numeric seller type of the cart items of the sales service as
    provider = 0, user = 1, cashier = 2.
  • The list is not paginated.

Errors Dictionary

StatusErrorDetailDescription
401unauthorizedinvalid_api_keyMissing or invalid Bearer token.
401unauthorizedapi_config_inactiveAPI access is inactive for this company.
403forbiddenscope_deniedAPI key lacks sellers:read scope.
404invalid_location—A location_ids value does not exist or belongs to another company.
429rate_limitedburst_limit_exceededPer-minute request limit exceeded.
429rate_limiteddaily_quota_exceededDaily request quota exceeded.
502upstream_unavailableconnection_failedThe upstream service is unavailable.
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
location_ids
array of integers

One or more location IDs, comma-separated (location_ids=1,2). location_ids[]=1&location_ids[]=2
also works against Connect directly, but only the comma form carries several values through
the public host. Omit it for every location of the company.

location_ids
Responses

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json