El módulo de Proveedores centraliza toda la información de los emisores de documentos que maneja el negocio: desde el RUT oficial hasta el plazo de pago acordado. Contar con un directorio bien mantenido tiene dos beneficios directos en GastosApp: el auto-completar en formularios rellena la categoría (y el RUT en facturas) al escribir el nombre del proveedor, y la auto-categorización en tres niveles del importador CSV del SII aprovecha el RUT registrado para clasificar las facturas importadas sin intervención manual. Además, al cambiar la categoría de un proveedor, el mismo modal de cascada que usa el módulo de Categorías permite actualizar todos los documentos asociados de forma controlada.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/Davidmallega/Gastos-App/llms.txt
Use this file to discover all available pages before exploring further.
Campos del proveedor
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
id | string | Sí (auto) | Identificador único generado al crear el proveedor. |
rut | string | No | RUT en formato chileno (ej. 76.543.210-K). Se usa para matching en la importación CSV y auto-completar en Facturas SII. |
razonSocial | string | Sí | Nombre legal del proveedor. Es el único campo obligatorio. |
nombreFantasia | string | No | Nombre comercial con el que se conoce al proveedor en el día a día. Si está presente, se muestra como nombre principal en la tarjeta. |
contacto | string | No | Email o teléfono de contacto. La UI detecta automáticamente si contiene @ para mostrar ícono de correo o de teléfono. |
categoria | string | No | Categoría del catálogo asignada al proveedor. Se propaga automáticamente a los formularios de gasto y factura al auto-completar. |
plazoPago | number | null | No | Número de días para calcular _fechaVencimiento al momento del render. null indica pago inmediato (sin plazo). |
observaciones | string | No | Notas adicionales de libre texto (condiciones especiales, referencias de contacto, etc.). |
Agregar un proveedor
Abrir el formulario
Ve a Administración → Proveedores y haz clic en Nuevo Proveedor (esquina superior derecha).
Completar los datos
El único campo obligatorio es Razón Social. Se recomienda ingresar el RUT si el proveedor emite facturas SII, ya que eso habilita el matching automático en la importación de CSV.El campo RUT aplica formato chileno automáticamente mientras se escribe (ej.
76.543.210-K).Asignar categoría y plazo de pago
Selecciona la categoría del desplegable. Si el proveedor tiene plazo de pago acordado, elige el número de días en el selector de Plazo de pago (7, 10, 15, 20, 30, 45 o 60 días). Deja el campo vacío para pago inmediato.
Auto-completar en formularios
Al escribir el nombre de un proveedor en el campo Proveedor de los módulos Gastos por Caja o Facturas SII, GastosApp busca coincidencias en el directorio comparando el texto ingresado con larazonSocial y el nombreFantasia de cada proveedor registrado (la comparación es insensible a mayúsculas).
Cuando se selecciona una coincidencia:
- En Gastos por Caja: se rellena automáticamente el campo Categoría con la categoría del proveedor.
- En Facturas SII: se rellena automáticamente Categoría y también el campo RUT Proveedor con el
rutdel directorio.
Plazo de pago
El campoplazoPago almacena un número entero que representa días. GastosApp no guarda una fecha de vencimiento fija en el documento; en cambio, calcula _fechaVencimiento al momento de renderizar combinando la fecha del documento más el plazo del proveedor.
Los valores disponibles en el selector son: 7, 10, 15, 20, 30, 45 y 60 días. Si el campo queda en null, el proveedor se considera de pago inmediato y no se calcula fecha de vencimiento adicional.
Actualización en cascada de categoría
Cuando se edita un proveedor y se cambia su campo Categoría, GastosApp verifica si existen documentos (gastos caja o facturas) cuyo campoproveedor coincida con la razón social o el nombre fantasía del proveedor, o cuyo rutProveedor coincida con el RUT registrado.
Si hay documentos asociados, aparece el mismo modal de cascada que usa el módulo de Categorías, con las tres opciones de alcance:
| Opción | Efecto |
|---|---|
| Solo pendientes | Actualiza la categoría únicamente en documentos con pagado: false. Los documentos ya pagados conservan su categoría original. |
| Todos los documentos | Actualiza la categoría en todos los documentos asociados al proveedor, independientemente de su estado de pago. |
| No actualizar | Solo guarda la nueva categoría en el directorio del proveedor. Los documentos existentes no se modifican. |
La detección de documentos asociados busca por
razonSocial, nombreFantasia y rut simultáneamente, por lo que el matching es robusto incluso cuando los registros históricos usaron el nombre fantasía en lugar del nombre legal.