UOL (Účetnictví Online) Integration
Direct integration with the UOL (Účetnictví Online) accounting system. Automatic invoice dispatch to accounting including contact creation, PDF document upload, and VAT rate mapping. Supports both incoming and outgoing invoices.
Screenshots and a more detailed guide are coming soon.
Configuration setup
In the 'UOL API Integration' feature settings, enter: API key, UOL instance base address (e.g., https://yourcompany.ucetnictvi.uol.cz), API user email address, and API token. Additionally, a forwarding email address (FWD Mail) is available for an alternative way to upload invoices directly to UOL.
Sending invoice to UOL
In the invoice detail, click 'Dispatch To UOL'. The system: 1) Searches for or creates a contact in UOL (looks up by ID number, VAT ID, or external ID), 2) Transforms the invoice to UOL API format — maps symbols, VAT rates (grouped into 3 groups), payment method and currency, 3) Sends the invoice — incoming to /api/v1/purchase_invoices, outgoing to /api/v1/sales_invoices, 4) Uploads the PDF document and pairs it with the invoice. After successful dispatch, the send date and accounting ID are recorded.
Email forwarding
Alternatively, invoices can be sent to UOL by forwarding email to a special collection address (e.g., upload+yourcompany@uol.cz). In the invoice detail, click 'FWD to UOL'. The system forwards the invoice PDF document by email to the configured UOL collection address. This method is suitable as a fallback if API integration is unavailable.
Contact management in UOL
When sending an invoice, the system automatically ensures the contact exists in UOL. It searches sequentially: by ID number (company_number), by VAT ID (vatin), and by external ID. If the contact doesn't exist, it automatically creates it including address, bank details (IBAN and domestic account number/bank code format), and contact information. The UOL contact ID is saved for future use.