Tipos de cliente (business_type)
| Valor | Etiqueta | Cuándo usar |
|---|---|---|
non-business | Persona Individual | Consumidor final sin actividad empresarial. Se identifica con DUI, pasaporte u otro documento personal |
natural | Persona Natural | Contribuyente individual con número de registro (NRC) y NIT |
legal | Persona Jurídica | Empresa o sociedad con razón social, NRC y NIT |
Crear un cliente
Datos básicos
| Campo | Descripción |
|---|---|
| Nombre comercial | Nombre que aparece en el sistema y en facturas |
Razón social (legal_name) | Nombre legal completo (para natural y legal) |
| Tipo de cliente | non-business, natural o legal |
| Tamaño de empresa | Clasificación interna (grande, mediano, pequeño, micro) |
Identificación fiscal
| Campo | Descripción |
|---|---|
Número de Registro (register_number) | NRC del contribuyente |
NIT (tax_number) | Número de Identificación Tributaria |
| Tipo de documento | Para personas individuales: DUI, pasaporte, carné de residente, etc. |
| Número de documento | Número del documento seleccionado |
| Actividad económica | Actividad fiscal del cliente |
Datos de contacto y ubicación
Teléfono, correo electrónico, país, departamento, municipio y dirección completa.
Configuración especial
| Campo | Descripción |
|---|---|
Exento de IVA (is_exent) | Si está activo, el sistema elimina el IVA de los precios al facturar a este cliente — incluso si los productos son gravados |
Institución Pública (is_public_institution) | Marca al cliente como entidad gubernamental. Afecta el tipo de documento fiscal emitible según normativa |
| Cuenta contable | Cuenta de cuentas por cobrar que se usará para los asientos contables de ventas a este cliente |
Exención de IVA
Cuando un cliente tieneis_exent = true, al seleccionarlo en una venta:
- El sistema cambia automáticamente el documento a modo exento.
- Los productos gravados se facturan sin IVA — el precio se divide por 1.13 para obtener el valor base.
- El total de la venta refleja el precio sin impuesto, que es el monto que el cliente paga.
La exención aplica incluyendo descuentos por promociones — los precios combo y override_price también se dividen por 1.13 para clientes exentos.
Institución pública
Los clientes marcados como institución pública (is_public_institution = true) requieren tipos de documento específicos según la normativa fiscal local. El sistema restringe los tipos de DTE disponibles al facturar a estas entidades.
Perfil del cliente
Desde el detalle de cada cliente se puede ver:- Historial completo de ventas y cotizaciones.
- Saldo pendiente de cobro.
- Datos fiscales y de contacto.