El formulario de Clientes te permite registrar un cliente nuevo o actualizar los datos de uno existente. Es la misma pantalla con dos modos: Crear (todos los campos vacíos) y Editar (datos pre-llenados del cliente). La diferencia visual: en edición, el documento aparece bloqueado porque es lo que identifica de forma única al cliente; en creación, eliges tipo y número desde cero.

El form está organizado en dos cards principales: Identidad (tipo de documento, número, razón social, nombre comercial, dirección) y Contacto y crédito (persona de contacto, email, teléfono, WhatsApp, días de crédito default, notas internas). A la derecha hay un aside informativo con explicación de dónde se usa el cliente (ventas, cotizaciones, CxC, comprobantes).

La función estrella es el botón 🔍 Buscar en SUNAT/RENIEC: si eliges tipo RUC o DNI, al hacer click consulta el padrón oficial y autocompleta la razón social y la dirección (solo para RUC). Esto te evita transcribir manualmente datos largos y reduce errores en la dirección que después aparece en la factura electrónica.

El cliente queda disponible para selección instantánea en el buscador de nueva venta y de cotizaciones. Si el cliente ya existe (mismo tipo y número de documento en tu negocio), el sistema actualiza en lugar de duplicar — el sistema no permite dos clientes iguales.

Manual completo

Modos del form: Crear vs Editar

Aspecto	Crear	Editar
Cómo llegas	Botón «+ Nuevo cliente»	Click en un cliente del listado
Documento (tipo + número)	Editable	Bloqueado (no se puede cambiar)
Botón 🔍 SUNAT/RENIEC	Disponible	No disponible (doc no editable)
Botón «Desactivar/Reactivar»	No aparece	Sí aparece (activa o desactiva el cliente)
Al guardar	Vuelve al listado con el mensaje «Cliente {nombre} guardado»	Vuelve al listado con el mensaje «Cliente actualizado»

💡 ¿Por qué el documento no se edita? Porque el negocio, el tipo y el número de documento son la combinación única que identifica al cliente. Editarlo rompería los vínculos con ventas, cotizaciones y cuentas por cobrar históricas. Si te equivocaste al tipear el RUC, la única salida es desactivar este cliente y crear uno nuevo con el documento correcto.

Card «Identidad»

Campo	Obligatorio	Validación	Notas
Tipo de documento	Sí	DNI, RUC, CE, PASAPORTE u OTROS	Por defecto DNI en creación.
Número de documento	Sí (excepto si tipo = OTROS)	Se valida al guardar según el tipo: RUC exactamente 11 dígitos, DNI 8 dígitos; sin espacios ni guiones	Un espacio pegado a un RUC (típico del copiar-pegar) antes se guardaba pero impedía emitir la factura; ahora se bloquea al guardar.
Razón social / Nombre	Sí	Obligatorio, hasta 255 caracteres	Para personas: nombre completo. Para empresas: razón social formal.
Nombre comercial	No	Opcional, hasta 255 caracteres	El nombre con el que lo conoces tú (ej. «Tienda Don Pepe» aunque su razón sea «Inversiones Pacheco S.A.C.»).
Dirección	Sí solo si tipo=RUC	Opcional, hasta 500 caracteres	Obligatoria para RUC porque va en el campo «Dirección del cliente» de la factura electrónica que pide SUNAT.
Distrito	No	Selector con buscador; el ubigeo se calcula solo al elegir	Búscalo por nombre («Miraflores, Lima, Lima»). No tecleas el ubigeo: se completa al elegir el distrito. Sirve para que las Guías de Remisión autocompleten la dirección del cliente.

💡 El distrito ahorra trabajo después: al guardar el distrito, cuando emitas una Guía de Remisión a ese cliente su dirección y ubigeo ya vienen puestos (no tienes que buscarlos en plena guía).

Card «Contacto y crédito»

Campo	Obligatorio	Validación
Persona de contacto	No	Opcional, hasta 255 caracteres. Útil cuando el cliente es empresa y tienes que coordinar con alguien específico.
Email	No	Opcional, formato de correo válido. Si el cliente recibe facturas electrónicas, el comprobante se le envía a este correo.
Teléfono	No	Opcional, hasta 20 caracteres
WhatsApp	No	Opcional, hasta 20 caracteres. Formato sugerido 51999888777 (con código de país, sin +).
Crédito default (días)	No	Número entero de 0 a 365. 0 = solo contado (cobro al instante).
Notas internas	No	Opcional, hasta 1000 caracteres. Texto privado solo visible para ti. NO va en comprobantes.

El botón 🔍 Buscar en SUNAT/RENIEC

Aparece solo cuando el tipo es RUC o DNI y solo en modo «Crear». Cuando lo presionas:

Tipo	Consulta	Qué autocompleta
RUC	Consulta a SUNAT	La razón social (nombre oficial en SUNAT) + la dirección fiscal que figura en SUNAT, si está disponible.
DNI	Consulta a RENIEC	El nombre completo según RENIEC. NO devuelve dirección — el DNI no la guarda en RENIEC.

Error	Mensaje en el form
Documento vacío	«Ingresa primero el número de documento.»
Tipo distinto de RUC/DNI	«La búsqueda en padrones solo aplica a RUC o DNI.»
Documento no existe	«{TIPO} {número} no encontrado en SUNAT/RENIEC.»
RUC con formato inválido	«RUC inválido: debe tener 11 dígitos.»
El servicio no responde	Error del servicio de consulta (ve a la pantalla Consultas SUNAT para volver a intentar).

💡 Se recuerda 24 horas: la primera consulta a un RUC/DNI va al padrón oficial (tiene un costo). Durante las siguientes 24 horas se responde desde una copia guardada — gratis y casi instantánea. Si necesitas datos actualizados, usa la pantalla Consultas SUNAT con el botón «↻ Refrescar».

Toggle Activar / Desactivar (solo en edición)

Botón con icono de encendido en la parte superior del formulario. Activa o desactiva el cliente:

• Desactivar: el cliente pasa a inactivo. Deja de aparecer en los buscadores de ventas/cotizaciones. Sus ventas históricas siguen intactas.
• Reactivar: el cliente vuelve a activo. Vuelve a aparecer en los buscadores.

Ambas acciones muestran un mensaje de confirmación («Cliente desactivado» / «Cliente reactivado»).

Flujos completos

Crear cliente desde cero con búsqueda SUNAT (caso típico de factura)

1. Entra a crear un cliente nuevo (botón «+ Nuevo cliente»).
2. Eliges tipo = RUC.
3. Tipeas el RUC de 11 dígitos.
4. Click 🔍 Buscar → autocompleta razón social y dirección.
5. Llenas WhatsApp y email del contacto (opcional pero recomendado para factura).
6. Click Guardar cliente → vuelves al listado con un mensaje de confirmación.

Crear cliente «Varios» sin documento (boleta de mostrador)

1. Tipo = OTROS.
2. Número de documento vacío (permitido para OTROS).
3. Razón social = «Cliente mostrador» o «Varios».
4. Guardar.

Editar email de un cliente existente

1. Desde el listado, click en su fila.
2. Cambias el email en la card «Contacto y crédito».
3. Click Guardar cambios → mensaje de confirmación.

Desactivar un cliente que ya no compra

1. Entras al cliente desde el listado.
2. Click en Desactivar (botón en la parte superior).
3. Confirmación inmediata. El cliente desaparece de los buscadores pero queda en la pestaña «Inactivos».

Casos comunes

«El botón Buscar SUNAT/RENIEC no aparece» Aparece solo si el tipo de documento es RUC o DNI. Si elegiste CE, PASAPORTE u OTROS, no hay padrón externo donde buscar.

«SUNAT me dice que el RUC está SUSPENDIDO o de BAJA» La búsqueda autocompleta los datos igual, pero ⚠ ese RUC puede rechazar comprobantes electrónicos. Para validarlo antes de venderle, usa la pantalla Consultas SUNAT que te muestra estado del contribuyente y condición de domicilio con badges visuales.

«Guardé el cliente pero quería corregir el número de RUC» El RUC no se edita. Tienes que desactivar este cliente y crear uno nuevo con el RUC correcto. Sus ventas anteriores (si las hay) seguirán vinculadas al cliente desactivado.

«El sistema dice que la dirección es obligatoria para RUC» Regla de Gestión: cualquier cliente con RUC requiere dirección porque la factura electrónica la lleva como campo obligatorio. Si SUNAT no te devolvió dirección o el cliente vino a darte solo el RUC sin papeles, pídele al cliente su dirección fiscal exacta antes de guardar.

«Quiero que un cliente tenga 15 días de crédito automáticos» En el campo «Crédito default» pon 15. Al crear una venta a ese cliente, el método de pago «Crédito» asumirá 15 días para vencimiento de la cuenta por cobrar. Es solo el default — puedes sobrescribirlo en cada venta.

«¿Por qué hay una ventana de creación rápida distinta a este formulario?» Esa ventana de creación rápida se abre desde dentro del formulario de Nueva venta cuando agregas un cliente nuevo en plena venta. Es una versión reducida del formulario (solo 5 campos esenciales) que se cierra y deja al cliente recién creado seleccionado en la venta. Este formulario completo es el que ves al crear desde Contactos.

«Hay un cliente que nunca creé ni desde este form ni desde la ventana rápida» Hay una tercera vía, totalmente automática: si emites un comprobante, aceptas una cotización o emites una guía a un cliente con RUC o DNI real que tecleaste (sin elegirlo del directorio), el sistema lo registra solo, sin pasar por ningún formulario. Puedes completarle el resto de los datos (email, WhatsApp, crédito) entrando a su ficha desde aquí normalmente.

Cosas que NO puedes hacer

• Cambiar el tipo de documento o el número de un cliente ya creado.
• Borrar un cliente físicamente — solo desactivarlo.
• Crear dos clientes con el mismo tipo y número de documento en el mismo negocio — el sistema lo impide. La segunda creación actualiza el existente.
• Subir foto/avatar — el avatar se genera automáticamente con las iniciales del nombre y un color.
• Asignar un cliente a otro negocio — cada cliente pertenece a un solo negocio. Si el mismo cliente compra en dos de tus negocios, lo registras en ambos.
• Forzar el RUC al guardar si SUNAT lo marca SUSPENDIDO — el formulario NO bloquea por estado del contribuyente, solo te avisa visualmente desde Consultas SUNAT. Tú decides si proceder o no. Pero SUNAT sí puede rechazar el comprobante al emitirlo.
• Editar los días de crédito de una venta pasada desde aquí — es solo el valor sugerido por defecto para ventas futuras.