Get Vendedor

{ "success": true, "data": { "id": "770e8400-e29b-41d4-a716-446655440000", "name": "Carlos Martínez", "username": "cmartinez", "email": "[email protected]", "phone": "8091234567", "role": "VENDEDOR", "ventanaId": "660e8400-e29b-41d4-a716-446655440000", "code": "CM001", "isActive": true, "settings": { "print": { "name": "Portable Printer", "phone": "8091234567", "width": 58, "footer": "Gracias por su preferencia", "barcode": true, "bluetoothMacAddress": "AA:BB:CC:DD:EE:FF" }, "theme": "dark" }, "platform": "android", "appVersion": "2.0.7", "deletedAt": null, "deletedBy": null, "deletedReason": null, "createdAt": "2024-03-15T13:00:00Z", "updatedAt": "2024-03-15T14:30:00Z" } }

Required: Valid JWT token (all authenticated users)

Response

success

boolean

Indicates if the request was successful

data

object

The vendedor user object (password excluded)

Show Vendedor object

string

UUID of the vendedor

name

string

Vendedor’s full name

username

string

Unique username

string

Email address

phone

string

Phone number

role

string

Always “VENDEDOR”

ventanaId

string

Associated ventana UUID

code

string

Vendedor code

isActive

boolean

Active status

settings

object

Vendedor-specific settings (print config, theme)

platform

string

User platform: “web”, “android”, or “ios”

appVersion

string

Application version (e.g., “2.0.7”)

deletedAt

string

Soft delete timestamp (null if active)

deletedBy

string

User ID who deleted this vendedor (null if active)

deletedReason

string

Reason for deletion (null if active)

createdAt

string

ISO 8601 timestamp

updatedAt

string

ISO 8601 timestamp

{
  "success": true,
  "data": {
    "id": "770e8400-e29b-41d4-a716-446655440000",
    "name": "Carlos Martínez",
    "username": "cmartinez",
    "email": "[email protected]",
    "phone": "8091234567",
    "role": "VENDEDOR",
    "ventanaId": "660e8400-e29b-41d4-a716-446655440000",
    "code": "CM001",
    "isActive": true,
    "settings": {
      "print": {
        "name": "Portable Printer",
        "phone": "8091234567",
        "width": 58,
        "footer": "Gracias por su preferencia",
        "barcode": true,
        "bluetoothMacAddress": "AA:BB:CC:DD:EE:FF"
      },
      "theme": "dark"
    },
    "platform": "android",
    "appVersion": "2.0.7",
    "deletedAt": null,
    "deletedBy": null,
    "deletedReason": null,
    "createdAt": "2024-03-15T13:00:00Z",
    "updatedAt": "2024-03-15T14:30:00Z"
  }
}

Notes

Password is never included in response

ID must be a valid UUID format

VENTANA users can only access vendedores in their ventana (see src/api/v1/controllers/vendedor.controller.ts:70-76)

Returns 404 if vendedor is soft-deleted or doesn’t have VENDEDOR role

Implementation: src/api/v1/controllers/vendedor.controller.ts:69-77

Authentication

Tickets

Sorteos (Draws)

Loterias

Bancas & Ventanas

Users & Vendedores

Commissions

Restrictions & Rules

Multipliers

Payments

Analytics & Reports

Accounts

Activity & Audit

Overview

Authorization

Path Parameters

Response

Notes

Build docs developers (and LLMs) love

Authentication

Tickets

Sorteos (Draws)

Loterias

Bancas & Ventanas

Users & Vendedores

Commissions

Restrictions & Rules

Multipliers

Payments

Analytics & Reports

Accounts

Activity & Audit

​Overview

​Authorization

​Path Parameters

​Response

​Notes

Build docs developers (and LLMs) love

Overview

Authorization

Path Parameters

Response

Notes