Shtojca A — Shifrarët e UJP-së¶
Kjo shtojcë përmban një shqyrtim referencial të të gjithë shifrarëve (tabelat cb_*) që eFakturaWin përdor për përputhshmëri me sistemin e-Faturë të UJP-së. Shifrarët janë vetëm për lexim — plotësohen gjatë nisjes së parë të aplikacionit dhe përdoren në lista zbritëse nëpër formularët. Pamja që vijon është nga UJP Phase 2 (3 maj 2026).
A.0. Si përditësohen shifrarët¶
Gjatë nisjes së parë të aplikacionit, funksioni Db_Codebooks.prg::PopulateCodebookSeeds() mbush të gjitha tabelat cb_* nga të dhëna seed të integruara (baked-in). Ato të dhëna seed merren nga UJP në momentin e ndërtimit të versionit.
Çdo rresht në tabelat e shifrarëve ka kolonën last_synced — të rezervuar për një funksion të ardhshëm Shërbim → Rifresko shifrarët, që do t'i tërheqë listat më të reja drejtpërdrejt nga API-i i UJP-së.
🚧 Rifreskimi automatik nga UJP ende nuk është implementuar. Deri atëherë, shifrarët mbeten „të ngrirë" në gjendjen nga momenti i instalimit; kjo shtojcë e dokumenton atë gjendje. Nëse UJP ndërkohë shton një kod të ri (p.sh. arsye të re refuzimi), nevojitet përmirësim i eFakturaWin që ai kod të jetë i disponueshëm në aplikacion.
💡 Tabelat lokale
cb_*gjithmonë mund të shqyrtohen drejtpërdrejt në bazën SQLiteeFakturaWin.dbme një klient arbitrar SQLite. Ato janë burimi i së vërtetës për atë që është i disponueshëm në instalimin tuaj.
A.1. Shtetet¶
Kodet dyshkronjore ISO-3166 alpha-2 të shteteve. Përdoren në fushën „Shteti" të partnerit për të dalluar rezidentët (MK) nga jorezidentët (EDB e huaj + kodi i shtetit).
Ku shfaqet në aplikacion: Shifrarët → Partnerët → Futje/ndryshim → fusha Shteti.
UJP endpoint: GET /api/v1/countries
Shifrat (zgjedhje nga më të shpeshtat në tregtinë MK):
| Kodi | Emri |
|---|---|
| MK | Maqedonia e Veriut |
| AL | Shqipëria |
| AT | Austria |
| BG | Bullgaria |
| CH | Zvicra |
| DE | Gjermania |
| ES | Spanja |
| FR | Franca |
| GB | Mbretëria e Bashkuar |
| GR | Greqia |
| IT | Italia |
| NL | Holanda |
| RS | Serbia |
| TR | Turqia |
| US | Shtetet e Bashkuara të Amerikës |
Lista e plotë përmban ~200 shtete. Për një kod që nuk është këtu, shihni burimin e UJP-së: countries.json ose drejtpërdrejt GET /api/v1/countries.
Pamje nga UJP Phase 2 snapshot, 2026-05-03.
A.2. Monedhat¶
Kodet e monedhave. Shifrari i UJP-së përmban dy formate paralelisht: kodi treshkronjor ISO-4217 (EUR, USD, MKD…) dhe kodi treshifror ISO-numerik (978, 840…). eFakturaWin përdor kodet treshkronjore si bazë.
Ku shfaqet në aplikacion: Fatura → Kreu → fusha Monedha.
UJP endpoint: GET /api/v1/currency
Shifrat (zgjedhje nga më të shpeshtat):
| Kodi | Emri |
|---|---|
| MKD | Denari maqedonas |
| EUR | Euro |
| USD | Dollari amerikan |
| GBP | Funta britanike |
| CHF | Franga zviceriane |
| CAD | Dollari kanadez |
| AUD | Dollari australian |
| JPY | Jeni japonez |
| BGN | Leva bullgare |
| 156 | yuani kinez (CNY) |
| 643 | rublja ruse (RUB) |
| 941 | dinari serb (RSD) |
| 949 | lira turke (TRY) |
Lista e plotë përmban ~44 kode (përfshirë variantet treshkronjore dhe numerike). Për një monedhë që nuk është këtu, shihni burimin e UJP-së ose drejtpërdrejt GET /api/v1/currency.
Pamje nga UJP Phase 2 snapshot, 2026-05-03.
A.3. Grupet tatimore (Lloji TVSH)¶
Normat themelore të TVSH-së. Nga Phase 2 (maj 2026) UJP riemërtoi kodet e vjetra (A018, B005, V010, G000) në DDV-A / DDV-B / DDV-V / DDV-G.
Ku shfaqet në aplikacion: Fatura → Artikujt → kolona Lloji TVSH.
UJP endpoint: GET /api/v1/tax-groups
Shifrat:
| Kodi | Emri | Norma | Përshkrimi |
|---|---|---|---|
| DDV-A | TVSH 18% | 18% | Norma standarde – 18% |
| DDV-B | TVSH 5% | 5% | Normë e preferuar tatimore – 5% |
| DDV-V | TVSH 10% | 10% | Normë e preferuar tatimore - 10% |
| DDV-G | TVSH 0% | 0% | Normë zero tatimore - 0% |
Pamje nga UJP Phase 2 snapshot, 2026-05-03.
A.4. Treguesi TVSH¶
Klasifikim më i detajuar i trajtimit të TVSH-së për çdo artikull — tatueshmëri standarde, e liruar, detyrim i bartur, jashtë fushës, etj. Çdo tregues është i lidhur me saktësisht një grup tatimor (taxGroupCode).
Ku shfaqet në aplikacion: Fatura → Artikujt → kolona Treguesi TVSH.
UJP endpoint: GET /api/v1/tax-indicators
Shifrat:
| Kodi | Grupi tatimor | Emri | Efekti TVSH |
|---|---|---|---|
| DDV-A | DDV-A | Tatim standard me normën e përgjithshme tatimore prej 18% | STANDARD |
| DDV-B | DDV-B | Tatim standard me normën e preferuar tatimore prej 5% | STANDARD |
| DDV-V | DDV-V | Tatim standard me normën e preferuar tatimore prej 10% | STANDARD |
| DDV-G | DDV-G | Nuk është subjekt i TVSH-së | NULA |
| DDV-7-I | DDV-G | Eksport - Qarkullim i liruar nga TVSH me të drejtë të zbritjes së tatimit të paraprak | OSLOBODEN |
| DDV-8 | DDV-G | Qarkullim i liruar nga TVSH me të drejtë të zbritjes së tatimit të paraprak | OSLOBODEN |
| DDV-9 | DDV-G | Qarkullim i liruar nga TVSH pa të drejtë të zbritjes së tatimit të paraprak | OSLOBODEN |
| DDV-10-13 | DDV-G | Qarkullim i mallrave që nuk është objekt tatimimi në vend | OSLOBODEN |
| DDV-10-14 | DDV-G | Qarkullim i shërbimeve që nuk është objekt tatimimi në vend | OSLOBODEN |
| DDV-11-A | DDV-A | Qarkullim në vend për të cilin tatimin e llogarit marrësi i qarkullimit me normën e përgjithshme tatimore prej 18% (bartje e detyrimit tatimor sipas nenit 32-a të LTVSH) | PRENESEN |
| DDV-11-V | DDV-V | Qarkullim në vend për të cilin tatimin e llogarit marrësi i qarkullimit me normën e preferuar tatimore prej 10% (bartje e detyrimit tatimor sipas nenit 32-a të LTVSH) | PRENESEN |
| DDV-11-B | DDV-B | Qarkullim në vend për të cilin tatimin e llogarit marrësi i qarkullimit me normën e preferuar tatimore prej 5% (bartje e detyrimit tatimor sipas nenit 32-a të LTVSH) | PRENESEN |
💡 Efekti TVSH (
vatImpact):STANDARD= TVSH e zakonshme llogaritet;NULA= nuk është subjekt i TVSH-së;OSLOBODEN= i liruar nga TVSH;PRENESEN= detyrim tatimor i bartur (reverse charge, neni 32-a).
Pamje nga UJP Phase 2 snapshot, 2026-05-03.
A.5. Lloji i pagesës¶
Shifrar i llojeve të pagesave. Përdoret për qëllim informativ në e-faturë.
Ku shfaqet në aplikacion: Fatura → Kreu → fusha Lloji i pagesës.
UJP endpoint: GET /api/v1/payment-types
Shifrat:
| Kodi | Përshkrimi |
|---|---|
| P10 | Pagesë në dorë |
| P11 | Pagesë me kartë |
| P12 | Pagesë përmes bankës |
| P13 | Pagesë me këste |
| P14 | Pagesë bankare online |
| P15 | Pagesë përmes aplikacionit mobil |
| P16 | Dhënie pa shpërblim |
| P17 | Kompensim |
| P18 | Pagesë me kupon vlere |
| P19 | Instrumente të tjera pagese |
Pamje nga UJP Phase 2 snapshot, 2026-05-03.
A.6. Lloji i dokumentit¶
Shifrar i llojeve të dokumenteve që mund të dërgohen përmes API-it të UJP-së. Aktualisht është aktivizuar vetëm fatura e zakonshme.
Ku shfaqet në aplikacion: Fatura → Kreu → fusha Lloji i dokumentit.
UJP endpoint: GET /api/v1/document-types
Shifrat:
| Kodi | Emri | Kërkon nënshkrim | Ka artikuj | Ka referencë |
|---|---|---|---|---|
| 100 | Faturë | po | po | jo |
Pamje nga UJP Phase 2 snapshot, 2026-05-03.
A.7. Lloji i dokumentit të lidhur¶
Shifrar i llojeve të dokumenteve te të cilat mund të referohet një faturë (porosi, deklaratë doganore, profaturë, etj.). Përdoret në fushën „Dok. i lidhur" në kreun e faturës.
Ku shfaqet në aplikacion: Fatura → Kreu → fusha Dok. i lidhur.
UJP endpoint: GET /api/v1/ref-document-types
Shifrat:
| Kodi | Emri | Përshkrimi |
|---|---|---|
| SYS | Nga sistemi | Fletëdërgesë dhe fletëkthim, sqarim për të njëjtat, fletë peshe — referohet në ID-në e dokumentit të lidhur të lëshuar përmes sistemit e-faturë |
| JN | Dokument për prokurim publik | — |
| C_D | Deklaratë doganore | — |
| C_R | Vendim nga Drejtoria Doganore | — |
| GRD | Dokumente ndërtimi | — |
| TRN | Dokumente transporti | p.sh. CMR, fletëdërgesë, dokument shoqërues për mallra të padoganuara |
| KUP | Referencë e blerësit | Referencë sipas llojeve të blerësve të preferuar |
| NAR | Porosi | Dokument me të cilin bëhet porosia zyrtare e mallit ose shërbimit |
| FIS | Faturë fiskale | Plotësohet në rast shitje ambulante kur paguhet në dorë dhe lëshohet faturë fiskale dhe Faturë në dorë |
| PRO | Profaturë | Dokument i lëshuar para realizimit të shitjes |
| PON | Ofertë | Ofertë e dorëzuar te blerësi |
| DOC | Dokumente të tjera | — |
Pamje nga UJP Phase 2 snapshot, 2026-05-03.
A.8. Arsyeja e zhvlerësimit (anulimit)¶
Arsyet zyrtare të UJP-së gjatë zhvlerësimit të një fature të dërguar. Zgjidhet në dritaren „Anulim" para konfirmimit.
Ku shfaqet në aplikacion: Lista e faturave → klik i djathtë → Anulo (Storno) → listë zbritëse Arsyeja. 🚧 (Aktivizohet me S1 — funksioni i anulimit është në zhvillim.)
UJP endpoint: GET /api/v1/void-reasons
Shifrat:
| Kodi | Arsyeja |
|---|---|
| S-1 | Blerës i gabuar |
| S-2 | Anulim i kontratës |
| S-3 | Malli është kthyer tërësisht |
| S-4 | Faturim i dyfishtë i të njëjtit qarkullim |
| S-5 | Tjetër |
Pamje nga UJP Phase 2 snapshot, 2026-05-03.
A.9. Arsyeja e refuzimit¶
Arsyet zyrtare të UJP-së për refuzimin e një fature hyrëse. Zgjidhet në dritaren „Refuzim i faturës hyrëse" para konfirmimit.
Ku shfaqet në aplikacion: Faturat hyrëse → Refuzo → listë zbritëse Arsyeja e refuzimit. (Shih edhe §9.9 Refuzimi.)
UJP endpoint: GET /api/v1/reject-reasons
Shifrat:
| Kodi | Arsyeja |
|---|---|
| O-1 | TVSH e llogaritur gabimisht (bazë tatimore e papërshtatshme, normë TVSH, tregues tatimor i parregullt etj.) |
| O-2 | Gabim në porosi (sasia, çmimi, përshkrimi i qarkullimit dhe të tjera) |
| O-3 | Të dhëna të gabuara për blerës (edb, emri, adresa dhe të tjera) |
| O-4 | Qarkullimi nuk është kryer |
| O-5 | Faturë dyfish |
| O-6 | Datë e gabuar (lëshim/qarkullim) |
| O-7 | Tjetër |
Pamje nga UJP Phase 2 snapshot, 2026-05-03.