Personas

Clientes, proveedores, empleados y motoboys — un solo registro, con roles que se acumulan.

Es una única pantalla para todo: la misma persona puede ser Cliente y Empleado al mismo tiempo, por ejemplo. Las 4 tarjetas del hub (Clientes, Proveedores, Empleados, MotoBoy) abren esta misma pantalla, solo cambiando el filtro inicial de rol.

Para quién: Registro · Gerencia · Financiero Requiere el módulo: Registros — siempre disponible (permiso "cadastro.ver")

Flujos del día a día

1 Registrar un cliente nuevo #

1 En el Hub de Personas, haga clic en Clientes (o abra Personas y filtre por Cliente).
2 Haga clic en "+ Nueva Persona" — el formulario ya abre con el rol Cliente marcado.
3 Complete Nombre, documento, teléfono y dirección.
4 Si es Persona Jurídica, use la lupa al lado del documento para completar razón social, dirección y teléfono solo (CNPJ en Brasil, RUC en Paraguay).
5 Si es Brasil, escriba el CEP y use la lupa para completar la dirección vía ViaCEP.
6 Si quiere, informe Límite de crédito, Límite por período y Observaciones de crédito.
7 Haga clic en Registrar.

i El documento (cuando se informa) debe pasar la validación de CPF/CNPJ (Brasil) o tener el tamaño correcto de Cédula/RUC (Paraguay), y no puede repetir el de otra persona de la misma empresa — si se repite, aparece un enlace "Ver registro existente" en vez de dejar duplicar. "Ver" abre la ficha solo para lectura; quien puede editar tiene el botón "Editar" ahí mismo, sin cerrar la ficha.

2 Registrar un proveedor #

1 Hub → Proveedores (o filtro Proveedor).
2 "+ Nueva Persona" ya viene con el rol Proveedor marcado.
3 Complete los mismos campos comunes (no existe campo específico de proveedor).
4 Registrar.

i Después de guardado, use las pestañas Historial de Ventas (en realidad muestra las compras hechas a ese proveedor) y Cuentas por Pagar para registrar y saldar cuentas.

3 Registrar un empleado #

1 Hub → Empleados (o filtro Empleado).
2 "+ Nueva Persona" con el rol Empleado marcado.
3 Complete los campos comunes.
4 Elija el Cargo/Perfil (lista los perfiles de acceso ya registrados en Config → Perfiles), Fecha de Ingreso y Salario base.
5 Si va a recibir comisión, elija el tipo (Por Venta o Por Cobro) y el porcentaje.
6 Registrar.

i Esta pantalla no crea el login de acceso del empleado, aunque pida el Cargo/Perfil. Para que pueda ingresar al POS o a la tablet, el acceso debe crearse aparte en Config → Usuarios, vinculándolo al mismo registro de persona. Si la persona ya tiene login, el Cargo/Perfil es también su perfil de acceso — cambiarlo exige el permiso 'Gerenciar Usuários' (Gestionar Usuarios).

4 Registrar un motoboy #

1 Hub → MotoBoy.
2 "+ Nueva Persona" con el rol MotoBoy marcado.
3 Complete solo los campos comunes — no hay vehículo ni zona de entrega para registrar.
4 Registrar.

i El rol MotoBoy solo aparece para elegir si la empresa tiene el módulo Delivery activo, o el Delivery integrado del Gourmet activado (Config → Módulos).

5 Editar, activar/desactivar o eliminar una persona #

1 Editar: botón Editar en la fila, o doble clic sobre ella.
2 Eliminar: botón Desactivar en la fila (solo aparece para registro activo y que no sea de sistema) — confirme en el aviso.

i La eliminación solo es real cuando la persona nunca tuvo ningún vínculo (venta, compra, cuenta, crédito, preventa, presupuesto, condicional, devolución, delivery o login). Teniendo cualquiera de esos, el sistema solo la desactiva y mantiene el historial. No hay botón dedicado de "reactivar" — hay que editar el registro.

6 Registrar un aporte de crédito adelantado (cliente) #

1 Edite el cliente y abra la pestaña Crédito Adelantado.
2 Haga clic en "+ Registrar Aporte".
3 Informe el valor.
4 Si el dinero se acaba de recibir en el mostrador, marque "Recibido ahora en efectivo/tarjeta, en una caja abierta" y elija la caja — esto registra un suministro en esa caja.
5 Confirme — el saldo del cliente se actualiza al instante.

i Sin marcar la opción de la caja, el aporte se trata como recibido "por fuera" (ej.: transferencia) y no entra en ninguna conciliación de cierre de caja — aunque el dinero se haya recibido en el mostrador, hay que marcar la opción correcta. El saldo se descuenta solo en cada venta pagada con "Crédito del Cliente".

7 Dar un descuento fijo (%) a un cliente #

1 Edite el cliente y, en la columna Cliente, complete "Descuento fijo (%)" (ej.: 5). Máximo 50%.
2 Haga clic en Guardar. Si su perfil no tiene el permiso "Alterar desconto fixo (%) do cliente sem supervisor", el sistema pide la contraseña de un supervisor.
3 Listo: en toda venta de ese cliente (PDV Web, PDV Desktop, preventa, mesa, comanda y delivery) el descuento se aplica solo al identificarlo (F10). Aparece la línea "Descuento del cliente X%" en el total, en el F9 y en el ticket.

i Si el cliente también tiene derecho al descuento de turista, vale solo el MAYOR de los dos. El descuento del F7 se suma al del cliente. La contraseña se pide al CAMBIAR el registro (queda registrado quién autorizó), no en la venta. En el PDV Desktop el descuento llega en la próxima sincronización.

Pantallas y ventanas — referencia

Campos comunes a cualquier persona

Datos de Registro

CamposPaís (BR/PY), Tipo (Persona Física/Jurídica), Roles (se puede marcar más de uno), Nombre, documento (CPF/RG, CNPJ/Inscripción Estadual, Cédula o RUC según país/tipo), teléfonos (varios, con uno marcado como principal), correo, dirección completa, observaciones.

Al confirmarUna persona no puede quedar sin ningún rol marcado. Al crear, el País ya viene igual al de la empresa, para evitar un registro en el país equivocado.

Cliente

Campos y pestañas del Cliente

CamposLímite de crédito, Límite por período (Semanal/Quincenal/Mensual), Observaciones de crédito, Descuento fijo (%) — de 0 a 50, se aplica solo en las ventas del cliente; cambiarlo exige el permiso "cliente.desconto_fixo" o contraseña de supervisor.

Al confirmarDespués de guardado, gana las pestañas Historial de Compras, Cuentas por Cobrar (registrar/saldar cuentas) y Crédito Adelantado (extracto + "Registrar Aporte").

⚠La pantalla también guarda un campo "moroso" en el cliente, pero hoy ninguna parte del sistema lo marca como verdadero — en la práctica, ese campo no refleja nada todavía.

Proveedor

Campos y pestañas del Proveedor

CamposNingún campo específico — usa solo los campos comunes.

Al confirmarDespués de guardado, gana las pestañas Historial de Ventas (muestra las compras hechas a él) y Cuentas por Pagar (registrar/saldar cuentas).

Empleado

Campos y pestañas del Empleado

CamposCargo/Perfil (el mismo perfil de acceso usado en permisos), Fecha de Ingreso, Salario base, Tipo de Comisión (Ninguna/Por Venta/Por Cobro) + porcentaje.

Al confirmarDespués de guardado, gana la pestaña Rendición de Cuentas (extracto de vale, descuento, comisión y cierre — solo lectura aquí).

⚠El registro de vale/adelanto/cierre mensual se hace en Financiero → Empleados, no en esta pantalla. Y el login de acceso del empleado también se crea aparte, en Config → Usuarios.

MotoBoy

Campos y pestañas del MotoBoy

CamposNingún campo específico (sin vehículo ni zona de entrega) — usa solo los campos comunes.

Al confirmarDespués de guardado, gana la pestaña Estadísticas, que muestra el total de entregas completadas por él.

⚠El rol MotoBoy solo queda disponible para elegir si el módulo Delivery (o el Delivery del Gourmet) está activo en Config → Módulos.

Permisos y acceso

Cómo funciona acá

CamposNo hay contraseña de supervisor en esta pantalla — el control es todo por permiso de perfil (Config → Perfiles).

cadastro.ver

CamposNecesaria para ver la lista y el detalle completo de cualquier persona.

cadastro.criar

CamposNecesaria para crear Proveedor, Empleado o MotoBoy. Para crear solo un Cliente, quien tiene venda.criar (ej.: cajero, mozo) también puede, sin necesitar cadastro.criar — pensado para el registro rápido durante una venta.

cadastro.editar

CamposNecesaria para editar cualquier persona.

cadastro.excluir

CamposNecesaria para desactivar/eliminar.

Más detalles

Un registro, roles que se acumulan

La misma persona puede ser Cliente y Funcionario a la vez. Los 4 cards del hub (Clientes, Proveedores, Funcionarios, MotoBoy) abren la misma pantalla — solo cambian el filtro de rol. Marcá cuantos roles tengan sentido en el mismo registro; no dupliques la persona.

El país del cliente y la Regla Turista (Paraguay)

Si la empresa está registrada en Paraguay y el cliente tiene país distinto (ej.: brasileño), el POS aplica la Regla Turista (descuento de IVA) — y el único campo que importa para eso es el País del cliente, que ya es estándar en el registro. No hay nada extra que marcar acá. Si la empresa exige contraseña de supervisor, el POS la pide al identificar al cliente (F10).

Pestaña Funcionario

El % de comisión del vendedor está acá (Registros → Personas → pestaña Funcionario). El cálculo es por cobro — al contado sale en el momento, a plazo solo cuando la cuota se paga. El informe está en Informes → Financiero → Comisiones.
El login del sistema de esa persona no se crea acá — es en Configuraciones → Usuarios, donde se vincula el usuario a un Funcionario ya registrado.

Documento y autocompletado

Persona Jurídica: la lupa al lado del documento busca razón social, dirección y teléfono (CNPJ en Brasil, RUC en Paraguay).
Dirección en Brasil: ingresá el CEP y usá la lupa (ViaCEP).

Enlaces con otros módulos

Financiero — Crédito y Cuentas por Cobrar usan el cliente de acá; Comisiones usan el funcionario.
POS — F10 identifica al cliente en la venta; F3, al vendedor.

Actualizado el 2026-09-10