Operación diaria Capítulo 09

Clientes

Registra a quién le vendes: consumidores finales, contribuyentes y clientes del extranjero.

Dónde está: menú lateral → Clientes
Plan: Todos
Permiso: customers:read (crear customers:create, editar customers:update, eliminar customers:delete)

Los clientes son los receptores de tus documentos. El tipo de datos que registres determina qué documento podrás emitirles: una factura de consumidor final (FCF), un comprobante de crédito fiscal (CCF) o una factura de exportación (FEX). Los clientes pertenecen a toda la empresa (no a una sucursal).

Ver y buscar clientes

La lista muestra a tus clientes en tarjetas (12 por página). Cada tarjeta muestra las iniciales, el nombre y apellido, un badge de estado, la edad y género (si hay fecha de nacimiento), el DUI, teléfono, correo, departamento y “Registrado el {fecha}”. Un punto verde sobre el avatar indica que el cliente es facturable (vivo y activo).

Pasos:

Usa las píldoras de filtro por estado: Todos, Activos, Inactivos, Eliminados.
Busca en “Buscar por nombre, DUI o teléfono…” (busca por nombre, apellido, DUI, teléfono o correo).
Abre una tarjeta para ver el detalle, o usa el menú ”…” para Ver detalle, Editar o las acciones de ciclo de vida.

Estados del cliente: Activo (verde), Inactivo (gris), Eliminado (rojo).

Nota: los clientes inactivos o eliminados nunca aparecen en los buscadores de facturación o del POS: no se les puede emitir un documento nuevo.

Crear un cliente

Pulsa “Nuevo Cliente”. En la cabecera de la primera sección hay un interruptor Persona / Empresa que cambia los campos requeridos.

Datos personales / de la empresa

Campo	Descripción / validación
Nombre (o Nombre de la empresa)	Obligatorio. Solo letras, espacios, tildes y guiones (máx. 150).
Apellido	Obligatorio para Persona; opcional para Empresa.
Tipo de Documento	DUI, Pasaporte, Carnet de Residente u Otro. Por defecto DUI.
Número de {tipo}	Para DUI: 9 dígitos. La etiqueta cambia según el tipo elegido.
Fecha de Nacimiento	Opcional.
Género	Masculino, Femenino u Otro.
Teléfono	Formato “+503 7000-0000”.
Correo Electrónico	Si el correo ya existe en otro cliente, aparece un aviso ámbar (no bloquea).

Para Empresa solo se piden Nombre, Teléfono y Correo (se ocultan apellido, documento, fecha y género).

Cliente extranjero (para Factura de Exportación)

Activa el interruptor “Comprador del exterior (Factura de Exportación)”. Si el tipo de documento era DUI, cambia automáticamente a Pasaporte (un extranjero no puede usar DUI). Aparecen:

País (catálogo del MH).
Tipo de persona (Natural / Jurídica).
Actividad económica (texto libre, 5–150 caracteres; la exige Hacienda para el receptor de una FEX).

Dirección

Para un cliente nacional, los selectores dependen entre sí:

Departamento — al cambiarlo se limpian municipio y distrito.
Municipio — depende del departamento.
Distrito — obligatorio.
Complemento de dirección (máx. 200).

Para un cliente extranjero, la dirección es un solo campo libre “Dirección en el extranjero”.

Regla fiscal (2026): el Distrito depende del Departamento (no del municipio) y es obligatorio cuando hay departamento, por la reforma territorial y la exigencia del Ministerio de Hacienda.

Datos tributarios

Activa el interruptor “Contribuyente” si el cliente está inscrito en IVA y recibirá CCF. Aparecen:

Nombre / Razón Social
NIT (formato XXXX-XXXXXX-XXX-X)
NRC (formato XXXXXX-X)
Nombre Comercial (opcional)
Giro / Actividad Económica (buscador por código o descripción)

Notas

Notas del cliente (máx. 500) — de uso interno; nunca aparecen en los documentos que recibe el cliente.

Pulsa “Guardar Cliente”. Verás “Cliente creado exitosamente”.

Validaciones clave:

El DUI debe tener 9 dígitos y es único en toda la empresa (incluso entre los eliminados). Si intentas registrar uno repetido, Facturo abre un diálogo que te ofrece reactivar, restaurar o ver al cliente existente en lugar de duplicarlo.

Cliente nacional con departamento: exige un distrito que pertenezca a ese departamento.

Cliente extranjero: exige país, actividad económica, documento (no DUI) y dirección.

¿Qué documento podré emitirle?

Sin datos tributarios → consumidor final, solo recibe FCF.

Contribuyente → recibe CCF.

Extranjero → recibe FEX.

Editar y ver el detalle

Editar (customers:update): mismo formulario precargado. No aparece si el cliente está eliminado.
Detalle: ficha 360° con identidad, datos tributarios, dirección y un resumen financiero — botones para Nueva Cotización / Nueva Factura / Registrar Pago, y las tarjetas Total Facturado, Total Pagado y Saldo Pendiente (con conteo de vencidas), además de facturas, pagos y cotizaciones recientes.

Si el cliente está eliminado o inactivo, el detalle muestra un aviso que explica que no aparece en la facturación y cómo restaurarlo o reactivarlo.

Ciclo de vida del cliente

Desde el menú ”…” (en la lista o el detalle):

Acción	Permiso	Efecto
Marcar como inactivo	`customers:update`	Sale de los buscadores de facturación/POS; conserva su historial.
Reactivar	`customers:update`	Vuelve a ser facturable.
Eliminar (papelera)	`customers:delete`	Pasa a “Eliminados”. Sus facturas, pagos y libros fiscales se conservan.
Restaurar	`customers:delete`	Vuelve como Activo (no al estado anterior).

Nota: aunque un cliente esté inactivo o eliminado, sí puedes emitir documentos correctivos (Nota de Crédito / Débito) sobre sus facturas pasadas.

Importar y exportar (CSV)

Desde “Importar / Exportar”:

Descargar Plantilla CSV — con las columnas requeridas (Nombre, Apellido, TipoDocumento, NumeroDocumento, FechaNacimiento, Genero, Telefono, Email, CodigoDepartamento, CodigoMunicipio, ComplementoDireccion) y una fila de ejemplo.
Importar desde CSV — muestra cuántos clientes se detectaron; al confirmar reporta “{N} creados”, “{N} duplicados omitidos” y los errores por fila. Los duplicados por DUI se omiten (no cuentan como error).
Exportar Clientes (CSV) — descarga tus clientes activos e inactivos (los eliminados quedan fuera).