| Rule | Scope |
|---|
| Providencia SNAT/2024/000102 | Digital printer and Digital Fiscal Control Number (NCF-D) issuance. |
| Providencia SNAT/2024/000121 | Compliance duties: immutable ledger, fiscal books and SENIAT transmission. |
| Requirement | Zentto implementation |
|---|
| Issuance by authorized digital printer | Zentto assigns the NCF-D from its own series (imprenta."ControlSerie"). |
| Unique, gap-free control number | Atomic counter fn_assign_control_serie with SELECT ... FOR UPDATE. |
| Integrity and immutability | SHA-256 hash-chain per issuer RIF; chain verification (verifyChainIntegrity). |
| Two-level numbering | Document number (issuer) + control number (Zentto), tracked separately. |
| Document types | Invoice (01), CN (02), DN (03), guide (04), VAT withholding (05), ISLR withholding (06), ARCV (07 local). |
| Tax handling | Rates G (16%), R (8%), A, E and IGTF (3%) on foreign-currency payments, per tax subtotal. |
| UTC-0 dates | All dates stored in UTC; display converts to company timezone. |
| Immutable ledger + books + transmission | Compliance system zentto-seniat-compliance. See SENIAT Compliance. |
| SENIAT lookup | Read-only /seniat/* endpoints (by NCF-D, listing, sales book) with X-Seniat-Key. |
| Retention | fiscal."DigitalInvoice" store with 10-year retention (config compliance.retention_years). |
- In-house NCF-D.
fiscal."NcfdSequence" + fn_assign_ncfd(rif) assign the number per
issuer RIF in Prefix-Series-Number format, atomic and gap-free.
- Graphical representation. Each document produces its PDF with the fiscal data (see
Document examples).
- Permanent SENIAT access. Endpoints
/seniat/consulta/{ncfd} and /seniat/listado
allow the Tax Administration to query; each access is recorded in the ledger.
- Immutable ledger.
compliance."EventLedger" records each fiscal event
(INVOICE_ISSUED, CREDIT_NOTE, DEBIT_NOTE, WITHHOLDING_ISSUED, …) with SHA-256 hash-chain
and per-tenant lock (pg_advisory_xact_lock).
- Fiscal books.
compliance."FiscalReport" and the sales-book generator
(libro-ventas.generator).
- Transmission.
compliance."DispatchQueue" with exponential backoff to SENIAT.
Full detail in SENIAT Compliance.
