Fiscalization

Automatically fiscalize all clinic payments through Albania's CIS via Bills.al - credentials, devices, daily ops, and corrections.

Automatically fiscalize all clinic payments through Albania's CIS (Central Invoice System). This guide walks you through configuring fiscalization in your Dentare account, registering your point-of-sale devices, and understanding daily operations.

Before You Begin

Make sure you have the following ready before opening Dentare settings:

Active business registration - registered with QKB (National Business Center)
NIPT/NUIS - your tax identification number (e.g., K72001008V)
Operator Code - obtained from the e-Albania portal. Each operator or cashier at your clinic needs their own code.
Business Unit Code - registered on the Central Invoice Platform
Bills.al account - signed up with our certified partner Bills.al and received your credentials (Software Code, POS IDs)

Your Bills.al representative will confirm whether an AKSHI digital certificate is needed for your setup. In cloud mode (which Dentare uses), Bills.al typically handles certificate management on your behalf.

About Dentare's Fiscalization System

Dentare currently offers fiscalization for clinics operating in Albania through our certified partner Bills.al (eBills).

Our fiscalization system is built on an open, provider-agnostic architecture. Bills.al is our launch partner for Albania - not your only option. If your clinic already works with a different fiscalization provider, contact support to discuss integration possibilities.

Expansion to other Balkan countries (North Macedonia, Serbia, Kosovo) is on our roadmap.

Part 1 - Enable Fiscalization

Open Fiscalization Settings

Log in to Dentare as a clinic admin
Go to Clinic Settings (Cilësimet e Klinikës)
Click Fiscalization (Fiskalizimi) in the sidebar

Configure Your Credentials

Toggle Enable Fiscalization to ON
Select Bills.al (eBills) as your provider
Fill in the following fields:

NIPT - your business tax identification number (e.g., K72001008V)
Operator Code - the code assigned to you on e-Albania (e.g., zk781mi007)
Business Unit Code - the code registered on the Central Invoice Platform (e.g., ab123ab123)
Software Code - provided by your Bills.al representative

Set VAT and Automation

Default VAT Rate - select 20% (standard rate for dental services in Albania). Consult your accountant if specific services qualify for a reduced rate (0%, 6%, or 10%).
Auto-fiscalize payments - toggle this ON to automatically fiscalize every payment when it's captured. If you toggle it OFF, payments are saved normally but you'll need to fiscalize them manually.
Click Save Settings

Tip

Keep auto-fiscalization ON for production use. Only turn it OFF during initial testing or if you want to review payments before they're fiscalized.

Test Your Connection

Click the Test Connection button
Wait a few seconds - you'll see a green success message or a red error message
If the test fails, double-check your NIPT, Operator Code, and Business Unit Code

A successful connection test means Dentare can communicate with Bills.al. It does not mean your POS device is registered - that's the next step.

Part 2 - Set Up Fiscal Devices (POS/TCR)

A "fiscal device" represents each workstation or computer at your clinic that processes payments. Albanian law requires each point of sale to be registered as a TCR (Tax Cash Register) with the tax authority.

Navigate to Devices

Go to Clinic Settings → Fiscalization → Devices (Pajisjet Fiskale)

Add Your First Device

Click Add Device
Fill in the details:

Device Name - a friendly name for this workstation (e.g., "Recepsioni", "Dhoma 1", "X-Ray Room")
POS ID - the unique identifier for this point of sale, provided by your Bills.al representative
Business Unit Code - auto-filled from your settings (you can override if this device belongs to a different business unit)

Click Save

Register the Device (TCR)

After creating the device, you'll see it listed with a Pending status (yellow badge)
Click the Register TCR button next to the device
Confirm the registration when prompted
Wait for the status to change to Registered (green badge)

You need at least one registered device before payments can be fiscalized. If registration fails, check that your Bills.al credentials are correct and try again.

Adding More Devices

Repeat the steps above for each workstation that processes payments. Each device gets its own POS ID and maintains its own sequential invoice numbering.

Tip

Most small clinics need only 1–2 devices: one at reception and optionally one in the X-Ray department. You don't need a device per treatment room - only per payment station.

Part 3 - Daily Operations

Once fiscalization is set up, most operations are automatic. Here's what happens during a normal day.

Automatic Fiscalization

When a staff member processes a payment (visit checkout, X-Ray payment, or standalone payment):

The payment is saved immediately - the patient's receipt prints normally
In the background, Dentare sends the payment data to Bills.al
Bills.al forwards it to the CIS (government system) and returns a fiscal verification code
The receipt is updated with the government QR code, NIVF, and NSLF codes

Tip

The payment goes through instantly for the patient. Fiscalization happens asynchronously - if the internet is briefly slow, the payment is still captured and will be fiscalized within seconds when the response arrives.

Daily Cash Balance

If your clinic accepts cash payments, Albanian law requires a daily cash balance registration before the first transaction.

Dentare handles this automatically. Every day at 6:00 AM, the system registers the opening balance for each of your active fiscal devices. You don't need to do anything.

Cash Deposits & Withdrawals

If you add cash to or remove cash from the register during the day (cash float, bank deposit), these operations should be recorded through the fiscal system. This feature will be available in the Fiscalization → Devices section in a future update.

The QR Code on Receipts

Every fiscalized receipt includes a QR code in the footer section. This QR code:

Links to the Albanian government's verification portal
Allows patients (or tax inspectors) to verify the transaction is properly registered
Contains the NIVF (government invoice number) and NSLF (local invoice number)

The QR code only appears on receipts for fiscalized payments. If a payment is still pending fiscalization, the receipt prints without the QR code and is updated once fiscalization completes.

Payment Methods

All payment methods are fiscalized automatically:

Cash (Para në dorë) - mapped to CASH in the fiscal system
Card (Kartë) - mapped to KARTE
Bank Transfer (Transfer bankar) - mapped to BANKE

Part 4 - Monitoring & Troubleshooting

Viewing Fiscal Documents

Go to Clinic Settings → Fiscalization → Documents (Dokumentet Fiskale)
You'll see a list of all fiscal documents with their status
Use the filters at the top to narrow by status, type, or date range

Understanding Status Badges

Fiscalized (green) - Successfully registered with the tax authority. Everything is in order.
Finalizing (blue) - Currently being sent to the tax authority. Usually resolves within seconds.
Failed (red) - The fiscalization attempt failed. See below for what to do.
Draft (gray) - Created but not yet sent. This is brief and transient.
Corrected (amber) - This document was replaced by a correction document.
Cancelled (gray) - This document was cancelled. A cancellation document exists.

When a Document Fails

If a fiscal document shows a Failed status:

Don't panic - the system retries automatically every 15 minutes, up to 5 times
Check the error message on the document detail page for clues
Common causes:
- Internet connectivity issue - the retry will likely succeed automatically
- Invalid credentials - check your NIPT, Operator Code, and Business Unit Code in settings
- Bills.al service temporarily unavailable - wait and retry
If still failing after 5 retries, click Retry manually on the document detail page
If the problem persists, contact support with the document ID and error message

A failed fiscalization does NOT affect the payment itself. The patient's payment is still recorded. Only the tax authority notification failed and needs to be resolved.

The Failed Queue

If you see a red badge next to "Fiscalization" in the sidebar, it means there are failed documents that need attention. Click through to the Failed Documents page to see them all in one place with retry buttons.

Part 5 - Corrections & Cancellations

Albanian law does not allow deleting a fiscalized invoice. If you need to fix an error, you must issue a corrective document.

Cancelling a Fiscalized Document

Go to Fiscalization → Documents
Find the document you need to cancel
Click on it to open the detail page
Click the Cancel Invoice button (red)
Confirm the cancellation

What happens:

A new Cancellation document is created with negative amounts
The cancellation is sent to the tax authority
The original document's status changes to Cancelled
Both documents are linked in the Document Chain on the detail page

After cancelling, you should create a new correct payment to replace the cancelled one. The new payment will be automatically fiscalized as a fresh document.

Viewing the Document Chain

When a document has been corrected or cancelled, the detail page shows a Document Chain in the sidebar. This shows the original document and all related corrections/cancellations in chronological order.

Frequently Asked Questions

Do I need a separate Bills.al account?

Yes. You need to sign up with Bills.al and receive your credentials (Software Code, POS IDs) before configuring fiscalization in Dentare.

What if I already use another fiscalization software?

Contact support. Dentare's fiscalization system is built on a provider-agnostic architecture. We can discuss integrating your existing provider.

Is Bills.al the only option?

Bills.al is our current certified partner for Albania. Our architecture supports multiple providers - if you work with a different fiscalization provider, contact support to discuss integration possibilities.

What happens if the internet goes down?

Payments continue to work normally. The payment is saved locally and the fiscalization is queued. When the internet connection is restored, the system automatically retries and fiscalizes all pending payments. No data is lost.

Do I need to do anything daily?

If you accept cash payments, the daily cash balance registration is handled automatically at 6:00 AM. Your only routine task is to check the Failed Documents queue if you see a red badge - but most clinics will rarely see failures.

Can my accountant access fiscal reports?

Yes. Go to Fiscalization → Documents, use the date range filters to select the period, and view all fiscalized transactions. Export functionality is coming in a future update.

What VAT rate should I use?

20% is the standard VAT rate for dental services in Albania. If specific services at your clinic qualify for a reduced rate (0%, 6%, or 10%), consult your accountant and adjust the default rate accordingly.

What does the QR code on the receipt do?

The QR code links to the Albanian government's verification portal. Anyone - patients, tax inspectors, or your accountant - can scan it to verify that the transaction is properly registered with the tax authority.

We have multiple clinics - do we set this up per clinic?

Yes. Each clinic (Dentare account) configures its own NIPT, operator codes, and fiscal devices independently. This ensures correct tax attribution per business entity.

Can I test before going live?

Yes. Ask your Bills.al representative for test environment credentials. Toggle off Auto-fiscalize payments in settings while testing. When you're ready, switch to production credentials and toggle auto-fiscalization back on.

Fiscalization

On this page