Kazakhstan IS ESF — Corrective & Additional Documents
Дополнительная / исправленная / возврат electronic invoices (ЭСФ) linked to the original registered IS ESF document — for Odoo 18 & 19
In Kazakhstan a registered ЭСФ cannot be amended with a bare credit note. When a cleared electronic invoice on the State Revenue Committee IS ESF portal (esf.gov.kz) must be corrected or reversed, the law requires a new ЭСФ of a specific corrective type that explicitly references the original registered document. This module builds those corrective documents correctly and submits them with your own EDS credential (BYOK).
Three IS ESF corrective types
Issue an Additional ЭСФ (дополнительная) that adds or reduces the value of a registered supply without annulling it, a Corrected ЭСФ (исправленная) that annuls and fully replaces the original, or a Return / Credit (возврат) carried as an additional ЭСФ with the negative refund delta — each stamped with the correct IS ESF document subtype and an original-document reference.
Original-document linkage
The original ЭСФ registration number, portal id and turnover date are pulled straight from the reversed customer invoice. The module verifies the original was actually registered with the IS ESF portal before a corrective can bind to it, and supports a manual override for documents migrated from another system.
Signed delta computation
Per-line and total correction deltas (corrective amount minus original amount) are computed automatically so additional and return documents reconcile against the original. A type/sign consistency rule prevents a return from increasing the document value and an additional ЭСФ from decreasing it.
Structured correction reason
A structured IS ESF reason code — price change, quantity / return, retroactive discount, buyer-detail correction, turnover / VAT-category correction, full annulment, or other — plus a free-text justification is carried into both the corrective document and the transport log.
Built on the IS ESF connector
Layered on the shared e-Invoice Core Engine and the
Kazakhstan IS ESF e-Invoicing connector: the UBL 2.1 skeleton,
the KZ jurisdiction extension, the BIN/IIN mod-11 identifications and the
VAT bucketing are produced by the shared, tested generator. Nothing is
duplicated. A dedicated kz_is_esf_corrective validation
profile extends the base IS ESF business rules.
One-click issuance wizard
Pick the correction type and reason on a credit note, preview the resulting original reference and corrective totals, then generate the XML or generate-and-submit to the IS ESF portal — all through the base connector's transport and the engine document state machine.
BYOK — you hold the credential
This module reuses the base connector's IS ESF connection: your own EDS certificate (mutual-TLS) or API token authenticates to the portal. Nothing is bundled and invoice data is transmitted only to the IS ESF endpoint you configure — your private key material never leaves your database. Compatible with Odoo 18 and Odoo 19.
Software, not an integration service
We provide software. It runs under the customer's own IS ESF credentials and EDS certificate (BYOK) — we are not an e-invoicing integrator, operator or agent. The relationship is directly between the customer (the registered taxpayer) and the State Revenue Committee; the customer owns their portal account, certificate and filings. Support is included and the licence is refundable under the marketplace policy. (Мы поставляем программное обеспечение, а не услуги оператора ЭСФ.)
Screenshots
Corrective Credit Note Retur
Generated Corrective Xml Doc
Update date: 2026-07-02