Skip to content

Clientes ​

El módulo de Clientes es tu base de datos comercial: guarda los datos de cada cliente, incluidos sus datos fiscales para facturar, y centraliza su historial: ventas, créditos (ventas a crédito), notas de crédito y cotizaciones.

Para acceder, ingresa al panel en https://zenci.app y ve a Clientes.

Lista de clientes con nombre, teléfono, correo e identificaciónLista de clientes con nombre, teléfono, correo e identificación
Clientes: busca, importa o crea clientes para asociarlos a tus ventas.

Crear un cliente ​

  1. Ve a Clientes y haz clic en Nuevo Cliente.
  2. Ingresa el nombre completo.
  3. Agrega los datos de contacto (teléfono, correo, dirección).
  4. Elige la Categoría fiscal y completa los datos fiscales si el cliente requiere factura con sus datos.
  5. Si trabajas con , elige la Lista de precios del cliente.
  6. Haz clic en Guardar.
Formulario de nuevo cliente con nombre, identificación, teléfono, correo, categoría fiscal, retenedor de impuestos y lista de preciosFormulario de nuevo cliente con nombre, identificación, teléfono, correo, categoría fiscal, retenedor de impuestos y lista de precios
Nuevo cliente: contacto, categoría fiscal, retenedor de impuestos y lista de precios.

También puedes crear un cliente directamente desde la pantalla de cuando lo necesites en el momento. En ese formulario rápido el Tipo de receptor arranca como No contribuyente (Consumidor Final): cámbialo a Contribuyente solo si el cliente te pide factura con su RUC.

Datos fiscales y validación de RUC ​

Para emitir una factura electrónica a nombre del cliente necesitas sus datos fiscales, principalmente el RUC y su DV. Zenci los consulta en la DGI de Panamá para confirmar que sean correctos antes de facturar.

Campo fiscalDescripción
Tipo de receptor / Categoría fiscalContribuyente (persona natural o jurídica), No contribuyente (Consumidor Final), Gobierno (entidades del Estado) o Extranjero.
Tipo de personaNatural o jurídica. Lo decide la cédula o el RUC que escribas (ver abajo).
RUCRegistro Único de Contribuyente. Obligatorio para contribuyentes y entidades de gobierno.
Dígito verificador (DV)Complemento del RUC. Obligatorio cuando hay RUC: sin él la DGI rechaza la factura.
Razón socialNombre fiscal del cliente, el que lleva la factura electrónica.

El tipo de persona lo decide la cédula o el RUC ​

Al escribir el identificador, Zenci ajusta solo el tipo de persona: una cédula (por ejemplo 8-123-4567, PE-13-2168 o E-8-12345) es de persona natural; un RUC de empresa es de persona jurídica. Si el tipo elegido no corresponde al identificador, el formulario lo dice (por ejemplo, "Ese identificador es de persona natural: corrige el tipo o el RUC.") y no deja guardar, porque la DGI rechazaría la factura. La opción Gobierno es la excepción: la eliges tú, sobre el RUC de la entidad.

Autocompletar con la DGI y el DV ​

Junto al RUC tienes el botón Autocompletar (o Validar, según la pantalla). Al usarlo, Zenci consulta la DGI y completa la razón social, el DV y el tipo de contribuyente.

Si guardas un cliente con RUC pero sin DV, Zenci lo busca solo en la DGI:

  • Si lo encuentra, lo completa y te pide revisar los datos y volver a guardar.
  • Si la DGI no lo devuelve, el formulario te pide escribirlo: sin el DV no se guarda.

Si a un cliente ya registrado le falta el DV, Zenci avisa al momento de facturar en vez de enviar a la DGI un documento que sería rechazado. Abre la ficha del cliente, pulsa Autocompletar o escribe el DV, y vuelve a intentarlo.

Clientes extranjeros ​

Para un cliente Extranjero se pide su pasaporte o identificación tributaria extranjera y su país. Ese identificador no se valida en la DGI ni lleva DV, y el correo es obligatorio, porque la factura se le entrega por correo.

Nombre y razón social en los comprobantes ​

Cuando el nombre con que conoces al cliente es distinto de la razón social de sus datos fiscales, los comprobantes muestran los dos: así se reconoce al cliente por su nombre y se ve que la factura electrónica, que lleva la razón social, es la suya.

Consumidor Final

No todas las ventas requieren un cliente registrado. Para ventas sin datos fiscales puedes usar Consumidor Final en la pantalla de venta. Registra el cliente solo cuando necesites factura con RUC, crédito o apartado.

Lista de precios del cliente ​

Si tu negocio usa , puedes asignarle una a cada cliente desde el campo Lista de precios de su ficha (al crearlo o editarlo). Al cobrar o cotizar para ese cliente, sus precios se aplican solos. En el listado de Clientes se ve qué lista tiene asignada cada uno.

Clientes retenedores de impuestos ​

Algunos clientes —entidades del Estado, o compradores obligados por la DGI— retienen una parte del ITBMS de la factura y la pagan ellos directamente al fisco. En Zenci puedes marcar a esos clientes para que la retención se calcule y se registre sola en cada venta.

En el formulario del cliente (tanto al crearlo como al editarlo) elige el tipo de agente retenedor:

Tipo de agente retenedorRetiene
Pago por servicio profesional al estado100% del ITBMS
Pago por venta de bienes/servicios al estado50% del ITBMS
Pago o acreditación a no domiciliado o empresa constituida en el exterior100% del ITBMS
Pago o acreditación por compra de bienes/servicios50% del ITBMS

Los clientes marcados muestran una etiqueta de retenedor en su ficha. Si el cliente no retiene —el caso normal— deja la opción en No es retenedor.

Cómo se aplica al cobrar ​

Al asignar un cliente retenedor en una venta al contado, Zenci calcula el monto retenido (ITBMS × el porcentaje de su tipo) y lo registra como un pago aparte llamado Retención de impuestos. Así los pagos suman el total de la factura, como exige la DGI, pero ese monto no entra a la caja ni descuadra tu arqueo.

El monto no es editable, y una venta solo puede retener una vez. El tipo de retenedor viaja en la factura electrónica, de modo que la consulta pública de la DGI muestra el desglose.

Si la venta se cierra sin la retención

Si quitas la línea de retención, o si los pagos ya cubren el total y no queda saldo donde aplicarla, Zenci deja un aviso en pantalla que indica cuánto se está dejando de retener y qué hacer para aplicarla.

Dónde no aplica ​

La retención se calcula sobre la factura, no sobre cada cobro, así que no aplica en:

  • Ventas a crédito.
  • Abonos y liquidación de saldos.
  • Depósitos de apartado.

En esos casos el cliente retiene cuando paga, no cuando se factura. Tampoco puede elegirse a mano como método de cobro: Zenci la aplica sola cuando corresponde.

En devoluciones y reportes ​

  • En una devolución de una venta con retención, el reembolso se reparte solo: se devuelve en efectivo lo que de verdad entró y se descuenta lo retenido, sin que tengas que calcularlo.
  • En el reporte de métodos de pago la retención aparece como una línea aparte marcada como informativa y fuera del gráfico, para que no se confunda con ingresos reales.

Créditos (ventas a crédito) ​

Cuando un cliente compra a crédito, el saldo pendiente queda registrado como un crédito en su ficha. Desde ahí puedes:

  • Ver el saldo pendiente y las ventas a crédito asociadas.
  • Usar Pagar créditos para registrar un abono o saldar la deuda (incluso de varios créditos a la vez).
  • Consultar las fechas y montos de cada movimiento.

Controla el crédito otorgado

Revisa periódicamente los créditos para dar seguimiento a los saldos vencidos. Un buen control del crédito mantiene sano el flujo de caja del negocio.

Apartados ​

Un apartado permite que el cliente reserve productos y los pague en abonos antes de llevárselos. Los apartados se crean desde la pantalla de y se gestionan desde su propia sección en Ventas › Apartados (no desde la ficha del cliente). Al completar el pago, el apartado queda listo para entregarse.

Historial del cliente ​

Cada ficha de cliente reúne su historial en pestañas: Órdenes, Cotizaciones, A crédito y Notas de crédito. Esto te permite conocer el comportamiento de compra y dar una mejor atención.

Ficha de una clienta con sus datos y las pestañas de órdenes, cotizaciones, créditos y notas de créditoFicha de una clienta con sus datos y las pestañas de órdenes, cotizaciones, créditos y notas de crédito
La ficha del cliente con su historial de compras.

Si una venta se cobró sin elegir al cliente, puedes asignárselo después desde el detalle de la venta con Asignar cliente (o Cambiar cliente, si tenía otro). Así la compra queda en el historial de ese cliente. Consulta si además necesitas corregir la factura.

Siguientes pasos ​

  • — Asigna clientes, vende a crédito y crea apartados.
  • — Emite facturas electrónicas con los datos fiscales del cliente.
  • — Sincroniza tu base de clientes por API.

Documentación oficial de Zelta