Kazakhstan ESF Note
Kazakhstan IS ESF additional / corrected electronic invoice (ЭСФ): ADDITIONAL_INVOICE and FIXED_INVOICE linked to the original registered ESF, signed and uploaded (BYOK)
Kazakhstan IS ESF — Corrected & Additional ESF
Customer credit notes issued as additional (дополнительный) or corrected (исправленный) ЭСФ linked to the original registered ESF — for Odoo 18, 19 & 20
A registered ЭСФ is not changed with a bare credit note. IS ESF expects a new InvoiceV2 document of type ADDITIONAL_INVOICE or FIXED_INVOICE that points to the original through relatedInvoice (date, number, registration number). This module builds that document from an Odoo customer credit note, validates it against the official InvoiceV2 schema, and signs and uploads it through the Kazakhstan ESF Invoice connector.
Additional ESF (return, discount, price change)
Following the KGD memo on additional invoices, every line of the original stays in its place: the returned quantity is written negative with negative amounts, the lines not concerned carry 0. The buyer's BIN must be the original's; seller details and delivery terms are taken from the credit note, so keep them as on the original.
Corrected ESF
A corrected ESF carries the full corrected operation (original lines minus the credit note) and annuls the original. A change of buyer is refused: per the KGD methodological answers it is not a correction; the original ESF is revoked in IS ESF and a new one is issued.
Original-document linkage
The original's registration number comes from the reversed invoice, as read back from IS ESF. An original issued through Odoo must have that number; a number typed by hand is accepted only for an original issued outside Odoo, and only in the IS ESF form ESF-<12 digits>-<date>-<number>.
Correction amount
The change of the original is shown as minus the credit note total (a 58.00 credit note on a 232.00 invoice shows -58.00), and a credit note larger than the original is refused.
Structured correction reason
Reason codes (price change, return, discount, turnover/VAT correction, whole correction, other) choose the document type, and a free-text justification is posted in the chatter.
One-click issuance wizard
Pick the correction type and reason on the credit note, preview the original reference and the correction amount, then generate the XML or generate, sign and upload it. The base "Generate ESF" button on a credit note builds the same corrective document.
BYOK — you hold the key
Signing and upload use the IS ESF connection of the Kazakhstan ESF Invoice module: your own NCA RK key (GOST 34.10-2015 or RSA) stays in your database, your IS ESF password is sent only to IS ESF when a session is opened, and data is sent only to the IS ESF endpoint you configure.
Software, not an integration service
We provide software. It runs under the customer's own IS ESF credentials and NCA RK key (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 IS ESF account, keys and filings. Support is included and the licence is refundable under the marketplace policy. (Мы поставляем программное обеспечение, а не услуги оператора ЭСФ.)
Screenshots
Credit note for a partial return: additional ESF (ADDITIONAL_INVOICE), original reference and correction amount
Generated corrected ESF (FIXED_INVOICE) with relatedInvoice, before signing and upload
Support: support@pokutsoft.com
Update date: 2026-09-25
User guides (PDF)
Related modules
Kazakhstan ESF Invoice
Kazakhstan IS ESF (ЭСФ) e-invoicing: official InvoiceV2 XML, GOST 2015 / RSA signature in Odoo, IS ESF SOAP upload, BIN/IIN mod-11 validation, BYOK
Kazakhstan Payroll
Kazakhstan payroll for Odoo: two-tier IIT 10/15%, OPV/OPVR pension, VOSMS/OOSMS health, SO and Social Tax - 2026 rates, computed per employee with a statutory remittance register.
Kazakhstan SNT Waybill
Kazakhstan SNT electronic waybill (СНТ) + Virtual Warehouse integration for tracked goods: official SntV1 XML, TN VED / GTIN, VWH balances, registration QR, IS ESF SntWebService upload (BYOK)