← Índice de manuales
Manual funcional · Sistema Plenario v14

Actualización de Alícuotas de IIBB (ARBA)

El módulo Actualización de Alícuotas de IIBB centraliza el mantenimiento de las alícuotas del Impuesto sobre los Ingresos Brutos (IIBB) que el sistema aplica a clientes (percepciones) y proveedores (retenciones).

Módulo: Legales e ImpuestosVersión: 1.0Actualizado: 2026-06-23

Actualización de Alícuotas de IIBB (ARBA)

Detalle

Campo Descripción
Manual de Usuario Actualización de Alícuotas de IIBB — importación de padrones de ARBA/AGIP y actualización de las alícuotas de percepción y retención de Ingresos Brutos sobre clientes y proveedores.

Introducción

El módulo Actualización de Alícuotas de IIBB centraliza el mantenimiento de las alícuotas del Impuesto sobre los Ingresos Brutos (IIBB) que el sistema aplica a clientes (percepciones) y proveedores (retenciones).

Desde esta pantalla se pueden ejecutar dos operaciones, que también se combinan en un solo proceso:

  • Importación de archivo de IIBB: carga en el sistema un padrón descargado de la autoridad fiscal (ARBA para Provincia de Buenos Aires, AGIP para Capital Federal). El archivo es de texto (.txt) y queda registrado como un nuevo padrón con su período de vigencia.
  • Actualización de alícuotas: toma un padrón ya cargado y recalcula las alícuotas de percepción (clientes) y/o de retención (proveedores). A cada CUIT le asigna la alícuota que figura en el padrón; si el CUIT no está en el padrón, se aplica la alícuota por defecto definida para esa provincia y tipo de aplicación.

Además del modo por padrones, la pantalla ofrece un modo Online que actualiza las alícuotas consultando el servicio VPNET InfoAPI (requiere plan activo y ApiKey configurada).

Este manual está pensado para usuarios de las áreas administrativa, contable e impositiva que mantienen actualizados los regímenes de IIBB.

Acceso al módulo

  1. Ingresá a Plenario (Back Office).
  2. Abrí la sección de Impuestos de la cinta de opciones (grupo "Impuestos / Archivos").
  3. Hacé clic en el botón Actualizacion Alicuotas IIBB.
  4. La pantalla Actualización de Alícuotas de IIBB se abre como ventana de diálogo y muestra una espera inicial mientras carga los datos de impuestos.

Importante: el acceso está controlado por el permiso Gestion.Operaciones.ActualizacionAlicuotasIBB. Si tu usuario no lo tiene asignado, la opción no se abre. Solicitá el alta del permiso a tu administrador.

Pantalla principal

La ventana se organiza en tres bloques, de arriba hacia abajo:

Bloque Descripción
Origen Selector de estrategia: Padrones (importar/actualizar desde archivos cargados) u Online (actualizar consultando el servicio VPNET InfoAPI). Por defecto queda en Padrones.
Importación de Archivo de IIBB Casilla que habilita la importación de un padrón desde un archivo de texto. Permite elegir formato (ARBA/AGIP), tipo de alícuota y la ruta del archivo.
Actualización de Alicuotas Casilla que habilita el recálculo de alícuotas sobre clientes y/o proveedores a partir de un padrón ya cargado.

En la barra de herramientas superior está el botón Procesar, que ejecuta la operación seleccionada. Las dos casillas (Importación y Actualización) son mutuamente excluyentes: al marcar una se desmarca la otra.

Filtros de búsqueda

La pantalla no es una grilla de consulta: sus controles son parámetros de proceso. Según la casilla activa, se completan estos campos:

Bloque Importación de Archivo de IIBB

Parámetro Descripción
Modo Opciones Actualizar Base de Datos (impacta directo en la BD) o Generar Script (genera el script de importación en lugar de impactar).
Formato de Archivo ARBA (Provincia de Buenos Aires) o AGIP (Capital Federal).
Tipo Alicuota Percepción o Retención. Solo se habilita para formato ARBA; para AGIP queda deshabilitado porque su archivo trae percepciones y retenciones juntas.
Archivo Ruta del archivo de texto a importar. Se elige con el botón ... (filtro por defecto: *.txt).

Bloque Actualización de Alicuotas

Parámetro Descripción
Clientes Habilita la actualización de percepciones. Al activarlo se habilitan las casillas ARBA y AGIP de clientes.
Clientes → ARBA / AGIP Por cada jurisdicción marcada, se debe elegir el padrón de percepción a aplicar (lista de padrones disponibles con fechas de Publicación / Vigencia Desde / Vigencia Hasta).
Proveedores Habilita la actualización de retenciones. Al activarlo se habilitan las casillas ARBA y AGIP de proveedores.
Proveedores → ARBA / AGIP Por cada jurisdicción marcada, se debe elegir el padrón de retención a aplicar.

Resultado del proceso

Al presionar Procesar, el sistema valida los datos y ejecuta la operación mostrando una pantalla de espera ("Por Favor Espere"). El comportamiento según la operación es:

Operación Resultado
Importación de archivo Lee el padrón del archivo indicado y lo registra en el sistema (o genera el script si se eligió ese modo). Al finalizar muestra "El Proceso ha Finalizado Correctamente" y recarga las listas de padrones disponibles.
Actualización de alícuotas (Padrones) Recalcula las alícuotas de los clientes/proveedores marcados a partir del padrón elegido. Mensaje "El Proceso de actualización ha Finalizado Correctamente" y se cierra la ventana.
Actualización Online Actualiza las alícuotas consultando VPNET InfoAPI por cada jurisdicción marcada. Al finalizar muestra el detalle de cada actualización, el tiempo transcurrido y un recordatorio de consultar el Log de Auditorías (módulo Herramientas).
Recálculo de percepciones de créditos Si el parámetro Gestion.Operaciones.ActualizarAlicPercepcion.ActualizarPercepcionesPrestamos está en 1 y se actualizaron percepciones de clientes, el sistema pregunta y recalcula las percepciones de los créditos vigentes no devengados.
Error Mensaje "Ha ocurrido un error al realizar la actualización" (o el detalle del error). El proceso se interrumpe; el botón Procesar se vuelve a habilitar.

Mientras un proceso está en curso, la ventana no se puede cerrar (avisa "La importación no ha terminado").

Acciones disponibles

Acción Descripción
Elegir origen En Origen, seleccionar Padrones u Online.
Importar padrón Marcar Importación de Archivo de IIBB, elegir formato/tipo, indicar la ruta del archivo y presionar Procesar.
Generar script En el bloque de importación, elegir Generar Script para producir el script en lugar de impactar la base de datos.
Actualizar percepciones (clientes) Marcar Actualización de Alicuotas → Clientes, tildar ARBA y/o AGIP y elegir el padrón de cada jurisdicción.
Actualizar retenciones (proveedores) Marcar Actualización de Alicuotas → Proveedores, tildar ARBA y/o AGIP y elegir el padrón de cada jurisdicción.
Procesar Ejecuta la operación seleccionada.

Ejemplo práctico

Recibiste el padrón mensual de percepciones de ARBA y querés cargarlo y aplicarlo:

  1. Entrá a Impuestos → Actualizacion Alicuotas IIBB.
  2. Dejá el Origen en Padrones.
  3. Marcá Importación de Archivo de IIBB.
  4. En Formato de Archivo elegí ARBA; en Tipo Alicuota elegí Percepción.
  5. Hacé clic en ... y seleccioná el archivo .txt descargado de ARBA.
  6. Dejá el modo en Actualizar Base de Datos y presioná Procesar. Esperá el mensaje de finalización: el padrón queda cargado.
  7. Volvé a abrir la pantalla (o desmarcá Importación) y marcá Actualización de Alicuotas.
  8. Tildá Clientes → ARBA y, en el desplegable, elegí el padrón recién cargado (verificá las fechas de vigencia).
  9. Presioná Procesar y esperá el mensaje "El Proceso de actualización ha Finalizado Correctamente".

Consejos útiles

  • Antes de actualizar alícuotas asegurate de tener definidas las alícuotas por defecto de la provincia y tipo (percepción/retención): el sistema las exige y las aplica a los CUIT que no figuran en el padrón.
  • El formato AGIP trae percepciones y retenciones en el mismo archivo, por eso no pide "Tipo Alicuota". El formato ARBA tiene archivos separados, por eso sí lo pide.
  • Importación y Actualización son pasos distintos: primero importás el padrón, después lo aplicás. No se pueden marcar las dos casillas a la vez.
  • No cierres la ventana mientras corre el proceso: el sistema lo impide hasta que termine.
  • Tras actualizar percepciones de clientes, si está activo el parámetro correspondiente, el sistema puede recalcular las percepciones de los créditos vigentes: confirmá solo si corresponde.
  • El detalle de cada actualización (modo Online) queda en el Log de Auditorías del módulo Herramientas.

Preguntas frecuentes

¿Cuál es la diferencia entre "Importación de Archivo" y "Actualización de Alicuotas"? La importación carga en el sistema un padrón nuevo a partir de un archivo de la autoridad fiscal. La actualización toma un padrón ya cargado y recalcula con él las alícuotas de clientes y/o proveedores. Son dos pasos: primero se importa, luego se aplica.
¿Qué pasa si un CUIT no figura en el padrón? Se le aplica la **alícuota por defecto** configurada para esa provincia y tipo de aplicación (percepción o retención). Si no hay alícuotas por defecto definidas, el proceso no se ejecuta y avisa que es necesario definirlas.
¿Por qué no puedo elegir "Tipo Alicuota" cuando selecciono formato AGIP? Porque el archivo de AGIP contiene en un mismo archivo las percepciones y las retenciones, de modo que el sistema importa ambas juntas. El campo Tipo Alicuota solo aplica al formato ARBA, que maneja archivos separados.
¿Qué necesito para usar el modo Online? Un plan activo y una ApiKey válida del servicio VPNET InfoAPI configurada en el parámetro `VPNET.InfoAPI.APIKEY`. Si no está configurada, el sistema pide comunicarse con el sector comercial.
¿Qué significa "Generar Script" en la importación? En lugar de impactar directamente la base de datos, el sistema genera el script de importación del padrón. Es útil para revisar o ejecutar la importación de forma controlada. La opción por defecto es **Actualizar Base de Datos**.

Permisos

Permiso Descripción
Gestion.Operaciones.ActualizacionAlicuotasIBB Habilita el acceso a la pantalla Actualización de Alícuotas de IIBB y la ejecución de los procesos de importación/actualización.

Información técnica

Basada en el análisis del formulario real de la v14. Sección de referencia para soporte/desarrollo.

Formularios principales

Form Rol
frmGestion_Operaciones_Actualizacion_ARBA (VB.NET) — VisualPlenarioNET\VisualPlenarioNET\Gestion\frmGestion_Operaciones_Actualizacion_ARBA.vb Pantalla de importación de padrones y actualización de alícuotas de IIBB. Hereda de DevExpress.XtraEditors.XtraForm. Se abre como ShowDialog() desde btnImpuestos_AlicuotasIIBB_ItemClick en frmNewMain.vb. Botón "Procesar" = cmdNuevo. Bloques: grOrigenActualización/rgEstrategia (Padrones=1, Online=2), gbxImportacion, gbxActualizacionAlic.
clsPagoFacil (VB.NET) — ClassVisualPlenarioNET\Common\clsPagoFacil.vb Manager de negocio. Métodos clave: Star_Importaciones_AGIP(), Start_Importacion_Percepciones_ARBA(), Start_Importacion_Retenciones_ARBA() (importación, en hilos STA); Actualizacion_Alic_Percepcion_IIBB(id_Provincia, fechaVigenciaDesde); Actualizar_Alicuotas_Retenciones_IIBB(id_Provincia, desde, hasta); modo Online: Actualizacion_Online_Alic_Percepcion_IIBB(id_Provincia) y Actualizar_Online_Alicuotas_Retenciones_IIBB(id_Provincia). Propiedad GenerarScriptImportacionIIBB.

Permisos reales

Permiso Acción
Gestion.Operaciones.ActualizacionAlicuotasIBB Ingreso a la pantalla. Validado en btnImpuestos_AlicuotasIIBB_ItemClick (frmNewMain.vb) vía ClassVisualPlenarioNET.Sistema.clsSeguridad.IsAllowedObject(...).
Parámetro VPNET.InfoAPI.APIKEY Requerido (no vacío) para el modo Online.
Parámetro Gestion.Operaciones.ActualizarAlicPercepcion.ActualizarPercepcionesPrestamos Si vale 1, tras actualizar percepciones de clientes el sistema recalcula percepciones de créditos vigentes no devengados.

Tablas de base de datos principales

Tabla / Entidad Uso
Padrones_Impuestos Cabecera de padrón (entidad EF Padrones_Impuestos): Id, Fecha_Publicacion, Fecha_Vigencia_Desde, Fecha_Vigencia_Hasta, Id_Provincia, Tipo_Padron, Id_Tipo_Impuesto.
Padron_Percepciones_Detalle Detalle (CUIT/alícuota) del padrón de percepciones, usado para crear/actualizar las alícuotas.
Impuestos_Alicuotas_Defaults Alícuotas por defecto por Id_Provincia / Tipo / TipoAplicacion (Percepción/Retención). Se aplican a CUIT que no figuran en el padrón; su existencia es validada antes de procesar (ImpuestosAlicuotasDefaultsManager).
Percepciones_Alicuotas Catálogo de alícuotas de percepción que el proceso inserta/actualiza (con Numeraciones para el próximo ID).
Clientes_Percepciones / Clientes Asignación de alícuota de percepción por cliente; Clientes.IIBB_Certificado_Excencion se setea según Tiposiva.PermitePercepciones.
Proveedores_Retenciones Alícuota de retención por proveedor (clase clsProveedores_retenciones). Las nuevas se crean inactivas (Activo = 0).

Relación con otros módulos / manuales

Manual relacionado Vínculo operativo
Legales Impuestos Padrones de IIBB Amplía el circuito, la configuración o los datos que utiliza esta funcionalidad.
Presentación de IIBB para ARBA Amplía el circuito, la configuración o los datos que utiliza esta funcionalidad.
Legales Impuestos Percepciones alícuotas Amplía el circuito, la configuración o los datos que utiliza esta funcionalidad.

Notas para soporte

  • Mapeo de provincia (autoritativo): combo de formato "AGIP" → Id_Provincia = 0 (Capital Federal) y "ARBA" → Id_Provincia = 1 (Provincia de Buenos Aires). Misma convención que el resto del módulo IIBB.
  • Caveat — comentarios cruzados en el código: en cmdNuevo_Click (importación) los comentarios de las ramas Id_Provincia = 0/= 1 están invertidos respecto a la convención (rotulan 0 como "Prov Buenos Aires (ARBA)" y 1 como "Capital Federal (AGIP)"), pero la lógica ejecuta Star_Importaciones_AGIP() para 0 y las importaciones ARBA para 1. Verificar contra el binario instalado si se reporta una jurisdicción cruzada.
  • Caveat — chkClientesActAGIP_CheckedChanged: en el Case "2" asigna cboActPercepAGIP.EditValue = False (en vez de Nothing); sin impacto funcional visible pero es un valor atípico.
  • Importación y Actualización son excluyentes por código (al marcar una se desmarca la otra). El modo Online fuerza marcar "Actualización de Alicuotas".
  • La importación corre en un hilo Threading.Thread (STA) y eleva el evento Finalizado; durante el proceso HiloCorriendo = True impide cerrar la ventana.
  • Existe una copia del form en VisualPlenarioNET.Legacy\Gestion\frmGestion_Operaciones_Actualizacion_ARBA.vb. El manual se basó en la versión principal (VisualPlenarioNET\VisualPlenarioNET\...); ante dudas, verificar contra el binario instalado.
¿Te resultó útil este manual?