Metadata-Version: 2.3
Name: unpaismejor_dgii_advisor
Version: 8.0.3
Summary: DGII advisor tools for Tryton
Project-URL: homepage, https://code.unpaismejor.org.do/tryton-do/dgii_advisor
Project-URL: repository, https://code.unpaismejor.org.do/tryton-do/dgii_advisor
Author: Fundación Un País Mejor
Maintainer: Fundación Un País Mejor
License: GPL-3.0-or-later
Keywords: dgii,dominican-republic,tryton
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Plugins
Classifier: Framework :: Tryton
Classifier: Topic :: Office/Business
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Requires-Dist: trytond<8.1,>=8.0
Requires-Dist: unpaismejor-dgii-reports<8.1,>=8.0
Provides-Extra: test
Requires-Dist: proteus<8.1,>=8.0; extra == 'test'
Description-Content-Type: text/x-rst

dgii_advisor
============

Asesor fiscal local y explicable para revisar obligaciones, riesgos y
oportunidades legales vinculadas a la contabilidad y los reportes DGII.

El motor es determinístico: procesa los registros de Tryton dentro del servidor
y no envía datos financieros a servicios externos.  No crea asientos, no cambia
facturas y no presenta declaraciones.  Cuando detecta una diferencia propone el
ajuste y exige revisión humana antes de marcarlo como aprobado o aplicado.

Cobertura funcional
-------------------

* Perfil fiscal de compañía.
* Recomendaciones persistentes por período y origen.
* Wizard de análisis desde IT-1 y reportes.
* Motor de reglas para ITBIS, ISR, NCF, retenciones, obligaciones e incentivos.
* Catálogo local de fuentes normativas con versión y procedencia documental.
* Nivel de confianza, huella del análisis y trazabilidad de los datos utilizados.
* Flujo de revisión: pendiente, revisada, aprobada, aplicada o descartada.
* Propuestas de ajuste separadas de la contabilización y presentación fiscal.

Continuidad por período
-----------------------

Cada análisis crea o reutiliza un expediente fiscal. IT-1 y formatos 606-609 se
clasifican por el ``MM/AAAA`` del documento y generan un expediente mensual.
IR-2 genera el expediente anual. El mes de cierre del Perfil Fiscal determina
el ejercicio al que pertenece cada mes: con cierre en junio, julio de 2025 se
integra al ejercicio fiscal 2026.

Los expedientes pasan por los estados abierto, analizado, pendiente de ajustes,
revisado, listo para presentar, presentado y cerrado. Cada ejecución conserva
una copia inmutable de sus resultados, la versión del motor y el catálogo legal.
La sección Continuidad Fiscal registra saldos a favor de ITBIS/ISR, pérdidas,
anticipos, retenciones y ajustes pendientes, incluyendo origen, destino, saldo
restante y vencimiento. El asesor vuelve a mostrarlos en períodos posteriores
hasta que se apliquen, venzan o cancelen de manera documentada.

Uso responsable
---------------

El ahorro estimado es una oportunidad de revisión, no un derecho adquirido ni
una instrucción para omitir ingresos o fabricar gastos.  Antes de aplicar una
recomendación se debe comprobar la vigencia de la norma, la realidad económica,
los comprobantes y la correspondencia con los libros contables.  Los cambios de
criterio y avisos publicados por la DGII deben incorporarse al catálogo y a las
reglas mediante una nueva versión del motor.

Pruebas
-------

Las pruebas cubren valores por defecto, resolución de período, contexto de recomendaciones, claves estables y helpers de período.
