Módulo de Impuestos

definición el módulo de impuestos de suga es la capa de gestión fiscal integrada al ciclo de procesamiento de pagos de la plataforma permite configurar, calcular y gestionar los impuestos nacionales, provinciales y municipales a los que están sujetos los comercios y subcomercios que operan en el ecosistema adquirente, garantizando que cada transacción refleje correctamente las obligaciones fiscales vigentes en el momento de su liquidación resuelve un problema estructural en plataformas de pagos que operan en entornos fiscales complejos la necesidad de aplicar regímenes impositivos heterogéneos —retenciones, percepciones, exenciones, alícuotas diferenciadas por jurisdicción— de forma automática y consistente sobre cada operación, sin que esa complejidad recaiga en el comercio ni en el sistema de origen de la transacción el módulo opera en dos modalidades complementarias de forma integrada al flujo de procesamiento de suga, donde el cálculo es automático en el momento de la acreditación, y de forma externa, donde el motor de cálculo puede ser consultado vía api para operaciones cursadas fuera de la plataforma pero que deben tributar bajo las mismas reglas concepto central del módulo configuración → impuestos nacionales, provinciales y municipales por régimen (retención / percepción) cálculo automático → se aplica al pasar la transacción de aprobada a acreditada cálculo externo → api disponible para operaciones cursadas fuera de suga certificados → consulta, descarga y carga manual de certificados de retención y percepción impacto en dashboards → los resultados fiscales se reflejan en el panel del subcomercio en tiempo real el módulo de impuestos abstrae la complejidad de operar en un entorno fiscal multijurisdiccional dentro de una plataforma de pagos la plataforma suga encapsula todo esto como parte nativa del ciclo de procesamiento operación aprobada → suga identifica los regímenes configurados para el comercio consulta de padrones fiscales → verifica si aplica retención, percepción o exención cálculo de impuestos → base imponible × alícuota por cada régimen aplicable generación del certificado → disponible en la url devuelta por la api aplicación al monto neto → el subcomercio recibe el importe ya descontado impacto en liquidación → el módulo de liquidaciones refleja el neto fiscal impacto en bo → visibilidad fiscal en tiempo real para el subcomercio rol dentro de la plataforma dentro de la arquitectura suga, el módulo de impuestos se posiciona como una capa transversal que intersecta el ciclo de post proceso financiero no es un módulo aislado de configuración tributaria está integrado al flujo de acreditación de la plataforma y alimenta directamente el módulo de liquidaciones con los montos netos resultantes de la aplicación de retenciones y percepciones este posicionamiento garantiza que la información fiscal esté disponible y aplicada en el momento en que se genera el impacto económico sobre el subcomercio, sin requerir pasos manuales ni reconciliación posterior entre el sistema de pagos y el sistema tributario módulo relacionado relación con el módulo de impuestos smart acquiring core procesa la transacción el módulo de impuestos actúa sobre el resultado de la autorización en el momento de la acreditación módulo de liquidaciones recibe los montos netos ya descontados los impuestos calculados por este módulo la liquidación al subcomercio refleja el impacto fiscal gestión de transacciones registra el detalle fiscal por operación, incluyendo base imponible, alícuota aplicada y monto retenido o percibido módulo acl / roles y permisos controla qué operadores y usuarios pueden configurar regímenes, cargar certificados y consultar información fiscal consola de operación canal de configuración de impuestos y regímenes, y de gestión de certificados manuales dashboards del subcomercio reflejan los resultados de las transacciones con los impuestos ya aplicados para una visión fiscal precisa en tiempo real funcionamiento del módulo momento del cálculo impositivo los impuestos se calculan y aplican en el momento en que una transacción transita del estado aprobada al estado acreditada, siguiendo los plazos de acreditación configurados en la plataforma este punto de aplicación es deliberado garantiza que el cálculo fiscal opere sobre operaciones efectivamente confirmadas, no sobre autorizaciones que podrían ser revertidas el flujo aplica a transacciones iniciadas desde cualquiera de los canales de aceptación soportados por suga qr, smartpos, link de pago y pos virtual la lógica de cálculo es consistente independientemente del canal de origen momento de aplicación en el flujo transaccional transacción iniciada (qr / smartpos / link de pago / pos virtual) → autorización procesada por smart acquiring core → estado aprobada (cod 200) → plazo de acreditación configurado (t / t+n según el subcomercio) → cálculo y aplicación de impuestos ← aquí actúa el módulo → estado acreditada (cod 300) → impacto en liquidación al subcomercio modalidades de cálculo cálculo integrado (interno) cuando la operación fue cursada a través de suga, el cálculo impositivo es automático la plataforma identifica el comercio, aplica los regímenes configurados y determina los montos de retención o percepción que corresponden según la jurisdicción y el tipo de operación el subcomercio recibe el valor neto de la transacción ya con el descuento de la retención reflejado en su panel y en la liquidación cálculo externo (vía api) https //www sugaway dev/calcular impuestos manualmente https //www sugaway dev/calcular impuestos manualmente https //www sugaway dev/exclusion manual de contribuyentes https //www sugaway dev/exclusion manual de contribuyentes para operaciones cursadas fuera de suga pero que deben tributar bajo las mismas reglas, la plataforma expone un endpoint de cálculo manual el agregador provee los datos de la operación y la plataforma devuelve el detalle de los impuestos aplicables, incluyendo nombre del impuesto, base imponible, monto calculado y, cuando aplica, la url del certificado de retención o percepción generado regímenes soportados el módulo soporta la configuración de regímenes de retención y percepción a múltiples niveles jurisdiccionales • impuestos nacionales tributos establecidos por el gobierno federal, aplicables en todo el territorio • impuestos provinciales tributos impuestos por cada provincia, aplicables dentro de su jurisdicción • impuestos municipales tributos impuestos por municipios específicos dentro de su jurisdicción cada régimen se configura indicando si opera como retención —donde el agente descuenta el impuesto del pago al proveedor— o como percepción —donde el agente añade un monto al valor de venta que luego remite al fisco certificados de retención y percepción el módulo genera, gestiona y expone certificados para cada operación donde se aplica una retención o percepción estos documentos acreditan el cumplimiento fiscal ante las autoridades y son descargables desde la consola o accesibles vía la url devuelta en la respuesta de la api de cálculo para contribuyentes que presentan certificados de inscripción o exclusión de forma manual —es decir, que no están empadronados en los padrones fiscales que la plataforma consulta automáticamente— el módulo permite cargar, consultar y dar de baja esos certificados a través de la api o desde la consola componentes y funcionalidades principales configuración de impuestos • configuración de impuestos a nivel nacional, provincial y municipal • gestión de regímenes de retención y percepción por jurisdicción • configuración desde la consola de operación de suga • los regímenes configurados se aplican automáticamente a cada operación del comercio o subcomercio cálculo de impuestos • cálculo automático integrado al flujo de acreditación para operaciones cursadas por suga • api de cálculo externo para operaciones cursadas fuera de la plataforma • soporte para operaciones internas (con cupón suga) y externas (con datos propios de la operación) • soporte para operaciones de pago (transaction) y devolución (refund) • soporte para sentido financiero de la operación cash in (ingreso al subcomercio) y cash out (egreso) • detalle por impuesto nombre, descripción, base imponible, monto calculado, moneda y certificado gestión de certificados • consulta y descarga de certificados de retención y percepción generados automáticamente por la plataforma • carga manual de certificados de inscripción o exención para contribuyentes no empadronados • configuración de vigencia por certificado fecha de inicio y fin • soporte para exenciones con valor fijo, porcentaje fijo o porcentaje de descuento sobre alícuota original • eliminación lógica de certificados cargados manualmente • listado paginado y búsqueda por identificador fiscal, número de certificado o id de registro impacto en dashboards • los resultados de transacciones se actualizan en el panel del subcomercio/comercio con los impuestos ya aplicados • el subcomercio visualiza siempre el valor neto de la transacción importe bruto menos retenciones • la visibilidad fiscal en tiempo real permite control interno y facilita los procesos de auditoría dimensiones y entidades del módulo entidad descripción régimen impositivo conjunto de reglas fiscales configuradas para un comercio o subcomercio tipo (retención / percepción), jurisdicción (nacional / provincial / municipal) y alícuota aplicable retención mecanismo por el cual el agente descuenta del pago al subcomercio un porcentaje en concepto de impuesto y lo ingresa al fisco en su nombre percepción mecanismo por el cual el agente añade al valor de venta un monto en concepto de impuesto, cobrado al comprador y remitido al fisco certificado de retención documento que acredita la retención realizada generado automáticamente o cargado manualmente descargable desde la consola o vía url en la respuesta de la api certificado de percepción documento que certifica la percepción efectuada mismo ciclo que el certificado de retención cupón (coupon) referencia de la operación dentro de suga se usa como identificador en el cálculo integrado de impuestos coupondata objeto con los datos de una operación externa (cursada fuera de suga) necesarios para calcular los impuestos aplicables subcomercio comercio secundario que opera bajo un agregador o payfac en la plataforma sus transacciones están sujetas a los regímenes configurados agente de retención / percepción entidad (generalmente el agregador) obligada por ley a retener o percibir impuestos en nombre del subcomercio y remitirlos al fisco flujo operativo flujo — cálculo integrado (operación interna) 1 operador configura los regímenes impositivos aplicables al comercio desde la consola 2 transacción iniciada por el subcomercio (qr / smartpos / link de pago / pos virtual) 3 smart acquiring core procesa la autorización → estado aprobada (cod 200) 4 plazo de acreditación configurado transcurre (t o t+n según el subcomercio) 5 módulo de impuestos calcula y aplica retenciones / percepciones según regímenes configurados 6 se genera el certificado fiscal correspondiente → url disponible para consulta 7 estado acreditada (cod 300) → monto neto acreditado al subcomercio 8 módulo de liquidaciones refleja el importe neto → dashboards actualizados flujo — cálculo externo (operación cursada fuera de suga) 1 sistema externo procesa una operación fuera de suga 2 agregador invoca la api de cálculo enviando los datos de la operación (coupondata) 3 módulo de impuestos identifica los regímenes aplicables al comercio (x suga entity) 4 plataforma devuelve el detalle de impuestos nombre, base, total, certificado por impuesto 5 el agregador aplica los importes calculados en su propio proceso de liquidación beneficios y valor operativo dimensión valor que aporta el módulo cumplimiento normativo automático el cálculo y aplicación de impuestos ocurre de forma automática en el ciclo de acreditación, sin pasos manuales ni riesgo de omisión soporte multijurisdiccional gestión de impuestos nacionales, provinciales y municipales en una única configuración por comercio transparencia fiscal el subcomercio ve siempre el importe neto correcto en su panel, con visibilidad completa sobre lo retenido o percibido api de cálculo externo el motor impositivo está disponible para operaciones cursadas fuera de suga, permitiendo unificar la lógica fiscal bajo una única plataforma gestión de certificados consulta, descarga y carga manual de certificados de retención y percepción desde la consola o vía api reducción de errores operativos la automatización del cálculo elimina el riesgo de errores humanos en la determinación de base imponible y alícuotas trazabilidad fiscal por operación cada transacción lleva asociado el detalle de los impuestos aplicados, facilitando auditorías y declaraciones fiscales glosario de términos fiscales término definición impuestos nacionales tributos establecidos por el gobierno federal, aplicables a todas las empresas y ciudadanos del país independientemente de su jurisdicción impuestos provinciales tributos impuestos por cada provincia, aplicables a empresas y ciudadanos que operan dentro de esa jurisdicción provincial impuestos municipales tributos impuestos por municipios, aplicables dentro de la jurisdicción municipal específica donde se realiza la actividad comercial régimen de retención procedimiento fiscal por el que el agente de retención descuenta un porcentaje del pago al subcomercio en concepto de impuestos y lo ingresa al fisco en su nombre régimen de percepción procedimiento fiscal por el que el agente de percepción añade un monto al valor de venta, lo cobra al comprador y lo remite a las autoridades fiscales certificado de retención documento que acredita las retenciones realizadas sirve como comprobante de cumplimiento fiscal ante el fisco y ante el contribuyente retenido certificado de percepción documento que certifica que la empresa ha percibido impuestos de sus clientes y los ha remitido a las autoridades fiscales base imponible monto sobre el que se aplica la alícuota del impuesto para determinar el importe a retener o percibir alícuota porcentaje definido por la normativa fiscal que se aplica sobre la base imponible para calcular el impuesto correspondiente exención situación fiscal en la que un contribuyente está excluido total o parcialmente de la obligación de tributar bajo un régimen determinado, acreditada mediante certificado payfac (payment facilitator) entidad que facilita pagos para subcomercios, actuando como intermediario entre el subcomercio y el adquirente opera como agente de retención y percepción t / t+n plazos de liquidación t representa el mismo día de la transacción; t+n indica n días hábiles posteriores a la transacción determina cuándo se acredita al subcomercio qué transmite este módulo el módulo de impuestos de suga demuestra que la plataforma comprende que operar como adquirente o payfac en un entorno fiscal complejo no es solo procesar pagos es asumir la responsabilidad de actuar como agente de retención y percepción ante el fisco integrar esa responsabilidad al ciclo de procesamiento —y no delegarla como un problema del cliente— es lo que distingue a una plataforma de pagos de infraestructura real de un gateway de pagos genérico ✔ gestión fiscal integrada al ciclo de acreditación el impuesto se calcula y aplica en el momento correcto, sin pasos adicionales ✔ soporte multijurisdiccional impuestos nacionales, provinciales y municipales bajo una única configuración ✔ motor de cálculo externo disponible vía api para operaciones cursadas fuera de suga ✔ gestión completa de certificados generación automática, descarga y carga manual para contribuyentes no empadronados ✔ transparencia fiscal en tiempo real para el subcomercio visibilidad del importe neto en dashboards ✔ trazabilidad completa cada operación lleva el detalle fiscal asociado para auditorías y declaraciones