Fiscal Printer Agents

This guide is for clinics in North Macedonia. Fiscal receipts there come out of a certified Synergy fiscal device made by Accent (Скопје) at your clinic, and Dentare drives that device through a small Windows app called the Dentare Fiscal Agent. If your clinic is in Albania, this page does not apply to you - read Fiscalization in Albania instead.

Supported Devices

Dentare supports two families of Accent's Synergy devices. Setup in Dentare is the same for both; the differences are on the device side.

The Printer Model list in Dentare shows a few more Synergy models (SY-55, SY-46, SY-47). Only the three above are driven by the Fiscal Agent today; if you have a different certified device, contact support before buying anything.

Accent's support page has the user guides, the Windows driver for the RS-232-to-USB adapter, and their service contacts - keep it handy for anything on the device side (paper, cables, the operator password your dealer set, fiscalization of the device itself).

How It Fits Together

1. A staff member takes a payment in Dentare (visit checkout, X-ray payment, or a quote payment).
2. Dentare builds the fiscal receipt and sends it to the Fiscal Agent on the Windows computer at reception.
3. The agent talks to the Synergy device over the COM port and prints the receipt from the device's fiscal memory.
4. The agent reports the fiscal number back, and the payment in Dentare shows as Fiscalized.

The agent keeps a small local queue: if the internet drops for a moment, receipts wait on the computer and print when the connection is back. If the computer is off or the app is not running, receipts wait in Dentare and print as soon as the agent reconnects.

What You'll Need

• A certified Accent Synergy PF-550, PF-700 or SY-250, already fiscalized for your clinic (your dealer does this)
• A Windows 10 or 11 computer at the payment station, connected to the device (RS-232 COM port, or Accent's USB adapter with its driver installed)
• Your clinic's tax number (EDB)
• The device's operator password - 0000 on a PF-550/PF-700, 1 on an SY-250 from the factory; dealers sometimes change it, so ask if you are unsure
• A Dentare clinic admin login (Fiscalization settings and printer agents are admin-only)

Part 1 - Turn On Fiscalization

Part 2 - Add the Printer Agent in Dentare

Each Windows computer with a fiscal device attached is one agent. Most clinics have one, at reception.

Part 3 - Install and Configure the Fiscal Agent on Windows

The Dentare Fiscal Agent is a small Windows app that runs in the background on the computer connected to the printer. It installs for one Windows user, starts with Windows, and updates itself. Do this part on the reception computer, logged in with the Windows account reception uses every day.

Requirements: Windows 10 or 11, the Synergy device connected to the computer and switched on, and a Windows account that can approve the administrator prompt (the app needs it to talk to the COM port). Nothing else has to be installed - the app brings its own runtime.

Model Notes

Using the App Day to Day

Day to day nobody needs to open the app; it runs from the tray. Closing the window with X only hides it - the tray balloon says "Agent is still running in the background". To bring it back, double-click the tray icon, or right-click it and choose Open Dentare Fiscal. Exit in the same menu stops fiscal printing on this computer until someone starts Dentare Fiscal Agent from the Start Menu again.

Tray icon colours: green - printer and Dentare both connected; amber - one of the two is down; red - the agent is stopped, or fiscal printing is paused (see Troubleshooting).

What the tabs are for:

• Status - the three connection cards, today's counts (fiscal receipts, storno receipts, failed jobs, last Z report), Test All and Restart.
• Configuration - the settings from this part.
• Diagnostics - Test Printer (opens the port, identifies the device, reads its fiscal status), Test Server (checks the token and the live link to Dentare), and Clear Stuck Receipt (closes a receipt the printer left open after a power cut or paper jam).
• Reports - the same reports as the agent page in Dentare, printed directly from the computer: X, Extended Control, Diagnostic, Z (close day), fiscal-memory reports by date or by closure number, tax rate changes.
• Cash - Cash In and Cash Out service slips, Open Drawer, and today's payment breakdown and daily sums.
• Jobs - every receipt and report this computer has printed or is about to print, with status, fiscal number and attempts, and a Retry button for failed ones.
• Logs - the live log; Copy for support puts the visible lines on the clipboard.
• About - version, Check for updates, Machine ID, the program and data folders, Copy support info and Open logs folder.

The app updates itself. It checks for a new version when it starts, every 6 hours, and when someone clicks Update now in Dentare, downloads in the background, and restarts once the print queue is empty; the restart takes a few seconds. Check for updates in the About tab runs the same check on demand.

If support asks for files, they are here: settings in C:\ProgramData\DentareFiscal\appsettings.json, the local queue in C:\ProgramData\DentareFiscal\data\, logs in C:\ProgramData\DentareFiscal\logs\. To remove the app, use Settings → Apps → Installed apps → Dentare Fiscal Agent → Uninstall.

Part 4 - Verify

Daily Use

Taking Payments

With Auto-fiscalize payments on, every cash or card payment prints its fiscal receipt as soon as it is taken - reception does nothing extra. The payment screen shows a green check once the fiscal number is back; while the printer is still working, pressing Fiscalize again only tells you the receipt is being fiscalized instead of sending a second one.

If auto-fiscalization is off, or a receipt failed, reception clicks Fiscalize on the payment screen. Cash prints as cash and card as card. A bank transfer is documented by its invoice, not a fiscal receipt - Dentare does not send it to the printer, and the payment screen shows no Fiscalize button for it.

More Than One Printer

A clinic can run several agents - reception and a back office, for example. When more than one agent is set up, the Fiscalize button first asks which fiscal printer should print the receipt, showing each agent with its online/offline status. Offline printers cannot be chosen. Automatic fiscalization uses the first online agent.

If a printer is out of use for a while, open its agent and click Disable so nobody sends receipts to it; Enable brings it back.

Reports and the Fiscal Day

Everything the device can print is available from the agent page under Fiscal Reports, so nobody has to press keys on the printer:

• Quick Reports - X Report (Control) at any time; Z Report (Daily Close) to close the fiscal day (this writes the daily totals to fiscal memory and cannot be undone - Dentare asks you to confirm and refuses a second Z report on the same day); Diagnostic, Extended Control, Cash Report
• Date Range Reports and Number Range Reports - short and detailed fiscal-memory reports for your accountant, plus Tax Rate Changes
• Cash Operations - Cash In (Deposit) and Cash Out (Withdrawal) for the float

Clinic admins also get a small printer monitor in the sidebar: a green, amber or red dot for the agents, and Test Print, Diagnostic and X Report for each one, without leaving the page they are on.

Fiscal Documents

Every fiscal receipt is also a fiscal document in Dentare. Open Fiscal Documents from Settings → Fiscalization & VAT (or Fiscalization → Documents in the sidebar) to filter by status, type and date. Statuses:

• Fiscalized (green) - printed, fiscal number stored
• Finalizing (blue) - sent to the agent, waiting for the printer
• Failed (red) - the printer rejected it or the agent could not reach it - see Troubleshooting
• Draft (gray) - being prepared, brief

The Print Jobs page (View all jobs on the agent page) shows the same activity from the printer's point of view: every job, its attempts, the fiscal number, and the error text the printer returned.

Troubleshooting

The agent shows offline. The Windows computer is off, asleep, or the app is not running. Payments are still recorded; receipts wait and print when the agent reconnects. Start the computer, open the Dentare Fiscal Agent, and watch Last Heartbeat on the agent page.

Receipts fail but Test Print and reports work. The device is rejecting the operator password (the printer says "wrong operator password"). Reports need no operator login, receipts do. Open the agent, enter the correct Operator password (0000 for PF-550/PF-700, 1 for SY-250, or whatever your dealer set) and save. Note that Synergy devices lock after three wrong passwords until they are switched off and on - power-cycle the device before trying again.

"Agent is not available (offline or disabled)". Either the agent is offline, or Dentare disabled it. Dentare disables an agent on its own after 5 consecutive failed prints so a broken printer does not keep consuming receipt numbers. Fix the printer, then open the agent and click Enable.

A payment shows Failed. Dentare retries a failed receipt every 15 minutes, up to 5 times. You do not have to wait: click Fiscalize on the payment screen (pick the printer if asked), or open the document under Fiscal Documents and click Retry. The receipt is re-sent to the printer as the same document - no second receipt number is used. If the sidebar shows a red badge next to Fiscalization, the Failed Documents page lists everything that needs attention.

A payment shows Fiscalizing... for a long time. The agent has the receipt but the printer has not answered - usually paper out, cover open, or the device switched off. Check the device; the job completes on its own once the printer answers. If it stays stuck, Dentare marks it failed after a few minutes and the retry rules above apply.

Nothing prints and the agent is online. Check the printer's paper and cover, then the COM port and cable. Diagnostic from the agent page or the sidebar monitor prints the device's own status.

The app shows "Fiscal printing is paused". The red banner on the Status tab means Dentare is refusing this agent: the agent is disabled in Dentare (not enabled yet, disabled by hand, or auto-disabled after 5 failed prints), the clinic's account is suspended, or the agent has been banned for violating the terms of use. For a disabled or suspended agent, fix the cause in Dentare (or contact support for a suspended account) and the app resumes on its own within 2 minutes. A ban is permanent and revokes the agent - it will not resume on its own; if you believe it was banned by mistake, contact support to have it reviewed.

"Save failed: Access denied" in Configuration. The app was started without administrator rights. Exit it from the tray icon and start Dentare Fiscal Agent from the Start Menu, confirming the administrator prompt.

The COM port changed. USB-to-serial adapters get a new COM number when plugged into a different USB socket. Open Configuration, click Refresh, pick the new port and save. Keep the adapter in the same socket to avoid this.

Jobs fail with "-11015 Отворена сметка!" (open receipt). The printer still has a receipt open from an interrupted print. In the app, open Diagnostics and click Clear Stuck Receipt; it tenders any amount due and closes the receipt. Then retry the failed jobs from Dentare or from the Jobs tab. The app also does this on its own every time it starts.

We changed the reception computer. Install the agent on the new computer as in Part 3, open the agent in Dentare, click Rotate Token, and paste the new token into the app. The old computer stops being able to connect.

Keeping the agent up to date. The Windows app updates itself. When Dentare notices a newer version it shows Update available on the agent page; click Update now to apply it right away instead of waiting. Check for updates in the app's About tab does the same from the computer.

Frequently Asked Questions

Do I need to enter an operator code?

No. Dentare prints as till operator 1. What the device checks is the operator password - see Part 2.

Which VAT rate do I choose?

0% if your clinic is not a VAT payer (most dental clinics in North Macedonia), 18% if it is. When in doubt, ask your accountant - the tax group is printed on every receipt.

Can I still print a fiscal receipt if the internet is down?

If the receipt already reached the agent, yes - the agent queues locally and prints. If it did not, the payment is saved and the receipt prints as soon as the connection is back. No payment is lost either way.

Does the fiscal receipt replace the patient receipt?

No. The Synergy device prints the legal fiscal receipt. Dentare's own receipt (PDF, email, or the counter printer under Receipt Printers) is separate and optional.

We have two locations.

Each location is its own clinic in Dentare, with its own tax number, agents and fiscal documents.

Where do I find the Fiscal Agent installer?

Download it from https://releases.dentare.io/DentareMkFiscal-win-Setup.exe and follow Part 3.