--- audiencia: usuario screen_key: configuracion/empresa titulo: Información de la Empresa aliases: - datos de la empresa - razon social - timbrado - certificado digital - actividades economicas - empresas asociadas - suscripcion - logo empresa - correo de notificacion - marangatu - marangatú - acceso a marangatu - configurar marangatu - credenciales marangatu - usuario y clave marangatu - integracion marangatu - integracion set - sincronizacion marangatu - importar facturas marangatu --- # Información de la Empresa Esta guía describe todo lo que se configura bajo el grupo **Empresa** en el menú de Configuración: los datos de identificación fiscal, el correo desde el cual salen las facturas, los datos SIFEN (timbrado, certificado digital y actividades económicas), la administración de **empresas asociadas** (holding / sucursales corporativas / resellers) y la **suscripción** del sistema. ## Dónde está esto en el menú `Configuración → Empresa → Datos de la Empresa` (secciones: Información de la Empresa, Facturación Electrónica/SIFEN, Timbrado, Certificado, Actividades y —si está habilitado— **Integración Marangatu (SET)**) `Configuración → Empresa → Empresas Asociadas` `Configuración → Empresa → Suscripción` `Configuración → Inicio` (Onboarding: checklist de configuración — es una categoría de primer nivel independiente, no un item dentro de "Empresa") ## Conceptos generales - **Empresa** = persona jurídica o física contribuyente ante la SET. Cada empresa tiene su propio RUC, timbrado, certificado, plan de suscripción y, dentro de ella, una o más **sucursales** y **cajas/puntos de expedición**. - **Tipo Contribuyente**: se asigna automáticamente al cargar el RUC. RUC ≥ 80.000.000 → **Persona Jurídica**, menor → **Persona Física**. El superadmin puede sobreescribirlo manualmente. - **Estado de la empresa**: catálogo `estado_empresa` (Pendiente, En verificación, Activo, Bloqueado, Rechazado). Una empresa **Bloqueada** no factura. - **Onboarding obligatorio**: para emitir comprobantes electrónicos hay 7 pasos: Datos básicos, Logo, Sucursal, Punto de expedición con numeración, Timbrado, Certificado digital y Actividades económicas. El dashboard de Configuración → Inicio muestra el progreso y enlaza a cada pantalla. - **Quién puede editar qué**: - **Usuario normal con permiso `ADM_EMP_EMPRESA_EDITAR`** (submódulo `ADM_EMPRESAS`, ver `ADM_EMP_EMPRESA_VER`): puede editar Razón Social, Nombre Fantasía, Email, Celular, Logo, Correo de notificación, Timbrado, Certificado y Actividades. - **Superadmin**: además puede editar RUC, DV, Tipo Contribuyente y Estado, y operar la pantalla Empresas Asociadas. - Sin el submódulo `ADM_EMPRESAS` el grupo entero queda oculto / restringido. --- ## 1. Datos de la Empresa (tab Básicos) ### Identificación fiscal | Campo | Obligatorio | Reglas | |---|---|---| | RUC | Sí | Hasta 8 dígitos. Solo superadmin lo edita una vez creado | | DV | Sí | 1 dígito verificador (lo entrega la SET) | | Razón Social | Sí | Nombre legal exacto como figura en el SET | | Nombre Fantasía | No | Marca comercial; se usa en KuDE y tickets si está cargado | | Email | No | Validado por expresión regular estándar | | Celular | No | Texto libre, sin formato impuesto | | Tipo Contribuyente | Auto | Persona Jurídica / Persona Física. Solo superadmin lo cambia | | Estado | Auto | Catálogo de estados. Solo superadmin lo cambia | > El RUC + DV se muestran como chips de solo lectura en la cabecera porque tocarlos manda al SIFEN documentos con un emisor distinto. Si efectivamente cambian, hay que pedirlo a soporte / superadmin. ### Logo - Avatar circular 120×120 px junto a los datos. - Se sube haciendo click en **Cambiar** y eligiendo un archivo de imagen. - Se valida que sea `image/*`. Mientras se sube aparece un spinner. - El logo aparece en el KuDE (PDF de la factura), en el ticket térmico (si la impresora lo soporta) y en la cabecera del sistema. - Si no se carga logo, el sistema muestra la inicial de la Razón Social. ### Correo de Notificación (sección dentro del mismo tab) Define **desde qué casilla** se mandan las facturas electrónicas, los recibos y las notificaciones al cliente. **Dos modos excluyentes**: 1. **Usar correo del sistema** (default, recomendado para empezar) - Las facturas salen desde el correo provisto por SmartFact. - No requiere configuración. El sistema muestra cuál es el remitente. 2. **Usar correo propio (SMTP)** - Permite que el cliente reciba el mail con el dominio de la empresa. - Requiere completar: - **Host SMTP** (ej. `smtp.gmail.com`, `smtp.office365.com`). - **Puerto** (típicamente 465 SSL, 587 STARTTLS, 25 sin cifrado). - **Usuario SMTP** (en Gmail = email completo). - **Contraseña SMTP** (ojo: con Gmail/Outlook 2FA hay que generar **contraseña de aplicación**, no funciona la contraseña personal). - **Email Remitente** (lo que verá el cliente como "De:"). - **SSL/TLS** (switch, default ON). **Opciones generales (visibles en ambos modos)**: - **Adjuntar KuDE (PDF)**: - ON: el cliente recibe el PDF de la factura como adjunto. - OFF: el cliente recibe sólo el enlace; descarga el PDF haciendo click. Útil cuando hay que evitar correos pesados o cuando el destinatario filtra adjuntos. **Probar la configuración**: - Botón **Enviar correo de prueba** despliega un input para escribir un destinatario y dispara un envío real. Si llega, la configuración está correcta. Si no llega revisar: contraseña de aplicación, puerto, SSL y antispam del destinatario. --- ## 2. Timbrado (tab Timbrado) Registra el **número de timbrado** que el SET otorgó a la empresa para emitir facturas electrónicas. | Campo | Obligatorio | Detalle | |---|---|---| | Número de Timbrado | Sí | 8 dígitos exactos. Aparece en el certificado del SET | | Fecha Inicio | Sí | Fecha de vigencia del timbrado | | ID CSC | Sí | 4 caracteres. Identificador del Código de Seguridad del Contribuyente | | CSC | Sí | Código de Seguridad. 32 caracteres alfanuméricos generalmente | | Ambiente | Sí | `hml` (Homologación, para pruebas con SET) o `prod` (Producción) | **Importante**: - Si el ambiente es **hml**, todas las facturas se envían al SIFEN de pruebas; **no tienen validez fiscal**. - En **prod** las facturas son reales. Cualquier error de timbrado / CSC rebota la factura. - El sistema muestra chip "Configurado" cuando hay timbrado activo, "Pendiente" si no. - Al cambiar timbrado (renovación anual) hay que cargar los nuevos datos antes de la fecha de vencimiento del anterior. --- ## 3. Certificado Digital (tab Certificado) Carga el certificado X.509 (.p12 o .pfx) que firma las facturas electrónicas. | Campo | Obligatorio | Detalle | |---|---|---| | Archivo | Sí | Extensiones `.p12` o `.pfx` | | PIN | Sí | Clave del certificado (la define la SET / la entidad emisora) | - Zona drag-and-drop o selector tradicional. - Una vez cargado el sistema muestra: - **Titular** del certificado (debe coincidir con el RUC). - **Emisor** (autoridad certificadora). - **Fecha de vencimiento**. - Si el certificado vence, **las facturas dejan de firmarse y rebotan**. Revisar el vencimiento mensualmente. - Cambiar el certificado por uno nuevo basta con re-subir el archivo y volver a tipear el PIN. --- ## 4. Actividades Económicas (tab Actividades) Las actividades vienen del catálogo oficial **SIFEN** (`actividad_economicas_sifen`). - Buscador con autocompletado por **código** o **descripción**. - Cada actividad agregada se muestra como una fila con: - Código + descripción. - Switch **Principal** (exclusivo: sólo una puede estar marcada). - Botón eliminar. - Reglas: - **Mínimo 1 actividad**. - **Exactamente 1 marcada como principal** al guardar. - No se permiten duplicados (toast: "Esta actividad ya está agregada"). - **Texto Personalizado para KuDE** (opcional, máx 255 caracteres): - Reemplaza el texto de la actividad principal sólo en el PDF (KuDE). - **No modifica el XML** enviado al SET — sigue mostrando la actividad oficial. - Sirve para usar un nombre comercial más entendible para el cliente. --- ## 5. Integración Marangatú (SET) — cómo configurar el acceso **Dónde:** `Configuración → Empresa → Datos de la Empresa`, al final de la pantalla, en la sección **"Integración Marangatu (SET)"**. Sirve para guardar las **credenciales del portal Marangatú de la SET/DNIT** y que el sistema pueda **importar comprobantes electrónicos** (compras y ventas) desde ese portal. > **Importante:** esta sección **solo aparece si la empresa tiene habilitado el submódulo `ADM_BOT_MARANGATU`** en su plan. Si no la ves, es porque esa función no está contratada/activada para tu empresa. ### Pasos para configurar el acceso 1. Entrá a **Configuración → Empresa → Datos de la Empresa** y bajá hasta **"Integración Marangatu (SET)"**. 2. **Usuario Marangatu (RUC)**: ingresá el usuario del portal (normalmente el RUC). 3. **Contraseña**: la clave del portal Marangatú. (Si ya había credenciales guardadas, el campo dice *"Nueva contraseña (opcional)"* y podés dejarlo vacío para mantener la actual — verás el aviso "Credenciales guardadas".) 4. Opcional — **Sincronización automática de COMPRAS (cada 6 horas)**: activá el switch para que el sistema traiga solo tus facturas de compra periódicamente. 5. Opcional — **Sincronización activa de VENTAS**: activá el switch para habilitar la sincronización de ventas (esta es manual, no corre sola cada 6 h). 6. Pulsá **"Guardar configuración Marangatu"** (se habilita cuando cargaste el usuario). ### Después de configurar - La **importación/sincronización** de comprobantes no se hace acá, sino en los módulos **Compras** y **Ventas** (paneles de Marangatú), donde revisás lo traído, lo vinculás a productos y confirmás/rechazás. - Las obligaciones fiscales (Imputa IVA / IRE / IRP-RSP) de la sección "Información de la Empresa" alimentan el Registro de Comprobantes de Marangatú. > Guarda vía `PUT /marangatu/config` (`{ username, password, activo_compras, activo_ventas }`). La contraseña se almacena cifrada; nunca se muestra en claro. --- ## 6. Empresas Asociadas Pantalla para empresas que administran **varias razones sociales** (holdings) o que actúan como **resellers** (revendedores del sistema). ### Tipos de empresa - **Standalone**: independiente. No tiene padre ni hijas. - **Holding**: grupo padre que administra subsidiarias y/o resellers. - **Subsidiary**: empresa hija de un holding o reseller. - **Reseller**: socio comercial que vende el sistema a sus propias subsidiarias y cobra comisión. ### Reglas de jerarquía - Un **Holding** crea subsidiarias y resellers. - Un **Reseller** crea subsidiarias. - Una **Subsidiary** no crea nada. - Sólo se pueden gestionar empresas dentro de la jerarquía del usuario logueado. ### Dashboard superior Tarjetas con totales: Total, Activas, Inactivas, Holdings, Subsidiarias. ### Filtros - Búsqueda por RUC, razón social o email. - Filtro por tipo (todos / holding / subsidiary / reseller). - Filtro por estado (Pendiente, En verificación, Activo, Bloqueado, Rechazado). - Botón **Limpiar filtros** cuando hay alguno activo. ### Crear empresa asociada El diálogo de creación pide en simultáneo: 1. **Datos de la empresa**: RUC, DV, Razón Social, Email, etc. 2. **Plan de suscripción**: - Lista de planes disponibles con su precio y ciclo (mensual/anual). - **Precio acordado** (opcional): permite sobrescribir el precio del plan para esa empresa puntual (descuento comercial). - **Día de cobro** (1–28). - **Fecha inicio del plan** (puede ser pasada o futura). - **Notas comerciales** (hasta 255 caracteres). 3. **Usuario admin de la nueva empresa**: - Nombre, Usuario (mín 3 caracteres) y Contraseña (mín 6 caracteres). - Este usuario será el que entre a la empresa creada a configurar todo. ### Acciones por fila - **Ver / Login**: cambia el contexto activo a esa empresa (recarga la app trabajando como si fuese esa razón social). - **Editar**: actualiza datos básicos. - **Cambiar estado** (sólo holdings): dropdown directo en la tabla. Cambios validados con confirmación. - **Eliminar** (sólo holdings, nunca la empresa actual): borrado permanente; el sistema obliga a **re-tipear el nombre de la empresa** para confirmar. ### Vista mobile vs desktop - En móvil aparece como **cards** apiladas. - En escritorio como **tabla** con 7 columnas. --- ## 7. Suscripción Pantalla de control del plan contratado por la empresa actual. ### Cabecera - **Plan** + precio + ciclo (mensual / anual). - **Estado**: Activa / EnGracia / Pausada / Expirada / Cancelada. - **Próximo pago**: monto que se cobrará. Si supera el precio base del plan, se aclara que incluye **módulos adicionales** contratados. ### Métricas (4 columnas) - **Fecha inicio**. - **Fecha fin** (vencimiento del período actual). - **Próximo cobro**. - **Días restantes**: en rojo si ≤ 3, naranja si ≤ 7, negro en otro caso. ### Módulos incluidos Chips con los módulos que el plan habilita (Facturación, RRHH, Contabilidad, Tesorería, Compras, Importaciones, etc.). Los chips son sólo informativos: agregar/quitar módulos se gestiona desde el holding o desde el reseller, no acá. ### Alertas - **Bloqueada** (rojo): la suscripción venció y agotó el período de gracia. **No se puede operar** hasta enviar el comprobante de pago. - **En gracia** (amarillo): venció, pero todavía quedan N días antes del bloqueo. - **Próximo vencimiento** (azul): faltan 7 días o menos. ### Enviar comprobante de pago Sólo visible para usuarios con permiso `ADM_SUSC_SUSCRIPCION_RENOVAR` (submódulo `ADM_MI_SUSCRIPCION`; típicamente el admin de la subsidiaria). 1. Botón **Enviar Comprobante**. 2. Subir archivo (JPG, PNG o PDF, hasta 10 MB). 3. **Monto**: precargado con el `costo_mensual` actual; editable. 4. **Observación** opcional (255 caracteres). 5. Al enviar: "Comprobante enviado correctamente. Tu holding lo revisará pronto." El **holding o reseller** que vende el plan ve el comprobante en su panel y lo aprueba o rechaza. Mientras esté en **Pendiente** la suscripción sigue con el estado anterior (puede entrar en gracia / bloqueo). Si lo **aprueba**, la suscripción se renueva. Si lo **rechaza**, aparece el **motivo de rechazo** y hay que volver a enviarlo. ### Historial de pagos - Toggle **Ver historial** muestra una tabla con: Fecha, Estado (Pendiente / Aprobado / Rechazado), Monto, Observación, Fecha de revisión y vista del documento. - Click en el documento abre un modal con la imagen o PDF para verificar qué se subió. --- ## 8. Inicio / Onboarding Es el primer panel que aparece bajo `Configuración → Inicio`. Muestra **el progreso de configuración inicial** como una barra y una grilla con 7 tarjetas (una por paso). Cada tarjeta indica: - Si está **completo** ✓ o **pendiente** ⏳. - Un link directo a la pantalla correspondiente. Lógica de completitud: | Paso | Se considera completo cuando… | |---|---| | Datos Básicos | Hay RUC y Razón Social cargados | | Logo | Hay un archivo de logo subido | | Sucursal | Existe al menos 1 sucursal | | Punto de Expedición | Existe al menos 1 caja con numeración de documentos configurada | | Timbrado | Hay al menos 1 timbrado registrado | | Certificado | Hay al menos 1 certificado subido | | Actividades | Hay al menos 1 actividad económica cargada | Cuando los 7 están en verde, aparece el mensaje **"¡Configuración completa! Tu empresa está lista para emitir facturas electrónicas."** Si falta alguno, aparece **"Configuración pendiente. Completa los pasos faltantes para poder emitir facturas."** Recién con los 7 pasos en verde se garantiza que el SIFEN aceptará los documentos. --- ## Validaciones (texto exacto que ve el usuario) - "Complete todos los campos requeridos" (Timbrado, si falta cualquier campo). - "Esta actividad ya está agregada" (Actividades, al intentar duplicar). - "Debe marcar una actividad como principal" (al guardar sin principal). - "Email inválido" (Básicos / Correo, regex falla). - "El archivo debe ser una imagen" (logo con tipo no `image/*`). - "Solo se aceptan archivos .p12 o .pfx" (certificado). - "Comprobante enviado correctamente. Tu holding lo revisará pronto." (Suscripción). - "Empresa creada correctamente" / "Empresa actualizada correctamente". ## Lo que NO se puede hacer - **No se puede cambiar el RUC desde la pantalla normal** una vez creada la empresa. Lo hace solamente un superadmin. - **No se pueden tener varias actividades marcadas como principal a la vez**. - **No se puede facturar en producción sin certificado, timbrado y actividad principal** cargados. - **No se puede borrar el certificado** sin subir uno nuevo (la operación es reemplazo, no eliminación). - **No se puede borrar la empresa actual desde Empresas Asociadas** — el botón eliminar nunca aparece para la empresa activa. - **No se puede dejar a la empresa sin sucursal ni sin punto de expedición**: el onboarding queda en rojo y SIFEN rechaza por falta de establecimiento. - **El correo de notificación propio no soporta cuentas con 2FA sin contraseña de aplicación** (Gmail, Outlook). - **El texto personalizado para KuDE NO se manda al SET** — sólo cambia el PDF visible. ## Problemas frecuentes - **"Mi cliente no recibe la factura por email"**: 1. Revisar que el correo del cliente esté bien escrito en su ficha de contacto. 2. Revisar la carpeta de spam del cliente. 3. Si usás correo propio, abrir Correo de Notificación → **Enviar correo de prueba** a tu propio email y validar que llegue. 4. Si la prueba no llega: contraseña de aplicación incorrecta, puerto bloqueado por el proveedor, o el ISP bloquea el SMTP saliente. - **"El SIFEN rechaza la factura por timbrado"**: el número, la fecha de inicio o el ambiente (hml/prod) no coinciden con lo que el SET tiene registrado. Verificar el certificado del SET y volver a tipear los datos. - **"Mi certificado venció"**: las facturas dejan de salir hasta que se cargue uno nuevo. Renovar el certificado con la autoridad certificadora y subirlo en la pestaña Certificado. - **"No puedo entrar a la app: suscripción bloqueada"**: enviar el comprobante de pago desde Suscripción y esperar la aprobación del holding/reseller. - **"El cliente ve el nombre técnico de la actividad económica en el PDF"**: usar el campo **Texto Personalizado para KuDE** para mostrar un nombre comercial. El XML sigue mostrando el oficial. - **"Quiero cambiar el logo y no se ve actualizado"**: el navegador suele cachear la imagen. Refrescar con Ctrl+F5 o cerrar y volver a abrir la sesión. ## Limitaciones actuales - **No hay alerta automática por vencimiento de certificado**. Hay que mirarlo manualmente desde la pestaña Certificado. - **No hay alerta automática por vencimiento de timbrado** más allá del estado del onboarding. - **No se versionan los cambios** de Razón Social, dirección u otros datos de la empresa: queda el último valor. - **El correo de notificación es uno solo por empresa** — no hay configuración por sucursal o por tipo de documento. - **No se puede tener más de una empresa activa al mismo tiempo en la misma sesión**: para cambiar de contexto se usa el botón "Login" en Empresas Asociadas y la app recarga. - **El módulo Marangatu sólo aparece** si el plan incluye `BOT_MARANGATU`. ## Documentos relacionados - `guia-facturacion.md` — uso del timbrado y certificado en la emisión de DE. - `guia-contactos.md` — donde se carga el email del cliente que recibe la factura. - `guia-sucursales-cajas-pos.md` — sucursales, cajas y puntos de expedición (continuación natural del onboarding). - `plan-suscripciones-escalable.md` — modelo interno de planes, resellers y comisiones.