N24 KSeF Helper

Version 27.0.1.38-- 30.03.2026

💡 - Customer Request
- Our Own Enhancement
Contact us with your ideas or requirements. We'd be delighted to consider them. Send an email to: produkty@nav24.pl

New Features

💡 AI – Create Mappings with AI

We introduced an Azure OpenAI integration that allows creating KSeF field mappings using natural language. Simply describe what you want to map, and AI will propose a complete step configuration – from selecting source tables to assigning values to KSeF structure fields.


Key features:
  • 🤖 "Prepare with AI" action available directly from the mapping list
  • 💬 Ready-made prompts (presets) for typical scenarios: GTIN, clearing CN code, clearing batch number, and others
  • 🔍 Automatic recognition of required Business Central tables based on description
  • ✅ Validation and conversion of AI responses into mapping steps
  • 📊 Full telemetry of sent prompts and saved mappings

New Features

💡 KSeF Mappings – New Sections and Extended Capabilities

We significantly expanded the KSeF field mapping module with new section types, support for clearing values, and support for large text fields.


New section types in lines:
  • 📦 GTIN code – support for the Global Trade Item Number code in invoice lines based on the item reference
  • 🏷️ CN code (Combined Nomenclature) – assigning a customs code to invoice lines

Value clearing:
  • 🧹 Clearing values in the KSeF structure – new source type "Clear Value" allows explicitly removing a field value in the KSeF structure without specifying source tables
  • 🧹 Clearing item batch number – dedicated support for the "ItemBatchNumber" section, which only supports the "Clear Value" type

Other improvements:
  • 🔢 Priority – a new field allowing specification of the execution order of mappings when multiple configurations reference the same output field. The mapping with higher priority takes precedence
  • 📝 Support for long text fields (BLOB) – mappings correctly read values from BLOB-type fields (e.g., extended texts, long descriptions), converting them to UTF-8 format
  • 🌐 Automatic language handling – record filters remember the language in which they were created. This ensures mappings work correctly regardless of the current user language – e.g., item extended texts are automatically resolved in the correct language

New Features

💡 Skip KSeF Lines and Step Management

We added the ability to exclude selected lines from KSeF export and flexible management of step order in mappings.


Skip lines:
  • 🚫 New "Skip in KSeF" field available on the item card and in sales and service document lines
  • 🔄 Value from the item card is automatically copied to document lines
  • 📄 Lines marked as "Skip in KSeF" are automatically filtered during invoice export

Mapping step management:
  • ➕ Insert steps in the middle – the "Insert Step Here" action allows adding a new step anywhere in the sequence
  • 🗑️ Delete steps from the middle – after deleting a step, numbers are automatically renumbered
  • 🔢 Automatic validation of step sequence correctness

New Features

💡 Administration – Export, Import, and Synchronization


Export and import settings to JSON file:
  • 💾 Export main settings – the "Export Settings" action allows saving footer, comment, and email attachment configuration to a JSON file.
  • 💾 Export KSeF field mappings – the "Export Mappings" action exports all mapping configurations along with their steps to a JSON file.
  • 📥 Import settings and mappings – JSON files can be imported in another environment or company. Mapping import adds new configurations to existing ones (does not remove existing ones). The system validates the file format and export type, and missing fields are skipped without error

Direct synchronization to other companies:
  • 🔄 Synchronize general settings – the "Synchronize to Other Companies" action opens a target company selection window. Footer, comment, email attachment, and AI configuration is copied directly to selected companies without file export
  • 🔄 Synchronize mappings – the "Synchronize Mappings to Other Companies" action copies KSeF field mappings to selected companies. The system automatically detects duplicates (by output label, application level, and document area) and asks about overwriting
  • ⚠️ Overwrite protection – before synchronization, the system checks whether the target company already has configured data (footer texts, comment export, email attachments, AI configuration) and displays a detailed warning with the option to skip that company

New Features

💡 Documentation and Configuration Examples

We made it easier to get started with the application through direct links to documentation and an expanded list of configuration examples.


  • 📖 Documentation links from settings – the settings page now contains direct links to online documentation for individual modules (Job Queues, KSeF Field Mappings)
  • 📋 Example selection for loading – the "Load Examples" action on the mapping list opens a selection page with 14 predefined configuration scenarios:
    • Customer No., Order Number, Order Date
    • Ship-to Recipient, Index, Custom Item No.
    • Item Extended Text, Custom Item/Service Name
    • Buyer Phone Number, Document Comments
    • GTIN, Clear CN Code, Clear Batch Number
    • Serial Numbers