UBLKIT logo

Online manual

UBLKIT User Manual

For UBLKIT Online, UBLKIT Pro, and UBLKIT Desktop

![Conversion flow](Screenshot from 2025-12-07 13-16-04.png)

1. Introduction

UBLKIT is a suite of tools designed to help businesses, accountants, developers, and organizations work with UBL (Universal Business Language) and electronic invoicing in an efficient and reliable way.

UBLKIT allows you to:

  • Convert UBL/XML to PDF
  • Extract UBL/XML from PDF
  • Validate UBL files
  • Inspect and correct metadata
  • Process files individually or in batches
  • Work fully offline (Pro & Desktop)
  • Automate tasks (Pro)

All versions of UBLKIT share the core conversion engine but differ in scope and functionality:

Version Best For Key Features
UBLKIT Online Quick usage in browser UBL→PDF, PDF→XML, validation, metadata editing
UBLKIT Pro Professional & high-volume workflows Batch tools, offline mode, detailed validation, templates
UBLKIT Desktop Simple offline usage UBL→PDF, PDF→UBL, validation

2. Understanding UBL and e-Invoicing

UBL (Universal Business Language) is a standard XML format for electronic invoices and business documents. It is widely used across Europe thanks to Peppol BIS profiles and government-mandated e-invoicing.

UBLKIT supports:

  • Standard UBL 2.x XML invoices
  • Peppol BIS 3.x (when validation is enabled)
  • PDFs with embedded UBL (also called "hybrid PDFs")
  • PDF generation using consistent formatting templates
  • JSON export for system integration

Typical workflows include:

  • Creating customer-ready PDFs from ERP-generated UBL invoices
  • Extracting UBL/XML from supplier PDF invoices
  • Validating invoices before sending them through Peppol
  • Inspecting and correcting invoice metadata

3. UBLKIT Online

UBLKIT Online is the fastest method to convert and inspect invoices directly in your browser.
No installation is required.

All processing is isolated by session, and temporary files are automatically cleaned up.
UBLKIT Online is not a storage service — download your results promptly.

🌐 3.1 Access

URL: https://ublkit.com
(replace with final domain)

3.2 What You Can Do

UBLKIT Online supports:

  • ➤ Convert UBL/XML → PDF
  • ➤ Extract UBL/XML from PDF
  • ➤ Edit invoice metadata before generating XML
  • ➤ Validate UBL invoices
  • ➤ Upload and process multiple files (within limits)
  • ➤ Clear all your uploaded files with Flush

3.3 Converting UBL/XML → PDF (Step-by-Step)

1️⃣ Open the Online Tool

Go to the UBLKIT Online website.

2️⃣ Select UBL/XML → PDF

3️⃣ Upload Your Files

Upload .xml or .ubl files using:

  • Upload button, or
  • Drag-and-drop

Upload limits apply. Extra files are rejected with a clear warning.

4️⃣ Review the File List

Each file shows:

  • Name
  • Size
  • Status (Ready, Converted, Error)

5️⃣ Convert

Click Convert to generate customer-ready PDFs.

6️⃣ Download PDFs

Options include:

  • Download PDF (per file)
  • Download All (ZIP) (if available)

7️⃣ Optional: Flush Your Session

This removes all files and resets the interface.

3.4 Extracting UBL from PDF + Metadata Editing

1️⃣ Select PDF → UBL/XML

2️⃣ Upload PDF Files

Drag-and-drop or use the Upload button.

3️⃣ Automatic UBL Detection

Each PDF will show:

  • UBL detected → editable
  • No UBL found → extraction not possible

4️⃣ Edit Metadata

Editable fields may include:

  • Supplier
  • Customer
  • Invoice number
  • Invoice date
  • Due date
  • Currency
  • Totals

Only safe, non-structural fields are shown.

5️⃣ Save & Regenerate XML

UBLKIT creates a new XML file with valid structure + your updates.

6️⃣ Download

  • Download XML / UBL
  • Optional: Validation report

7️⃣ Optional: Flush

Clear all uploaded and generated files.

3.5 File Limits

To keep UBLKIT Online stable:

Maximum number of files

  • Limited batch size
  • Exceeding the limit triggers an error message

Maximum file size

  • Very large files may be rejected

For heavy workloads, use UBLKIT Pro or UBLKIT Desktop.

3.6 Privacy, Isolation & Automatic Cleanup

  • You cannot see files from other users
  • Other users cannot see your files
  • Temporary files are deleted automatically
  • Download links expire after a short period
  • Uploaded data is not stored permanently

3.7 Manual Flush

Use Flush / Clear / Reset to:

  • Delete all uploaded files
  • Delete all generated outputs (PDF, XML, reports)
  • Reset the interface

4. UBLKIT Pro

UBLKIT Pro is the advanced version intended for professional users, accountants, and organizations dealing with significant volumes of invoices.

It includes:

  • Batch conversion & validation
  • Configurable PDF templates
  • JSON export
  • Offline operation
  • Detailed validation reports
  • Automatic error handling rules
  • Customizable output paths
  • Licensing controls

4.1 Installation

🪟 Windows

  1. Download the installer
  2. Run the .exe
  3. Follow the setup wizard
  4. Launch UBLKIT Pro from the Start Menu

🍎 macOS

  1. Download .dmg
  2. Drag app to Applications
  3. Allow execution (if required) in System Settings → Privacy & Security

🐧 Linux

For .deb packages:

sudo apt install ./ublkitpro-x.y.z.deb