Fiscalization in Albania

Albania only - fiscalize clinic payments through Bills.al (eBills), register your TCR devices, and handle daily operations, failures and cancellations.

This guide is for clinics in Albania. Fiscalization there is a cloud connection to the CIS (Central Invoice System) through our certified partner Bills.al (eBills) - no special hardware, and every receipt gets the government QR code, NIVF and NSLF automatically. If your clinic is in North Macedonia, this page does not apply to you - read Fiscal Printer Agents instead.

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 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.

Part 1 - Enable Fiscalization

Open Fiscalization Settings

Turn It On and Pick a Provider

Toggle Enable Fiscalization on. The rest of the form appears below the toggle. Under Fiscalization Provider, select Bills.al (eBills) - the list is already filtered to providers available in your country.

Enter Your Tax Identification

Fill in the Tax Identification fields:

NIPT / Tax ID - 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

Under VAT & 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 - check this to automatically fiscalize every payment when it's captured. Leave it unchecked and payments are saved normally, but you'll need to fiscalize them manually.

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 and Save

Click Test Connection. Wait a few seconds - you'll see a success or an error message inline, right below the button.
If the test fails, double-check your NIPT, Operator Code, and Business Unit Code.
Click Save Settings at the bottom of the page to persist your changes.

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

From Settings → Fiscalization & VAT, click the Fiscal Devices button at the top of the page.

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 on the Fiscal Devices page 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

From Settings → Fiscalization & VAT, click the Fiscal Documents button at the top of the page. If any documents have failed, the button shows a count badge.
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

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

Cancelling a Fiscalized Document

Open Fiscal Documents (from Settings → Fiscalization & VAT, or from Fiscalization → Documents in the main sidebar).
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.

Is Bills.al the only option?

Bills.al is our certified partner for Albania. Dentare's fiscalization is built on a provider-agnostic architecture - 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. Open Fiscal Documents from Settings → Fiscalization & VAT, 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 in Albania

On this page