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).

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 de Plenario (requiere plan activo y ApiKey configurada en el parámetro VPNET.InfoAPI.APIKEY). En el modo Online las alícuotas por defecto son opcionales: a un CUIT que no figura en el padrón y no tiene default no se le asigna alícuota, y el proceso sigue con el resto. En el modo por padrones, en cambio, las alícuotas por defecto siguen siendo necesarias.

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

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.

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

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.

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

Bloque Actualización de Alicuotas

Con origen Online no se elige padrón: las casillas Clientes → ARBA / AGIP y Proveedores → ARBA / AGIP indican qué procesos correr (percepciones de clientes AGIP, percepciones de clientes ARBA, retenciones de proveedores ARBA y retenciones de proveedores AGIP), y cada CUIT se consulta en InfoAPI.

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:

Dónde queda registrado cada cambio (Log de Auditorías)

Al terminar el modo Online el sistema recuerda: "Recuerde que puede visualizar el detalle de cada actualización desde la pantalla de 'Log de Auditorias' en el módulo 'Herramientas'.". En esa pantalla (Herramientas → Log de Auditorías), el tipo de log a elegir depende de qué se actualizó:

En los registros de Clientes_Percepciones el Tipo_Log_Id es el Id del cliente, así que se puede seguir la historia de percepciones de un cliente puntual. El detalle completo está en el manual Log de Auditorías.

Antes de este cambio, la actualización Online de percepciones de clientes se registraba bajo el tipo InfoAPI; los registros anteriores siguen estando bajo ese tipo.

Detalle de cada proceso Online

Para cada proceso Online (por ejemplo ">> Percepciones de clientes AGIP" o ">> Retenciones de proveedores ARBA") el detalle informa sólo las líneas que correspondan:

Un proceso se considera "con errores" si hubo errores de consulta, errores al grabar o se interrumpió. Los CUIT "sin alícuota asignada" se informan pero no hacen fallar el proceso.

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

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".

Variante Online: si tu empresa tiene configurado InfoAPI, en Origen elegí Online, tildá Clientes → AGIP / ARBA y/o Proveedores → ARBA / AGIP y presioná Procesar. Al terminar revisá "Resultado por proceso:": si algún proceso figura con ❌, leé su detalle. Si dice "PROCESO INTERRUMPIDO", el servicio no respondió; esperá unos minutos y volvé a ejecutarlo (los CUIT que no se procesaron conservan su alícuota).

• En el modo Padrones, antes de actualizar 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. En el modo Online son opcionales, pero sin ellas los CUIT que no figuran en el padrón quedan "Sin alícuota asignada".
• Podés importar el padrón del mes siguiente apenas se publica y aplicarlo el último día del mes: la actualización por padrones usa el padrón que elegís en la lista, no la fecha de trabajo.
• Si el modo Online informa errores de consulta, no hace falta corregir nada a mano: los clientes/proveedores afectados conservan la alícuota que tenían. Volvé a correr el proceso cuando el servicio responda.
• 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 queda en el Log de Auditorías del módulo Herramientas: para percepciones de clientes (modo Online y modo Padrones) filtrá por el tipo Clientes_Percepciones; para retenciones de proveedores (modo Online), por el tipo InfoAPI.

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

Formularios principales

Permisos reales

Tablas de base de datos principales

Relación con otros módulos / manuales

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".
• Cambios CS 23691 (Ticket#117048) — estrategia Online (ActualizarOnline). Arma una lista de procesos (Percepciones de clientes AGIP/ARBA → clsPagoFacil.Actualizacion_Online_Alic_Percepcion_IIBB(0/1); Retenciones de proveedores ARBA/AGIP → Actualizar_Online_Alicuotas_Retenciones_IIBB(1/0)), los ejecuta todos y concatena ErrorMessage de cada uno en MessageBoxFrm.ShowMessage("Resultado por proceso:" ...) con ✅/❌. ValirdarFormulario ya no exige defaults cuando rgEstrategia <> 1. Sin VPNET.InfoAPI.APIKEY (vacío o "0") sale antes de llamar a ActualizarOnline; luego VPNET_Info_API.IsPlanActivo() valida el plan.
• Criterio de los masivos Online: VPNET_Info_API.GetAlicuotaPadronRegGral devuelve Item1 = False ante cualquier falla (sin APIKEY/APIRoot, HTTP distinto de 200, excepción) y nunca una alícuota 0; Item2 = -1 = no figura en el padrón. Falla → contErrorConsulta sin tocar la alícuota; MAX_FALLAS_SEGUIDAS_INFOAPI = 3 fallas consecutivas → Exit For e informa los no procesados. La default (GetAlicuotaDefault(1, provincia, TipoAplicacion)) se descarta si IsActiva = False. El proceso devuelve False si hubo interrupción, errores de consulta o de grabación (no por "Sin alícuota asignada"). Con ActualizarPercepcionesPrestamos = 1 el recálculo de créditos corre si hubo algún proceso de clientes, aun con errores.
• Auditoría (CS 23692, Ticket#117048). Percepciones de clientes: Tipo_Log.Clientes_Percepciones (45). En la estrategia Online la registra clsClientes_percepciones al grabar (origen en Origen_Auditoria = "Actualización masiva online - …"); ya no se usa Tipo_Log.InfoAPI para clientes. En la estrategia Padrones, Actualizacion_Alic_Percepcion_IIBB captura el antes/después con OUTPUT … INTO @Cambios y hace el INSERT INTO Plenario_Operaciones_Log en el mismo SQL, sólo para altas y cambios de Id_Percepciones_Alicuotas; si el insert de auditoría falla, la actualización no se revierte. Retenciones de proveedores (Online): siguen con Tipo_Log.InfoAPI. Mismo CS: se corrigieron los textos "Es necesario definir las alícuotas por default para percepción/retención ARBA/AGIP" y "Debe especificar un ApiKey válido para el servicio online de actualización de alícuotas, comuníquese con el sector comercial.".
• Estrategia Padrones: cada proceso (Actualizacion_Alic_Percepcion_IIBB(provincia, padron.Fecha_Vigencia_Desde) / Actualizar_Alicuotas_Retenciones_IIBB(provincia, desde, hasta)) se evalúa por separado y el error lista "Con errores: ..." y "Finalizaron correctamente: ...". El padrón se toma del combo (Padrones_Impuestos elegido), no de la fecha de trabajo. Los SQL siguen haciendo INNER JOIN Impuestos_Alicuotas_Defaults, por eso la default sigue siendo obligatoria en esta estrategia.
• 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.