NCF Manager Module
##################

The ncf_manager module manages Dominican Republic fiscal receipt numbers
for Tryton invoices.

It provides NCF/e-CF types, fiscal sequence management, invoice fiscal fields,
NCF assignment on posting, and fiscal preparation for debit and credit notes.

Installing
**********

Install the package and activate the module in the database::

    pip install unpaismejor_ncf_manager
    trytond-admin -d <database> -u ncf_manager

Publishing
**********

The included Gitea Actions workflow builds and publishes the package to the
Gitea PyPI registry from version-series branches such as ``8.0``.

Configure this repository secret:

* ``REGISTRY_PASSWORD``

The module assigns fiscal numbers transactionally from ``ir.sequence.strict``.
It does not sign or transmit e-CF documents; transmission remains the explicit
responsibility of an electronic invoicing connector.

Authorization workflow
**********************

NCF authorizations follow the protected workflow ``Draft → Active →
Finished``.  Create the authorization and its fiscal lines in draft, then use
the **Activate** button.  A line can select an existing strict sequence or ask
the module to create one on activation from its authorized range.  Activation
checks company, fiscal type, prefix, padding, validity, availability and range
overlap.  The last issued number automatically finishes the line.  Finishing
an authorization closes every remaining active line without reusing numbers.

Electronic fiscal numbers are only reserved by this module.  Activating an
E-series authorization never signs or transmits an e-CF to DGII.