Your guide to Vlerano.

Find the page you need

The menu groups daily work, documents, finance, planning, and team/payroll. On smaller screens, open it with Menu. Use Kërko në menu to search by page name or keywords such as “pushime”, “PDF” or “listëpagesa”; accents are optional. Enter opens a single match. Escape clears a search; press it again to close the drawer.

Lexuesi i faturave uploads supplier invoices for OpenAI-assisted review. Arkivi stores evidence linked to invoices. Assistant, Help and Dil (sign out) remain at the bottom of the menu.

Assistant beside your app · new

Chat on the left and work on the right. Ask for a supplier, invoice, report or screen. Complete the action from its work card. Posting and payment recording require explicit document selection and review confirmation. No bank transfers occur. VAT proposals open the existing tax-review form. Chat survives navigation but clears on reload or company change.

Kosovo VAT · new

The owner configures the effective tax profile in TVSH. Complete buyer/supplier tax identities in Contacts, then select Kosovo VAT in the invoice form. Choose service category, net/gross price and the actual receiving establishment or residence. Calculate, review and save the draft.

Supported: ordinary 18% services, 8% waste services and selected services outside Kosovo VAT scope. A foreign address does not automatically mean 0%. EUR only; completed supply, invoice and posting must share a date. Goods, imports, advances, special schemes, partial deductions and payroll/income taxes are excluded. The VAT worksheet is not an ATK return. VAT proposals open the tax-review form.

1. Your first five minutes

1. Open the local address supplied by the operator. The usual staging address is http://127.0.0.1:8001; the development demo usually uses port 8000. Sign in with the method shown on that page.
2. Select Studio Drita — DEMO in the business selector. This practice business is seeded when the environment is initialized.
3. Open Përmbledhje (Overview). Set Nga to 1 September 2026 and Deri më to 26 September 2026, then choose Përditëso (Refresh).
4. Compare the original seed totals below. An environment where someone has already practised may have different totals; do not change transactions just to force a match.
5. Open Faturat to inspect the €600 invoice and its remaining €350. Try a new draft only after reading the invoice workflow below.

Draft → post → payment. Saving a draft does not change the financial reports. Posting records the sale or expense. Recording a later payment settles what is owed; it does not record the same income or expense again.

2. Sign in and access

Protected local staging

Enter the username in Përdoruesi i staging and password in Fjalëkalimi, then choose Hap demonstrimin. Obtain your own credentials from the operator. Do not share passwords or paste them into an AI chat.

Reloading preserves an active staging session. Sign-in expires after 15 minutes without authenticated activity, or after eight hours in total. Dil nga demonstrimi signs out and revokes that session. An operator password reset or account disable signs out all sessions for that account.

After repeated failed attempts, stop retrying and check your credentials with the operator. There is no email password-reset link or public sign-up. The operator handles account recovery.

Development demo

If the page asks for Çelësi lokal nga terminali, use the development token supplied by the local launcher. It is kept in page memory, so reloading signs you out. A staging password and a development token are different credentials.

Permissions

Owners and accountants can perform the supported bookkeeping actions for companies they can access. Viewers can read but cannot save financial changes. Some action buttons may still appear to viewers; the server rejects unauthorized saves. Ask the owner/operator for the right access rather than sharing someone else’s login.

Help is available before sign-in and contains no account records. The operator’s separate backup/status access does not automatically grant access to every business.

3. Choose a business and reporting dates

The selector at the top chooses the active business. Check it before creating a contact, uploading a document or recording a payment. Each business has its own records.

Nga is the start of the report period; Deri më is the “as of” date. Choose Përditëso after changing them. Overview and accounting views use these dates; the assistant hides the date controls.

A historical report excludes later-dated payments. For the untouched seed at 5 September 2026, bank is €5,000, receivables €600 and payables €120. Revenue (€600), expenses (€120) and result (€480) are already recognized; the September 10 settlements have not happened yet.

+ Biznes provë creates another empty synthetic business, not a live customer account. A new business does not automatically receive the Studio Drita seed. Ask the operator before starting another exercise if you need a shared dataset.

4. Add a customer or supplier

1. Open Kontaktet → + Kontakt i ri.
2. Enter a clearly synthetic name in Emri, for example “Klienti Test — DEMO”.
3. Choose Klient (customer), Furnitor (supplier), or Klient dhe furnitor (both).
4. Choose Ruaj (Save). Check that the contact appears in the active business.

Sales invoices need a customer; supplier bills need a supplier. If no suitable contact exists, the document workflow takes you to contact creation. Creating a contact never changes a balance.

5. Create and post an invoice or bill

1. For a sale, open Faturat → + Faturë e re. For a purchased service, open Shpenzimet → + Shpenzim i ri.
2. Select the correct customer or supplier. Describe the completed synthetic service.
3. Enter Sasia (quantity) and Çmimi për njësi (unit price). Use a decimal point, such as 100.00, without thousands separators or a currency symbol.
4. Check the service/posting date, document date and due date. In this version the service date is also the posting date; it must not be later than the document date, and the due date must not be earlier than the document date. The period must be open.
5. For a supplier bill, enter its reference in Referenca e faturës së furnitorit. Do not invent another reference to bypass a duplicate warning.
6. Choose Ruaj si draft. The draft has no posted number and does not affect financial totals.
7. Review the saved row. Only when correct, choose Regjistro (Post). Posting assigns a DEMO number and records the invoice or bill in the ledger.

The manual-entry form supports 1–100 service lines. Use + Shto shërbim to add a line and Hiq to remove one. Every line uses the same tax treatment. Check the server-calculated total with Kontrollo totalin or Llogarit TVSH-në; changing financial inputs clears the VAT review. It calculates VAT for supported services after configuring TVSH and contact tax profiles. It generates labelled DEMO PDFs and downloadable email drafts; see the sales workflow section below. Use the Assistant for a text request and review its proposal.

Check before saving and posting. Use Redakto on an unposted invoice or bill, enter a reason and save the changes. For VAT, calculate and review again before saving. Historiku · vN shows each revision and its before/after values. If another reviewer changes the draft first, refresh and review their version before saving or posting. Draft deletion and posted-record editing are unavailable. For an unpaid posted document, see corrections.

A small practice exercise

On an otherwise untouched seed, save a €100 customer invoice: totals stay unchanged. Post it: AR becomes €450, revenue €700 and result €580; bank remains €5,130. Record a €25 receipt on that invoice: bank becomes €5,155 and AR €425; revenue and result stay €700 and €580. Choose report dates that include both transactions.

6. Chat and upload documents with OpenAI

Asistenti offers bounded conversation about synthetic books. Supplier uploads are under Dokumentet → Lexuesi i faturave. Posting and payment recording require explicit review; the model cannot execute them autonomously or send invoices.

Ask about the books

OpenAI consent starts selected and can be unchecked. Enter a question and choose Dërgo ↑. Try “Who owes me money?”, “What were expenses this month?” or “Summarize the books through 2026-09-27”. Check the displayed period. OpenAI interprets the request; Vlerano calculates the figures. Drafts are excluded, later payments do not change historical answers, and expenses are separate from cash payments. Replies are Albanian-first.

Request a customer-invoice draft

For example: “Prepare a synthetic 250 EUR consulting invoice for Klienti Shembull — DEMO, service and issue date 2026-09-20, due 2026-09-30.” Complete missing fields in the card or clarify in a follow-up message. Select the active company's customer, review the amount and dates, confirm review and choose Ruaj vetëm si draft. The result appears in Faturat. Posting remains separate. This card supports one completed-service line. VAT proposals open the tax-review form; currency conversion and multi-line calculations are unavailable. A new chat request can produce another proposal: do not save the same service twice.

Conversation stays in page memory and clears on reload, logout or company change. Bisedë e re clears messages, not saved documents or drafts. Limits: 12 messages, 2,000 characters each and 8,000 total; 10 requests per user per minute. OpenAI receives user messages and today's date, not the contact directory or ledger figures automatically. Never enter real data or credentials.

Upload a supplier invoice

1. Prepare a synthetic supplier service invoice. The operator can provide the generated sample. Do not upload a real invoice, even with personal fields partly hidden.
2. Confirm separately that the document is synthetic. OpenAI consent starts selected and can be unchecked. The uploaded file leaves your device through the server for extraction.
3. Choose Zgjidh dokumentin, or drop one supported file into the upload area. Limits: PDF, PNG or JPEG, at most 6 MB; PDFs at most five pages; images at most 16 million pixels and a single frame.
4. Wait for the preview and suggested fields. Compare every field with the original: supplier, reference, currency, total, service/issue/due dates and description. Missing or uncertain fields need your review; a plausible answer can still be wrong.
5. Select an existing supplier in the active business. A suggested supplier name is not authorization to use that contact.
6. Correct the fields and confirm the reviewed, synthetic service-only scope. Choose Ruaj draftin e shqyrtuar to save the reviewed draft.
7. Find the draft under Shpenzimet. Financial totals remain unchanged until you separately choose Regjistro.

Detected tax claims or unsupported document types cannot be converted through this workflow. Do not remove tax information or alter the source to get around a rejection. The original source and its linked draft are kept as evidence.

Reopening a stored document lets you inspect it. The same source can create only one linked draft. Uploading the same file again normally returns the stored source. If an extraction fails, check the document list before retrying; repeated provider calls can incur charges.

If OpenAI is not configured or the provider rejects the request, contact the operator. Do not enter the OpenAI API key in the sign-in or invoice forms. You may still enter a supported synthetic service bill manually. There is no local OCR fallback.

7. Record a receipt or supplier payment

1. Find a posted document under Faturat or Shpenzimet.
2. Choose Arkëto for a customer receipt, or Paguaj for a supplier payment.
3. Enter the amount, actual synthetic payment date and a descriptive reference. You may record a partial payment.
4. Choose Regjistro pagesën. Check the remaining amount and report totals.

These buttons record a bookkeeping movement; they do not transfer money through a bank. One payment settles one document. Advances, refunds, overpayments and splitting a single payment across multiple documents are not supported.

The remaining amount shown follows the report’s as-of date. The server also checks later payments already saved, so it may reject an amount that looks available in an earlier report. Move the report date forward and review the history before trying again.

8. Correct a mistake

Posted records are preserved. They cannot be silently edited or deleted.

For a posted document with no payments, choose Anulo, supply a correction date in an open period and a reason, then choose Krijo korrigjimin. This creates a linked entry with the opposite financial effect and retains the original document. It is a full correction, not an approved statutory credit note.

There is no supported correction workflow here for a partially or fully paid document, no payment edit/refund workflow. Ask the operator/accountant to review the case. Do not add a fictitious offsetting transaction to hide the error.

9. Match synthetic bank movements

1. Open Rakordimi bankar. Choose the period to compare, then refresh.
2. Choose + Rresht bankar provë. Enter the synthetic bank-line date, receipt/payment direction, amount and reference.
3. Use the row’s matching action to select the corresponding recorded payment. Company, bank account, currency, movement date, direction and exact amount must agree. Review the reference before confirming; timing differences are not supported.
4. Confirm the match. Check the unmatched bank lines and unmatched recorded payments.
5. If a link is wrong, release it with a reason. To correct a bank line, first release any match, void the line with a reason and enter a replacement with a new, clearly labelled reference. The original reference stays reserved and history is retained.

For the original seed, compare September 10–26 and enter the €250 receipt and €120 supplier-payment lines. September 1 also includes the opening bank movement. Matching does not create another payment or change the ledger balances.

This is manual movement matching, not a live bank connection or full statement reconciliation. A zero difference does not prove that every statement line was entered, or verify the statement’s opening and closing balances. Locked periods restrict changes.

10. Read reports and export the journal

Përmbledhje shows the bank ledger, service revenue, receivables, payables and result. Bank ledger is the amount recorded in Vlerano; it is not a verified live bank balance. Result is revenue less expenses, not cash received less cash paid.

Kontabiliteti shows the balance-sheet management totals, trial balance and journal. Control differences should be zero in the supported exercises. If they are not, stop posting and ask the operator/accountant to investigate. Do not change figures to make a report balance.

To export, choose the period and Eksporto regjistrin CSV (or Eksporto CSV). Vlerano produces a frozen demo journal export and shows a hash identifier. Check your browser’s downloads and open the saved file to confirm that it arrived.

The CSV is not an ATK/EDI submission. A success/hash message means the server generated the export; it does not prove the browser saved it to disk. If the file is missing, see troubleshooting. This interface does not deliver approved statutory statements or filing.

11. Opening balances and period controls

These actions are for a reviewed exercise with the accountant/operator. A viewer cannot perform them.

• Vendos gjendjen hapëse: a simple bank/equity opening for a business with no existing postings. It does not import customer or supplier opening balances. Do not repeat it in the seeded business.
• Blloko periudhën: blocks new postings through the selected date without transferring the result. Review the records and supply a reason.
• Mbyll rezultatin: transfers the unclosed result to retained result and locks the period. The reports must not count that result twice.

Reopening a locked/closed period is not available in this version. Resolve drafts and review the dates before locking or closing. Ask the operator to take a verified backup before a period-control exercise. Restoring data is an operator action, not an undo button.

12. When something goes wrong

When reporting an issue, include the synthetic business name, report dates, steps and expected versus actual result. Do not include passwords, API keys, cookies or real invoices. There is no built-in support chat or automatic error-report submission.

13. Terms and current limits

The intended review profile is a Kosovo service business with a single EUR ledger, no inventory and the bounded DEMO payroll described below. Accountant approval is still pending. The original reference-book GBP tests do not establish multi-currency support for a business.

Not available or approved: real-business mode; complete tax coverage and fiscalization; official invoice documents and tax filing; unrestricted chat, questions over uploaded-file contents or autonomous financial actions; invoice emailing; live bank feeds; complete statement reconciliation; opening AR/AP migration; payroll outside the supported scope/inventory; correction of paid documents; refunds/advances; period reopening; hosted production use.

For account setup, backup, restore and monitoring, the operator uses the separate staging runbook. A supervised real-data pilot must wait for the accounting, security and hosted-operations acceptance gates.

14. Statements, archive, budgets, people and payroll

Statements: choose a customer or supplier, check the report dates and select “Shfaq kartelën”. Opening balances, documents and payments follow the report date. Customer and supplier balances stay separate for dual-role contacts.

Archive: select “+ Bashkëngjit dokument”, choose the invoice and a synthetic PDF/PNG/JPEG up to 3 MB, attest demo-only content, then save. Open an attachment to see its static preview and download its original. Older invoice-reader sources retain previews only. Archive attachments are not sent to OpenAI.

Comparative reports: the top filters select the active period; enter the comparison period in the workspace and select “Shfaq krahasimin”. Figures follow accrual recognition, not cash settlement.

Budgets: “Deri më” selects the full month. Choose “+ Planifiko shumën”, select an income/expense account, enter the planned amount and note, then save. Revisions preserve history. Variance means actual minus plan; a positive expense variance is an overrun. A dash means no plan was supplied.

People: add synthetic employee codes/names, employment start, monthly gross salary, job, department and primary/secondary employer type. “Kushtet” adds effective-dated terms. “Pushim” creates a leave request; “Shqyrto” approves or rejects it. Legal entitlements and holidays are not calculated. Only owners and accountants can access HR/payroll.

Payroll: choose the month, select “Llogarit për shqyrtim”, review calculations and scope, then “Ruaj draftin”. Drafts do not affect balances. “Shqyrto dhe regjistro” opens a separate posting confirmation. Record actual synthetic payments afterwards with the net/pension/tax component, amount, date and reference. Payment does not recognize the expense again. No bank transfers or ATK filings occur.

Supported DEMO scope: full months in 2026, full-time resident Kosovo citizens aged 18–64, standard 5% employee and 5% employer pensions. Partial months, bonuses, overtime, benefits, insurance and special cases are excluded. Pending leave and approved non-annual leave block payroll. Posted payroll cannot be cancelled in this version. Accountant acceptance for real use remains outstanding.

Ask Asistenti to add a demo employee, plan a monthly budget or prepare a payroll draft. It opens a reviewable form and gives exact next steps after saving.

14. Services, quotes, PDFs and email drafts

1. Open Faturat → Katalogu i shërbimeve → + Shërbim. Save a description, default quantity and exact unit price. Editing creates another version; existing invoices keep their prices. Inactive services stop appearing in the invoice picker.
2. In a new invoice/bill, choose a service and Shto nga katalogu. Review quantities, dates and tax treatment. The catalogue does not choose VAT eligibility.
3. Open Ofertat → + Ofertë, complete the lines and validity date, and save. Quotes do not create receivables or revenue. Use Redakto before conversion if terms change.
4. Choose Kthe në draft after checking the customer, completed service, dates and current VAT. Each quote converts once. An expired quote needs its validity reviewed first. The resulting invoice is still unposted.
5. Use Veprime të tjera → Shkarko PDF. Drafts, quotes and posted invoices are labelled separately. Every PDF is marked DEMO. The owner can set the display name, accent colour, address, payment details and footer under Paraqitja e faturës; tax identities come from the document's saved tax snapshot.
6. For a posted sales invoice choose Përgatit email. Enter the recipient, subject and message. Vlerano downloads an .eml email draft with the PDF attached. It does not send the message. An overdue unpaid invoice also offers Kujtesë pagese.
7. Open Shënime / aktiviteti to download a prepared email again or Shëno rezultatin after handling it externally. “Sent manually” is your record, not provider-confirmed delivery or proof the customer read it.

Only synthetic exercises are supported. PDF formatting and a tax calculation do not make a document an approved fiscal invoice. Downloaded emails and report packs retain their original content after later changes.

15. Accountant review and month-end checklist

Kontabiliteti → Puna për shqyrtim lists documents, current review status and missing attachments. An attachment flag records presence, not authenticity. The owner/accountant can add evidence in the Archive and comments in Shënime / aktiviteti.

1. Use an invoice's Kërko shqyrtim, or select drafts in the queue and choose Shqyrto të zgjedhurat (up to 25).
2. Choose request review, approve, or request changes, and enter a reason. Once review has been requested, posting requires approval of the current revision. A draft edit invalidates the old approval. Comments alone do not block posting.
3. Refresh and review again if another user changed a selected draft. Batch decisions are atomic: one stale draft prevents all selected decisions from being saved.
4. Open Lista e mbylljes mujore for the month selected by “Deri më”. Review bank reconciliation, customers, suppliers, VAT, payroll and evidence. Checked items require notes. A later change to the underlying records marks the checklist stale.

The checklist does not automatically lock or close the books. The review decision is an internal workflow decision, not tax certification. Viewers cannot change review decisions or access the accountant queue.

16. Duplicate, recurring and batch work

Veprime të tjera → Kopjo si draft opens an editable copy. It uses the selected report date and requires a new supplier reference for a bill. Review due dates and recalculate VAT before saving. The original remains unchanged.

Përsërite çdo muaj saves a monthly template from a document, with a start/end month. Under Përsëritjet mujore, inspect each due occurrence, select up to 25, confirm completed services and current tax facts, then Përgatit draftet e zgjedhura. The service day is preserved or clamped to the last day of a shorter month; payment-term days are retained. The date selected in “Deri më” controls which occurrences are due. Pausing a template preserves its history.

Each template/month creates at most one draft. A changed tax profile or template makes the preview stale and requires another review. There is no background posting, sending or automatic recognition of a future service. Recurring supplier references are synthetic generated references: replace them with the actual synthetic source reference when reviewing the draft.

Lexuesi i faturave accepts up to 10 selected or dropped PDF/PNG/JPEG files. Confirm the whole batch is synthetic and consent to sending it to OpenAI. Files are read sequentially, with a result per file; a failed file does not erase successful uploads. Open every source and review its fields individually before saving a bill. No bill is posted by uploading a batch.

17. Ledger details, cash forecasts and projects

In Kontabiliteti, click an account code to see opening balance, dated journal movements and closing balance. Raportet → Analiza e llogarive exposes the same drill-down. The ledger view includes closing entries; operating P&L excludes them.

Parashikimi i parasë begins with recorded bank cash at the selected date and projects 90 days of open invoices/bills. Later-dated payments do not alter that starting position. Overdue balances enter the first future day. Ndrysho supozimet changes the collection percentage and receipt delay and adds dated inflow/outflow assumptions.

Payroll, tax remittances, financing, new sales and other costs are not scheduled automatically; add them as assumptions without double-counting invoice/bill payments. Forecasts are not postings or guaranteed collections. Your scenario remains while navigating within the company and same report date, and resets on reload/company/date change.

Under Rezultati sipas projektit → + Projekt, create a project, then assign invoices/bills through Veprime të tjera → Cakto projektin. Entire documents are attributed; current assignments apply to historical project views. The report uses posted net revenue/expense and dated corrections, excluding VAT, settlements, payroll and shared overhead. Unassigned documents remain visible separately.

Shkarko paketën PDF + CSV freezes the management report, trial balance, project results, forecast and exact assumptions in a ZIP. It is a management review pack, not statutory statements.

18. Kosovo review books and payroll exports

TVSH → Librat e shitjes dhe blerjes lists supported posted service transactions and dated DEMO corrections using their saved tax identities and treatment. Sales VAT reconciles to account 2200 and deductible purchase VAT to account 1400 for the selected period. Differences must be resolved before export.

Libri i shitjes · XLSX and Libri i blerjes · XLSX preview separate workbooks using the supplied ATK VAT templates. Select the report dates, check the invoice references, dates, parties, ATK boxes and VAT totals, then confirm the review and choose Shkarko XLSX. Purchase rows use the supplier's original invoice reference. The saved export retains its original bytes after later book changes. Reopen the preview if Vlerano says the books changed.

The XLSX exporter supports existing domestic 18%/8% service cases with full purchase VAT deduction, supported foreign service sales, and domestic purchases from explicitly nonregistered suppliers. A valid registered-company tax profile and correctly formatted identities are required. Unsupported documents, tax-not-modelled records, DEMO corrections, nondeductible VAT ambiguity and formula/ledger rounding differences block the selected book. Empty books also require review: the guide's code 0 does not supply all mandatory zero-row values. Vlerano does not invent them. Each workbook is limited to 5,000 documents.

Paketa CSV për shqyrtim still produces sales/purchase CSVs, a separate excluded-document list, control totals and a manifest. Legacy tax-not-modelled documents are excluded from that review package, never classified as zero-rated or exempt. Outside-scope, nonregistered and taxable supplies remain distinct. DEMO reversals are labelled for separate statutory correction review.

Under Pagat → Fletëpagesat dhe eksporti për shqyrtim, download a posted payroll run's individual PDF payslips and CSV review schedule. They use the immutable posted salary/tax snapshot, not later employee terms. Access remains restricted to owner/accountant. Aggregate payroll payment records do not prove individual employee settlement.

These are synthetic accountant review exports. XLSX follows the supplied VAT-template columns, but EDI acceptance is unverified. General/non-VAT XLSX templates are not implemented. A partial date interval is not a complete monthly declaration. No export files a return, pays tax or certifies WM/CM compatibility. Review with your accountant before any filing use.

19. Companies and access

The active company selector shows only your memberships. Switching companies clears the previous company's forms, records and assistant conversation. An empty account shows a no-access message; ask the operator or owner for access.

Owners can open Qasja in the top bar to list members, choose an existing member or enter an account ID provided by the operator, grant viewer/accountant access or select Hiq qasjen to remove access. This changes only the selected company. Ownership cannot be removed here. Accountants can work across explicitly granted companies; they cannot manage members.

The operator creates new password accounts and empty rehearsal companies. Removing membership takes effect on the next request, including in an existing session. Data already downloaded cannot be recalled. This feature does not enable real-record use: advances, refunds and student enrolment workflows remain outside the current DEMO.

20. UPAY collection requests

For a posted sales invoice, open Veprime të tjera → UPAY · Kërkesat e arkëtimit. The operator must first confirm a test-only merchant and its currency for this company. An owner or accountant reviews the amount and creates a test collection code. Viewers can read the history.

The panel shows the code, provider expiry and quoted commission/total. No email is sent. A code or provider status is not a recorded receipt: invoice balances and reports stay unchanged. Reopen the panel to check status. Do not share test codes with real customers.

After a timeout or uncertain result, do not create another collection. Ask the operator to reconcile with UPAY. Existing requests are not automatically cancelled by a manual receipt; reconcile first. Card payments, automatic posting, advances and refunds are not supported by this connector. Real OESI use is not enabled.