| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Invoicing (account)
• Discuss (mail) |
| Community Apps Dependencies | Show |
| Lines of code | 3554 |
| Technical Name |
l10n_kz_esf_credit_note |
| License | OPL-1 |
| Website | https://gencbaris.com/odoo_plugins/ |
| Versions | 18.0 19.0 |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Invoicing (account)
• Discuss (mail) |
| Community Apps Dependencies | Show |
| Lines of code | 3554 |
| Technical Name |
l10n_kz_esf_credit_note |
| License | OPL-1 |
| Website | https://gencbaris.com/odoo_plugins/ |
| Versions | 18.0 19.0 |
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
Odoo Proprietary License v1.0 This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file). You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one). It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software. The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Please log in to comment on this module