Cashbook integration

Cashbook is an external Hungarian online service that collects the invoices of a business for bookkeeping and cash-flow follow-up. The Cashbook integráció (eyssen_l10n_hu_cashbook) module transfers the invoices, credit notes and pro-forma invoices of the company to Cashbook automatically, as structured data together with the PDF, and re-sends an invoice with its payment data whenever a payment is reconciled with it.

Note

• This integration is not related to the cash register (házipénztár) feature.

• The module requires eyssen_l10n_hu and eyssen_l10n_hu_proforma. Its labels are displayed in Hungarian in the current module version.

Configuration

Request an API key from Cashbook, then go to Accounting ‣ Configuration ‣ Settings, section Cashbook adatszolgáltatás (the same fields are available in the CashBook adatszolgáltatás tab of the company form):

• tick Cashbook adatszolgáltatás;

• Üzemmód: Teszt üzemmód (test system, the default) or Éles adatszolgáltatás (production);

• Ne küldjük be a Cashbook-nak a számlákat. KIZÁRÓLAG TESZTELÉSRE!: suspends the transfer, for testing;

• Cashbook kulcs: the API key.

screenshot: finance-fl-hungary-cashbook-settings

menu

Accounting ‣ Configuration ‣ Settings

shows

Settings page scrolled to the "Cashbook adatszolgáltatás" section with the feature ticked, the mode selector, the testing switch and the "Login Details" block with the API key field.

highlight

The "Cashbook adatszolgáltatás" section (red frame).

data

Demo company "YourCompany HU"; mode "Teszt üzemmód".

module

eyssen_l10n_hu_cashbook

notes

Hungarian field labels (hardcoded), light theme, 1440px width, crop to the section. Use a throw-away secret; the key must not be readable.

At installation, a to-do activity Cashbook adatszolgáltatáshoz be kell állítani! is created on every company. A copied (neutralized) database is switched to test mode with the transfer disabled.

Important

Enter the API key right after installing the module. In the current module version, confirming a pro-forma invoice and reconciling a payment fail while the key is empty, even if the Cashbook adatszolgáltatás option is not ticked.

To exclude a whole journal (for example, a journal of invoices issued in another system), open it in developer mode and tick Nem kell átadni a Cashbook-nak! in the Hungarian Invoicing section.

Transfer and follow-up

Posted customer invoices, vendor bills and credit notes, as well as confirmed pro-forma invoices, are queued when they are confirmed; a background job sends them about a minute later and retries every five minutes. The PDF sent is the main attachment of the document, or the printed invoice.

The CashBook tab of the invoice and of the pro-forma invoice shows the Cashbook státusz, which is also available as a column in the invoice, credit note and pro-forma lists: Beküldés folyamatban (queued), Beküldve (sent), Sikeresen feldolgozva (processed), or the error reported by Cashbook (for example, unreadable data, missing PDF, unknown tax number, or missing permission for vendor bills). In developer mode, the tab contains the buttons Beküldés a CashBook-ba, Azonnali beküldés a CashBook-ba and Státusz ellenőrzés for administrators.