El formulario de Proveedores te permite registrar una empresa o persona a la que tu MYPE le compra mercadería, insumos o servicios. Es la misma pantalla con dos modos: Crear (campos vacíos, tipo por defecto = RUC) y Editar (datos pre-llenados, con el documento bloqueado para edición).

Está organizado en dos cards: Identificación (tipo de documento, número, razón social, nombre comercial, dirección) y Contacto y crédito (persona de contacto, teléfono, email, días de crédito default, notas internas). El layout interno usa grid de 3 columnas (tipo + número + razón social en la misma fila) — más compacto que el form de clientes.

A diferencia del form de clientes, el documento es siempre obligatorio en proveedores — el RUC es lo que SUNAT te exige para asentar el crédito fiscal de cada compra. El default del tipo es RUC (no DNI como en clientes) porque la mayoría de proveedores son empresas.

La feature 🔍 SUNAT funciona igual que en clientes: si eliges tipo RUC o DNI, consulta el padrón vía Migo y autocompleta razón social y dirección (solo para RUC, RENIEC no devuelve dirección). El cache es de 24h. Para proveedores con RUC, la dirección es obligatoria porque es el dato que va en tu registro de compras.

Manual completo

Modos del form: Crear vs Editar

Aspecto	Crear	Editar
Cómo se abre	Con «+ Nuevo proveedor»	Al hacer click en un proveedor del listado
Documento (tipo + número)	Editable	Bloqueado — aparece como bloque con avatar + etiqueta de estado
Botón 🔍 SUNAT	Disponible	No disponible (doc fijo)
Botón «Desactivar/Reactivar»	No aparece	Sí aparece (activa o desactiva el proveedor)
Default tipo doc	RUC	(heredado del proveedor existente)
Aside derecho	«Sobre proveedores» (texto explicativo)	«Tips» con recordatorio de cómo cambiar el RUC

💡 ¿Por qué el documento no se edita? Igual que en clientes: no puede haber dos proveedores con el mismo tipo y número de documento en tu negocio. Cambiar el RUC rompería los vínculos con compras y cuentas por pagar históricas. La salida correcta: desactivar este proveedor y crear uno nuevo con el RUC correcto.

Card «Identificación»

Campo	Obligatorio	Validación	Notas
Tipo de documento	Sí	Uno de: RUC, DNI, CE, PASAPORTE, OTROS	Por defecto RUC. La mayoría de proveedores son empresas.
Número de documento	Sí (siempre)	Se valida al guardar según el tipo: RUC exactamente 11 dígitos, DNI 8 dígitos; sin espacios ni guiones	A diferencia de clientes, en proveedores siempre exigido. Un espacio pegado al RUC antes se guardaba pero rompía la emisión; ahora se bloquea al guardar.
Razón social	Sí	Obligatorio, hasta 255 caracteres	Razón social formal — exactamente como aparece en sus comprobantes.
Nombre comercial	No	Opcional, hasta 255 caracteres	Como tú lo conoces (ej. «Ferretería Don Juan» aunque su razón sea «Comercializadora ABC S.A.C.»).
Dirección	Sí, solo si el tipo es RUC	Opcional, hasta 500 caracteres	Obligatoria para RUC. Es el dato que va a tu registro de compras para SUNAT.
Distrito	No	Selector con buscador; el ubigeo se calcula solo al elegir	Búscalo por nombre («Miraflores, Lima, Lima»). No tecleas el ubigeo. Sirve para que las Guías de Remisión de compra autocompleten la dirección del proveedor como origen.

Card «Contacto y crédito»

Campo	Obligatorio	Validación
Persona de contacto	No	Opcional, hasta 255 caracteres. Útil para coordinar entregas o cobranzas.
Teléfono	No	Opcional, hasta 20 caracteres.
Email	No	Opcional, debe ser un correo válido, hasta 255 caracteres. Para recibir cotizaciones, comprobantes electrónicos del proveedor, etc.
Crédito por defecto (días)	No	Opcional, número entre 0 y 365. 0 = solo contado. Se puede cambiar en cada compra.
Notas internas	No	Opcional, hasta 1000 caracteres. Texto privado solo visible para ti.

💡 Diferencia con clientes: el form de proveedores no tiene campo WhatsApp porque la comunicación operativa con proveedores típicamente es por email o teléfono fijo. Si lo necesitas, ponlo en «Notas internas».

El botón 🔍 SUNAT (Buscar en padrones)

Funciona solo cuando el tipo es RUC o DNI y solo en modo «Crear»:

Tipo	Qué consulta	Qué autocompleta
RUC	Padrón RUC de SUNAT	Razón social + dirección (si SUNAT la tiene registrada).
DNI	Padrón RENIEC	Nombre completo (= razón social). El DNI no devuelve dirección.

Caso de error	Mensaje
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 en padrón	«{TIPO} {número} no encontrado en SUNAT/RENIEC.»
Formato inválido	«RUC inválido: debe tener 11 dígitos.» / «DNI inválido: debe tener 8 dígitos.»
Servicio caído / sin configurar	Error de conexión con el servicio de consulta, o falta configurar el token de acceso.

Toggle «Desactivar / Reactivar proveedor» (solo en edición)

Botón en la parte superior del formulario. Activa o desactiva el proveedor:

• Desactivar: el proveedor queda inactivo. Deja de aparecer como sugerencia en el form de compra. Sus compras pasadas siguen visibles.
• Reactivar: lo vuelve a activar.

Mensaje de confirmación: «Proveedor desactivado» / «Proveedor reactivado».

Flujos completos

Crear proveedor con búsqueda SUNAT (flujo típico)

1. Abre «+ Nuevo proveedor».
2. Tipo = RUC (por defecto).
3. Tipeas el RUC del proveedor (11 dígitos).
4. Click 🔍 SUNAT → autocompleta razón social y dirección.
5. Llenas persona de contacto, teléfono y email (opcionales pero útiles).
6. Si te dan crédito a 30 días, pones 30 en el crédito por defecto.
7. Click Guardar proveedor → redirect al listado.

Crear proveedor manualmente (sin SUNAT) Si el proveedor es persona natural con DNI o no tiene RUC: eliges tipo apropiado, llenas razón social y datos a mano, click Guardar.

Editar el email de cobranza de un proveedor existente

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

Desactivar un proveedor con el que ya no trabajas

1. Entras desde el listado.
2. Click en Desactivar proveedor (botón ghost en header).
3. Deja de aparecer en typeaheads de nuevas compras. Sus compras históricas siguen intactas.

Casos comunes

«El RUC que ingresé está SUSPENDIDO según SUNAT» El form deja registrarlo igual — no bloquea por estado. Pero ⚠ cuando hagas una compra a ese proveedor con factura electrónica, SUNAT puede rechazar el crédito fiscal porque el emisor no estaba habilitado. Antes de hacer compras grandes, valida en Consultas SUNAT que esté ACTIVO y HABIDO.

«El sistema me obliga a poner dirección porque puse RUC» Es por diseño. Pídele al proveedor su dirección fiscal exacta (la que él declara en SUNAT) y completa. Si SUNAT no te devolvió dirección automáticamente, es porque el proveedor tiene su domicilio fiscal marcado como «no habido» y SUNAT lo oculta.

«El proveedor cambió de domicilio fiscal» Entras a su edición y actualizas el campo «Dirección». El cambio aplica a las nuevas compras que registres — las compras pasadas conservan el snapshot de los datos del momento (la dirección que iba en aquella factura no se modifica retroactivamente).

«Quiero cambiar la condición de crédito de un proveedor de 15 a 30 días» Edita el proveedor, cambia el campo «Crédito default». Las compras pasadas conservan los 15 días que tenían — las nuevas heredan 30. Cada compra puede sobrescribirlo en su propio form.

«¿Por qué el form me deja crear un proveedor tipo OTROS sin documento?» El sistema pide que el número de documento sea obligatorio, pero si por algún caso raro te deja crear uno sin documento (ej. una importación del sistema viejo o tipo OTROS), no vas a poder usarlo en SUNAT. Considera completarlo antes de hacer compras.

«Acabo de crear un proveedor desde la creación rápida de una compra y no veo todos sus datos» La creación rápida (que aparece dentro del form de compra) pide solo datos esenciales (tipo, doc, razón, dirección, email, teléfono). Si quieres llenar persona de contacto, condición de crédito o notas, abre el proveedor desde el listado y completa los campos restantes.

Cosas que NO puedes hacer

• Cambiar el RUC de un proveedor existente. Si tu proveedor cambió de RUC (caso muy raro), desactivas el viejo y creas uno nuevo.
• Borrar físicamente un proveedor — solo desactivar.
• Crear dos proveedores con el mismo RUC en tu negocio — el sistema no lo permite. La segunda creación actualiza el primero.
• Asignar WhatsApp a un proveedor desde este form — el campo no existe. Ponlo en notas internas si lo necesitas.
• Subir foto/logo del proveedor — el avatar se genera automáticamente de las iniciales del nombre.
• Forzar el RUC si SUNAT lo marca SUSPENDIDO o NO HABIDO — el form no bloquea, pero podrías tener problemas con el crédito fiscal al declarar IGV mensual.
• Compartir el proveedor con otro negocio — cada negocio mantiene su propio directorio.
• Convertirlo en cliente — son registros distintos. Créalo en el listado de clientes como entidad separada.